@abloatai/ablo 0.35.0 → 0.37.0

package/dist/testing/helpers/syncEngineHarness.d.ts

@@ -1,54 +0,0 @@
-/**
- * An integration-test harness that assembles a full sync engine stack —
- * the model registry, object pool, transaction queue, and related parts —
- * from the real implementations, but with mocked input and output. It lets
- * tests exercise the engine end to end without a network or a live server.
- */
-import { ModelRegistry } from '../../ModelRegistry.js';
-import { InstanceCache } from '../../InstanceCache.js';
-import { MockMutationExecutor } from '../mocks/MockMutationExecutor.js';
-import { MockNetworkMonitor } from '../mocks/MockNetworkMonitor.js';
-import { MockWebSocket } from '../mocks/MockWebSocket.js';
-import type { TestContextResult } from '../mocks/MockSyncContext.js';
-export interface TestHarness {
-    /** A model registry pre-loaded with the test models. */
-    registry: ModelRegistry;
-    /** A real object pool with the test foreign-key indexes configured. */
-    pool: InstanceCache;
-    /** A mock WebSocket for injecting deltas into the engine. */
-    webSocket: MockWebSocket;
-    /** The dependency-injection context holding every mock. */
-    context: TestContextResult;
-    /** Shorthand for the mock mutation executor on {@link context}. */
-    mutationExecutor: MockMutationExecutor;
-    /** Shorthand for the mock network monitor on {@link context}. */
-    networkMonitor: MockNetworkMonitor;
-    /** Tears down the harness and resets its counters. */
-    cleanup: () => void;
-}
-export interface TestHarnessOptions {
-    /** Start offline (default: false) */
-    startOffline?: boolean;
-    /** Initial sync ID for mutation executor */
-    initialSyncId?: number;
-    /** InstanceCache config overrides */
-    poolConfig?: {
-        maxSize?: number;
-        maxAge?: number;
-        gcInterval?: number;
-        useWeakRefs?: boolean;
-    };
-}
-/**
- * Builds a full test harness: real sync engine components wired to mocked
- * input and output. Reset the counters and tear everything down through the
- * returned {@link TestHarness.cleanup}.
- *
- * Usage:
- * ```ts
- * let harness: TestHarness;
- * beforeEach(() => { harness = createTestHarness(); });
- * afterEach(() => { harness.cleanup(); });
- * ```
- */
-export declare function createTestHarness(options?: TestHarnessOptions): TestHarness;

package/dist/testing/helpers/syncEngineHarness.js

@@ -1,73 +0,0 @@
-/**
- * An integration-test harness that assembles a full sync engine stack —
- * the model registry, object pool, transaction queue, and related parts —
- * from the real implementations, but with mocked input and output. It lets
- * tests exercise the engine end to end without a network or a live server.
- */
-import { ModelRegistry, setActiveRegistry } from '../../ModelRegistry.js';
-import { InstanceCache } from '../../InstanceCache.js';
-import { MockMutationExecutor } from '../mocks/MockMutationExecutor.js';
-import { MockNetworkMonitor } from '../mocks/MockNetworkMonitor.js';
-import { MockWebSocket } from '../mocks/MockWebSocket.js';
-import { createTestContext } from '../mocks/MockSyncContext.js';
-import { registerTestModels, createTestConfig, resetFixtureCounter, } from '../fixtures/models.js';
-import { resetDeltaCounter } from '../fixtures/deltas.js';
-/**
- * Builds a full test harness: real sync engine components wired to mocked
- * input and output. Reset the counters and tear everything down through the
- * returned {@link TestHarness.cleanup}.
- *
- * Usage:
- * ```ts
- * let harness: TestHarness;
- * beforeEach(() => { harness = createTestHarness(); });
- * afterEach(() => { harness.cleanup(); });
- * ```
- */
-export function createTestHarness(options = {}) {
-    // Reset counters for deterministic tests
-    resetFixtureCounter();
-    resetDeltaCounter();
-    // Create and register test models
-    const registry = new ModelRegistry();
-    setActiveRegistry(registry);
-    registerTestModels(registry);
-    // Create the dependency-injection context with the test config
-    const testConfig = createTestConfig();
-    const context = createTestContext({
-        config: testConfig,
-        startOffline: options.startOffline,
-        mutationExecutorOptions: {
-            initialSyncId: options.initialSyncId ?? 1,
-        },
-    });
-    // Create the real object pool with foreign-key indexes
-    const pool = new InstanceCache({
-        maxSize: options.poolConfig?.maxSize ?? 10000,
-        maxAge: options.poolConfig?.maxAge ?? 5 * 60 * 1000,
-        gcInterval: options.poolConfig?.gcInterval ?? 0, // Disable auto-GC in tests
-        useWeakRefs: options.poolConfig?.useWeakRefs ?? false, // Disable WeakRefs for predictable tests
-    }, registry);
-    // Register foreign-key indexes for the test models
-    pool.registerForeignKey('Task', 'projectId');
-    pool.registerForeignKey('Comment', 'taskId');
-    pool.registerForeignKey('Slide', 'deckId');
-    pool.registerForeignKey('SlideLayer', 'slideId');
-    // Create mock WebSocket
-    const webSocket = new MockWebSocket();
-    return {
-        registry,
-        pool,
-        webSocket,
-        context,
-        mutationExecutor: context.mocks.mutationExecutor,
-        networkMonitor: context.mocks.networkMonitor,
-        cleanup: () => {
-            pool.clear();
-            webSocket.reset();
-            context.cleanup();
-            resetFixtureCounter();
-            resetDeltaCounter();
-        },
-    };
-}

package/dist/testing/helpers/wait.d.ts

@@ -1,30 +0,0 @@
-/**
- * Asynchronous helpers for tests whose assertions depend on timing — for
- * flushing pending work, polling for a condition, or waiting a fixed delay.
- */
-/**
- * Flushes all pending microtasks, such as resolved promises and
- * `queueMicrotask` callbacks. Useful for testing work the transaction queue
- * batches on the microtask queue.
- */
-export declare function flushMicrotasks(): Promise<void>;
-/**
- * Polls `condition` until it returns true, checking every `interval`
- * milliseconds. Rejects with an {@link AbloConnectionError} if `maxWait`
- * milliseconds pass first.
- */
-export declare function waitFor(condition: () => boolean, options?: {
-    maxWait?: number;
-    interval?: number;
-}): Promise<void>;
-/**
- * Waits for the given number of milliseconds. Use sparingly; prefer
- * {@link flushMicrotasks} or {@link waitFor}, which don't tie tests to
- * wall-clock time.
- */
-export declare function delay(ms: number): Promise<void>;
-/**
- * Flushes pending microtasks, then runs `fn` and returns its result. Handy
- * for asserting state after the transaction queue processes a batch.
- */
-export declare function afterMicrotasks<T>(fn: () => T): Promise<T>;

package/dist/testing/helpers/wait.js

@@ -1,49 +0,0 @@
-/**
- * Asynchronous helpers for tests whose assertions depend on timing — for
- * flushing pending work, polling for a condition, or waiting a fixed delay.
- */
-import { AbloConnectionError } from '../../transaction/errors.js';
-/**
- * Flushes all pending microtasks, such as resolved promises and
- * `queueMicrotask` callbacks. Useful for testing work the transaction queue
- * batches on the microtask queue.
- */
-export function flushMicrotasks() {
-    return new Promise((resolve) => {
-        // Use setTimeout(0) to yield to the microtask queue
-        setTimeout(resolve, 0);
-    });
-}
-/**
- * Polls `condition` until it returns true, checking every `interval`
- * milliseconds. Rejects with an {@link AbloConnectionError} if `maxWait`
- * milliseconds pass first.
- */
-export async function waitFor(condition, options = {}) {
-    const { maxWait = 5000, interval = 10 } = options;
-    const start = Date.now();
-    while (!condition()) {
-        if (Date.now() - start > maxWait) {
-            throw new AbloConnectionError(`waitFor timed out after ${maxWait}ms`, {
-                code: 'wait_for_timeout',
-            });
-        }
-        await new Promise((resolve) => setTimeout(resolve, interval));
-    }
-}
-/**
- * Waits for the given number of milliseconds. Use sparingly; prefer
- * {@link flushMicrotasks} or {@link waitFor}, which don't tie tests to
- * wall-clock time.
- */
-export function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Flushes pending microtasks, then runs `fn` and returns its result. Handy
- * for asserting state after the transaction queue processes a batch.
- */
-export async function afterMicrotasks(fn) {
-    await flushMicrotasks();
-    return fn();
-}

package/dist/testing/index.d.ts

@@ -1,23 +0,0 @@
-/**
- * @abloatai/ablo/testing — Public test utilities for SDK consumers.
- *
- * Provides mock implementations, fixture factories, and test harnesses
- * for writing integration tests against the sync engine.
- */
-export { MockMutationExecutor } from './mocks/MockMutationExecutor.js';
-export type { CapturedMutation, MockMutationExecutorOptions } from './mocks/MockMutationExecutor.js';
-export { MockNetworkMonitor } from './mocks/MockNetworkMonitor.js';
-export { MockWebSocket } from './mocks/MockWebSocket.js';
-export type { MockDelta, MockBootstrapHint } from './mocks/MockWebSocket.js';
-export { fakeDatabase } from './mocks/FakeDatabase.js';
-export type { FakeDatabaseOverrides } from './mocks/FakeDatabase.js';
-export { createTestContext, } from './mocks/MockSyncContext.js';
-export type { TestContextOptions, TestContextResult } from './mocks/MockSyncContext.js';
-export { TestProject, TestTask, TestComment, TestSlideDeck, TestSlide, TestSlideLayer, TEST_MODEL_PRIORITIES, registerTestModels, createTestConfig, resetFixtureCounter, createProjectFixture, createTaskFixture, createCommentFixture, createSlideDeckFixture, createSlideFixture, createSlideLayerFixture, } from './fixtures/models.js';
-export { createDelta, createInsertDelta, createUpdateDelta, createDeleteDelta, createArchiveDelta, createUnarchiveDelta, createCoveringDelta, createGroupAddedDelta, createLegacyGroupChangeDelta, createGroupRemovedDelta, createDeltaBatch, createConfirmationDelta, resetDeltaCounter, } from './fixtures/deltas.js';
-export { createFullBootstrapResponse, createPartialBootstrapResponse, createTestBootstrapResponse, } from './fixtures/bootstrap.js';
-export type { BootstrapModelData, BootstrapResponse } from './fixtures/bootstrap.js';
-export { createTestHarness, } from './helpers/syncEngineHarness.js';
-export type { TestHarness, TestHarnessOptions } from './helpers/syncEngineHarness.js';
-export { flushMicrotasks, waitFor, delay, afterMicrotasks, } from './helpers/wait.js';
-export { createReactTestWrapper, renderSyncHook, MockSyncStore, createMockSyncStore, type TestWrapperOptions, } from './helpers/reactWrapper.js';

package/dist/testing/index.js

@@ -1,33 +0,0 @@
-/**
- * @abloatai/ablo/testing — Public test utilities for SDK consumers.
- *
- * Provides mock implementations, fixture factories, and test harnesses
- * for writing integration tests against the sync engine.
- */
-// ─────────────────────────────────────────────
-// Mocks
-// ─────────────────────────────────────────────
-export { MockMutationExecutor } from './mocks/MockMutationExecutor.js';
-export { MockNetworkMonitor } from './mocks/MockNetworkMonitor.js';
-export { MockWebSocket } from './mocks/MockWebSocket.js';
-export { fakeDatabase } from './mocks/FakeDatabase.js';
-export { createTestContext, } from './mocks/MockSyncContext.js';
-// ─────────────────────────────────────────────
-// Fixtures: Models
-// ─────────────────────────────────────────────
-export { TestProject, TestTask, TestComment, TestSlideDeck, TestSlide, TestSlideLayer, TEST_MODEL_PRIORITIES, registerTestModels, createTestConfig, resetFixtureCounter, createProjectFixture, createTaskFixture, createCommentFixture, createSlideDeckFixture, createSlideFixture, createSlideLayerFixture, } from './fixtures/models.js';
-// ─────────────────────────────────────────────
-// Fixtures: Deltas
-// ─────────────────────────────────────────────
-export { createDelta, createInsertDelta, createUpdateDelta, createDeleteDelta, createArchiveDelta, createUnarchiveDelta, createCoveringDelta, createGroupAddedDelta, createLegacyGroupChangeDelta, createGroupRemovedDelta, createDeltaBatch, createConfirmationDelta, resetDeltaCounter, } from './fixtures/deltas.js';
-// ─────────────────────────────────────────────
-// Fixtures: Bootstrap
-// ─────────────────────────────────────────────
-export { createFullBootstrapResponse, createPartialBootstrapResponse, createTestBootstrapResponse, } from './fixtures/bootstrap.js';
-// ─────────────────────────────────────────────
-// Helpers
-// ─────────────────────────────────────────────
-export { createTestHarness, } from './helpers/syncEngineHarness.js';
-export { flushMicrotasks, waitFor, delay, afterMicrotasks, } from './helpers/wait.js';
-// React testing helpers
-export { createReactTestWrapper, renderSyncHook, MockSyncStore, createMockSyncStore, } from './helpers/reactWrapper.js';

package/dist/testing/mocks/FakeDatabase.d.ts

@@ -1,18 +0,0 @@
-import type { Database } from '../../Database.js';
-/**
- * Overrides for {@link fakeDatabase}. Everything is typechecked against
- * Database's public surface except `getPersistedTransactions`, which widens to
- * `unknown[]`: persisted rows are untrusted input (the DurableWriteStore port
- * documents this), and restore-path tests feed deliberately corrupt rows.
- */
-export type FakeDatabaseOverrides = Omit<Partial<Database>, 'getPersistedTransactions'> & {
-    getPersistedTransactions?: () => Promise<unknown[]>;
-};
-/**
- * A Database double that implements ONLY the given members — no real
- * prototype behind it, so a code path reaching for anything else fails
- * loudly instead of silently running real IndexedDB logic. The bare `as`
- * is a single narrowing assert (Database is assignable to the overrides
- * type), so every override stays typechecked against the real surface.
- */
-export declare function fakeDatabase(overrides: FakeDatabaseOverrides): Database;

package/dist/testing/mocks/FakeDatabase.js

@@ -1,10 +0,0 @@
-/**
- * A Database double that implements ONLY the given members — no real
- * prototype behind it, so a code path reaching for anything else fails
- * loudly instead of silently running real IndexedDB logic. The bare `as`
- * is a single narrowing assert (Database is assignable to the overrides
- * type), so every override stays typechecked against the real surface.
- */
-export function fakeDatabase(overrides) {
-    return overrides;
-}

package/dist/testing/mocks/MockMutationExecutor.d.ts

@@ -1,87 +0,0 @@
-/**
- * A test double for {@link MutationExecutor} that records every call instead
- * of writing to a database. Use it to assert what a component tried to commit
- * and to script the response — success, failure, or added latency — without a
- * live backend. Each successful commit hands back an incrementing `lastSyncId`,
- * so tests can drive the delta-confirmation flow that depends on those ids.
- */
-import type { MutationExecutor, MutationOperation, MutationOptions, CommitResult } from '../../interfaces/index.js';
-import type { StaleNotification } from '../../transaction/coordination/schema.js';
-export interface CapturedMutation {
-    method: string;
-    modelName?: string;
-    modelId?: string;
-    input?: Record<string, unknown>;
-    operations?: MutationOperation[];
-    options?: MutationOptions;
-    clientMutationId?: string;
-    timestamp: number;
-}
-export interface MockMutationExecutorOptions {
-    /** The first `lastSyncId` to return. It increments by one after each commit. */
-    initialSyncId?: number;
-    /** Whether mutations succeed by default. Set this false to make every call reject. */
-    shouldSucceed?: boolean;
-    /** A delay applied before each call resolves, in milliseconds, to simulate a slow network. */
-    latencyMs?: number;
-    /** The settlement status each commit reports. Defaults to `'confirmed'`. */
-    status?: CommitResult['status'];
-    /** Optional server-issued source/WAL correlation returned with queued receipts. */
-    correlationId?: string;
-    /** Optional stale-context notifications returned with each commit. */
-    notifications?: StaleNotification[];
-    /** Optional zero-row target ids returned with each commit. */
-    missingIds?: string[];
-}
-export declare class MockMutationExecutor implements MutationExecutor {
-    /** Every captured call, in the order it was made. Assertions read from this list. */
-    readonly calls: CapturedMutation[];
-    /** Current sync ID — incremented on each successful commit */
-    private _syncId;
-    private _shouldSucceed;
-    private _latencyMs;
-    private _status;
-    private _correlationId;
-    private _notifications;
-    private _missingIds;
-    /** Per-method failure overrides: method name → error */
-    private _failureOverrides;
-    /** Per-method response overrides */
-    private _responseOverrides;
-    constructor(options?: MockMutationExecutorOptions);
-    /** Returns the current sync id without advancing it. */
-    get currentSyncId(): number;
-    /** Sets the next sync id the executor will return. */
-    setSyncId(id: number): void;
-    /** Sets the settlement status returned by subsequent commit calls. */
-    setStatus(status: CommitResult['status']): void;
-    /** Sets the opaque source/WAL correlation returned by subsequent commits. */
-    setCorrelationId(correlationId: string | undefined): void;
-    /** Sets stale-context notifications returned by subsequent commit calls. */
-    setNotifications(notifications: StaleNotification[] | undefined): void;
-    /** Sets zero-row target ids returned by subsequent commit calls. */
-    setMissingIds(missingIds: string[] | undefined): void;
-    /** Makes every mutation reject. Pass an error to control what is thrown. */
-    failAll(error?: Error): void;
-    /** Restores the default where mutations succeed, clearing any failure overrides. */
-    succeedAll(): void;
-    /** Makes a single named method reject. Pass an error to control what is thrown. */
-    failMethod(method: string, error?: Error): void;
-    /** Removes the failure override for one method. */
-    clearFailure(method: string): void;
-    /** Returns the captured calls for one method, in order. */
-    getCallsByMethod(method: string): CapturedMutation[];
-    /** The most recent captured call, or undefined if none have been made. */
-    get lastCall(): CapturedMutation | undefined;
-    /** Clears captured calls and restores the initial options. */
-    reset(options?: MockMutationExecutorOptions): void;
-    commit(operations: MutationOperation[], options?: MutationOptions): Promise<CommitResult>;
-    executeCreate(modelName: string, id: string, input: Record<string, unknown>, clientMutationId?: string): Promise<void>;
-    executeUpdate(modelName: string, modelId: string, data: Record<string, unknown>, clientMutationId?: string): Promise<CommitResult | null>;
-    executeDelete(modelName: string, modelId: string, clientMutationId?: string): Promise<void>;
-    executeArchive(modelName: string, modelId: string, clientMutationId?: string): Promise<void>;
-    executeUnarchive(modelName: string, modelId: string, clientMutationId?: string): Promise<void>;
-    private _capture;
-    private _maybeDelay;
-    private _maybeThrow;
-}

package/dist/testing/mocks/MockMutationExecutor.js

@@ -1,186 +0,0 @@
-/**
- * A test double for {@link MutationExecutor} that records every call instead
- * of writing to a database. Use it to assert what a component tried to commit
- * and to script the response — success, failure, or added latency — without a
- * live backend. Each successful commit hands back an incrementing `lastSyncId`,
- * so tests can drive the delta-confirmation flow that depends on those ids.
- */
-import { AbloError } from '../../transaction/errors.js';
-export class MockMutationExecutor {
-    /** Every captured call, in the order it was made. Assertions read from this list. */
-    calls = [];
-    /** Current sync ID — incremented on each successful commit */
-    _syncId;
-    _shouldSucceed;
-    _latencyMs;
-    _status;
-    _correlationId;
-    _notifications;
-    _missingIds;
-    /** Per-method failure overrides: method name → error */
-    _failureOverrides = new Map();
-    /** Per-method response overrides */
-    _responseOverrides = new Map();
-    constructor(options = {}) {
-        this._syncId = options.initialSyncId ?? 1;
-        this._shouldSucceed = options.shouldSucceed ?? true;
-        this._latencyMs = options.latencyMs ?? 0;
-        this._status = options.status ?? 'confirmed';
-        this._correlationId = options.correlationId;
-        this._notifications = options.notifications;
-        this._missingIds = options.missingIds;
-    }
-    // ─────────────────────────────────────────────
-    // Test control API
-    // ─────────────────────────────────────────────
-    /** Returns the current sync id without advancing it. */
-    get currentSyncId() {
-        return this._syncId;
-    }
-    /** Sets the next sync id the executor will return. */
-    setSyncId(id) {
-        this._syncId = id;
-    }
-    /** Sets the settlement status returned by subsequent commit calls. */
-    setStatus(status) {
-        this._status = status;
-    }
-    /** Sets the opaque source/WAL correlation returned by subsequent commits. */
-    setCorrelationId(correlationId) {
-        this._correlationId = correlationId;
-    }
-    /** Sets stale-context notifications returned by subsequent commit calls. */
-    setNotifications(notifications) {
-        this._notifications = notifications;
-    }
-    /** Sets zero-row target ids returned by subsequent commit calls. */
-    setMissingIds(missingIds) {
-        this._missingIds = missingIds;
-    }
-    /** Makes every mutation reject. Pass an error to control what is thrown. */
-    failAll(error) {
-        this._shouldSucceed = false;
-        if (error) {
-            this._failureOverrides.set('*', error);
-        }
-    }
-    /** Restores the default where mutations succeed, clearing any failure overrides. */
-    succeedAll() {
-        this._shouldSucceed = true;
-        this._failureOverrides.clear();
-    }
-    /** Makes a single named method reject. Pass an error to control what is thrown. */
-    failMethod(method, error) {
-        this._failureOverrides.set(method, error ?? new Error(`Mock ${method} failed`));
-    }
-    /** Removes the failure override for one method. */
-    clearFailure(method) {
-        this._failureOverrides.delete(method);
-    }
-    /** Returns the captured calls for one method, in order. */
-    getCallsByMethod(method) {
-        return this.calls.filter((c) => c.method === method);
-    }
-    /** The most recent captured call, or undefined if none have been made. */
-    get lastCall() {
-        return this.calls[this.calls.length - 1];
-    }
-    /** Clears captured calls and restores the initial options. */
-    reset(options) {
-        this.calls.length = 0;
-        this._syncId = options?.initialSyncId ?? 1;
-        this._shouldSucceed = options?.shouldSucceed ?? true;
-        this._latencyMs = options?.latencyMs ?? 0;
-        this._status = options?.status ?? 'confirmed';
-        this._correlationId = options?.correlationId;
-        this._notifications = options?.notifications;
-        this._missingIds = options?.missingIds;
-        this._failureOverrides.clear();
-        this._responseOverrides.clear();
-    }
-    // ─────────────────────────────────────────────
-    // MutationExecutor interface implementation
-    // ─────────────────────────────────────────────
-    async commit(operations, options) {
-        this._capture('commit', { operations, options });
-        await this._maybeDelay();
-        this._maybeThrow('commit');
-        const syncId = this._syncId++;
-        if (this._status === 'queued') {
-            if (!this._correlationId) {
-                throw new Error('Mock queued commits require a correlationId');
-            }
-            return {
-                lastSyncId: 0,
-                status: 'queued',
-                correlationId: this._correlationId,
-                ...(this._notifications ? { notifications: this._notifications } : {}),
-                ...(this._missingIds ? { missingIds: this._missingIds } : {}),
-            };
-        }
-        return {
-            lastSyncId: syncId,
-            status: 'confirmed',
-            ...(this._correlationId ? { correlationId: this._correlationId } : {}),
-            ...(this._notifications ? { notifications: this._notifications } : {}),
-            ...(this._missingIds ? { missingIds: this._missingIds } : {}),
-        };
-    }
-    async executeCreate(modelName, id, input, clientMutationId) {
-        this._capture('executeCreate', { modelName, modelId: id, input, clientMutationId });
-        await this._maybeDelay();
-        this._maybeThrow('executeCreate');
-    }
-    async executeUpdate(modelName, modelId, data, clientMutationId) {
-        this._capture('executeUpdate', { modelName, modelId, input: data, clientMutationId });
-        await this._maybeDelay();
-        this._maybeThrow('executeUpdate');
-        return { lastSyncId: this._syncId++, status: 'confirmed' };
-    }
-    async executeDelete(modelName, modelId, clientMutationId) {
-        this._capture('executeDelete', { modelName, modelId, clientMutationId });
-        await this._maybeDelay();
-        this._maybeThrow('executeDelete');
-    }
-    async executeArchive(modelName, modelId, clientMutationId) {
-        this._capture('executeArchive', { modelName, modelId, clientMutationId });
-        await this._maybeDelay();
-        this._maybeThrow('executeArchive');
-    }
-    async executeUnarchive(modelName, modelId, clientMutationId) {
-        this._capture('executeUnarchive', { modelName, modelId, clientMutationId });
-        await this._maybeDelay();
-        this._maybeThrow('executeUnarchive');
-    }
-    // ─────────────────────────────────────────────
-    // Internal helpers
-    // ─────────────────────────────────────────────
-    _capture(method, data) {
-        this.calls.push({
-            method,
-            timestamp: Date.now(),
-            ...data,
-        });
-    }
-    async _maybeDelay() {
-        if (this._latencyMs > 0) {
-            await new Promise((r) => setTimeout(r, this._latencyMs));
-        }
-    }
-    _maybeThrow(method) {
-        // Check specific method override first
-        const methodError = this._failureOverrides.get(method);
-        if (methodError)
-            throw methodError;
-        // Check global override
-        const globalError = this._failureOverrides.get('*');
-        if (globalError)
-            throw globalError;
-        // Check global flag
-        if (!this._shouldSucceed) {
-            throw new AbloError(`Mock mutation failed: ${method}`, {
-                code: 'mock_mutation_failed',
-            });
-        }
-    }
-}

package/dist/testing/mocks/MockNetworkMonitor.d.ts

@@ -1,20 +0,0 @@
-/**
- * A test double for {@link OnlineStatusProvider} that lets tests flip the
- * connection between online and offline on demand. Alongside its own state, it
- * updates the global `navigator.onLine` flag so code that reads the browser
- * value directly sees the same status.
- */
-import type { OnlineStatusProvider } from '../../interfaces/index.js';
-export declare class MockNetworkMonitor implements OnlineStatusProvider {
-    private _online;
-    constructor(initialOnline?: boolean);
-    isOnline(): boolean;
-    /** Marks the connection online and sets `navigator.onLine` to true. */
-    goOnline(): void;
-    /** Marks the connection offline and sets `navigator.onLine` to false. */
-    goOffline(): void;
-    /** Flips between online and offline, returning the new online state. */
-    toggle(): boolean;
-    /** Returns the monitor to its online starting state. */
-    reset(): void;
-}

package/dist/testing/mocks/MockNetworkMonitor.js

@@ -1,46 +0,0 @@
-/**
- * A test double for {@link OnlineStatusProvider} that lets tests flip the
- * connection between online and offline on demand. Alongside its own state, it
- * updates the global `navigator.onLine` flag so code that reads the browser
- * value directly sees the same status.
- */
-export class MockNetworkMonitor {
-    _online;
-    constructor(initialOnline = true) {
-        this._online = initialOnline;
-    }
-    isOnline() {
-        return this._online;
-    }
-    /** Marks the connection online and sets `navigator.onLine` to true. */
-    goOnline() {
-        this._online = true;
-        // Also update navigator.onLine for code that reads it directly
-        Object.defineProperty(navigator, 'onLine', {
-            writable: true,
-            value: true,
-        });
-    }
-    /** Marks the connection offline and sets `navigator.onLine` to false. */
-    goOffline() {
-        this._online = false;
-        Object.defineProperty(navigator, 'onLine', {
-            writable: true,
-            value: false,
-        });
-    }
-    /** Flips between online and offline, returning the new online state. */
-    toggle() {
-        if (this._online) {
-            this.goOffline();
-        }
-        else {
-            this.goOnline();
-        }
-        return this._online;
-    }
-    /** Returns the monitor to its online starting state. */
-    reset() {
-        this.goOnline();
-    }
-}