@genesislcap/grid-pro 14.358.0 → 14.360.0

package/dist/custom-elements.json

@@ -11098,6 +11098,20 @@
           "description": "A Genesis Datasource element, for server-side | SSRM-compatible data fetching and used exclusively by the GridPro element.",
           "name": "GridProServerSideDatasource",
           "members": [
+            {
+              "kind": "field",
+              "name": "serializer",
+              "type": {
+                "text": "JSONSerializer"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "pollingDatasource",
+              "type": {
+                "text": "Datasource"
+              }
+            },
             {
               "kind": "field",
               "name": "zeroBasedViewNumber",
@@ -13755,6 +13769,87 @@
                 "text": "(existingParams?: any) => Promise<RequestServerResult>"
               }
             },
+            {
+              "kind": "field",
+              "name": "createReqRepStreamFunc",
+              "type": {
+                "text": "(params?: any) => Promise<{\n    stream: SocketObservable<RequestServerResult>;\n    datasource: any;\n  }> | undefined"
+              },
+              "privacy": "private",
+              "description": "Function to create a polling stream with a separate datasource instance."
+            },
+            {
+              "kind": "field",
+              "name": "reqRepPollingStream",
+              "type": {
+                "text": "SocketObservable<RequestServerResult> | undefined"
+              },
+              "privacy": "private",
+              "description": "The active polling stream observable."
+            },
+            {
+              "kind": "field",
+              "name": "reqRepPollingSubscription",
+              "type": {
+                "text": "SocketSubscription | undefined"
+              },
+              "privacy": "private",
+              "description": "Subscription to the polling stream."
+            },
+            {
+              "kind": "field",
+              "name": "reqRepPollingDatasource",
+              "type": {
+                "text": "any | undefined"
+              },
+              "privacy": "private",
+              "description": "Separate datasource instance used exclusively for polling."
+            },
+            {
+              "kind": "field",
+              "name": "usePolling",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether polling is enabled for this datasource."
+            },
+            {
+              "kind": "field",
+              "name": "onPollingUpdate",
+              "type": {
+                "text": "(result: RequestServerResult) => void | undefined"
+              },
+              "privacy": "private",
+              "description": "Callback to apply polling updates at the parent datasource level."
+            },
+            {
+              "kind": "field",
+              "name": "resetPreviousPollResult",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private",
+              "description": "Callback to reset the previous poll comparison state."
+            },
+            {
+              "kind": "field",
+              "name": "currentStreamParams",
+              "type": {
+                "text": "RequestParams | undefined"
+              },
+              "privacy": "private",
+              "description": "Current request parameters used for the active polling stream."
+            },
+            {
+              "kind": "field",
+              "name": "debouncedCreateStream",
+              "type": {
+                "text": "ReturnType<typeof debounce>"
+              },
+              "privacy": "private",
+              "description": "Debounced function for creating polling streams."
+            },
             {
               "kind": "field",
               "name": "discoveredTotalRowCount",
@@ -13794,6 +13889,81 @@
                 "module": "src/datasource/server-side.resource-base.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "updatePaginationParams",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "params",
+                  "type": {
+                    "text": "IServerSideGetRowsParams"
+                  }
+                },
+                {
+                  "name": "effectivePagingMode",
+                  "type": {
+                    "text": "PagingMode"
+                  }
+                }
+              ],
+              "description": "Update pagination params based on paging mode"
+            },
+            {
+              "kind": "method",
+              "name": "determineIsLastView",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "requestResult",
+                  "type": {
+                    "text": "RequestServerResult"
+                  }
+                },
+                {
+                  "name": "requestParams",
+                  "type": {
+                    "text": "RequestParams"
+                  }
+                },
+                {
+                  "name": "effectivePagingMode",
+                  "type": {
+                    "text": "PagingMode"
+                  }
+                }
+              ],
+              "description": "Determine if this is the last view/page"
+            },
+            {
+              "kind": "method",
+              "name": "schedulePollingStream",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "requestParams",
+                  "type": {
+                    "text": "RequestParams"
+                  }
+                }
+              ],
+              "description": "Schedules polling stream creation if enabled."
+            },
             {
               "kind": "method",
               "name": "applyServerSideData",
@@ -13903,6 +14073,40 @@
                 "module": "src/datasource/server-side.resource-base.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "destroy",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "inheritedFrom": {
+                "name": "BaseServerSideDatasource",
+                "module": "src/datasource/server-side.resource-base.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "createPollingStream",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "requestParams",
+                  "type": {
+                    "text": "RequestParams"
+                  },
+                  "description": "The request parameters for the current view"
+                }
+              ],
+              "description": "Creates a polling stream for the currently loaded data."
+            },
+            {
+              "kind": "method",
+              "name": "destroyPollingStream",
+              "privacy": "private",
+              "description": "Destroys the current polling stream and associated datasource."
+            },
             {
               "kind": "method",
               "name": "buildRequestDetails",
@@ -14275,19 +14479,6 @@
                 "module": "src/datasource/server-side.resource-base.ts"
               }
             },
-            {
-              "kind": "method",
-              "name": "destroy",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseServerSideDatasource",
-                "module": "src/datasource/server-side.resource-base.ts"
-              }
-            },
             {
               "kind": "method",
               "name": "updateResourceParams",

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

@@ -1,4 +1,4 @@
-import { SocketObservable, FilteredDataServerResult, MetadataDetail, RequestServerResult, DataserverParams, RequestParams } from '@genesislcap/foundation-comms';
+import { SocketObservable, FilteredDataServerResult, MetadataDetail, RequestServerResult, DataserverParams, RequestParams, Datasource } from '@genesislcap/foundation-comms';
 import { PagingMode } from './datasource.types';
 /**
  * Type definition for configuration options used for streams.
@@ -9,6 +9,24 @@ import { PagingMode } from './datasource.types';
 export type ServerSideDatasourceOptions = {
     createDataserverStreamFunc?: (existingParams?: any) => Promise<SocketObservable<FilteredDataServerResult>>;
     createReqRepRequestFunc?: (existingParams?: any) => Promise<RequestServerResult>;
+    /**
+     * Function to create a polling stream for REQUEST_SERVER resources.
+     * @remarks Returns both the stream and the datasource instance for proper lifecycle management.
+     */
+    createReqRepStreamFunc?: (params?: any) => Promise<{
+        stream: SocketObservable<RequestServerResult>;
+        datasource: Datasource;
+    }>;
+    /**
+     * Callback function invoked when a polling update is received.
+     * @remarks Used by REQUEST_SERVER resources to apply updates via applyServerSideTransaction.
+     */
+    onPollingUpdateFunc?: (result: RequestServerResult) => void;
+    /**
+     * Callback function to reset the previous poll result comparison state.
+     * @remarks Called when the polling stream is destroyed or recreated with new parameters.
+     */
+    resetPreviousPollResultFunc?: () => void;
     reloadResourceDataFunc?: (params: any) => Promise<void>;
     errorHandlerFunc?: (message: string, type: string) => void;
     resourceName: string;
@@ -22,6 +40,7 @@ export type ServerSideDatasourceOptions = {
     zeroBasedViewNumber?: boolean;
     pagingMode?: PagingMode | undefined;
     criteriaOnlyRequest?: boolean;
+    usePolling?: boolean;
 };
 /**
  * Base datasource error event names.

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,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;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,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,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC;IAClD,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,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;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,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;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;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,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC;IAClD,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,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;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,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/server-side.datasource.d.ts

@@ -1,4 +1,5 @@
-import { DatasourceOptions } from '@genesislcap/foundation-comms';
+import { Datasource, DatasourceOptions } from '@genesislcap/foundation-comms';
+import { JSONSerializer } from '@genesislcap/foundation-utils';
 import { GridProBaseDatasource } from './base.datasource';
 import { PagingMode } from './datasource.types';
 declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
@@ -378,6 +379,8 @@ declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
  * @beta
  */
 export declare class GridProServerSideDatasource extends GridProServerSideDatasource_base {
+    serializer: JSONSerializer;
+    pollingDatasource: Datasource;
     /**
      * The starting VIEW_NUMBER of the data to be fetched.
      * @remarks The VIEW_NUMBER isincremented by the grid as the user scrolls or changes pages.
@@ -429,6 +432,49 @@ export declare class GridProServerSideDatasource extends GridProServerSideDataso
     private clearRowData;
     private getResourceIndexes;
     private createReqRepRequest;
+    /**
+     * Creates a polling stream for REQUEST_SERVER resources.
+     * @remarks
+     * Creates a separate `Datasource` instance configured to poll all currently loaded rows
+     * (from offset 0 to current offset + maxRows). This enables change detection across all
+     * loaded data, not just the current page.
+     *
+     * The separate datasource instance has built-in polling logic (pollingInterval, pollTriggerEvents)
+     * and manages its own lifecycle independently of the snapshot datasource.
+     * @param existingParams - The current request parameters (includes OFFSET, MAX_ROWS, etc.)
+     * @returns Object containing the polling stream and the datasource instance
+     * @internal
+     */
+    private createReqRepStream;
+    /**
+     * Stores the previous poll result for comparison (poll N vs poll N-1).
+     * @remarks
+     * This enables efficient change detection by comparing consecutive polls instead of
+     * maintaining the entire dataset in memory. Only stores the last poll result.
+     * @internal
+     */
+    private previousPollResult;
+    /**
+     * Resets the previous poll result comparison state.
+     * @remarks
+     * Called when the polling stream is destroyed or recreated with new parameters
+     * (e.g., user scrolls to a different page, or filters/sorting changes).
+     * @internal
+     */
+    resetPreviousPollResult(): void;
+    /**
+     * Applies polling updates for REQUEST_SERVER resources in SSRM.
+     * @remarks
+     * Compares the current poll result (poll N) with the previous poll result (poll N-1)
+     * to detect inserts, updates, and deletes. Changes are applied to the grid using
+     * `applyServerSideTransaction` to avoid interfering with SSRM's cache management.
+     *
+     * The first poll is stored without applying changes (nothing to compare yet).
+     * Subsequent polls are compared to detect changes efficiently.
+     * @param result - The polling result from the REQUEST_SERVER resource
+     * @internal
+     */
+    private applyReqRepPollingUpdate;
     private createDataserverStream;
     private getAgColumnDefs;
     applyTransaction(transaction: any): any;

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

@@ -1 +1 @@
-{"version":3,"file":"server-side.datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/server-side.datasource.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,iBAAiB,EAYlB,MAAM,+BAA+B,CAAC;AAWvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;;;;;;;kBAsDQ,CAAC;;;;;;;;8BAoC1B,CAAC,cAC5B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA8BsB,CAAC;4IAOF,CAAA;wFAOnB,CAAC;+IAGmB,CAAC;2FAKgC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA6B9B,CAAC;;;;;;;;;;;;;;;;;;;;;;;mBAuEiB,CAAC;;;;;;;;;;;;;6BAmBnC,CAAC;8BACN,CAAL;kBAC6B,CAAC;;oBAI2B,CAAC;;sBAGL,CAAC;oBAChB,CAAC;;;;;;;;gDAWe,CAAC;;;;;;;;;;;;;;;;;;uBAiBpB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAgHzB,CAAC;yBAEO,CAAC;UACL,GAAG;WACT,GAAG;;gBAEmB,GAAG;;;;;;;WAO3B,GAAC;YACU,GAAG;;;;;;;;;;;oBAoCtB,GAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBwoN,CAAC;cAA6F,CAAC;eAA8F,CAAC;gBAA+F,CAAC;;;;;;;;;;;;;;SAAulC,CAAC;;;iBAA+E,CAAC;;AA1aplQ;;;;;;;;;GASG;AACH,qBAGa,2BAA4B,SAAQ,gCAAqC;IACpF;;;OAGG;IAC6D,mBAAmB,UAAS;IAE5F;;;OAGG;IACmD,WAAW,UAAS;IAE1E;;;;;;OAMG;IACiC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAE3D,OAAO,EAAE,GAAG,CAAM;IAE9B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAA8D;IACpF,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,uBAAuB,CAA6B;IAE5D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOtD,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAaxD,iBAAiB;IAUjB,oBAAoB;IAUX,SAAS,IAAI,IAAI;IAO1B;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCnE;;;OAGG;IACH,OAAO,CAAC,mCAAmC;IAc3C;;;OAGG;IACH,OAAO,CAAC,oCAAoC;IAWtC,IAAI;IAuHV,mBAAmB,CAAC,KAAK,EAAE,GAAG;IAMf,OAAO;IAkBP,OAAO;IAKtB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,kBAAkB;YAUZ,mBAAmB;YAKnB,sBAAsB;YAoDtB,eAAe;IAmBpB,gBAAgB,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG;IAIvC,QAAQ;CAGlB"}
+{"version":3,"file":"server-side.datasource.d.ts","sourceRoot":"","sources":["../../../src/datasource/server-side.datasource.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,UAAU,EACV,iBAAiB,EAYlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EAGf,MAAM,+BAA+B,CAAC;AAUvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;;;;;;;kBAsD7B,CAAC;;;;;;;;8BAkCV,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA+BO,CAAC;4IAQpB,CAAC;wFAGiB,CAAC;+IAQK,CAAC;2FAEL,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA+B3B,CAAJ;;;;;;;;;;;;;;;;;;;;;;;mBAwEc,CAAC;;;;;;;;;;;;;6BAmBX,CAAJ;8BAAuE,CAAC;kBAE1D,CAAC;;oBAET,CAAV;;sBAI+B,CAAC;oBACC,CAAC;;;;;;;;gDAYJ,CAAC;;;;;;;;;;;;;;;;;;uBAcb,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EA8GhB,CAAC;yBAA8E,CAAC;UACvC,GAAG;WACnB,GAAG;;gBAIwB,GAAG;;;;;;;WAM0C,GACnG;YAAiD,GAAG;;;;;;;;;;;oBA6BhC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4Lm5B,CAAC;cAA6F,CAAC;eAA8F,CAAC;gBAA+F,CAAC;;;;;;;;;;;;;;SAAulC,CAAC;;;iBAA+E,CAAC;;AAxkBj3E;;;;;;;;;GASG;AACH,qBAGa,2BAA4B,SAAQ,gCAAqC;IACpE,UAAU,EAAG,cAAc,CAAC;IAChC,iBAAiB,EAAG,UAAU,CAAC;IAC3C;;;OAGG;IAC6D,mBAAmB,UAAS;IAE5F;;;OAGG;IACmD,WAAW,UAAS;IAE1E;;;;;;OAMG;IACiC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAE3D,OAAO,EAAE,GAAG,CAAM;IAE9B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAA8D;IACpF,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,uBAAuB,CAA6B;IAE5D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOtD,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAaxD,iBAAiB;IAUjB,oBAAoB;IAUX,SAAS,IAAI,IAAI;IAO1B;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCnE;;;OAGG;IACH,OAAO,CAAC,mCAAmC;IAc3C;;;OAGG;IACH,OAAO,CAAC,oCAAoC;IAWtC,IAAI;IAgIV,mBAAmB,CAAC,KAAK,EAAE,GAAG;IAMf,OAAO;IAmBP,OAAO;IAKtB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,kBAAkB;YAUZ,mBAAmB;IAKjC;;;;;;;;;;;;OAYG;YACW,kBAAkB;IA+BhC;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAA+B;IAEzD;;;;;;OAMG;IACI,uBAAuB;IAK9B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,wBAAwB;YAqElB,sBAAsB;YAoDtB,eAAe;IAmBpB,gBAAgB,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG;IAIvC,QAAQ;CAGlB"}

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

@@ -8,10 +8,65 @@ import { BaseServerSideDatasource } from './server-side.resource-base';
  */
 export declare class ReqRepServerSideDatasource extends BaseServerSideDatasource implements IServerSideDatasource {
     createReqRepRequestFunc: (existingParams?: any) => Promise<RequestServerResult>;
+    /**
+     * Function to create a polling stream with a separate datasource instance.
+     * @remarks Optional - only set when polling is enabled (!isSnapshot && !disablePolling).
+     */
+    private createReqRepStreamFunc?;
+    /**
+     * The active polling stream observable.
+     */
+    private reqRepPollingStream?;
+    /**
+     * Subscription to the polling stream.
+     */
+    private reqRepPollingSubscription?;
+    /**
+     * Separate datasource instance used exclusively for polling.
+     * @remarks Maintains its own lifecycle independent of the snapshot datasource.
+     */
+    private reqRepPollingDatasource?;
+    /**
+     * Whether polling is enabled for this datasource.
+     */
+    private usePolling;
+    /**
+     * Callback to apply polling updates at the parent datasource level.
+     */
+    private onPollingUpdate?;
+    /**
+     * Callback to reset the previous poll comparison state.
+     */
+    private resetPreviousPollResult?;
+    /**
+     * Current request parameters used for the active polling stream.
+     * @remarks Used to detect if parameters changed (user scrolled away).
+     */
+    private currentStreamParams?;
+    /**
+     * Debounced function for creating polling streams.
+     * @remarks Prevents excessive stream recreation during rapid scrolling.
+     */
+    private debouncedCreateStream;
     private discoveredTotalRowCount;
     private currentNextOffset;
     constructor(options: ServerSideDatasourceOptions);
     getRows(params: IServerSideGetRowsParams): Promise<void>;
+    /**
+     * Update pagination params based on paging mode
+     */
+    private updatePaginationParams;
+    /**
+     * Determine if this is the last view/page
+     */
+    private determineIsLastView;
+    /**
+     * Schedules polling stream creation if enabled.
+     * @remarks
+     * Destroys any existing stream and schedules a new one after the user stops scrolling (debounced).
+     * This prevents excessive stream recreation during rapid scrolling.
+     */
+    private schedulePollingStream;
     private applyServerSideData;
     protected getCorrectRowCount(params: IServerSideGetRowsParams): number;
     private handleCurrentStreamLoad;
@@ -21,6 +76,29 @@ export declare class ReqRepServerSideDatasource extends BaseServerSideDatasource
      */
     protected setupSorting(params: IServerSideGetRowsParams): Promise<void>;
     refreshDatasource(params: DatasourceOptions): Promise<void>;
+    destroy(): Promise<void>;
+    /**
+     * Creates a polling stream for the currently loaded data.
+     * @remarks
+     * This method creates a separate datasource instance that polls all currently loaded rows
+     * (from offset 0 to current offset + maxRows). The polling results are sent to the parent
+     * datasource via the `onPollingUpdate` callback for change detection and grid updates.
+     *
+     * The stream will only apply updates if the request params haven't changed (user hasn't
+     * scrolled away or changed filters/sorting).
+     * @param requestParams - The request parameters for the current view
+     */
+    private createPollingStream;
+    /**
+     * Destroys the current polling stream and associated datasource.
+     * @remarks
+     * Cleans up the polling subscription, destroys the separate polling datasource instance,
+     * and resets the previous poll comparison state. Called when:
+     * - User scrolls to a new page
+     * - Filters or sorting changes
+     * - The datasource is being destroyed
+     */
+    private destroyPollingStream;
     private buildRequestDetails;
 }
 //# sourceMappingURL=server-side.resource-reqrep.d.ts.map

package/dist/dts/datasource/server-side.resource-reqrep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-side.resource-reqrep.d.ts","sourceRoot":"","sources":["../../../src/datasource/server-side.resource-reqrep.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EAInB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;GAGG;AACH,qBAAa,0BACX,SAAQ,wBACR,YAAW,qBAAqB;IAEhC,uBAAuB,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAGhF,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,iBAAiB,CAAa;gBAE1B,OAAO,EAAE,2BAA2B;IAmB1C,OAAO,CAAC,MAAM,EAAE,wBAAwB;IAiF9C,OAAO,CAAC,mBAAmB;IAsF3B,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM;IA0BtE,OAAO,CAAC,uBAAuB;IAoB/B;;;OAGG;cACa,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvE,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjE,OAAO,CAAC,mBAAmB;CAoB5B"}
+{"version":3,"file":"server-side.resource-reqrep.d.ts","sourceRoot":"","sources":["../../../src/datasource/server-side.resource-reqrep.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EAInB,iBAAiB,EAGlB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAOvE;;;GAGG;AACH,qBAAa,0BACX,SAAQ,wBACR,YAAW,qBAAqB;IAEhC,uBAAuB,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhF;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAAC,CAG5B;IAEH;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAAwC;IAEpE;;OAEG;IACH,OAAO,CAAC,yBAAyB,CAAC,CAAqB;IAEvD;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAAC,CAAM;IAEtC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAU;IAE5B;;OAEG;IACH,OAAO,CAAC,eAAe,CAAC,CAAwC;IAEhE;;OAEG;IACH,OAAO,CAAC,uBAAuB,CAAC,CAAa;IAE7C;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAAgB;IAE5C;;;OAGG;IACH,OAAO,CAAC,qBAAqB,CAA8B;IAG3D,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,iBAAiB,CAAa;gBAE1B,OAAO,EAAE,2BAA2B;IA6B1C,OAAO,CAAC,MAAM,EAAE,wBAAwB;IAmC9C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;YACW,mBAAmB;IAsCjC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,mBAAmB;IAsF3B,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM;IA0BtE,OAAO,CAAC,uBAAuB;IAoB/B;;;OAGG;cACa,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvE,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D,OAAO;IAUb;;;;;;;;;;OAUG;YACW,mBAAmB;IAkCjC;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,mBAAmB;CAoB5B"}

package/dist/esm/datasource/server-side.datasource.js

@@ -1,6 +1,6 @@
 import { __awaiter, __decorate } from "tslib";
-import { dataServerResultFilter, MessageType, normaliseCriteria, ResourceType, toFieldMetadata, } from '@genesislcap/foundation-comms';
-import { LifecycleMixin, insertDocumentCSSRule } from '@genesislcap/foundation-utils';
+import { dataServerResultFilter, Datasource, MessageType, normaliseCriteria, ResourceType, toFieldMetadata, } from '@genesislcap/foundation-comms';
+import { JSONSerializer, LifecycleMixin, insertDocumentCSSRule, } from '@genesislcap/foundation-utils';
 import { attr, customElement, DOM, observable } from '@microsoft/fast-element';
 import { gridProGenesisDatasourceEventNames } from '../grid-pro-genesis-datasource';
 import { datasourceEventNames, } from '../grid-pro-genesis-datasource/datasource-events.types';
@@ -80,6 +80,14 @@ let GridProServerSideDatasource = class GridProServerSideDatasource extends Life
         this.liveUpdates = false;
         this.request = {};
         this.sortIndicatorCSSDestroy = null;
+        /**
+         * Stores the previous poll result for comparison (poll N vs poll N-1).
+         * @remarks
+         * This enables efficient change detection by comparing consecutive polls instead of
+         * maintaining the entire dataset in memory. Only stores the last poll result.
+         * @internal
+         */
+        this.previousPollResult = new Map();
     }
     resourceNameChanged(oldValue, newValue) {
         if (!oldValue || oldValue === newValue)
@@ -232,8 +240,16 @@ let GridProServerSideDatasource = class GridProServerSideDatasource extends Life
                     metadata: fieldMetadata,
                 });
                 if (this.isRequestServer) {
+                    // Enable polling if not in snapshot mode and polling is not disabled
+                    const usePolling = !this.isSnapshot && !this.disablePolling;
                     this.ssrmDatasource = new ReqRepServerSideDatasource({
                         createReqRepRequestFunc: this.createReqRepRequest.bind(this),
+                        createReqRepStreamFunc: usePolling ? this.createReqRepStream.bind(this) : undefined,
+                        onPollingUpdateFunc: usePolling ? this.applyReqRepPollingUpdate.bind(this) : undefined,
+                        resetPreviousPollResultFunc: usePolling
+                            ? this.resetPreviousPollResult.bind(this)
+                            : undefined,
+                        usePolling: usePolling,
                         reloadResourceDataFunc: this.reloadResourceData.bind(this),
                         errorHandlerFunc: this.handleErrors.bind(this),
                         resourceName: this.resourceName,
@@ -287,13 +303,14 @@ let GridProServerSideDatasource = class GridProServerSideDatasource extends Life
     }
     destroy() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
+            var _a, _b;
             this.datasource.destroy();
             (_a = this.liveUpdatesStream) === null || _a === void 0 ? void 0 : _a.unsubscribe();
             this.liveUpdatesStream = undefined;
             this.clearRowData();
             if (this.ssrmDatasource) {
                 yield this.ssrmDatasource.destroy();
+                (_b = this.pollingDatasource) === null || _b === void 0 ? void 0 : _b.destroy();
                 this.ssrmDatasource = undefined;
             }
             // Remove custom sort indicator styling
@@ -337,6 +354,123 @@ let GridProServerSideDatasource = class GridProServerSideDatasource extends Life
             return reqRep;
         });
     }
+    /**
+     * Creates a polling stream for REQUEST_SERVER resources.
+     * @remarks
+     * Creates a separate `Datasource` instance configured to poll all currently loaded rows
+     * (from offset 0 to current offset + maxRows). This enables change detection across all
+     * loaded data, not just the current page.
+     *
+     * The separate datasource instance has built-in polling logic (pollingInterval, pollTriggerEvents)
+     * and manages its own lifecycle independently of the snapshot datasource.
+     * @param existingParams - The current request parameters (includes OFFSET, MAX_ROWS, etc.)
+     * @returns Object containing the polling stream and the datasource instance
+     * @internal
+     */
+    createReqRepStream() {
+        return __awaiter(this, arguments, void 0, function* (existingParams = null) {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const currentOffset = (_b = (_a = existingParams === null || existingParams === void 0 ? void 0 : existingParams.DETAILS) === null || _a === void 0 ? void 0 : _a.OFFSET) !== null && _b !== void 0 ? _b : 0;
+            const baseMaxRows = (_d = (_c = existingParams === null || existingParams === void 0 ? void 0 : existingParams.DETAILS) === null || _c === void 0 ? void 0 : _c.MAX_ROWS) !== null && _d !== void 0 ? _d : this.maxRows;
+            const totalRowsToFetch = baseMaxRows + currentOffset;
+            const datasourceOptions = Object.assign(Object.assign({}, this.datasourceOptions()), { criteria: (_f = (_e = existingParams === null || existingParams === void 0 ? void 0 : existingParams.DETAILS) === null || _e === void 0 ? void 0 : _e.CRITERIA_MATCH) !== null && _f !== void 0 ? _f : this.criteria, maxRows: totalRowsToFetch, orderBy: (_h = (_g = existingParams === null || existingParams === void 0 ? void 0 : existingParams.DETAILS) === null || _g === void 0 ? void 0 : _g.ORDER_BY) !== null && _h !== void 0 ? _h : this.orderBy });
+            logger.debug('Creating polling datasource for all loaded rows:', {
+                currentOffset,
+                baseMaxRows,
+                totalRowsToFetch,
+            });
+            // Initialize the polling datasource
+            const initOK = yield this.pollingDatasource.init(datasourceOptions, true, true);
+            if (!initOK) {
+                logger.error('Polling datasource init failed');
+                return;
+            }
+            return { stream: this.pollingDatasource.stream, datasource: this.pollingDatasource };
+        });
+    }
+    /**
+     * Resets the previous poll result comparison state.
+     * @remarks
+     * Called when the polling stream is destroyed or recreated with new parameters
+     * (e.g., user scrolls to a different page, or filters/sorting changes).
+     * @internal
+     */
+    resetPreviousPollResult() {
+        this.previousPollResult.clear();
+        logger.debug('Previous poll result cleared');
+    }
+    /**
+     * Applies polling updates for REQUEST_SERVER resources in SSRM.
+     * @remarks
+     * Compares the current poll result (poll N) with the previous poll result (poll N-1)
+     * to detect inserts, updates, and deletes. Changes are applied to the grid using
+     * `applyServerSideTransaction` to avoid interfering with SSRM's cache management.
+     *
+     * The first poll is stored without applying changes (nothing to compare yet).
+     * Subsequent polls are compared to detect changes efficiently.
+     * @param result - The polling result from the REQUEST_SERVER resource
+     * @internal
+     */
+    applyReqRepPollingUpdate(result) {
+        var _a;
+        if (!this.ssrmDatasource || !result.REPLY) {
+            return;
+        }
+        const polledData = result.REPLY;
+        if (!Array.isArray(polledData) || !((_a = result.MESSAGE_TYPE) === null || _a === void 0 ? void 0 : _a.startsWith('REP_'))) {
+            logger.error('received invalid RequestServerResult for polling update', result);
+            return;
+        }
+        if (this.previousPollResult.size === 0) {
+            polledData.forEach((row) => {
+                this.previousPollResult.set(row[this.rowId], row);
+            });
+            logger.debug('First poll result stored for future comparison', {
+                rowCount: this.previousPollResult.size,
+            });
+            return;
+        }
+        const currentPollMap = new Map();
+        polledData.forEach((row) => {
+            currentPollMap.set(row[this.rowId], row);
+        });
+        const rowsToUpdate = [];
+        const rowsToInsert = [];
+        const rowsToDelete = [];
+        polledData.forEach((row) => {
+            const rowId = row[this.rowId];
+            if (this.previousPollResult.has(rowId)) {
+                const previousRow = this.previousPollResult.get(rowId);
+                if (this.serializer.serialize(previousRow) !== this.serializer.serialize(row)) {
+                    rowsToUpdate.push(row);
+                }
+            }
+            else {
+                rowsToInsert.push(row);
+            }
+        });
+        this.previousPollResult.forEach((previousRow, rowId) => {
+            if (!currentPollMap.has(rowId)) {
+                rowsToDelete.push(previousRow);
+            }
+        });
+        if (rowsToUpdate.length > 0 || rowsToDelete.length > 0 || rowsToInsert.length > 0) {
+            this.previousPollResult = currentPollMap;
+            logger.debug('Applying reqRep polling update via applyServerSideTransaction:', {
+                added: rowsToInsert.length,
+                updated: rowsToUpdate.length,
+                removed: rowsToDelete.length,
+                totalInPoll: currentPollMap.size,
+            });
+            this.$emit(datasourceEventNames.applyServerSideTransaction, {
+                transaction: {
+                    add: rowsToInsert,
+                    update: rowsToUpdate,
+                    remove: rowsToDelete,
+                },
+            });
+        }
+    }
     createDataserverStream() {
         return __awaiter(this, arguments, void 0, function* (existingParams = null) {
             if (this.liveUpdates) {
@@ -399,6 +533,12 @@ let GridProServerSideDatasource = class GridProServerSideDatasource extends Life
         throw new Error('loadMore() method is not supported for server-side datasource');
     }
 };
+__decorate([
+    JSONSerializer
+], GridProServerSideDatasource.prototype, "serializer", void 0);
+__decorate([
+    Datasource
+], GridProServerSideDatasource.prototype, "pollingDatasource", void 0);
 __decorate([
     attr({ mode: 'boolean', attribute: 'zero-based-view-number' })
 ], GridProServerSideDatasource.prototype, "zeroBasedViewNumber", void 0);

package/dist/esm/datasource/server-side.resource-reqrep.js

@@ -1,36 +1,46 @@
 import { __awaiter } from "tslib";
 import { MessageType, } from '@genesislcap/foundation-comms';
+import debounce from 'lodash.debounce';
 import { logger } from '../utils';
 import { BaseServerSideDatasource } from './server-side.resource-base';
+/**
+ * Debounce time for stream creation after user stops scrolling (in ms)
+ */
+const POLLING_STREAM_DEBOUNCE_MS = 300;
 /**
  * The REQUEST_SERVER IServerSideDatasource implementation, used for SSRM (Server-Side Row Model) in the grid.
  * @beta
  */
 export class ReqRepServerSideDatasource extends BaseServerSideDatasource {
     constructor(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         super(options);
         // Track the total discovered row count when we reach the last page
         this.discoveredTotalRowCount = null;
         this.currentNextOffset = 0;
         this.createReqRepRequestFunc = options.createReqRepRequestFunc;
+        this.createReqRepStreamFunc = options.createReqRepStreamFunc;
+        this.onPollingUpdate = options.onPollingUpdateFunc;
+        this.resetPreviousPollResult = options.resetPreviousPollResultFunc;
+        this.usePolling = (_a = options.usePolling) !== null && _a !== void 0 ? _a : false;
+        // Initialize debounced stream creation function
+        this.debouncedCreateStream = debounce((params) => this.createPollingStream(params), POLLING_STREAM_DEBOUNCE_MS);
         const effectivePagingMode = this.getEffectivePagingMode();
         // Initialize based on paging mode
         if (effectivePagingMode === 'viewBased') {
-            if (!((_b = (_a = options.resourceParams) === null || _a === void 0 ? void 0 : _a.DETAILS) === null || _b === void 0 ? void 0 : _b.VIEW_NUMBER)) {
+            if (!((_c = (_b = options.resourceParams) === null || _b === void 0 ? void 0 : _b.DETAILS) === null || _c === void 0 ? void 0 : _c.VIEW_NUMBER)) {
                 this.resourceParams.DETAILS.VIEW_NUMBER = this.zeroBasedViewNumber ? 0 : 1;
             }
         }
         else {
             // offsetBased
-            if (!((_d = (_c = options.resourceParams) === null || _c === void 0 ? void 0 : _c.DETAILS) === null || _d === void 0 ? void 0 : _d.OFFSET)) {
+            if (!((_e = (_d = options.resourceParams) === null || _d === void 0 ? void 0 : _d.DETAILS) === null || _e === void 0 ? void 0 : _e.OFFSET)) {
                 this.resourceParams.DETAILS.OFFSET = 0;
             }
         }
     }
     getRows(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
             // Use custom filtering and sorting setup for req-rep
             yield this.setupFiltering(params);
             yield this.setupSorting(params);
@@ -39,38 +49,55 @@ export class ReqRepServerSideDatasource extends BaseServerSideDatasource {
                 return;
             }
             const effectivePagingMode = this.getEffectivePagingMode();
-            if (effectivePagingMode === 'viewBased') {
-                if (this.currentSequenceId !== null && this.currentSequenceId >= 0 && this.moreRows) {
-                    if (this.pagination) {
-                        this.resourceParams.DETAILS.VIEW_NUMBER = this.getPageNumber(params.request.startRow, this.maxRows, undefined, // Don't pass maxView as totalRecords since it's not a valid total count
-                        this.zeroBasedViewNumber);
-                    }
-                    else {
-                        this.resourceParams.DETAILS.VIEW_NUMBER += 1;
-                    }
-                }
-            }
-            else {
-                // offsetBased
-                if (this.currentNextOffset > 0 && this.currentNextOffset !== params.request.startRow) {
-                    this.resourceParams.DETAILS.OFFSET = this.currentNextOffset;
-                }
-                else {
-                    this.resourceParams.DETAILS.OFFSET = params.request.startRow;
-                }
-            }
+            // Update pagination params based on paging mode
+            this.updatePaginationParams(params, effectivePagingMode);
             const requestParams = {
                 DETAILS: this.buildRequestDetails(effectivePagingMode),
             };
             const requestResult = yield this.createReqRepRequestFunc(requestParams);
-            // Check if MORE_ROWS is available in the response (GSF 8.14+ only)
+            // Determine if this is the last view/page
+            const isLastView = yield this.determineIsLastView(requestResult, requestParams, effectivePagingMode);
+            // Apply the result to the grid
+            this.applyServerSideData(params, requestResult, isLastView);
+            // If polling enabled, schedule stream creation after user stops scrolling
+            this.schedulePollingStream(requestParams);
+        });
+    }
+    /**
+     * Update pagination params based on paging mode
+     */
+    updatePaginationParams(params, effectivePagingMode) {
+        if (effectivePagingMode === 'viewBased') {
+            if (this.currentSequenceId !== null && this.currentSequenceId >= 0 && this.moreRows) {
+                if (this.pagination) {
+                    this.resourceParams.DETAILS.VIEW_NUMBER = this.getPageNumber(params.request.startRow, this.maxRows, undefined, // Don't pass maxView as totalRecords since it's not a valid total count
+                    this.zeroBasedViewNumber);
+                }
+                else {
+                    this.resourceParams.DETAILS.VIEW_NUMBER += 1;
+                }
+            }
+        }
+        else {
+            // offsetBased
+            if (this.currentNextOffset > 0 && this.currentNextOffset !== params.request.startRow) {
+                this.resourceParams.DETAILS.OFFSET = this.currentNextOffset;
+            }
+            else {
+                this.resourceParams.DETAILS.OFFSET = params.request.startRow;
+            }
+        }
+    }
+    /**
+     * Determine if this is the last view/page
+     */
+    determineIsLastView(requestResult, requestParams, effectivePagingMode) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             const hasMoreRowsInResult = 'MORE_ROWS' in requestResult;
             let isLastView = false;
-            // Fall back to the existing logic for backwards compatibility
             if (effectivePagingMode === 'viewBased') {
-                // Massive limitation on the GSF. It should return -1 if it's already the last view/record (but it doesn't, next will have 0 rows then the NEXT_VIEW=-1).
                 if (hasMoreRowsInResult) {
-                    // Only works with GSF 8.14+
                     isLastView = !requestResult.MORE_ROWS;
                 }
                 else if (requestResult.NEXT_VIEW !== -1) {
@@ -80,7 +107,7 @@ export class ReqRepServerSideDatasource extends BaseServerSideDatasource {
                 }
             }
             else {
-                // offsetBased: check if NEXT_OFFSET exists and is valid
+                // offsetBased
                 isLastView = hasMoreRowsInResult && !requestResult.MORE_ROWS;
                 if ('NEXT_OFFSET' in requestResult && requestResult.NEXT_OFFSET !== -1) {
                     this.currentNextOffset = requestResult.NEXT_OFFSET;
@@ -89,13 +116,21 @@ export class ReqRepServerSideDatasource extends BaseServerSideDatasource {
                     this.currentNextOffset = 0;
                 }
             }
-            let applyResult = true;
-            if (applyResult) {
-                this.applyServerSideData(params, requestResult, isLastView);
-                applyResult = false;
-            }
+            return isLastView;
         });
     }
+    /**
+     * Schedules polling stream creation if enabled.
+     * @remarks
+     * Destroys any existing stream and schedules a new one after the user stops scrolling (debounced).
+     * This prevents excessive stream recreation during rapid scrolling.
+     */
+    schedulePollingStream(requestParams) {
+        if (this.usePolling && this.createReqRepStreamFunc) {
+            this.destroyPollingStream();
+            this.debouncedCreateStream(requestParams);
+        }
+    }
     applyServerSideData(params, result, isLastView) {
         var _a, _b;
         const messageType = result.MESSAGE_TYPE;
@@ -248,15 +283,98 @@ export class ReqRepServerSideDatasource extends BaseServerSideDatasource {
             refreshDatasource: { get: () => super.refreshDatasource }
         });
         return __awaiter(this, void 0, void 0, function* () {
-            // Reset discovered total when refreshing (sorting/filtering changes)
+            this.destroyPollingStream();
+            if (this.debouncedCreateStream) {
+                this.debouncedCreateStream.cancel();
+            }
             this.discoveredTotalRowCount = null;
             this.currentNextOffset = 0;
-            // Reset pagination parameters to start from beginning
             this.resourceParams.DETAILS.VIEW_NUMBER = this.zeroBasedViewNumber ? 0 : 1;
             this.resourceParams.DETAILS.OFFSET = 0;
             yield _super.refreshDatasource.call(this, params);
         });
     }
+    destroy() {
+        const _super = Object.create(null, {
+            destroy: { get: () => super.destroy }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            this.destroyPollingStream();
+            if (this.debouncedCreateStream) {
+                this.debouncedCreateStream.cancel();
+            }
+            yield _super.destroy.call(this);
+        });
+    }
+    /**
+     * Creates a polling stream for the currently loaded data.
+     * @remarks
+     * This method creates a separate datasource instance that polls all currently loaded rows
+     * (from offset 0 to current offset + maxRows). The polling results are sent to the parent
+     * datasource via the `onPollingUpdate` callback for change detection and grid updates.
+     *
+     * The stream will only apply updates if the request params haven't changed (user hasn't
+     * scrolled away or changed filters/sorting).
+     * @param requestParams - The request parameters for the current view
+     */
+    createPollingStream(requestParams) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                this.destroyPollingStream();
+                this.currentStreamParams = requestParams;
+                const { stream, datasource } = yield this.createReqRepStreamFunc(requestParams);
+                this.reqRepPollingStream = stream;
+                this.reqRepPollingDatasource = datasource;
+                this.reqRepPollingSubscription = this.reqRepPollingStream.subscribe({
+                    next: (result) => {
+                        if (this.currentStreamParams &&
+                            JSON.stringify(this.currentStreamParams) === JSON.stringify(requestParams)) {
+                            if (this.onPollingUpdate) {
+                                this.onPollingUpdate(result);
+                            }
+                        }
+                    },
+                    error: (error) => {
+                        var _a;
+                        logger.error('Polling stream error:', error);
+                        if (this.errorHandlerFunc) {
+                            this.errorHandlerFunc(((_a = error === null || error === void 0 ? void 0 : error.receivedMessage) === null || _a === void 0 ? void 0 : _a.ERROR) || (error === null || error === void 0 ? void 0 : error.message), 'stream');
+                        }
+                    },
+                });
+                logger.debug('Polling stream created for params:', requestParams);
+            }
+            catch (error) {
+                logger.error('Failed to create polling stream:', error);
+            }
+        });
+    }
+    /**
+     * Destroys the current polling stream and associated datasource.
+     * @remarks
+     * Cleans up the polling subscription, destroys the separate polling datasource instance,
+     * and resets the previous poll comparison state. Called when:
+     * - User scrolls to a new page
+     * - Filters or sorting changes
+     * - The datasource is being destroyed
+     */
+    destroyPollingStream() {
+        if (this.reqRepPollingSubscription) {
+            this.reqRepPollingSubscription.unsubscribe();
+            this.reqRepPollingSubscription = undefined;
+            logger.debug('Polling subscription destroyed');
+        }
+        if (this.reqRepPollingDatasource) {
+            this.reqRepPollingDatasource.destroy();
+            this.reqRepPollingDatasource = undefined;
+            logger.debug('Polling datasource destroyed');
+        }
+        this.reqRepPollingStream = undefined;
+        this.currentStreamParams = undefined;
+        if (this.resetPreviousPollResult) {
+            this.resetPreviousPollResult();
+        }
+    }
     buildRequestDetails(effectivePagingMode) {
         const baseDetails = {
             CRITERIA_MATCH: this.resourceParams.DETAILS.CRITERIA_MATCH,

package/dist/grid-pro.api.json

@@ -16462,6 +16462,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/grid-pro!GridProServerSideDatasource#pollingDatasource:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "pollingDatasource: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Datasource",
+                  "canonicalReference": "@genesislcap/foundation-comms!Datasource:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "pollingDatasource",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/grid-pro!GridProServerSideDatasource#reloadResourceData:member(1)",
@@ -16646,6 +16677,37 @@
               "isAbstract": false,
               "name": "restart"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/grid-pro!GridProServerSideDatasource#serializer:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serializer: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "JSONSerializer",
+                  "canonicalReference": "@genesislcap/foundation-utils!JSONSerializer:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "serializer",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/grid-pro!GridProServerSideDatasource#zeroBasedViewNumber:member",

package/dist/grid-pro.d.ts

@@ -95,6 +95,7 @@ import { IStatusPanelParams } from 'ag-grid-community';
 import { ITooltipComp } from '@ag-grid-community/core';
 import { ITooltipParams } from '@ag-grid-community/core';
 import { ITooltipParams as ITooltipParams_2 } from 'ag-grid-community';
+import { JSONSerializer } from '@genesislcap/foundation-utils';
 import { KeyCreatorParams } from '@ag-grid-community/core';
 import { KeyCreatorParams as KeyCreatorParams_2 } from 'ag-grid-community';
 import { KVStorage } from '@genesislcap/foundation-comms';
@@ -3760,6 +3761,8 @@ export declare enum GridProRendererTypes {
  * @beta
  */
 export declare class GridProServerSideDatasource extends GridProServerSideDatasource_base {
+    serializer: JSONSerializer;
+    pollingDatasource: Datasource;
     /**
      * The starting VIEW_NUMBER of the data to be fetched.
      * @remarks The VIEW_NUMBER isincremented by the grid as the user scrolls or changes pages.
@@ -3811,6 +3814,49 @@ export declare class GridProServerSideDatasource extends GridProServerSideDataso
     private clearRowData;
     private getResourceIndexes;
     private createReqRepRequest;
+    /**
+     * Creates a polling stream for REQUEST_SERVER resources.
+     * @remarks
+     * Creates a separate `Datasource` instance configured to poll all currently loaded rows
+     * (from offset 0 to current offset + maxRows). This enables change detection across all
+     * loaded data, not just the current page.
+     *
+     * The separate datasource instance has built-in polling logic (pollingInterval, pollTriggerEvents)
+     * and manages its own lifecycle independently of the snapshot datasource.
+     * @param existingParams - The current request parameters (includes OFFSET, MAX_ROWS, etc.)
+     * @returns Object containing the polling stream and the datasource instance
+     * @internal
+     */
+    private createReqRepStream;
+    /**
+     * Stores the previous poll result for comparison (poll N vs poll N-1).
+     * @remarks
+     * This enables efficient change detection by comparing consecutive polls instead of
+     * maintaining the entire dataset in memory. Only stores the last poll result.
+     * @internal
+     */
+    private previousPollResult;
+    /**
+     * Resets the previous poll result comparison state.
+     * @remarks
+     * Called when the polling stream is destroyed or recreated with new parameters
+     * (e.g., user scrolls to a different page, or filters/sorting changes).
+     * @internal
+     */
+    resetPreviousPollResult(): void;
+    /**
+     * Applies polling updates for REQUEST_SERVER resources in SSRM.
+     * @remarks
+     * Compares the current poll result (poll N) with the previous poll result (poll N-1)
+     * to detect inserts, updates, and deletes. Changes are applied to the grid using
+     * `applyServerSideTransaction` to avoid interfering with SSRM's cache management.
+     *
+     * The first poll is stored without applying changes (nothing to compare yet).
+     * Subsequent polls are compared to detect changes efficiently.
+     * @param result - The polling result from the REQUEST_SERVER resource
+     * @internal
+     */
+    private applyReqRepPollingUpdate;
     private createDataserverStream;
     private getAgColumnDefs;
     applyTransaction(transaction: any): any;

package/docs/api/grid-pro.gridproserversidedatasource.md

@@ -82,6 +82,25 @@ boolean
 **_(BETA)_** The paging mode to use for data fetching.
 
 
+</td></tr>
+<tr><td>
+
+[pollingDatasource](./grid-pro.gridproserversidedatasource.pollingdatasource.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Datasource
+
+
+</td><td>
+
+**_(BETA)_**
+
+
 </td></tr>
 <tr><td>
 
@@ -101,6 +120,25 @@ any
 **_(BETA)_**
 
 
+</td></tr>
+<tr><td>
+
+[serializer](./grid-pro.gridproserversidedatasource.serializer.md)
+
+
+</td><td>
+
+
+</td><td>
+
+JSONSerializer
+
+
+</td><td>
+
+**_(BETA)_**
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/grid-pro.gridproserversidedatasource.pollingdatasource.md

@@ -0,0 +1,14 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [GridProServerSideDatasource](./grid-pro.gridproserversidedatasource.md) &gt; [pollingDatasource](./grid-pro.gridproserversidedatasource.pollingdatasource.md)
+
+## GridProServerSideDatasource.pollingDatasource property
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+> 
+
+**Signature:**
+
+```typescript
+pollingDatasource: Datasource;
+```

package/docs/api/grid-pro.gridproserversidedatasource.serializer.md

@@ -0,0 +1,14 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [GridProServerSideDatasource](./grid-pro.gridproserversidedatasource.md) &gt; [serializer](./grid-pro.gridproserversidedatasource.serializer.md)
+
+## GridProServerSideDatasource.serializer property
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+> 
+
+**Signature:**
+
+```typescript
+serializer: JSONSerializer;
+```

package/docs/api-report.md.api.md

@@ -101,6 +101,7 @@ import { IStatusPanelParams } from 'ag-grid-community';
 import { ITooltipComp } from '@ag-grid-community/core';
 import { ITooltipParams } from '@ag-grid-community/core';
 import { ITooltipParams as ITooltipParams_2 } from 'ag-grid-community';
+import { JSONSerializer } from '@genesislcap/foundation-utils';
 import { KeyCreatorParams } from '@ag-grid-community/core';
 import { KeyCreatorParams as KeyCreatorParams_2 } from 'ag-grid-community';
 import { KVStorage } from '@genesislcap/foundation-comms';
@@ -1393,13 +1394,19 @@ export class GridProServerSideDatasource extends GridProServerSideDatasource_bas
     // (undocumented)
     onPaginationChanged(event: any): void;
     pagingMode: PagingMode | undefined;
+    // (undocumented)
+    pollingDatasource: Datasource;
     reloadResourceData(params?: DatasourceOptions): Promise<void>;
     // (undocumented)
     request: any;
+    // @internal
+    resetPreviousPollResult(): void;
     // (undocumented)
     resourceNameChanged(oldValue: string, newValue: string): void;
     // (undocumented)
     restart(): Promise<void>;
+    // (undocumented)
+    serializer: JSONSerializer;
     zeroBasedViewNumber: boolean;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/grid-pro",
   "description": "Genesis Foundation AG Grid",
-  "version": "14.358.0",
+  "version": "14.360.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -38,19 +38,19 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.358.0",
-    "@genesislcap/genx": "14.358.0",
-    "@genesislcap/rollup-builder": "14.358.0",
-    "@genesislcap/ts-builder": "14.358.0",
-    "@genesislcap/uvu-playwright-builder": "14.358.0",
-    "@genesislcap/vite-builder": "14.358.0",
-    "@genesislcap/webpack-builder": "14.358.0"
+    "@genesislcap/foundation-testing": "14.360.0",
+    "@genesislcap/genx": "14.360.0",
+    "@genesislcap/rollup-builder": "14.360.0",
+    "@genesislcap/ts-builder": "14.360.0",
+    "@genesislcap/uvu-playwright-builder": "14.360.0",
+    "@genesislcap/vite-builder": "14.360.0",
+    "@genesislcap/webpack-builder": "14.360.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.358.0",
-    "@genesislcap/foundation-logger": "14.358.0",
-    "@genesislcap/foundation-ui": "14.358.0",
-    "@genesislcap/foundation-utils": "14.358.0",
+    "@genesislcap/foundation-comms": "14.360.0",
+    "@genesislcap/foundation-logger": "14.360.0",
+    "@genesislcap/foundation-ui": "14.360.0",
+    "@genesislcap/foundation-utils": "14.360.0",
     "@microsoft/fast-colors": "5.3.1",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
@@ -77,5 +77,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "7aee2c72c154451a9da8c25bcaaa25f2e44ba9ef"
+  "gitHead": "5864d7cbaaefef81025068e4025c4d2be89054dd"
 }