@teincfood/core 0.1.0

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

@@ -0,0 +1,179 @@
+import type { PaginationMeta, PaginatedResponse } from './pagination';
+export interface RiderProfileBusiness {
+    id: string;
+    name: string;
+    business_number: string;
+    type: string;
+    status: string;
+    logo_url: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    address: {
+        address_line: string;
+        city: string;
+        region: string;
+        latitude: number | null;
+        longitude: number | null;
+    } | null;
+}
+export interface RiderProfile {
+    id: string;
+    rider_number: string;
+    user_id: string;
+    status: string;
+    is_online: boolean;
+    is_fleet_managed: boolean;
+    is_active: boolean;
+    current_lat: number | null;
+    current_lng: number | null;
+    businesses: RiderProfileBusiness[];
+    phone: string;
+    license_number: string;
+    kyc_status: string;
+    vehicle_type: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface RiderProfileResponse {
+    data: RiderProfile;
+}
+export interface RiderKycResponse {
+    data: {
+        kyc_status: string;
+        documents?: string[];
+    };
+}
+export interface RiderDelivery {
+    id: string;
+    order_id: string;
+    order_number: string | null;
+    status: string;
+    pickup_name: string | null;
+    pickup: string | null;
+    dropoff: string | null;
+    pickup_lat: number;
+    pickup_lng: number;
+    dropoff_lat: number;
+    dropoff_lng: number;
+    eta_minutes: number;
+    earnings_minor: number | null;
+    currency: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+export type RiderDeliveriesResponse = PaginatedResponse<RiderDelivery>;
+export interface RiderEarningsResponse {
+    data: Record<string, unknown>[];
+    pagination: PaginationMeta;
+    total_earned_minor: number;
+    currency: string;
+}
+export interface RiderEarningsSummaryResponse {
+    data: {
+        total_earnings_minor: number;
+        total_deliveries: number;
+        currency: string;
+        period: string;
+    };
+}
+export interface RiderVehicle {
+    id: string;
+    rider_id: string;
+    plate_number: string;
+    type: string;
+    ownership: string;
+    brand: string | null;
+    model: string | null;
+    color: string | null;
+    year: number | null;
+    inserted_at: string;
+}
+export interface RiderVehicleRequest {
+    type: string;
+    plate_number: string;
+    brand: string;
+    model: string;
+    color: string;
+    year?: number;
+    ownership?: string;
+}
+export interface RiderVehicleResponse {
+    data: RiderVehicle | null;
+}
+export interface AvailableOrder {
+    order_id: string;
+    order_number: string;
+    total_minor: number;
+    currency: string;
+    payment_mode: string;
+    business_name: string;
+    business_address: string | null;
+    business_lat: number | null;
+    business_lng: number | null;
+    delivery_address: Record<string, unknown> | string | null;
+    delivery_lat: number | null;
+    delivery_lng: number | null;
+    inserted_at: string;
+}
+export interface AvailableOrdersResponse {
+    data: AvailableOrder[];
+}
+export interface RiderDashboard {
+    today_earnings_minor: number;
+    today_deliveries: number;
+    available_deliveries: number;
+    total_deliveries: number;
+    status: string;
+}
+export interface RiderDashboardResponse {
+    data: RiderDashboard;
+}
+export interface DeliveryCustomer {
+    name: string | null;
+    phone: string | null;
+    user_id: string | null;
+}
+export interface DeliveryPickupLocation {
+    name: string | null;
+    address: string | null;
+    phone: string | null;
+    lat: number | null;
+    lng: number | null;
+}
+export interface DeliveryDropoffLocation {
+    name: string | null;
+    address: string | null;
+    lat: number | null;
+    lng: number | null;
+    notes: string | null;
+}
+export interface DeliveryItem {
+    name: string | null;
+    quantity: number;
+    price: number;
+}
+export interface RiderDeliveryDetail {
+    id: string;
+    order_id: string;
+    order_number: string | null;
+    status: string;
+    pickup_lat: number | null;
+    pickup_lng: number | null;
+    dropoff_lat: number | null;
+    dropoff_lng: number | null;
+    eta_minutes: number | null;
+    rider_pickup_confirmed_at: string | null;
+    merchant_handover_confirmed_at: string | null;
+    inserted_at: string;
+    updated_at: string;
+    customer: DeliveryCustomer;
+    pickup: DeliveryPickupLocation;
+    dropoff: DeliveryDropoffLocation;
+    items: DeliveryItem[];
+    order_total_minor: number | null;
+    delivery_fee_minor: number | null;
+    currency: string | null;
+}
+export interface RiderDeliveryDetailResponse {
+    data: RiderDeliveryDetail;
+}

package/dist/types/api/rider.api.js

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

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

@@ -0,0 +1,164 @@
+import type { PaginatedResponse } from './pagination';
+export interface OrderUser {
+    id: string;
+    full_name: string;
+    email: string;
+    phone: string;
+    avatar_url: string | null;
+}
+export interface OrderPayment {
+    is_paid: boolean;
+    reference: string | null;
+    amount_minor: number | null;
+    currency: string | null;
+    paid_at: string | null;
+}
+export interface OrderMenuItem {
+    id: string;
+    name: string;
+}
+export interface OrderItemAddon {
+    id: string;
+    price: number;
+}
+export interface OrderItem {
+    id: string;
+    menu_item: OrderMenuItem | null;
+    quantity: number;
+    unit_price: number;
+    subtotal: number;
+    addons?: OrderItemAddon[];
+}
+export interface OrderBusiness {
+    id: string;
+    name: string;
+    phone?: string;
+    latitude?: number;
+    longitude?: number;
+    estimated_delivery_time?: number;
+}
+export interface OrderDeliveryAddress {
+    apartment?: string;
+    city?: string;
+    full_address?: string;
+    id?: string;
+    label?: string;
+    place_id?: string;
+    street?: string;
+    latitude?: number;
+    longitude?: number;
+}
+export interface OrderTaxLine {
+    id: string | null;
+    business_tax_rule_id: string | null;
+    name: string | null;
+    code: string | null;
+    country_code: string | null;
+    rate_basis_points: number | null;
+    taxable_amount_minor: number | null;
+    tax_amount_minor: number | null;
+    applies_to: string | null;
+    is_inclusive: boolean | null;
+}
+export interface DeliveryPerson {
+    id: string;
+    name: string | null;
+    phone: string | null;
+    avatar_url: string | null;
+    current_latitude: number | null;
+    current_longitude: number | null;
+    rating: number | null;
+    vehicle_type: string | null;
+}
+export interface StatusHistoryEntry {
+    status: string;
+    inserted_at: string;
+}
+export interface SellerOrder {
+    id: string;
+    order_number: string;
+    callout_number: number | null;
+    order_type: string | null;
+    is_pos: boolean;
+    customer_name: string | null;
+    customer_phone: string | null;
+    pos_payment_method: string | null;
+    paid_at: string | null;
+    status: string;
+    delivery_id: string | null;
+    delivery_status: string | null;
+    is_paid: boolean;
+    payment: OrderPayment;
+    payment_mode: string;
+    total_minor: number;
+    subtotal_minor: number;
+    delivery_fee_minor: number;
+    tax_minor: number;
+    tip_minor: number | null;
+    discount_minor: number;
+    promo_code: string | null;
+    tax_lines: OrderTaxLine[];
+    currency: string;
+    currency_code: string;
+    business_id: string;
+    business: OrderBusiness | null;
+    delivery_address: OrderDeliveryAddress | null;
+    delivery_lat: number | null;
+    delivery_lng: number | null;
+    user: OrderUser | null;
+    items: OrderItem[];
+    inserted_at: string;
+}
+export interface SellerOrderDetail extends SellerOrder {
+    notes: string | null;
+    delivery_person: DeliveryPerson | null;
+    delivery_id: string | null;
+    delivery_status: string | null;
+    merchant_handover_confirmed_at: string | null;
+    rider_pickup_confirmed_at: string | null;
+    eta_minutes: number | null;
+    status_history: StatusHistoryEntry[];
+    business: OrderBusiness | null;
+    items: OrderItem[];
+}
+export type SellerOrdersResponse = PaginatedResponse<SellerOrder>;
+export interface SellerOrderDetailResponse {
+    data: SellerOrderDetail;
+}
+export interface DeliveryOrderItem {
+    id: string;
+    menu_item: OrderMenuItem | null;
+    quantity: number;
+    unit_price: number;
+    subtotal: number;
+}
+export interface DeliveryRider {
+    id: string;
+    rider_number: string | null;
+    name: string | null;
+    phone: string | null;
+    avatar_url: string | null;
+}
+export interface BusinessDelivery {
+    id: string;
+    status: string;
+    rider_pickup_confirmed_at: string | null;
+    merchant_handover_confirmed_at: string | null;
+    inserted_at: string;
+    order: {
+        id: string;
+        order_number: string;
+        status: string;
+        customer_name: string | null;
+        customer_phone: string | null;
+        total_minor: number;
+        subtotal_minor: number;
+        delivery_fee_minor: number;
+        currency: string;
+        delivery_address: OrderDeliveryAddress | null;
+        user: OrderUser | null;
+        items: DeliveryOrderItem[];
+    } | null;
+    rider: DeliveryRider | null;
+}
+export type BusinessDeliveriesResponse = PaginatedResponse<BusinessDelivery>;

package/dist/types/api/seller.api.js

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

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

@@ -0,0 +1,27 @@
+import type { PaginationMeta } from './pagination';
+export interface WalletBalanceItem {
+    type: 'buyer' | 'business' | 'rider';
+    amount_minor: number;
+    currency: string;
+    business_id?: string;
+}
+export interface WalletBalanceResponse {
+    data: {
+        balances: WalletBalanceItem[];
+    };
+}
+export interface WalletEntry {
+    id: string;
+    type: string;
+    amount_minor: number;
+    currency: string;
+    balance_after: number;
+    description: string | null;
+    inserted_at: string;
+}
+export interface WalletHistoryResponse {
+    data: {
+        entries: WalletEntry[];
+    };
+    pagination: PaginationMeta;
+}

package/dist/types/api/wallet.api.js

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

package/dist/types/pos.types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * POS types — minimal shapes used by sync transports and repositories.
+ */
+export interface POSOrderItem {
+    menu_item_id: string;
+    quantity: number;
+    addons?: unknown[];
+}
+export interface POSOrderCreateRequest {
+    items: POSOrderItem[];
+    order_type?: string;
+    customer_name?: string | null;
+    customer_phone?: string | null;
+    pos_payment_method?: string;
+    total_minor?: number;
+    order_number?: string;
+    command_id?: string;
+    local_order_number?: string;
+    [key: string]: unknown;
+}
+export interface POSOrderPreviewRequest {
+    items: POSOrderItem[];
+    order_type: string;
+    customer_name?: string;
+    [key: string]: unknown;
+}
+export interface POSOrderPreviewResponse {
+    total_minor: number;
+    subtotal_minor: number;
+    tax_minor: number;
+    delivery_fee_minor: number;
+    [key: string]: unknown;
+}

package/dist/types/pos.types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * POS types — minimal shapes used by sync transports and repositories.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/constants.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Application-wide constants — plain config, no expo dependencies.
+ * Values can be overridden via createTeincCore config (future).
+ */
+/** Base URL for the API — will be swapped per environment */
+export declare const API_BASE_URL: string;
+/** WebSocket URL for Phoenix Channels */
+export declare const WS_BASE_URL: string;
+/** App metadata */
+export declare const APP_NAME = "Teinc Food Business";
+export declare const APP_VERSION = "1.0.0";
+/** Async storage keys */
+export declare const STORAGE_KEYS: {
+    readonly AUTH_TOKEN: "auth_token";
+    readonly REFRESH_TOKEN: "refresh_token";
+    readonly USER_PROFILE: "user_profile";
+    readonly HAS_SEEN_ONBOARDING: "has_seen_onboarding";
+    readonly THEME_PREFERENCE: "theme_preference";
+    readonly BUSINESS_DATA: "business_data";
+    readonly FLEET_DATA: "fleet_data";
+    readonly LOCAL_NODE_DATA: "local_node_data";
+    readonly PRINTER_SETTINGS: "printer_settings";
+};
+/** Chat storage keys */
+export declare const CHAT_STORAGE_KEYS: {
+    readonly MESSAGES: "chat_messages";
+    readonly OUTBOX: "chat_outbox";
+};
+/** Chat configuration */
+export declare const CHAT_CONFIG: {
+    readonly HEARTBEAT_INTERVAL_MS: 15000;
+    readonly HEARTBEAT_TIMEOUT_MS: 10000;
+    readonly RECONNECT_BASE_DELAY_MS: 1000;
+    readonly RECONNECT_MAX_DELAY_MS: 30000;
+    readonly RECONNECT_MAX_ATTEMPTS: 10;
+    readonly TYPING_TIMEOUT_MS: 3000;
+    readonly MESSAGE_PAGE_SIZE: 50;
+};
+/** OTP configuration */
+export declare const OTP_LENGTH = 4;
+export declare const OTP_RESEND_DELAY_SECONDS = 60;
+/** Pagination defaults */
+export declare const DEFAULT_PAGE_SIZE = 20;
+/**
+ * Max time the Sync Engine waits for a cloud command before treating the cloud
+ * as unreachable and falling back to the Local Node or the offline outbox.
+ * Keeps the terminal responsive (fast) even when the internet is slow.
+ */
+export declare const CLOUD_COMMAND_TIMEOUT_MS = 2500;
+export declare const appVersion = "1.0.0";
+/** Default config bundle for createTeincCore overrides */
+export declare const DEFAULTS: {
+    readonly API_BASE_URL: string;
+    readonly WS_BASE_URL: string;
+    readonly APP_NAME: "Teinc Food Business";
+    readonly APP_VERSION: "1.0.0";
+    readonly STORAGE_KEYS: {
+        readonly AUTH_TOKEN: "auth_token";
+        readonly REFRESH_TOKEN: "refresh_token";
+        readonly USER_PROFILE: "user_profile";
+        readonly HAS_SEEN_ONBOARDING: "has_seen_onboarding";
+        readonly THEME_PREFERENCE: "theme_preference";
+        readonly BUSINESS_DATA: "business_data";
+        readonly FLEET_DATA: "fleet_data";
+        readonly LOCAL_NODE_DATA: "local_node_data";
+        readonly PRINTER_SETTINGS: "printer_settings";
+    };
+    readonly CHAT_STORAGE_KEYS: {
+        readonly MESSAGES: "chat_messages";
+        readonly OUTBOX: "chat_outbox";
+    };
+    readonly CHAT_CONFIG: {
+        readonly HEARTBEAT_INTERVAL_MS: 15000;
+        readonly HEARTBEAT_TIMEOUT_MS: 10000;
+        readonly RECONNECT_BASE_DELAY_MS: 1000;
+        readonly RECONNECT_MAX_DELAY_MS: 30000;
+        readonly RECONNECT_MAX_ATTEMPTS: 10;
+        readonly TYPING_TIMEOUT_MS: 3000;
+        readonly MESSAGE_PAGE_SIZE: 50;
+    };
+    readonly OTP_LENGTH: 4;
+    readonly OTP_RESEND_DELAY_SECONDS: 60;
+    readonly DEFAULT_PAGE_SIZE: 20;
+    readonly CLOUD_COMMAND_TIMEOUT_MS: 2500;
+};

package/dist/utils/constants.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Application-wide constants — plain config, no expo dependencies.
+ * Values can be overridden via createTeincCore config (future).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULTS = exports.appVersion = exports.CLOUD_COMMAND_TIMEOUT_MS = exports.DEFAULT_PAGE_SIZE = exports.OTP_RESEND_DELAY_SECONDS = exports.OTP_LENGTH = exports.CHAT_CONFIG = exports.CHAT_STORAGE_KEYS = exports.STORAGE_KEYS = exports.APP_VERSION = exports.APP_NAME = exports.WS_BASE_URL = exports.API_BASE_URL = void 0;
+/** Base URL for the API — will be swapped per environment */
+exports.API_BASE_URL = process.env.EXPO_PUBLIC_API_URL ??
+    process.env.API_URL ??
+    "http://localhost:4000/api/v1";
+/** WebSocket URL for Phoenix Channels */
+exports.WS_BASE_URL = process.env.EXPO_PUBLIC_WS_URL ??
+    process.env.WS_URL ??
+    "ws://localhost:4000";
+/** App metadata */
+exports.APP_NAME = "Teinc Food Business";
+exports.APP_VERSION = "1.0.0";
+/** Async storage keys */
+exports.STORAGE_KEYS = {
+    AUTH_TOKEN: "auth_token",
+    REFRESH_TOKEN: "refresh_token",
+    USER_PROFILE: "user_profile",
+    HAS_SEEN_ONBOARDING: "has_seen_onboarding",
+    THEME_PREFERENCE: "theme_preference",
+    BUSINESS_DATA: "business_data",
+    FLEET_DATA: "fleet_data",
+    LOCAL_NODE_DATA: "local_node_data",
+    PRINTER_SETTINGS: "printer_settings",
+};
+/** Chat storage keys */
+exports.CHAT_STORAGE_KEYS = {
+    MESSAGES: "chat_messages",
+    OUTBOX: "chat_outbox",
+};
+/** Chat configuration */
+exports.CHAT_CONFIG = {
+    HEARTBEAT_INTERVAL_MS: 15000,
+    HEARTBEAT_TIMEOUT_MS: 10000,
+    RECONNECT_BASE_DELAY_MS: 1000,
+    RECONNECT_MAX_DELAY_MS: 30000,
+    RECONNECT_MAX_ATTEMPTS: 10,
+    TYPING_TIMEOUT_MS: 3000,
+    MESSAGE_PAGE_SIZE: 50,
+};
+/** OTP configuration */
+exports.OTP_LENGTH = 4;
+exports.OTP_RESEND_DELAY_SECONDS = 60;
+/** Pagination defaults */
+exports.DEFAULT_PAGE_SIZE = 20;
+/**
+ * Max time the Sync Engine waits for a cloud command before treating the cloud
+ * as unreachable and falling back to the Local Node or the offline outbox.
+ * Keeps the terminal responsive (fast) even when the internet is slow.
+ */
+exports.CLOUD_COMMAND_TIMEOUT_MS = 2500;
+// Expo version removed; expose static version for now
+exports.appVersion = exports.APP_VERSION;
+/** Default config bundle for createTeincCore overrides */
+exports.DEFAULTS = {
+    API_BASE_URL: exports.API_BASE_URL,
+    WS_BASE_URL: exports.WS_BASE_URL,
+    APP_NAME: exports.APP_NAME,
+    APP_VERSION: exports.APP_VERSION,
+    STORAGE_KEYS: exports.STORAGE_KEYS,
+    CHAT_STORAGE_KEYS: exports.CHAT_STORAGE_KEYS,
+    CHAT_CONFIG: exports.CHAT_CONFIG,
+    OTP_LENGTH: exports.OTP_LENGTH,
+    OTP_RESEND_DELAY_SECONDS: exports.OTP_RESEND_DELAY_SECONDS,
+    DEFAULT_PAGE_SIZE: exports.DEFAULT_PAGE_SIZE,
+    CLOUD_COMMAND_TIMEOUT_MS: exports.CLOUD_COMMAND_TIMEOUT_MS,
+};

package/dist/utils/copyToClipBoard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Clipboard helper — no-op stub in core. Host apps inject real clipboard.
+ */
+export declare function setClipboardImpl(fn: (text: string) => Promise<void>): void;
+export declare const copyToClipboard: (text: string) => Promise<void>;

package/dist/utils/copyToClipBoard.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Clipboard helper — no-op stub in core. Host apps inject real clipboard.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyToClipboard = void 0;
+exports.setClipboardImpl = setClipboardImpl;
+let clipboardImpl = null;
+function setClipboardImpl(fn) {
+    clipboardImpl = fn;
+}
+const copyToClipboard = async (text) => {
+    if (clipboardImpl) {
+        await clipboardImpl(text);
+        return;
+    }
+    if (typeof navigator !== "undefined" && navigator.clipboard) {
+        await navigator.clipboard.writeText(text);
+        return;
+    }
+    // fallback: no-op
+};
+exports.copyToClipboard = copyToClipboard;

package/dist/utils/currency.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Currency Utility — no RN/store dependencies.
+ */
+export declare const DEFAULT_CURRENCY = "GHS";
+export declare function getCurrencySymbol(currency: string): string;
+export declare function formatPrice(amount: number, currency?: string): string;
+export declare function formatPriceFromMinor(amountMinor: number, currency?: string): string;
+export declare function useCurrency(): string;
+export declare function useCurrencySymbol(): string;

package/dist/utils/currency.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Currency Utility — no RN/store dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CURRENCY = void 0;
+exports.getCurrencySymbol = getCurrencySymbol;
+exports.formatPrice = formatPrice;
+exports.formatPriceFromMinor = formatPriceFromMinor;
+exports.useCurrency = useCurrency;
+exports.useCurrencySymbol = useCurrencySymbol;
+exports.DEFAULT_CURRENCY = "GHS";
+const CURRENCY_SYMBOLS = {
+    GHS: "GH₵",
+    USD: "$",
+    NGN: "₦",
+    KES: "KSh",
+    EUR: "€",
+    GBP: "£",
+};
+function getCurrencySymbol(currency) {
+    return CURRENCY_SYMBOLS[currency] || currency;
+}
+function formatPrice(amount, currency = exports.DEFAULT_CURRENCY) {
+    return `${getCurrencySymbol(currency)}${amount.toFixed(2)}`;
+}
+function formatPriceFromMinor(amountMinor, currency = exports.DEFAULT_CURRENCY) {
+    const amount = amountMinor / 100;
+    return formatPrice(amount, currency);
+}
+// Compatibility hooks — return default when no location adapter injected
+function useCurrency() {
+    return exports.DEFAULT_CURRENCY;
+}
+function useCurrencySymbol() {
+    return getCurrencySymbol(exports.DEFAULT_CURRENCY);
+}

package/dist/utils/error.d.ts

@@ -0,0 +1,4 @@
+export declare function extractFromResponseBody(data: Record<string, unknown>): string | null;
+export declare function extractApiErrorMessage(error: unknown): string;
+export declare function extractApiErrorCode(error: unknown): string | undefined;
+export { ApiError } from "../adapters/http";