@mohasinac/appkit 2.6.3 → 2.6.5

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

@@ -1,136 +1,8 @@
-/**
- * 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 { FieldValue } from "firebase-admin/firestore";
-import { BATCH_LIMIT } from "./messages";
-const CATEGORIES = "categories";
-async function shiftPositions(ctx, threshold, delta, excludeId) {
-    const snap = await ctx.db.collection(CATEGORIES).where("position", ">=", threshold).get();
-    const docs = snap.docs.filter((d) => d.id !== excludeId && d.data().position >= threshold);
-    if (docs.length === 0)
-        return 0;
-    for (let i = 0; i < docs.length; i += BATCH_LIMIT) {
-        const batch = ctx.db.batch();
-        for (const doc of docs.slice(i, i + BATCH_LIMIT)) {
-            batch.update(doc.ref, {
-                position: doc.data().position + delta,
-                updatedAt: new Date(),
-            });
-        }
-        await batch.commit();
-    }
-    return docs.length;
-}
-async function adjustAncestorSubtreeSize(ctx, ancestorIds, delta) {
-    if (ancestorIds.length === 0)
-        return;
-    for (let i = 0; i < ancestorIds.length; i += BATCH_LIMIT) {
-        const batch = ctx.db.batch();
-        for (const id of ancestorIds.slice(i, i + BATCH_LIMIT)) {
-            batch.update(ctx.db.collection(CATEGORIES).doc(id), {
-                subtreeSize: FieldValue.increment(delta),
-                updatedAt: new Date(),
-            });
-        }
-        await batch.commit();
-    }
-}
-async function getMaxPosition(ctx, excludeId) {
-    const snap = await ctx.db
-        .collection(CATEGORIES)
-        .orderBy("position", "desc")
-        .limit(excludeId ? 2 : 1)
-        .get();
-    for (const doc of snap.docs) {
-        if (doc.id === excludeId)
-            continue;
-        return doc.data().position ?? 0;
-    }
-    return 0;
-}
+import { handleCategoryWrite } from "../core/onCategoryWrite";
 export const onCategoryWriteHandler = async (event, ctx) => {
-    const categoryId = event.params.categoryId;
-    const before = event.before;
-    const after = event.after;
-    const isCreate = !before && !!after;
-    const isDelete = !!before && !after;
-    const isUpdate = !!before && !!after;
-    try {
-        if (isCreate) {
-            const parentIds = after.parentIds ?? [];
-            const parentId = parentIds.length > 0 ? parentIds[parentIds.length - 1] : null;
-            let insertPosition;
-            if (parentId) {
-                const parentSnap = await ctx.db.collection(CATEGORIES).doc(parentId).get();
-                if (!parentSnap.exists) {
-                    ctx.logger.warn("Parent not found, appending at end", { categoryId, parentId });
-                    insertPosition = (await getMaxPosition(ctx, categoryId)) + 1;
-                }
-                else {
-                    const p = parentSnap.data();
-                    const parentPos = p.position ?? 0;
-                    const parentSize = p.subtreeSize ?? 1;
-                    insertPosition = parentPos + parentSize;
-                }
-            }
-            else {
-                insertPosition = (await getMaxPosition(ctx, categoryId)) + 1;
-            }
-            const shifted = await shiftPositions(ctx, insertPosition, +1, categoryId);
-            await ctx.db.collection(CATEGORIES).doc(categoryId).update({
-                position: insertPosition,
-                subtreeSize: 1,
-                updatedAt: new Date(),
-            });
-            await adjustAncestorSubtreeSize(ctx, parentIds, +1);
-            ctx.logger.info("Category created — position assigned", {
-                categoryId,
-                position: insertPosition,
-                parentId,
-                shifted,
-            });
-        }
-        else if (isDelete) {
-            const deletedPos = before.position ?? 0;
-            const deletedSize = before.subtreeSize ?? 1;
-            const parentIds = before.parentIds ?? [];
-            if (deletedPos === 0) {
-                ctx.logger.warn("Deleted category had no position — skipping shift", { categoryId });
-                return;
-            }
-            const shifted = await shiftPositions(ctx, deletedPos + deletedSize, -deletedSize);
-            await adjustAncestorSubtreeSize(ctx, parentIds, -deletedSize);
-            ctx.logger.info("Category deleted — positions shifted", {
-                categoryId,
-                position: deletedPos,
-                subtreeSize: deletedSize,
-                shifted,
-            });
-        }
-        else if (isUpdate) {
-            const beforeParents = before.parentIds ?? [];
-            const afterParents = after.parentIds ?? [];
-            const beforeParent = beforeParents[beforeParents.length - 1] ?? null;
-            const afterParent = afterParents[afterParents.length - 1] ?? null;
-            if (beforeParent !== afterParent) {
-                await ctx.db
-                    .collection(CATEGORIES)
-                    .doc(categoryId)
-                    .update({ positionDirty: true, updatedAt: new Date() });
-                ctx.logger.warn("Category moved — positionDirty flagged for nightly reconcile", {
-                    categoryId,
-                    fromParent: beforeParent,
-                    toParent: afterParent,
-                });
-            }
-        }
-    }
-    catch (err) {
-        ctx.logger.error("Position update failed (non-fatal — will heal on next reconcile)", err, {
-            categoryId,
-        });
-    }
+    await handleCategoryWrite({
+        categoryId: event.params.categoryId,
+        before: event.before,
+        after: event.after,
+    }, ctx);
 };

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

@@ -1,14 +1,3 @@
 import type { FirestoreTriggerHandler } from "../runtime/types";
-interface OrderItem {
-    title?: string;
-    name?: string;
-}
-interface NewOrder {
-    buyerDisplayName?: string;
-    buyerId?: string;
-    items?: OrderItem[];
-    totalAmount?: number;
-    storeId?: string;
-}
+import { type NewOrder } from "../core/onOrderCreate";
 export declare const onOrderCreateHandler: FirestoreTriggerHandler<null, NewOrder>;
-export {};

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

@@ -1,83 +1,9 @@
-import { storeRepository, userRepository } from "../../../../repositories";
-import { decryptPii } from "../../../../security/index";
-import { sendWhatsAppBusinessMessage, buildPurchaseAnnouncementMessage, } from "../../../../features/whatsapp-bot/server";
-async function sendAnnouncement(ctx, toPhone, message, phoneNumberId, accessToken, label, orderId) {
-    try {
-        const sent = await sendWhatsAppBusinessMessage({
-            toPhone,
-            message,
-            phoneNumberId,
-            accessToken,
-        });
-        if (sent) {
-            ctx.logger.info(`Announcement sent to ${label}`, {
-                orderId,
-                toPhone: `...${toPhone.slice(-4)}`,
-            });
-        }
-        else {
-            ctx.logger.error(`Announcement delivery failed for ${label} (non-fatal)`, null, { orderId });
-        }
-    }
-    catch (err) {
-        ctx.logger.error(`Announcement send threw for ${label} (non-fatal)`, err, { orderId });
-    }
-}
+import { handleOrderCreate } from "../core/onOrderCreate";
 export const onOrderCreateHandler = async (event, ctx) => {
     const order = event.after;
     if (!order) {
         ctx.logger.error("No snapshot data", null);
         return;
     }
-    const orderId = event.params.orderId;
-    const phoneNumberId = ctx.env("WHATSAPP_PHONE_NUMBER_ID") ?? "";
-    const accessToken = ctx.env("WHATSAPP_CLOUD_API_TOKEN") ?? "";
-    if (!phoneNumberId || !accessToken) {
-        ctx.logger.info("WhatsApp Cloud API not configured — skipping announcement", { orderId });
-        return;
-    }
-    const items = order.items ?? [];
-    const firstItem = items[0];
-    const firstItemName = firstItem?.title ?? firstItem?.name ?? "an item";
-    const additionalItemCount = Math.max(0, items.length - 1);
-    const buyerName = order.buyerDisplayName ?? "A customer";
-    const message = buildPurchaseAnnouncementMessage({
-        buyerName,
-        firstItemName,
-        additionalItemCount,
-        totalAmount: order.totalAmount ?? 0,
-        orderId,
-    });
-    const adminNumbersRaw = ctx.env("WHATSAPP_ADMIN_NOTIFY_NUMBERS") ?? "";
-    const adminNumbers = adminNumbersRaw
-        .split(",")
-        .map((n) => n.trim().replace(/\D/g, ""))
-        .filter(Boolean);
-    for (const num of adminNumbers) {
-        await sendAnnouncement(ctx, num, message, phoneNumberId, accessToken, "admin", orderId);
-    }
-    const storeId = order.storeId;
-    if (storeId) {
-        try {
-            const store = await storeRepository.findBySlug(storeId);
-            if (store?.ownerId) {
-                const owner = await userRepository.findById(store.ownerId);
-                const encryptedPhone = owner?.phoneNumber;
-                if (encryptedPhone) {
-                    const ownerPhone = decryptPii(encryptedPhone);
-                    if (ownerPhone) {
-                        await sendAnnouncement(ctx, ownerPhone, message, phoneNumberId, accessToken, "store-owner", orderId);
-                    }
-                }
-            }
-        }
-        catch (err) {
-            ctx.logger.error("Store owner lookup failed (non-fatal)", err, { orderId, storeId });
-        }
-    }
-    ctx.logger.info(`Order announcement complete`, {
-        orderId,
-        adminCount: adminNumbers.length,
-        storeId: storeId ?? "unknown",
-    });
+    await handleOrderCreate({ orderId: event.params.orderId, order }, ctx);
 };

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

@@ -1,14 +1,3 @@
 import type { FirestoreTriggerHandler } from "../runtime/types";
-type OrderStatus = "pending" | "confirmed" | "shipped" | "delivered" | "cancelled" | "returned";
-type OrderAfter = {
-    status: OrderStatus;
-    userId: string;
-    userEmail: string;
-    productTitle: string;
-    trackingNumber?: string;
-};
-type OrderBefore = {
-    status: OrderStatus;
-};
+import { type OrderAfter, type OrderBefore } from "../core/onOrderStatusChange";
 export declare const onOrderStatusChangeHandler: FirestoreTriggerHandler<OrderBefore, OrderAfter>;
-export {};

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

@@ -1,141 +1,4 @@
-import { notificationRepository } from "../../../../repositories";
-import { decryptPii } from "../../../../security/index";
-import { getAdminRealtimeDb } from "../../../../providers/db-firebase";
-import { ORDER_MESSAGES, EMAIL_SUBJECTS, JOB_ERROR_MESSAGES } from "./messages";
-const STATUS_CONFIG = {
-    confirmed: {
-        type: "order_confirmed",
-        title: ORDER_MESSAGES.CONFIRMED_TITLE,
-        message: (o) => ORDER_MESSAGES.CONFIRMED_MESSAGE(o.productTitle),
-        priority: "normal",
-        sendEmail: true,
-    },
-    shipped: {
-        type: "order_shipped",
-        title: ORDER_MESSAGES.SHIPPED_TITLE,
-        message: (o) => ORDER_MESSAGES.SHIPPED_MESSAGE(o.productTitle, o.trackingNumber),
-        priority: "high",
-        sendEmail: true,
-    },
-    delivered: {
-        type: "order_delivered",
-        title: ORDER_MESSAGES.DELIVERED_TITLE,
-        message: (o) => ORDER_MESSAGES.DELIVERED_MESSAGE(o.productTitle),
-        priority: "normal",
-        sendEmail: true,
-    },
-    cancelled: {
-        type: "order_cancelled",
-        title: ORDER_MESSAGES.CANCELLED_TITLE,
-        message: (o) => `Your order for "${o.productTitle}" has been cancelled.`,
-        priority: "normal",
-        sendEmail: false,
-    },
-};
-async function sendResendEmail(params) {
-    const subject = params.status === "confirmed"
-        ? EMAIL_SUBJECTS.ORDER_CONFIRMED(params.productTitle)
-        : params.status === "shipped"
-            ? EMAIL_SUBJECTS.ORDER_SHIPPED(params.productTitle)
-            : params.status === "delivered"
-                ? EMAIL_SUBJECTS.ORDER_DELIVERED(params.productTitle)
-                : EMAIL_SUBJECTS.ORDER_UPDATE_FALLBACK(params.productTitle);
-    const response = await fetch("https://api.resend.com/emails", {
-        method: "POST",
-        headers: {
-            Authorization: `Bearer ${params.apiKey}`,
-            "Content-Type": "application/json",
-        },
-        body: JSON.stringify({
-            from: params.fromAddress,
-            to: [params.to],
-            subject,
-            html: `<p>Hi,</p><p>Your order for <strong>${params.productTitle}</strong> is now <strong>${params.status}</strong>.</p>${params.trackingNumber ? `<p>Tracking number: ${params.trackingNumber}</p>` : ""}<p>Thanks,<br/>${params.brandName} Team</p>`,
-        }),
-    });
-    if (!response.ok) {
-        const body = await response.text();
-        throw new Error(JOB_ERROR_MESSAGES.RESEND_API_ERROR(response.status, body));
-    }
-}
+import { handleOrderStatusChange, } from "../core/onOrderStatusChange";
 export const onOrderStatusChangeHandler = async (event, ctx) => {
-    const { before, after } = event;
-    if (!before || !after)
-        return;
-    if (before.status === after.status)
-        return;
-    const orderId = event.params.orderId;
-    const newStatus = after.status;
-    const config = STATUS_CONFIG[newStatus];
-    if (!config) {
-        ctx.logger.info(`No handler for status transition → ${newStatus}`, { orderId });
-        return;
-    }
-    // Decrypt PII that was encrypted at rest
-    const userEmail = decryptPii(after.userEmail);
-    try {
-        const messageText = config.message({
-            productTitle: after.productTitle,
-            trackingNumber: after.trackingNumber,
-        });
-        await notificationRepository.create({
-            userId: after.userId,
-            type: config.type,
-            priority: config.priority,
-            title: config.title,
-            message: messageText,
-            relatedId: orderId,
-            relatedType: "order",
-        });
-        try {
-            await getAdminRealtimeDb().ref(`notifications/${after.userId}`).push({
-                type: config.type,
-                title: config.title,
-                message: messageText,
-                timestamp: Date.now(),
-                read: false,
-            });
-        }
-        catch (rtdbError) {
-            ctx.logger.error("Realtime DB push failed (non-fatal)", rtdbError);
-        }
-        if (config.sendEmail) {
-            const apiKey = ctx.env("RESEND_API_KEY") ?? "";
-            if (!apiKey) {
-                ctx.logger.error(JOB_ERROR_MESSAGES.RESEND_KEY_MISSING, null);
-            }
-            else {
-                try {
-                    const fromAddress = ctx.env("ORDER_EMAIL_FROM") ?? ctx.env("RESEND_FROM_ADDRESS") ?? "";
-                    const brandName = ctx.env("APPKIT_BRAND_NAME") ?? "";
-                    if (!fromAddress || !brandName) {
-                        ctx.logger.error("ORDER_EMAIL_FROM / APPKIT_BRAND_NAME not configured — skipping order status email", null, { orderId });
-                    }
-                    else {
-                        await sendResendEmail({
-                            to: userEmail,
-                            status: newStatus,
-                            orderId,
-                            productTitle: after.productTitle,
-                            trackingNumber: after.trackingNumber,
-                            apiKey,
-                            fromAddress,
-                            brandName,
-                        });
-                    }
-                }
-                catch (emailError) {
-                    ctx.logger.error("Email send failed (non-fatal)", emailError, { orderId });
-                }
-            }
-        }
-        ctx.logger.info(`Order ${orderId} status → ${newStatus}`, {
-            userId: after.userId,
-            emailSent: config.sendEmail,
-        });
-    }
-    catch (error) {
-        ctx.logger.error("Error handling order status change", error, { orderId });
-        throw error;
-    }
+    await handleOrderStatusChange({ orderId: event.params.orderId, before: event.before, after: event.after }, ctx);
 };

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

@@ -1,16 +1,3 @@
-/**
- * onProductStockChange — SB-UNI-V Firestore onWrite trigger on products.
- *
- * Fires when any product document is created / updated / deleted. Looks
- * up every bundle category (categoryType:"bundle") that lists the product
- * in `bundleProductIds[]` and recomputes its `bundleStockStatus`. Also
- * updates every grouped listing that lists the product in `productIds[]`
- * — bumps `activeMemberCount` and `visibilityStatus`.
- *
- * Cheap: each affected bundle/group reads its `bundleProductIds.length`
- * member products (≤16 typically). Skips entirely when the product's
- * status didn't transition between "available" and "unavailable".
- */
 import type { FirestoreTriggerHandler } from "../runtime/types";
 type ProductDoc = Record<string, unknown>;
 export declare const onProductStockChangeHandler: FirestoreTriggerHandler<ProductDoc, ProductDoc>;

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

@@ -1,136 +1,9 @@
-/**
- * onProductStockChange — SB-UNI-V Firestore onWrite trigger on products.
- *
- * Fires when any product document is created / updated / deleted. Looks
- * up every bundle category (categoryType:"bundle") that lists the product
- * in `bundleProductIds[]` and recomputes its `bundleStockStatus`. Also
- * updates every grouped listing that lists the product in `productIds[]`
- * — bumps `activeMemberCount` and `visibilityStatus`.
- *
- * Cheap: each affected bundle/group reads its `bundleProductIds.length`
- * member products (≤16 typically). Skips entirely when the product's
- * status didn't transition between "available" and "unavailable".
- */
-const CATEGORIES_COLLECTION = "categories";
-const GROUPED_LISTINGS_COLLECTION = "groupedListings";
-const PRODUCT_COLLECTION = "products";
-const UNAVAILABLE_STATUSES = new Set(["sold", "out_of_stock", "discontinued"]);
-const MIN_ACTIVE_DEFAULT = 2;
-function isAvailable(status) {
-    if (!status)
-        return false;
-    return !UNAVAILABLE_STATUSES.has(status);
-}
-async function recomputeBundleStatus(productIds, minActive, ctx) {
-    if (productIds.length === 0)
-        return "out_of_stock";
-    let unavailable = 0;
-    for (let i = 0; i < productIds.length; i += 30) {
-        const chunk = productIds.slice(i, i + 30);
-        const snap = await ctx.db
-            .collection(PRODUCT_COLLECTION)
-            .where("__name__", "in", chunk)
-            .get();
-        for (const doc of snap.docs) {
-            const status = doc.data().status;
-            if (!isAvailable(status))
-                unavailable++;
-        }
-        if (snap.size < chunk.length)
-            unavailable += chunk.length - snap.size;
-    }
-    const active = productIds.length - unavailable;
-    if (unavailable === 0)
-        return "in_stock";
-    if (active < minActive)
-        return "out_of_stock";
-    return "partial";
-}
-async function syncBundlesForProduct(productId, ctx) {
-    const snap = await ctx.db
-        .collection(CATEGORIES_COLLECTION)
-        .where("categoryType", "==", "bundle")
-        .where("bundleProductIds", "array-contains", productId)
-        .get();
-    let updated = 0;
-    for (const bundleDoc of snap.docs) {
-        const data = bundleDoc.data();
-        const ids = data.bundleProductIds ?? [];
-        const minActive = data.minActiveMembers ?? 1;
-        const next = await recomputeBundleStatus(ids, minActive, ctx);
-        if (next !== data.bundleStockStatus) {
-            await bundleDoc.ref.update({
-                bundleStockStatus: next,
-                bundleQueryResolvedAt: ctx.now,
-                updatedAt: ctx.now,
-            });
-            updated++;
-        }
-    }
-    return updated;
-}
-async function syncGroupedListingsForProduct(productId, ctx) {
-    const snap = await ctx.db
-        .collection(GROUPED_LISTINGS_COLLECTION)
-        .where("productIds", "array-contains", productId)
-        .get();
-    let updated = 0;
-    for (const groupDoc of snap.docs) {
-        const data = groupDoc.data();
-        const productIds = data.productIds ?? [];
-        if (productIds.length === 0)
-            continue;
-        const minActive = data.minActiveMembers ?? MIN_ACTIVE_DEFAULT;
-        let activeCount = 0;
-        for (let i = 0; i < productIds.length; i += 30) {
-            const chunk = productIds.slice(i, i + 30);
-            const productSnap = await ctx.db
-                .collection(PRODUCT_COLLECTION)
-                .where("__name__", "in", chunk)
-                .get();
-            for (const doc of productSnap.docs) {
-                const status = doc.data().status;
-                if (isAvailable(status))
-                    activeCount++;
-            }
-        }
-        const nextVisibility = activeCount >= minActive ? "visible" : "hidden";
-        if (activeCount !== data.activeMemberCount ||
-            nextVisibility !== data.visibilityStatus) {
-            await groupDoc.ref.update({
-                activeMemberCount: activeCount,
-                visibilityStatus: nextVisibility,
-                updatedAt: ctx.now,
-            });
-            updated++;
-        }
-    }
-    return updated;
-}
+import { handleProductStockChange } from "../core/onProductStockChange";
 export const onProductStockChangeHandler = async (event, ctx) => {
-    const productId = event.params.productId;
-    const before = event.before;
-    const after = event.after;
-    // Only react when the available/unavailable state actually flipped.
-    // Saves Firestore reads on routine writes (price edits, image updates, etc.).
-    const beforeAvailable = isAvailable(before?.status);
-    const afterAvailable = isAvailable(after?.status);
-    const isDelete = !after;
-    const stateFlipped = beforeAvailable !== afterAvailable;
-    if (!isDelete && !stateFlipped) {
-        return;
-    }
-    try {
-        const bundlesUpdated = await syncBundlesForProduct(productId, ctx);
-        const groupsUpdated = await syncGroupedListingsForProduct(productId, ctx);
-        ctx.logger.info("onProductStockChange synced", {
-            productId,
-            bundlesUpdated,
-            groupsUpdated,
-            isDelete,
-        });
-    }
-    catch (err) {
-        ctx.logger.error("onProductStockChange sync failed (non-fatal)", err, { productId });
-    }
+    await handleProductStockChange({
+        productId: event.params.productId,
+        beforeStatus: event.before?.status ?? null,
+        afterStatus: event.after?.status ?? null,
+        isDelete: !event.after,
+    }, ctx);
 };

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

@@ -1,8 +1,3 @@
-/**
- * Trigger handler: keep category metrics + store stats in sync when a
- * product document is written. Only published products count.
- */
 import type { FirestoreTriggerHandler } from "../runtime/types";
-type ProductDoc = Record<string, unknown>;
+import { type ProductDoc } from "../core/onProductWrite";
 export declare const onProductWriteHandler: FirestoreTriggerHandler<ProductDoc, ProductDoc>;
-export {};