@teincfood/core 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export { formatDate, formatRelativeTime } from "./utils/formatDate";
 export * from "./utils/validation";
 export * from "./utils/responsive";
 export * from "./utils/copyToClipBoard";
+export * from "./utils/customer-display";
+export * from "./utils/order-filter";
 export * from "./db/migrations";
 export * from "./db/operations";
 export * as dbOps from "./db/operations";

package/dist/index.js

@@ -21,6 +21,8 @@ export { formatDate, formatRelativeTime } from "./utils/formatDate";
 export * from "./utils/validation";
 export * from "./utils/responsive";
 export * from "./utils/copyToClipBoard";
+export * from "./utils/customer-display";
+export * from "./utils/order-filter";
 // ── DB ──
 export * from "./db/migrations";
 export * from "./db/operations";

package/dist/utils/customer-display.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Customer display helpers — offline-first, shared by mobile + desktop.
+ * SellerOrder shape comes from backend order_serializer (customer_name, is_pos, user{full_name, avatar_url, phone}).
+ */
+import type { SellerOrder } from "../types/api/seller.api";
+export type CustomerDisplay = {
+    name: string;
+    avatarUrl: string | null;
+    phone: string | null;
+    isWalkIn: boolean;
+    tellerName?: string | null;
+};
+type OrderLike = Pick<SellerOrder, "customer_name"> & {
+    user?: {
+        full_name?: string;
+        avatar_url?: string;
+        phone?: string;
+    } | null;
+    customer_phone?: string | null;
+    is_pos?: boolean;
+};
+/**
+ * Single source of truth for customer identity.
+ * - is_pos:true (POS walk-in): customer is walk-in/typed name, never the staff user.
+ *   Staff is the teller (order.user) — do not show staff avatar as customer.
+ *   Returns tellerName so UI can optionally show "Teller: <name>" underneath.
+ * - is_pos:false (WhatsApp / online / AI agent): customer_name || user.full_name || "Customer" + avatar from user.avatar_url
+ */
+export declare function getCustomerDisplay(order: OrderLike): CustomerDisplay;
+export declare function getCustomerSearchKeys(order: OrderLike): string[];
+export declare function matchesCustomerSearch(order: OrderLike, qLower: string): boolean;
+export {};

package/dist/utils/customer-display.js

@@ -0,0 +1,55 @@
+/**
+ * Customer display helpers — offline-first, shared by mobile + desktop.
+ * SellerOrder shape comes from backend order_serializer (customer_name, is_pos, user{full_name, avatar_url, phone}).
+ */
+/**
+ * Single source of truth for customer identity.
+ * - is_pos:true (POS walk-in): customer is walk-in/typed name, never the staff user.
+ *   Staff is the teller (order.user) — do not show staff avatar as customer.
+ *   Returns tellerName so UI can optionally show "Teller: <name>" underneath.
+ * - is_pos:false (WhatsApp / online / AI agent): customer_name || user.full_name || "Customer" + avatar from user.avatar_url
+ */
+export function getCustomerDisplay(order) {
+    if (order.is_pos) {
+        const walkName = order.customer_name?.trim() ? order.customer_name.trim() : "Walk-in";
+        return {
+            name: walkName,
+            avatarUrl: null,
+            phone: order.customer_phone ?? null,
+            isWalkIn: true,
+            tellerName: order.user?.full_name?.trim() ?? null,
+        };
+    }
+    const rawName = order.customer_name?.trim()
+        ? order.customer_name.trim()
+        : order.user?.full_name?.trim() ?? "";
+    if (rawName) {
+        return {
+            name: rawName,
+            avatarUrl: order.user?.avatar_url ?? null,
+            phone: order.customer_phone ?? order.user?.phone ?? null,
+            isWalkIn: false,
+        };
+    }
+    return {
+        name: "Customer",
+        avatarUrl: order.user?.avatar_url ?? null,
+        phone: order.customer_phone ?? order.user?.phone ?? null,
+        isWalkIn: false,
+    };
+}
+export function getCustomerSearchKeys(order) {
+    return [
+        order.customer_name ?? "",
+        order.user?.full_name ?? "",
+        order.customer_phone ?? "",
+        order.user?.phone ?? "",
+        order.user?.avatar_url ?? "",
+    ];
+}
+export function matchesCustomerSearch(order, qLower) {
+    if (!qLower)
+        return true;
+    const hay = `${order.customer_name ?? ""} ${order.user?.full_name ?? ""} ${order.customer_phone ?? ""} ${order.user?.phone ?? ""}`.toLowerCase();
+    return hay.includes(qLower);
+}

package/dist/utils/order-filter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Offline order list helpers — shared filtering + pagination for
+ * usePOSOrdersQuery / useSellerOrdersQuery snapshot fallbacks.
+ */
+import type { SellerOrder } from "../types/api/seller.api";
+export declare function filterOrdersOffline(orders: SellerOrder[], filters?: {
+    status?: string;
+    order_type?: string;
+    is_pos?: string;
+    q?: string;
+    search?: string;
+}): SellerOrder[];
+export declare function filterSellerOrdersOffline(orders: SellerOrder[], filters?: {
+    status?: string;
+    q?: string;
+}): SellerOrder[];
+export declare function paginateOffline<T>(orders: T[], page: number, pageSize?: number): {
+    data: T[];
+    pagination: {
+        page: number;
+        page_size: number;
+        total_pages: number;
+        total_count: number;
+    };
+};

package/dist/utils/order-filter.js

@@ -0,0 +1,41 @@
+/**
+ * Offline order list helpers — shared filtering + pagination for
+ * usePOSOrdersQuery / useSellerOrdersQuery snapshot fallbacks.
+ */
+import { matchesCustomerSearch } from "./customer-display";
+export function filterOrdersOffline(orders, filters) {
+    let filtered = orders;
+    const statusSet = filters?.status ? new Set(filters.status.split(",").map((s) => s.trim())) : null;
+    if (statusSet)
+        filtered = filtered.filter((o) => statusSet.has(o.status));
+    if (filters?.order_type)
+        filtered = filtered.filter((o) => (o.order_type ?? "pos") === filters.order_type);
+    if (filters?.is_pos !== undefined) {
+        const wantPos = filters.is_pos === "true" || filters.is_pos === "1";
+        filtered = filtered.filter((o) => !!o.is_pos === wantPos);
+    }
+    const q = (filters?.q ?? filters?.search ?? "").toLowerCase();
+    if (q) {
+        filtered = filtered.filter((o) => o.order_number.toLowerCase().includes(q) ||
+            matchesCustomerSearch(o, q));
+    }
+    return filtered;
+}
+export function filterSellerOrdersOffline(orders, filters) {
+    let filtered = orders;
+    if (filters?.status) {
+        const set = new Set(filters.status.split(",").map((s) => s.trim()));
+        filtered = filtered.filter((o) => set.has(o.status));
+    }
+    if (filters?.q) {
+        const q = filters.q.toLowerCase();
+        filtered = filtered.filter((o) => o.order_number.toLowerCase().includes(q) || matchesCustomerSearch(o, q));
+    }
+    return filtered;
+}
+export function paginateOffline(orders, page, pageSize = 20) {
+    const start = (page - 1) * pageSize;
+    const slice = orders.slice(start, start + pageSize);
+    const totalPages = Math.max(1, Math.ceil(orders.length / pageSize));
+    return { data: slice, pagination: { page, page_size: pageSize, total_pages: totalPages, total_count: orders.length } };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teincfood/core",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "TeincFood shared offline-first core — types, sync engine, local DB, reference data, and repositories for mobile + desktop",
   "type": "module",
   "main": "dist/index.js",