@cuboapp/crdt 1.0.27 → 2.0.0

package/dist/client/index.d.ts

@@ -0,0 +1,77 @@
+import { CuboCrdtKey, CuboCrdtRowId, CuboCrdtSubscriptionStatus } from '../types';
+import { CuboCrdtClientDoc, CuboCrdtClientDocOrigin, CuboCrdtClientList, CuboCrdtClientOptions, CuboCrdtClientRow, CuboCrdtClientStore, CuboCrdtClientUseOptions } from './types';
+export * from './types';
+export declare class CuboCrdtClient<M> {
+    private opts;
+    store: CuboCrdtClientStore<M>;
+    docs: import("vue").ShallowReactive<Map<string, CuboCrdtClientDoc>>;
+    private listeners;
+    private subscriptions;
+    private onReconnect;
+    private onDisconnect;
+    private eventQueue;
+    constructor(opts: CuboCrdtClientOptions<M>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Переподписка на все активные подписки после реконнекта.
+     *
+     * При обрыве сокета бэкенд удаляет клиента вместе со всеми его подписками
+     * (removeClient -> cleanSubscribe), а после реконнекта сокету выдаётся новый id.
+     * Локальные слушатели (this.listeners) и yjs-документы при этом сохраняются,
+     * поэтому достаточно заново отправить SUBSCRIBE по реестру — заново
+     * навешивать слушатели не нужно.
+     */
+    private resubscribeAll;
+    private resolvePaginated;
+    /**
+     * Подписка на КОЛИЧЕСТВО строк под фильтрами.
+     *
+     * Возвращает реактивное число и живёт как обычная подписка: сервер пересчитывает
+     * count на любую мутацию сущности и присылает только totals — строки не грузятся,
+     * CRDT-документы не создаются.
+     *
+     * Зачем: счётчику (оранжевая точка инбокса, число задач в «Неразобранном») нужно одно
+     * число, а обычная подписка ради него держала бы весь набор строк — память на сервере,
+     * трафик на каждое их изменение и документы, которые никто не читает.
+     *
+     *   const { count, unsubscribe } = crdt.useCount('events', { filters: { recipient: 5 } })
+     */
+    useCount<K extends Extract<keyof M, string>>(entity: K | string, opts?: CuboCrdtClientUseOptions): {
+        count: import("vue").ComputedRef<number>;
+        subscribe_id: string;
+        storeKey: string;
+        subscribe: (filters?: any) => void;
+        upgrade: (filters?: any) => void;
+        unsubscribe: (clear?: boolean) => void;
+        subscribed: () => import("vue").ComputedRef<boolean>;
+        loading: () => import("vue").ComputedRef<boolean>;
+        ready: () => import("vue").ComputedRef<boolean>;
+        status: () => import("vue").ComputedRef<CuboCrdtSubscriptionStatus>;
+        error: () => import("vue").ComputedRef<unknown>;
+        totals: () => import("vue").ComputedRef<import("..").CuboCrdtListTotals>;
+        revision: () => import("vue").ComputedRef<number>;
+        rows: () => import("vue").ComputedRef<CuboCrdtKey<K, M>[]>;
+        rowsById: () => import("vue").ComputedRef<Record<string, CuboCrdtKey<K, M>>>;
+    };
+    useComputedList<K extends Extract<keyof M, string>>(entity: K): import("vue").ComputedRef<M[K][]>;
+    useComputedRow<K extends Extract<keyof M, string>>(entity: K, entity_id: CuboCrdtRowId): import("vue").ComputedRef<M[K]>;
+    useList<K extends Extract<keyof M, string>, T = CuboCrdtKey<K, M>>(entity: K | string, opts?: CuboCrdtClientUseOptions): CuboCrdtClientList<T>;
+    useDoc<K extends Extract<keyof M, string>>(entity: K, id: number): CuboCrdtClientDoc;
+    useRow<K extends Extract<keyof M, string>, T = CuboCrdtKey<K, M>>(entity: K | string, id: number, opts?: CuboCrdtClientUseOptions): CuboCrdtClientRow<T>;
+    update<K extends Extract<keyof M, string>>(entity: K, entity_id: CuboCrdtRowId, dto: K extends Extract<keyof M, string> ? Partial<M[K]> : object, opts?: CuboCrdtClientDocOrigin): void;
+    upgrade(subscribe_id: string, filters?: Record<string, any>): void;
+    private applyDocumentRows;
+    private attachDocument;
+    private detachDocument;
+    private applyRowJson;
+    private onDocumentCreate;
+    private onDocumentUpdate;
+    private onDocumentDelete;
+    private onIncomingUpdate;
+    private onListSync;
+    private onAwarenessUpdate;
+    private get ws();
+    private get debug();
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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

package/dist/client/queue/index.d.ts

@@ -0,0 +1,60 @@
+type QueueErrorMode = 'continue' | 'stop';
+export interface AsyncQueueOptions {
+    /**
+     * Что делать, если задача упала:
+     * - continue: логируем/пробрасываем через onError и идём дальше
+     * - stop: останавливаем очередь (следующие задачи не стартуют)
+     */
+    errorMode?: QueueErrorMode;
+    /**
+     * Хук на ошибки задач (если errorMode=continue — обязательно пригодится)
+     */
+    onError?: (err: unknown) => void;
+    /**
+     * Максимальный размер очереди (для защиты от утечек, опционально)
+     */
+    maxSize?: number;
+}
+export declare class AsyncSerialQueue {
+    private running;
+    private stopped;
+    private readonly errorMode;
+    private readonly onError?;
+    private readonly maxSize?;
+    private tasks;
+    private drainWaiters;
+    constructor(opts?: AsyncQueueOptions);
+    get size(): number;
+    get isRunning(): boolean;
+    get isStopped(): boolean;
+    /**
+     * Добавляет задачу в очередь.
+     * Возвращает промис, который резолвится когда задача реально выполнена.
+     */
+    enqueue(fn: () => void | Promise<void>): Promise<void>;
+    /**
+     * Ждёт, пока очередь станет пустой и ничего не выполняется.
+     */
+    drain(): Promise<void>;
+    /**
+     * Очищает очередь (не прерывая текущую выполняемую задачу).
+     * Невыполненные задачи получат reject.
+     */
+    clear(reason?: unknown): void;
+    /**
+     * Останавливает очередь: новые enqueue будут отвергнуты.
+     * Можно опционально очистить pending.
+     */
+    stop(opts?: {
+        clear?: boolean;
+        reason?: unknown;
+    }): void;
+    /**
+     * Разрешает снова enqueue (не запускает автоматически).
+     */
+    resume(): void;
+    private pump;
+    private notifyDrainedIfNeeded;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/client/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/queue/index.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,UAAU,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAA;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAQ;IAEjC,OAAO,CAAC,KAAK,CAIN;IAEP,OAAO,CAAC,YAAY,CAAwB;gBAEhC,IAAI,GAAE,iBAAsB;IAMxC,IAAI,IAAI,WAEP;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,SAAS,YAEZ;IAED;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;IACH,KAAK,CAAC,MAAM,GAAE,OAAoC,GAAG,IAAI;IAOzD;;;OAGG;IACH,IAAI,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAK5D;;OAEG;IACH,MAAM,IAAI,IAAI;YAKA,IAAI;IA4BlB,OAAO,CAAC,qBAAqB;CAO9B"}

package/dist/client/types/document.d.ts

@@ -0,0 +1,23 @@
+import { Awareness } from 'y-protocols/awareness';
+import { Doc } from 'yjs';
+import { CuboCrdtClientUseOptions } from '..';
+import { CuboCrdtExposeStrategy } from '../../types';
+import { CuboCrdtClientBaseOptions } from './utils';
+export type CuboCrdtClientDoc = {
+    doc: Doc;
+    subscribes: Set<string>;
+    awareness?: Awareness;
+    awarenessSubscribes: Set<string>;
+};
+export type CuboCrdtClientDocOrigin = {
+    store?: boolean;
+    react?: boolean;
+    keys?: string[];
+    expose?: CuboCrdtExposeStrategy;
+    subscribe_id?: string;
+};
+export type CuboCrdtClientDocUpdateOptions = {
+    subscribe_id: string;
+    storeKey: string;
+} & Pick<CuboCrdtClientBaseOptions, 'onBeforeCreate' | 'onAfterCreate' | 'onBeforeUpdate' | 'onAfterUpdate' | 'onBeforeDelete' | 'onAfterDelete'> & Pick<CuboCrdtClientUseOptions, 'awareness'>;
+//# sourceMappingURL=document.d.ts.map

package/dist/client/types/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/client/types/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAEzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,IAAI,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,GAAG,CAAA;IACR,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAEpC,KAAK,CAAC,EAAE,OAAO,CAAA;IAGf,KAAK,CAAC,EAAE,OAAO,CAAA;IAGf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAGf,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAG/B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAC5F,yBAAyB,EACzB,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAC7G,GACC,IAAI,CAAC,wBAAwB,EAAE,WAAW,CAAC,CAAA"}

package/dist/client/types/index.d.ts

@@ -0,0 +1,60 @@
+import { type WsClient } from '@cuboapp/ws';
+import { ComputedRef } from 'vue';
+import { CuboCrdtAction, CuboCrdtListSyncData, CuboCrdtListTotals, CuboCrdtSubscriptionStatus } from '../../types';
+import { CuboCrdtClientBaseOptions } from './utils';
+export * from './document';
+export * from './store';
+export * from './utils';
+export type CuboCrdtClientOptions<M> = {
+    ws: WsClient;
+    entities: Extract<keyof M, string>[];
+    debug?: boolean;
+};
+export type CuboCrdtClientUseOptions = CuboCrdtClientBaseOptions & {
+    storeKey?: string;
+    filters?: Record<string, any>;
+    awareness?: boolean;
+    paginated?: boolean;
+    /**
+     * Подписка только на КОЛИЧЕСТВО строк под фильтрами: строки не грузятся и документы
+     * не создаются, приезжает лишь totals. Для счётчиков и индикаторов — см. useCount.
+     */
+    counted?: boolean;
+};
+export type CuboCrdtClientSubscribeEvent = {
+    action: CuboCrdtAction;
+    entity: string;
+    entity_id?: number;
+    subscribe_id?: string;
+    data?: number[] | CuboCrdtListSyncData;
+};
+export type CuboCrdtClientList<T> = {
+    subscribe_id: string;
+    storeKey: string;
+    subscribe: (filters?: any) => void;
+    upgrade: (filters?: any) => void;
+    unsubscribe: (clear?: boolean) => void;
+    subscribed: () => ComputedRef<boolean>;
+    loading: () => ComputedRef<boolean>;
+    ready: () => ComputedRef<boolean>;
+    status: () => ComputedRef<CuboCrdtSubscriptionStatus>;
+    error: () => ComputedRef<unknown>;
+    totals: () => ComputedRef<CuboCrdtListTotals>;
+    revision: () => ComputedRef<number>;
+    rows: () => ComputedRef<T[]>;
+    rowsById: () => ComputedRef<Record<string, T>>;
+};
+export type CuboCrdtClientRow<T> = {
+    subscribe_id: string;
+    storeKey: string;
+    subscribe: () => void;
+    upgrade: (filters?: any) => void;
+    unsubscribe: (clear?: boolean) => void;
+    subscribed: () => ComputedRef<boolean>;
+    loading: () => ComputedRef<boolean>;
+    ready: () => ComputedRef<boolean>;
+    status: () => ComputedRef<CuboCrdtSubscriptionStatus>;
+    error: () => ComputedRef<unknown>;
+    row: () => ComputedRef<T>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/client/types/index.d.ts.map

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

package/dist/client/types/store.d.ts

@@ -0,0 +1,17 @@
+import { Reactive } from 'vue';
+import { CuboCrdtKey, CuboCrdtListTotals, CuboCrdtSubscriptionStatus } from '../../types';
+export type CuboCrdtClientStoreItem<T> = {
+    state: Reactive<{
+        rows: T[];
+        subscribed: boolean;
+        loading: boolean;
+        status: CuboCrdtSubscriptionStatus;
+        error?: unknown;
+        totals: CuboCrdtListTotals;
+        revision: number;
+    }>;
+};
+export type CuboCrdtClientStore<M> = Partial<{
+    [K in string]: CuboCrdtClientStoreItem<CuboCrdtKey<K, M>>;
+}>;
+//# sourceMappingURL=store.d.ts.map

package/dist/client/types/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/client/types/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAEzF,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;IACvC,KAAK,EAAE,QAAQ,CAAC;QACd,IAAI,EAAE,CAAC,EAAE,CAAA;QACT,UAAU,EAAE,OAAO,CAAA;QACnB,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,EAAE,0BAA0B,CAAA;QAClC,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,MAAM,EAAE,kBAAkB,CAAA;QAC1B,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;CACH,CAAA;AACD,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,OAAO,CAAC;KAC1C,CAAC,IAAI,MAAM,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC1D,CAAC,CAAA"}

package/dist/client/types/utils.d.ts

@@ -0,0 +1,13 @@
+import { Doc } from 'yjs';
+import { CuboCrdtClientSubscribeEvent } from '.';
+import { CuboCrdtClientDocUpdateOptions } from './document';
+export type CuboCrdtClientBaseOptions = {
+    autoSubscribe?: boolean;
+    onBeforeCreate?: (update: Uint8Array, ctx: CuboCrdtClientSubscribeEvent, opts: CuboCrdtClientDocUpdateOptions) => Promise<boolean> | boolean;
+    onAfterCreate?: (doc: Doc, update: Uint8Array, ctx: CuboCrdtClientSubscribeEvent, opts: CuboCrdtClientDocUpdateOptions) => Promise<void> | void;
+    onBeforeUpdate?: (doc: Doc, update: Uint8Array, ctx: CuboCrdtClientSubscribeEvent, opts: CuboCrdtClientDocUpdateOptions) => Promise<boolean> | boolean;
+    onAfterUpdate?: (doc: Doc, update: Uint8Array, ctx: CuboCrdtClientSubscribeEvent, opts: CuboCrdtClientDocUpdateOptions) => Promise<void> | void;
+    onBeforeDelete?: (doc: Doc, ctx: CuboCrdtClientSubscribeEvent, opts: CuboCrdtClientDocUpdateOptions) => Promise<boolean> | boolean;
+    onAfterDelete?: (doc: Doc, ctx: CuboCrdtClientSubscribeEvent, opts: CuboCrdtClientDocUpdateOptions) => Promise<void> | void;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/client/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/client/types/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AACzB,OAAO,EAAE,4BAA4B,EAAE,MAAM,GAAG,CAAA;AAChD,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,4BAA4B,EACjC,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IAC/B,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,4BAA4B,EACjC,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAEzB,cAAc,CAAC,EAAE,CACf,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,4BAA4B,EACjC,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IAC/B,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,4BAA4B,EACjC,IAAI,EAAE,8BAA8B,KACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAEzB,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,4BAA4B,EAAE,IAAI,EAAE,8BAA8B,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IAClI,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,4BAA4B,EAAE,IAAI,EAAE,8BAA8B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC5H,CAAA"}

package/dist/constants/index.d.ts

@@ -0,0 +1,7 @@
+export declare const CUBO_CRDT_EVENT: {
+    EVENT: string;
+    SUBSCRIBE: string;
+    UPGRADE: string;
+    UNSUBSCRIBE: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;CAK3B,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './client';
+export * from './server';
+export * from './types';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/dist/server/document/index.d.ts

@@ -0,0 +1,50 @@
+import { Awareness } from 'y-protocols/awareness';
+import { CuboCrdtServerDocumentOptions, CuboCrdtServerDocumentOrigin } from '../types';
+export declare class CuboCrdtServerDocument {
+    opts: CuboCrdtServerDocumentOptions;
+    private ydoc;
+    private persistedState;
+    private observedState;
+    private storeQueue?;
+    private pendingStore?;
+    private storeTimeout?;
+    awareness: Awareness;
+    awarenessBySubscribe: Map<string, Set<number>>;
+    constructor(opts: CuboCrdtServerDocumentOptions);
+    enableAwareness(): void;
+    get name(): string;
+    get stateAsUpdate(): Uint8Array<ArrayBufferLike>;
+    applyUpdate(update: Uint8Array, origin?: CuboCrdtServerDocumentOrigin): void;
+    getMap(): import("yjs").Map<unknown>;
+    getXmlFragment(name?: string): import("yjs").XmlFragment;
+    getJson(): {
+        [x: string]: any;
+    };
+    getPersistedState(): any;
+    setPersistedState(row: object): void;
+    write(dto: object, origin?: CuboCrdtServerDocumentOrigin): void;
+    get id(): string;
+    destroy(): void;
+    /**
+     * Немедленно передаёт trailing-пакет в очередь и ждёт все уже принятые
+     * сохранения документа. Используется перед вытеснением Y.Doc из серверного
+     * кэша, чтобы refresh последнего клиента не потерял его update.
+     */
+    flushStoreQueue(): Promise<void>;
+    /** Есть ли принятое клиентское изменение в debounce или очереди записи. */
+    hasPendingStore(): boolean;
+    store(body: object, origin: CuboCrdtServerDocumentOrigin, row?: {
+        [x: string]: any;
+    }): Promise<void>;
+    /**
+     * Схлопывает только соседние изменения одного origin и одного набора
+     * leaf-путей. Смена пользователя или поля немедленно фиксирует предыдущий
+     * пакет, сохраняя фактический порядок collaborative-обновлений.
+     */
+    debounceStore(body: object, origin: CuboCrdtServerDocumentOrigin): Promise<void>;
+    /** Перезапускает trailing debounce для текущего однородного пакета. */
+    private schedulePendingStore;
+    /** Передаёт накопленный пакет в общую последовательную очередь записи. */
+    private flushPendingStore;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/server/document/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/document/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAyB,MAAM,uBAAuB,CAAA;AAExE,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAE7B,MAAM,UAAU,CAAA;AAKjB,qBAAa,sBAAsB;IAYd,IAAI,EAAE,6BAA6B;IAXtD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,YAAY,CAAC,CAAoC;IACzD,OAAO,CAAC,YAAY,CAAC,CAA+B;IAC7C,SAAS,EAAE,SAAS,CAAA;IACpB,oBAAoB,2BAAiC;gBAIzC,IAAI,EAAE,6BAA6B;IA2C/C,eAAe;IA6BtB,IAAW,IAAI,WAEd;IAED,IAAW,aAAa,gCAEvB;IAED,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,4BAA4B;IAIrE,MAAM;IAIN,cAAc,CAAC,IAAI,SAAK;IAIxB,OAAO;;;IAIP,iBAAiB;IAIjB,iBAAiB,CAAC,GAAG,EAAE,MAAM;IAI7B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,4BAA4B;IAoBxD,IAAI,EAAE,WAEL;IAED,OAAO;IAKP;;;;OAIG;IACU,eAAe;IAS5B,2EAA2E;IACpE,eAAe;IAIf,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,EAAE,GAAG;;KAAiB;IA8BrF;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B;IAoDvE,uEAAuE;IACvE,OAAO,CAAC,oBAAoB;IAQ5B,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB;CAkB1B"}

package/dist/server/index.d.ts

@@ -0,0 +1,77 @@
+import { WsServerSocket } from '@cuboapp/ws';
+import { CuboCrdtMutation, CuboCrdtRowId } from '../types';
+import { CuboCrdtClientDocOrigin } from '../client';
+import { CuboCrdtServerDocument } from './document';
+import { CuboCrdtServerOptions } from './types';
+export * from './document';
+export * from './types';
+export declare class CuboCrdtServer<M, A = {}, E extends Extract<keyof M, string> = Extract<keyof M, string>> {
+    private options;
+    constructor(options: CuboCrdtServerOptions<M, A, E>);
+    private clients;
+    private queue;
+    private sendTimeouts;
+    private subscribes;
+    private subscribesByClient;
+    private subscribesByEntity;
+    private subscribeRefreshStates;
+    private subscribeGenerations;
+    private documents;
+    private documentEvictions;
+    private subscribesByDocument;
+    private documentsBySubscribe;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    addClient(client: WsServerSocket<{
+        auth?: A;
+    }>): void;
+    removeClient(client: WsServerSocket): void;
+    private get batchMaxSize();
+    private get batchDebounce();
+    private get paginationDebounce();
+    private resolvePaginated;
+    private sendQueueToClient;
+    sendToClient(client_id: string, data: any): void;
+    private linkSubscribeToDocument;
+    private unlinkSubscribeFromDocument;
+    private checkDocumentNeedRemove;
+    private cleanSubscribe;
+    getDocument(entity: string, entity_id: CuboCrdtRowId): CuboCrdtServerDocument;
+    getSutableSubscribes(entity: string, row: any): string[];
+    private getSubscribeRefreshState;
+    private bumpSubscribeGeneration;
+    private runSubscribeRefresh;
+    private requestSubscribeRefresh;
+    private getSubscribeQueryKeys;
+    private shouldRefreshSubscribe;
+    /**
+     * Уведомляет пагинированные подписки о сохранённой мутации.
+     * Пересчитываются только реально открытые страницы; несколько мутаций
+     * схлопываются debounce-ом в один запрос на подписку.
+     */
+    notifyMutation(entity: E, mutation: CuboCrdtMutation<M[E]>): void;
+    /**
+     * Принудительно инвалидирует все открытые пагинированные окна сущности.
+     * Используется для вычисляемых полей и зависимых сущностей, когда changedKeys
+     * исходной строки недостаточно для определения влияния на запрос.
+     */
+    invalidate(entity: E): void;
+    private getOrCreateDocument;
+    ensureDocument(entity: E, row: any, awareness?: boolean): CuboCrdtServerDocument;
+    private sendDocumentToSubscribe;
+    deleteDocument(entity: E, row: any, origin?: CuboCrdtClientDocOrigin): void;
+    private onDocumentExternalCreate;
+    private onDocumentExternalUpdate;
+    private onAwarenessExternalUpdate;
+    private onDocumentExternalDelete;
+    private checkSubscribeIsSutable;
+    private checkRowIsSutable;
+    private pushDocumentAction;
+    private reconcileSubscribe;
+    private upgradeSubscribe;
+    private initSubscribe;
+    private get debug();
+    private get ws();
+    private get entities();
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,EAAwC,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGhG,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAGL,qBAAqB,EAMtB,MAAM,SAAS,CAAA;AAEhB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AAEvB,qBAAa,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACtF,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAE3D,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,YAAY,CAAyB;IAE7C,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,sBAAsB,CAAmD;IACjF,OAAO,CAAC,oBAAoB,CAA4B;IAExD,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,oBAAoB,CAAiC;IAG7D,OAAO,CAAC,oBAAoB,CAAiC;IAEhD,IAAI;IAkKJ,OAAO;IAyBb,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;IAW9C,YAAY,CAAC,MAAM,EAAE,cAAc;IAmB1C,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,aAAa,GAExB;IAED,OAAO,KAAK,kBAAkB,GAE7B;IAED,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IAuBlB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IA+BhD,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,2BAA2B;IAMnC,OAAO,CAAC,uBAAuB;IAyD/B,OAAO,CAAC,cAAc;IAqDf,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa;IAIpD,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG;IAgBpD,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,qBAAqB;IAuC7B,OAAO,CAAC,sBAAsB;IAqC9B;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IASjE;;;;OAIG;IACI,UAAU,CAAC,MAAM,EAAE,CAAC;IAY3B,OAAO,CAAC,mBAAmB;IAuDpB,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,OAAO;IAoC9D,OAAO,CAAC,uBAAuB;IAyBxB,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,uBAAuB;IA6B3E,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;YAgIZ,kBAAkB;YAqHlB,gBAAgB;YAkBhB,aAAa;IAQ3B,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,EAAE,GAEb;IAED,OAAO,KAAK,QAAQ,GAEnB;CACF"}

package/dist/server/types/document.d.ts

@@ -0,0 +1,59 @@
+import { CuboCrdtAction, CuboCrdtExposeStrategy } from '../../types';
+export type CuboCrdtServerDocumentStoreContext = {
+    previousRow: object;
+    row: object;
+};
+export type CuboCrdtServerDocumentStoreWaiter = {
+    resolve: () => void;
+    reject: (reason?: unknown) => void;
+};
+export type CuboCrdtServerDocumentPendingStore = {
+    body: object;
+    changeKey: string;
+    origin: CuboCrdtServerDocumentOrigin;
+    originKey: string;
+    row: object;
+    waiters: CuboCrdtServerDocumentStoreWaiter[];
+};
+export type CuboCrdtServerDocumentOptions = {
+    name: string;
+    onStore?: (body: object, origin: CuboCrdtServerDocumentOrigin, context: CuboCrdtServerDocumentStoreContext) => void | Promise<void>;
+    onUpdate?: (data: Uint8Array, origin?: CuboCrdtServerDocumentOrigin) => void;
+    onAwarenessUpdate?: (data: Uint8Array, origin?: CuboCrdtServerDocumentOrigin) => void;
+    initialState?: object;
+    awareness?: boolean;
+    yjsOptions?: {
+        guid?: string;
+        collectionid?: string;
+        gc?: boolean;
+        gcFilter?: () => true;
+        meta?: any;
+    };
+};
+export type CuboCrdtServerDocumentIncomingAction = {
+    action: CuboCrdtAction;
+    entity: string;
+    entity_id: number;
+    data: number[];
+    origin: CuboCrdtServerDocumentOrigin;
+};
+export type CuboCrdtServerDocumentOrigin = {
+    store?: boolean;
+    react?: boolean;
+    keys?: string[];
+    expose?: CuboCrdtExposeStrategy;
+    subscribe_id?: string;
+    client_id?: string;
+    /**
+     * Снимок серверного контекста автора в момент получения update.
+     *
+     * Он нужен только для отложенного сохранения: исходная подписка и сокет могут
+     * закрыться при refresh раньше, чем сработает debounce. Клиентское значение
+     * этого поля сервер всегда перезаписывает собственными данными.
+     */
+    store_context?: {
+        client_id: string;
+        auth?: unknown;
+    };
+};
+//# sourceMappingURL=document.d.ts.map

package/dist/server/types/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/server/types/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,MAAM,kCAAkC,GAAG;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,4BAA4B,CAAA;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,iCAAiC,EAAE,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,4BAA4B,EACpC,OAAO,EAAE,kCAAkC,KACxC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,4BAA4B,KAAK,IAAI,CAAA;IAC5E,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,4BAA4B,KAAK,IAAI,CAAA;IAGrF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,EAAE,CAAC,EAAE,OAAO,CAAA;QACZ,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;QACrB,IAAI,CAAC,EAAE,GAAG,CAAA;KACX,CAAA;CACF,CAAA;AAED,MAAM,MAAM,oCAAoC,GAAG;IAEjD,MAAM,EAAE,cAAc,CAAA;IAGtB,MAAM,EAAE,MAAM,CAAA;IAGd,SAAS,EAAE,MAAM,CAAA;IAGjB,IAAI,EAAE,MAAM,EAAE,CAAA;IAGd,MAAM,EAAE,4BAA4B,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IAEzC,KAAK,CAAC,EAAE,OAAO,CAAA;IAGf,KAAK,CAAC,EAAE,OAAO,CAAA;IAGf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAGf,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAG/B,YAAY,CAAC,EAAE,MAAM,CAAA;IAGrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAA;CACF,CAAA"}

package/dist/server/types/index.d.ts

@@ -0,0 +1,50 @@
+import { WsServer, WsServerSocket } from '@cuboapp/ws';
+import { CuboCrdtListTotals, CuboCrdtMutation } from '../../types';
+import { CuboCrdtServerDocument } from '../document';
+import { CuboCrdtServerDocumentOrigin } from './document';
+import { CuboCrdtServerSubscribe } from './subscribe';
+export * from './document';
+export * from './subscribe';
+export type CuboCrdtServerFetchResult<T> = {
+    rows: T[];
+    totals?: CuboCrdtListTotals;
+};
+export type CuboCrdtServerOptions<M, A, E extends Extract<keyof M, string>> = {
+    ws: WsServer;
+    entities: E[];
+    debug?: boolean;
+    /**
+     * Параметры батчинга исходящих событий (защита от перегрузки бэка).
+     * - maxSize: при достижении такого размера очереди клиента батч отправляется сразу
+     * - debounce: задержка перед отправкой неполного батча (мс)
+     */
+    batch?: {
+        maxSize?: number;
+        debounce?: number;
+    };
+    pagination?: {
+        debounce?: number;
+    };
+    fetchRows?: (client: WsServerSocket, subscribe: CuboCrdtServerSubscribe) => Promise<M[E][] | CuboCrdtServerFetchResult<M[E]>>;
+    checkRowIsSutable?: (baseState: boolean, ctx: {
+        entity: E;
+        subscribe: CuboCrdtServerSubscribe;
+        row: any;
+    }) => boolean;
+    shouldRefreshSubscribe?: (ctx: {
+        entity: E;
+        subscribe: CuboCrdtServerSubscribe;
+        mutation: CuboCrdtMutation<M[E]>;
+    }) => boolean;
+    storeRow?: <K extends E>(entity: K, entity_id: number, row: M[K], opts: {
+        document: CuboCrdtServerDocument;
+        client: CuboCrdtSocketClient<A>;
+        origin: CuboCrdtServerDocumentOrigin;
+        previousRow: M[K];
+        row: M[K];
+    }) => Promise<void> | void;
+};
+export type CuboCrdtSocketClient<A> = WsServerSocket<{
+    auth?: A;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAErD,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAE3B,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IACzC,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI;IAC5E,EAAE,EAAE,QAAQ,CAAA;IACZ,QAAQ,EAAE,CAAC,EAAE,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,UAAU,CAAC,EAAE;QACX,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,uBAAuB,KAC/B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,uBAAuB,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE,KAAK,OAAO,CAAA;IACrH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE;QAC7B,MAAM,EAAE,CAAC,CAAA;QACT,SAAS,EAAE,uBAAuB,CAAA;QAClC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KACjC,KAAK,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EACrB,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EACT,IAAI,EAAE;QACJ,QAAQ,EAAE,sBAAsB,CAAA;QAChC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,EAAE,4BAA4B,CAAA;QACpC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACjB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KACV,KACE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,cAAc,CAAC;IAAE,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC,CAAA"}

package/dist/server/types/subscribe.d.ts

@@ -0,0 +1,35 @@
+import type { CuboCrdtListTotals, CuboCrdtRowId } from '../../types';
+export type CuboCrdtServerUnsubscribeDto = {
+    subscribe_id: string;
+};
+export type CuboCrdtServerSubscribeDto = {
+    subscribe_id: string;
+    entity: string;
+    filters: {
+        [K in 'id' | string]: any;
+    };
+    awareness?: boolean;
+    paginated?: boolean;
+    /**
+     * Подписка только на КОЛИЧЕСТВО строк под фильтрами.
+     *
+     * Документы при этом не создаются вовсе: клиенту нужно одно число (счётчик,
+     * индикатор непрочитанного), а держать ради него весь набор строк — держать
+     * лишнюю память на сервере и лишний трафик на каждое их изменение.
+     */
+    counted?: boolean;
+};
+export type CuboCrdtServerSubscribe = {
+    id: string;
+    client_id: string;
+    row_ids: CuboCrdtRowId[];
+    totals: CuboCrdtListTotals;
+    revision: number;
+} & Pick<CuboCrdtServerSubscribeDto, 'entity' | 'filters' | 'awareness' | 'paginated' | 'counted'>;
+export type CuboCrdtSubscribeRefreshState = {
+    dirty: boolean;
+    forceSync: boolean;
+    timer?: ReturnType<typeof setTimeout>;
+    running?: Promise<void>;
+};
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/server/types/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../../src/server/types/subscribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AACD,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;SACN,CAAC,IAAI,IAAI,GAAG,MAAM,GAAG,GAAG;KAC1B,CAAA;IACD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,CAAA;AAElG,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA"}

package/dist/server/utils/index.d.ts

@@ -0,0 +1,3 @@
+/** Возвращает стабильный ключ фактически изменённых leaf-путей объекта. */
+export declare const getCrdtStoreChangeKey: (previous: object, current: object) => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/utils/index.ts"],"names":[],"mappings":"AAiCA,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,WAMtE,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,27 @@
+export type CuboCrdtKey<K, M> = K extends Extract<keyof M, string> ? M[K] : any;
+export type CuboCrdtAction = 'create' | 'upsert' | 'update' | 'delete' | 'awareness' | 'sync';
+export type CuboCrdtExposeStrategy = 'all' | 'other' | 'subscribe' | 'client';
+export type CuboCrdtListTotals = Record<string, number>;
+export type CuboCrdtSubscriptionStatus = 'idle' | 'loading' | 'ready' | 'error';
+/**
+ * A row's primary key, as it comes off the wire.
+ *
+ * Deliberately NOT `number`. Rows are keyed by whatever the database column holds — uuid text in
+ * current schemas, integers in older ones — and the CRDT plane only ever compares and indexes ids, it
+ * never does arithmetic on them. Typing this as `number` is what let `Number(id)` / `Number.isFinite`
+ * creep into both ends of the sync, where every uuid failed the test and the row was silently dropped.
+ */
+export type CuboCrdtRowId = string | number;
+export type CuboCrdtListSyncData = {
+    ids: CuboCrdtRowId[];
+    totals: CuboCrdtListTotals;
+    revision: number;
+};
+export type CuboCrdtMutationAction = 'create' | 'update' | 'delete';
+export type CuboCrdtMutation<T = any> = {
+    action: CuboCrdtMutationAction;
+    row: T;
+    previousRow?: T;
+    changedKeys?: string[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AAE/E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;AAE7F,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEvD,MAAM,MAAM,0BAA0B,GAClC,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,CAAA;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA;AAE3C,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,aAAa,EAAE,CAAA;IACpB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEnE,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI;IACtC,MAAM,EAAE,sBAAsB,CAAA;IAC9B,GAAG,EAAE,CAAC,CAAA;IACN,WAAW,CAAC,EAAE,CAAC,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+import { CuboApiEntitiesMap } from '@cuboapp/types';
+import { CuboCrdtClient, CuboCrdtClientOptions, CuboCrdtRowId, CuboCrdtServer, CuboCrdtServerDocumentOrigin, CuboCrdtServerOptions, CuboCrdtServerSubscribe } from '..';
+export declare function createCrdtServer<M extends CuboApiEntitiesMap<M>, A = {}, E extends Extract<keyof M, string> = Extract<keyof M, string>>(opts: CuboCrdtServerOptions<M, A, E>): CuboCrdtServer<M, A, E>;
+export declare function createCrdtClient<M extends CuboApiEntitiesMap<M>>(opts: CuboCrdtClientOptions<M>): CuboCrdtClient<M>;
+export declare function cleanObject<F>(object: F): any;
+export declare function checkRowIsSutable(row: any, filters?: object, customKeys?: Record<string, (key: string, row: any, filters?: any) => boolean>): boolean;
+export declare function checkSubscribeIsSutable(origin: CuboCrdtServerDocumentOrigin, subscribe?: CuboCrdtServerSubscribe): boolean;
+export declare function areCrdtListIdsEqual(left: CuboCrdtRowId[], right: CuboCrdtRowId[]): boolean;
+export declare function areCrdtListTotalsEqual(left: Record<string, number>, right: Record<string, number>): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,IAAI,CAAA;AAEX,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EACrI,IAAI,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,2BAGrC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,qBAE/F;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,GAAG,CAkB7C;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,WAwD/E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,4BAA4B,EAAE,SAAS,CAAC,EAAE,uBAAuB,WAWhH;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAIhF;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAI9B"}

package/package.json

@@ -1,35 +1,40 @@
 {
   "name": "@cuboapp/crdt",
-  "version": "1.0.27",
-  "description": "CRDT for CUBO",
-  "main": "src/index.ts",
-  "repository": {
-    "type": "git",
-    "url": "git@cuboapp.gitlab.yandexcloud.net:cubo/crdt.git"
-  },
-  "author": "CuboSoft",
+  "version": "2.0.0",
+  "description": "Yjs-based CRDT server/client over @cuboapp/ws (vendored — README §5/§13.1).",
   "license": "MIT",
   "type": "module",
-  "publishConfig": {
-    "access": "public"
+  "main": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.ts"
+    }
   },
   "files": [
+    "dist",
     "src"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "echo \"vendored @cuboapp — typecheck via emitted d.ts\"",
+    "test": "echo \"no tests\"",
+    "lint": "echo \"no lint\""
+  },
   "dependencies": {
-    "@cuboapp/types": "^2.0.14",
-    "@cuboapp/utils": "1.0.12",
-    "@cuboapp/ws": "1.0.10",
+    "@cuboapp/types": "^3.0.0",
+    "@cuboapp/utils": "^1.0.12",
+    "@cuboapp/ws": "^2.0.0",
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31"
   },
   "peerDependencies": {
-    "vue": "^3.5.38",
-    "vue-router": "^5.1.0"
+    "vue": "^3.5.0"
   },
   "devDependencies": {
-    "@types/node": "^26.0.0",
-    "@types/ws": "^8.18.1",
-    "typescript": "^6.0.3"
+    "@types/node": "^22.10.5",
+    "typescript": "^5.8.3",
+    "vue": "^3.5.13"
   }
 }

package/src/client/index.ts

@@ -6,7 +6,7 @@ import { applyUpdate, Doc } from 'yjs'
 
 import { CUBO_CRDT_EVENT } from '../constants'
 import { CuboCrdtServerDocumentIncomingAction } from '../server'
-import { CuboCrdtKey, CuboCrdtListSyncData, CuboCrdtSubscriptionStatus } from '../types'
+import { CuboCrdtKey, CuboCrdtListSyncData, CuboCrdtRowId, CuboCrdtSubscriptionStatus } from '../types'
 
 import { AsyncSerialQueue } from './queue'
 import {
@@ -210,9 +210,11 @@ export class CuboCrdtClient<M> {
     return computed(() => (this.store[entity]?.state.rows || []) as M[K][])
   }
 
-  public useComputedRow<K extends Extract<keyof M, string>>(entity: K, entity_id: number) {
+  public useComputedRow<K extends Extract<keyof M, string>>(entity: K, entity_id: CuboCrdtRowId) {
     return computed(() => {
-      return ((this.store[entity]?.state.rows || []) as M[K][]).find((row: any) => row.id === entity_id)
+      // Compared as strings for the same reason the sync path is: the caller may hold a uuid while the
+      // row carries one too, but a legacy numeric id can arrive as either, and `'42' === 42` is false.
+      return ((this.store[entity]?.state.rows || []) as M[K][]).find((row: any) => String(row.id) === String(entity_id))
     })
   }
 
@@ -427,7 +429,7 @@ export class CuboCrdtClient<M> {
 
   public update<K extends Extract<keyof M, string>>(
     entity: K,
-    entity_id: number,
+    entity_id: CuboCrdtRowId,
     dto: K extends Extract<keyof M, string> ? Partial<M[K]> : object,
     opts?: CuboCrdtClientDocOrigin
   ) {
@@ -496,7 +498,7 @@ export class CuboCrdtClient<M> {
       })
   }
 
-  private applyDocumentRows(entity_id: number, document: CuboCrdtClientDoc) {
+  private applyDocumentRows(entity_id: CuboCrdtRowId, document: CuboCrdtClientDoc) {
     for (const subscribe_id of document.subscribes) {
       const subscription = this.subscriptions.get(subscribe_id)
       if (subscription) {
@@ -505,7 +507,7 @@ export class CuboCrdtClient<M> {
     }
   }
 
-  private attachDocument(entity: string, entity_id: number, document: CuboCrdtClientDoc, opts: CuboCrdtClientDocUpdateOptions) {
+  private attachDocument(entity: string, entity_id: CuboCrdtRowId, document: CuboCrdtClientDoc, opts: CuboCrdtClientDocUpdateOptions) {
     document.subscribes.add(opts.subscribe_id)
 
     if (!opts.awareness) {
@@ -547,7 +549,7 @@ export class CuboCrdtClient<M> {
     }
   }
 
-  private detachDocument(entity: string, entity_id: number, subscribe_id: string) {
+  private detachDocument(entity: string, entity_id: CuboCrdtRowId, subscribe_id: string) {
     const key = `${entity}:${entity_id}`
     const document = this.docs.get(key)
     if (!document) {
@@ -571,7 +573,7 @@ export class CuboCrdtClient<M> {
   }
 
   // апсертит строку в реактивное хранилище из текущего состояния yjs-документа
-  private applyRowJson(storeKey: string, entity_id: number, doc: Doc) {
+  private applyRowJson(storeKey: string, entity_id: CuboCrdtRowId, doc: Doc) {
     const json: any = doc.getMap().toJSON()
     const rows = this.store[storeKey]?.state.rows
     if (!rows) {
@@ -775,21 +777,29 @@ export class CuboCrdtClient<M> {
       return
     }
 
-    const ids = data.ids.filter((id) => Number.isFinite(id))
-    const idsSet = new Set(ids)
+    // An id is OPAQUE. This used to be `filter(Number.isFinite)`, from when rows had integer ids —
+    // against uuids every id failed the test, `ids` came back empty, and the splice below then wiped
+    // the whole list. Silently: `totals` is copied from the payload separately, so the subscription
+    // reported the true count while holding no rows, which reads exactly like "the account has none".
+    //
+    // Compared as STRINGS throughout: the wire carries whatever the database column holds — uuid text
+    // today, integers in older data — and `'42' !== 42` would resurrect the same bug for anyone still
+    // on numeric ids.
+    const ids = data.ids.filter((id) => id !== null && id !== undefined && id !== '')
+    const idsSet = new Set(ids.map((id) => String(id)))
 
     for (const row of item.state.rows) {
       const entity_id = (row as any).id
 
-      if (idsSet.has(entity_id)) {
+      if (idsSet.has(String(entity_id))) {
         continue
       }
 
       this.detachDocument(ctx.entity, entity_id, opts.subscribe_id)
     }
 
-    const rowsById = new Map(item.state.rows.map((row: any) => [Number(row.id), row]))
-    const orderedRows = ids.map((id) => rowsById.get(id)).filter((row) => row !== undefined)
+    const rowsById = new Map(item.state.rows.map((row: any) => [String(row.id), row]))
+    const orderedRows = ids.map((id) => rowsById.get(String(id))).filter((row) => row !== undefined)
 
     item.state.rows.splice(0, item.state.rows.length, ...orderedRows)
     item.state.totals = data.totals || {}

package/src/server/index.ts

@@ -3,7 +3,7 @@ import { WsServerSocket } from '@cuboapp/ws'
 import { applyAwarenessUpdate, encodeAwarenessUpdate, removeAwarenessStates } from 'y-protocols/awareness'
 
 import { CUBO_CRDT_EVENT } from '../constants'
-import { CuboCrdtAction, CuboCrdtListSyncData, CuboCrdtMutation } from '../types'
+import { CuboCrdtAction, CuboCrdtListSyncData, CuboCrdtMutation, CuboCrdtRowId } from '../types'
 import { areCrdtListIdsEqual, areCrdtListTotalsEqual, checkRowIsSutable } from '../utils'
 
 import { CuboCrdtClientDocOrigin } from '../client'
@@ -473,7 +473,7 @@ export class CuboCrdtServer<M, A = {}, E extends Extract<keyof M, string> = Extr
     this.subscribesByEntity.get(subscribe.entity as E)?.delete(subscribe_id)
   }
 
-  public getDocument(entity: string, entity_id: number) {
+  public getDocument(entity: string, entity_id: CuboCrdtRowId) {
     return this.documents.get(`${entity}:${entity_id}`)
   }
 
@@ -767,7 +767,7 @@ export class CuboCrdtServer<M, A = {}, E extends Extract<keyof M, string> = Extr
   // Точечная доставка документа ТОЛЬКО инициирующей подписке (init/upgrade/resubscribe).
   // Раньше это шло через ensureDocument -> pushDocumentAction('upsert') с полным сканом
   // всех подписок сущности — на каждый ряд из fetchRows. Теперь — один send на подписку.
-  private sendDocumentToSubscribe(subscribe: CuboCrdtServerSubscribe, document: CuboCrdtServerDocument, entity_id: number) {
+  private sendDocumentToSubscribe(subscribe: CuboCrdtServerSubscribe, document: CuboCrdtServerDocument, entity_id: CuboCrdtRowId) {
     this.linkSubscribeToDocument(subscribe.id, document.name)
 
     this.sendToClient(subscribe.client_id, {
@@ -1054,24 +1054,35 @@ export class CuboCrdtServer<M, A = {}, E extends Extract<keyof M, string> = Extr
       return true
     }
 
-    const rowsById = new Map<number, any>()
-    const nextIds: number[] = []
+    // Take the row's id AS IT IS. This was `Number(row.id)` guarded by `Number.isFinite`, which against
+    // uuid keys evaluated NaN for every row and `continue`d past all of them: `nextIds` came out empty,
+    // no document was ever created or linked, and the subscription synced `ids: []` while `totals` —
+    // assigned separately from the fetch — still reported the true count. So the client was told "19
+    // rows exist" and handed none of them, with nothing logged at either end.
+    //
+    // Keyed by String so a uuid and a legacy integer id both index correctly, and so `'42'` and `42`
+    // cannot become two entries for one row.
+    const rowsById = new Map<string, any>()
+    const nextIds: CuboCrdtRowId[] = []
 
     for (const row of result.rows) {
-      const id = Number((row as any)?.id)
-      if (!Number.isFinite(id) || rowsById.has(id)) {
+      const id = (row as any)?.id
+      if (id === null || id === undefined || id === '' || rowsById.has(String(id))) {
         continue
       }
 
-      rowsById.set(id, row)
+      rowsById.set(String(id), row)
       nextIds.push(id)
     }
 
-    const previousIds = new Set(subscribe.row_ids)
-    const nextIdsSet = new Set(nextIds)
+    // Membership is compared as STRINGS, like the map above: `row_ids` carries whatever was stored on
+    // the previous pass, so a set of raw values would treat `'42'` and `42` as two different rows and
+    // churn documents on every reconcile.
+    const previousIds = new Set(subscribe.row_ids.map((id) => String(id)))
+    const nextIdsSet = new Set(nextIds.map((id) => String(id)))
 
     for (const entity_id of subscribe.row_ids) {
-      if (nextIdsSet.has(entity_id)) {
+      if (nextIdsSet.has(String(entity_id))) {
         continue
       }
 
@@ -1081,12 +1092,12 @@ export class CuboCrdtServer<M, A = {}, E extends Extract<keyof M, string> = Extr
     }
 
     for (const entity_id of nextIds) {
-      const row = rowsById.get(entity_id)
+      const row = rowsById.get(String(entity_id))
       if (!row) {
         continue
       }
 
-      if (previousIds.has(entity_id)) {
+      if (previousIds.has(String(entity_id))) {
         this.linkSubscribeToDocument(subscribe.id, `${subscribe.entity}:${entity_id}`)
         continue
       }

package/src/server/types/subscribe.ts

@@ -1,4 +1,4 @@
-import type { CuboCrdtListTotals } from '../../types'
+import type { CuboCrdtListTotals, CuboCrdtRowId } from '../../types'
 
 export type CuboCrdtServerUnsubscribeDto = {
   subscribe_id: string
@@ -24,7 +24,7 @@ export type CuboCrdtServerSubscribeDto = {
 export type CuboCrdtServerSubscribe = {
   id: string
   client_id: string
-  row_ids: number[]
+  row_ids: CuboCrdtRowId[]
   totals: CuboCrdtListTotals
   revision: number
 } & Pick<CuboCrdtServerSubscribeDto, 'entity' | 'filters' | 'awareness' | 'paginated' | 'counted'>

package/src/types/index.ts

@@ -12,8 +12,18 @@ export type CuboCrdtSubscriptionStatus =
   | 'ready'
   | 'error'
 
+/**
+ * A row's primary key, as it comes off the wire.
+ *
+ * Deliberately NOT `number`. Rows are keyed by whatever the database column holds — uuid text in
+ * current schemas, integers in older ones — and the CRDT plane only ever compares and indexes ids, it
+ * never does arithmetic on them. Typing this as `number` is what let `Number(id)` / `Number.isFinite`
+ * creep into both ends of the sync, where every uuid failed the test and the row was silently dropped.
+ */
+export type CuboCrdtRowId = string | number
+
 export type CuboCrdtListSyncData = {
-  ids: number[]
+  ids: CuboCrdtRowId[]
   totals: CuboCrdtListTotals
   revision: number
 }

package/src/utils/index.ts

@@ -3,6 +3,7 @@ import { CuboApiEntitiesMap } from '@cuboapp/types'
 import {
   CuboCrdtClient,
   CuboCrdtClientOptions,
+  CuboCrdtRowId,
   CuboCrdtServer,
   CuboCrdtServerDocumentOrigin,
   CuboCrdtServerOptions,
@@ -113,8 +114,10 @@ export function checkSubscribeIsSutable(origin: CuboCrdtServerDocumentOrigin, su
   return noStrategyResolved || strategyOtherResolved || strategyClientResolved || strategySubscribeResolved
 }
 
-export function areCrdtListIdsEqual(left: number[], right: number[]) {
-  return left.length === right.length && left.every((id, index) => id === right[index])
+export function areCrdtListIdsEqual(left: CuboCrdtRowId[], right: CuboCrdtRowId[]) {
+  // Order matters (the list is ordered), but the id's TYPE does not: comparing as strings keeps a
+  // numeric id that made one round trip as text from reading as a changed list and forcing a resync.
+  return left.length === right.length && left.every((id, index) => String(id) === String(right[index]))
 }
 
 export function areCrdtListTotalsEqual(