@wirecat/cli-base 0.23.0 → 0.25.0

package/dist/query/parser.js

@@ -0,0 +1,303 @@
+// Port of Lucene 9.12.3 StandardSyntaxParser.jj and BooleanModifiersQueryNodeProcessor (Apache-2.0).
+// Notices: THIRD_PARTY_NOTICES; upstream sources and the reference generator: cli-messaging scripts/search-reference.
+// Adjacency is Query(DisjQuery*), not ConjQuery.
+import { QUERY_LIMITS, queryError, walkQuery, } from "./types.js";
+const whitespace = (c) => /[ \t\n\r\u3000]/u.test(c);
+const reserved = new Set([
+    "+",
+    "-",
+    "!",
+    "(",
+    ")",
+    ":",
+    "=",
+    "^",
+    "@",
+    "<",
+    ">",
+    "[",
+    "]",
+    '"',
+    "{",
+    "}",
+    "~",
+    "\\",
+    "/",
+]);
+const decodeEscapes = (raw, span, fail) => {
+    let out = "";
+    for (let at = 0; at < raw.length; at++) {
+        if (raw[at] !== "\\") {
+            out += raw[at];
+            continue;
+        }
+        if (++at >= raw.length)
+            fail("query.invalid-escape", span);
+        if (raw[at] === "u") {
+            const hex = raw.slice(at + 1, at + 5);
+            if (!/^[0-9a-fA-F]{4}$/.test(hex))
+                fail("query.invalid-escape", span);
+            out += String.fromCharCode(Number.parseInt(hex, 16));
+            at += 4;
+        }
+        else
+            out += raw[at];
+    }
+    return out;
+};
+const tokensOf = (text, fail = queryError) => {
+    const tokens = [];
+    let at = 0;
+    let range = false;
+    while (at < text.length) {
+        const start = at;
+        const c = text[at] ?? "";
+        if (whitespace(c)) {
+            at++;
+            continue;
+        }
+        let kind = c;
+        if (c === '"' || (!range && c === "/")) {
+            at++;
+            while (at < text.length && text[at] !== c) {
+                if (text[at] === "\\" && (c === '"' || text[at + 1] === "/"))
+                    at++;
+                at++;
+            }
+            if (at >= text.length)
+                fail("query.unclosed-literal", { start, end: at });
+            at++;
+            if (c === "/" && /^[dgimsuvy]+(?:$|[ \t\n\r)])/.test(text.slice(at)))
+                fail("query.unsupported-regex-flags", { start: at, end: at + 1 }, "Lucene regex does not take JavaScript flags");
+            kind = c === '"' ? "quoted" : "regex";
+        }
+        else if (range && c !== "]" && c !== "}") {
+            while (at < text.length && !whitespace(text[at] ?? "") && !["]", "}"].includes(text[at] ?? ""))
+                at++;
+            kind = "rangeValue";
+        }
+        else if (reserved.has(c)) {
+            if (c === "\\") {
+                at += 2;
+                while (at < text.length &&
+                    !whitespace(text[at] ?? "") &&
+                    (!reserved.has(text[at] ?? "") || ["+", "-"].includes(text[at] ?? "")))
+                    at++;
+                kind = "term";
+            }
+            else {
+                at++;
+                if ((c === "<" || c === ">") && text[at] === "=") {
+                    at++;
+                    kind += "=";
+                }
+                if (c === "[" || c === "{")
+                    range = true;
+                if (c === "]" || c === "}")
+                    range = false;
+            }
+        }
+        else {
+            at++;
+            while (at < text.length) {
+                const next = text[at] ?? "";
+                if (next === "\\") {
+                    if (at + 1 >= text.length)
+                        fail("query.invalid-escape", { start: at, end: at + 1 });
+                    at += 2;
+                    continue;
+                }
+                if (whitespace(next) || (reserved.has(next) && next !== "+" && next !== "-"))
+                    break;
+                at++;
+            }
+            const raw = text.slice(start, at);
+            kind =
+                { AND: "AND", OR: "OR", NOT: "NOT", "&&": "AND", "||": "OR" }[raw] ??
+                    (/^\d+(?:\.\d+)?$/u.test(raw) ? "number" : "term");
+        }
+        tokens.push({ kind, raw: text.slice(start, at), span: { start, end: at } });
+    }
+    tokens.push({ kind: "EOF", raw: "", span: { start: at, end: at } });
+    return tokens;
+};
+export const parseLucene = (text, { defaultField = "text", ...context } = {}) => {
+    const fail = (reason, span, alternative) => queryError(reason, span, alternative, context);
+    if (text.length > QUERY_LIMITS.bytes || new TextEncoder().encode(text).length > QUERY_LIMITS.bytes)
+        fail("query.too-large", { start: 0, end: text.length });
+    const tokens = tokensOf(text, fail);
+    let at = 0;
+    let count = 0;
+    let depth = 0;
+    const peek = () => tokens[at];
+    const take = () => tokens[at++];
+    const expect = (kind) => {
+        if (peek().kind !== kind)
+            fail("query.invalid-syntax", peek().span);
+        return take();
+    };
+    const built = (node) => {
+        if (++count > QUERY_LIMITS.nodes)
+            fail("query.too-large", node.span);
+        return node;
+    };
+    const combine = (clauses, occur) => {
+        const first = clauses[0];
+        const last = clauses.at(-1);
+        if (!first || !last)
+            fail("query.invalid-syntax", peek().span);
+        if (clauses.length === 1)
+            return first;
+        return {
+            node: built({
+                kind: "boolean",
+                clauses: clauses.map(({ node, modifier }) => ({ node, occur: modifier ?? occur })),
+                span: { start: first.node.span.start, end: last.node.span.end },
+            }),
+        };
+    };
+    const query = (field, implicit = false) => {
+        if (++depth > QUERY_LIMITS.depth)
+            fail("query.too-large", peek().span);
+        const clauses = [];
+        do {
+            clauses.push(disjunction(field, implicit));
+        } while (!["EOF", ")"].includes(peek().kind));
+        const result = combine(clauses, "must");
+        depth--;
+        if (result.modifier === "mustNot")
+            return built({ kind: "boolean", clauses: [{ node: result.node, occur: "mustNot" }], span: result.node.span });
+        return result.node;
+    };
+    const disjunction = (field, implicit) => {
+        const clauses = [conjunction(field, implicit)];
+        while (peek().kind === "OR") {
+            take();
+            clauses.push(conjunction(field, implicit));
+        }
+        return combine(clauses, "should");
+    };
+    const conjunction = (field, implicit) => {
+        const clauses = [clause(field, implicit)];
+        while (peek().kind === "AND") {
+            take();
+            clauses.push(clause(field, implicit));
+        }
+        return combine(clauses, "must");
+    };
+    const clause = (inherited, inheritedImplicit) => {
+        let modifier;
+        if (["+", "-", "NOT", "!"].includes(peek().kind))
+            modifier = take().kind === "+" ? "must" : "mustNot";
+        let field = inherited;
+        // An error about `field:value` points at the field, where the comparison form already starts.
+        let start;
+        let implicit = inheritedImplicit;
+        if (peek().kind === "term" && [":", "=", "<", ">", "<=", ">="].includes(tokens[at + 1]?.kind ?? "")) {
+            const token = take();
+            field = decodeEscapes(token.raw, token.span, fail);
+            start = token.span.start;
+            implicit = false;
+            let operator = take();
+            if (operator.kind === ":" && ["<", ">", "<=", ">="].includes(peek().kind))
+                operator = take();
+            if (["<", ">", "<=", ">="].includes(operator.kind)) {
+                const value = take();
+                if (!["term", "number", "quoted"].includes(value.kind))
+                    fail("query.invalid-syntax", value.span);
+                const decoded = decodeEscapes(value.kind === "quoted" ? value.raw.slice(1, -1) : value.raw, value.span, fail);
+                const lower = operator.kind.startsWith(">");
+                const node = built({
+                    kind: "predicate",
+                    field,
+                    operator: "range",
+                    value: lower ? decoded : "*",
+                    upper: lower ? "*" : decoded,
+                    lowerInclusive: !lower || operator.kind.endsWith("="),
+                    upperInclusive: lower || operator.kind.endsWith("="),
+                    span: { start: token.span.start, end: value.span.end },
+                });
+                return { node, ...(modifier ? { modifier } : {}) };
+            }
+        }
+        let node;
+        if (peek().kind === "(") {
+            const start = take().span.start;
+            node = query(field, implicit);
+            const end = expect(")").span.end;
+            node = { ...node, span: { start, end } };
+        }
+        else if (["[", "{"].includes(peek().kind)) {
+            const opening = take();
+            const lower = take();
+            if (!["rangeValue", "quoted"].includes(lower.kind))
+                fail("query.invalid-syntax", lower.span);
+            const separator = take();
+            if (separator.raw !== "TO")
+                fail("query.invalid-syntax", separator.span);
+            const upper = take();
+            if (!["rangeValue", "quoted"].includes(upper.kind))
+                fail("query.invalid-syntax", upper.span);
+            const closing = take();
+            if (!["]", "}"].includes(closing.kind))
+                fail("query.invalid-syntax", closing.span);
+            const decode = (t) => decodeEscapes(t.kind === "quoted" ? t.raw.slice(1, -1) : t.raw, t.span, fail);
+            node = built({
+                kind: "predicate",
+                field,
+                operator: "range",
+                value: decode(lower),
+                upper: decode(upper),
+                lowerInclusive: opening.kind === "[",
+                upperInclusive: closing.kind === "]",
+                span: { start: start ?? opening.span.start, end: closing.span.end },
+            });
+        }
+        else {
+            const token = take();
+            if (!["term", "number", "quoted", "regex"].includes(token.kind))
+                fail("query.invalid-syntax", token.span);
+            const raw = ["term", "number"].includes(token.kind) ? token.raw : token.raw.slice(1, -1);
+            if (field === "fn")
+                fail("query.unsupported-operator", token.span, "interval functions are not supported");
+            const wildcard = ["term", "number"].includes(token.kind) && /(?<!\\)[*?]/u.test(raw);
+            node = built({
+                kind: "predicate",
+                field,
+                operator: token.kind === "regex" ? "regex" : token.kind === "quoted" ? "phrase" : wildcard ? "wildcard" : "term",
+                value: token.kind === "regex" || wildcard ? raw : decodeEscapes(raw, token.span, fail),
+                span: { start: start ?? token.span.start, end: token.span.end },
+                ...(implicit ? { implicit: true } : {}),
+            });
+        }
+        if (peek().kind === "~")
+            fail("query.unsupported-operator", peek().span, node.kind === "predicate" && node.operator === "phrase"
+                ? "proximity (~) is not supported — drop the ~ for the exact phrase, or join the words with AND"
+                : "fuzzy matching (~) is not supported — use a prefix such as word* to catch word forms");
+        if (["^", "@"].includes(peek().kind))
+            fail("query.unsupported-operator", peek().span, "boost and minimum-should-match are not supported");
+        return { node, ...(modifier ? { modifier } : {}) };
+    };
+    const root = query(defaultField, true);
+    expect("EOF");
+    if (defaultField === "none") {
+        const bare = walkQuery(root).find((node) => node.implicit);
+        if (bare)
+            queryError("query.bare-word", bare.span, `"${bare.value}" has no field; write field:value`, context, {
+                word: bare.value,
+            });
+    }
+    return { version: 1, language: "lucene-v1", root };
+};
+/** Bare terms eligible for forgiving retrieval; explicit syntax keeps strict semantics. */
+export const implicitTextTerms = (text) => {
+    const tokens = tokensOf(text);
+    if (tokens.some(({ kind }) => ["AND", "OR", "NOT", "+", "-", "!", "(", ")"].includes(kind)))
+        return new Set();
+    return new Set(tokens.flatMap((token, index) => token.kind === "term" &&
+        ![":", "=", "<", ">", "<=", ">="].includes(tokens[index - 1]?.kind ?? "") &&
+        ![":", "=", "<", ">", "<=", ">="].includes(tokens[index + 1]?.kind ?? "")
+        ? [token.span.start]
+        : []));
+};
+//# sourceMappingURL=parser.js.map

package/dist/query/parser.js.map

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

package/dist/query/registry.d.ts

@@ -0,0 +1,23 @@
+import type { FieldSpec, QueryRegistry } from "./fields.js";
+/** A field as `commands --json` carries it: everything but the hook. */
+export type FieldInfo = Omit<FieldSpec, "validate">;
+export interface QueryInfo extends Omit<QueryRegistry, "fields"> {
+    fields: FieldInfo[];
+}
+export declare const describeQuery: (registry: QueryRegistry) => QueryInfo;
+/** Why an example or default term would not run against these fields, per field name; empty when every one runs. */
+export declare const exampleProblems: (registry: QueryRegistry) => {
+    field: string;
+    problem: string;
+}[];
+/** One list's query: field names unique and snake_case, every example and default runs. Throws naming every problem. */
+export declare const defineQuery: (registry: QueryRegistry) => QueryRegistry;
+/** The query reasons every CLI shares; a CLI adds its own (`query.invalid-tag`) with `defineReasons`. */
+export declare const QUERY_REASONS: {
+    reason: string;
+    code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
+    message: string;
+    details: string[];
+    step?: string | undefined;
+}[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/query/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/query/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAK3D,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;AACnD,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC;IAC9D,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAED,eAAO,MAAM,aAAa,aAAc,aAAa,KAAG,SAKtD,CAAA;AAEF,oHAAoH;AACpH,eAAO,MAAM,eAAe,aAAc,aAAa,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAoB3F,CAAA;AAED,wHAAwH;AACxH,eAAO,MAAM,WAAW,aAAc,aAAa,KAAG,aASrD,CAAA;AAID,yGAAyG;AACzG,eAAO,MAAM,aAAa;;;;;;GA6BzB,CAAA"}

package/dist/query/registry.js

@@ -0,0 +1,77 @@
+import { isCliError } from "../errors.js";
+import { defineReasons } from "../standards/errors.js";
+import { duplicates, RegistryError, SNAKE_CASE } from "../standards/registry.js";
+import { parseLucene } from "./parser.js";
+import { walkQuery } from "./types.js";
+import { validateQuery } from "./validate.js";
+export const describeQuery = (registry) => ({
+    entity: registry.entity,
+    backend: registry.backend,
+    fields: registry.fields.map(({ validate: _, ...field }) => field),
+    ...(registry.defaults && registry.defaults.length > 0 ? { defaults: [...registry.defaults] } : {}),
+});
+/** Why an example or default term would not run against these fields, per field name; empty when every one runs. */
+export const exampleProblems = (registry) => {
+    // An example proves syntax and type; whether a provider filters the field is the list's answer at run time.
+    const syntaxOnly = { ...registry, backend: "sql" };
+    const problem = (text, field) => {
+        try {
+            const named = walkQuery(validateQuery(parseLucene(text, { defaultField: "none" }), syntaxOnly).root);
+            return named.every((node) => node.field === field) ? undefined : `"${text}" does not name ${field}`;
+        }
+        catch (failure) {
+            if (!isCliError(failure))
+                throw failure;
+            return `"${text}": ${failure.message}`;
+        }
+    };
+    const defaults = (registry.defaults ?? []).map((term) => {
+        const field = term.replace(/^-/, "").split(/[:<>=]/)[0] ?? "";
+        return { field, problem: problem(term.replace(/^-/, ""), field) };
+    });
+    return [
+        ...registry.fields.map((field) => ({ field: field.name, problem: problem(field.example, field.name) })),
+        ...defaults,
+    ].filter((entry) => entry.problem !== undefined);
+};
+/** One list's query: field names unique and snake_case, every example and default runs. Throws naming every problem. */
+export const defineQuery = (registry) => {
+    const names = registry.fields.map((field) => field.name);
+    const problems = [
+        ...duplicates(names).map((name) => `"${name}" is listed twice`),
+        ...names.filter((name) => !SNAKE_CASE.test(name)).map((name) => `"${name}" is not snake_case`),
+        ...exampleProblems(registry).map(({ field, problem }) => `${field}: ${problem}`),
+    ];
+    if (problems.length > 0)
+        throw new RegistryError(`${registry.entity} query`, problems);
+    return registry;
+};
+const SPAN = ["span", "alternative", "guide"];
+/** The query reasons every CLI shares; a CLI adds its own (`query.invalid-tag`) with `defineReasons`. */
+export const QUERY_REASONS = defineReasons([
+    ["query.bare-word", "a word in the query has no field", ["word"]],
+    ["query.invalid-ast", "the query tree is not valid", []],
+    ["query.invalid-date", "a date in the query cannot be read", []],
+    ["query.invalid-escape", "an escape in the query is not valid", []],
+    ["query.invalid-number", "a number in the query cannot be read", []],
+    ["query.invalid-regex", "a regular expression in the query is not valid", []],
+    ["query.invalid-syntax", "the query cannot be parsed", []],
+    ["query.invalid-timezone", "the time zone is not known", []],
+    ["query.missing-value", "a field in the query has no value", []],
+    ["query.too-large", "the query is over one of its limits", []],
+    ["query.unclosed-literal", "a quote or bracket in the query is not closed", []],
+    ["query.unknown-field", "a field in the query is not known", ["fields"]],
+    ["query.unknown-value", "a value in the query is not known", []],
+    ["query.unsupported-field", "this list cannot filter by that field", ["supported"]],
+    ["query.unsupported-operator", "this field does not take that operator", []],
+    ["query.unsupported-placement", "this field works only as a required term", []],
+    ["query.unsupported-regex", "that regular expression is not supported", []],
+    ["query.unsupported-regex-flags", "regular expression flags are not supported", []],
+    ["query.unsupported-version", "the query version is not supported", []],
+].map(([reason, message, details]) => ({
+    reason,
+    code: "validation_error",
+    message,
+    details: [...SPAN, ...details],
+})));
+//# sourceMappingURL=registry.js.map

package/dist/query/registry.js.map

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

package/dist/query/types.d.ts

@@ -0,0 +1,45 @@
+export declare const QUERY_LIMITS: {
+    readonly bytes: 8192;
+    readonly depth: 32;
+    readonly nodes: 256;
+};
+export type Span = {
+    start: number;
+    end: number;
+};
+export type Occur = "must" | "should" | "mustNot";
+export type Operator = "term" | "phrase" | "wildcard" | "regex" | "range";
+export interface Predicate {
+    kind: "predicate";
+    field: string;
+    operator: Operator;
+    value: string;
+    upper?: string;
+    lowerInclusive?: boolean;
+    upperInclusive?: boolean;
+    span: Span;
+    /** A bare word, under no field. */
+    implicit?: true;
+}
+export type QueryNode = Predicate | {
+    kind: "boolean";
+    clauses: {
+        occur: Occur;
+        node: QueryNode;
+    }[];
+    span: Span;
+};
+export interface QueryAst {
+    version: 1;
+    language: "lucene-v1";
+    root: QueryNode;
+}
+/** Who reports a query error: `chats list`, `search`. Without it the message starts with `query:`. */
+export interface QueryContext {
+    command?: string;
+    /** Where the query language is explained. */
+    guide?: string;
+}
+export declare function queryError(reason: string, span: Span, alternative?: string, context?: QueryContext, details?: Record<string, unknown>): never;
+export declare const walkQuery: (node: QueryNode) => Predicate[];
+//# sourceMappingURL=types.d.ts.map

package/dist/query/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;aACvB,KAAK,EAAE,IAAI;aACX,KAAK,EAAE,EAAE;aACT,KAAK,EAAE,GAAG;CACF,CAAA;AAEV,MAAM,MAAM,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AACjD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;AACjD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAA;AACzE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,mCAAmC;IACnC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAChB;AACD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAA;AACjH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,WAAW,CAAA;IACrB,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,YAAiB,EAC1B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,KAAK,CAYP;AAED,eAAO,MAAM,SAAS,SAAU,SAAS,KAAG,SAAS,EACqC,CAAA"}

package/dist/query/types.js

@@ -0,0 +1,17 @@
+import { CliError } from "../errors.js";
+export const QUERY_LIMITS = {
+    bytes: 8192,
+    depth: 32,
+    nodes: 256,
+};
+export function queryError(reason, span, alternative, context = {}, details = {}) {
+    throw new CliError("validation_error", `${context.command ?? "query"}: ${reason} at position ${span.start + 1}${alternative ? ` — ${alternative}` : ""}`, {
+        reason,
+        span,
+        ...(alternative ? { alternative } : {}),
+        ...(context.guide ? { guide: context.guide } : {}),
+        ...details,
+    });
+}
+export const walkQuery = (node) => node.kind === "predicate" ? [node] : node.clauses.flatMap(({ node }) => walkQuery(node));
+//# sourceMappingURL=types.js.map

package/dist/query/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,GAAG;CACF,CAAA;AA+BV,MAAM,UAAU,UAAU,CACxB,MAAc,EACd,IAAU,EACV,WAAoB,EACpB,OAAO,GAAiB,EAAE,EAC1B,OAAO,GAA4B,EAAE;IAErC,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,gBAAgB,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACjH;QACE,MAAM;QACN,IAAI;QACJ,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,OAAO;KACX,CACF,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAe,EAAe,EAAE,CACxD,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA"}

package/dist/query/validate.d.ts

@@ -0,0 +1,11 @@
+import type { QueryRegistry } from "./fields.js";
+import { type QueryAst, type QueryContext } from "./types.js";
+export interface ValidateOptions extends QueryContext {
+    /** Day boundaries in time values; validity does not depend on it but for a day a zone skips. */
+    zone?: string;
+}
+/** Checks every term against the list's fields: name, operator, value by type, placement, the field's own hook. */
+export declare const validateQuery: (ast: QueryAst, registry: QueryRegistry, options?: ValidateOptions) => QueryAst;
+/** The fields a query names, so a default on a field the query names is lifted. */
+export declare const fieldsNamed: (ast: QueryAst) => Set<string>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/query/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/query/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAyC,MAAM,YAAY,CAAA;AAEpH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAiDD,mHAAmH;AACnH,eAAO,MAAM,aAAa,QAAS,QAAQ,YAAY,aAAa,YAAW,eAAe,KAAQ,QAiCrG,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,WAAW,QAAS,QAAQ,KAAG,GAAG,CAAC,MAAM,CAA2D,CAAA"}

package/dist/query/validate.js

@@ -0,0 +1,82 @@
+import { isCliError } from "../errors.js";
+import { dateEndpoint } from "./dates.js";
+import { queryError, walkQuery } from "./types.js";
+// dates.ts raises without a command; its errors are re-raised here under the command that ran.
+const inContext = (context, run) => {
+    try {
+        run();
+    }
+    catch (failure) {
+        if (!isCliError(failure) || typeof failure.details.reason !== "string" || failure.details.span === undefined)
+            throw failure;
+        const { reason, span, alternative } = failure.details;
+        queryError(reason, span, alternative, context);
+    }
+};
+const bounds = (node) => node.operator === "range" ? [node.value, node.upper ?? "*"].filter((bound) => bound !== "*") : [node.value];
+const checkValue = (field, node, options) => {
+    const fail = (reason, alternative) => queryError(reason, node.span, alternative, options);
+    if (node.value === "" && field.type !== "txt")
+        fail("query.missing-value");
+    if (node.operator === "wildcard")
+        return;
+    switch (field.type) {
+        case "enum":
+            if (!field.values?.includes(node.value.toLowerCase()))
+                fail("query.unknown-value", `${field.name} takes ${field.values?.join(", ")}`);
+            return;
+        case "bool":
+            if (!["true", "false"].includes(node.value.toLowerCase()))
+                fail("query.unknown-value", `${field.name} takes true, false`);
+            return;
+        case "num":
+            for (const bound of bounds(node))
+                if (!Number.isFinite(Number(bound)) || bound.trim() === "")
+                    fail("query.invalid-number", `${field.name} takes a number`);
+            return;
+        case "time":
+            inContext(options, () => {
+                for (const bound of bounds(node))
+                    dateEndpoint(bound, options.zone ?? "UTC", "lower", true, node.span);
+            });
+            return;
+        default:
+            return;
+    }
+};
+/** Checks every term against the list's fields: name, operator, value by type, placement, the field's own hook. */
+export const validateQuery = (ast, registry, options = {}) => {
+    const byName = new Map(registry.fields.map((field) => [field.name, field]));
+    const visit = (node, required) => {
+        if (node.kind === "boolean") {
+            for (const clause of node.clauses)
+                visit(clause.node, required && clause.occur === "must");
+            return;
+        }
+        const field = byName.get(node.field);
+        if (!field)
+            queryError("query.unknown-field", node.span, `no field "${node.field}"`, options, {
+                fields: registry.fields.map((one) => one.name),
+            });
+        if (registry.backend === "native" && !field.native)
+            queryError("query.unsupported-field", node.span, `the source cannot filter by ${field.name}`, options, {
+                supported: registry.fields.filter((one) => one.native).map((one) => one.name),
+            });
+        // `field:*` asks whether the field has a value, which every type answers.
+        const presence = node.operator === "wildcard" && node.value === "*";
+        if (!presence && !field.operators.includes(node.operator))
+            queryError("query.unsupported-operator", node.span, `${field.name} takes ${field.operators.join(", ")}`, options);
+        if (field.placement === "and" && !required)
+            queryError("query.unsupported-placement", node.span, `${field.name} only as a required term, not under OR or NOT`, options);
+        if (presence)
+            return;
+        checkValue(field, node, options);
+        if (field.validate)
+            inContext(options, () => field.validate?.(node));
+    };
+    visit(ast.root, true);
+    return ast;
+};
+/** The fields a query names, so a default on a field the query names is lifted. */
+export const fieldsNamed = (ast) => new Set(walkQuery(ast.root).map((node) => node.field));
+//# sourceMappingURL=validate.js.map

package/dist/query/validate.js.map

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

package/dist/result-fields.js

@@ -39,7 +39,7 @@ const select = (value, paths, item = false) => {
         }
         target[parts.at(-1)] = found;
     }
-    for (const name of ["operationId", "sendId"])
+    for (const name of ["operation_id", "send_id"])
         if (Object.hasOwn(value, name))
             result[name] = value[name];
     return result;