@opendatalabs/personal-server-ts-core 0.0.1-canary.0078f25

package/dist/storage/hierarchy/manager.js

@@ -0,0 +1,60 @@
+import { mkdir, readFile, writeFile, readdir, unlink, rename, stat, rm, } from "node:fs/promises";
+import { dirname, relative } from "node:path";
+import { randomUUID } from "node:crypto";
+import { DataFileEnvelopeSchema } from "../../schemas/data-file.js";
+import { buildDataFilePath, buildScopeDir, filenameToTimestamp, } from "./paths.js";
+/** Atomic write: mkdir -p, write temp file, rename */
+export async function writeDataFile(options, envelope) {
+    const filePath = buildDataFilePath(options.dataDir, envelope.scope, envelope.collectedAt);
+    const dir = dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const content = JSON.stringify(envelope, null, 2);
+    const tempPath = filePath + ".tmp." + randomUUID();
+    await writeFile(tempPath, content, "utf-8");
+    await rename(tempPath, filePath);
+    const stats = await stat(filePath);
+    return {
+        path: filePath,
+        relativePath: relative(options.dataDir, filePath),
+        sizeBytes: stats.size,
+    };
+}
+/** Read and parse a data file */
+export async function readDataFile(options, scope, collectedAt) {
+    const filePath = buildDataFilePath(options.dataDir, scope, collectedAt);
+    const content = await readFile(filePath, "utf-8");
+    return DataFileEnvelopeSchema.parse(JSON.parse(content));
+}
+/** List version filenames for a scope, newest first. Empty array if scope dir doesn't exist. */
+export async function listVersions(options, scope) {
+    const scopeDir = buildScopeDir(options.dataDir, scope);
+    let entries;
+    try {
+        entries = await readdir(scopeDir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return [];
+        }
+        throw err;
+    }
+    const jsonFiles = entries
+        .filter((f) => f.endsWith(".json"))
+        .sort()
+        .reverse();
+    return jsonFiles.map((f) => filenameToTimestamp(f.replace(".json", "")));
+}
+/** Delete a single data file */
+export async function deleteDataFile(options, scope, collectedAt) {
+    const filePath = buildDataFilePath(options.dataDir, scope, collectedAt);
+    await unlink(filePath);
+}
+/**
+ * Delete all files for a scope by removing the scope directory recursively.
+ * No-op if directory doesn't exist.
+ */
+export async function deleteAllForScope(options, scope) {
+    const scopeDir = buildScopeDir(options.dataDir, scope);
+    await rm(scopeDir, { recursive: true, force: true });
+}
+//# sourceMappingURL=manager.js.map

package/dist/storage/hierarchy/manager.js.map

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

package/dist/storage/hierarchy/paths.d.ts

@@ -0,0 +1,11 @@
+/** "2026-01-21T10:00:00Z" → "2026-01-21T10-00-00Z" */
+export declare function timestampToFilename(isoTimestamp: string): string;
+/** "2026-01-21T10-00-00Z" → "2026-01-21T10:00:00Z" */
+export declare function filenameToTimestamp(filename: string): string;
+/** Full file path: join(baseDir, ...scopeSegments, timestamp.json) */
+export declare function buildDataFilePath(baseDir: string, scope: string, collectedAt: string): string;
+/** Directory path for a scope */
+export declare function buildScopeDir(baseDir: string, scope: string): string;
+/** Generate current UTC timestamp without milliseconds, ending in Z */
+export declare function generateCollectedAt(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/storage/hierarchy/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/storage/hierarchy/paths.ts"],"names":[],"mappings":"AAGA,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR;AAED,iCAAiC;AACjC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C"}

package/dist/storage/hierarchy/paths.js

@@ -0,0 +1,36 @@
+import { join } from "node:path";
+import { scopeToPathSegments } from "../../scopes/parse.js";
+/** "2026-01-21T10:00:00Z" → "2026-01-21T10-00-00Z" */
+export function timestampToFilename(isoTimestamp) {
+    return isoTimestamp.replace(/:/g, "-");
+}
+/** "2026-01-21T10-00-00Z" → "2026-01-21T10:00:00Z" */
+export function filenameToTimestamp(filename) {
+    // Replace hyphens that appear in the time portion (after the T) back to colons.
+    // The date portion also has hyphens (2026-01-21) which must stay.
+    // Pattern: after T, every hyphen that separates HH-MM-SS should become a colon.
+    const tIndex = filename.indexOf("T");
+    if (tIndex === -1)
+        return filename;
+    const datePart = filename.slice(0, tIndex);
+    const timePart = filename.slice(tIndex);
+    return datePart + timePart.replace(/-/g, ":");
+}
+/** Full file path: join(baseDir, ...scopeSegments, timestamp.json) */
+export function buildDataFilePath(baseDir, scope, collectedAt) {
+    const segments = scopeToPathSegments(scope);
+    const filename = timestampToFilename(collectedAt) + ".json";
+    return join(baseDir, ...segments, filename);
+}
+/** Directory path for a scope */
+export function buildScopeDir(baseDir, scope) {
+    const segments = scopeToPathSegments(scope);
+    return join(baseDir, ...segments);
+}
+/** Generate current UTC timestamp without milliseconds, ending in Z */
+export function generateCollectedAt() {
+    const now = new Date();
+    now.setMilliseconds(0);
+    return now.toISOString().replace(".000Z", "Z");
+}
+//# sourceMappingURL=paths.js.map

package/dist/storage/hierarchy/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/storage/hierarchy/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,sDAAsD;AACtD,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,gFAAgF;IAChF,kEAAkE;IAClE,gFAAgF;IAChF,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,KAAa,EACb,WAAmB;IAEnB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC;IAC5D,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,KAAa;IAC1D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC"}

package/dist/storage/index/index.d.ts

@@ -0,0 +1,4 @@
+export type { IndexEntry, IndexListOptions } from "./types.js";
+export { initializeDatabase } from "./schema.js";
+export { createIndexManager, type IndexManager } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/storage/index/index.js

@@ -0,0 +1,3 @@
+export { initializeDatabase } from "./schema.js";
+export { createIndexManager } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/index/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC"}

package/dist/storage/index/manager.d.ts

@@ -0,0 +1,37 @@
+import type Database from "better-sqlite3";
+import type { IndexEntry, IndexListOptions, ScopeSummary } from "./types.js";
+export interface IndexManager {
+    insert(entry: Omit<IndexEntry, "id" | "createdAt">): IndexEntry;
+    findByPath(path: string): IndexEntry | undefined;
+    findByScope(options: IndexListOptions): IndexEntry[];
+    findLatestByScope(scope: string): IndexEntry | undefined;
+    countByScope(scope: string): number;
+    deleteByPath(path: string): boolean;
+    listDistinctScopes(options?: {
+        scopePrefix?: string;
+        limit?: number;
+        offset?: number;
+    }): {
+        scopes: ScopeSummary[];
+        total: number;
+    };
+    findClosestByScope(scope: string, at: string): IndexEntry | undefined;
+    findByFileId(fileId: string): IndexEntry | undefined;
+    /**
+     * Find all index entries where fileId is null (not yet synced to storage backend).
+     * Returns entries ordered by created_at ASC (oldest first).
+     */
+    findUnsynced(options?: {
+        limit?: number;
+    }): IndexEntry[];
+    /**
+     * Update the fileId for an index entry (after successful upload + on-chain registration).
+     * @returns true if row was updated, false if path not found
+     */
+    updateFileId(path: string, fileId: string): boolean;
+    /** Deletes all index entries for a scope. Returns count of deleted rows. */
+    deleteByScope(scope: string): number;
+    close(): void;
+}
+export declare function createIndexManager(db: Database.Database): IndexManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/storage/index/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/storage/index/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,UAAU,CAAC;IAChE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACjD,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAAC;IACrD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG;QAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACtE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,EAAE,CAAC;IACzD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,4EAA4E;IAC5E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf;AAwBD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,YAAY,CAgMtE"}

package/dist/storage/index/manager.js

@@ -0,0 +1,132 @@
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        fileId: row.file_id,
+        path: row.path,
+        scope: row.scope,
+        collectedAt: row.collected_at,
+        createdAt: row.created_at,
+        sizeBytes: row.size_bytes,
+    };
+}
+export function createIndexManager(db) {
+    const insertStmt = db.prepare(`INSERT INTO data_files (file_id, path, scope, collected_at, size_bytes)
+     VALUES (@file_id, @path, @scope, @collected_at, @size_bytes)`);
+    const findByPathStmt = db.prepare("SELECT * FROM data_files WHERE path = @path");
+    const findLatestByScopeStmt = db.prepare("SELECT * FROM data_files WHERE scope = @scope ORDER BY collected_at DESC LIMIT 1");
+    const countByScopeStmt = db.prepare("SELECT COUNT(*) AS cnt FROM data_files WHERE scope = @scope");
+    const deleteByPathStmt = db.prepare("DELETE FROM data_files WHERE path = @path");
+    const findClosestByScopeStmt = db.prepare("SELECT * FROM data_files WHERE scope = @scope AND collected_at <= @at ORDER BY collected_at DESC LIMIT 1");
+    const findByFileIdStmt = db.prepare("SELECT * FROM data_files WHERE file_id = @file_id");
+    const findUnsyncedStmt = db.prepare("SELECT * FROM data_files WHERE file_id IS NULL ORDER BY created_at ASC");
+    const findUnsyncedLimitStmt = db.prepare("SELECT * FROM data_files WHERE file_id IS NULL ORDER BY created_at ASC LIMIT @limit");
+    const updateFileIdStmt = db.prepare("UPDATE data_files SET file_id = @file_id WHERE path = @path");
+    const deleteByScopeStmt = db.prepare("DELETE FROM data_files WHERE scope = @scope");
+    return {
+        insert(entry) {
+            const result = insertStmt.run({
+                file_id: entry.fileId,
+                path: entry.path,
+                scope: entry.scope,
+                collected_at: entry.collectedAt,
+                size_bytes: entry.sizeBytes,
+            });
+            const row = db
+                .prepare("SELECT * FROM data_files WHERE id = ?")
+                .get(result.lastInsertRowid);
+            return rowToEntry(row);
+        },
+        findByPath(path) {
+            const row = findByPathStmt.get({ path });
+            return row ? rowToEntry(row) : undefined;
+        },
+        findByScope(options) {
+            let sql = "SELECT * FROM data_files";
+            const params = {};
+            if (options.scope) {
+                sql += " WHERE scope = @scope";
+                params.scope = options.scope;
+            }
+            sql += " ORDER BY collected_at DESC";
+            if (options.limit !== undefined) {
+                sql += " LIMIT @limit";
+                params.limit = options.limit;
+            }
+            if (options.offset !== undefined) {
+                sql += " OFFSET @offset";
+                params.offset = options.offset;
+            }
+            const rows = db.prepare(sql).all(params);
+            return rows.map(rowToEntry);
+        },
+        findLatestByScope(scope) {
+            const row = findLatestByScopeStmt.get({ scope });
+            return row ? rowToEntry(row) : undefined;
+        },
+        countByScope(scope) {
+            const row = countByScopeStmt.get({ scope });
+            return row.cnt;
+        },
+        deleteByPath(path) {
+            const result = deleteByPathStmt.run({ path });
+            return result.changes > 0;
+        },
+        listDistinctScopes(options) {
+            const hasPrefix = options?.scopePrefix !== undefined && options.scopePrefix !== "";
+            const prefix = hasPrefix ? options.scopePrefix + "%" : "%";
+            const countRow = db
+                .prepare("SELECT COUNT(DISTINCT scope) AS cnt FROM data_files WHERE scope LIKE @prefix")
+                .get({ prefix });
+            const total = countRow.cnt;
+            let sql = "SELECT scope, MAX(collected_at) AS latest_collected_at, COUNT(*) AS version_count FROM data_files WHERE scope LIKE @prefix GROUP BY scope ORDER BY scope ASC";
+            const params = { prefix };
+            if (options?.limit !== undefined) {
+                sql += " LIMIT @limit";
+                params.limit = options.limit;
+            }
+            if (options?.offset !== undefined) {
+                sql += " OFFSET @offset";
+                params.offset = options.offset;
+            }
+            const rows = db.prepare(sql).all(params);
+            return {
+                scopes: rows.map((r) => ({
+                    scope: r.scope,
+                    latestCollectedAt: r.latest_collected_at,
+                    versionCount: r.version_count,
+                })),
+                total,
+            };
+        },
+        findClosestByScope(scope, at) {
+            const row = findClosestByScopeStmt.get({ scope, at });
+            return row ? rowToEntry(row) : undefined;
+        },
+        findByFileId(fileId) {
+            const row = findByFileIdStmt.get({ file_id: fileId });
+            return row ? rowToEntry(row) : undefined;
+        },
+        findUnsynced(options) {
+            if (options?.limit !== undefined) {
+                const rows = findUnsyncedLimitStmt.all({
+                    limit: options.limit,
+                });
+                return rows.map(rowToEntry);
+            }
+            const rows = findUnsyncedStmt.all();
+            return rows.map(rowToEntry);
+        },
+        updateFileId(path, fileId) {
+            const result = updateFileIdStmt.run({ file_id: fileId, path });
+            return result.changes > 0;
+        },
+        deleteByScope(scope) {
+            const result = deleteByScopeStmt.run({ scope });
+            return result.changes;
+        },
+        close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/storage/index/manager.js.map

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

package/dist/storage/index/schema.d.ts

@@ -0,0 +1,4 @@
+import Database from "better-sqlite3";
+/** Open/create SQLite database, run CREATE TABLE IF NOT EXISTS, set WAL mode */
+export declare function initializeDatabase(dbPath: string): Database.Database;
+//# sourceMappingURL=schema.d.ts.map

package/dist/storage/index/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAmBtC,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAWpE"}

package/dist/storage/index/schema.js

@@ -0,0 +1,27 @@
+import Database from "better-sqlite3";
+const CREATE_TABLE_SQL = `
+CREATE TABLE IF NOT EXISTS data_files (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  file_id TEXT,
+  path TEXT NOT NULL UNIQUE,
+  scope TEXT NOT NULL,
+  collected_at TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  size_bytes INTEGER NOT NULL DEFAULT 0
+)`;
+const CREATE_INDEXES_SQL = [
+    "CREATE INDEX IF NOT EXISTS idx_data_files_scope ON data_files (scope)",
+    "CREATE INDEX IF NOT EXISTS idx_data_files_collected_at ON data_files (collected_at)",
+    "CREATE INDEX IF NOT EXISTS idx_data_files_file_id ON data_files (file_id)",
+];
+/** Open/create SQLite database, run CREATE TABLE IF NOT EXISTS, set WAL mode */
+export function initializeDatabase(dbPath) {
+    const db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.exec(CREATE_TABLE_SQL);
+    for (const sql of CREATE_INDEXES_SQL) {
+        db.exec(sql);
+    }
+    return db;
+}
+//# sourceMappingURL=schema.js.map

package/dist/storage/index/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,gBAAgB,GAAG;;;;;;;;;EASvB,CAAC;AAEH,MAAM,kBAAkB,GAAG;IACzB,uEAAuE;IACvE,qFAAqF;IACrF,2EAA2E;CAC5E,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,20 @@
+export interface IndexEntry {
+    id: number;
+    fileId: string | null;
+    path: string;
+    scope: string;
+    collectedAt: string;
+    createdAt: string;
+    sizeBytes: number;
+}
+export interface IndexListOptions {
+    scope?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ScopeSummary {
+    scope: string;
+    latestCollectedAt: string;
+    versionCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/index/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/index/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/storage/index/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/index/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/storage/index/types.ts"],"names":[],"mappings":""}

package/dist/sync/cursor.d.ts

@@ -0,0 +1,12 @@
+export interface SyncCursor {
+    /** Read the lastProcessedTimestamp from config.json */
+    read(): Promise<string | null>;
+    /** Write the lastProcessedTimestamp to config.json */
+    write(timestamp: string): Promise<void>;
+}
+/**
+ * Creates a cursor that reads/writes sync.lastProcessedTimestamp in config.json.
+ * Uses loadConfig/saveConfig to preserve other config fields.
+ */
+export declare function createSyncCursor(configPath: string): SyncCursor;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/sync/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/B,sDAAsD;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAa/D"}

package/dist/sync/cursor.js

@@ -0,0 +1,19 @@
+import { loadConfig, saveConfig } from "../config/index.js";
+/**
+ * Creates a cursor that reads/writes sync.lastProcessedTimestamp in config.json.
+ * Uses loadConfig/saveConfig to preserve other config fields.
+ */
+export function createSyncCursor(configPath) {
+    return {
+        async read() {
+            const config = await loadConfig({ configPath });
+            return config.sync.lastProcessedTimestamp;
+        },
+        async write(timestamp) {
+            const config = await loadConfig({ configPath });
+            config.sync.lastProcessedTimestamp = timestamp;
+            await saveConfig(config, { configPath });
+        },
+    };
+}
+//# sourceMappingURL=cursor.js.map

package/dist/sync/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAU5D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,SAAS;YACnB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;YAC/C,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sync/engine/sync-manager.d.ts

@@ -0,0 +1,25 @@
+import type { UploadWorkerDeps } from "../workers/upload.js";
+import type { DownloadWorkerDeps } from "../workers/download.js";
+import type { SyncStatus } from "../types.js";
+export interface SyncManagerOptions {
+    /** Polling interval in milliseconds (default: 60_000 = 1 minute) */
+    pollInterval?: number;
+    /** Max upload batch size per cycle (default: 50) */
+    uploadBatchSize?: number;
+}
+export interface SyncManager {
+    /** Start the background sync loop */
+    start(): void;
+    /** Stop the background sync loop gracefully */
+    stop(): Promise<void>;
+    /** Trigger an immediate sync cycle (skips wait) */
+    trigger(): Promise<void>;
+    /** Get current sync status */
+    getStatus(): SyncStatus;
+    /** Signal that new data has been ingested (next cycle picks it up) */
+    notifyNewData(): void;
+    /** Whether the sync manager is currently running */
+    readonly running: boolean;
+}
+export declare function createSyncManager(uploadDeps: UploadWorkerDeps, downloadDeps: DownloadWorkerDeps, options?: SyncManagerOptions): SyncManager;
+//# sourceMappingURL=sync-manager.d.ts.map

package/dist/sync/engine/sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../src/sync/engine/sync-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AAIzD,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;IAEd,+CAA+C;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,mDAAmD;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,8BAA8B;IAC9B,SAAS,IAAI,UAAU,CAAC;IAExB,sEAAsE;IACtE,aAAa,IAAI,IAAI,CAAC;IAEtB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,WAAW,CA8Jb"}

package/dist/sync/engine/sync-manager.js

@@ -0,0 +1,136 @@
+import { uploadAll } from "../workers/upload.js";
+import { downloadAll } from "../workers/download.js";
+const MAX_ERRORS = 10;
+export function createSyncManager(uploadDeps, downloadDeps, options) {
+    const pollInterval = options?.pollInterval ?? 60_000;
+    const uploadBatchSize = options?.uploadBatchSize ?? 50;
+    let intervalId = null;
+    let isRunning = false;
+    let lastSync = null;
+    let lastProcessedTimestamp = null;
+    let errors = [];
+    let cycleInFlight = null;
+    async function runCycle() {
+        // Prevent concurrent cycles
+        if (cycleInFlight) {
+            return cycleInFlight;
+        }
+        cycleInFlight = (async () => {
+            try {
+                // Upload unsynced local files
+                const uploadResults = await uploadAll(uploadDeps, {
+                    batchSize: uploadBatchSize,
+                });
+                uploadDeps.logger.debug({ uploaded: uploadResults.length }, "Upload cycle complete");
+            }
+            catch (err) {
+                const syncError = {
+                    fileId: null,
+                    scope: null,
+                    message: `Upload cycle failed: ${err.message}`,
+                    timestamp: new Date().toISOString(),
+                };
+                pushError(syncError);
+                uploadDeps.logger.error({ error: err.message }, "Upload cycle failed");
+            }
+            try {
+                // Download new remote files
+                const downloadResults = await downloadAll(downloadDeps);
+                downloadDeps.logger.debug({ downloaded: downloadResults.length }, "Download cycle complete");
+            }
+            catch (err) {
+                const syncError = {
+                    fileId: null,
+                    scope: null,
+                    message: `Download cycle failed: ${err.message}`,
+                    timestamp: new Date().toISOString(),
+                };
+                pushError(syncError);
+                downloadDeps.logger.error({ error: err.message }, "Download cycle failed");
+            }
+            // Update cached cursor value
+            try {
+                lastProcessedTimestamp = await downloadDeps.cursor.read();
+            }
+            catch {
+                // Non-critical: status will show stale value
+            }
+            lastSync = new Date().toISOString();
+        })();
+        try {
+            await cycleInFlight;
+        }
+        finally {
+            cycleInFlight = null;
+        }
+    }
+    function pushError(error) {
+        errors.push(error);
+        if (errors.length > MAX_ERRORS) {
+            errors = errors.slice(-MAX_ERRORS);
+        }
+    }
+    function startInterval() {
+        if (intervalId !== null)
+            return;
+        intervalId = setInterval(() => {
+            runCycle().catch(() => {
+                // Errors already captured in ring buffer
+            });
+        }, pollInterval);
+    }
+    function clearIntervalTimer() {
+        if (intervalId !== null) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    }
+    const manager = {
+        get running() {
+            return isRunning;
+        },
+        start() {
+            if (isRunning)
+                return; // Idempotent
+            isRunning = true;
+            // Crash recovery: run one cycle immediately on start
+            runCycle().catch(() => {
+                // Errors already captured in ring buffer
+            });
+            startInterval();
+        },
+        async stop() {
+            clearIntervalTimer();
+            isRunning = false;
+            // Wait for any in-flight cycle to complete
+            if (cycleInFlight) {
+                await cycleInFlight;
+            }
+        },
+        async trigger() {
+            // Clear existing interval, run immediately, restart interval
+            clearIntervalTimer();
+            await runCycle();
+            if (isRunning) {
+                startInterval();
+            }
+        },
+        getStatus() {
+            const pendingFiles = uploadDeps.indexManager.findUnsynced().length;
+            return {
+                enabled: true,
+                running: isRunning,
+                lastSync,
+                lastProcessedTimestamp,
+                pendingFiles,
+                errors: [...errors],
+            };
+        },
+        notifyNewData() {
+            // No-op signal — the next cycle picks up unsynced entries automatically.
+            uploadDeps.logger.debug("New data notification received");
+        },
+    };
+    return manager;
+}
+//# sourceMappingURL=sync-manager.js.map

package/dist/sync/engine/sync-manager.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,4 @@
+export type { FileRecord, FileListResult, RegisterFileParams, FileRegistration, SyncStatus, SyncError, } from "./types.js";
+export { createSyncCursor, type SyncCursor } from "./cursor.js";
+export { createSyncManager, type SyncManager, type SyncManagerOptions, } from "./engine/sync-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,3 @@
+export { createSyncCursor } from "./cursor.js";
+export { createSyncManager, } from "./engine/sync-manager.js";
+//# sourceMappingURL=index.js.map