@teincfood/core 0.1.0

package/dist/sync/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Core types for the offline-first, event-driven Sync Engine.
+ *
+ * These types define the contract between:
+ *   - UI / Hooks
+ *   - Repositories
+ *   - Sync Engine
+ *   - Transports (REST, Local Node, queued)
+ *
+ * All timestamps are ISO strings. Monetary amounts remain in minor units.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sync/use-sync-reconciliation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Sync reconciliation bridge.
+ *
+ * Subscribes to domain events produced by the Sync Engine and:
+ *   - Applies order events to the pending-orders store (queued orders stay
+ *     visible until the cloud confirms them).
+ *   - Marks reconciled optimistic events as synced to cloud.
+ *   - Invalidates TanStack Query caches for affected entities.
+ */
+export declare function useSyncReconciliation(): void;

package/dist/sync/use-sync-reconciliation.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Sync reconciliation bridge.
+ *
+ * Subscribes to domain events produced by the Sync Engine and:
+ *   - Applies order events to the pending-orders store (queued orders stay
+ *     visible until the cloud confirms them).
+ *   - Marks reconciled optimistic events as synced to cloud.
+ *   - Invalidates TanStack Query caches for affected entities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSyncReconciliation = useSyncReconciliation;
+const react_1 = require("react");
+const react_query_1 = require("@tanstack/react-query");
+const engine_1 = require("./engine");
+const pending_orders_service_1 = require("./pending-orders.service");
+const local_node_1 = require("../adapters/local-node");
+const connection_1 = require("../db/connection");
+const operations_1 = require("../db/operations");
+const sync_logger_1 = require("../utils/sync-logger");
+const query_keys_1 = require("../adapters/query-keys");
+const events_1 = require("../reference/events");
+function isLocalOrderEvent(event) {
+    const payload = event.payload;
+    if (!payload)
+        return false;
+    const localOrderNumber = payload.local_order_number;
+    return typeof localOrderNumber === "string" && localOrderNumber.startsWith("TFL-");
+}
+function useSyncReconciliation() {
+    const queryClient = (0, react_query_1.useQueryClient)();
+    (0, react_1.useEffect)(() => {
+        // Reference changes re-sync offline data and refresh caches on this device
+        // and (via the LAN relay) on every connected terminal.
+        const unregisterReferenceInvalidator = (0, events_1.registerReferenceInvalidator)(() => {
+            queryClient.invalidateQueries({ queryKey: query_keys_1.MENU_KEYS.all });
+            queryClient.invalidateQueries({ queryKey: query_keys_1.REFERENCE_KEYS.all });
+            queryClient.invalidateQueries({ queryKey: query_keys_1.POS_KEYS.all });
+            queryClient.invalidateQueries({ queryKey: query_keys_1.SELLER_KEYS.all });
+        });
+        // Pending-order reconciliation invalidates POS + seller order lists so the
+        // server-confirmed order replaces the optimistic one. Invalidate from the
+        // broadest key: POS_KEYS.orders() without a businessId would produce
+        // ['pos','orders',undefined] which does not prefix-match business-scoped
+        // keys.
+        const unregisterInvalidator = (0, pending_orders_service_1.registerPendingOrdersInvalidator)(() => {
+            queryClient.invalidateQueries({ queryKey: query_keys_1.POS_KEYS.all });
+            queryClient.invalidateQueries({ queryKey: query_keys_1.SELLER_KEYS.all });
+        });
+        // Reference-change events are published through the Sync Engine but are
+        // not backed by a command, so the engine has no transport dependency on
+        // the reference module. Register the singleton once.
+        (0, events_1.registerReferenceEventEngine)(engine_1.syncEngine);
+        const unsubscribe = engine_1.syncEngine.subscribe(async (event) => {
+            sync_logger_1.syncLogger.event(event, "received");
+            // The node relays engine events (e.g. order.created when a queued
+            // command is replayed) to LAN clients so they reconcile their pending
+            // orders and refresh caches.
+            if (local_node_1.localNodeService.isLocalNode()) {
+                local_node_1.localNodeService.broadcastToClients(event);
+            }
+            // Reference data changed on this device but we are a LAN client (not the
+            // node): forward the event to the node so it rebroadcasts it to every
+            // other terminal (the node also applies it locally via its onRelayEvent
+            // hook). The node does not echo it back to this device.
+            if (event.event_type === events_1.REFERENCE_CHANGED_EVENT_TYPE &&
+                !local_node_1.localNodeService.isLocalNode()) {
+                local_node_1.localNodeService.getClient()?.publishEvent?.(event);
+            }
+            // Reference data changed (locally or echoed from the cloud): re-sync the
+            // affected keys and refresh caches on this device.
+            await (0, events_1.applyReferenceChangeEvent)(event, "local");
+            // Order/delivery state changed: refresh order caches so this terminal
+            // shows the same order states as the device that made the change.
+            await (0, pending_orders_service_1.applyOrderStateChangeEvent)(event, "local");
+            // Route both queued (optimistic) and reconciled (created) order events
+            // into the pending-orders store.
+            if (event.event_type === "order.create_queued" ||
+                event.event_type === "order.created") {
+                await (0, pending_orders_service_1.applyPendingOrderEvent)(event, "local");
+            }
+            if (event.event_type === "order.created" && isLocalOrderEvent(event)) {
+                try {
+                    const db = (0, connection_1.getSyncDatabase)();
+                    await (0, operations_1.markEventsSynced)(db, [event.event_id]);
+                }
+                catch (error) {
+                    sync_logger_1.syncLogger.error("Reconciliation", "Failed to mark event synced", {
+                        error: String(error),
+                    });
+                }
+                const payload = event.payload;
+                const businessId = payload.business_id;
+                if (businessId) {
+                    queryClient.invalidateQueries({ queryKey: query_keys_1.POS_KEYS.orders(businessId) });
+                    queryClient.invalidateQueries({ queryKey: query_keys_1.SELLER_KEYS.all });
+                }
+            }
+        });
+        return () => {
+            unsubscribe();
+            unregisterInvalidator();
+            unregisterReferenceInvalidator();
+        };
+    }, [queryClient]);
+}

package/dist/types/api/auth.api.d.ts

@@ -0,0 +1,61 @@
+export interface RegisterRequest {
+    email: string;
+    password: string;
+    full_name: string;
+    phone?: string;
+}
+export interface LoginRequest {
+    email: string;
+    password: string;
+}
+export interface OTPRequest {
+    phone: string;
+    purpose?: 'login' | 'register';
+}
+export interface OTPVerifyRequest {
+    phone: string;
+    code: string;
+    type?: 'login' | 'register';
+}
+export interface OIDCRequest {
+    provider: 'google' | 'apple' | 'facebook';
+    id_token: string;
+}
+export interface AuthResponse {
+    access_token: string;
+    refresh_token: string;
+    user: AuthUser;
+}
+export interface AuthUser {
+    id: string;
+    email: string | null;
+    full_name: string | null;
+    phone: string | null;
+    avatar_url: string | null;
+    has_password: boolean;
+    roles: string[];
+}
+export interface RegisterResponse {
+    status: string;
+    message: string;
+    user: {
+        email: string;
+        full_name: string;
+        has_password: boolean;
+        roles: string[];
+    };
+}
+export interface RefreshResponse {
+    access_token: string;
+    refresh_token: string;
+}
+export interface ForgotPasswordRequest {
+    email: string;
+}
+export interface ResetPasswordRequest {
+    token: string;
+    password: string;
+}
+export interface VerifyEmailRequest {
+    token: string;
+}

package/dist/types/api/auth.api.js

@@ -0,0 +1,3 @@
+"use strict";
+// ─── Auth Requests ───
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/business.api.d.ts

@@ -0,0 +1,137 @@
+export interface Business {
+    id: string;
+    name: string;
+    description: string;
+    type: string;
+    phone: string;
+    email: string;
+    status: string;
+    currency: string;
+    is_open: boolean;
+    owner_id: string;
+    business_number: string;
+    latitude: number;
+    longitude: number;
+    logo_url: string | null;
+    cover_image_url: string | null;
+    kyc_status: string;
+    rating: number | null;
+    address?: {
+        street: string;
+        city: string;
+        region?: string;
+        country?: string;
+        latitude?: number;
+        longitude?: number;
+    } | null;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface BusinessResponse {
+    data: Business;
+}
+export interface BusinessListResponse {
+    data: Business[];
+}
+export interface BusinessMembershipBusiness {
+    id: string;
+    business_number: string;
+    name: string;
+    type: string;
+    status: string;
+    logo_url: string | null;
+    cover_image_url: string | null;
+}
+export interface BusinessMembership {
+    business: BusinessMembershipBusiness;
+    role: string;
+    status: string;
+    source: string | null;
+    invited_by_user_id: string | null;
+}
+export interface BusinessMembershipListResponse {
+    data: BusinessMembership[];
+}
+export interface BusinessMembershipDetail {
+    business_id: string;
+    role: string;
+    source: string;
+    status: string;
+    capabilities: string[];
+}
+export interface BusinessMembershipResponse {
+    data: BusinessMembershipDetail;
+}
+export interface BusinessMember {
+    id: string;
+    user_id: string;
+    role: string;
+    status: string;
+    inserted_at: string;
+}
+export interface BusinessMemberListResponse {
+    data: BusinessMember[];
+}
+export interface OperatingHoursEntry {
+    id?: string;
+    day_of_week: number;
+    open_time: string | null;
+    close_time: string | null;
+    is_closed: boolean;
+}
+export interface OperatingHoursResponse {
+    data: OperatingHoursEntry[];
+}
+export interface DayHours {
+    open: string;
+    close: string;
+}
+export interface Promo {
+    id: string;
+    code: string;
+    discount_percent: number | null;
+    discount_minor: number | null;
+    max_uses: number | null;
+    used_count: number;
+    expires_at: string | null;
+    is_active: boolean;
+    business_id: string;
+}
+export interface PromoListResponse {
+    data: Promo[];
+}
+export interface PromoResponse {
+    data: Promo;
+}
+export interface TaxRule {
+    id: string;
+    business_id: string;
+    name: string;
+    code: string;
+    country_code: string;
+    rate_basis_points: number;
+    applies_to: 'subtotal' | 'subtotal_plus_delivery';
+    is_inclusive: boolean;
+    is_active: boolean;
+    display_order: number;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface TaxRuleListResponse {
+    data: TaxRule[];
+}
+export interface TaxRuleResponse {
+    data: TaxRule;
+}
+export interface TaxRuleRequest {
+    tax_rule: {
+        name: string;
+        code: string;
+        country_code: string;
+        rate_basis_points: number;
+        applies_to: 'subtotal' | 'subtotal_plus_delivery';
+        is_inclusive: boolean;
+        is_active: boolean;
+        display_order?: number;
+    };
+}

package/dist/types/api/business.api.js

@@ -0,0 +1,3 @@
+"use strict";
+// ─── Business ───
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/conversation.api.d.ts

@@ -0,0 +1,46 @@
+import type { PaginationMeta } from './pagination';
+export interface ConversationParticipant {
+    id: string;
+    user_id: string;
+    archived_at: string | null;
+}
+export interface Conversation {
+    id: string;
+    type: string;
+    status: string;
+    assigned_agent_id: string | null;
+    order_id: string | null;
+    participants: ConversationParticipant[];
+    inserted_at: string;
+    updated_at: string;
+}
+export interface ConversationMessage {
+    id: string;
+    content: string;
+    sender_id: string;
+    conversation_id: string;
+    direction: string;
+    channel: string;
+    message_type: string;
+    status: string;
+    external_id: string | null;
+    metadata: Record<string, unknown> | null;
+    replied_by_id: string | null;
+    read: boolean;
+    inserted_at: string;
+}
+export interface ConversationListResponse {
+    data: Conversation[];
+    pagination: PaginationMeta;
+}
+export interface ConversationResponse {
+    data: Conversation;
+}
+export interface ConversationMessagesResponse {
+    data: ConversationMessage[];
+    meta: {
+        limit: number;
+        offset: number;
+        count: number;
+    };
+}

package/dist/types/api/conversation.api.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/error.api.d.ts

@@ -0,0 +1,8 @@
+export interface ApiErrorContent {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface ApiErrorResponse {
+    error: ApiErrorContent | string;
+}

package/dist/types/api/error.api.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/fleet.api.d.ts

@@ -0,0 +1,98 @@
+export interface FleetRiderUser {
+    id: string;
+    full_name: string;
+    phone?: string;
+    avatar_url?: string;
+}
+export interface FleetRiderVehicle {
+    id: string;
+    type: string;
+    plate_number: string;
+    brand: string | null;
+    model: string | null;
+    color: string | null;
+    year: number | null;
+}
+export interface FleetRider {
+    id: string;
+    rider_number: string;
+    status: string;
+    is_online: boolean;
+    is_fleet_managed: boolean;
+    is_active: boolean;
+    phone: string;
+    license_number: string;
+    kyc_status: string;
+    user: FleetRiderUser | null;
+    vehicle: FleetRiderVehicle | null;
+    inserted_at: string;
+}
+export interface FleetRiderResponse {
+    data: FleetRider;
+}
+export interface FleetKycDocument {
+    type: string;
+    name: string;
+    url: string | null;
+    signed_url: string | null;
+    document_id: string | null;
+    issued_date: string | null;
+    expiration_date: string | null;
+    expired: boolean;
+}
+export interface FleetRiderKyc {
+    rider_id: string;
+    kyc_status: string;
+    submitted_at: string | null;
+    verified_at: string | null;
+    documents: FleetKycDocument[];
+}
+export interface FleetRiderKycResponse {
+    data: FleetRiderKyc;
+}
+export interface FleetVehicle {
+    id: string;
+    rider_id: string | null;
+    plate_number: string;
+    type: string;
+    ownership: string;
+    brand?: string;
+    model?: string;
+    color?: string;
+    year?: number;
+    rider_number?: string;
+    rider_name?: string;
+    inserted_at: string;
+}
+export interface FleetRidersResponse {
+    data: FleetRider[];
+}
+export interface FleetVehiclesResponse {
+    data: FleetVehicle[];
+}
+export interface JoinRequest {
+    id: string;
+    user_id: string;
+    rider_number: string;
+    status: string;
+    inserted_at: string;
+}
+export interface FleetInvitation {
+    id: string;
+    business_id: string;
+    status: string;
+    inserted_at: string;
+}
+export interface FleetDashboard {
+    total_riders: number;
+    active_riders: number;
+    online_riders: number;
+    offline_riders: number;
+    total_vehicles: number;
+    today_deliveries: number;
+    today_earnings_minor: number;
+    pending_join_requests: number;
+}
+export interface FleetDashboardResponse {
+    data: FleetDashboard;
+}

package/dist/types/api/fleet.api.js

@@ -0,0 +1,3 @@
+"use strict";
+// ─── Fleet Rider ───
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/index.d.ts

@@ -0,0 +1,11 @@
+export * from './pagination';
+export * from './auth.api';
+export * from './rider.api';
+export * from './seller.api';
+export * from './fleet.api';
+export * from './kiosk.api';
+export * from './menu.api';
+export * from './business.api';
+export * from './wallet.api';
+export * from './conversation.api';
+export * from './error.api';

package/dist/types/api/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pagination"), exports);
+__exportStar(require("./auth.api"), exports);
+__exportStar(require("./rider.api"), exports);
+__exportStar(require("./seller.api"), exports);
+__exportStar(require("./fleet.api"), exports);
+__exportStar(require("./kiosk.api"), exports);
+__exportStar(require("./menu.api"), exports);
+__exportStar(require("./business.api"), exports);
+__exportStar(require("./wallet.api"), exports);
+__exportStar(require("./conversation.api"), exports);
+__exportStar(require("./error.api"), exports);

package/dist/types/api/kiosk.api.d.ts

@@ -0,0 +1,4 @@
+import type { PaginatedResponse } from './pagination';
+import type { SellerOrder } from './seller.api';
+export type KioskOrder = SellerOrder;
+export type KioskOrdersResponse = PaginatedResponse<KioskOrder>;

package/dist/types/api/kiosk.api.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/menu.api.d.ts

@@ -0,0 +1,90 @@
+import type { PaginationMeta } from './pagination';
+export interface Money {
+    amountMinor: number;
+    currencyCode: string;
+}
+export interface MenuItemVariantResponse {
+    id: string;
+    name: string;
+    price: Money;
+}
+export interface MenuItemAddonResponse {
+    id: string;
+    name: string;
+    pricingType: string;
+    amountMinor: number;
+    currencyCode: string;
+}
+export interface MenuItemCategory {
+    id: string;
+    name: string;
+}
+export interface MenuItemBusiness {
+    id: string;
+    name: string;
+    distance?: number;
+    is_open?: boolean;
+}
+export interface MenuItem {
+    id: string;
+    name: string;
+    description: string | null;
+    basePrice: Money;
+    image_url: string | null;
+    is_available: boolean;
+    dietary_tags: string[];
+    category_id: string;
+    business_id: string;
+    category: MenuItemCategory | null;
+    variants: MenuItemVariantResponse[];
+    extras: MenuItemAddonResponse[];
+    business?: MenuItemBusiness;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface MenuItemResponse {
+    data: MenuItem;
+}
+export interface MenuItemListResponse {
+    data: MenuItem[];
+    pagination: PaginationMeta;
+}
+export interface MenuItemVariant {
+    id: string;
+    name: string;
+    price_adjustment: number;
+}
+export interface MenuItemAddon {
+    id: string;
+    name: string;
+    price_minor: number;
+}
+export interface MenuCategory {
+    id: string;
+    name: string;
+    sort_order: number;
+    is_global: boolean;
+    is_system: boolean;
+    pending_global_request: boolean;
+}
+export interface MenuCategoryListResponse {
+    data: MenuCategory[];
+}
+export interface CatalogItemRequest {
+    name: string;
+    description: string;
+    price_minor: number;
+    category_id: string;
+    currency_code: string;
+    dietary_tags?: string[];
+    variants: {
+        name: string;
+        price_adjustment: number;
+    }[];
+    extras: {
+        name: string;
+        price_minor: number;
+    }[];
+    available: boolean;
+    image_url?: string | null;
+}

package/dist/types/api/menu.api.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/api/pagination.d.ts

@@ -0,0 +1,10 @@
+export interface PaginationMeta {
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}

package/dist/types/api/pagination.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });