@prabhask5/stellar-engine 1.0.3

package/dist/data.js

@@ -0,0 +1,360 @@
+/**
+ * Generic CRUD and Query Operations
+ *
+ * Replaces repository infrastructure boilerplate.
+ * Uses Supabase table names as the API surface, internally resolves to Dexie table names.
+ */
+import { getTableMap, getTableColumns } from './config';
+import { getDb } from './database';
+import { queueCreateOperation, queueDeleteOperation, queueSyncOperation } from './queue';
+import { markEntityModified, scheduleSyncPush } from './engine';
+import { generateId, now } from './utils';
+import { debugError } from './debug';
+import { supabase } from './supabase/client';
+// ============================================================
+// HELPERS
+// ============================================================
+function getDexieTableName(supabaseName) {
+    const map = getTableMap();
+    return map[supabaseName] || supabaseName;
+}
+// ============================================================
+// SINGLE-ENTITY WRITE OPERATIONS
+// ============================================================
+/**
+ * Create a new entity. Auto: transaction + queue + markModified + schedulePush.
+ * Caller provides all fields including id, timestamps, etc.
+ */
+export async function engineCreate(table, data) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    const entityId = data.id || generateId();
+    const payload = { ...data, id: entityId };
+    // Separate out id for the queue payload (queue stores id separately)
+    const { id: _id, ...queuePayload } = payload;
+    await db.transaction('rw', [db.table(dexieTable), db.table('syncQueue')], async () => {
+        await db.table(dexieTable).add(payload);
+        await queueCreateOperation(table, entityId, queuePayload);
+    });
+    markEntityModified(entityId);
+    scheduleSyncPush();
+    return payload;
+}
+/**
+ * Update an entity's fields. Auto-sets updated_at, queues sync, marks modified.
+ */
+export async function engineUpdate(table, id, fields) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    const timestamp = now();
+    const updateFields = { ...fields, updated_at: timestamp };
+    let updated;
+    await db.transaction('rw', [db.table(dexieTable), db.table('syncQueue')], async () => {
+        await db.table(dexieTable).update(id, updateFields);
+        updated = await db.table(dexieTable).get(id);
+        if (updated) {
+            await queueSyncOperation({
+                table,
+                entityId: id,
+                operationType: 'set',
+                value: updateFields
+            });
+        }
+    });
+    if (updated) {
+        markEntityModified(id);
+        scheduleSyncPush();
+    }
+    return updated;
+}
+/**
+ * Soft-delete an entity. Sets deleted=true, queues delete op.
+ */
+export async function engineDelete(table, id) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    const timestamp = now();
+    await db.transaction('rw', [db.table(dexieTable), db.table('syncQueue')], async () => {
+        await db.table(dexieTable).update(id, { deleted: true, updated_at: timestamp });
+        await queueDeleteOperation(table, id);
+    });
+    markEntityModified(id);
+    scheduleSyncPush();
+}
+/**
+ * Execute multiple write operations in a single atomic transaction.
+ * All ops succeed or all roll back.
+ */
+export async function engineBatchWrite(operations) {
+    const db = getDb();
+    const timestamp = now();
+    // Collect all unique Dexie table names needed for the transaction scope
+    const tableNames = new Set();
+    tableNames.add('syncQueue');
+    for (const op of operations) {
+        tableNames.add(getDexieTableName(op.table));
+    }
+    const tables = Array.from(tableNames).map(name => db.table(name));
+    const modifiedIds = [];
+    await db.transaction('rw', tables, async () => {
+        for (const op of operations) {
+            const dexieTable = getDexieTableName(op.table);
+            switch (op.type) {
+                case 'create': {
+                    const entityId = op.data.id || generateId();
+                    const payload = { ...op.data, id: entityId };
+                    const { id: _id, ...queuePayload } = payload;
+                    await db.table(dexieTable).add(payload);
+                    await queueCreateOperation(op.table, entityId, queuePayload);
+                    modifiedIds.push(entityId);
+                    break;
+                }
+                case 'update': {
+                    const updateFields = { ...op.fields, updated_at: timestamp };
+                    await db.table(dexieTable).update(op.id, updateFields);
+                    await queueSyncOperation({
+                        table: op.table,
+                        entityId: op.id,
+                        operationType: 'set',
+                        value: updateFields
+                    });
+                    modifiedIds.push(op.id);
+                    break;
+                }
+                case 'delete': {
+                    await db.table(dexieTable).update(op.id, { deleted: true, updated_at: timestamp });
+                    await queueDeleteOperation(op.table, op.id);
+                    modifiedIds.push(op.id);
+                    break;
+                }
+            }
+        }
+    });
+    for (const id of modifiedIds) {
+        markEntityModified(id);
+    }
+    scheduleSyncPush();
+}
+// ============================================================
+// INCREMENT OPERATION
+// ============================================================
+/**
+ * Increment a numeric field on an entity, preserving increment intent for conflict resolution.
+ * Uses increment operationType in the sync queue so multi-device increments are additive.
+ * Optionally sets additional fields (e.g., completed, updated_at) alongside the increment.
+ */
+export async function engineIncrement(table, id, field, amount, additionalFields) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    const timestamp = now();
+    // Read current value
+    const current = await db.table(dexieTable).get(id);
+    if (!current)
+        return undefined;
+    const currentValue = current[field] || 0;
+    const newValue = currentValue + amount;
+    const updateFields = {
+        [field]: newValue,
+        updated_at: timestamp,
+        ...additionalFields
+    };
+    let updated;
+    await db.transaction('rw', [db.table(dexieTable), db.table('syncQueue')], async () => {
+        await db.table(dexieTable).update(id, updateFields);
+        updated = await db.table(dexieTable).get(id);
+        if (updated) {
+            await queueSyncOperation({
+                table,
+                entityId: id,
+                operationType: 'increment',
+                field,
+                value: amount
+            });
+            // Queue additional fields as a separate set operation if present
+            if (additionalFields && Object.keys(additionalFields).length > 0) {
+                await queueSyncOperation({
+                    table,
+                    entityId: id,
+                    operationType: 'set',
+                    value: { ...additionalFields, updated_at: timestamp }
+                });
+            }
+        }
+    });
+    if (updated) {
+        markEntityModified(id);
+        scheduleSyncPush();
+    }
+    return updated;
+}
+// ============================================================
+// QUERY OPERATIONS
+// ============================================================
+/**
+ * Get a single entity by ID. Optional remote fallback if not found locally.
+ */
+export async function engineGet(table, id, opts) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    const local = await db.table(dexieTable).get(id);
+    if (local)
+        return local;
+    if (opts?.remoteFallback && typeof navigator !== 'undefined' && navigator.onLine) {
+        try {
+            const columns = getTableColumns(table);
+            const { data, error } = await supabase
+                .from(table)
+                .select(columns)
+                .eq('id', id)
+                .or('deleted.is.null,deleted.eq.false')
+                .maybeSingle();
+            if (!error && data) {
+                await db.table(dexieTable).put(data);
+                return data;
+            }
+        }
+        catch (e) {
+            debugError(`[Data] Remote fallback failed for ${table}/${id}:`, e);
+        }
+    }
+    return null;
+}
+/**
+ * Get all entities from a table. Optional ordering and remote fallback.
+ */
+export async function engineGetAll(table, opts) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    let results;
+    if (opts?.orderBy) {
+        results = await db.table(dexieTable).orderBy(opts.orderBy).toArray();
+    }
+    else {
+        results = await db.table(dexieTable).toArray();
+    }
+    if (results.length === 0 && opts?.remoteFallback && typeof navigator !== 'undefined' && navigator.onLine) {
+        try {
+            const columns = getTableColumns(table);
+            const { data, error } = await supabase
+                .from(table)
+                .select(columns)
+                .or('deleted.is.null,deleted.eq.false');
+            if (!error && data && data.length > 0) {
+                await db.table(dexieTable).bulkPut(data);
+                if (opts?.orderBy) {
+                    results = await db.table(dexieTable).orderBy(opts.orderBy).toArray();
+                }
+                else {
+                    results = data;
+                }
+            }
+        }
+        catch (e) {
+            debugError(`[Data] Remote fallback failed for ${table}:`, e);
+        }
+    }
+    return results;
+}
+/**
+ * Query entities by index value (WHERE index = value).
+ */
+export async function engineQuery(table, index, value, opts) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    let results = await db.table(dexieTable).where(index).equals(value).toArray();
+    if (results.length === 0 && opts?.remoteFallback && typeof navigator !== 'undefined' && navigator.onLine) {
+        try {
+            const columns = getTableColumns(table);
+            const { data, error } = await supabase
+                .from(table)
+                .select(columns)
+                .eq(index, value)
+                .or('deleted.is.null,deleted.eq.false');
+            if (!error && data && data.length > 0) {
+                await db.table(dexieTable).bulkPut(data);
+                results = data;
+            }
+        }
+        catch (e) {
+            debugError(`[Data] Remote query fallback failed for ${table}.${index}:`, e);
+        }
+    }
+    return results;
+}
+/**
+ * Range query (WHERE index BETWEEN lower AND upper).
+ */
+export async function engineQueryRange(table, index, lower, upper, opts) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    let results = await db.table(dexieTable).where(index).between(lower, upper, true, true).toArray();
+    if (results.length === 0 && opts?.remoteFallback && typeof navigator !== 'undefined' && navigator.onLine) {
+        try {
+            const columns = getTableColumns(table);
+            const { data, error } = await supabase
+                .from(table)
+                .select(columns)
+                .gte(index, lower)
+                .lte(index, upper)
+                .or('deleted.is.null,deleted.eq.false');
+            if (!error && data && data.length > 0) {
+                await db.table(dexieTable).bulkPut(data);
+                results = data;
+            }
+        }
+        catch (e) {
+            debugError(`[Data] Remote range query fallback failed for ${table}.${index}:`, e);
+        }
+    }
+    return results;
+}
+/**
+ * Singleton get-or-create with optional remote check.
+ * Used for patterns like focus_settings where one record per user exists.
+ */
+export async function engineGetOrCreate(table, index, value, defaults, opts) {
+    const db = getDb();
+    const dexieTable = getDexieTableName(table);
+    // Check local first
+    const localResults = await db.table(dexieTable).where(index).equals(value).toArray();
+    const existing = localResults.find((r) => !r.deleted);
+    if (existing)
+        return existing;
+    // Check remote if requested
+    if (opts?.checkRemote && typeof navigator !== 'undefined' && navigator.onLine) {
+        try {
+            const columns = getTableColumns(table);
+            const { data } = await supabase
+                .from(table)
+                .select(columns)
+                .eq(index, value)
+                .is('deleted', null)
+                .maybeSingle();
+            if (data) {
+                await db.table(dexieTable).put(data);
+                return data;
+            }
+        }
+        catch {
+            // Offline or network error - fall through to local create
+        }
+    }
+    // Create new
+    const entityId = generateId();
+    const timestamp = now();
+    const payload = {
+        id: entityId,
+        ...defaults,
+        created_at: timestamp,
+        updated_at: timestamp
+    };
+    const { id: _id, ...queuePayload } = payload;
+    await db.transaction('rw', [db.table(dexieTable), db.table('syncQueue')], async () => {
+        await db.table(dexieTable).add(payload);
+        await queueCreateOperation(table, entityId, queuePayload);
+    });
+    markEntityModified(entityId);
+    scheduleSyncPush();
+    return payload;
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"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"}

package/dist/database.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Database Management
+ *
+ * Engine creates and owns the Dexie instance when `database` config is provided.
+ * System tables (syncQueue, conflictHistory, offlineCredentials, offlineSession)
+ * are automatically merged into every schema version.
+ */
+import Dexie from 'dexie';
+export interface DatabaseVersionConfig {
+    version: number;
+    stores: Record<string, string>;
+    upgrade?: (tx: import('dexie').Transaction) => Promise<void>;
+}
+export interface DatabaseConfig {
+    name: string;
+    versions: DatabaseVersionConfig[];
+}
+/**
+ * Create a Dexie database with system tables auto-merged into every version.
+ */
+export declare function createDatabase(config: DatabaseConfig): Dexie;
+/**
+ * Get the engine-managed Dexie instance.
+ * Must be set via createDatabase() or _setManagedDb() before use.
+ */
+export declare function getDb(): Dexie;
+/**
+ * Set the managed database instance (used when db is provided directly via config).
+ */
+export declare function _setManagedDb(db: Dexie): void;
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAYD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAgB5D;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,KAAK,CAK7B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,CAE7C"}

package/dist/database.js

@@ -0,0 +1,51 @@
+/**
+ * Database Management
+ *
+ * Engine creates and owns the Dexie instance when `database` config is provided.
+ * System tables (syncQueue, conflictHistory, offlineCredentials, offlineSession)
+ * are automatically merged into every schema version.
+ */
+import Dexie from 'dexie';
+// System tables auto-added to every version
+const SYSTEM_TABLES = {
+    syncQueue: '++id, table, entityId, timestamp',
+    conflictHistory: '++id, entityId, entityType, timestamp',
+    offlineCredentials: 'id',
+    offlineSession: 'id'
+};
+let managedDb = null;
+/**
+ * Create a Dexie database with system tables auto-merged into every version.
+ */
+export function createDatabase(config) {
+    const db = new Dexie(config.name);
+    for (const ver of config.versions) {
+        // Merge app tables with system tables
+        const mergedStores = { ...ver.stores, ...SYSTEM_TABLES };
+        if (ver.upgrade) {
+            db.version(ver.version).stores(mergedStores).upgrade(ver.upgrade);
+        }
+        else {
+            db.version(ver.version).stores(mergedStores);
+        }
+    }
+    managedDb = db;
+    return db;
+}
+/**
+ * Get the engine-managed Dexie instance.
+ * Must be set via createDatabase() or _setManagedDb() before use.
+ */
+export function getDb() {
+    if (!managedDb) {
+        throw new Error('No database available. Call initEngine() with database config or db first.');
+    }
+    return managedDb;
+}
+/**
+ * Set the managed database instance (used when db is provided directly via config).
+ */
+export function _setManagedDb(db) {
+    managedDb = db;
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,4CAA4C;AAC5C,MAAM,aAAa,GAA2B;IAC5C,SAAS,EAAE,kCAAkC;IAC7C,eAAe,EAAE,uCAAuC;IACxD,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF,IAAI,SAAS,GAAiB,IAAI,CAAC;AAEnC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClC,sCAAsC;QACtC,MAAM,YAAY,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;QAEzD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,SAAS,GAAG,EAAE,CAAC;IACf,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAS;IACrC,SAAS,GAAG,EAAE,CAAC;AACjB,CAAC"}

package/dist/debug.d.ts

@@ -0,0 +1,11 @@
+export declare function _setDebugPrefix(prefix: string): void;
+export declare function isDebugMode(): boolean;
+export declare function setDebugMode(enabled: boolean): void;
+export declare function debugLog(...args: unknown[]): void;
+export declare function debugWarn(...args: unknown[]): void;
+export declare function debugError(...args: unknown[]): void;
+/**
+ * Unified debug function. Replaces debugLog/debugWarn/debugError with a single export.
+ */
+export declare function debug(level: 'log' | 'warn' | 'error', ...args: unknown[]): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,QAE7C;AAED,wBAAgB,WAAW,IAAI,OAAO,CAMrC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,QAG5C;AAED,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE5C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAO/E"}

package/dist/debug.js

@@ -0,0 +1,48 @@
+let debugEnabled = null;
+let debugPrefix = 'stellar';
+export function _setDebugPrefix(prefix) {
+    debugPrefix = prefix;
+}
+export function isDebugMode() {
+    if (debugEnabled !== null)
+        return debugEnabled;
+    debugEnabled =
+        typeof localStorage !== 'undefined' &&
+            localStorage.getItem(`${debugPrefix}_debug_mode`) === 'true';
+    return debugEnabled;
+}
+export function setDebugMode(enabled) {
+    debugEnabled = enabled;
+    localStorage.setItem(`${debugPrefix}_debug_mode`, enabled ? 'true' : 'false');
+}
+export function debugLog(...args) {
+    if (isDebugMode())
+        console.log(...args);
+}
+export function debugWarn(...args) {
+    if (isDebugMode())
+        console.warn(...args);
+}
+export function debugError(...args) {
+    if (isDebugMode())
+        console.error(...args);
+}
+/**
+ * Unified debug function. Replaces debugLog/debugWarn/debugError with a single export.
+ */
+export function debug(level, ...args) {
+    if (!isDebugMode())
+        return;
+    switch (level) {
+        case 'log':
+            console.log(...args);
+            break;
+        case 'warn':
+            console.warn(...args);
+            break;
+        case 'error':
+            console.error(...args);
+            break;
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA,IAAI,YAAY,GAAmB,IAAI,CAAC;AACxC,IAAI,WAAW,GAAG,SAAS,CAAC;AAE5B,MAAM,UAAU,eAAe,CAAC,MAAc;IAC7C,WAAW,GAAG,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAC/C,YAAY;QACX,OAAO,YAAY,KAAK,WAAW;YACnC,YAAY,CAAC,OAAO,CAAC,GAAG,WAAW,aAAa,CAAC,KAAK,MAAM,CAAC;IAC9D,OAAO,YAAY,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC5C,YAAY,GAAG,OAAO,CAAC;IACvB,YAAY,CAAC,OAAO,CAAC,GAAG,WAAW,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAG,IAAe;IAC1C,IAAI,WAAW,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,GAAG,IAAe;IAC3C,IAAI,WAAW,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAC1C,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,GAAG,IAAe;IAC5C,IAAI,WAAW,EAAE;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAA+B,EAAE,GAAG,IAAe;IACxE,IAAI,CAAC,WAAW,EAAE;QAAE,OAAO;IAC3B,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAAC,MAAM;QACxC,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAAC,MAAM;QAC1C,KAAK,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YAAC,MAAM;IAC7C,CAAC;AACF,CAAC"}

package/dist/deviceId.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Device ID Management
+ *
+ * Generates and persists a stable device identifier for deterministic conflict resolution.
+ * When two operations have the same timestamp, the device ID is used as a tiebreaker
+ * to ensure consistent resolution across all devices.
+ */
+export declare function _setDeviceIdPrefix(prefix: string): void;
+/**
+ * Get or create a stable device ID for this browser/device.
+ * The ID is stored in localStorage and persists across sessions.
+ *
+ * Format: Random UUID v4
+ */
+export declare function getDeviceId(): string;
+//# sourceMappingURL=deviceId.d.ts.map

package/dist/deviceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../src/deviceId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,QAEhD;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAcpC"}

package/dist/deviceId.js

@@ -0,0 +1,48 @@
+/**
+ * Device ID Management
+ *
+ * Generates and persists a stable device identifier for deterministic conflict resolution.
+ * When two operations have the same timestamp, the device ID is used as a tiebreaker
+ * to ensure consistent resolution across all devices.
+ */
+let _deviceIdPrefix = 'stellar';
+export function _setDeviceIdPrefix(prefix) {
+    _deviceIdPrefix = prefix;
+}
+function getDeviceIdKey() {
+    return `${_deviceIdPrefix}_device_id`;
+}
+/**
+ * Get or create a stable device ID for this browser/device.
+ * The ID is stored in localStorage and persists across sessions.
+ *
+ * Format: Random UUID v4
+ */
+export function getDeviceId() {
+    if (typeof localStorage === 'undefined') {
+        // SSR context - return a placeholder that won't be used
+        return 'ssr-placeholder';
+    }
+    let deviceId = localStorage.getItem(getDeviceIdKey());
+    if (!deviceId) {
+        deviceId = generateUUID();
+        localStorage.setItem(getDeviceIdKey(), deviceId);
+    }
+    return deviceId;
+}
+/**
+ * Generate a UUID v4 (random UUID).
+ * Uses crypto.randomUUID if available, otherwise falls back to manual generation.
+ */
+function generateUUID() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback for older browsers
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=deviceId.js.map

package/dist/deviceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.js","sourceRoot":"","sources":["../src/deviceId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,IAAI,eAAe,GAAG,SAAS,CAAC;AAEhC,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,eAAe,GAAG,MAAM,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,GAAG,eAAe,YAAY,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,YAAY,KAAK,WAAW,EAAE,CAAC;QACxC,wDAAwD;QACxD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,YAAY,EAAE,CAAC;QAC1B,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY;IACnB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,8BAA8B;IAC9B,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Clear all pending sync operations (used when auth is invalid)
+ * SECURITY: Called when offline credentials are found to be invalid
+ * to prevent unauthorized data from being synced to the server
+ */
+export declare function clearPendingSyncQueue(): Promise<number>;
+export declare function markEntityModified(entityId: string): void;
+export declare function onSyncComplete(callback: () => void): () => void;
+export declare function scheduleSyncPush(): void;
+export declare function runFullSync(quiet?: boolean, skipPull?: boolean): Promise<void>;
+export declare function startSyncEngine(): Promise<void>;
+export declare function stopSyncEngine(): Promise<void>;
+export declare function clearLocalCache(): Promise<void>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAkGA;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAW7D;AAkND,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEzD;AAwFD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAS/D;AAkBD,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AA0wBD,wBAAsB,WAAW,CAAC,KAAK,GAAE,OAAe,EAAE,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoMlG;AA0YD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA8WrD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAsDpD;AAGD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BrD"}