clanker-agent/packages/web-ui/src/storage/store.ts

import type { StorageBackend, StoreConfig } from "./types.js";

/**
 * Base class for all storage stores.
 * Each store defines its IndexedDB schema and provides domain-specific methods.
 */
export abstract class Store {
  private backend: StorageBackend | null = null;

  /**
   * Returns the IndexedDB configuration for this store.
   * Defines store name, key path, and indices.
   */
  abstract getConfig(): StoreConfig;

  /**
   * Sets the storage backend. Called by AppStorage after backend creation.
   */
  setBackend(backend: StorageBackend): void {
    this.backend = backend;
  }

  /**
   * Gets the storage backend. Throws if backend not set.
   * Concrete stores must use this to access the backend.
   */
  protected getBackend(): StorageBackend {
    if (!this.backend) {
      throw new Error(`Backend not set on ${this.constructor.name}`);
    }
    return this.backend;
  }
}