@drakkar.software/starfish-client 3.0.0-alpha.5 → 3.0.0-alpha.50

package/dist/history.js

@@ -0,0 +1,61 @@
+export class SnapshotHistory {
+    snapshots = [];
+    maxSnapshots;
+    storageKey;
+    constructor(options) {
+        this.maxSnapshots = options?.maxSnapshots ?? 20;
+        this.storageKey = options?.storageKey;
+        if (this.storageKey) {
+            try {
+                const raw = localStorage.getItem(this.storageKey);
+                if (raw) {
+                    const parsed = JSON.parse(raw);
+                    if (Array.isArray(parsed))
+                        this.snapshots = parsed;
+                }
+            }
+            catch { /* corrupted or unavailable — start fresh */ }
+        }
+    }
+    /** Take a labeled snapshot of the given data. */
+    take(label, data) {
+        this.snapshots.push({
+            timestamp: Date.now(),
+            label,
+            data: JSON.stringify(data),
+        });
+        if (this.snapshots.length > this.maxSnapshots) {
+            this.snapshots = this.snapshots.slice(-this.maxSnapshots);
+        }
+        this.persist();
+    }
+    /** Restore data from a snapshot at the given index. Returns undefined if index is invalid or data is corrupt. */
+    restore(index) {
+        const snapshot = this.snapshots[index];
+        if (!snapshot)
+            return undefined;
+        try {
+            return JSON.parse(snapshot.data);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** List available snapshots (metadata only, no data payload). */
+    list() {
+        return this.snapshots.map(({ timestamp, label }) => ({ timestamp, label }));
+    }
+    /** Clear all snapshots. */
+    clear() {
+        this.snapshots = [];
+        this.persist();
+    }
+    persist() {
+        if (!this.storageKey)
+            return;
+        try {
+            localStorage.setItem(this.storageKey, JSON.stringify(this.snapshots));
+        }
+        catch { /* quota exceeded — skip silently */ }
+    }
+}

package/dist/index.d.ts

@@ -4,21 +4,26 @@ export { stableStringify, computeHash } from "@drakkar.software/starfish-protoco
 export { buildRevocationList, revocationListCanonicalSigningInput } from "@drakkar.software/starfish-protocol";
 export type { RevocationList, RevocationEntry, RevokedSubject, BuildRevocationListOpts, } from "@drakkar.software/starfish-protocol";
 export type { PullResult, PushSuccess, PullKeyringProjection } from "@drakkar.software/starfish-protocol";
-export { StarfishClient } from "./client.js";
-export type { BlobPullResult, BlobPushResult, AppendPullOptions, PullOptions } from "./client.js";
+export { StarfishClient, pullWasFromCache, stripPushPrefix } from "./client.js";
+export type { BlobPullResult, BlobPushResult, AppendPullOptions, PullOptions, BatchPullOptions, BatchPullResult, BatchPullEntry, } from "./client.js";
+export { sealAndPushBlob, pullAndOpenBlob } from "./blob-seal.js";
+export type { ByteSealer, SealAndPushBlobOptions, PullAndOpenBlobOptions, } from "./blob-seal.js";
+export { PARQUET_MIME_TYPE, PARQUET_MIME_TYPES } from "@drakkar.software/starfish-protocol";
 export { SyncManager, AbortError } from "./sync.js";
 export type { SyncManagerOptions, SyncSigner } from "./sync.js";
+export { AppendLogCursor, AppendAuthorError, checkpointOf } from "./append-log.js";
+export type { AppendLogCursorOptions, AppendElement, AuthorVerifier, ElementErrorPolicy } from "./append-log.js";
 export { ENCRYPTED_KEY } from "@drakkar.software/starfish-protocol";
 export type { Encryptor } from "@drakkar.software/starfish-protocol";
-export { ConflictError, StarfishHttpError, } from "./types.js";
-export type { StarfishClientOptions, StarfishCapProvider, ConflictResolver, ClientPlugin, } from "./types.js";
+export { ConflictError, StarfishHttpError, AppendHttpError, } from "./types.js";
+export type { StarfishClientOptions, StarfishCapProvider, PullCache, ConflictResolver, ClientPlugin, } from "./types.js";
 export { consoleSyncLogger, noopSyncLogger, createMetricsCollector } from "./logger.js";
 export type { SyncLogger, SyncMetrics, MetricsCollector } from "./logger.js";
 export { createMigrator } from "./migrate.js";
 export type { MigrationFn, MigrationConfig } from "./migrate.js";
 export { ValidationError, createSchemaValidator } from "./validate.js";
 export type { Validator, ValidationResult } from "./validate.js";
-export { classifyError } from "./fetch.js";
+export { classifyError, parseRetryAfterMs } from "./fetch.js";
 export type { ErrorCategory } from "./fetch.js";
 export { createUnionMerge, createSoftDeleteResolver, timestampWinner, pruneTombstones, withConflictMeta, } from "./resolvers.js";
 export type { ConflictMeta, ConflictResolverWithMeta } from "./resolvers.js";
@@ -27,10 +32,14 @@ export type { Snapshot, SnapshotHistoryOptions } from "./history.js";
 export { startPolling, startAdaptivePolling } from "./polling.js";
 export type { PollableState, AdaptivePollingOptions, AdaptivePollingControls } from "./polling.js";
 export { createDedupFetch } from "./dedup.js";
+export { mutateDoc } from "./mutate.js";
+export type { DocState, DocMutator, MutateDocOptions } from "./mutate.js";
 export { fetchServerConfig } from "./config.js";
 export type { EncryptionMode, CollectionClientInfo, ConfigResponse } from "./config.js";
 export { createIndexedDBStorage } from "./storage/indexeddb.js";
 export type { IndexedDBStorageOptions, AsyncStateStorage } from "./storage/indexeddb.js";
+export { createKvPullCache } from "./kv-cache.js";
+export type { KvStore, KvPullCacheOptions } from "./kv-cache.js";
 export { exportData, importData, exportToBlob } from "./export.js";
 export type { ExportOptions } from "./export.js";
 export { isBackgroundSyncSupported, registerBackgroundSync } from "./background-sync.js";
@@ -40,8 +49,8 @@ export type { ServiceWorkerOptions } from "./service-worker.js";
 export { createSuspenseResource } from "./bindings/suspense.js";
 export { createDebouncedSync, createDebouncedPush } from "./debounced-sync.js";
 export type { DebouncedSyncOptions, DebouncedSync, DebouncedPushOptions, DebouncedPush } from "./debounced-sync.js";
-export { createMobileLifecycle } from "./mobile-lifecycle.js";
-export type { AppStateModule, NetInfoModule, MobileLifecycleDeps, MobileLifecycleOptions } from "./mobile-lifecycle.js";
+export { createMobileLifecycle, createAppendLogMobileLifecycle } from "./mobile-lifecycle.js";
+export type { AppStateModule, NetInfoModule, MobileLifecycleDeps, MobileLifecycleOptions, AppendLogLifecycleOptions } from "./mobile-lifecycle.js";
 export { createMultiStoreSync } from "./multi-store.js";
 export type { StoreSlice, BackupDocument, MultiStoreMigrationFn, MultiStoreSyncOptions, MultiStoreSync, } from "./multi-store.js";
 export type { AppendOnlyClientInfo } from "./config.js";