@gonvex/client 0.1.31 → 0.3.0

package/dist/cache-coordinator.js

@@ -1,109 +0,0 @@
-export class CacheCoordinatorModel {
-    tabs = new Map();
-    activeTabId;
-    status = "no_owner";
-    registerTab(tab) {
-        this.tabs.set(tab.id, normalizeTab(tab));
-        this.electIfNeeded();
-    }
-    updateTab(tabId, patch) {
-        const current = this.tabs.get(tabId);
-        if (!current) {
-            return;
-        }
-        this.tabs.set(tabId, normalizeTab({ ...current, ...patch }));
-        if (tabId === this.activeTabId && !this.canOwn(this.tabs.get(tabId))) {
-            this.activeTabId = undefined;
-            this.status = "owner_lost";
-        }
-        this.electIfNeeded();
-    }
-    closeTab(tabId) {
-        this.tabs.delete(tabId);
-        if (this.activeTabId === tabId) {
-            this.activeTabId = undefined;
-            this.status = "owner_lost";
-        }
-        this.electIfNeeded();
-    }
-    disableUnsafeFallback() {
-        this.activeTabId = undefined;
-        this.status = "unsafe_fallback_disabled";
-    }
-    verifyActiveOwnerIntegrity() {
-        if (!this.activeTabId || this.status === "unsafe_fallback_disabled") {
-            return;
-        }
-        this.updateTab(this.activeTabId, { integrityVerified: true });
-    }
-    markActiveOwnerStorageReady() {
-        if (!this.activeTabId || this.status === "unsafe_fallback_disabled") {
-            return;
-        }
-        this.updateTab(this.activeTabId, { storageReady: true });
-    }
-    markActiveOwnerReady() {
-        if (!this.activeTabId || this.status === "unsafe_fallback_disabled") {
-            return;
-        }
-        this.updateTab(this.activeTabId, {
-            dedicatedWorkerReady: true,
-            storageReady: true,
-            integrityVerified: true,
-        });
-        this.electIfNeeded();
-    }
-    routeRequest() {
-        if (this.status === "unsafe_fallback_disabled") {
-            return { route: "server", reason: "unsafe-fallback-disabled" };
-        }
-        if (!this.activeTabId) {
-            return { route: "server", reason: "no-active-owner" };
-        }
-        const active = this.tabs.get(this.activeTabId);
-        if (!this.canOwn(active) || !this.ownerReady(active) || this.status !== "active_owner_ready") {
-            return { route: "server", reason: "owner-not-ready" };
-        }
-        return { route: "active-worker", activeTabId: this.activeTabId };
-    }
-    snapshot() {
-        return {
-            status: this.status,
-            activeTabId: this.activeTabId,
-            tabs: [...this.tabs.values()].map((tab) => ({ ...tab })),
-        };
-    }
-    electIfNeeded() {
-        if (this.status === "unsafe_fallback_disabled") {
-            return;
-        }
-        if (this.activeTabId && this.canOwn(this.tabs.get(this.activeTabId))) {
-            this.status = this.ownerReady(this.tabs.get(this.activeTabId)) ? "active_owner_ready" : "electing";
-            return;
-        }
-        const nextOwner = [...this.tabs.values()]
-            .filter((tab) => this.canOwn(tab))
-            .sort((left, right) => left.id.localeCompare(right.id))[0];
-        if (!nextOwner) {
-            this.activeTabId = undefined;
-            this.status = this.tabs.size > 0 ? "electing" : "no_owner";
-            return;
-        }
-        this.activeTabId = nextOwner.id;
-        this.status = this.ownerReady(nextOwner) ? "active_owner_ready" : "electing";
-    }
-    canOwn(tab) {
-        return Boolean(tab?.hasLivenessLock);
-    }
-    ownerReady(tab) {
-        return Boolean(tab?.dedicatedWorkerReady && tab.storageReady && tab.integrityVerified);
-    }
-}
-function normalizeTab(tab) {
-    return {
-        ...tab,
-        storageReady: tab.storageReady ?? false,
-        integrityVerified: tab.integrityVerified ?? false,
-    };
-}
-//# sourceMappingURL=cache-coordinator.js.map

package/dist/cache-coordinator.js.map

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

package/dist/cache.d.ts

@@ -1,74 +0,0 @@
-export type ShapeSyncStatus = "not_started" | "syncing" | "ready" | "stale" | "too_large" | "error";
-export type CacheDBHealth = "healthy" | "initializing" | "unavailable" | "corrupt";
-export type CacheRoutingSource = "local" | "server";
-export type CacheRoutingReason = "local-ready" | "query-has-no-local-plan" | "query-has-no-shape" | "shape-missing" | "shape-does-not-cover-query" | "shape-not-ready" | "shape-too-large" | "query-row-limit-unsafe" | "shape-auth-scope-mismatch" | "shape-epoch-mismatch" | "db-not-healthy" | "db-owner-unsafe";
-export type CacheShapeVisibilityScope = "project" | "tenant" | "user" | "auth";
-export type CacheShapeDefinition = {
-    id: string;
-    tables: string[];
-    visibilityScope: CacheShapeVisibilityScope;
-    maxRows?: number;
-    maxBytes?: number;
-    schemaVersion: string;
-    permissionVersion: string;
-};
-export type CacheShapeState = {
-    id: string;
-    projectId: string;
-    tenantId: string;
-    userId: string;
-    authScope: string;
-    status: ShapeSyncStatus;
-    schemaVersion: string;
-    permissionVersion: string;
-    checkpoint?: string;
-    rowCount?: number;
-    maxRows?: number;
-};
-export type CacheQueryPlan = {
-    queryKey: string;
-    queryPath?: string;
-    projectId: string;
-    tenantId: string;
-    userId: string;
-    authScope: string;
-    requiredShapeId?: string;
-    hasLocalPlan: boolean;
-    schemaVersion: string;
-    permissionVersion: string;
-    coveredByShapeIds?: string[];
-    estimatedRows?: number;
-    limit?: number;
-};
-export type CacheEnvironment = {
-    dbHealth: CacheDBHealth;
-    singleWriter: boolean;
-    shapes: Record<string, CacheShapeState | undefined>;
-    definitions?: Record<string, CacheShapeDefinition | undefined>;
-};
-export type CacheRoutingDecision = {
-    source: CacheRoutingSource;
-    reason: CacheRoutingReason;
-    shape?: CacheShapeState;
-};
-export type CacheFailureAction = {
-    action: "reset-and-server-fallback";
-    reason: "cache-corruption-suspected";
-} | {
-    action: "server-fallback";
-    reason: "ordinary-failure";
-};
-export declare function chooseQuerySource(query: CacheQueryPlan, environment: CacheEnvironment): CacheRoutingDecision;
-export declare function defineVisibleShape(definition: CacheShapeDefinition): CacheShapeDefinition;
-export declare function cacheKey(parts: {
-    projectId: string;
-    tenantId: string;
-    userId: string;
-    authScope: string;
-    queryPath: string;
-    argsHash: string;
-    schemaVersion: string;
-    permissionVersion: string;
-}): string;
-export declare function shouldResetLocalCache(error: unknown): boolean;
-export declare function cacheFailureAction(error: unknown): CacheFailureAction;

package/dist/cache.js

@@ -1,120 +0,0 @@
-export function chooseQuerySource(query, environment) {
-    if (!query.hasLocalPlan) {
-        return server("query-has-no-local-plan");
-    }
-    if (!query.requiredShapeId) {
-        return server("query-has-no-shape");
-    }
-    if (environment.dbHealth !== "healthy") {
-        return server("db-not-healthy");
-    }
-    if (!environment.singleWriter) {
-        return server("db-owner-unsafe");
-    }
-    const shape = environment.shapes[query.requiredShapeId];
-    if (!shape) {
-        return server("shape-missing");
-    }
-    const definition = environment.definitions?.[query.requiredShapeId];
-    if (!shapeCoversQuery(query, definition)) {
-        return server("shape-does-not-cover-query", shape);
-    }
-    if (shape.status === "too_large") {
-        return server("shape-too-large", shape);
-    }
-    if (shape.status !== "ready") {
-        return server("shape-not-ready", shape);
-    }
-    if (!sameScope(query, shape)) {
-        return server("shape-auth-scope-mismatch", shape);
-    }
-    if (shape.schemaVersion !== query.schemaVersion || shape.permissionVersion !== query.permissionVersion) {
-        return server("shape-epoch-mismatch", shape);
-    }
-    if (shape.maxRows !== undefined && shape.rowCount !== undefined && shape.rowCount > shape.maxRows) {
-        return server("shape-too-large", shape);
-    }
-    if (!queryLimitIsSafe(query, shape, definition)) {
-        return server("query-row-limit-unsafe", shape);
-    }
-    return { source: "local", reason: "local-ready", shape };
-}
-export function defineVisibleShape(definition) {
-    if (!definition.id.trim()) {
-        throw new Error("cache shape id is required");
-    }
-    if (definition.tables.length === 0 || definition.tables.some((table) => !table.trim())) {
-        throw new Error(`cache shape ${definition.id} must include at least one table`);
-    }
-    if (definition.maxRows !== undefined && definition.maxRows <= 0) {
-        throw new Error(`cache shape ${definition.id} maxRows must be positive`);
-    }
-    if (definition.maxBytes !== undefined && definition.maxBytes <= 0) {
-        throw new Error(`cache shape ${definition.id} maxBytes must be positive`);
-    }
-    return {
-        ...definition,
-        tables: [...definition.tables],
-    };
-}
-export function cacheKey(parts) {
-    return [
-        "gonvex",
-        parts.projectId,
-        parts.tenantId,
-        parts.userId,
-        parts.authScope,
-        parts.queryPath,
-        parts.argsHash,
-        parts.schemaVersion,
-        parts.permissionVersion,
-    ].map(escapeKeyPart).join(":");
-}
-export function shouldResetLocalCache(error) {
-    if (!(error instanceof Error)) {
-        return false;
-    }
-    const message = error.message.toLowerCase();
-    return message.includes("corrupt")
-        || message.includes("integrity")
-        || message.includes("checkpoint")
-        || message.includes("schema mismatch");
-}
-export function cacheFailureAction(error) {
-    if (shouldResetLocalCache(error)) {
-        return { action: "reset-and-server-fallback", reason: "cache-corruption-suspected" };
-    }
-    return { action: "server-fallback", reason: "ordinary-failure" };
-}
-function sameScope(query, shape) {
-    return shape.projectId === query.projectId
-        && shape.tenantId === query.tenantId
-        && shape.userId === query.userId
-        && shape.authScope === query.authScope;
-}
-function shapeCoversQuery(query, definition) {
-    if (query.coveredByShapeIds) {
-        return query.coveredByShapeIds.includes(query.requiredShapeId ?? "");
-    }
-    return definition !== undefined;
-}
-function queryLimitIsSafe(query, shape, definition) {
-    const maxRows = shape.maxRows ?? definition?.maxRows;
-    if (maxRows === undefined) {
-        return true;
-    }
-    if (query.limit !== undefined) {
-        return query.limit <= maxRows;
-    }
-    if (query.estimatedRows !== undefined) {
-        return query.estimatedRows <= maxRows;
-    }
-    return shape.rowCount === undefined || shape.rowCount <= maxRows;
-}
-function server(reason, shape) {
-    return { source: "server", reason, shape };
-}
-function escapeKeyPart(part) {
-    return encodeURIComponent(part);
-}
-//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/persistent-cache.d.ts

@@ -1,41 +0,0 @@
-import { type CacheDBHealth, type CacheEnvironment, type CacheQueryPlan, type CacheRoutingDecision, type CacheShapeDefinition, type CacheShapeState } from "./cache.js";
-import { CacheCoordinatorModel } from "./cache-coordinator.js";
-import { type BrowserCacheCapabilities } from "./browser-capabilities.js";
-export type ShapeHydrationResult = Omit<CacheShapeState, "status"> & {
-    status?: CacheShapeState["status"];
-};
-export type ShapeHydrator = (definition: CacheShapeDefinition) => Promise<ShapeHydrationResult>;
-export declare class CacheMetadataStore {
-    private dbHealth;
-    private readonly definitions;
-    private readonly shapes;
-    setDBHealth(health: CacheDBHealth): void;
-    getDBHealth(): CacheDBHealth;
-    registerShape(definition: CacheShapeDefinition): void;
-    markShapeSyncing(definition: CacheShapeDefinition, scope: Pick<CacheShapeState, "projectId" | "tenantId" | "userId" | "authScope">): void;
-    updateShape(shape: CacheShapeState): void;
-    markAllShapesStale(): void;
-    environment(singleWriter: boolean): CacheEnvironment;
-    shapeStates(): {
-        id: string;
-        projectId: string;
-        tenantId: string;
-        userId: string;
-        authScope: string;
-        status: import("./cache.js").ShapeSyncStatus;
-        schemaVersion: string;
-        permissionVersion: string;
-        checkpoint?: string;
-        rowCount?: number;
-        maxRows?: number;
-    }[];
-}
-export declare class BrowserPersistentCache {
-    readonly metadata: CacheMetadataStore;
-    readonly coordinator: CacheCoordinatorModel;
-    constructor(metadata?: CacheMetadataStore, coordinator?: CacheCoordinatorModel);
-    decideQuerySource(query: CacheQueryPlan): CacheRoutingDecision;
-    disableIfUnsupported(capabilities?: BrowserCacheCapabilities): BrowserCacheCapabilities;
-    hydrateShapeInBackground(definition: CacheShapeDefinition, scope: Pick<CacheShapeState, "projectId" | "tenantId" | "userId" | "authScope">, hydrate: ShapeHydrator): void;
-    quarantineScope(nextScope: Pick<CacheShapeState, "projectId" | "tenantId" | "userId" | "authScope">): void;
-}

package/dist/persistent-cache.js

@@ -1,103 +0,0 @@
-import { chooseQuerySource, } from "./cache.js";
-import { CacheCoordinatorModel } from "./cache-coordinator.js";
-import { detectBrowserCacheCapabilities } from "./browser-capabilities.js";
-export class CacheMetadataStore {
-    dbHealth = "initializing";
-    definitions = new Map();
-    shapes = new Map();
-    setDBHealth(health) {
-        this.dbHealth = health;
-    }
-    getDBHealth() {
-        return this.dbHealth;
-    }
-    registerShape(definition) {
-        this.definitions.set(definition.id, definition);
-    }
-    markShapeSyncing(definition, scope) {
-        this.registerShape(definition);
-        this.shapes.set(definition.id, {
-            id: definition.id,
-            ...scope,
-            status: "syncing",
-            schemaVersion: definition.schemaVersion,
-            permissionVersion: definition.permissionVersion,
-            maxRows: definition.maxRows,
-        });
-    }
-    updateShape(shape) {
-        this.shapes.set(shape.id, { ...shape });
-    }
-    markAllShapesStale() {
-        for (const [id, shape] of this.shapes) {
-            this.shapes.set(id, { ...shape, status: "stale" });
-        }
-    }
-    environment(singleWriter) {
-        return {
-            dbHealth: this.dbHealth,
-            singleWriter,
-            shapes: Object.fromEntries(this.shapes),
-            definitions: Object.fromEntries(this.definitions),
-        };
-    }
-    shapeStates() {
-        return [...this.shapes.values()].map((shape) => ({ ...shape }));
-    }
-}
-export class BrowserPersistentCache {
-    metadata;
-    coordinator;
-    constructor(metadata = new CacheMetadataStore(), coordinator = new CacheCoordinatorModel()) {
-        this.metadata = metadata;
-        this.coordinator = coordinator;
-    }
-    decideQuerySource(query) {
-        const route = this.coordinator.routeRequest();
-        return chooseQuerySource(query, this.metadata.environment(route.route === "active-worker"));
-    }
-    disableIfUnsupported(capabilities = detectBrowserCacheCapabilities()) {
-        if (!capabilities.supported) {
-            this.coordinator.disableUnsafeFallback();
-        }
-        return capabilities;
-    }
-    hydrateShapeInBackground(definition, scope, hydrate) {
-        this.metadata.markShapeSyncing(definition, scope);
-        void hydrate(definition).then((shape) => {
-            this.metadata.updateShape({
-                ...shape,
-                id: definition.id,
-                projectId: shape.projectId,
-                tenantId: shape.tenantId,
-                userId: shape.userId,
-                authScope: shape.authScope,
-                status: shape.status ?? "ready",
-                schemaVersion: definition.schemaVersion,
-                permissionVersion: definition.permissionVersion,
-                maxRows: definition.maxRows,
-            });
-        }).catch(() => {
-            this.metadata.updateShape({
-                id: definition.id,
-                ...scope,
-                status: "error",
-                schemaVersion: definition.schemaVersion,
-                permissionVersion: definition.permissionVersion,
-                maxRows: definition.maxRows,
-            });
-        });
-    }
-    quarantineScope(nextScope) {
-        for (const shape of this.metadata.shapeStates()) {
-            const scopeMatches = shape.projectId === nextScope.projectId
-                && shape.tenantId === nextScope.tenantId
-                && shape.userId === nextScope.userId
-                && shape.authScope === nextScope.authScope;
-            if (!scopeMatches) {
-                this.metadata.updateShape({ ...shape, status: "stale" });
-            }
-        }
-    }
-}
-//# sourceMappingURL=persistent-cache.js.map

package/dist/persistent-cache.js.map

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

package/dist/query-cache.d.ts

@@ -1,88 +0,0 @@
-import type { JsonValue } from "@gonvex/protocol";
-export declare const defaultQueryCacheMaxAgeMs: number;
-export declare const defaultQueryCacheMaxEntryBytes: number;
-export declare const defaultQueryCacheMaxEntriesPerScope = 100;
-export declare const defaultQueryCacheMaxBytesPerScope: number;
-export declare const defaultQueryCacheMaxBytes: number;
-export declare const defaultQueryCacheReadTimeoutMs = 250;
-export type QueryCacheLookup = {
-    result: JsonValue;
-    revision: string;
-    writtenAt: number;
-    ageMs: number;
-};
-export type QueryCacheWrite = {
-    scope: string;
-    path: string;
-    args: JsonValue;
-    result: JsonValue;
-    revision: string;
-    maxAgeMs: number;
-};
-export type QueryCacheWriteOutcome = "written" | "older" | "oversize" | "disabled" | "error";
-export type QueryCacheStatus = {
-    enabled: boolean;
-    readsEnabled: boolean;
-    writesEnabled: boolean;
-    reason?: string;
-};
-export type QueryCacheStore = {
-    read(scope: string, path: string, args: JsonValue, maxAgeMs?: number): Promise<QueryCacheLookup | undefined>;
-    write(value: QueryCacheWrite): Promise<QueryCacheWriteOutcome>;
-    delete(scope: string, path: string, args: JsonValue): Promise<void>;
-    clear(scope?: string): Promise<void>;
-    status(): QueryCacheStatus;
-    close(): void;
-};
-export type QueryCacheOptions = {
-    enabled?: boolean;
-    /**
-     * Maximum time to wait for a persisted warm result before subscribing
-     * without its revision. Defaults to 250ms. This is intentionally longer
-     * than a typical IndexedDB read so startup contention does not turn a warm
-     * reload into a full server payload.
-     */
-    readTimeoutMs?: number;
-    maxAgeMs?: number;
-    maxEntryBytes?: number;
-    maxEntriesPerScope?: number;
-    maxBytesPerScope?: number;
-    maxBytes?: number;
-    store?: QueryCacheStore;
-    databaseName?: string;
-    indexedDB?: IDBFactory;
-    IDBKeyRange?: typeof IDBKeyRange;
-};
-export declare class DexieQueryCacheStore implements QueryCacheStore {
-    private readonly databaseName;
-    private readonly maxAgeMs;
-    private readonly maxEntryBytes;
-    private readonly maxEntriesPerScope;
-    private readonly maxBytesPerScope;
-    private readonly maxBytes;
-    private readonly indexedDB?;
-    private readonly keyRange?;
-    private readonly memory;
-    private databasePromise;
-    private database;
-    private readsEnabled;
-    private writesEnabled;
-    private disabledReason;
-    private cleanupScheduled;
-    constructor(options?: QueryCacheOptions);
-    read(scope: string, path: string, args: JsonValue, maxAgeMs?: number): Promise<QueryCacheLookup | undefined>;
-    write(value: QueryCacheWrite): Promise<QueryCacheWriteOutcome>;
-    delete(scope: string, path: string, args: JsonValue): Promise<void>;
-    clear(scope?: string): Promise<void>;
-    status(): QueryCacheStatus;
-    close(): void;
-    private open;
-    private createDatabase;
-    private putRecord;
-    private deleteByHash;
-    private touchMemory;
-    private scheduleCleanup;
-    private cleanup;
-    private disable;
-}
-export declare function createQueryCacheStore(options: QueryCacheOptions | false | undefined): QueryCacheStore | undefined;