@de-otio/chaoskb-client 0.2.0

package/dist/storage/sync-status-repo.d.ts

@@ -0,0 +1,15 @@
+import type BetterSqlite3 from 'better-sqlite3';
+import type { ISyncStatusRepository, SyncStatusRecord } from './types.js';
+import { SyncStatus } from './types.js';
+export declare class SyncStatusRepository implements ISyncStatusRepository {
+    private readonly setStmt;
+    private readonly getStmt;
+    private readonly getPendingStmt;
+    private readonly getByStatusStmt;
+    constructor(db: BetterSqlite3.Database);
+    set(blobId: string, status: SyncStatus, errorMessage?: string): void;
+    get(blobId: string): SyncStatusRecord | null;
+    getPending(): SyncStatusRecord[];
+    getByStatus(status: SyncStatus): SyncStatusRecord[];
+}
+//# sourceMappingURL=sync-status-repo.d.ts.map

package/dist/storage/sync-status-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-status-repo.d.ts","sourceRoot":"","sources":["../../storage/sync-status-repo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkBxC,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;gBAE9C,EAAE,EAAE,aAAa,CAAC,QAAQ;IAetC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAIpE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAK5C,UAAU,IAAI,gBAAgB,EAAE;IAKhC,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,EAAE;CAIpD"}

package/dist/storage/sync-status-repo.js

@@ -0,0 +1,40 @@
+import { SyncStatus } from './types.js';
+function rowToRecord(row) {
+    return {
+        blobId: row.blob_id,
+        status: row.status,
+        lastAttempt: row.last_attempt ?? undefined,
+        errorMessage: row.error_message ?? undefined,
+    };
+}
+export class SyncStatusRepository {
+    setStmt;
+    getStmt;
+    getPendingStmt;
+    getByStatusStmt;
+    constructor(db) {
+        this.setStmt = db.prepare(`
+      INSERT OR REPLACE INTO sync_status (blob_id, status, last_attempt, error_message)
+      VALUES (?, ?, datetime('now'), ?)
+    `);
+        this.getStmt = db.prepare('SELECT * FROM sync_status WHERE blob_id = ?');
+        this.getPendingStmt = db.prepare(`SELECT * FROM sync_status WHERE status IN ('${SyncStatus.LocalOnly}', '${SyncStatus.SyncFailed}')`);
+        this.getByStatusStmt = db.prepare('SELECT * FROM sync_status WHERE status = ?');
+    }
+    set(blobId, status, errorMessage) {
+        this.setStmt.run(blobId, status, errorMessage ?? null);
+    }
+    get(blobId) {
+        const row = this.getStmt.get(blobId);
+        return row ? rowToRecord(row) : null;
+    }
+    getPending() {
+        const rows = this.getPendingStmt.all();
+        return rows.map(rowToRecord);
+    }
+    getByStatus(status) {
+        const rows = this.getByStatusStmt.all(status);
+        return rows.map(rowToRecord);
+    }
+}
+//# sourceMappingURL=sync-status-repo.js.map

package/dist/storage/sync-status-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-status-repo.js","sourceRoot":"","sources":["../../storage/sync-status-repo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AASxC,SAAS,WAAW,CAAC,GAAkB;IACrC,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,OAAO;QACnB,MAAM,EAAE,GAAG,CAAC,MAAoB;QAChC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC1C,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,oBAAoB;IACd,OAAO,CAA0B;IACjC,OAAO,CAA0B;IACjC,cAAc,CAA0B;IACxC,eAAe,CAA0B;IAE1D,YAAY,EAA0B;QACpC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;;;KAGzB,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;QAEzE,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC,OAAO,CAC9B,+CAA+C,UAAU,CAAC,SAAS,OAAO,UAAU,CAAC,UAAU,IAAI,CACpG,CAAC;QAEF,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC;IAClF,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,MAAkB,EAAE,YAAqB;QAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,IAAI,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAA8B,CAAC;QAClE,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAqB,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,MAAkB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAoB,CAAC;QACjE,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/storage/types.d.ts

@@ -0,0 +1,139 @@
+/** Source record in the database */
+export interface SourceRecord {
+    id: string;
+    url: string;
+    title: string;
+    tags: string[];
+    chunkCount: number;
+    blobSizeBytes: number;
+    createdAt: string;
+    updatedAt: string;
+    lastAccessedAt: string;
+    deletedAt?: string;
+}
+/** Chunk record in the database */
+export interface ChunkRecord {
+    id: string;
+    sourceId: string;
+    chunkIndex: number;
+    content: string;
+    embedding: Float32Array;
+    tokenCount: number;
+    model: string;
+}
+/** Sync status for a blob */
+export declare enum SyncStatus {
+    LocalOnly = "local_only",
+    Synced = "synced",
+    PendingDelete = "pending_delete",
+    SyncFailed = "sync_failed"
+}
+/** Sync status record */
+export interface SyncStatusRecord {
+    blobId: string;
+    status: SyncStatus;
+    lastAttempt?: string;
+    errorMessage?: string;
+}
+/** Pagination options */
+export interface PaginationOptions {
+    limit: number;
+    offset: number;
+}
+/** Filter options for listing sources */
+export interface SourceFilter {
+    tags?: string[];
+    /** Only include sources created after this date */
+    since?: string;
+    /** Search title substring */
+    titleSearch?: string;
+    /** Include soft-deleted sources */
+    includeDeleted?: boolean;
+}
+/** Database configuration */
+export interface DatabaseConfig {
+    /** Path to the SQLite database file */
+    path: string;
+    /** Project name (undefined for personal KB) */
+    projectName?: string;
+}
+/** Source repository interface */
+export interface ISourceRepository {
+    insert(source: Omit<SourceRecord, 'createdAt' | 'updatedAt' | 'lastAccessedAt'>): SourceRecord;
+    getById(id: string): SourceRecord | null;
+    list(filter?: SourceFilter, pagination?: PaginationOptions): SourceRecord[];
+    count(filter?: SourceFilter): number;
+    softDelete(id: string): boolean;
+    restore(id: string): boolean;
+    updateLastAccessed(id: string): void;
+}
+/** Result of a keyword search */
+export interface KeywordSearchResult {
+    sourceId: string;
+    chunkIndex: number;
+    content: string;
+    snippet: string;
+    rank: number;
+}
+/** Chunk repository interface */
+export interface IChunkRepository {
+    insertMany(chunks: Omit<ChunkRecord, 'id'>[]): ChunkRecord[];
+    getBySourceId(sourceId: string): ChunkRecord[];
+    deleteBySourceId(sourceId: string): number;
+    /** Search chunk content using FTS5 keyword matching */
+    searchKeyword(query: string, topK: number): KeywordSearchResult[];
+}
+/** Sync status repository interface */
+export interface ISyncStatusRepository {
+    set(blobId: string, status: SyncStatus, errorMessage?: string): void;
+    get(blobId: string): SyncStatusRecord | null;
+    getPending(): SyncStatusRecord[];
+    getByStatus(status: SyncStatus): SyncStatusRecord[];
+}
+/** Embedding index for in-memory search */
+export interface IEmbeddingIndex {
+    /** Load all embeddings from database */
+    load(): void;
+    /** Add embeddings for a source */
+    add(sourceId: string, chunks: {
+        chunkIndex: number;
+        embedding: Float32Array;
+    }[]): void;
+    /** Remove embeddings for a source */
+    remove(sourceId: string): void;
+    /** Search for similar embeddings, return indices sorted by score */
+    search(query: Float32Array, topK: number): {
+        sourceId: string;
+        chunkIndex: number;
+        score: number;
+    }[];
+    /** Total number of embeddings in the index */
+    readonly size: number;
+}
+/** Database manager for multiple KBs */
+export interface IDatabaseManager {
+    /** Get or create the personal database */
+    getPersonalDb(): IDatabase;
+    /** Get or create a project database */
+    getProjectDb(projectName: string): IDatabase;
+    /** List all project databases */
+    listProjects(): {
+        name: string;
+        path: string;
+        sizeBytes: number;
+        sourceCount: number;
+    }[];
+    /** Delete a project database */
+    deleteProject(projectName: string): boolean;
+    /** Close all open databases */
+    closeAll(): void;
+}
+/** Combined database interface */
+export interface IDatabase {
+    readonly sources: ISourceRepository;
+    readonly chunks: IChunkRepository;
+    readonly syncStatus: ISyncStatusRepository;
+    readonly embeddingIndex: IEmbeddingIndex;
+    close(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/storage/types.js

@@ -0,0 +1,9 @@
+/** Sync status for a blob */
+export var SyncStatus;
+(function (SyncStatus) {
+    SyncStatus["LocalOnly"] = "local_only";
+    SyncStatus["Synced"] = "synced";
+    SyncStatus["PendingDelete"] = "pending_delete";
+    SyncStatus["SyncFailed"] = "sync_failed";
+})(SyncStatus || (SyncStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../storage/types.ts"],"names":[],"mappings":"AAyBA,6BAA6B;AAC7B,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,sCAAwB,CAAA;IACxB,+BAAiB,CAAA;IACjB,8CAAgC,CAAA;IAChC,wCAA0B,CAAA;AAC5B,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB"}

package/dist/sync/canary.d.ts

@@ -0,0 +1,14 @@
+import type { ISyncHttpClient } from './types.js';
+import type { IEncryptionService, DerivedKeySet } from '../crypto/types.js';
+/**
+ * Verify encryption keys by writing, reading, and verifying a canary blob.
+ *
+ * This is used on first sync to confirm that the local encryption keys
+ * can successfully round-trip through the server. The canary blob is
+ * deleted after verification.
+ *
+ * @returns true if the canary was written, read back, decrypted, and
+ *          verified successfully; false otherwise.
+ */
+export declare function verifyCanary(client: ISyncHttpClient, encryptionService: IEncryptionService, keys: DerivedKeySet): Promise<boolean>;
+//# sourceMappingURL=canary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canary.d.ts","sourceRoot":"","sources":["../../sync/canary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAiB,MAAM,oBAAoB,CAAC;AAE3F;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,EACvB,iBAAiB,EAAE,kBAAkB,EACrC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,OAAO,CAAC,CA6ClB"}

package/dist/sync/canary.js

@@ -0,0 +1,53 @@
+/**
+ * Verify encryption keys by writing, reading, and verifying a canary blob.
+ *
+ * This is used on first sync to confirm that the local encryption keys
+ * can successfully round-trip through the server. The canary blob is
+ * deleted after verification.
+ *
+ * @returns true if the canary was written, read back, decrypted, and
+ *          verified successfully; false otherwise.
+ */
+export async function verifyCanary(client, encryptionService, keys) {
+    const canaryPayload = {
+        type: 'canary',
+        value: 'chaoskb-canary-v1',
+    };
+    const blobId = encryptionService.generateBlobId();
+    try {
+        // Encrypt the canary payload
+        const { bytes } = encryptionService.encrypt(canaryPayload, keys);
+        // Upload to server
+        const putResponse = await client.put(`/v1/blobs/${blobId}`, bytes);
+        if (!putResponse.ok && putResponse.status !== 201) {
+            return false;
+        }
+        // Download back from server
+        const getResponse = await client.get(`/v1/blobs/${blobId}`);
+        if (!getResponse.ok) {
+            return false;
+        }
+        // Decrypt
+        const downloadedBytes = new Uint8Array(await getResponse.arrayBuffer());
+        const envelope = JSON.parse(new TextDecoder().decode(downloadedBytes));
+        const { payload } = encryptionService.decrypt(envelope, keys);
+        // Verify
+        if (payload.type !== 'canary' || payload.value !== 'chaoskb-canary-v1') {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        // Always attempt to clean up the canary blob
+        try {
+            await client.delete(`/v1/blobs/${blobId}`);
+        }
+        catch {
+            // Best-effort cleanup — ignore failures
+        }
+    }
+}
+//# sourceMappingURL=canary.js.map

package/dist/sync/canary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary.js","sourceRoot":"","sources":["../../sync/canary.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuB,EACvB,iBAAqC,EACrC,IAAmB;IAEnB,MAAM,aAAa,GAAkB;QACnC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,mBAAmB;KAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC;IAElD,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAEjE,mBAAmB;QACnB,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,WAAW,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,4BAA4B;QAC5B,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,UAAU;QACV,MAAM,eAAe,GAAG,IAAI,UAAU,CAAC,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;QACvE,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAE9D,SAAS;QACT,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAK,OAAyB,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YAC1F,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,6CAA6C;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/sync/full-sync.d.ts

@@ -0,0 +1,16 @@
+import type { ISyncHttpClient, SyncResult, SyncState } from './types.js';
+import type { IDatabase } from '../storage/types.js';
+/**
+ * Full sync for new devices — downloads all blobs from the server.
+ *
+ * Supports resumability via a cursor persisted in SyncState. If a previous
+ * full sync was interrupted, it resumes from where it left off.
+ *
+ * @param client - HTTP client for server communication
+ * @param storage - Local database
+ * @param state - Mutable sync state; fullSyncCursor is updated during pagination.
+ *   The caller is responsible for persisting state to disk after each call.
+ * @returns SyncResult with counts of processed blobs
+ */
+export declare function fullSync(client: ISyncHttpClient, storage: IDatabase, state: SyncState): Promise<SyncResult>;
+//# sourceMappingURL=full-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"full-sync.d.ts","sourceRoot":"","sources":["../../sync/full-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,UAAU,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AASrD;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,CAAC,CAqFrB"}

package/dist/sync/full-sync.js

@@ -0,0 +1,91 @@
+import { SyncStatus } from '../storage/types.js';
+/**
+ * Full sync for new devices — downloads all blobs from the server.
+ *
+ * Supports resumability via a cursor persisted in SyncState. If a previous
+ * full sync was interrupted, it resumes from where it left off.
+ *
+ * @param client - HTTP client for server communication
+ * @param storage - Local database
+ * @param state - Mutable sync state; fullSyncCursor is updated during pagination.
+ *   The caller is responsible for persisting state to disk after each call.
+ * @returns SyncResult with counts of processed blobs
+ */
+export async function fullSync(client, storage, state) {
+    const errors = [];
+    let newBlobs = 0;
+    let cursor = state.fullSyncCursor;
+    state.fullSyncInProgress = true;
+    while (true) {
+        const listPath = cursor ? `/v1/blobs?cursor=${encodeURIComponent(cursor)}` : '/v1/blobs';
+        const listResponse = await client.get(listPath);
+        if (!listResponse.ok) {
+            errors.push({
+                message: `Failed to list blobs: HTTP ${listResponse.status}`,
+                code: 'LIST_FAILED',
+                retryable: listResponse.status >= 500,
+            });
+            return {
+                newBlobs,
+                updatedBlobs: 0,
+                deletedBlobs: 0,
+                conflicts: [],
+                errors,
+                success: false,
+            };
+        }
+        const page = (await listResponse.json());
+        if (page.blobs.length === 0) {
+            // No more pages — full sync complete
+            break;
+        }
+        for (const blobMeta of page.blobs) {
+            try {
+                const blobResponse = await client.get(`/v1/blobs/${blobMeta.id}`);
+                if (!blobResponse.ok) {
+                    errors.push({
+                        blobId: blobMeta.id,
+                        message: `Failed to download blob: HTTP ${blobResponse.status}`,
+                        code: 'DOWNLOAD_FAILED',
+                        retryable: blobResponse.status >= 500,
+                    });
+                    continue;
+                }
+                const blobData = new Uint8Array(await blobResponse.arrayBuffer());
+                void blobData; // Consumed by higher-layer processing
+                storage.syncStatus.set(blobMeta.id, SyncStatus.Synced);
+                newBlobs++;
+            }
+            catch (error) {
+                errors.push({
+                    blobId: blobMeta.id,
+                    message: error instanceof Error ? error.message : String(error),
+                    code: 'DOWNLOAD_ERROR',
+                    retryable: true,
+                });
+            }
+        }
+        // Update cursor for resumability
+        if (page.cursor) {
+            cursor = page.cursor;
+            state.fullSyncCursor = cursor;
+        }
+        else {
+            // No more pages
+            break;
+        }
+    }
+    // Mark full sync as complete
+    state.fullSyncInProgress = false;
+    state.fullSyncCursor = undefined;
+    state.lastSyncTimestamp = new Date().toISOString();
+    return {
+        newBlobs,
+        updatedBlobs: 0,
+        deletedBlobs: 0,
+        conflicts: [],
+        errors,
+        success: errors.length === 0,
+    };
+}
+//# sourceMappingURL=full-sync.js.map

package/dist/sync/full-sync.js.map

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

package/dist/sync/http-client.d.ts

@@ -0,0 +1,28 @@
+import type { ISyncHttpClient } from './types.js';
+import type { SyncConfig } from './types.js';
+import type { SSHSigner } from './ssh-signer.js';
+import { SequenceCounter } from './sequence.js';
+/** Error that indicates the request can be retried after a delay. */
+export declare class RetryableError extends Error {
+    /** Seconds to wait before retrying */
+    readonly retryAfterSeconds: number;
+    constructor(message: string, retryAfterSeconds: number);
+}
+/**
+ * HTTP client for ChaosKB server communication.
+ *
+ * Enforces HTTPS, signs every request with the SSH signer, and
+ * provides error handling for rate-limiting and network failures.
+ */
+export declare class SyncHttpClient implements ISyncHttpClient {
+    private readonly baseUrl;
+    private readonly signer;
+    private readonly sequence;
+    constructor(config: SyncConfig, signer: SSHSigner, sequence?: SequenceCounter);
+    get(path: string): Promise<Response>;
+    put(path: string, body: Uint8Array): Promise<Response>;
+    delete(path: string): Promise<Response>;
+    post(path: string, body?: Uint8Array): Promise<Response>;
+    private request;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/sync/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../sync/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;IACvC,sCAAsC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM;CAKvD;AAKD;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,eAAe;IAYvE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;YAIhD,OAAO;CAsDtB"}

package/dist/sync/http-client.js

@@ -0,0 +1,90 @@
+import { SequenceCounter } from './sequence.js';
+/** Error that indicates the request can be retried after a delay. */
+export class RetryableError extends Error {
+    /** Seconds to wait before retrying */
+    retryAfterSeconds;
+    constructor(message, retryAfterSeconds) {
+        super(message);
+        this.name = 'RetryableError';
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/** Default request timeout in milliseconds. */
+const REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * HTTP client for ChaosKB server communication.
+ *
+ * Enforces HTTPS, signs every request with the SSH signer, and
+ * provides error handling for rate-limiting and network failures.
+ */
+export class SyncHttpClient {
+    baseUrl;
+    signer;
+    sequence;
+    constructor(config, signer, sequence) {
+        this.sequence = sequence ?? new SequenceCounter();
+        if (!config.endpoint.startsWith('https://')) {
+            throw new Error(`TLS required: endpoint must start with https://, got "${config.endpoint}"`);
+        }
+        // Strip trailing slash for clean URL joining
+        this.baseUrl = config.endpoint.replace(/\/+$/, '');
+        this.signer = signer;
+    }
+    async get(path) {
+        return this.request('GET', path);
+    }
+    async put(path, body) {
+        return this.request('PUT', path, body);
+    }
+    async delete(path) {
+        return this.request('DELETE', path);
+    }
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    async request(method, path, body) {
+        const seq = this.sequence.next();
+        const result = await this.signer.signRequest(method, path, seq, body);
+        const headers = {
+            Authorization: result.authorization,
+            'X-ChaosKB-Timestamp': result.timestamp,
+            'X-ChaosKB-Sequence': String(result.sequence),
+            'X-ChaosKB-PublicKey': result.publicKey,
+        };
+        if (body) {
+            headers['Content-Type'] = 'application/octet-stream';
+        }
+        const url = `${this.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                body: body ?? undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`Request timed out after ${REQUEST_TIMEOUT_MS}ms: ${method} ${path}`);
+            }
+            throw new Error(`Network error: ${method} ${path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        if (response.status === 401) {
+            throw new Error('Authentication failed: invalid or expired SSH signature');
+        }
+        if (response.status === 429) {
+            const retryAfterHeader = response.headers.get('Retry-After');
+            const retryAfterSeconds = retryAfterHeader ? parseInt(retryAfterHeader, 10) : 60;
+            throw new RetryableError(`Rate limited: ${method} ${path}`, isNaN(retryAfterSeconds) ? 60 : retryAfterSeconds);
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/sync/http-client.js.map

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

package/dist/sync/incremental-sync.d.ts

@@ -0,0 +1,17 @@
+import type { ISyncHttpClient, SyncResult } from './types.js';
+import type { IDatabase } from '../storage/types.js';
+/**
+ * Download changes from the server since the last sync timestamp.
+ *
+ * On first sync (no lastSyncTimestamp), downloads metadata for all blobs.
+ * For each new/updated blob, downloads the content and stores it locally.
+ * For each tombstone, soft-deletes the local record if it exists.
+ *
+ * Conflict resolution strategy:
+ *   - New remote blobs (not present locally): accept as-is
+ *   - Remote blob updated, local is synced: accept remote update
+ *   - Remote blob updated, local has unsynchronized changes: last-write-wins
+ *   - Remote tombstone, local has unsynchronized changes: keep local (local_wins)
+ */
+export declare function incrementalSync(client: ISyncHttpClient, storage: IDatabase, lastSyncTimestamp?: string): Promise<SyncResult>;
+//# sourceMappingURL=incremental-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-sync.d.ts","sourceRoot":"","sources":["../../sync/incremental-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoB,UAAU,EAA2B,MAAM,YAAY,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,SAAS,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,UAAU,CAAC,CAsJrB"}