@hasna/cloud 0.1.3 → 0.1.5

package/dist/sync-progress.d.ts

@@ -0,0 +1,68 @@
+import type { DbAdapter } from "./adapter.js";
+export interface SyncProgressInfo {
+    table: string;
+    total: number;
+    done: number;
+    percent: number;
+    elapsed_ms: number;
+    eta_ms: number;
+    status: "pending" | "in_progress" | "completed" | "failed" | "resumed";
+}
+export type ProgressCallback = (progress: SyncProgressInfo) => void;
+export interface ResumePoint {
+    table_name: string;
+    last_row_id: string;
+    direction: string;
+    started_at: string;
+    status: string;
+}
+export declare class SyncProgressTracker {
+    private db;
+    private progress;
+    private startTimes;
+    private callback?;
+    constructor(db: DbAdapter, callback?: ProgressCallback);
+    private ensureResumeTable;
+    /**
+     * Start tracking a table sync. Sets status to in_progress or resumed.
+     */
+    start(table: string, total: number, direction: string): void;
+    /**
+     * Update progress for a table after processing rows.
+     */
+    update(table: string, done: number, lastRowId: string): void;
+    /**
+     * Mark a table sync as completed.
+     */
+    markComplete(table: string): void;
+    /**
+     * Mark a table sync as failed.
+     */
+    markFailed(table: string, _error: string): void;
+    /**
+     * Check if a previous sync was interrupted (status is 'in_progress' or 'resumed').
+     */
+    canResume(table: string): boolean;
+    /**
+     * Returns the last successfully synced row ID for a table, or null.
+     */
+    getResumePoint(table: string): ResumePoint | null;
+    /**
+     * Clear resume state for a table (e.g., after a fresh sync starts).
+     */
+    clearResume(table: string): void;
+    /**
+     * Get current progress info for a table.
+     */
+    getProgress(table: string): SyncProgressInfo | null;
+    /**
+     * Get progress info for all tracked tables.
+     */
+    getAllProgress(): SyncProgressInfo[];
+    /**
+     * List all resume records from the database (including historical).
+     */
+    listResumeRecords(): ResumePoint[];
+    private notify;
+}
+//# sourceMappingURL=sync-progress.d.ts.map

package/dist/sync-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-progress.d.ts","sourceRoot":"","sources":["../src/sync-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAExB,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,gBAAgB;IAUtD,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAmC5D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA0B5D;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBjC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAmB/C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASjC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUjD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAahC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAInD;;OAEG;IACH,cAAc,IAAI,gBAAgB,EAAE;IAIpC;;OAEG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAUlC,OAAO,CAAC,MAAM;CAMf"}

package/dist/sync.d.ts

@@ -1,4 +1,5 @@
 import type { DbAdapter } from "./adapter.js";
+import type { PgAdapterAsync } from "./adapter.js";
 export interface SyncProgress {
     table: string;
     phase: "reading" | "writing" | "done";
@@ -13,7 +14,7 @@ export interface SyncOptions {
     tables: string[];
     /** Optional progress callback. */
     onProgress?: SyncProgressCallback;
-    /** Batch size for UPSERT operations. Default: 500 */
+    /** Batch size for UPSERT operations. Default: 100 */
     batchSize?: number;
     /** Conflict resolution column (default: "updated_at"). Newest wins. */
     conflictColumn?: string;
@@ -28,21 +29,21 @@ export interface SyncResult {
     errors: string[];
 }
 /**
- * Push data from a local database to the cloud database.
- * For each table: SELECT * from source → UPSERT into target.
- * Conflict resolution: compare `updated_at`, newest wins.
+ * Push data from a local SQLite database to the cloud PostgreSQL database.
+ * Uses batch UPSERT for performance and FK-aware table ordering.
  */
-export declare function syncPush(local: DbAdapter, cloud: DbAdapter, options: SyncOptions): SyncResult[];
+export declare function syncPush(local: DbAdapter, remote: PgAdapterAsync, options: SyncOptions): Promise<SyncResult[]>;
 /**
- * Pull data from the cloud database into the local database.
+ * Pull data from the cloud PostgreSQL database into a local SQLite database.
+ * Uses FK-aware table ordering.
  */
-export declare function syncPull(local: DbAdapter, cloud: DbAdapter, options: SyncOptions): SyncResult[];
+export declare function syncPull(remote: PgAdapterAsync, local: DbAdapter, options: SyncOptions): Promise<SyncResult[]>;
 /**
  * List all user tables in a SQLite database.
  */
 export declare function listSqliteTables(db: DbAdapter): string[];
 /**
- * List all user tables in a PostgreSQL database.
+ * List all user tables in a PostgreSQL database (async).
  */
-export declare function listPgTables(db: DbAdapter): string[];
+export declare function listPgTables(db: PgAdapterAsync): Promise<string[]>;
 //# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB,UAAU,EAAE,CAEd;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB,UAAU,EAAE,CAEd;AAoLD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,CAKxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,CAKpD"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAMD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAmWD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,CAKxD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKxE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/cloud",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Shared cloud infrastructure \u2014 database adapter (SQLite + PostgreSQL), sync engine, feedback system, unified dotfile config",
   "license": "Apache-2.0",
   "type": "module",