@webda/ql 4.0.0-beta.6 → 4.0.0-beta.8

package/lib/completion.spec.js

@@ -0,0 +1,409 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { suite, test } from "@webda/test";
+import * as assert from "assert";
+import { getCompletions, fieldsFromSchema } from "./completion.js";
+const TEST_FIELDS = [
+    { name: "status", type: "string", enum: ["open", "closed"] },
+    { name: "priority", type: "integer" },
+    { name: "done", type: "boolean" },
+    { name: "profile.email", type: "string" }
+];
+/**
+ * Helper that takes a query string containing '|' as caret marker,
+ * runs getCompletions, and returns the result.
+ */
+function complete(markedQuery, options = { fields: TEST_FIELDS }) {
+    const caret = markedQuery.indexOf("|");
+    if (caret === -1) {
+        throw new Error(`Test query must contain '|' to mark caret: "${markedQuery}"`);
+    }
+    const cleanQuery = markedQuery.slice(0, caret) + markedQuery.slice(caret + 1);
+    return getCompletions(cleanQuery, caret, options);
+}
+let CompletionTest = (() => {
+    let _classDecorators = [suite];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _instanceExtraInitializers = [];
+    let _caretAtStart_decorators;
+    let _partialIdentifier_decorators;
+    let _afterIdentifier_decorators;
+    let _afterComparisonOnEnumField_decorators;
+    let _afterComparisonOnBooleanField_decorators;
+    let _afterCompleteComparison_decorators;
+    let _afterCompleteComparisonWithPrefix_decorators;
+    let _afterOrderByField_decorators;
+    let _afterSelect_decorators;
+    let _afterSelectCountStar_decorators;
+    let _afterUpdate_decorators;
+    let _afterUpdateSet_decorators;
+    let _dottedPathPrefix_decorators;
+    let _insideStringLiteral_decorators;
+    let _insideUnclosedStringLiteral_decorators;
+    let _afterLimit_decorators;
+    let _syntaxErrorAndCaretBoundsNoThrow_decorators;
+    let _noFieldsOption_decorators;
+    let _namedParameters_decorators;
+    let _candidateLimit_decorators;
+    let _fieldsFromSchema_decorators;
+    let _performanceCheck_decorators;
+    var CompletionTest = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _caretAtStart_decorators = [test];
+            _partialIdentifier_decorators = [test];
+            _afterIdentifier_decorators = [test];
+            _afterComparisonOnEnumField_decorators = [test];
+            _afterComparisonOnBooleanField_decorators = [test];
+            _afterCompleteComparison_decorators = [test];
+            _afterCompleteComparisonWithPrefix_decorators = [test];
+            _afterOrderByField_decorators = [test];
+            _afterSelect_decorators = [test];
+            _afterSelectCountStar_decorators = [test];
+            _afterUpdate_decorators = [test];
+            _afterUpdateSet_decorators = [test];
+            _dottedPathPrefix_decorators = [test];
+            _insideStringLiteral_decorators = [test];
+            _insideUnclosedStringLiteral_decorators = [test];
+            _afterLimit_decorators = [test];
+            _syntaxErrorAndCaretBoundsNoThrow_decorators = [test];
+            _noFieldsOption_decorators = [test];
+            _namedParameters_decorators = [test];
+            _candidateLimit_decorators = [test];
+            _fieldsFromSchema_decorators = [test];
+            _performanceCheck_decorators = [test];
+            __esDecorate(this, null, _caretAtStart_decorators, { kind: "method", name: "caretAtStart", static: false, private: false, access: { has: obj => "caretAtStart" in obj, get: obj => obj.caretAtStart }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _partialIdentifier_decorators, { kind: "method", name: "partialIdentifier", static: false, private: false, access: { has: obj => "partialIdentifier" in obj, get: obj => obj.partialIdentifier }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterIdentifier_decorators, { kind: "method", name: "afterIdentifier", static: false, private: false, access: { has: obj => "afterIdentifier" in obj, get: obj => obj.afterIdentifier }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterComparisonOnEnumField_decorators, { kind: "method", name: "afterComparisonOnEnumField", static: false, private: false, access: { has: obj => "afterComparisonOnEnumField" in obj, get: obj => obj.afterComparisonOnEnumField }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterComparisonOnBooleanField_decorators, { kind: "method", name: "afterComparisonOnBooleanField", static: false, private: false, access: { has: obj => "afterComparisonOnBooleanField" in obj, get: obj => obj.afterComparisonOnBooleanField }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterCompleteComparison_decorators, { kind: "method", name: "afterCompleteComparison", static: false, private: false, access: { has: obj => "afterCompleteComparison" in obj, get: obj => obj.afterCompleteComparison }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterCompleteComparisonWithPrefix_decorators, { kind: "method", name: "afterCompleteComparisonWithPrefix", static: false, private: false, access: { has: obj => "afterCompleteComparisonWithPrefix" in obj, get: obj => obj.afterCompleteComparisonWithPrefix }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterOrderByField_decorators, { kind: "method", name: "afterOrderByField", static: false, private: false, access: { has: obj => "afterOrderByField" in obj, get: obj => obj.afterOrderByField }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterSelect_decorators, { kind: "method", name: "afterSelect", static: false, private: false, access: { has: obj => "afterSelect" in obj, get: obj => obj.afterSelect }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterSelectCountStar_decorators, { kind: "method", name: "afterSelectCountStar", static: false, private: false, access: { has: obj => "afterSelectCountStar" in obj, get: obj => obj.afterSelectCountStar }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterUpdate_decorators, { kind: "method", name: "afterUpdate", static: false, private: false, access: { has: obj => "afterUpdate" in obj, get: obj => obj.afterUpdate }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterUpdateSet_decorators, { kind: "method", name: "afterUpdateSet", static: false, private: false, access: { has: obj => "afterUpdateSet" in obj, get: obj => obj.afterUpdateSet }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _dottedPathPrefix_decorators, { kind: "method", name: "dottedPathPrefix", static: false, private: false, access: { has: obj => "dottedPathPrefix" in obj, get: obj => obj.dottedPathPrefix }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _insideStringLiteral_decorators, { kind: "method", name: "insideStringLiteral", static: false, private: false, access: { has: obj => "insideStringLiteral" in obj, get: obj => obj.insideStringLiteral }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _insideUnclosedStringLiteral_decorators, { kind: "method", name: "insideUnclosedStringLiteral", static: false, private: false, access: { has: obj => "insideUnclosedStringLiteral" in obj, get: obj => obj.insideUnclosedStringLiteral }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _afterLimit_decorators, { kind: "method", name: "afterLimit", static: false, private: false, access: { has: obj => "afterLimit" in obj, get: obj => obj.afterLimit }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _syntaxErrorAndCaretBoundsNoThrow_decorators, { kind: "method", name: "syntaxErrorAndCaretBoundsNoThrow", static: false, private: false, access: { has: obj => "syntaxErrorAndCaretBoundsNoThrow" in obj, get: obj => obj.syntaxErrorAndCaretBoundsNoThrow }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _noFieldsOption_decorators, { kind: "method", name: "noFieldsOption", static: false, private: false, access: { has: obj => "noFieldsOption" in obj, get: obj => obj.noFieldsOption }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _namedParameters_decorators, { kind: "method", name: "namedParameters", static: false, private: false, access: { has: obj => "namedParameters" in obj, get: obj => obj.namedParameters }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _candidateLimit_decorators, { kind: "method", name: "candidateLimit", static: false, private: false, access: { has: obj => "candidateLimit" in obj, get: obj => obj.candidateLimit }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _fieldsFromSchema_decorators, { kind: "method", name: "fieldsFromSchema", static: false, private: false, access: { has: obj => "fieldsFromSchema" in obj, get: obj => obj.fieldsFromSchema }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _performanceCheck_decorators, { kind: "method", name: "performanceCheck", static: false, private: false, access: { has: obj => "performanceCheck" in obj, get: obj => obj.performanceCheck }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            CompletionTest = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        caretAtStart() {
+            // "|" -> fields, SELECT, DELETE, UPDATE, ORDER BY, LIMIT
+            const res = complete("|");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("status"), "Should include status field");
+            assert.ok(labels.includes("priority"), "Should include priority field");
+            assert.ok(labels.includes("done"), "Should include done field");
+            assert.ok(labels.includes("profile.email"), "Should include profile.email field");
+            assert.ok(labels.includes("SELECT"), "Should include SELECT");
+            assert.ok(labels.includes("DELETE"), "Should include DELETE");
+            assert.ok(labels.includes("UPDATE"), "Should include UPDATE");
+            assert.ok(labels.includes("ORDER BY"), "Should include ORDER BY");
+            assert.ok(labels.includes("LIMIT"), "Should include LIMIT");
+            // with filterOnly: no SELECT/DELETE/UPDATE
+            const filterRes = complete("|", { fields: TEST_FIELDS, filterOnly: true });
+            const filterLabels = filterRes.items.map(i => i.label);
+            assert.ok(!filterLabels.includes("SELECT"), "filterOnly should exclude SELECT");
+            assert.ok(!filterLabels.includes("DELETE"), "filterOnly should exclude DELETE");
+            assert.ok(!filterLabels.includes("UPDATE"), "filterOnly should exclude UPDATE");
+            assert.ok(filterLabels.includes("status"), "filterOnly should still include fields");
+            assert.ok(filterLabels.includes("ORDER BY"), "filterOnly should still include ORDER BY");
+            assert.ok(filterLabels.includes("LIMIT"), "filterOnly should still include LIMIT");
+        }
+        partialIdentifier() {
+            // "sta|" -> status with range [0,3]
+            const res = complete("sta|");
+            assert.strictEqual(res.prefix, "sta");
+            const statusItem = res.items.find(i => i.label === "status");
+            assert.ok(statusItem, "Should offer status");
+            assert.deepStrictEqual(statusItem.range, [0, 3]);
+            assert.strictEqual(statusItem.kind, "field");
+        }
+        afterIdentifier() {
+            // "status |" -> =, !=, IN, LIKE, CONTAINS, IS NULL, IS NOT NULL; no fields
+            const res = complete("status |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("="), "Should include =");
+            assert.ok(labels.includes("!="), "Should include !=");
+            assert.ok(labels.includes("IN"), "Should include IN");
+            assert.ok(labels.includes("LIKE"), "Should include LIKE");
+            assert.ok(labels.includes("CONTAINS"), "Should include CONTAINS");
+            assert.ok(labels.includes("IS NULL"), "Should include IS NULL");
+            assert.ok(labels.includes("IS NOT NULL"), "Should include IS NOT NULL");
+            // no fields
+            assert.ok(!labels.includes("status"), "Should not include status field");
+            assert.ok(!labels.includes("priority"), "Should not include priority field");
+            assert.ok(!labels.includes("done"), "Should not include done field");
+        }
+        afterComparisonOnEnumField() {
+            // "status = |" -> 'open', 'closed', ?; no TRUE
+            const res = complete("status = |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("'open'"), "Should include 'open'");
+            assert.ok(labels.includes("'closed'"), "Should include 'closed'");
+            assert.ok(labels.includes("?"), "Should include ?");
+            assert.ok(!labels.includes("TRUE"), "Should NOT include TRUE");
+            assert.ok(!labels.includes("FALSE"), "Should NOT include FALSE");
+        }
+        afterComparisonOnBooleanField() {
+            // "done = |" -> TRUE, FALSE
+            const res = complete("done = |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("TRUE"), "Should include TRUE");
+            assert.ok(labels.includes("FALSE"), "Should include FALSE");
+        }
+        afterCompleteComparison() {
+            // "status = 'open' |" -> AND, OR, ORDER BY, LIMIT, OFFSET
+            const res = complete("status = 'open' |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("AND"), "Should include AND");
+            assert.ok(labels.includes("OR"), "Should include OR");
+            assert.ok(labels.includes("ORDER BY"), "Should include ORDER BY");
+            assert.ok(labels.includes("LIMIT"), "Should include LIMIT");
+            assert.ok(labels.includes("OFFSET"), "Should include OFFSET");
+        }
+        afterCompleteComparisonWithPrefix() {
+            // "status = 'open' ord|" -> ORDER BY
+            const res = complete("status = 'open' ord|");
+            const labels = res.items.map(i => i.label);
+            assert.strictEqual(res.prefix, "ord");
+            assert.ok(labels.includes("ORDER BY"), "Should include ORDER BY");
+            assert.ok(!labels.includes("AND"), "Should not include AND");
+        }
+        afterOrderByField() {
+            // "ORDER BY priority |" -> ASC, DESC, ,, LIMIT
+            const res = complete("ORDER BY priority |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("ASC"), "Should include ASC");
+            assert.ok(labels.includes("DESC"), "Should include DESC");
+            assert.ok(labels.includes(","), "Should include ,");
+            assert.ok(labels.includes("LIMIT"), "Should include LIMIT");
+        }
+        afterSelect() {
+            // "SELECT |" -> fields, COUNT, SUM, AVG, MIN, MAX
+            const res = complete("SELECT |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("status"), "Should include status");
+            assert.ok(labels.includes("priority"), "Should include priority");
+            assert.ok(labels.includes("COUNT"), "Should include COUNT");
+            assert.ok(labels.includes("SUM"), "Should include SUM");
+            assert.ok(labels.includes("AVG"), "Should include AVG");
+            assert.ok(labels.includes("MIN"), "Should include MIN");
+            assert.ok(labels.includes("MAX"), "Should include MAX");
+        }
+        afterSelectCountStar() {
+            // "SELECT COUNT(*) |" -> AS
+            const res = complete("SELECT COUNT(*) |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("AS"), "Should include AS");
+        }
+        afterUpdate() {
+            // "UPDATE |" -> SET only
+            const res = complete("UPDATE |");
+            const labels = res.items.map(i => i.label);
+            assert.deepStrictEqual(labels, ["SET"]);
+        }
+        afterUpdateSet() {
+            // "UPDATE SET |" -> fields
+            const res = complete("UPDATE SET |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("status"), "Should include status");
+            assert.ok(labels.includes("priority"), "Should include priority");
+            assert.ok(labels.includes("done"), "Should include done");
+            assert.ok(labels.includes("profile.email"), "Should include profile.email");
+        }
+        dottedPathPrefix() {
+            // "profile.|" -> profile.email only, range covers profile.
+            const res = complete("profile.|");
+            const labels = res.items.map(i => i.label);
+            assert.deepStrictEqual(labels, ["profile.email"]);
+            assert.strictEqual(res.prefix, "profile.");
+            assert.deepStrictEqual(res.items[0].range, [0, 8]);
+        }
+        insideStringLiteral() {
+            // "status = 'op|'" -> 'open' (inside a string)
+            const res = complete("status = 'op|'");
+            const labels = res.items.map(i => i.label);
+            assert.deepStrictEqual(labels, ["'open'"]);
+            assert.strictEqual(res.prefix, "op");
+            assert.deepStrictEqual(res.items[0].range, [9, 13]);
+        }
+        insideUnclosedStringLiteral() {
+            const res = complete("status = 'op|");
+            const labels = res.items.map(i => i.label);
+            assert.deepStrictEqual(labels, ["'open'"]);
+            assert.strictEqual(res.prefix, "op");
+        }
+        afterLimit() {
+            // "LIMIT |" -> ? (no fields)
+            const res = complete("LIMIT |");
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes("?"), "Should include ?");
+            assert.ok(!labels.includes("status"), "Should not include fields");
+            assert.ok(!labels.includes("priority"), "Should not include fields");
+        }
+        syntaxErrorAndCaretBoundsNoThrow() {
+            // "x = #|", caret -1, caret 999 -> no throw
+            assert.doesNotThrow(() => complete("x = #|"));
+            assert.doesNotThrow(() => {
+                const res = getCompletions("status =", -1, { fields: TEST_FIELDS });
+                assert.ok(Array.isArray(res.items));
+            });
+            assert.doesNotThrow(() => {
+                const res = getCompletions("status =", 999, { fields: TEST_FIELDS });
+                assert.ok(Array.isArray(res.items));
+            });
+            assert.doesNotThrow(() => {
+                const res = getCompletions(null, 0);
+                assert.deepStrictEqual(res, { items: [], prefix: "" });
+            });
+        }
+        noFieldsOption() {
+            // no fields option -> no field items, keywords still offered
+            const res = complete("sta|", { fields: undefined });
+            assert.strictEqual(res.items.filter(i => i.kind === "field").length, 0);
+            const emptyRes = complete("|", { fields: undefined });
+            const labels = emptyRes.items.map(i => i.label);
+            assert.ok(labels.includes("SELECT"), "Keywords still offered when fields undefined");
+            assert.ok(labels.includes("ORDER BY"), "Keywords still offered when fields undefined");
+        }
+        namedParameters() {
+            const res = complete("status = |", {
+                fields: TEST_FIELDS,
+                parameters: ["myStatus", ":other"]
+            });
+            const labels = res.items.map(i => i.label);
+            assert.ok(labels.includes(":myStatus"));
+            assert.ok(labels.includes(":other"));
+            assert.ok(labels.includes("?"));
+        }
+        candidateLimit() {
+            const res = complete("|", { fields: TEST_FIELDS, limit: 3 });
+            assert.strictEqual(res.items.length, 3);
+        }
+        fieldsFromSchema() {
+            const schema = {
+                type: "object",
+                properties: {
+                    title: { type: "string", description: "Post title" },
+                    status: { type: "string", enum: ["draft", "published"], description: "Post status" },
+                    count: { type: "integer" },
+                    active: { type: "boolean" },
+                    author: {
+                        type: "object",
+                        description: "Author info",
+                        properties: {
+                            name: { type: "string" },
+                            contact: {
+                                type: "object",
+                                properties: {
+                                    email: { type: "string" },
+                                    deep: {
+                                        type: "object",
+                                        properties: {
+                                            level4: { type: "string" }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    },
+                    ignoredRef: {
+                        $ref: "#/definitions/SomeType"
+                    },
+                    booleanTrueProp: true,
+                    booleanFalseProp: false
+                }
+            };
+            const fields = fieldsFromSchema(schema);
+            const names = fields.map(f => f.name);
+            assert.ok(names.includes("title"), "Should include title");
+            assert.ok(names.includes("status"), "Should include status");
+            assert.ok(names.includes("count"), "Should include count");
+            assert.ok(names.includes("active"), "Should include active");
+            assert.ok(names.includes("author.name"), "Should include author.name");
+            assert.ok(names.includes("author.contact.email"), "Should include author.contact.email");
+            assert.ok(names.includes("booleanTrueProp"), "Should include boolean true property");
+            assert.ok(!names.includes("booleanFalseProp"), "Should exclude boolean false property");
+            assert.ok(!names.includes("ignoredRef"), "Should skip $ref property");
+            // Check depth limit (maxDepth = 3: author(1) -> contact(2) -> deep(3), level4 is at depth 4)
+            assert.ok(names.includes("author.contact.deep"), "Deep object should be included as object at depth limit");
+            assert.ok(!names.includes("author.contact.deep.level4"), "Should not recurse past maxDepth 3");
+            // Check enum/type/description copied
+            const statusField = fields.find(f => f.name === "status");
+            assert.deepStrictEqual(statusField?.enum, ["draft", "published"]);
+            assert.strictEqual(statusField?.type, "string");
+            assert.strictEqual(statusField?.description, "Post status");
+            // Empty or non-object schema
+            assert.deepStrictEqual(fieldsFromSchema({}), []);
+            assert.deepStrictEqual(fieldsFromSchema(null), []);
+        }
+        performanceCheck() {
+            const query = "SELECT title, content, author, createdAt WHERE status = 'published' AND priority > 10 AND done = TRUE AND category IN ['tech', 'news'] ORDER BY createdAt DESC LIMIT 20 OFFSET 'token123'";
+            assert.ok(query.length >= 180, "Query should be around 200 characters");
+            const start = Date.now();
+            for (let i = 0; i < 1000; i++) {
+                getCompletions(query, 50, { fields: TEST_FIELDS });
+            }
+            const elapsed = Date.now() - start;
+            console.log(`1,000 getCompletions calls completed in ${elapsed}ms`);
+            if (elapsed > 1000) {
+                console.warn(`Performance warning: 1000 calls took ${elapsed}ms (target <1000ms)`);
+            }
+            assert.ok(elapsed < 5000, `Expected 1000 calls to complete within reasonable time, took ${elapsed}ms`);
+        }
+        constructor() {
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+    return CompletionTest = _classThis;
+})();
+export { CompletionTest };
+//# sourceMappingURL=completion.spec.js.map

package/lib/completion.spec.js.map

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

package/lib/filter.d.ts

@@ -0,0 +1,54 @@
+import { type Expression } from "./query.js";
+import type { WebdaQLString } from "./webdaql-string.js";
+type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+type PropertyPaths<T extends object> = {
+    [K in Extract<keyof T, string>]: T[K] extends Function ? never : NonNullable<T[K]> extends Primitive | Date | RegExp | Array<any> | Map<any, any> | Set<any> ? K : NonNullable<T[K]> extends object ? K | `${K}.${PropertyPaths<NonNullable<T[K]>>}` : K;
+}[Extract<keyof T, string>];
+type PathValue<T, K extends string> = K extends `${infer H}.${infer R}` ? H extends keyof T ? PathValue<NonNullable<T[H]>, R> : never : K extends keyof T ? T[K] : never;
+type PropertyPathType<T extends object, K extends PropertyPaths<T>> = PathValue<T, K>;
+export type FilterOperators<V> = {
+    $eq?: V | null;
+    $ne?: V | null;
+    $gt?: V;
+    $gte?: V;
+    $lt?: V;
+    $lte?: V;
+    $in?: V[];
+    $like?: string;
+    $contains?: V extends readonly (infer E)[] ? Extract<E, string> : never;
+    $exists?: boolean;
+};
+export type ModelFilter<T extends object = any> = {
+    [K in PropertyPaths<T>]?: PropertyPathType<T, K> | null | FilterOperators<PropertyPathType<T, K>>;
+} & {
+    $or?: ModelFilter<T>[];
+    $and?: ModelFilter<T>[];
+};
+export interface FindOptions<T extends object> {
+    orderBy?: {
+        field: PropertyPaths<T>;
+        direction: "ASC" | "DESC";
+    }[];
+    limit?: number;
+    continuationToken?: string;
+}
+/**
+ * Convert a JSON filter to a WebdaQL expression
+ *
+ * Keys set to `undefined` are ignored, so optional criteria can be spread in. A plain object without
+ * operators matches its nested fields: `{ address: { city: "Paris" } }` is `address.city = "Paris"`.
+ * @param filter - the JSON filter
+ * @returns the expression
+ * @throws {WebdaQLError} for an invalid filter
+ */
+export declare function filterToExpression(filter: ModelFilter): Expression;
+/**
+ * Convert a JSON filter and its find options to a WebdaQL query string
+ * @param filter - the JSON filter
+ * @param options - ordering, limit and continuation token
+ * @returns the WebdaQL query
+ * @throws {WebdaQLError} for an invalid filter
+ */
+export declare function toWebdaQL<T extends object = any>(filter: ModelFilter<T>, options?: FindOptions<T>): WebdaQLString<T>;
+export {};
+//# sourceMappingURL=filter.d.ts.map

package/lib/filter.d.ts.map

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

package/lib/filter.js

@@ -0,0 +1,135 @@
+import { AndExpression, ComparisonExpression, OrExpression, checkFieldPath, normalizeQuery } from "./query.js";
+import { WebdaQLError } from "./webdaql-string.js";
+const operators = {
+    $eq: "=",
+    $ne: "!=",
+    $gt: ">",
+    $gte: ">=",
+    $lt: "<",
+    $lte: "<=",
+    $in: "IN",
+    $like: "LIKE",
+    $contains: "CONTAINS"
+};
+/**
+ * WebdaQL has no date literal: dates are compared as ISO 8601 strings, the way they are serialized
+ * @param value - the filter value
+ * @returns the value, with dates as ISO strings
+ */
+function toFilterValue(value) {
+    if (Array.isArray(value))
+        return value.map(toFilterValue);
+    if (!(value instanceof Date))
+        return value;
+    if (isNaN(value.getTime()))
+        throw new WebdaQLError("Invalid date in filter");
+    return value.toISOString();
+}
+/**
+ * Convert a JSON filter to a WebdaQL expression
+ *
+ * Keys set to `undefined` are ignored, so optional criteria can be spread in. A plain object without
+ * operators matches its nested fields: `{ address: { city: "Paris" } }` is `address.city = "Paris"`.
+ * @param filter - the JSON filter
+ * @returns the expression
+ * @throws {WebdaQLError} for an invalid filter
+ */
+export function filterToExpression(filter) {
+    if (!filter || typeof filter !== "object" || Array.isArray(filter))
+        throw new WebdaQLError("Filter must be an object");
+    const parts = [];
+    for (const key of Object.keys(filter)) {
+        const value = filter[key];
+        if (value === undefined)
+            continue;
+        if (key === "$or" || key === "$and") {
+            if (!Array.isArray(value) || !value.length)
+                throw new WebdaQLError(`${key} requires a non-empty array`);
+            parts.push(key === "$or"
+                ? new OrExpression(value.map(filterToExpression))
+                : new AndExpression(value.map(filterToExpression)));
+            continue;
+        }
+        if (key.startsWith("$"))
+            throw new WebdaQLError(`Unknown filter operator '${key}'`);
+        fieldToExpressions(key, value, parts);
+    }
+    return new AndExpression(parts);
+}
+/**
+ * Add the conditions on one field
+ * @param key - the field path
+ * @param value - a plain value, an operator object or a nested object
+ * @param parts - the conditions to add to
+ */
+function fieldToExpressions(key, value, parts) {
+    checkFieldPath(key);
+    if (value === null) {
+        parts.push(new ComparisonExpression("IS NULL", key, true));
+        return;
+    }
+    if (typeof value !== "object" || Array.isArray(value) || value instanceof Date) {
+        parts.push(new ComparisonExpression("=", key, toFilterValue(value)));
+        return;
+    }
+    const keys = Object.keys(value);
+    if (!keys.length)
+        throw new WebdaQLError(`Empty filter object for '${key}'`);
+    const operatorKeys = keys.filter(k => k.startsWith("$"));
+    if (!operatorKeys.length) {
+        // Nested object: match each of its fields
+        const before = parts.length;
+        for (const sub of keys) {
+            if (value[sub] !== undefined)
+                fieldToExpressions(`${key}.${sub}`, value[sub], parts);
+        }
+        if (parts.length === before)
+            throw new WebdaQLError(`Empty filter object for '${key}'`);
+        return;
+    }
+    if (operatorKeys.length !== keys.length)
+        throw new WebdaQLError(`Cannot mix operators and fields in '${key}'`);
+    for (const op of keys) {
+        const operand = value[op];
+        if (operand === undefined)
+            continue;
+        if (op === "$exists") {
+            if (typeof operand !== "boolean")
+                throw new WebdaQLError("$exists must be a boolean");
+            parts.push(new ComparisonExpression(operand ? "IS NOT NULL" : "IS NULL", key, true));
+        }
+        else if ((op === "$eq" || op === "$ne") && operand === null) {
+            parts.push(new ComparisonExpression(op === "$eq" ? "IS NULL" : "IS NOT NULL", key, true));
+        }
+        else {
+            const mapped = operators[op];
+            if (!mapped)
+                throw new WebdaQLError(`Unknown filter operator '${op}'`);
+            if (operand === null)
+                throw new WebdaQLError("null is only supported with $eq, $ne, or $exists");
+            if (op === "$in" && (!Array.isArray(operand) || !operand.length))
+                throw new WebdaQLError("$in requires a non-empty array");
+            if (op === "$contains" && typeof operand !== "string")
+                throw new WebdaQLError("$contains takes a string");
+            parts.push(new ComparisonExpression(mapped, key, toFilterValue(operand)));
+        }
+    }
+}
+/**
+ * Convert a JSON filter and its find options to a WebdaQL query string
+ * @param filter - the JSON filter
+ * @param options - ordering, limit and continuation token
+ * @returns the WebdaQL query
+ * @throws {WebdaQLError} for an invalid filter
+ */
+export function toWebdaQL(filter, options) {
+    const q = normalizeQuery({
+        type: "SELECT",
+        filter: filterToExpression(filter),
+        orderBy: options?.orderBy,
+        limit: options?.limit,
+        continuationToken: options?.continuationToken
+    });
+    return q.toString();
+}
+//# sourceMappingURL=filter.js.map