@instockng/api-client 1.0.7 → 1.0.8

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

@@ -34,8 +34,8 @@ export declare function formatOrderResponse(order: OrderDBResponse): {
         createdAt: string;
         updatedAt: string;
         deletedAt: string;
-        name: string;
         id: string;
+        name: string;
         slug: string;
         logoUrl: string | null;
         siteUrl: string;
@@ -52,18 +52,20 @@ export declare function formatOrderResponse(order: OrderDBResponse): {
             createdAt: string;
             updatedAt: string;
             deletedAt: string;
-            name: string;
             id: string;
+            name: string;
             isActive: boolean;
         };
-        name: string;
         id: string;
+        name: string;
         brandId: string | null;
         stateId: string;
         allowCOD: boolean;
         allowOnline: boolean;
         waybillOnly: boolean;
         estimatedDays: number | null;
+        noteTitle: string | null;
+        noteContent: string | null;
         isActive: boolean;
     };
     items: {
@@ -77,8 +79,8 @@ export declare function formatOrderResponse(order: OrderDBResponse): {
                 createdAt: string;
                 updatedAt: string;
                 deletedAt: string;
-                name: string;
                 id: string;
+                name: string;
                 slug: string;
                 brandId: string;
                 isActive: boolean;
@@ -86,8 +88,8 @@ export declare function formatOrderResponse(order: OrderDBResponse): {
                 thumbnailUrl: string | null;
                 quantityDiscounts: Prisma.JsonValue | null;
             };
-            name: string | null;
             id: string;
+            name: string | null;
             isActive: boolean;
             thumbnailUrl: string | null;
             productId: string;
@@ -99,8 +101,8 @@ export declare function formatOrderResponse(order: OrderDBResponse): {
             createdAt: string;
             updatedAt: string;
             deletedAt: string;
-            name: string;
             id: string;
+            name: string;
             isActive: boolean;
             address: string | null;
             city: string | null;
@@ -112,8 +114,8 @@ export declare function formatOrderResponse(order: OrderDBResponse): {
         warehouseId: string | null;
         quantity: number;
     }[];
-    id: string;
     email: string | null;
+    id: string;
     brandId: string;
     deliveryZoneId: string;
     recoveryAttempts: number;

package/dist/apps/backend/src/lib/product-response.d.ts

@@ -32,8 +32,8 @@ export declare function formatProductResponse(product: ProductDBResponse): {
         createdAt: string;
         updatedAt: string;
         deletedAt: string;
-        name: string;
         id: string;
+        name: string;
         slug: string;
         logoUrl: string | null;
         siteUrl: string;
@@ -45,8 +45,8 @@ export declare function formatProductResponse(product: ProductDBResponse): {
         updatedAt: string;
         price: number;
         deletedAt: string;
-        name: string | null;
         id: string;
+        name: string | null;
         isActive: boolean;
         thumbnailUrl: string | null;
         productId: string;
@@ -54,8 +54,8 @@ export declare function formatProductResponse(product: ProductDBResponse): {
         trackInventory: boolean;
         lowStockThreshold: number | null;
     }[];
-    name: string;
     id: string;
+    name: string;
     slug: string;
     createdAt: Date;
     updatedAt: Date;
@@ -71,8 +71,8 @@ export declare function formatProductVariantResponse(variant: ProductVariantDBRe
     updatedAt: string;
     price: number;
     deletedAt: string;
-    name: string | null;
     id: string;
+    name: string | null;
     isActive: boolean;
     thumbnailUrl: string | null;
     productId: string;

package/dist/apps/backend/src/lib/sentry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Sentry error tracking for Cloudflare Workers
+ *
+ * This module provides utilities for capturing errors, exceptions, and messages
+ * with proper context and sampling rates.
+ *
+ * Sentry is initialized via withSentry() wrapper in index.ts
+ */
+import type { Context } from 'hono';
+/**
+ * Capture an exception with request context
+ */
+export declare function captureException(error: Error | unknown, context?: {
+    level?: 'fatal' | 'error' | 'warning';
+    tags?: Record<string, string>;
+    extra?: Record<string, any>;
+    fingerprint?: string[];
+    honoContext?: Context<any>;
+}): void;
+/**
+ * Capture a message with context (for non-exception events)
+ */
+export declare function captureMessage(message: string, context?: {
+    level?: 'fatal' | 'error' | 'warning' | 'info' | 'debug';
+    tags?: Record<string, string>;
+    extra?: Record<string, any>;
+    sampleRate?: number;
+}): void;
+/**
+ * Add breadcrumb for tracing event flow
+ */
+export declare function addBreadcrumb(message: string, data?: Record<string, any>, category?: string): void;
+/**
+ * Wrap a function with Sentry error capturing
+ */
+export declare function withSentry<T extends (...args: any[]) => any>(fn: T, context?: {
+    tags?: Record<string, string>;
+    extra?: Record<string, any>;
+}): T;
+/**
+ * Helper to determine if an error should be tracked in Sentry
+ * based on its characteristics (e.g., status code, error code)
+ */
+export declare function shouldTrackError(statusCode: number, errorCode?: string): boolean;
+/**
+ * Get sample rate for different error types
+ */
+export declare function getSampleRate(errorCode: string): number;

package/dist/apps/backend/src/lib/sentry.js

@@ -0,0 +1,180 @@
+/**
+ * Sentry error tracking for Cloudflare Workers
+ *
+ * This module provides utilities for capturing errors, exceptions, and messages
+ * with proper context and sampling rates.
+ *
+ * Sentry is initialized via withSentry() wrapper in index.ts
+ */
+import * as Sentry from '@sentry/cloudflare';
+/**
+ * Capture an exception with request context
+ */
+export function captureException(error, context) {
+    Sentry.withScope((scope) => {
+        // Set severity level
+        if (context?.level) {
+            scope.setLevel(context.level);
+        }
+        // Add tags for filtering/grouping
+        if (context?.tags) {
+            Object.entries(context.tags).forEach(([key, value]) => {
+                scope.setTag(key, value);
+            });
+        }
+        // Add extra context data
+        if (context?.extra) {
+            Object.entries(context.extra).forEach(([key, value]) => {
+                scope.setExtra(key, value);
+            });
+        }
+        // Custom fingerprint for grouping
+        if (context?.fingerprint) {
+            scope.setFingerprint(context.fingerprint);
+        }
+        // Add request context from Hono if available
+        if (context?.honoContext) {
+            const c = context.honoContext;
+            const req = c.req;
+            // Set request context
+            scope.setContext('request', {
+                url: req.url,
+                method: req.method,
+                headers: sanitizeHeaders(req.header()),
+            });
+            // Add user context if authenticated
+            const user = c.get('user');
+            if (user) {
+                scope.setUser({
+                    id: user.id,
+                    email: user.email,
+                    username: user.name,
+                });
+            }
+            // Add brand context if available
+            const brandSlug = req.param('brandSlug') || req.query('brandSlug');
+            if (brandSlug) {
+                scope.setTag('brand', brandSlug);
+            }
+        }
+        // Capture the exception
+        Sentry.captureException(error);
+    });
+}
+/**
+ * Capture a message with context (for non-exception events)
+ */
+export function captureMessage(message, context) {
+    // Apply sampling if specified
+    if (context?.sampleRate !== undefined && Math.random() > context.sampleRate) {
+        return; // Skip this capture based on sample rate
+    }
+    Sentry.withScope((scope) => {
+        if (context?.level) {
+            scope.setLevel(context.level);
+        }
+        if (context?.tags) {
+            Object.entries(context.tags).forEach(([key, value]) => {
+                scope.setTag(key, value);
+            });
+        }
+        if (context?.extra) {
+            Object.entries(context.extra).forEach(([key, value]) => {
+                scope.setExtra(key, value);
+            });
+        }
+        Sentry.captureMessage(message, context?.level || 'info');
+    });
+}
+/**
+ * Add breadcrumb for tracing event flow
+ */
+export function addBreadcrumb(message, data, category) {
+    Sentry.addBreadcrumb({
+        message,
+        data,
+        category: category || 'default',
+        level: 'info',
+    });
+}
+/**
+ * Wrap a function with Sentry error capturing
+ */
+export function withSentry(fn, context) {
+    return ((...args) => {
+        try {
+            const result = fn(...args);
+            // Handle async functions
+            if (result instanceof Promise) {
+                return result.catch((error) => {
+                    captureException(error, context);
+                    throw error;
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            captureException(error, context);
+            throw error;
+        }
+    });
+}
+/**
+ * Sanitize headers to remove sensitive data
+ */
+function sanitizeHeaders(headers) {
+    const sanitized = {};
+    const sensitiveHeaders = ['authorization', 'cookie', 'x-api-key'];
+    Object.entries(headers).forEach(([key, value]) => {
+        if (sensitiveHeaders.includes(key.toLowerCase())) {
+            sanitized[key] = '[REDACTED]';
+        }
+        else {
+            sanitized[key] = value;
+        }
+    });
+    return sanitized;
+}
+/**
+ * Helper to determine if an error should be tracked in Sentry
+ * based on its characteristics (e.g., status code, error code)
+ */
+export function shouldTrackError(statusCode, errorCode) {
+    // Always track 500 errors
+    if (statusCode >= 500) {
+        return true;
+    }
+    // Don't track expected client errors
+    const expectedErrors = ['UNAUTHORIZED', 'NOT_FOUND'];
+    if (errorCode && expectedErrors.includes(errorCode)) {
+        return false;
+    }
+    // Track other 4xx errors with sampling
+    return statusCode >= 400;
+}
+/**
+ * Get sample rate for different error types
+ */
+export function getSampleRate(errorCode) {
+    const sampleRates = {
+        // High-volume, expected errors - low sample rate
+        CART_EXPIRED: 0.1,
+        NOT_FOUND: 0.05,
+        CART_NOT_FOUND: 0.05,
+        ORDER_NOT_FOUND: 0.05,
+        VARIANT_NOT_FOUND: 0.05,
+        // Medium-volume errors - moderate sample rate
+        INVALID_DISCOUNT_CODE: 0.2,
+        MIN_PURCHASE_NOT_MET: 0.15,
+        PAYMENT_METHOD_NOT_AVAILABLE: 0.25,
+        INVALID_DELIVERY_ZONE: 0.3,
+        PRECONDITION_FAILED: 0.5,
+        // Low-volume errors - higher sample rate
+        BAD_REQUEST: 0.1,
+        CODE_EXISTS: 1.0,
+        STATE_EXISTS: 1.0,
+        // Default for unknown errors
+        DEFAULT: 1.0,
+    };
+    return sampleRates[errorCode] ?? sampleRates.DEFAULT;
+}

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

@@ -31,9 +31,13 @@ export async function enqueueAddToCartEvent(env, data) {
             fbp: data.fbp,
         },
         customData: {
-            value: data.price, // Unit price, not total
+            value: data.price * data.quantity, // Total value
             currency: 'NGN',
-            contentIds: [data.sku],
+            contents: [{
+                    id: data.sku,
+                    quantity: data.quantity,
+                    item_price: data.price,
+                }],
             contentName: data.productName,
             contentType: 'product',
             numItems: data.quantity,
@@ -106,6 +110,7 @@ export async function enqueuePurchaseEvent(env, order, options) {
             firstName: order.firstName,
             lastName: order.lastName,
             city: order.city,
+            state: order.deliveryZone.state.name,
             country: 'ng', // Nigeria
             clientIpAddress: options?.clientIpAddress,
             clientUserAgent: options?.clientUserAgent,
@@ -115,7 +120,11 @@ export async function enqueuePurchaseEvent(env, order, options) {
         customData: {
             value: Number(order.totalPrice),
             currency: 'NGN',
-            contentIds: order.items.map((item) => item.variant.sku),
+            contents: order.items.map((item) => ({
+                id: item.variant.sku,
+                quantity: item.quantity,
+                item_price: Number(item.priceAtPurchase),
+            })),
             contentType: 'product',
             numItems: order.items.reduce((sum, item) => sum + item.quantity, 0),
         },
@@ -151,12 +160,17 @@ export async function enqueueConfirmedPurchaseEvent(env, order) {
             firstName: order.firstName,
             lastName: order.lastName,
             city: order.city,
+            state: order.deliveryZone.state.name,
             country: 'ng', // Nigeria
         },
         customData: {
             value: Number(order.totalPrice),
             currency: 'NGN',
-            contentIds: order.items.map((item) => item.variant.sku),
+            contents: order.items.map((item) => ({
+                id: item.variant.sku,
+                quantity: item.quantity,
+                item_price: Number(item.priceAtPurchase),
+            })),
             contentType: 'product',
             numItems: order.items.reduce((sum, item) => sum + item.quantity, 0),
         },

package/dist/apps/backend/src/routes/admin/abandoned-carts.d.ts

@@ -10,8 +10,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                         createdAt: string;
                         updatedAt: string;
                         deletedAt: string;
-                        name: string;
                         id: string;
+                        name: string;
                         slug: string;
                         logoUrl: string | null;
                         siteUrl: string;
@@ -31,14 +31,14 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                     lastRecoveryAttemptAt: string;
                     recoveryDiscountCode: {
                         id: string;
+                        type: string;
+                        value: string;
                         createdAt: string;
                         updatedAt: string;
                         deletedAt: string;
                         brandId: string | null;
                         isActive: boolean;
                         code: string;
-                        type: string;
-                        value: string;
                         minPurchase: string;
                         maxDiscount: string;
                         usageLimit: number | null;
@@ -56,8 +56,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                         variant: {
                             price: number;
                             product: {
-                                name: string;
                                 id: string;
+                                name: string;
                                 slug: string;
                                 createdAt: string;
                                 updatedAt: string;
@@ -212,8 +212,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                                     };
                                 };
                             };
-                            name: string | null;
                             id: string;
+                            name: string | null;
                             createdAt: string;
                             updatedAt: string;
                             deletedAt: string;
@@ -344,8 +344,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                     createdAt: string;
                     updatedAt: string;
                     deletedAt: string;
-                    name: string;
                     id: string;
+                    name: string;
                     slug: string;
                     logoUrl: string | null;
                     siteUrl: string;
@@ -365,14 +365,14 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                 lastRecoveryAttemptAt: string;
                 recoveryDiscountCode: {
                     id: string;
+                    type: string;
+                    value: string;
                     createdAt: string;
                     updatedAt: string;
                     deletedAt: string;
                     brandId: string | null;
                     isActive: boolean;
                     code: string;
-                    type: string;
-                    value: string;
                     minPurchase: string;
                     maxDiscount: string;
                     usageLimit: number | null;
@@ -390,8 +390,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                     variant: {
                         price: number;
                         product: {
-                            name: string;
                             id: string;
+                            name: string;
                             slug: string;
                             createdAt: string;
                             updatedAt: string;
@@ -546,8 +546,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                                 };
                             };
                         };
-                        name: string | null;
                         id: string;
+                        name: string | null;
                         createdAt: string;
                         updatedAt: string;
                         deletedAt: string;

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

@@ -4,8 +4,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
         $get: {
             input: {};
             output: {
-                name: string;
                 id: string;
+                name: string;
                 slug: string;
                 logoUrl: string | null;
                 siteUrl: string;
@@ -52,8 +52,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                 };
             };
             output: {
-                name: string;
                 id: string;
+                name: string;
                 slug: string;
                 logoUrl: string | null;
                 siteUrl: string;
@@ -86,8 +86,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
         $post: {
             input: {};
             output: {
-                name: string;
                 id: string;
+                name: string;
                 slug: string;
                 logoUrl: string | null;
                 siteUrl: string;
@@ -120,8 +120,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                 };
             };
             output: {
-                name: string;
                 id: string;
+                name: string;
                 slug: string;
                 logoUrl: string | null;
                 siteUrl: string;

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

@@ -43,8 +43,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                         createdAt: string;
                         updatedAt: string;
                         deletedAt: string;
-                        name: string;
                         id: string;
+                        name: string;
                         slug: string;
                         logoUrl: string | null;
                         siteUrl: string;
@@ -61,18 +61,20 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                             createdAt: string;
                             updatedAt: string;
                             deletedAt: string;
-                            name: string;
                             id: string;
+                            name: string;
                             isActive: boolean;
                         };
-                        name: string;
                         id: string;
+                        name: string;
                         brandId: string | null;
                         stateId: string;
                         allowCOD: boolean;
                         allowOnline: boolean;
                         waybillOnly: boolean;
                         estimatedDays: number | null;
+                        noteTitle: string | null;
+                        noteContent: string | null;
                         isActive: boolean;
                     };
                     items: {
@@ -86,8 +88,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                                 createdAt: string;
                                 updatedAt: string;
                                 deletedAt: string;
-                                name: string;
                                 id: string;
+                                name: string;
                                 slug: string;
                                 brandId: string;
                                 isActive: boolean;
@@ -239,8 +241,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                                     };
                                 };
                             };
-                            name: string | null;
                             id: string;
+                            name: string | null;
                             isActive: boolean;
                             thumbnailUrl: string | null;
                             productId: string;
@@ -252,8 +254,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                             createdAt: string;
                             updatedAt: string;
                             deletedAt: string;
-                            name: string;
                             id: string;
+                            name: string;
                             isActive: boolean;
                             address: string | null;
                             city: string | null;
@@ -265,8 +267,8 @@ declare const app: import("hono/hono-base").HonoBase<AppContext, {
                         warehouseId: string | null;
                         quantity: number;
                     }[];
-                    id: string;
                     email: string | null;
+                    id: string;
                     brandId: string;
                     deliveryZoneId: string;
                     recoveryAttempts: number;