@kernl-sdk/pg 0.1.24 → 0.1.26

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @kernl-sdk/pg@0.1.24 build /home/runner/work/kernl/kernl/packages/storage/pg
+> @kernl-sdk/pg@0.1.26 build /home/runner/work/kernl/kernl/packages/storage/pg
 > tsc && tsc-alias --resolve-full-paths
 

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @kernl/pg
 
+## 0.1.26
+
+### Patch Changes
+
+- Updated dependencies [f593374]
+  - kernl@0.10.0
+  - @kernl-sdk/storage@0.1.26
+  - @kernl-sdk/retrieval@0.1.6
+
+## 0.1.25
+
+### Patch Changes
+
+- Updated dependencies [25e46e7]
+  - kernl@0.9.1
+  - @kernl-sdk/shared@0.3.1
+  - @kernl-sdk/storage@0.1.25
+  - @kernl-sdk/retrieval@0.1.5
+
 ## 0.1.24
 
 ### Patch Changes

package/dist/__tests__/memory-integration.test.js

@@ -157,7 +157,7 @@ describe.sequential("Memory Integration with PGVector", { timeout: 30000 }, () =
         expect(results.length).toBe(1);
         expect(results[0].document?.id).toBe("m1");
     });
-    it("respects topK limit", async () => {
+    it("respects limit", async () => {
         await kernl.memories.create({
             id: "m1",
             scope: { namespace: "test" },

package/dist/pgvector/__tests__/handle.test.js

@@ -107,7 +107,7 @@ describe.sequential("PGIndexHandle", () => {
             const handle = search.index("docs");
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
-                topK: 2,
+                limit: 2,
             });
             expect(results).toHaveLength(2);
             expect(results[0].id).toBe("doc1"); // closest match
@@ -120,7 +120,7 @@ describe.sequential("PGIndexHandle", () => {
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
                 filter: { status: "active" },
-                topK: 10,
+                limit: 10,
             });
             expect(results).toHaveLength(2);
             results.forEach((r) => {
@@ -133,7 +133,7 @@ describe.sequential("PGIndexHandle", () => {
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
                 filter: { views: { $gte: 100 } },
-                topK: 10,
+                limit: 10,
             });
             expect(results.length).toBeGreaterThanOrEqual(2);
             results.forEach((r) => {
@@ -148,7 +148,7 @@ describe.sequential("PGIndexHandle", () => {
                 filter: {
                     $or: [{ status: "draft" }, { status: "archived" }],
                 },
-                topK: 10,
+                limit: 10,
             });
             expect(results).toHaveLength(2);
             results.forEach((r) => {
@@ -161,16 +161,16 @@ describe.sequential("PGIndexHandle", () => {
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
                 filter: { status: { $in: ["active", "draft"] } },
-                topK: 10,
+                limit: 10,
             });
             expect(results).toHaveLength(3);
         });
-        it("respects topK limit", async () => {
+        it("respects limit", async () => {
             await insertDocs();
             const handle = search.index("docs");
             const results = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5] }],
-                topK: 2,
+                limit: 2,
             });
             expect(results).toHaveLength(2);
         });
@@ -180,13 +180,13 @@ describe.sequential("PGIndexHandle", () => {
             // Get first 2
             const page1 = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5] }],
-                topK: 2,
+                limit: 2,
                 offset: 0,
             });
             // Get next 2
             const page2 = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5] }],
-                topK: 2,
+                limit: 2,
                 offset: 2,
             });
             expect(page1).toHaveLength(2);
@@ -199,7 +199,7 @@ describe.sequential("PGIndexHandle", () => {
             const results = await handle.query({
                 filter: { status: "active" },
                 orderBy: { field: "views", direction: "desc" },
-                topK: 10,
+                limit: 10,
             });
             expect(results).toHaveLength(2);
             expect(results[0].document?.views).toBe(200);
@@ -210,7 +210,7 @@ describe.sequential("PGIndexHandle", () => {
             const handle = search.index("docs");
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
-                topK: 1,
+                limit: 1,
             });
             expect(results[0].document).toHaveProperty("title");
             expect(results[0].document).toHaveProperty("content");
@@ -224,7 +224,7 @@ describe.sequential("PGIndexHandle", () => {
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
                 filter: { status: "nonexistent" },
-                topK: 10,
+                limit: 10,
             });
             expect(results).toEqual([]);
         });
@@ -258,7 +258,7 @@ describe.sequential("PGIndexHandle", () => {
             const handle = search.index("typed-docs");
             const results = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3] }],
-                topK: 1,
+                limit: 1,
             });
             // TypeScript should allow these without errors
             const doc = results[0].document;

package/dist/pgvector/__tests__/integration/document.integration.test.js

@@ -64,7 +64,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             // Verify document was inserted
             const hits = await handle.query({
                 query: [{ embedding: [0.1, 0.2, 0.3, 0.4] }],
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].id).toBe("doc-1");
@@ -126,7 +126,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             // Verify update
             const hits = await handle.query({
                 filter: { id: "doc-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Updated Title");
             expect(hits[0].document?.views).toBe(100);
@@ -195,7 +195,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             // Verify count
             const hits = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-                topK: 1000,
+                limit: 1000,
             });
             expect(hits).toHaveLength(100);
         });
@@ -211,7 +211,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "vec-test" },
-                topK: 1,
+                limit: 1,
             });
             // Vector values should be preserved (within floating point precision)
             const stored = hits[0].document?.embedding;
@@ -240,7 +240,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await nullHandle.query({
                 filter: { id: "doc-null" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Has Title");
             expect(hits[0].document?.subtitle).toBeNull();
@@ -279,7 +279,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             expect(result.count).toBe(1);
             const hits = await handle.query({
                 filter: { id: "patch-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Updated Title");
             expect(hits[0].document?.content).toBe("Original Content 1"); // unchanged
@@ -295,7 +295,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             expect(result.count).toBe(1);
             const hits = await handle.query({
                 filter: { id: "patch-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("New Title");
             expect(hits[0].document?.views).toBe(999);
@@ -310,7 +310,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "patch-1" },
-                topK: 1,
+                limit: 1,
             });
             const stored = hits[0].document?.embedding;
             expect(stored?.[0]).toBeCloseTo(0.9, 5);
@@ -323,7 +323,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             expect(result.count).toBe(2);
             const hits = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-                topK: 10,
+                limit: 10,
             });
             const doc1 = hits.find((h) => h.id === "patch-1");
             const doc2 = hits.find((h) => h.id === "patch-2");
@@ -355,7 +355,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await nullHandle.query({
                 filter: { id: "doc-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.subtitle).toBeNull();
         });
@@ -378,7 +378,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "patch-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Updated");
             expect(hits[0].document?.content).toBe("Original Content 1"); // unchanged
@@ -430,7 +430,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             // Verify deletion
             const hits = await handle.query({
                 filter: { id: "del-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(0);
         });
@@ -440,7 +440,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             // Verify only del-3 remains
             const hits = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-                topK: 10,
+                limit: 10,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].id).toBe("del-3");
@@ -462,7 +462,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             await handle.delete(["del-1", "del-2", "del-3"]);
             const hits = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-                topK: 10,
+                limit: 10,
             });
             expect(hits).toHaveLength(0);
         });
@@ -482,7 +482,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { views: 0 },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.views).toBe(0);
@@ -498,7 +498,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { views: -50 },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.views).toBe(-50);
@@ -524,11 +524,11 @@ describe.sequential("pgvector document operations integration tests", () => {
             ]);
             const trueHits = await handle.query({
                 filter: { published: true },
-                topK: 10,
+                limit: 10,
             });
             const falseHits = await handle.query({
                 filter: { published: false },
-                topK: 10,
+                limit: 10,
             });
             expect(trueHits).toHaveLength(1);
             expect(trueHits[0].id).toBe("bool-true");
@@ -546,7 +546,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { title: "" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.title).toBe("");
@@ -562,7 +562,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "unicode-test" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Hello 世界 🌍");
             expect(hits[0].document?.content).toBe("Привет мир");
@@ -579,7 +579,7 @@ describe.sequential("pgvector document operations integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "long-string" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.content).toBe(longString);
         });

package/dist/pgvector/__tests__/integration/edge.integration.test.js

@@ -58,7 +58,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             // Table should still exist and be queryable
             const hits = await handle.query({
                 filter: { id: "injection-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.title).toBe("'; DROP TABLE string_edge; --");
@@ -72,7 +72,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { title: "'; DROP TABLE string_edge; --" },
-                topK: 10,
+                limit: 10,
             });
             // Should return no results, not crash
             expect(hits).toHaveLength(0);
@@ -86,7 +86,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "quotes" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe('He said "Hello"');
             expect(hits[0].document?.content).toBe("It's a test");
@@ -100,7 +100,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "backslash" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Path\\to\\file");
         });
@@ -113,7 +113,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "whitespace" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toBe("Line1\nLine2");
             expect(hits[0].document?.content).toBe("Col1\tCol2\tCol3");
@@ -145,7 +145,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "unicode-edge-2" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
         });
@@ -159,7 +159,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "long" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.title).toHaveLength(100000);
         });
@@ -173,7 +173,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             // Should not interpret % and _ as wildcards
             const hits = await handle.query({
                 filter: { title: { $contains: "100%" } },
-                topK: 10,
+                limit: 10,
             });
             expect(hits).toHaveLength(1);
         });
@@ -208,7 +208,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { int_val: 0 },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.int_val).toBe(0);
@@ -222,7 +222,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { int_val: { $lt: 0 } },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.int_val).toBe(-999);
@@ -237,7 +237,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { int_val: 2147483647 },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.int_val).toBe(2147483647);
@@ -251,7 +251,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "precise" },
-                topK: 1,
+                limit: 1,
             });
             // Double precision maintains about 15 significant digits
             expect(hits[0].document?.float_val).toBeCloseTo(0.123456789012345, 10);
@@ -267,7 +267,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "extreme-float" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.float_val).toBe(1e308);
         });
@@ -300,7 +300,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             // pgvector returns NaN for cosine of zero vectors
             const hits = await handle.query({
                 filter: { id: "zero-vec" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
         });
@@ -311,7 +311,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 query: [{ embedding: [-1, -0.5, 0.5, 1] }],
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe("negative-vec");
             expect(hits[0].score).toBeGreaterThan(0.99);
@@ -323,7 +323,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "small-vec" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
         });
@@ -334,7 +334,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 query: [{ embedding: [1e10, 1e10, 1e10, 1e10] }],
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe("large-vec");
         });
@@ -358,7 +358,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             await highHandle.upsert({ id: "high-1", embedding: vec });
             const hits = await highHandle.query({
                 query: [{ embedding: vec }],
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe("high-1");
             expect(hits[0].score).toBeGreaterThan(0.99);
@@ -394,7 +394,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { optional_field: null },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             expect(hits[0].document?.optional_field).toBeNull();
@@ -416,11 +416,11 @@ describe.sequential("pgvector edge cases integration tests", () => {
             ]);
             const existsTrue = await handle.query({
                 filter: { optional_field: { $exists: true } },
-                topK: 10,
+                limit: 10,
             });
             const existsFalse = await handle.query({
                 filter: { optional_field: { $exists: false } },
-                topK: 10,
+                limit: 10,
             });
             expect(existsTrue).toHaveLength(1);
             expect(existsTrue[0].id).toBe("has-value");
@@ -440,7 +440,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "patch-null" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].document?.optional_field).toBeNull();
         });
@@ -474,7 +474,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: uuid },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe(uuid);
         });
@@ -487,7 +487,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: longId },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe(longId);
         });
@@ -500,7 +500,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: specialId },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe(specialId);
         });
@@ -512,7 +512,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             });
             const hits = await handle.query({
                 filter: { id: "12345" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits[0].id).toBe("12345");
         });
@@ -525,7 +525,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             const badHandle = pgvec.index("nonexistent_table");
             await expect(badHandle.query({
                 query: [{ embedding: [0.1, 0.1, 0.1, 0.1] }],
-                topK: 10,
+                limit: 10,
             })).rejects.toThrow();
         });
         it("throws on non-existent column in filter", async () => {
@@ -541,7 +541,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             const handle = pgvec.index("error_test");
             await expect(handle.query({
                 filter: { nonexistent_column: "value" },
-                topK: 10,
+                limit: 10,
             })).rejects.toThrow();
         });
         it("throws on deleteIndex for non-bound index", async () => {
@@ -598,7 +598,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             // Should have completed without errors
             const hits = await handle.query({
                 filter: { id: "concurrent-1" },
-                topK: 1,
+                limit: 1,
             });
             expect(hits).toHaveLength(1);
             // Counter should be one of the values
@@ -613,11 +613,11 @@ describe.sequential("pgvector edge cases integration tests", () => {
             }));
             await Promise.all(upserts);
             // Increase ef_search to allow HNSW to explore more candidates
-            // Default is 40, which limits results to ~40 even with topK=100
+            // Default is 40, which limits results to ~40 even with limit=100
             await pool.query("SET hnsw.ef_search = 200");
             const hits = await handle.query({
                 query: [{ embedding: [0.5, 0.5, 0.5, 0.5] }],
-                topK: 100,
+                limit: 100,
             });
             expect(hits).toHaveLength(50);
         });
@@ -631,7 +631,7 @@ describe.sequential("pgvector edge cases integration tests", () => {
             // Query while upserting
             const queryPromise = handle.query({
                 query: [{ embedding: [0.1, 0.1, 0.1, 0.1] }],
-                topK: 1000,
+                limit: 1000,
             });
             const [, hits] = await Promise.all([upsertPromise, queryPromise]);
             // Query should succeed (may see partial or full results)

package/dist/pgvector/__tests__/integration/filters.integration.test.js

@@ -153,7 +153,7 @@ describe.sequential("pgvector filter integration tests", () => {
     async function queryIds(filter) {
         const hits = await handle.query({
             query: [{ embedding: QUERY_VECTOR }],
-            topK: 100,
+            limit: 100,
             filter,
         });
         return hits.map((h) => h.id).sort();
@@ -520,7 +520,7 @@ describe.sequential("pgvector filter integration tests", () => {
         it("filtered results have correct field values", async () => {
             const hits = await handle.query({
                 query: [{ embedding: QUERY_VECTOR }],
-                topK: 100,
+                limit: 100,
                 filter: { status: "pending" },
             });
             expect(hits.length).toBe(3);
@@ -535,7 +535,7 @@ describe.sequential("pgvector filter integration tests", () => {
         it("complex filter returns expected documents with correct data", async () => {
             const hits = await handle.query({
                 query: [{ embedding: QUERY_VECTOR }],
-                topK: 100,
+                limit: 100,
                 filter: {
                     $and: [{ num: { $gte: 20, $lte: 50 } }, { flag: true }],
                 },
@@ -549,10 +549,10 @@ describe.sequential("pgvector filter integration tests", () => {
                 expect(hit.document?.num).toBeLessThanOrEqual(50);
             }
         });
-        it("combining filter + topK limits correctly", async () => {
+        it("combining filter + limit limits correctly", async () => {
             const hits = await handle.query({
                 query: [{ embedding: QUERY_VECTOR }],
-                topK: 2,
+                limit: 2,
                 filter: { status: "active" },
             });
             expect(hits.length).toBe(2);