@instockng/api-client 1.0.5 → 1.0.7

package/dist/apps/backend/src/lib/meta-capi.d.ts

@@ -4,7 +4,7 @@
  * Sends server-side events to Meta for conversion tracking.
  * Used alongside browser pixel for maximum reliability and iOS 14+ compliance.
  */
-export type MetaEventName = 'AddToCart' | 'InitiateCheckout' | 'Purchase' | 'ViewContent';
+export type MetaEventName = 'AddToCart' | 'InitiateCheckout' | 'Purchase' | 'ViewContent' | 'ConfirmedPurchase';
 export interface MetaCapiQueueMessage {
     pixelId: string;
     eventName: MetaEventName;

package/dist/apps/backend/src/lib/meta-capi.js

@@ -114,7 +114,7 @@ export async function sendMetaCapiEvent(accessToken, message) {
  */
 export function generateEventId(type, id, suffix) {
     if (type === 'order') {
-        return `order_${id}`;
+        return suffix ? `order_${id}_${suffix}` : `order_${id}`;
     }
     return suffix ? `cart_${id}_${suffix}` : `cart_${id}`;
 }

package/dist/apps/backend/src/lib/order-recovery.d.ts

@@ -282,6 +282,92 @@ export declare function prepareOrderForRecoveryAttempt(prisma: PrismaClient, ord
  * Convert prospect order back to pending when customer confirms
  */
 export declare function confirmProspectOrder(prisma: PrismaClient, orderId: string, userActionToken: string): Promise<{
+    brand: {
+        name: string;
+        id: string;
+        slug: string;
+        logoUrl: string | null;
+        siteUrl: string;
+        domain: string;
+        metaPixelId: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        deletedAt: Date | null;
+    };
+    deliveryZone: {
+        state: {
+            name: string;
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            deletedAt: Date | null;
+            isActive: boolean;
+        };
+    } & {
+        name: string;
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        deletedAt: Date | null;
+        brandId: string | null;
+        stateId: string;
+        deliveryCost: import("@prisma/client/runtime/library").Decimal;
+        freeShippingThreshold: import("@prisma/client/runtime/library").Decimal | null;
+        allowCOD: boolean;
+        allowOnline: boolean;
+        waybillOnly: boolean;
+        estimatedDays: number | null;
+        isActive: boolean;
+    };
+    items: ({
+        warehouse: {
+            name: string;
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            deletedAt: Date | null;
+            isActive: boolean;
+            address: string | null;
+            city: string | null;
+            state: string | null;
+        };
+        variant: {
+            product: {
+                name: string;
+                id: string;
+                slug: string;
+                createdAt: Date;
+                updatedAt: Date;
+                deletedAt: Date | null;
+                brandId: string;
+                isActive: boolean;
+                description: string | null;
+                thumbnailUrl: string | null;
+                quantityDiscounts: import("@prisma/client/runtime/library").JsonValue | null;
+            };
+        } & {
+            name: string | null;
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            deletedAt: Date | null;
+            isActive: boolean;
+            thumbnailUrl: string | null;
+            productId: string;
+            sku: string;
+            price: import("@prisma/client/runtime/library").Decimal;
+            trackInventory: boolean;
+            lowStockThreshold: number | null;
+        };
+    } & {
+        id: string;
+        orderId: string;
+        variantId: string;
+        warehouseId: string | null;
+        quantity: number;
+        priceAtPurchase: import("@prisma/client/runtime/library").Decimal;
+    })[];
+} & {
     id: string;
     email: string | null;
     createdAt: Date;

package/dist/apps/backend/src/lib/order-recovery.js

@@ -1,6 +1,7 @@
 import { OrderStatus, ProspectReason, NoteType } from '@prisma/client';
 import { subHours, addHours } from 'date-fns';
 import { generateDiscountCode } from './discount';
+import { ORDER_INCLUDE_FULL } from './cart-helpers';
 // Recovery schedule configuration
 // Note: First email sent immediately after marking as prospect (since manual contact already attempted)
 export const PROSPECT_RECOVERY_SCHEDULE = [
@@ -200,7 +201,7 @@ export async function confirmProspectOrder(prisma, orderId, userActionToken) {
             updateData.discountAmount = discountAmount;
         }
         // Update order status
-        const updatedOrder = await tx.order.update({
+        await tx.order.update({
             where: { id: orderId },
             data: updateData
         });
@@ -216,7 +217,11 @@ export async function confirmProspectOrder(prisma, orderId, userActionToken) {
                 }
             }
         });
-        return updatedOrder;
+        // Return the full order with all relations
+        return tx.order.findUnique({
+            where: { id: orderId },
+            include: ORDER_INCLUDE_FULL
+        });
     });
 }
 /**

package/dist/apps/backend/src/notifications/producers/meta-capi-producer.d.ts

@@ -53,3 +53,10 @@ export declare function enqueuePurchaseEvent(env: Env, order: OrderDBResponse, o
     fbc?: string;
     fbp?: string;
 }): Promise<void>;
+/**
+ * Queue a ConfirmedPurchase event when order is delivered & paid
+ *
+ * This event tracks successful order completion (delivered + paid),
+ * which is a higher value conversion signal than initial purchase.
+ */
+export declare function enqueueConfirmedPurchaseEvent(env: Env, order: OrderDBResponse): Promise<void>;

package/dist/apps/backend/src/notifications/producers/meta-capi-producer.js

@@ -123,3 +123,44 @@ export async function enqueuePurchaseEvent(env, order, options) {
     await env.META_CAPI_QUEUE.send(message);
     console.log(`[Meta CAPI] Queued Purchase event: ${message.eventId}`);
 }
+/**
+ * Queue a ConfirmedPurchase event when order is delivered & paid
+ *
+ * This event tracks successful order completion (delivered + paid),
+ * which is a higher value conversion signal than initial purchase.
+ */
+export async function enqueueConfirmedPurchaseEvent(env, order) {
+    if (!env.META_CAPI_QUEUE) {
+        console.warn('[Meta CAPI] Queue not configured, skipping ConfirmedPurchase event');
+        return;
+    }
+    const pixelId = order.brand.metaPixelId;
+    if (!pixelId) {
+        console.log('[Meta CAPI] No pixel ID for brand, skipping ConfirmedPurchase event');
+        return;
+    }
+    const message = {
+        pixelId,
+        eventName: 'ConfirmedPurchase',
+        eventId: generateEventId('order', order.id, 'confirmed'),
+        eventTime: Math.floor(Date.now() / 1000),
+        eventSourceUrl: order.brand.siteUrl,
+        userData: {
+            email: order.email || undefined,
+            phone: order.phone,
+            firstName: order.firstName,
+            lastName: order.lastName,
+            city: order.city,
+            country: 'ng', // Nigeria
+        },
+        customData: {
+            value: Number(order.totalPrice),
+            currency: 'NGN',
+            contentIds: order.items.map((item) => item.variant.sku),
+            contentType: 'product',
+            numItems: order.items.reduce((sum, item) => sum + item.quantity, 0),
+        },
+    };
+    await env.META_CAPI_QUEUE.send(message);
+    console.log(`[Meta CAPI] Queued ConfirmedPurchase event: ${message.eventId}`);
+}

package/dist/apps/backend/src/routes/admin/orders.d.ts

@@ -572,20 +572,6 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
 } & {
     "/:id": {
         $get: {
-            input: {
-                param: {
-                    id: string;
-                };
-            };
-            output: {
-                error: {
-                    code: string;
-                    message: string;
-                };
-            };
-            outputFormat: "json";
-            status: 404;
-        } | {
             input: {
                 param: {
                     id: string;
@@ -851,6 +837,20 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
             };
             outputFormat: "json";
             status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: {
+                    code: string;
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 404;
         } | {
             input: {
                 param: {
@@ -1438,18 +1438,308 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                     id: string;
                 };
             };
-            output: {};
-            outputFormat: string;
-            status: import("hono/utils/http-status").StatusCode;
+            output: {
+                subtotal: number;
+                deliveryCharge: number;
+                totalPrice: number;
+                discountAmount: number;
+                createdAt: string;
+                updatedAt: string;
+                deletedAt: string;
+                prospectSince: string;
+                lastRecoveryAttemptAt: string;
+                brand: {
+                    createdAt: string;
+                    updatedAt: string;
+                    deletedAt: string;
+                    name: string;
+                    id: string;
+                    slug: string;
+                    logoUrl: string | null;
+                    siteUrl: string;
+                    domain: string;
+                    metaPixelId: string | null;
+                };
+                deliveryZone: {
+                    deliveryCost: number;
+                    freeShippingThreshold: number;
+                    createdAt: string;
+                    updatedAt: string;
+                    deletedAt: string;
+                    state: {
+                        createdAt: string;
+                        updatedAt: string;
+                        deletedAt: string;
+                        name: string;
+                        id: string;
+                        isActive: boolean;
+                    };
+                    name: string;
+                    id: string;
+                    brandId: string | null;
+                    stateId: string;
+                    allowCOD: boolean;
+                    allowOnline: boolean;
+                    waybillOnly: boolean;
+                    estimatedDays: number | null;
+                    isActive: boolean;
+                };
+                items: {
+                    priceAtPurchase: number;
+                    variant: {
+                        price: number;
+                        createdAt: string;
+                        updatedAt: string;
+                        deletedAt: string;
+                        product: {
+                            createdAt: string;
+                            updatedAt: string;
+                            deletedAt: string;
+                            name: string;
+                            id: string;
+                            slug: string;
+                            brandId: string;
+                            isActive: boolean;
+                            description: string | null;
+                            thumbnailUrl: string | null;
+                            quantityDiscounts: string | number | boolean | {
+                                [x: string]: string | number | boolean | /*elided*/ any | {
+                                    [x: number]: string | number | boolean | /*elided*/ any | /*elided*/ any;
+                                    length: number;
+                                    toString: never;
+                                    toLocaleString: never;
+                                    pop: never;
+                                    push: never;
+                                    concat: never;
+                                    join: never;
+                                    reverse: never;
+                                    shift: never;
+                                    slice: never;
+                                    sort: never;
+                                    splice: never;
+                                    unshift: never;
+                                    indexOf: never;
+                                    lastIndexOf: never;
+                                    every: never;
+                                    some: never;
+                                    forEach: never;
+                                    map: never;
+                                    filter: never;
+                                    reduce: never;
+                                    reduceRight: never;
+                                    find: never;
+                                    findIndex: never;
+                                    fill: never;
+                                    copyWithin: never;
+                                    entries: never;
+                                    keys: never;
+                                    values: never;
+                                    includes: never;
+                                    flatMap: never;
+                                    flat: never;
+                                    [Symbol.iterator]: never;
+                                    readonly [Symbol.unscopables]: {
+                                        [x: number]: boolean;
+                                        length?: boolean;
+                                        toString?: boolean;
+                                        toLocaleString?: boolean;
+                                        pop?: boolean;
+                                        push?: boolean;
+                                        concat?: boolean;
+                                        join?: boolean;
+                                        reverse?: boolean;
+                                        shift?: boolean;
+                                        slice?: boolean;
+                                        sort?: boolean;
+                                        splice?: boolean;
+                                        unshift?: boolean;
+                                        indexOf?: boolean;
+                                        lastIndexOf?: boolean;
+                                        every?: boolean;
+                                        some?: boolean;
+                                        forEach?: boolean;
+                                        map?: boolean;
+                                        filter?: boolean;
+                                        reduce?: boolean;
+                                        reduceRight?: boolean;
+                                        find?: boolean;
+                                        findIndex?: boolean;
+                                        fill?: boolean;
+                                        copyWithin?: boolean;
+                                        entries?: boolean;
+                                        keys?: boolean;
+                                        values?: boolean;
+                                        includes?: boolean;
+                                        flatMap?: boolean;
+                                        flat?: boolean;
+                                    };
+                                };
+                            } | {
+                                [x: number]: string | number | boolean | {
+                                    [x: string]: string | number | boolean | /*elided*/ any | /*elided*/ any;
+                                } | /*elided*/ any;
+                                length: number;
+                                toString: never;
+                                toLocaleString: never;
+                                pop: never;
+                                push: never;
+                                concat: never;
+                                join: never;
+                                reverse: never;
+                                shift: never;
+                                slice: never;
+                                sort: never;
+                                splice: never;
+                                unshift: never;
+                                indexOf: never;
+                                lastIndexOf: never;
+                                every: never;
+                                some: never;
+                                forEach: never;
+                                map: never;
+                                filter: never;
+                                reduce: never;
+                                reduceRight: never;
+                                find: never;
+                                findIndex: never;
+                                fill: never;
+                                copyWithin: never;
+                                entries: never;
+                                keys: never;
+                                values: never;
+                                includes: never;
+                                flatMap: never;
+                                flat: never;
+                                [Symbol.iterator]: never;
+                                readonly [Symbol.unscopables]: {
+                                    [x: number]: boolean;
+                                    length?: boolean;
+                                    toString?: boolean;
+                                    toLocaleString?: boolean;
+                                    pop?: boolean;
+                                    push?: boolean;
+                                    concat?: boolean;
+                                    join?: boolean;
+                                    reverse?: boolean;
+                                    shift?: boolean;
+                                    slice?: boolean;
+                                    sort?: boolean;
+                                    splice?: boolean;
+                                    unshift?: boolean;
+                                    indexOf?: boolean;
+                                    lastIndexOf?: boolean;
+                                    every?: boolean;
+                                    some?: boolean;
+                                    forEach?: boolean;
+                                    map?: boolean;
+                                    filter?: boolean;
+                                    reduce?: boolean;
+                                    reduceRight?: boolean;
+                                    find?: boolean;
+                                    findIndex?: boolean;
+                                    fill?: boolean;
+                                    copyWithin?: boolean;
+                                    entries?: boolean;
+                                    keys?: boolean;
+                                    values?: boolean;
+                                    includes?: boolean;
+                                    flatMap?: boolean;
+                                    flat?: boolean;
+                                };
+                            };
+                        };
+                        name: string | null;
+                        id: string;
+                        isActive: boolean;
+                        thumbnailUrl: string | null;
+                        productId: string;
+                        sku: string;
+                        trackInventory: boolean;
+                        lowStockThreshold: number | null;
+                    };
+                    warehouse: {
+                        createdAt: string;
+                        updatedAt: string;
+                        deletedAt: string;
+                        name: string;
+                        id: string;
+                        isActive: boolean;
+                        address: string | null;
+                        city: string | null;
+                        state: string | null;
+                    };
+                    id: string;
+                    orderId: string;
+                    variantId: string;
+                    warehouseId: string | null;
+                    quantity: number;
+                }[];
+                id: string;
+                email: string | null;
+                brandId: string;
+                deliveryZoneId: string;
+                recoveryAttempts: number;
+                recoveryDiscountCodeId: string | null;
+                wasRecovered: boolean;
+                estimatedDays: number | null;
+                orderNumber: number;
+                firstName: string;
+                lastName: string;
+                phone: string;
+                address: string;
+                city: string;
+                discountCodeId: string | null;
+                paymentMethod: import("@prisma/client").$Enums.PaymentMethod;
+                paystackReference: string | null;
+                status: import("@prisma/client").$Enums.OrderStatus;
+                cancellationReason: string | null;
+                prospectReason: import("@prisma/client").$Enums.ProspectReason | null;
+                userActionToken: string;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
         } | {
             input: {
                 param: {
                     id: string;
                 };
             };
-            output: {};
-            outputFormat: string;
-            status: import("hono/utils/http-status").StatusCode;
+            output: {
+                error: {
+                    code: string;
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: {
+                    code: string;
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: {
+                    code: string;
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 500;
         };
     };
 } & {

package/dist/apps/backend/src/routes/admin/orders.js

@@ -139,6 +139,7 @@ const app = new Hono()
                 { phone: { contains: query.search } },
                 { firstName: { contains: query.search, mode: 'insensitive' } },
                 { lastName: { contains: query.search, mode: 'insensitive' } },
+                { address: { contains: query.search, mode: 'insensitive' } },
             ].filter((item) => Object.values(item).some((v) => v !== undefined));
         }
         if (query.startDate)
@@ -267,7 +268,7 @@ const app = new Hono()
                     address: input.address ?? order.address,
                     city: input.city ?? order.city,
                     deliveryCharge,
-                    paymentMethod: input.paymentMethod ?? order.paymentMethod,
+                    paymentMethod: (input.paymentMethod ?? order.paymentMethod),
                     paystackReference: input.paystackReference ?? order.paystackReference,
                     totalPrice,
                 },
@@ -477,8 +478,31 @@ const app = new Hono()
             catch (error) {
                 console.error('Failed to queue order status update notification:', error);
             }
+            // Queue Meta CAPI ConfirmedPurchase event when order is delivered & paid
+            if (newStatus === 'delivered' && previousStatus !== 'delivered') {
+                try {
+                    const { enqueueConfirmedPurchaseEvent } = await import('../../notifications/producers/meta-capi-producer');
+                    // Fetch full order details with items for the CAPI event
+                    const fullOrder = await prisma.order.findFirst({
+                        where: { id, deletedAt: null },
+                        include: ORDER_INCLUDE_FULL,
+                    });
+                    if (fullOrder) {
+                        await enqueueConfirmedPurchaseEvent(c.env, fullOrder);
+                    }
+                }
+                catch (error) {
+                    console.error('Failed to queue Meta CAPI ConfirmedPurchase event:', error);
+                    // Don't fail the status update if CAPI queuing fails
+                }
+            }
         }
-        return c.status(200);
+        // Fetch updated order to return
+        const updatedOrder = await prisma.order.findFirst({
+            where: { id, deletedAt: null },
+            include: ORDER_INCLUDE_FULL,
+        });
+        return c.json(formatOrderResponse(updatedOrder));
     }
     catch (error) {
         return c.json({