@hashtree/worker 0.1.26 → 0.2.1

package/dist/tree-root.d.ts

@@ -1,201 +0,0 @@
-/**
- * TreeRootRegistry - Browser-side single source of truth for tree root data
- *
- * This module provides:
- * - Unified record format for all root data
- * - Subscription API that emits cached data immediately, then updates
- * - Async resolve with timeout for waiting on first resolution
- * - Local write tracking with dirty flag for publish throttling
- * - Pluggable persistence (localStorage by default)
- *
- * This module lives under @hashtree/worker because it coordinates with worker
- * updates and publish flows, but it runs on the app/main thread.
- */
-import type { Hash, TreeVisibility } from '@hashtree/core';
-/**
- * Source of the tree root update
- */
-export type TreeRootSource = 'local-write' | 'nostr' | 'prefetch' | 'worker';
-/**
- * Core record format - single source of truth for all root data
- */
-export interface TreeRootRecord {
-    hash: Hash;
-    key?: Hash;
-    visibility: TreeVisibility;
-    labels?: string[];
-    updatedAt: number;
-    source: TreeRootSource;
-    dirty: boolean;
-    encryptedKey?: string;
-    keyId?: string;
-    selfEncryptedKey?: string;
-    selfEncryptedLinkKey?: string;
-}
-/**
- * Listener callback type
- */
-type Listener = (record: TreeRootRecord | null) => void;
-/**
- * Persistence interface - allows swapping localStorage for IndexedDB/etc
- */
-export interface RegistryPersistence {
-    save(key: string, record: TreeRootRecord): void;
-    load(key: string): TreeRootRecord | null;
-    delete(key: string): void;
-    loadAll(): Map<string, TreeRootRecord>;
-}
-/**
- * TreeRootRegistry - singleton class for managing tree root data
- */
-declare class TreeRootRegistryImpl {
-    private records;
-    private listeners;
-    private globalListeners;
-    private persistence;
-    private publishTimers;
-    private publishFn;
-    private publishDelay;
-    private retryDelay;
-    constructor(persistence?: RegistryPersistence);
-    /**
-     * Hydrate from persistence on startup
-     */
-    private hydrate;
-    /**
-     * Set the publish function (called with throttling for dirty records)
-     */
-    setPublishFn(fn: (npub: string, treeName: string, record: TreeRootRecord) => Promise<boolean>): void;
-    /**
-     * Build cache key from npub and treeName
-     */
-    private makeKey;
-    /**
-     * Notify listeners of a record change
-     */
-    private notify;
-    private shouldAcceptUpdate;
-    private mergeSameHashMetadata;
-    /**
-     * Sync lookup - returns cached record or null (no side effects)
-     */
-    get(npub: string, treeName: string): TreeRootRecord | null;
-    /**
-     * Get by key directly
-     */
-    getByKey(key: string): TreeRootRecord | null;
-    /**
-     * Async resolve - returns current record if cached, otherwise waits for first resolve
-     */
-    resolve(npub: string, treeName: string, options?: {
-        timeoutMs?: number;
-    }): Promise<TreeRootRecord | null>;
-    /**
-     * Subscribe to updates for a specific tree
-     * Emits current snapshot immediately if available, then future updates
-     */
-    subscribe(npub: string, treeName: string, callback: Listener): () => void;
-    /**
-     * Subscribe to all registry updates (for bridges like Tauri/worker)
-     */
-    subscribeAll(callback: (key: string, record: TreeRootRecord | null) => void): () => void;
-    /**
-     * Set record from local write - marks dirty and schedules publish
-     */
-    setLocal(npub: string, treeName: string, hash: Hash, options?: {
-        key?: Hash;
-        visibility?: TreeVisibility;
-        labels?: string[];
-        encryptedKey?: string;
-        keyId?: string;
-        selfEncryptedKey?: string;
-        selfEncryptedLinkKey?: string;
-    }): void;
-    /**
-     * Set record from resolver (Nostr event) - only updates if newer
-     */
-    setFromResolver(npub: string, treeName: string, hash: Hash, updatedAt: number, options?: {
-        key?: Hash;
-        visibility?: TreeVisibility;
-        labels?: string[];
-        encryptedKey?: string;
-        keyId?: string;
-        selfEncryptedKey?: string;
-        selfEncryptedLinkKey?: string;
-    }): boolean;
-    /**
-     * Merge a decrypted key into an existing record without changing updatedAt/source.
-     * Returns true if the record was updated.
-     */
-    mergeKey(npub: string, treeName: string, hash: Hash, key: Hash): boolean;
-    /**
-     * Set record from worker (Nostr subscription routed through worker)
-     * Similar to setFromResolver but source is 'worker'
-     */
-    setFromWorker(npub: string, treeName: string, hash: Hash, updatedAt: number, options?: {
-        key?: Hash;
-        visibility?: TreeVisibility;
-        labels?: string[];
-        encryptedKey?: string;
-        keyId?: string;
-        selfEncryptedKey?: string;
-        selfEncryptedLinkKey?: string;
-    }): boolean;
-    /**
-     * Set record from external source (Tauri, worker, prefetch)
-     */
-    setFromExternal(npub: string, treeName: string, hash: Hash, source: TreeRootSource, options?: {
-        key?: Hash;
-        visibility?: TreeVisibility;
-        labels?: string[];
-        updatedAt?: number;
-        encryptedKey?: string;
-        keyId?: string;
-        selfEncryptedKey?: string;
-        selfEncryptedLinkKey?: string;
-    }): void;
-    /**
-     * Delete a record
-     */
-    delete(npub: string, treeName: string): void;
-    /**
-     * Schedule a throttled publish
-     */
-    private schedulePublish;
-    /**
-     * Execute the publish
-     */
-    private doPublish;
-    /**
-     * Force immediate publish of all dirty records
-     */
-    flushPendingPublishes(): Promise<void>;
-    /**
-     * Cancel pending publish (call before delete to prevent "undelete")
-     */
-    cancelPendingPublish(npub: string, treeName: string): void;
-    /**
-     * Get all records (for debugging/migration)
-     */
-    getAllRecords(): Map<string, TreeRootRecord>;
-    /**
-     * Check if a record exists
-     */
-    has(npub: string, treeName: string): boolean;
-    /**
-     * Get visibility for a tree
-     */
-    getVisibility(npub: string, treeName: string): TreeVisibility | undefined;
-    /**
-     * Get labels for a tree
-     */
-    getLabels(npub: string, treeName: string): string[] | undefined;
-}
-declare global {
-    interface Window {
-        __treeRootRegistry?: TreeRootRegistryImpl;
-    }
-}
-export declare const treeRootRegistry: TreeRootRegistryImpl;
-export type { TreeRootRecord as TreeRootEntry };
-//# sourceMappingURL=tree-root.d.ts.map

package/dist/tree-root.d.ts.map

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