@drakkar.software/starfish-client 3.0.0-alpha.2 → 3.0.0-alpha.4

package/dist/service-worker.js

@@ -1,55 +0,0 @@
-/**
- * Service Worker utilities for offline support and PWA functionality.
- */
-/** Check if service workers are supported in the current environment. */
-export function isServiceWorkerSupported() {
-    return typeof navigator !== "undefined" && "serviceWorker" in navigator;
-}
-/**
- * Register a service worker for offline support.
- * Returns the registration, or null if not supported.
- */
-export async function registerServiceWorker(scriptUrl, opts) {
-    if (!isServiceWorkerSupported())
-        return null;
-    try {
-        const registration = await navigator.serviceWorker.register(scriptUrl, {
-            scope: opts?.scope,
-        });
-        if (opts?.onUpdate) {
-            registration.onupdatefound = () => {
-                const installingWorker = registration.installing;
-                if (installingWorker) {
-                    installingWorker.onstatechange = () => {
-                        if (installingWorker.state === "installed" &&
-                            navigator.serviceWorker.controller) {
-                            opts.onUpdate(registration);
-                        }
-                    };
-                }
-            };
-        }
-        return registration;
-    }
-    catch {
-        return null;
-    }
-}
-/** Unregister all service worker registrations. Returns true if any were unregistered. */
-export async function unregisterServiceWorkers() {
-    if (!isServiceWorkerSupported())
-        return false;
-    try {
-        const registrations = await navigator.serviceWorker.getRegistrations();
-        let unregistered = false;
-        for (const registration of registrations) {
-            const result = await registration.unregister();
-            if (result)
-                unregistered = true;
-        }
-        return unregistered;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/storage/indexeddb.js

@@ -1,59 +0,0 @@
-/**
- * IndexedDB-based storage adapter for Zustand persistence.
- * Implements the same interface as Zustand's StateStorage (getItem/setItem/removeItem).
- * Supports larger data than localStorage (typically 50MB+).
- */
-function openDB(dbName, storeName) {
-    return new Promise((resolve, reject) => {
-        const request = indexedDB.open(dbName, 1);
-        request.onupgradeneeded = () => {
-            const db = request.result;
-            if (!db.objectStoreNames.contains(storeName)) {
-                db.createObjectStore(storeName);
-            }
-        };
-        request.onsuccess = () => resolve(request.result);
-        request.onerror = () => reject(request.error);
-    });
-}
-function idbRequest(request) {
-    return new Promise((resolve, reject) => {
-        request.onsuccess = () => resolve(request.result);
-        request.onerror = () => reject(request.error);
-    });
-}
-export function createIndexedDBStorage(opts) {
-    const dbName = opts?.dbName ?? "starfish";
-    const storeName = opts?.storeName ?? "state";
-    let dbPromise = null;
-    function getDB() {
-        if (!dbPromise) {
-            dbPromise = openDB(dbName, storeName).catch((err) => {
-                dbPromise = null; // Reset so next call retries
-                throw err;
-            });
-        }
-        return dbPromise;
-    }
-    return {
-        async getItem(name) {
-            const db = await getDB();
-            const tx = db.transaction(storeName, "readonly");
-            const store = tx.objectStore(storeName);
-            const result = await idbRequest(store.get(name));
-            return result ?? null;
-        },
-        async setItem(name, value) {
-            const db = await getDB();
-            const tx = db.transaction(storeName, "readwrite");
-            const store = tx.objectStore(storeName);
-            await idbRequest(store.put(value, name));
-        },
-        async removeItem(name) {
-            const db = await getDB();
-            const tx = db.transaction(storeName, "readwrite");
-            const store = tx.objectStore(storeName);
-            await idbRequest(store.delete(name));
-        },
-    };
-}

package/dist/sync.js

@@ -1,127 +0,0 @@
-import { deepMerge, stableStringify } from "@drakkar.software/starfish-protocol";
-import { ConflictError } from "./types.js";
-import { createEncryptor } from "./crypto.js";
-import { ValidationError } from "./validate.js";
-export class SyncManager {
-    client;
-    pullPath;
-    pushPath;
-    onConflict;
-    maxRetries;
-    encryptor;
-    signData;
-    logger;
-    loggerName;
-    validate;
-    lastHash = null;
-    lastCheckpoint = 0;
-    localData = {};
-    constructor(options) {
-        this.client = options.client;
-        this.pullPath = options.pullPath;
-        this.pushPath = options.pushPath;
-        this.onConflict = options.onConflict ?? deepMerge;
-        this.maxRetries = options.maxRetries ?? 3;
-        this.signData = options.signData;
-        this.logger = options.logger;
-        this.loggerName = options.loggerName ?? options.pullPath.split("/").filter(Boolean).pop() ?? options.pullPath;
-        this.validate = options.validate;
-        this.encryptor =
-            options.encryptor ??
-                (options.encryptionSecret && options.encryptionSalt
-                    ? createEncryptor(options.encryptionSecret, options.encryptionSalt, options.encryptionInfo)
-                    : null);
-    }
-    getData() {
-        return { ...this.localData };
-    }
-    getHash() {
-        return this.lastHash;
-    }
-    getCheckpoint() {
-        return this.lastCheckpoint;
-    }
-    async pull() {
-        this.logger?.pullStart(this.loggerName);
-        const start = performance.now();
-        try {
-            const result = await this.client.pull(this.pullPath, this.lastCheckpoint);
-            if (this.encryptor) {
-                const decrypted = await this.encryptor.decrypt(result.data);
-                this.localData = decrypted;
-                result.data = decrypted;
-            }
-            else if (this.lastCheckpoint > 0) {
-                this.localData = deepMerge(this.localData, result.data);
-                result.data = this.localData;
-            }
-            else {
-                this.localData = result.data;
-            }
-            this.lastHash = result.hash;
-            this.lastCheckpoint = result.timestamp;
-            this.logger?.pullSuccess(this.loggerName, Math.round(performance.now() - start));
-            return result;
-        }
-        catch (err) {
-            this.logger?.pullError(this.loggerName, err instanceof Error ? err.message : String(err));
-            throw err;
-        }
-    }
-    async push(data) {
-        if (this.validate) {
-            const result = this.validate(data);
-            if (result !== true)
-                throw new ValidationError(result);
-        }
-        this.logger?.pushStart(this.loggerName);
-        const start = performance.now();
-        let attempt = 0;
-        let pendingData = data;
-        while (attempt <= this.maxRetries) {
-            try {
-                const payload = this.encryptor
-                    ? await this.encryptor.encrypt(pendingData)
-                    : pendingData;
-                const sig = this.signData
-                    ? await this.signData(stableStringify(payload))
-                    : undefined;
-                const result = await this.client.push(this.pushPath, payload, this.lastHash, sig);
-                this.lastHash = result.hash;
-                this.lastCheckpoint = result.timestamp;
-                this.localData = pendingData;
-                this.logger?.pushSuccess(this.loggerName, Math.round(performance.now() - start));
-                return result;
-            }
-            catch (err) {
-                if (!(err instanceof ConflictError) || attempt >= this.maxRetries) {
-                    this.logger?.pushError(this.loggerName, err instanceof Error ? err.message : String(err));
-                    throw err;
-                }
-                this.logger?.conflict(this.loggerName, attempt + 1);
-                try {
-                    const remote = await this.client.pull(this.pullPath);
-                    const remoteData = this.encryptor
-                        ? await this.encryptor.decrypt(remote.data)
-                        : remote.data;
-                    this.lastHash = remote.hash;
-                    this.lastCheckpoint = remote.timestamp;
-                    pendingData = this.onConflict(pendingData, remoteData);
-                }
-                catch (resolveErr) {
-                    const msg = resolveErr instanceof Error ? resolveErr.message : String(resolveErr);
-                    this.logger?.pushError(this.loggerName, `Conflict resolution failed (attempt ${attempt + 1}): ${msg}`);
-                    throw resolveErr;
-                }
-                await new Promise(resolve => setTimeout(resolve, Math.min(100 * Math.pow(2, attempt), 2000) + Math.random() * 100));
-                attempt++;
-            }
-        }
-        throw new ConflictError();
-    }
-    async update(modifier) {
-        await this.pull();
-        const updated = modifier(this.localData);
-        return this.push(updated);
-    }
-}

package/dist/types.js

@@ -1,18 +0,0 @@
-/** Push conflict error (HTTP 409). */
-export class ConflictError extends Error {
-    constructor() {
-        super("hash_mismatch");
-        this.name = "ConflictError";
-    }
-}
-/** HTTP error from the Starfish server. */
-export class StarfishHttpError extends Error {
-    status;
-    body;
-    constructor(status, body) {
-        super(`HTTP ${status}: ${body}`);
-        this.status = status;
-        this.body = body;
-        this.name = "StarfishHttpError";
-    }
-}

package/dist/validate.js

@@ -1,28 +0,0 @@
-/** Error thrown when pre-push validation fails. */
-export class ValidationError extends Error {
-    errors;
-    constructor(errors) {
-        super(`Validation failed: ${errors.join("; ")}`);
-        this.errors = errors;
-        this.name = "ValidationError";
-    }
-}
-/**
- * Creates a validator from a JSON Schema object.
- * Requires an Ajv-compatible validate function.
- *
- * @example
- * ```ts
- * import Ajv from "ajv"
- * const ajv = new Ajv()
- * const validator = createSchemaValidator(ajv, mySchema)
- * ```
- */
-export function createSchemaValidator(ajv, schema) {
-    const validate = ajv.compile(schema);
-    return (data) => {
-        if (validate(data))
-            return true;
-        return [ajv.errorsText(validate.errors)];
-    };
-}