web-remarq 0.4.9 → 0.6.0

package/dist/index.d.cts

@@ -43,6 +43,7 @@ interface WebRemarqOptions {
     dataAttribute?: string;
     position?: ToolbarPosition;
     shortcuts?: boolean;
+    storage?: StorageAdapter;
 }
 interface ImportResult {
     total: number;
@@ -83,6 +84,19 @@ interface AgentExport {
     viewportBucket: number;
     annotations: AgentAnnotation[];
 }
+interface StorageChangeEvent {
+    type: 'add' | 'update' | 'remove' | 'clear';
+    annotation?: Annotation;
+    id?: string;
+}
+interface StorageAdapter {
+    load(): Promise<AnnotationStore | null>;
+    save(annotation: Annotation): Promise<void>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+    subscribe?(callback: (event: StorageChangeEvent) => void): () => void;
+    readonly isMemoryOnly?: boolean;
+}
 
 declare const WebRemarq: {
     init(opts?: WebRemarqOptions): void;
@@ -95,4 +109,16 @@ declare const WebRemarq: {
     clearAll(): void;
 };
 
-export { type AgentAnnotation, type AgentExport, type Annotation, type AnnotationStore, type CSSModuleClass, type ElementFingerprint, type ImportResult, type ToolbarPosition, WebRemarq, type WebRemarqOptions };
+declare class LocalStorageAdapter implements StorageAdapter {
+    isMemoryOnly: boolean;
+    private extraFields;
+    private memoryStore;
+    load(): Promise<AnnotationStore | null>;
+    save(annotation: Annotation): Promise<void>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+    private ensureStore;
+    private persist;
+}
+
+export { type AgentAnnotation, type AgentExport, type Annotation, type AnnotationStore, type CSSModuleClass, type ElementFingerprint, type ImportResult, LocalStorageAdapter, type StorageAdapter, type StorageChangeEvent, type ToolbarPosition, WebRemarq, type WebRemarqOptions };

package/dist/index.d.ts

@@ -43,6 +43,7 @@ interface WebRemarqOptions {
     dataAttribute?: string;
     position?: ToolbarPosition;
     shortcuts?: boolean;
+    storage?: StorageAdapter;
 }
 interface ImportResult {
     total: number;
@@ -83,6 +84,19 @@ interface AgentExport {
     viewportBucket: number;
     annotations: AgentAnnotation[];
 }
+interface StorageChangeEvent {
+    type: 'add' | 'update' | 'remove' | 'clear';
+    annotation?: Annotation;
+    id?: string;
+}
+interface StorageAdapter {
+    load(): Promise<AnnotationStore | null>;
+    save(annotation: Annotation): Promise<void>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+    subscribe?(callback: (event: StorageChangeEvent) => void): () => void;
+    readonly isMemoryOnly?: boolean;
+}
 
 declare const WebRemarq: {
     init(opts?: WebRemarqOptions): void;
@@ -95,4 +109,16 @@ declare const WebRemarq: {
     clearAll(): void;
 };
 
-export { type AgentAnnotation, type AgentExport, type Annotation, type AnnotationStore, type CSSModuleClass, type ElementFingerprint, type ImportResult, type ToolbarPosition, WebRemarq, type WebRemarqOptions };
+declare class LocalStorageAdapter implements StorageAdapter {
+    isMemoryOnly: boolean;
+    private extraFields;
+    private memoryStore;
+    load(): Promise<AnnotationStore | null>;
+    save(annotation: Annotation): Promise<void>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+    private ensureStore;
+    private persist;
+}
+
+export { type AgentAnnotation, type AgentExport, type Annotation, type AnnotationStore, type CSSModuleClass, type ElementFingerprint, type ImportResult, LocalStorageAdapter, type StorageAdapter, type StorageChangeEvent, type ToolbarPosition, WebRemarq, type WebRemarqOptions };

package/dist/index.js

@@ -65,79 +65,133 @@ function destroyViewportListener() {
 }
 
 // src/core/storage.ts
-var STORAGE_KEY = "remarq:annotations";
 var AnnotationStorage = class {
-  constructor() {
-    this.annotations = [];
-    this.extraFields = {};
-    this.isMemoryOnly = false;
-    this.load();
+  constructor(adapter) {
+    this.adapter = adapter;
+    this.cache = [];
+    this.ready = this.init();
+  }
+  get isMemoryOnly() {
+    var _a3;
+    return (_a3 = this.adapter.isMemoryOnly) != null ? _a3 : false;
   }
   getAll() {
-    return [...this.annotations];
+    return [...this.cache];
   }
   getByRoute(route) {
-    return this.annotations.filter((a) => a.route === route);
+    return this.cache.filter((a) => a.route === route);
   }
-  add(annotation) {
-    this.annotations.push(annotation);
-    this.save();
+  async add(annotation) {
+    this.cache.push(annotation);
+    await this.adapter.save(annotation);
   }
-  remove(id) {
-    this.annotations = this.annotations.filter((a) => a.id !== id);
-    this.save();
+  async remove(id) {
+    this.cache = this.cache.filter((a) => a.id !== id);
+    await this.adapter.remove(id);
   }
-  update(id, changes) {
-    const idx = this.annotations.findIndex((a) => a.id === id);
-    if (idx !== -1) {
-      this.annotations[idx] = __spreadValues(__spreadValues({}, this.annotations[idx]), changes);
-      this.save();
-    }
+  async update(id, changes) {
+    const idx = this.cache.findIndex((a) => a.id === id);
+    if (idx === -1) return;
+    const updated = __spreadValues(__spreadValues({}, this.cache[idx]), changes);
+    this.cache[idx] = updated;
+    await this.adapter.save(updated);
   }
-  clearAll() {
-    this.annotations = [];
-    this.save();
+  async clearAll() {
+    this.cache = [];
+    await this.adapter.clear();
   }
   exportJSON() {
     return {
       version: 1,
-      annotations: [...this.annotations]
+      annotations: [...this.cache]
     };
   }
-  importJSON(data) {
-    this.annotations = [...data.annotations];
+  async importJSON(data) {
+    this.cache = [...data.annotations];
     this.migrateViewportBuckets();
-    this.save();
+    await this.adapter.clear();
+    for (const ann of this.cache) {
+      await this.adapter.save(ann);
+    }
+  }
+  async init() {
+    const data = await this.adapter.load();
+    if (data) {
+      this.cache = data.annotations;
+      this.migrateViewportBuckets();
+    }
   }
   migrateViewportBuckets() {
-    for (const ann of this.annotations) {
+    for (const ann of this.cache) {
       if (ann.viewportBucket == null && ann.viewport) {
         const width = parseInt(ann.viewport.split("x")[0], 10);
         ann.viewportBucket = toBucket(width);
       }
     }
   }
-  load() {
+};
+
+// src/core/local-storage-adapter.ts
+var STORAGE_KEY = "remarq:annotations";
+var LocalStorageAdapter = class {
+  constructor() {
+    this.isMemoryOnly = false;
+    this.extraFields = {};
+    this.memoryStore = null;
+  }
+  async load() {
+    if (this.isMemoryOnly) return this.memoryStore;
     try {
       const raw = localStorage.getItem(STORAGE_KEY);
-      if (raw) {
-        const parsed = JSON.parse(raw);
-        const _a3 = parsed, { version, annotations } = _a3, rest = __objRest(_a3, ["version", "annotations"]);
-        this.annotations = annotations != null ? annotations : [];
-        this.extraFields = rest;
-        this.migrateViewportBuckets();
-      }
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      const _a3 = parsed, { version, annotations } = _a3, rest = __objRest(_a3, ["version", "annotations"]);
+      this.extraFields = rest;
+      const store = {
+        version: 1,
+        annotations: Array.isArray(annotations) ? annotations : []
+      };
+      this.memoryStore = store;
+      return store;
     } catch (e) {
       this.isMemoryOnly = true;
+      return this.memoryStore;
+    }
+  }
+  async save(annotation) {
+    const store = await this.ensureStore();
+    const idx = store.annotations.findIndex((a) => a.id === annotation.id);
+    if (idx === -1) {
+      store.annotations.push(annotation);
+    } else {
+      store.annotations[idx] = annotation;
     }
+    this.persist(store);
+  }
+  async remove(id) {
+    const store = await this.ensureStore();
+    store.annotations = store.annotations.filter((a) => a.id !== id);
+    this.persist(store);
+  }
+  async clear() {
+    const store = await this.ensureStore();
+    store.annotations = [];
+    this.persist(store);
   }
-  save() {
+  async ensureStore() {
+    if (this.memoryStore) return this.memoryStore;
+    const loaded = await this.load();
+    if (loaded) return loaded;
+    this.memoryStore = { version: 1, annotations: [] };
+    return this.memoryStore;
+  }
+  persist(store) {
     if (this.isMemoryOnly) return;
     try {
       const data = __spreadProps(__spreadValues({
         version: 1
       }, this.extraFields), {
-        annotations: this.annotations
+        annotations: store.annotations
       });
       localStorage.setItem(STORAGE_KEY, JSON.stringify(data));
     } catch (e) {
@@ -2617,18 +2671,18 @@ function setupMutationObserver() {
 }
 var WebRemarq = {
   init(opts) {
-    var _a3;
+    var _a3, _b;
     if (initialized) return;
     options = opts != null ? opts : {};
     try {
       injectStyles();
-      storage = new AnnotationStorage();
+      storage = new AnnotationStorage((_a3 = options.storage) != null ? _a3 : new LocalStorageAdapter());
       themeManager = new ThemeManager(document.body, options.theme);
       overlay = new Overlay(themeManager.container);
       spacingOverlay = new SpacingOverlay(themeManager.container);
       popup = new Popup(themeManager.container);
       markers = new MarkerManager(themeManager.container, handleMarkerClick);
-      const position = (_a3 = options.position) != null ? _a3 : "bottom-right";
+      const position = (_b = options.position) != null ? _b : "bottom-right";
       detachedPanel = new DetachedPanel(themeManager.container, (id) => {
         elementCache.delete(id);
         storage.remove(id);
@@ -2661,9 +2715,6 @@ var WebRemarq = {
         onThemeToggle: () => themeManager.toggle(),
         onHelp: () => showShortcutsModal(themeManager.container)
       }, position);
-      if (storage.isMemoryOnly) {
-        toolbar.setMemoryWarning(true);
-      }
       routeObserver = new RouteObserver();
       unsubRoute = routeObserver.onChange(() => refreshMarkers());
       document.addEventListener("click", handleInspectClick, true);
@@ -2671,8 +2722,13 @@ var WebRemarq = {
       document.addEventListener("keydown", handleInspectKeydown);
       setupMutationObserver();
       initViewportListener(() => refreshMarkers());
+      storage.ready.then(() => {
+        if (storage.isMemoryOnly) {
+          toolbar.setMemoryWarning(true);
+        }
+        refreshMarkers();
+      });
       console.debug(`[web-remarq] Initialized on route: ${currentRoute()}`);
-      refreshMarkers();
       initialized = true;
     } catch (err) {
       console.error("[web-remarq] Init failed:", err);
@@ -2754,6 +2810,7 @@ var WebRemarq = {
   }
 };
 export {
+  LocalStorageAdapter,
   WebRemarq
 };
 //# sourceMappingURL=index.js.map