@memberjunction/ai-vectors 5.33.0 → 5.34.0

package/README.md

@@ -20,7 +20,7 @@ npm install @memberjunction/ai-vectors
 | `IVectorIndex` | Interface | Contract for CRUD operations on vector records within an index |
 | `ChunkTextParams` | Type | Configuration for `TextChunker.ChunkText()` |
 | `TextChunk` | Type | Output chunk with text, offsets, token count, and index |
-| `PageRecordsParams` | Type | Paginated entity record retrieval configuration |
+| `PageRecordsParams` | Type | Paginated entity record retrieval configuration. Supports both OFFSET-based pagination (`PageNumber`) and keyset/seek pagination (`AfterKey`) — see [KEYSET_PAGINATION_GUIDE.md](../../../../guides/KEYSET_PAGINATION_GUIDE.md). |
 
 ## Architecture
 
@@ -320,9 +320,47 @@ export class MyVectorProcessor extends VectorBase {
             page++;
         }
     }
+
+    // Preferred for deep iteration: keyset (seek) pagination via AfterKey.
+    // O(log N) per page regardless of depth — `PageNumber`-based OFFSET pagination
+    // gets progressively slower as pages climb into the thousands.
+    async ProcessInKeysetPages(entityId: string): Promise<void> {
+        // Check upfront — falls back to PageNumber path if the entity has a composite PK.
+        if (!this.CanUseKeysetPagination(entityId)) {
+            // ... use the PageNumber loop above
+            return;
+        }
+        const entity = this.Metadata.Entities.find(e => e.ID === entityId)!;
+        const pkField = entity.FirstPrimaryKey!;
+
+        let lastSeenKey: CompositeKey | undefined; // undefined => first page
+        while (true) {
+            const records = await this.PageRecordsByEntityID<Record<string, unknown>>({
+                EntityID: entityId,
+                PageNumber: 0, // ignored when AfterKey is set
+                PageSize: 500,
+                ResultType: 'simple',
+                Filter: "Status = 'Active'",
+                AfterKey: lastSeenKey,
+            });
+            if (records.length === 0) break;
+            for (const r of records) { /* process */ }
+            if (records.length < 500) break;
+            lastSeenKey = CompositeKey.FromKeyValuePair(pkField.Name, records[records.length - 1][pkField.Name]);
+        }
+    }
 }
 ```
 
+### Keyset Pagination Helpers
+
+`VectorBase` exposes two helpers for keyset (seek) pagination:
+
+- **`PageRecordsParams.AfterKey?: CompositeKey`** — optional cursor that switches `PageRecordsByEntityID` from OFFSET (`PageNumber`) mode to keyset mode. When set, the query uses `WHERE pk > @lastSeen ORDER BY pk LIMIT N` and stays O(log N) per page.
+- **`CanUseKeysetPagination(entityID)`** — returns true if the entity has a single-column PK on an orderable type (i.e. it's safe to pass `AfterKey`). Use it to choose between the keyset and OFFSET paths.
+
+See **[KEYSET_PAGINATION_GUIDE.md](../../../../guides/KEYSET_PAGINATION_GUIDE.md)** for the full pattern, constraints (composite-PK entities throw `AfterKeyNotSupportedError`), and reference implementations across the framework.
+
 ### Filtering with Composite Keys
 
 ```typescript

package/dist/generic/VectorCore.types.d.ts

@@ -1,10 +1,15 @@
+import type { CompositeKey } from '@memberjunction/core';
 export type PageRecordsParams = {
     /**
      * The ID of the entitiy to get the records from
      */
     EntityID: string | number;
     /**
-     * Number of records to offset. This number will be multiplied by the PageSize to get the actual offset
+     * OFFSET-mode pagination cursor — multiplied by PageSize to compute SQL OFFSET.
+     *
+     * Ignored when `AfterKey` is provided (keyset mode). For deep iteration over large
+     * entities, prefer the keyset form — pass an undefined `AfterKey` on the first call,
+     * then pass the PK of the last record returned on each subsequent call.
      */
     PageNumber: number;
     /**
@@ -19,5 +24,16 @@ export type PageRecordsParams = {
      * Filter to apply to the query
      */
     Filter?: string;
+    /**
+     * Keyset (seek) pagination cursor — when present, the query returns records ordered
+     * by the entity's single-column PK with `WHERE pk > @lastSeen`. Keep each page O(log N)
+     * regardless of how deep you go. Requires a single-column PK on the target entity.
+     *
+     * Pass `undefined` (or omit) to fetch the first page. On subsequent calls, pass a
+     * CompositeKey containing the PK column name and the last returned record's PK value.
+     *
+     * See `guides/KEYSET_PAGINATION_GUIDE.md` for the full pattern.
+     */
+    AfterKey?: CompositeKey;
 };
 //# sourceMappingURL=VectorCore.types.d.ts.map

package/dist/generic/VectorCore.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VectorCore.types.d.ts","sourceRoot":"","sources":["../../src/generic/VectorCore.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,eAAe,GAAG,QAAQ,GAAG,YAAY,CAAC;IACtD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}
+{"version":3,"file":"VectorCore.types.d.ts","sourceRoot":"","sources":["../../src/generic/VectorCore.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,eAAe,GAAG,QAAQ,GAAG,YAAY,CAAC;IACtD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CAC3B,CAAC"}

package/dist/models/VectorBase.d.ts

@@ -21,6 +21,12 @@ export declare class VectorBase {
     set Provider(value: IMetadataProvider | null);
     protected GetRecordsByEntityID(entityID: string, recordIDs?: CompositeKey[]): Promise<BaseEntity[]>;
     protected PageRecordsByEntityID<T>(params: PageRecordsParams): Promise<T[]>;
+    /**
+     * Returns true when {@link PageRecordsByEntityID} can serve the given entity via
+     * keyset (seek) pagination — i.e. the entity has a single-column PK on a comparable
+     * type. Callers iterating large tables should consult this and pass `AfterKey` when true.
+     */
+    protected CanUseKeysetPagination(entityID: string | number): boolean;
     /**
      * Builds a SQL filter from composite keys. Values are sanitized to prevent SQL injection.
      */

package/dist/models/VectorBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VectorBase.d.ts","sourceRoot":"","sources":["../../src/models/VectorBase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAuC,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAAa,UAAU;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,QAAQ,CAAC;IACvB,OAAO,CAAC,SAAS,CAAkC;;IAQnD,IAAW,QAAQ,IAAI,QAAQ,CAA2B;IAC1D,IAAW,OAAO,IAAI,OAAO,CAA0B;IACvD,IAAW,WAAW,IAAI,QAAQ,CAA8B;IAChE,IAAW,WAAW,CAAC,IAAI,EAAE,QAAQ,EAA+B;IAEpE;;;;OAIG;IACH,IAAW,QAAQ,IAAI,iBAAiB,CAEvC;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAElD;cAEe,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;cAqBzF,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqBjF;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM;IASjE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,uBAAuB;IAe1D,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,sBAAsB;cAgBhD,qBAAqB,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBvH;;;QAGI;cACY,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;CAInE"}
+{"version":3,"file":"VectorBase.d.ts","sourceRoot":"","sources":["../../src/models/VectorBase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAuC,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAAa,UAAU;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,QAAQ,CAAC;IACvB,OAAO,CAAC,SAAS,CAAkC;;IAQnD,IAAW,QAAQ,IAAI,QAAQ,CAA2B;IAC1D,IAAW,OAAO,IAAI,OAAO,CAA0B;IACvD,IAAW,WAAW,IAAI,QAAQ,CAA8B;IAChE,IAAW,WAAW,CAAC,IAAI,EAAE,QAAQ,EAA+B;IAEpE;;;;OAIG;IACH,IAAW,QAAQ,IAAI,iBAAiB,CAEvC;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAElD;cAEe,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;cAqBzF,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA4BjF;;;;OAIG;IACH,SAAS,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAcpE;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM;IASjE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,uBAAuB;IAe1D,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,sBAAsB;cAgBhD,qBAAqB,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBvH;;;QAGI;cACY,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;CAInE"}

package/dist/models/VectorBase.js

@@ -45,11 +45,17 @@ export class VectorBase {
         if (!entity) {
             throw new Error(`Entity with ID ${params.EntityID} not found.`);
         }
+        // Prefer keyset (seek) pagination when the caller provides AfterKey.
+        // The framework will throw AfterKeyNotSupportedError if the entity has a composite
+        // PK — callers iterating those entities must use the PageNumber path.
+        const useKeyset = !!params.AfterKey;
         const rvResult = await this._runView.RunView({
             EntityName: entity.Name,
             ResultType: params.ResultType,
             MaxRows: params.PageSize,
-            StartRow: Math.max(0, (params.PageNumber - 1) * params.PageSize),
+            ...(useKeyset
+                ? { AfterKey: params.AfterKey, OrderBy: entity.FirstPrimaryKey.Name }
+                : { StartRow: Math.max(0, (params.PageNumber - 1) * params.PageSize) }),
             ExtraFilter: params.Filter
         }, this.CurrentUser);
         if (!rvResult.Success) {
@@ -57,6 +63,26 @@ export class VectorBase {
         }
         return rvResult.Results;
     }
+    /**
+     * Returns true when {@link PageRecordsByEntityID} can serve the given entity via
+     * keyset (seek) pagination — i.e. the entity has a single-column PK on a comparable
+     * type. Callers iterating large tables should consult this and pass `AfterKey` when true.
+     */
+    CanUseKeysetPagination(entityID) {
+        const entity = this.Metadata.Entities.find(e => UUIDsEqual(e.ID, entityID));
+        if (!entity || !entity.FirstPrimaryKey)
+            return false;
+        if (entity.PrimaryKeys.length !== 1)
+            return false;
+        // Inline allowlist check (avoid pulling in the helper here)
+        const t = (entity.FirstPrimaryKey.Type || '').replace(/\s*\([^)]*\)\s*$/, '').trim().toLowerCase();
+        // Same set as KEYSET_PAGINATION_ORDERABLE_PK_TYPES in @memberjunction/core
+        return ['uniqueidentifier', 'uuid', 'int', 'bigint', 'smallint', 'tinyint', 'decimal', 'numeric', 'money', 'smallmoney',
+            'float', 'real', 'double precision', 'char', 'varchar', 'nchar', 'nvarchar', 'text', 'ntext',
+            'date', 'datetime', 'datetime2', 'datetimeoffset', 'smalldatetime', 'time', 'bit',
+            'integer', 'bigserial', 'serial', 'character varying', 'character', 'timestamp',
+            'timestamp with time zone', 'timestamp without time zone', 'boolean'].includes(t);
+    }
     /**
      * Builds a SQL filter from composite keys. Values are sanitized to prevent SQL injection.
      */

package/dist/models/VectorBase.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-vectors",
   "type": "module",
-  "version": "5.33.0",
+  "version": "5.34.0",
   "description": "MemberJunction: AI Vectors Module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,13 +17,13 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/core": "5.33.0",
-    "@memberjunction/global": "5.33.0",
-    "@memberjunction/core-entities": "5.33.0",
-    "@memberjunction/aiengine": "5.33.0",
-    "@memberjunction/ai": "5.33.0",
-    "@memberjunction/ai-core-plus": "5.33.0",
-    "@memberjunction/ai-vectordb": "5.33.0",
+    "@memberjunction/core": "5.34.0",
+    "@memberjunction/global": "5.34.0",
+    "@memberjunction/core-entities": "5.34.0",
+    "@memberjunction/aiengine": "5.34.0",
+    "@memberjunction/ai": "5.34.0",
+    "@memberjunction/ai-core-plus": "5.34.0",
+    "@memberjunction/ai-vectordb": "5.34.0",
     "dotenv": "^17.2.4",
     "openai": "^6.18.0"
   },