@abloatai/ablo 0.34.1 → 0.36.0

package/dist/Database.d.ts

@@ -5,11 +5,16 @@
  * server. {@link BaseSyncedStore} drives it, and {@link InstanceCache} holds the
  * in-memory mirror of what this class persists.
  */
-import { type DatabaseInfo, type WorkspaceMetadata } from './core/DatabaseManager.js';
+import { type DatabaseInfo, type WorkspaceMetadata } from './stores/DatabaseManager.js';
 import { ModelRegistry } from './ModelRegistry.js';
-import { LoadStrategy } from './types/index.js';
+import { LoadStrategy } from './transaction/types/index.js';
+import type { RuntimeContext } from './RuntimeContext.js';
+import type { AppliedChange } from './transaction/plugin.js';
 import type { BootstrapFetcher, BootstrapData } from './sync/BootstrapFetcher.js';
 import { InMemoryObjectStore } from './adapters/inMemoryStorage.js';
+import type { SyncDeltaAction } from './transaction/wire/delta.js';
+import type { OnStaleMode } from './transaction/coordination/schema.js';
+import type { BootstrapType } from './transaction/types/index.js';
 /** Generic record type for model data */
 type ModelData = Record<string, unknown>;
 /** Persisted mutation in a transaction */
@@ -20,7 +25,7 @@ interface PersistedMutation {
     timestamp: string;
     writeOptions?: {
         readAt?: number | null;
-        onStale?: 'reject' | 'overwrite' | 'notify' | null;
+        onStale?: OnStaleMode | null;
     };
 }
 /** Persisted transaction for offline/retry support.
@@ -45,20 +50,7 @@ interface PersistedTransaction {
     };
     [key: string]: unknown;
 }
-/**
- * How a session establishes its baseline state at startup.
- *
- * 'full' — Fetch a complete snapshot from the server, clear the local store,
- *   load the snapshot, and adopt its `lastSyncId`.
- *
- * 'partial' — Fetch only the deltas since the stored `lastSyncId` and apply
- *   them on top of the existing local data.
- *
- * 'local' — Skip the server entirely: hydrate the {@link InstanceCache} from the
- *   local store, connect the WebSocket with the stored `lastSyncId`, and
- *   receive deltas from there onward. Used when offline with valid local data.
- */
-export type BootstrapType = 'full' | 'partial' | 'local';
+export type { BootstrapType };
 export interface BootstrapRequirements {
     type: BootstrapType;
     modelsToLoad: string[];
@@ -78,12 +70,7 @@ export interface BootstrapResult {
      * was disconnected — without this, DELETE deltas persist to IDB but
      * ghost entities linger in the pool until a full reload.
      */
-    deltaResults?: {
-        action: 'add' | 'update' | 'remove' | 'archive' | 'verify';
-        modelName: string;
-        modelId: string;
-        data?: ModelData | null;
-    }[];
+    deltaResults?: AppliedChange[];
 }
 export declare class Database {
     private databaseManager;
@@ -125,12 +112,14 @@ export declare class Database {
      *   new Database(registry, bootstrap, { inMemory: true })
      */
     private readonly inMemory;
+    private readonly runtime;
     /** In-memory stores used when inMemory=true. Keyed by model name. */
     private inMemoryStores;
     /** In-memory workspace metadata when inMemory=true. */
     private inMemoryMetadata;
     constructor(modelRegistry: ModelRegistry, bootstrapHelper: BootstrapFetcher, options?: {
         inMemory?: boolean;
+        runtime?: RuntimeContext;
     });
     /**
      * Get store for a model, or `undefined` if no store exists.
@@ -191,7 +180,7 @@ export declare class Database {
      *
      * Update deltas carry only the changed fields, so they are merged onto the
      * existing record rather than replacing it. That preserves fields the delta
-     * omits (such as deckId or title), and an explicit null is kept as a value,
+     * omits (such as reportId or title), and an explicit null is kept as a value,
      * clearing that field.
      */
     processDelta(delta: {
@@ -202,16 +191,11 @@ export declare class Database {
          * but the switch returns a no-op verify if one slips through (e.g.
          * replayed from the bootstrap queue) rather than crashing the engine.
          */
-        actionType: 'I' | 'U' | 'D' | 'A' | 'V' | 'C' | 'G' | 'S' | 'M';
+        actionType: SyncDeltaAction;
         modelName: string;
         modelId: string;
         data: ModelData | null;
-    }): Promise<{
-        action: 'add' | 'update' | 'remove' | 'archive' | 'verify';
-        modelName: string;
-        modelId: string;
-        data?: ModelData | null;
-    }>;
+    }): Promise<AppliedChange>;
     /**
      * Apply many deltas to the local store in as few IndexedDB transactions as
      * possible. Deltas are grouped by store, and each store's writes commit in a
@@ -235,7 +219,7 @@ export declare class Database {
          * shouldn't reach batch processing, but the switch inside returns
          * no-op verify for them if one slips through.
          */
-        actionType: 'I' | 'U' | 'D' | 'A' | 'V' | 'C' | 'G' | 'S' | 'M';
+        actionType: SyncDeltaAction;
         modelName: string;
         modelId: string;
         data: ModelData | null;
@@ -250,13 +234,7 @@ export declare class Database {
          */
         transactionId?: string;
     }[]): Promise<{
-        results: {
-            action: 'add' | 'update' | 'remove' | 'archive' | 'verify';
-            modelName: string;
-            modelId: string;
-            data?: ModelData | null;
-            transactionId?: string;
-        }[];
+        results: AppliedChange[];
         /**
          * Highest syncId whose IDB store transaction actually committed in this
          * batch. The runtime delta cursor (WS `lastSyncId`, server-side
@@ -319,10 +297,6 @@ export declare class Database {
         database: DatabaseInfo | null;
         stores: {
             totalStores: number;
-            storeTypes: {
-                full: number;
-                partial: number;
-            };
             readiness: {
                 ready: number;
                 notReady: number;
@@ -347,4 +321,3 @@ export declare class Database {
         includeWriteJournal?: boolean;
     }): Promise<void>;
 }
-export {};