@use-stall/core 0.0.11 → 0.0.13

package/dist/index.d.mts

@@ -704,6 +704,31 @@ declare const fulfillments: {
     }) => Promise<void>;
 };
 
+declare const sync_service: {
+    get_sync_status: () => Promise<{
+        pending: number;
+        syncing: number;
+        failed: number;
+        total: number;
+        is_sync_running: boolean;
+    }>;
+    fix_sync_queue: () => Promise<{
+        fixed: number;
+    }>;
+    trigger_sync: (props: {
+        sdk: CoreConfig;
+    }) => Promise<{
+        sync_batch_id: string;
+        total: number;
+        synced: number;
+        failed: number;
+    }>;
+    start_sync: (props: {
+        sdk: CoreConfig;
+    }) => Promise<void>;
+    stop_sync: () => void;
+};
+
 interface ConnectorCacheType {
     id: string;
     code: string;
@@ -721,6 +746,7 @@ interface SyncQueueType {
     error?: string;
     retry_count: number;
     last_retry_at?: number;
+    priority: number;
 }
 interface SyncLogType {
     id: string;
@@ -756,55 +782,6 @@ type CustomersTable = EntityTable<UnifiedCustomerType, "id">;
 type LocationsTable = EntityTable<UnifiedLocationType, "id">;
 type FulfillmentsTable = EntityTable<UnifiedFulfillmentType, "id">;
 
-declare const sync_service: {
-    process_sync_queue: (props: {
-        sdk: CoreConfig;
-    }) => Promise<{
-        sync_batch_id: string;
-        total: number;
-        synced: number;
-        failed: number;
-        summary: {
-            table: ConnectorModuleKey;
-            synced: number;
-            failed: number;
-        }[];
-    }>;
-    sync_queue_item: (props: {
-        sdk: CoreConfig;
-        item: SyncQueueType;
-        sync_batch_id: string;
-    }) => Promise<{
-        success: boolean;
-        connector_id?: string;
-        error?: string;
-    }>;
-    start_sync_service: (props: {
-        sdk: CoreConfig;
-        interval?: number;
-    }) => Promise<void>;
-    stop_sync_service: () => void;
-    get_sync_stats: () => Promise<{
-        pending: number;
-        syncing: number;
-        failed: number;
-        total: number;
-    }>;
-    trigger_sync: (props: {
-        sdk: CoreConfig;
-    }) => Promise<{
-        sync_batch_id: string;
-        total: number;
-        synced: number;
-        failed: number;
-        summary: {
-            table: ConnectorModuleKey;
-            synced: number;
-            failed: number;
-        }[];
-    }>;
-};
-
 /**
  * Generate a temporary offline ID
  * Format: stall_{table}_{uuid}_{timestamp}
@@ -819,6 +796,7 @@ declare const save_bulk_data: (props: {
 }) => Promise<void>;
 /**
  * Add a single item to the sync queue for later synchronization
+ * Automatically assigns priority: create=1, update=2, delete=3
  */
 declare const add_to_sync_queue: (props: {
     action: "create" | "update" | "delete";
@@ -828,7 +806,14 @@ declare const add_to_sync_queue: (props: {
     data: Record<string, any>;
 }) => Promise<SyncQueueType>;
 /**
- * Get pending sync queue items grouped by table for dependency-aware syncing
+ * Get pending sync queue items ordered by priority
+ * Returns items sorted by: priority (create first), then by timestamp
+ * Groups by table to maintain dependency order
+ *
+ * Execution order:
+ * 1. All CREATE operations per table (in timestamp order)
+ * 2. All UPDATE operations per table (in timestamp order)
+ * 3. All DELETE operations per table (in timestamp order)
  */
 declare const get_pending_sync_queue: () => Promise<Map<ConnectorModuleKey, SyncQueueType[]>>;
 /**
@@ -898,4 +883,14 @@ declare const local_db: Dexie & {
     fulfillments: FulfillmentsTable;
 };
 
-export { add_sync_log, add_to_sync_queue, categories, cleanup_old_sync_logs, collections, customers, fulfillments, generate_offline_id, get_pending_sync_queue, get_recent_sync_logs, get_sync_logs_by_batch, initializeStallCore, inventory_levels, local_db, locations, order_notes, orders, payment_providers, payments, products, promotions, refunds, remove_from_sync_queue, save_bulk_data, sync_service, tax_rates, tax_regions, update_sync_queue_status, variants };
+/**
+ * Check if the device is online
+ * Returns true if navigator.onLine is true or if navigator is not available (Node.js)
+ */
+declare const is_online: () => boolean;
+/**
+ * Check if the device is offline
+ */
+declare const is_offline: () => boolean;
+
+export { add_sync_log, add_to_sync_queue, categories, cleanup_old_sync_logs, collections, customers, fulfillments, generate_offline_id, get_pending_sync_queue, get_recent_sync_logs, get_sync_logs_by_batch, initializeStallCore, inventory_levels, is_offline, is_online, local_db, locations, order_notes, orders, payment_providers, payments, products, promotions, refunds, remove_from_sync_queue, save_bulk_data, sync_service, tax_rates, tax_regions, update_sync_queue_status, variants };

package/dist/index.d.ts

@@ -704,6 +704,31 @@ declare const fulfillments: {
     }) => Promise<void>;
 };
 
+declare const sync_service: {
+    get_sync_status: () => Promise<{
+        pending: number;
+        syncing: number;
+        failed: number;
+        total: number;
+        is_sync_running: boolean;
+    }>;
+    fix_sync_queue: () => Promise<{
+        fixed: number;
+    }>;
+    trigger_sync: (props: {
+        sdk: CoreConfig;
+    }) => Promise<{
+        sync_batch_id: string;
+        total: number;
+        synced: number;
+        failed: number;
+    }>;
+    start_sync: (props: {
+        sdk: CoreConfig;
+    }) => Promise<void>;
+    stop_sync: () => void;
+};
+
 interface ConnectorCacheType {
     id: string;
     code: string;
@@ -721,6 +746,7 @@ interface SyncQueueType {
     error?: string;
     retry_count: number;
     last_retry_at?: number;
+    priority: number;
 }
 interface SyncLogType {
     id: string;
@@ -756,55 +782,6 @@ type CustomersTable = EntityTable<UnifiedCustomerType, "id">;
 type LocationsTable = EntityTable<UnifiedLocationType, "id">;
 type FulfillmentsTable = EntityTable<UnifiedFulfillmentType, "id">;
 
-declare const sync_service: {
-    process_sync_queue: (props: {
-        sdk: CoreConfig;
-    }) => Promise<{
-        sync_batch_id: string;
-        total: number;
-        synced: number;
-        failed: number;
-        summary: {
-            table: ConnectorModuleKey;
-            synced: number;
-            failed: number;
-        }[];
-    }>;
-    sync_queue_item: (props: {
-        sdk: CoreConfig;
-        item: SyncQueueType;
-        sync_batch_id: string;
-    }) => Promise<{
-        success: boolean;
-        connector_id?: string;
-        error?: string;
-    }>;
-    start_sync_service: (props: {
-        sdk: CoreConfig;
-        interval?: number;
-    }) => Promise<void>;
-    stop_sync_service: () => void;
-    get_sync_stats: () => Promise<{
-        pending: number;
-        syncing: number;
-        failed: number;
-        total: number;
-    }>;
-    trigger_sync: (props: {
-        sdk: CoreConfig;
-    }) => Promise<{
-        sync_batch_id: string;
-        total: number;
-        synced: number;
-        failed: number;
-        summary: {
-            table: ConnectorModuleKey;
-            synced: number;
-            failed: number;
-        }[];
-    }>;
-};
-
 /**
  * Generate a temporary offline ID
  * Format: stall_{table}_{uuid}_{timestamp}
@@ -819,6 +796,7 @@ declare const save_bulk_data: (props: {
 }) => Promise<void>;
 /**
  * Add a single item to the sync queue for later synchronization
+ * Automatically assigns priority: create=1, update=2, delete=3
  */
 declare const add_to_sync_queue: (props: {
     action: "create" | "update" | "delete";
@@ -828,7 +806,14 @@ declare const add_to_sync_queue: (props: {
     data: Record<string, any>;
 }) => Promise<SyncQueueType>;
 /**
- * Get pending sync queue items grouped by table for dependency-aware syncing
+ * Get pending sync queue items ordered by priority
+ * Returns items sorted by: priority (create first), then by timestamp
+ * Groups by table to maintain dependency order
+ *
+ * Execution order:
+ * 1. All CREATE operations per table (in timestamp order)
+ * 2. All UPDATE operations per table (in timestamp order)
+ * 3. All DELETE operations per table (in timestamp order)
  */
 declare const get_pending_sync_queue: () => Promise<Map<ConnectorModuleKey, SyncQueueType[]>>;
 /**
@@ -898,4 +883,14 @@ declare const local_db: Dexie & {
     fulfillments: FulfillmentsTable;
 };
 
-export { add_sync_log, add_to_sync_queue, categories, cleanup_old_sync_logs, collections, customers, fulfillments, generate_offline_id, get_pending_sync_queue, get_recent_sync_logs, get_sync_logs_by_batch, initializeStallCore, inventory_levels, local_db, locations, order_notes, orders, payment_providers, payments, products, promotions, refunds, remove_from_sync_queue, save_bulk_data, sync_service, tax_rates, tax_regions, update_sync_queue_status, variants };
+/**
+ * Check if the device is online
+ * Returns true if navigator.onLine is true or if navigator is not available (Node.js)
+ */
+declare const is_online: () => boolean;
+/**
+ * Check if the device is offline
+ */
+declare const is_offline: () => boolean;
+
+export { add_sync_log, add_to_sync_queue, categories, cleanup_old_sync_logs, collections, customers, fulfillments, generate_offline_id, get_pending_sync_queue, get_recent_sync_logs, get_sync_logs_by_batch, initializeStallCore, inventory_levels, is_offline, is_online, local_db, locations, order_notes, orders, payment_providers, payments, products, promotions, refunds, remove_from_sync_queue, save_bulk_data, sync_service, tax_rates, tax_regions, update_sync_queue_status, variants };