@genesislcap/grid-pro 15.30.0 → 15.30.1

package/dist/dts/datasource/base.datasource.d.ts

@@ -1,5 +1,6 @@
 import type { ColDef, ColumnState, GridOptions } from '@ag-grid-community/core';
 import { Connect, Datasource, DatasourceOptions, DatasourceStatus, FieldMetadata, FieldTypeEnum, IndexDetail } from '@genesislcap/foundation-comms';
+import { JSONSerializer } from '@genesislcap/foundation-utils';
 import { BehaviorSubject, Subscription } from 'rxjs';
 import { type BaseDatasourceErrorEventDetail } from './base.types';
 /**
@@ -49,12 +50,7 @@ declare const GenesisGridDatasourceElement_base: new () => {
     addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
     addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
     removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options
-    /**
-     * Optional parameter that allows you to select a subset of fields from the query if the client is not interested in receiving all of them.
-     * @remarks DATASERVER only.
-     */
-    ?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     readonly attributes: NamedNodeMap;
     get classList(): DOMTokenList;
     set classList(value: string): any;
@@ -119,7 +115,15 @@ declare const GenesisGridDatasourceElement_base: new () => {
     removeAttribute(qualifiedName: string): void;
     removeAttributeNS(namespace: string | null, localName: string): void;
     removeAttributeNode(attr: Attr): Attr;
-    requestFullscreen(options?: FullscreenOptions): Promise<void>;
+    requestFullscreen(options
+    /**
+     * Returns whether the `row-id` attribute is the default one, depending on the resource type.
+     * @internal
+     */
+    ? /**
+     * Returns whether the `row-id` attribute is the default one, depending on the resource type.
+     * @internal
+     */: FullscreenOptions): Promise<void>;
     requestPointerLock(options?: PointerLockOptions): Promise<void>;
     scroll(options?: ScrollToOptions): void;
     scroll(x: number, y: number): void;
@@ -505,7 +509,12 @@ export declare class GenesisGridDatasourceElement extends GenesisGridDatasourceE
     protected criteriaFromFilters: Map<string, string>;
     protected update: BehaviorSubject<Map<string, string>>;
     protected datasourceOptions(): DatasourceOptions;
-    private buildCriteria;
+    /**
+     * The criteria the resource should be read with: the `criteria` attribute plus anything added
+     * through `setFilter()`.
+     * @internal
+     */
+    protected buildCriteria(): string;
     setFilter(fieldName: string, newFilter: string): void;
     removeFilter(fieldName: string): void;
     get isRequestServer(): boolean;
@@ -550,19 +559,71 @@ interface TransactionData {
     addIndex?: number;
 }
 export declare class GridProBaseDatasource extends GenesisGridDatasourceElement {
+    serializer: JSONSerializer;
     protected dataSubWasLoggedOff: boolean;
     keepColDefsOnClearRowData: boolean;
     rowData: Map<string, any>;
     protected transactionData: TransactionData;
+    /** So rows without a row id are warned about once per element, not once per block. @internal */
+    private missingRowIdWarned;
     protected connectionSub: Subscription | undefined;
     protected subscribeToConnection(): void;
     protected unsubscribeFromConnection(): void;
     protected generateColumnDefsFromMetadata(fieldsMetadata: FieldMetadata[], getFilterParamsByFieldType: (field: FieldMetadata) => ColDef['filterParams'] | any, getFilterByFieldType: (type: FieldTypeEnum) => string): ColDef[];
     protected handleStreamInserts(insertedRows: any[], addIndex?: number): void;
+    /**
+     * Resolves the id of the held row a stream row refers to.
+     * @remarks Under a custom `row-id` a DATASERVER push may carry only the default id
+     * (`ROW_REF`), so the held row with that default id supplies the custom one. Returns
+     * `undefined` when neither id is present - callers skip the row rather than matching
+     * `undefined === undefined` against the first held row.
+     * @internal
+     */
+    protected resolveRowId(row: any): string | undefined;
     protected handleStreamDeletes(deletedRows: any[]): void;
     protected handleStreamUpdates(updatedRows: any[]): void;
     protected applyAllTransactions(): void;
     private applyMappedTransaction;
+    /**
+     * Reports rows a block-based row model (server-side, infinite) has just handed to the grid.
+     * Rows not held before are reported as `add`; rows already held (a block re-read after a
+     * refresh, or a req/rep re-read after a commit or poll) are reported as `update` only when
+     * their content changed, so a plain re-read is silent.
+     * @remarks `rowData` holds the rows delivered since the last cache reset: the resource reports
+     * rows a re-read no longer returned (`reportWithdrawnRows`), and `clearRowData` empties it when
+     * the grid drops its cache. Block eviction is not mirrored - see `DeliveredBlockLedger` - so
+     * this is a superset of what the grid holds.
+     * @internal
+     */
+    protected reportDeliveredRows(rows: any[]): void;
+    /**
+     * Reports rows a block re-read no longer returned: they left the grid (deleted on the server,
+     * or moved into a block that reports them again). Rows already reported removed - a DATASERVER
+     * push, say - are skipped.
+     * @internal
+     */
+    protected reportWithdrawnRows(rowIds: string[]): void;
+    /**
+     * Starts a fresh transaction and returns it, so a caller can keep working on the object it
+     * built even if a consumer's `datasource-data-changed` handler resets the element meanwhile.
+     * @internal
+     */
+    protected resetTransaction(): TransactionData & {
+        add: any[];
+        remove: any[];
+        update: any[];
+    };
+    /**
+     * Whether two versions of a row differ in content. Identity and a key-order-insensitive
+     * field comparison come first, so a re-read of unchanged rows costs no serialization; nested
+     * values fall back to the serializer.
+     * @internal
+     */
+    protected hasRowContentChanged(known: any, row: any): boolean;
+    /** Emits `datasource-data-changed` for `transaction` when it is non-empty. @internal */
+    protected emitTransaction(transaction: TransactionData | undefined): void;
+    /** @internal */
+    private warnMissingRowIdOnce;
     /**
      * Builds the index map used for server-side sorting from the resource's metadata.
      * @remarks Real DATASERVER indexes keep their names; when the resource also (or only) reports

package/dist/dts/datasource/base.datasource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/base.datasource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/base.datasource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,OAAO,EACP,UAAU,EAGV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,WAAW,EAIZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAUrD,OAAO,EAA4B,KAAK,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE7F;;;GAGG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC;;;GAGG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;;;;QASlB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAiCJ,CAAC;4IAGyH,CAAC;wFAGtI,CAAC;+IAMc,CAAC;2FAKc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAyBc,CAAC;;;;;;;;;;;;;;;;;;;;;;;mBAiDV,CAAC;;;;;;;;;;;;;;IAsBtC;;;OAGG;IACH,CAJF,CAAE;;;OAGG;8BAF4D,CAAC;kBAGzD,CAAC;;oBAGW,CAAC;;sBAC6B,CAAC;oBAIR,CAAC;;;;;;;;gDAa9B,CAAC;;;;;;;;;;;;;;;;qBAwBI,CAAC;;;uBAI2D,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EA0GrE,CAAJ;yBAC+C,CAAC;UAC/B,GAAG;WAGhB,GAAJ;;gBAA6E,GAAG;;;;;;;WAahF,GAAL;YAAiD,GAAG;;;;;;;;;;;oBAgDxB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiNxB,CAAR;cAEM,CAAJ;eAKwC,CAAC;gBAC4C,CAAC;;;;;;;;;;;;;;SAwBrF,CAAC;;;iBAGU,CAAC;;8BAIM,CAAC,cAClB,CAAN;;;AAnnBA;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,SAAQ,iCAAyC;IAChF,OAAO,EAAG,OAAO,CAAC;IACf,UAAU,EAAG,UAAU,CAAC;IAExB,mBAAmB,EAAE,WAAW,CAAC;IACjC,oBAAoB,EAAE,WAAW,EAAE,CAAC;IAEhD;;OAEG;IACS,aAAa,EAAE,QAAQ,CAAC;IAGpC;;OAEG;IACG,QAAQ,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACkD,UAAU,UAAS;IAExE;;;OAGG;IACkE,OAAO,EAAE,MAAM,CAClD;IAElC;;;OAGG;IAC8B,OAAO,EAAE,MAAM,CAAC;IAEjD;;;OAGG;IACmC,YAAY,EAAE,MAAM,CAAC;IAE3D;;OAEG;IACqE,UAAU,EAAE,MAAM,CAAC;IAI3F;;;OAGG;IACG,MAAM,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACkE,OAAO,EAAE,MAAM,CACjD;IAEnC;;;OAGG;IACkD,UAAU,UAAS;IAExE;;;OAGG;IACwB,OAAO,UAAS;IAI3C;;;OAGG;IACsD,cAAc,EAAE,OAAO,CAAS;IAEzF;;;OAGG;IAC2C,MAAM,EAAE,MAAM,CAChB;IAE5C;;;OAGG;IACsC,eAAe,EAAE,MAAM,CACf;IAEjD;;;OAGG;IACS,iBAAiB,EAAE,MAAM,EAAE,CAAM;IAE7C;;;OAGG;IACS,OAAO,EAAE,GAAG,CAAC;IAEzB;;;;OAIG;IACyD,gBAAgB,UAAQ;IAEpF;;;;;OAKG;IAC4B,SAAS,MAAC;IAEzC;;;;OAIG;IAC8D,qBAAqB,UAAQ;IAE9F;;;;OAIG;IACH,SAAS,KAAK,KAAK,IAAI,MAAM,CAI5B;IAED;;;OAGG;IACH,SAAS,KAAK,eAAe,IAAI,OAAO,CAMvC;IAED,SAAS,KAAK,0BAA0B,IAAI,MAAM,CAIjD;IAED,SAAS,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAC/D,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAkC;IAExF,SAAS,CAAC,iBAAiB,IAAI,iBAAiB;IA0BhD;;;;OAIG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM;IAc1B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK9C,YAAY,CAAC,SAAS,EAAE,MAAM;IAKrC,IACI,eAAe,IAAI,OAAO,CAE7B;IAID,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB;IAKtE;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,EAAE,IAAI,GAAE,8BAA8B,CAAC,MAAM,CAAa;IA+B7F;;;OAGG;IACH,WAAW;IAIX;;;OAGG;cACa,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,GAAE,OAAc,EACzB,WAAW,GAAE,OAAc,GAC1B,OAAO,CAAC,OAAO,CAAC;CAqDpB;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH;;GAEG;AACH,UAAU,eAAe;IACvB,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAsB,SAAQ,4BAA4B;IACrD,UAAU,EAAG,cAAc,CAAC;IAE5C,SAAS,CAAC,mBAAmB,UAAS;IAC/B,yBAAyB,UAAS;IAEzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa;IAEtC,SAAS,CAAC,eAAe,EAAE,eAAe,CAAuC;IAEjF,gGAAgG;IAChG,OAAO,CAAC,kBAAkB,CAAS;IAGnC,SAAS,CAAC,aAAa,EAAE,YAAY,GAAG,SAAS,CAAC;IAElD,SAAS,CAAC,qBAAqB;IAgB/B,SAAS,CAAC,yBAAyB;IAKnC,SAAS,CAAC,8BAA8B,CACtC,cAAc,EAAE,aAAa,EAAE,EAC/B,0BAA0B,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAAC,cAAc,CAAC,GAAG,GAAG,EAClF,oBAAoB,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,MAAM,GACpD,MAAM,EAAE;IAiEX,SAAS,CAAC,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE,EAAE,QAAQ,GAAE,MAAU;IAkCvE;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS;IAqBpD,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE;IAYhD,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE;IAkBhD,SAAS,CAAC,oBAAoB;IAgC9B,OAAO,CAAC,sBAAsB;IAQ9B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAqBhD;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAYrD;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,IAAI,eAAe,GAAG;QAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE;IAM5F;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO;IAgC7D,wFAAwF;IACxF,SAAS,CAAC,eAAe,CAAC,WAAW,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI;IAazE,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAW5B;;;;;;;;OAQG;IACH,SAAS,CAAC,kBAAkB,CAC1B,gBAAgB,EAAE,WAAW,EAAE,EAC/B,uBAAuB,EAAE,MAAM,EAAE,GAChC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAyCxB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA6BtB,QAAQ;IAIR;;;;;;OAMG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;IAEhD,OAAO;IAIP,kBAAkB;IAIlB,OAAO;IAIP,OAAO,CAAC,eAAe,CAAS;IAEhC;;;OAGG;IACI,eAAe,CAAC,YAAY,EAAE,OAAO;IAa5C;;OAEG;IACI,cAAc,IAAI,OAAO;IAIhC;;;OAGG;IACH,SAAS,CAAC,wBAAwB,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,GAAG;QAC3E,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,CAAC;KACZ;IAaD;;;;OAIG;IACI,4BAA4B,CAAC,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,GAAG,GAAG,EAAE;CAiExF"}

package/dist/dts/datasource/base.types.d.ts

@@ -32,6 +32,16 @@ export type ServerSideDatasourceOptions = {
     onNoDataAvailableFunc?: () => void;
     /** Called when a server-side load finishes with one or more rows. */
     onDataAvailableFunc?: () => void;
+    /**
+     * Called with the rows just handed to AG Grid for a block. This is the only point at which
+     * rows leave the datasource, so it is where the host learns which rows the grid holds.
+     */
+    onRowsDeliveredFunc?: (rows: any[]) => void;
+    /**
+     * Called with the ids of rows a re-read of a block no longer returned - they left the grid
+     * (deleted on the server, or moved to a block that reports them again).
+     */
+    onRowsWithdrawnFunc?: (rowIds: string[]) => void;
     resourceName: string;
     resourceParams?: DataserverParams | RequestParams;
     resourceIndexes?: Map<string, string[]>;

package/dist/dts/datasource/base.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.types.d.ts","sourceRoot":"","sources":["../../../src/datasource/base.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACX,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,0BAA0B,CAAC,EAAE,CAC3B,cAAc,CAAC,EAAE,GAAG,KACjB,OAAO,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACzD,uBAAuB,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjF;;;OAGG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QACjD,MAAM,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QAC9C,UAAU,EAAE,UAAU,CAAC;KACxB,CAAC,CAAC;IACH;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC;IAClD,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAEnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EACA,YAAY,GACZ,qBAAqB,GACrB,eAAe,GACf,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,8BAA8B,CAAC,CAAC"}
+{"version":3,"file":"base.types.d.ts","sourceRoot":"","sources":["../../../src/datasource/base.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACX,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,0BAA0B,CAAC,EAAE,CAC3B,cAAc,CAAC,EAAE,GAAG,KACjB,OAAO,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACzD,uBAAuB,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjF;;;OAGG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QACjD,MAAM,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QAC9C,UAAU,EAAE,UAAU,CAAC;KACxB,CAAC,CAAC;IACH;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC;IAClD,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAEnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EACA,YAAY,GACZ,qBAAqB,GACrB,eAAe,GACf,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,8BAA8B,CAAC,CAAC"}

package/dist/dts/datasource/dataserver-result.filter.d.ts

@@ -0,0 +1,17 @@
+import { FilteredDataServerResult, RawDataServerResult } from '@genesislcap/foundation-comms';
+/**
+ * Filters a DATASERVER batch into inserts/updates/deletes, keeping the default row id
+ * (`ROW_REF`) on every row alongside the configured one.
+ * @remarks `dataServerResultFilter` resolves the configured `rowId` out of `DETAILS` and then
+ * drops `DETAILS` entirely. Under a custom `row-id` that loses the only id a pushed MODIFY or
+ * DELETE carries: Genesis sends those as `DETAILS: { OPERATION, ROW_REF }` plus the changed
+ * fields, so the custom id is absent and the row arrives with no resolvable identity at all.
+ * Hoisting `ROW_REF` before the filter runs keeps it on both the rows a block delivers and the
+ * rows a push carries, which is what lets `resolveRowId` match one to the other.
+ *
+ * Columns come from the resource's field metadata, not from row keys, so the extra field does
+ * not add a column.
+ * @internal
+ */
+export declare function filterDataserverResult(result: RawDataServerResult, rowId: string): FilteredDataServerResult;
+//# sourceMappingURL=dataserver-result.filter.d.ts.map

package/dist/dts/datasource/dataserver-result.filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataserver-result.filter.d.ts","sourceRoot":"","sources":["../../../src/datasource/dataserver-result.filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,MAAM,GACZ,wBAAwB,CAgB1B"}

package/dist/dts/datasource/delivered-block.ledger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * What one block delivery changed about the rows the grid holds.
+ * @internal
+ */
+export type BlockDeliveryReport = {
+    /** Ids the previous delivery of this block carried that this one does not, and no other held block carries. */
+    withdrawnRowIds: string[];
+};
+/**
+ * Tracks which row ids each block has handed to AG Grid, so the host can learn when a re-read of
+ * a block no longer returns a row (it left the grid).
+ * @remarks Plain class shared by the infinite and SSRM resources - AG Grid does not report that
+ * event.
+ *
+ * Block eviction is deliberately **not** mirrored here. AG Grid evicts by last access
+ * (`InfiniteCache.purgeBlocksIfNeeded` sorts on `lastAccessed` and never evicts a displayed or
+ * focused block; the SSRM `LazyCache` purges by distance from the viewport), and a datasource is
+ * told about neither the accesses nor the evictions. Any eviction model built from delivery order
+ * alone diverges from the grid's as soon as the user scrolls back, which would drop a visible
+ * row from the held set and silence the pushes that follow. So the held set means "rows delivered
+ * since the last cache reset": a superset of what the grid holds, which keeps every push for a
+ * possibly-visible row flowing and costs only a re-delivered row being reported as unchanged
+ * rather than as an `add`.
+ * @internal
+ */
+export declare class DeliveredBlockLedger {
+    private readonly rowId;
+    /** Row ids per block start row. */
+    private blocks;
+    constructor(rowId: string);
+    /** Records the rows handed to the grid for the block at `startRow`. */
+    record(startRow: number, rows: any[]): BlockDeliveryReport;
+    /** Forgets every block, for when the grid drops its whole cache (filter/sort change, destroy). */
+    clear(): void;
+    private isHeld;
+}
+//# sourceMappingURL=delivered-block.ledger.d.ts.map

package/dist/dts/datasource/delivered-block.ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivered-block.ledger.d.ts","sourceRoot":"","sources":["../../../src/datasource/delivered-block.ledger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,+GAA+G;IAC/G,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAuC;gBAExB,KAAK,EAAE,MAAM;IAE1C,uEAAuE;IACvE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,mBAAmB;IAmB1D,kGAAkG;IAClG,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,MAAM;CAQf"}

package/dist/dts/datasource/infinite.datasource.d.ts

@@ -398,12 +398,15 @@ declare const GridProInfiniteDatasource_base: (new (...args: any[]) => {
  * @fires datasource-initialize - Fired to hand off infinite row model grid options. detail: `InitializeEventDetail`
  * @fires datasource-init - Fired when the infinite grid model should initialize data
  * @fires datasource-schema-updated - Fired when column metadata or defs are updated. detail: `SchemaUpdatedEventDetail`
+ * @fires datasource-data-changed - Fired when rows are delivered to the grid, a DATASERVER push changes them, or a re-read no longer returns them; `add` are rows the grid did not hold before, `update` are held rows whose content changed, `remove` carries the row id. detail: `DataChangedEventDetail`
  * @fires set-infinite-datasource - Fired to attach or clear the infinite row model datasource. detail: `SetInfiniteDatasourceEventDetail`
  * @fires refresh-infinite-cache - Fired to request an infinite row model refresh; `purge` drops the block cache and re-reads. detail: `RefreshInfiniteCacheEventDetail`
  * @fires add-grid-css-class - Fired to add a CSS class on the grid host (hover sort indicators). detail: `GridCssClassEventDetail`
  * @fires remove-grid-css-class - Fired to remove that CSS class from the grid host. detail: `GridCssClassEventDetail`
  * @fires cache-filter-config - Fired to persist filter configuration for the grid
- * @fires datasource-data-cleared - Fired when infinite row data is cleared. detail: `DataClearedEventDetail`
+ * @fires datasource-data-cleared - Fired when the grid drops every row it held (reload, filter or sort change, destroy); `includeSchema` says whether the columns went too. detail: `DataClearedEventDetail`
+ * @fires datasource-loading-finished - Fired when the first block comes back with rows
+ * @fires datasource-no-data-available - Fired when the first block comes back empty
  * @fires datasource-filters-restored - Fired when persisted filters are reapplied
  */
 export declare class GridProInfiniteDatasource extends GridProInfiniteDatasource_base {
@@ -419,6 +422,19 @@ export declare class GridProInfiniteDatasource extends GridProInfiniteDatasource
     criteriaChanged(oldCriteria: string, newCriteria: string): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    /** Unsubscribes the `setFilter()` listener. @internal */
+    private filterSub;
+    /**
+     * Reloads when `setFilter()` or `removeFilter()` changes the criteria.
+     * @remarks The criteria a block is read with is captured when the resource is built, so a
+     * filter added later reaches nothing until the rows are re-read. The `criteria` attribute
+     * already reloads through `criteriaChanged`; this gives the programmatic API the same
+     * behaviour instead of silently doing nothing.
+     * @internal
+     */
+    private subscribeToFilterChanges;
+    /** @internal */
+    private unsubscribeFromFilterChanges;
     deepClone(): Node;
     /**
      * Resets the grid data while keeping columnDefs and reloads data.
@@ -429,10 +445,58 @@ export declare class GridProInfiniteDatasource extends GridProInfiniteDatasource
     init(): Promise<void>;
     /** @internal */
     private clearReadyListener;
+    /**
+     * Whether the infinite row model can drive this resource.
+     * @remarks It pages a req/rep by sending CRITERIA_MATCH, ORDER_BY and OFFSET in DETAILS, which
+     * a request reply only accepts when it is declared `criteriaOnlyRequest`
+     * (`CRITERIA_ONLY_REQUEST` in its metadata). Without it the server expects its inputs in
+     * `REQUEST` instead and rejects every block, which on this row model surfaces as a grid that
+     * simply never fills. Report it once, up front, as the server-side model does.
+     * @returns `true` when the infinite model can be used, `false` after reporting a
+     * `resource-type` error.
+     * @internal
+     */
+    private isInfiniteSupportedForResource;
     /** @internal */
     private onDatasourceReady;
+    /**
+     * A pushed INSERT/DELETE changes which rows exist or their order, so the change is reported
+     * and then the rows are re-read (purge).
+     * @internal
+     */
+    private handleLiveRowsInvalidated;
+    /**
+     * A pushed MODIFY is already patched into the paging cache, so the change is reported and the
+     * grid only needs to re-render its blocks.
+     * @internal
+     */
+    private handleLiveRowsUpdated;
+    /**
+     * Turns a DATASERVER push into the same transaction the client-side datasource reports:
+     * partial MODIFY rows are merged into the held row, and a remove carries just the row id.
+     * @remarks Unlike the client-side model, a pushed row need not be held here - it may sit
+     * beyond the loaded blocks, in which case the grid will never show it.
+     *
+     * So a pushed INSERT is deliberately not reported: nothing here says where the new row sorts,
+     * and reporting an `add` for a row that lands at position 40,000 of an unscrolled grid would
+     * contradict the event's contract and leave the row held forever, since no block re-read ever
+     * delivers (or withdraws) it. Every INSERT is followed by a purge and re-read, which reports
+     * the row as `add` if and when it actually reaches the grid.
+     *
+     * A MODIFY for a row that is not held is skipped for the same reason; a DELETE is reported by
+     * the id it carries, and one that cannot be resolved to an id is skipped with a warning rather
+     * than matched against the wrong row.
+     * @internal
+     */
+    private reportLiveChange;
     destroy(): Promise<void>;
     restart(): Promise<void>;
+    /**
+     * Forgets every held row and tells consumers, as the client-side datasource does: the grid is
+     * dropping its rows (a reload, a filter or sort change, or teardown). `withColumnDefs` also
+     * clears the column definitions.
+     * @internal
+     */
     private clearRowData;
     /**
      * Honours `pollTriggerEvents` without polling: a commit ACK for one of the listed events

package/dist/dts/datasource/infinite.datasource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infinite.datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/infinite.datasource.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,aAAa,EACb,UAAU,EAOX,MAAM,+BAA+B,CAAC;AAcvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;;;;;;;;kBA2CvB,CAAC;;;;;;;;8BA8ChC,CAAC,cAGC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAwB8E,CAAC;4IAGvE,CAAC;wFAKP,CAAC;+IAMM,CAAC;2FAKf,CAAD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA8BK,CAAD;;;;;;;;;;;;;;;;;;;;;;;mBA2D+B,CAAC;;;;;;;;;;;;;6BAaf,CAAC;8BAEf,CAAD;kBACM,CAAC;;oBAEC,CAAC;;sBAEW,CAAC;oBAEnB,CAAC;;;;;;;;gDAYiF,CAAC;;;;;;;;;;;;;;;;;;uBAkB1E,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAsG6C,CAAC;yBACR,CAAC;UAC1C,GAAG;WAAgD,GAAG;;gBACjB,GAAE;;;;;;;WAQV,GAAG;YACzC,GAAE;;;;;;;;;;;oBA2BkC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMu1N,CAAC;cAA6F,CAAC;eAA8F,CAAC;gBAA+F,CAAC;;;;;;;;;;;;;;SAAulC,CAAC;;;iBAA+E,CAAC;;AA9Z30Q;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAGa,yBAA0B,SAAQ,8BAAqC;IACzE,OAAO,EAAG,OAAO,CAAC;IACZ,aAAa,EAAG,aAAa,CAAC;IACjC,UAAU,EAAG,UAAU,CAAC;IAExB,OAAO,EAAE,GAAG,CAAM;IAE9B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,kBAAkB,CAA4B;IAEtD,sFAAsF;IACtF,OAAO,CAAC,yBAAyB,CAAC,CAAa;IAE/C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOtD,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAWxD,iBAAiB;IAUjB,oBAAoB;IAUX,SAAS,IAAI,IAAI;IAO1B;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBnC,IAAI;IAqDV,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAI1B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CA4EvB;IAEa,OAAO;IAsBP,OAAO;IAKtB,OAAO,CAAC,YAAY;IAapB;;;;;;;OAOG;IACH,OAAO,CAAC,2BAA2B;IAkBnC,qEAAqE;IACrE,OAAO,CAAC,8BAA8B;IAKtC;;;;OAIG;YACW,cAAc;IAO5B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;YAchB,eAAe;IAsCpB,QAAQ;CAMlB"}
+{"version":3,"file":"infinite.datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/infinite.datasource.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,aAAa,EACb,UAAU,EAOX,MAAM,+BAA+B,CAAC;AAgBvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;;;;;;;;kBA2CsM,CAAA;;;;;;;;8BAyBtP,CAAA,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAmChB,CAAC;4IAOC,CAAC;wFAIuB,CAAA;+IAEwB,CAAC;2FAE7C,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA6B6D,CAAA;;;;;;;;;;;;;;;;;;;;;;;mBAkDG,CAAC;;;;;;;;;;;;;6BAoB5E,CAAC;8BAAwE,CAAA;kBAIhE,CAAC;;oBAEuC,CAAC;;sBAOjD,CAAC;oBACiC,CAAC;;;;;;;;gDAQ8C,CAAC;;;;;;;;;;;;;;;;;;uBAoBnF,CAAF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EA6EsC,CAAC;yBAGf,CAAC;UAIb,GAAE;WAAgD,GAAG;;gBAE9D,GAAG;;;;;;;WAU0E,GAAG;YAC/C,GAAE;;;;;;;;;;;oBAsBgD,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuK6oB,CAAC;cAA6F,CAAC;eAA8F,CAAC;gBAA+F,CAAC;;;;;;;;;;;;;;SAAulC,CAAC;;;iBAA+E,CAAC;;AArhB9qE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAGa,yBAA0B,SAAQ,8BAAqC;IACzE,OAAO,EAAG,OAAO,CAAC;IACZ,aAAa,EAAG,aAAa,CAAC;IACjC,UAAU,EAAG,UAAU,CAAC;IAExB,OAAO,EAAE,GAAG,CAAM;IAE9B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,kBAAkB,CAA4B;IAEtD,sFAAsF;IACtF,OAAO,CAAC,yBAAyB,CAAC,CAAa;IAE/C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOtD,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAWxD,iBAAiB;IAWjB,oBAAoB;IAWpB,yDAAyD;IACzD,OAAO,CAAC,SAAS,CAA2B;IAE5C;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;IAWhC,gBAAgB;IAChB,OAAO,CAAC,4BAA4B;IAK3B,SAAS,IAAI,IAAI;IAO1B;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BnC,IAAI;IAqDV,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAI1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,8BAA8B;IAYtC,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAkFvB;IAEF;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAOjC;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,gBAAgB;IAST,OAAO;IAwBP,OAAO;IAKtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;OAOG;IACH,OAAO,CAAC,2BAA2B;IAkBnC,qEAAqE;IACrE,OAAO,CAAC,8BAA8B;IAKtC;;;;OAIG;YACW,cAAc;IAO5B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;YAchB,eAAe;IAsCpB,QAAQ;CAMlB"}

package/dist/dts/datasource/infinite.resource.d.ts

@@ -16,6 +16,13 @@ export declare function convertSortModelToOrderBy(sortModel: SortModelItem[], re
     orderBy: string | null;
     reverse: boolean;
 };
+/**
+ * Turns whatever a rejected resource read produced into a message worth showing.
+ * @remarks Genesis rejects with a message object (`{ ERROR: [{ TEXT }], MESSAGE_TYPE }`), not an
+ * `Error`, so stringifying it naively yields "[object Object]" in the grid's error dialog.
+ * @internal
+ */
+export declare function describeResourceError(error: unknown): string;
 /**
  * AG Grid Infinite Row Model datasource implementation.
  * This class implements the IDatasource interface required by AG Grid's Infinite Row Model.
@@ -30,6 +37,15 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
     private rowId;
     private baseCriteria;
     private isRequestServer;
+    /**
+     * The `order-by` attribute, used when the grid itself is unsorted.
+     * @remarks DATASERVER takes the name of an index on the query; REQUEST_SERVER takes a column
+     * with the direction inline.
+     * @internal
+     */
+    private defaultOrderBy?;
+    /** The `reverse` attribute, applied alongside `defaultOrderBy` on DATASERVER. @internal */
+    private defaultReverse;
     private createSnapshotFunc;
     private createDataserverStreamFunc;
     private getMoreRowsFunc;
@@ -37,17 +53,69 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
      * Called when an unsolicited batch changes which rows exist or their order (an INSERT or a
      * DELETE). The cache cannot be patched in place for those - a created row arrives at the end
      * rather than in sort position, and a delete below the delivered watermark is skipped to keep
-     * slice offsets stable - so the rows have to be re-read.
+     * slice offsets stable - so the rows have to be re-read. Receives the pushed change so the
+     * host can report it before the re-read.
      * @internal
      */
     private onRowsInvalidatedFunc?;
     /**
      * Called when an unsolicited batch only modified rows already held. The cache is patched in
-     * place, so the grid just needs to re-render its blocks.
+     * place, so the grid just needs to re-render its blocks. Receives the pushed change so the
+     * host can report it.
      * @internal
      */
     private onRowsUpdatedFunc?;
+    /**
+     * Called with the rows just handed to AG Grid for a block, on either transport. This is the
+     * only point at which rows leave the datasource, so it is where the host learns which rows
+     * the grid holds (a re-read after a refresh delivers the same rows again).
+     * @internal
+     */
+    private onRowsDeliveredFunc?;
+    /**
+     * Called with the ids of rows a re-read of a block no longer returned: they left the grid
+     * (deleted on the server, or moved into a block that reports them again).
+     * @internal
+     */
+    private onRowsWithdrawnFunc?;
+    /**
+     * Called when a filter or sort change drops every row the grid held, on either transport, so
+     * the host forgets them too. AG Grid purges its own cache on those changes.
+     * @internal
+     */
+    private onRowCacheResetFunc?;
+    /**
+     * Called when the first block comes back with no rows, and when it comes back with rows, so
+     * the host can raise the same no-data / loading-finished events the server-side model does.
+     * @internal
+     */
+    private onNoDataAvailableFunc?;
+    /** @internal */
+    private onDataAvailableFunc?;
     private errorHandlerFunc;
+    /** Which rows each delivered block carried, for withdrawal and eviction reporting. @internal */
+    private ledger;
+    /**
+     * Bumped whenever the rows this datasource was reading for are dropped (a teardown, or a
+     * filter/sort change). A REQUEST_SERVER reply that resolves for an earlier generation was read
+     * for a cache the grid no longer has.
+     * @remarks Deliberately a generation rather than a "destroyed" flag: AG Grid calls `destroy()`
+     * on the datasource bean it then keeps using (`InfiniteRowModel.start()` re-applies the
+     * `datasource` grid option, and `setDatasource` destroys the previous one first), so a sticky
+     * flag would disable the instance the grid is still driving.
+     * @internal
+     */
+    private loadGeneration;
+    /**
+     * Set once the host has dropped this instance for a replacement (a criteria change, a resource
+     * change, teardown). AG Grid keeps calling the bean it was given until the new one is attached,
+     * and its purge re-requests blocks immediately, so without this the replaced instance keeps
+     * reading with its captured criteria and reporting those rows to the host as delivered.
+     * @remarks Distinct from `destroy()`, which AG Grid itself calls on a bean it then keeps using;
+     * only the host calls `detach()`, and only when it will never use this instance again.
+     * @internal
+     */
+    private detached;
     /**
      * Max time a DATASERVER block may stay pending before the safety valve resolves it with the
      * rows accumulated so far.
@@ -70,11 +138,20 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
     private dataserverStreamSubscription;
     private sourceRef;
     /**
-     * Identifies the CRITERIA_MATCH/ORDER_BY the current subscription was opened with; a change
-     * means the subscription has to be re-opened, as those are DATA_LOGON parameters.
+     * Identifies the CRITERIA_MATCH/ORDER_BY the current rows were read with. A change means AG
+     * Grid has dropped every block (it purges on filter/sort changes): on DATASERVER the
+     * subscription has to be re-opened, as those are DATA_LOGON parameters, and on both transports
+     * the host is told its held rows are gone.
      * @internal
      */
     private subscriptionKey;
+    /**
+     * Identifies the CRITERIA_MATCH/ORDER_BY the rows the host currently holds were read with.
+     * Unlike `subscriptionKey` this survives a subscription teardown, so a filter or sort change
+     * is still recognised as one when a live push tore the subscription down first.
+     * @internal
+     */
+    private rowCacheKey;
     /**
      * Session-cumulative row cache, keyed by row id. A Map preserves insertion order, so the
      * cache can be sliced by block range; Genesis splits batches across messages and later
@@ -109,8 +186,11 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
         createSnapshotFunc: (params?: any) => Promise<RequestServerResult | FilteredDataServerResult>;
         createDataserverStreamFunc?: (params?: any) => SocketObservable<FilteredDataServerResult>;
         getMoreRowsFunc?: (sourceRef: string) => Promise<unknown>;
-        onRowsInvalidatedFunc?: () => void;
-        onRowsUpdatedFunc?: () => void;
+        onRowsInvalidatedFunc?: (change: FilteredDataServerResult) => void;
+        onRowsUpdatedFunc?: (change: FilteredDataServerResult) => void;
+        onRowsDeliveredFunc?: (rows: any[]) => void;
+        onRowsWithdrawnFunc?: (rowIds: string[]) => void;
+        onRowCacheResetFunc?: () => void;
         errorHandlerFunc: (message: string, type: string) => void;
         resourceName: string;
         resourceParams: any;
@@ -120,6 +200,10 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
         rowId: string;
         baseCriteria?: string;
         isRequestServer: boolean;
+        defaultOrderBy?: string;
+        defaultReverse?: boolean;
+        onNoDataAvailableFunc?: () => void;
+        onDataAvailableFunc?: () => void;
     });
     /**
      * Builds request parameters for REQUEST_SERVER resources.
@@ -153,6 +237,23 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
      * outstanding at once, and each settles as soon as the cache covers its range.
      * @internal
      */
+    /**
+     * Notes the CRITERIA_MATCH/ORDER_BY a block is being read with. A change means AG Grid has
+     * purged its cache and restarted from block 0: on DATASERVER the subscription is re-opened
+     * (those are DATA_LOGON parameters), and on both transports the host is told the rows it held
+     * are gone, so the rows read under the new filter or sort are reported as new.
+     * @internal
+     */
+    /**
+     * The sort a block is read with: the grid's own sort model when the user has sorted, and the
+     * `order-by` / `reverse` attributes otherwise.
+     * @remarks Without the fallback those attributes reached the comms datasource but were then
+     * dropped, because the logon builder removes ORDER_BY and REVERSE whenever the grid is
+     * unsorted. Sorting from the grid still wins, as it is the more specific instruction.
+     * @internal
+     */
+    private resolveSortConfig;
+    private noteRequestKey;
     private getDataserverRows;
     /**
      * Keeps pulling batches while blocks are still waiting.
@@ -201,6 +302,19 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
      * @internal
      */
     private settleBlock;
+    /**
+     * Raises the no-data / data-available hooks for the first block, as the server-side resource
+     * does. Later blocks say nothing: the question is whether the resource has any rows at all,
+     * and the answer cannot change once the first block has been served.
+     * @internal
+     */
+    private notifyDataAvailability;
+    /**
+     * Reports rows handed to the grid for a block, then the rows a re-read of that block no longer
+     * carries and the rows whose block the grid evicted.
+     * @internal
+     */
+    private deliverRows;
     /**
      * Warns when the view filled up before the data ran out.
      * @remarks The server stops sending at MAX_VIEW rows and reports MORE_ROWS false, which is
@@ -226,6 +340,22 @@ export declare class GenesisInfiniteDatasource implements IDatasource {
      * @internal
      */
     private teardownDataserverSubscription;
+    /**
+     * Drops the subscription and the cached rows.
+     * @remarks AG Grid calls this on the bean it then keeps using (`InfiniteRowModel.start()`
+     * re-applies the `datasource` grid option, and `setDatasource` destroys the previous one
+     * first), and it can land while a block request is in flight. So it must leave the datasource
+     * able to serve that reply and the next `getRows`: it drops the subscription, not the instance.
+     */
     destroy?(): void;
+    /**
+     * Drops this instance for good: the host is replacing it, so it must stop serving the grid and
+     * stop reporting rows, even though AG Grid still holds it as its `datasource` until the
+     * replacement is attached.
+     * @remarks Deliberately separate from `destroy()`, which AG Grid calls on a bean it then keeps
+     * using (`InfiniteRowModel.start()` re-applies the `datasource` grid option, and `setDatasource`
+     * destroys the previous one first).
+     */
+    detach(): void;
 }
 //# sourceMappingURL=infinite.resource.d.ts.map

package/dist/dts/datasource/infinite.resource.d.ts.map

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

package/dist/dts/datasource/server-side.datasource.d.ts

@@ -1,5 +1,4 @@
 import { Datasource, DatasourceOptions } from '@genesislcap/foundation-comms';
-import { JSONSerializer } from '@genesislcap/foundation-utils';
 import { GridProBaseDatasource } from './base.datasource';
 declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
     #_container: import("@genesislcap/foundation-utils").FoundationLayoutContainer | import("@genesislcap/foundation-utils").LayoutCacheContainer | import("@genesislcap/foundation-utils").DOMContainer;
@@ -387,7 +386,7 @@ declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
  * @fires base-datasource-connected - Fired when error state is cleared after connection succeeds
  * @fires datasource-loading-finished - Fired when pending stream transactions are flushed with no row changes
  * @fires datasource-no-data-available - Fired when loading finishes with an empty row set
- * @fires datasource-data-changed - Fired when row data changes from applied stream transactions. detail: `DataChangedEventDetail`
+ * @fires datasource-data-changed - Fired when rows are delivered to the grid, a live stream pushes a change, a poll detects one, or a re-read no longer returns a row; `add` are rows the grid did not hold before, `update` are held rows whose content changed, `remove` carries the row id. detail: `DataChangedEventDetail`
  * @fires cache-filter-config - Fired to persist filter configuration for the grid
  * @fires refresh-server-side - Fired to request a server-side refresh. detail: `RefreshServerSideEventDetail`
  * @fires set-server-side-datasource - Fired to attach or clear the server-side row model datasource
@@ -398,12 +397,11 @@ declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
  * @fires datasource-init - Fired when the server-side grid model should initialize data
  * @fires datasource-schema-updated - Fired when column metadata or defs are updated. detail: `SchemaUpdatedEventDetail`
  * @fires datasource-filters-restored - Fired when persisted filters are reapplied
- * @fires datasource-data-cleared - Fired when server-side row data is cleared. detail: `DataClearedEventDetail`
+ * @fires datasource-data-cleared - Fired when the grid drops every row it held (reload, filter or sort change, destroy); `includeSchema` says whether the columns went too. detail: `DataClearedEventDetail`
  * @fires apply-server-side-transaction - Fired to apply a server-side row transaction
  * @fires datasource-ready - Fired when the host grid is ready to start loading data
  */
 export declare class GridProServerSideDatasource extends GridProServerSideDatasource_base {
-    serializer: JSONSerializer;
     pollingDatasource: Datasource;
     /**
      * Enable live updates for the grid.
@@ -440,6 +438,12 @@ export declare class GridProServerSideDatasource extends GridProServerSideDataso
     private onDatasourceReady;
     destroy(): Promise<void>;
     restart(): Promise<void>;
+    /**
+     * Forgets every held row and tells consumers, as the client-side datasource does: the grid is
+     * dropping its rows (a reload, a filter or sort change, or teardown). `withColumnDefs` also
+     * clears the column definitions.
+     * @internal
+     */
     private clearRowData;
     /**
      * Checks whether the resolved resource can be served through the Server-Side Row Model.