mindoodb 0.0.24 → 0.0.32

package/dist/core/expressions/evaluateExpression.js

@@ -0,0 +1,386 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIEW_CONTEXT_OPERATIONS = void 0;
+exports.getFieldValue = getFieldValue;
+exports.expressionToNumber = expressionToNumber;
+exports.expressionToBoolean = expressionToBoolean;
+exports.evaluateExpression = evaluateExpression;
+exports.collectDecryptRequests = collectDecryptRequests;
+exports.getReferencedFields = getReferencedFields;
+exports.analyzeExpressionRequirements = analyzeExpressionRequirements;
+/** Operation nodes that only make sense inside a materialized view tree. */
+exports.VIEW_CONTEXT_OPERATIONS = new Set([
+    "childCount",
+    "childCategoryCount",
+    "childDocumentCount",
+    "descendantCount",
+    "descendantCategoryCount",
+    "descendantDocumentCount",
+    "siblingCount",
+]);
+/** Reads a dot-separated path from an object and returns `undefined` when any segment is missing. */
+function getFieldValue(source, path) {
+    if (!path) {
+        return undefined;
+    }
+    return path.split(".").reduce((current, part) => {
+        if (current && typeof current === "object" && part in current) {
+            return current[part];
+        }
+        return undefined;
+    }, source);
+}
+function expressionToNumber(value) {
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : null;
+    }
+    if (typeof value === "string" && value.trim()) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+function expressionToBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return value !== 0;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        return normalized !== "" && normalized !== "false" && normalized !== "0" && normalized !== "no";
+    }
+    return Boolean(value);
+}
+function toDate(value) {
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? null : value;
+    }
+    if (typeof value === "number" || typeof value === "string") {
+        const date = new Date(value);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    return null;
+}
+function leftString(value, by) {
+    const text = String(value ?? "");
+    if (typeof by === "number") {
+        const count = Number.isFinite(by) ? Math.max(0, Math.trunc(by)) : 0;
+        return text.slice(0, count);
+    }
+    const delimiter = String(by ?? "");
+    const index = text.indexOf(delimiter);
+    return index === -1 ? text : text.slice(0, index);
+}
+function rightString(value, by) {
+    const text = String(value ?? "");
+    if (typeof by === "number") {
+        const count = Number.isFinite(by) ? Math.max(0, Math.trunc(by)) : 0;
+        return count === 0 ? "" : text.slice(-count);
+    }
+    const delimiter = String(by ?? "");
+    const index = text.lastIndexOf(delimiter);
+    return index === -1 ? text : text.slice(index + delimiter.length);
+}
+function getAttachmentList(doc) {
+    const attachments = doc._attachments;
+    return Array.isArray(attachments) ? attachments : [];
+}
+function getViewRowCount(context, key) {
+    return context.counts?.[key] ?? 0;
+}
+/** Evaluates a single operation node after its arguments have been recursively resolved. */
+function evaluateOperation(expression, context) {
+    const args = expression.args.map((arg) => evaluateExpression(arg, context));
+    switch (expression.op) {
+        case "createdAt":
+            return context.createdAt ?? null;
+        case "decryptionKeyId":
+            return context.decryptionKeyId ?? null;
+        case "isWitnessed":
+            return context.witnessed ?? false;
+        case "isAwaitingWitness":
+            return context.awaitingWitness ?? false;
+        case "attachmentNames":
+            return getAttachmentList(context.doc)
+                .map((attachment) => attachment.fileName)
+                .filter((value) => typeof value === "string");
+        case "attachmentLengths":
+            return getAttachmentList(context.doc)
+                .map((attachment) => attachment.size)
+                .filter((value) => typeof value === "number" && Number.isFinite(value));
+        case "attachmentCount":
+            return getAttachmentList(context.doc).length;
+        case "childCount":
+            return getViewRowCount(context, "childCount");
+        case "childCategoryCount":
+            return getViewRowCount(context, "childCategoryCount");
+        case "childDocumentCount":
+            return getViewRowCount(context, "childDocumentCount");
+        case "descendantCount":
+            return getViewRowCount(context, "descendantCount");
+        case "descendantCategoryCount":
+            return getViewRowCount(context, "descendantCategoryCount");
+        case "descendantDocumentCount":
+            return getViewRowCount(context, "descendantDocumentCount");
+        case "siblingCount":
+            return getViewRowCount(context, "siblingCount");
+        case "add":
+            return (expressionToNumber(args[0]) ?? 0) + (expressionToNumber(args[1]) ?? 0);
+        case "sub":
+            return (expressionToNumber(args[0]) ?? 0) - (expressionToNumber(args[1]) ?? 0);
+        case "mul":
+            return (expressionToNumber(args[0]) ?? 0) * (expressionToNumber(args[1]) ?? 0);
+        case "div": {
+            const divisor = expressionToNumber(args[1]);
+            return divisor && divisor !== 0 ? (expressionToNumber(args[0]) ?? 0) / divisor : null;
+        }
+        case "mod": {
+            const divisor = expressionToNumber(args[1]);
+            return divisor && divisor !== 0 ? (expressionToNumber(args[0]) ?? 0) % divisor : null;
+        }
+        case "eq":
+            return args[0] === args[1];
+        case "neq":
+            return args[0] !== args[1];
+        case "gt":
+            return String(args[0] ?? "") > String(args[1] ?? "");
+        case "gte":
+            return String(args[0] ?? "") >= String(args[1] ?? "");
+        case "lt":
+            return String(args[0] ?? "") < String(args[1] ?? "");
+        case "lte":
+            return String(args[0] ?? "") <= String(args[1] ?? "");
+        case "and":
+            return args.every((value) => expressionToBoolean(value));
+        case "or":
+            return args.some((value) => expressionToBoolean(value));
+        case "not":
+            return !expressionToBoolean(args[0]);
+        case "concat":
+            return args.filter((part) => part !== null && part !== undefined && part !== "").join("");
+        case "lower":
+            return String(args[0] ?? "").toLowerCase();
+        case "upper":
+            return String(args[0] ?? "").toUpperCase();
+        case "trim":
+            return String(args[0] ?? "").trim();
+        case "left":
+            return leftString(args[0], args[1]);
+        case "right":
+            return rightString(args[0], args[1]);
+        case "number":
+            return expressionToNumber(args[0]);
+        case "string":
+            return String(args[0] ?? "");
+        case "boolean":
+            return expressionToBoolean(args[0]);
+        case "contains":
+            return String(args[0] ?? "").toLowerCase().includes(String(args[1] ?? "").toLowerCase());
+        case "startsWith":
+            return String(args[0] ?? "").toLowerCase().startsWith(String(args[1] ?? "").toLowerCase());
+        case "endsWith":
+            return String(args[0] ?? "").toLowerCase().endsWith(String(args[1] ?? "").toLowerCase());
+        case "coalesce":
+            return args.find((value) => value !== null && value !== undefined && value !== "");
+        case "exists":
+            return args[0] !== null && args[0] !== undefined && args[0] !== "";
+        case "notExists":
+            return args[0] === null || args[0] === undefined || args[0] === "";
+        case "pathJoin":
+            return args
+                .map((part) => String(part ?? "").trim())
+                .filter(Boolean)
+                .join("\\");
+        case "datePart": {
+            const date = toDate(args[0]);
+            if (!date) {
+                return null;
+            }
+            switch (expression.part) {
+                case "year":
+                    return date.getUTCFullYear();
+                case "month":
+                    return String(date.getUTCMonth() + 1).padStart(2, "0");
+                case "day":
+                    return String(date.getUTCDate()).padStart(2, "0");
+                case "quarter":
+                    return `Q${Math.ceil((date.getUTCMonth() + 1) / 3)}`;
+                default:
+                    return null;
+            }
+        }
+    }
+}
+/**
+ * Parses a JSON string into a value (objects/values pass through unchanged),
+ * then optionally selects a nested value via a dot `path`. Returns null when
+ * the input is nullish or the string is not valid JSON.
+ */
+function parseAndExtract(value, path) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    let parsed = value;
+    if (typeof value === "string") {
+        try {
+            parsed = JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (!path) {
+        return parsed;
+    }
+    if (parsed && typeof parsed === "object") {
+        return getFieldValue(parsed, path);
+    }
+    return undefined;
+}
+/**
+ * Evaluates an expression against a document plus the current view/value
+ * context. This is the runtime counterpart of the builder and parser.
+ */
+function evaluateExpression(expression, context) {
+    switch (expression.kind) {
+        case "literal":
+            return expression.value;
+        case "field":
+            return getFieldValue(context.doc, expression.path);
+        case "value":
+            return getFieldValue(context.values, expression.path);
+        case "origin":
+            return context.origin;
+        case "variable":
+            return context.variables[expression.name];
+        case "if":
+            return expressionToBoolean(evaluateExpression(expression.condition, context))
+                ? evaluateExpression(expression.whenTrue, context)
+                : evaluateExpression(expression.whenFalse, context);
+        case "let": {
+            const nextVariables = { ...context.variables };
+            for (const [name, valueExpression] of Object.entries(expression.bindings)) {
+                nextVariables[name] = evaluateExpression(valueExpression, {
+                    ...context,
+                    variables: nextVariables,
+                });
+            }
+            return evaluateExpression(expression.result, {
+                ...context,
+                variables: nextVariables,
+            });
+        }
+        case "decrypt": {
+            const raw = context.decrypted?.[expression.field] ?? null;
+            if (!expression.json) {
+                return raw;
+            }
+            return parseAndExtract(raw, expression.path);
+        }
+        case "json":
+            return parseAndExtract(getFieldValue(context.doc, expression.field), expression.path);
+        case "operation":
+            return evaluateOperation(expression, context);
+    }
+}
+/** Generic AST walker visiting every node of an expression tree. */
+function walkExpression(expression, visit) {
+    visit(expression);
+    switch (expression.kind) {
+        case "operation":
+            for (const arg of expression.args) {
+                walkExpression(arg, visit);
+            }
+            break;
+        case "if":
+            walkExpression(expression.condition, visit);
+            walkExpression(expression.whenTrue, visit);
+            walkExpression(expression.whenFalse, visit);
+            break;
+        case "let":
+            for (const binding of Object.values(expression.bindings)) {
+                walkExpression(binding, visit);
+            }
+            walkExpression(expression.result, visit);
+            break;
+        case "decrypt":
+            if (expression.key) {
+                walkExpression(expression.key, visit);
+            }
+            break;
+        case "literal":
+        case "field":
+        case "value":
+        case "origin":
+        case "variable":
+        case "json":
+            break;
+    }
+}
+/**
+ * Walks an expression tree and collects every `decrypt` node so the host
+ * runtime knows which `_encrypted` fields it must decrypt before evaluation.
+ * `json` nodes need no decryption and are ignored.
+ */
+function collectDecryptRequests(expression) {
+    const requests = [];
+    walkExpression(expression, (node) => {
+        if (node.kind === "decrypt") {
+            requests.push({ field: node.field, key: node.key });
+        }
+    });
+    return requests;
+}
+/**
+ * Operations reading the document's managed `_attachments` array. They are
+ * "context" operations (no `field` node), so the coverage machinery must
+ * account for them explicitly: on the summary path they only work when the
+ * summary stores the attachment projection.
+ */
+const ATTACHMENT_OPERATIONS = new Set(["attachmentNames", "attachmentLengths", "attachmentCount"]);
+/**
+ * Collects every document field path (`field` and `json` nodes) an
+ * expression references. Basis of the query engine's coverage check against
+ * the summary configuration. Attachment operations count as a reference to
+ * `_attachments` — they read that managed field even without a field node.
+ */
+function getReferencedFields(expression) {
+    const paths = new Set();
+    walkExpression(expression, (node) => {
+        if (node.kind === "field") {
+            paths.add(node.path);
+        }
+        else if (node.kind === "json") {
+            paths.add(node.field);
+        }
+        else if (node.kind === "operation" && ATTACHMENT_OPERATIONS.has(node.op)) {
+            paths.add("_attachments");
+        }
+    });
+    return Array.from(paths);
+}
+/**
+ * Collects expression capabilities relevant for the query engine's
+ * guardrails: whether the expression needs decryption or a view-tree
+ * context (neither can be answered from the summary buffer).
+ */
+function analyzeExpressionRequirements(expression) {
+    let needsDecryption = false;
+    const viewContextOperations = new Set();
+    walkExpression(expression, (node) => {
+        if (node.kind === "decrypt") {
+            needsDecryption = true;
+        }
+        else if (node.kind === "operation" && exports.VIEW_CONTEXT_OPERATIONS.has(node.op)) {
+            viewContextOperations.add(node.op);
+        }
+    });
+    return {
+        needsDecryption,
+        needsViewContext: viewContextOperations.size > 0,
+        viewContextOperations: Array.from(viewContextOperations),
+    };
+}
+//# sourceMappingURL=evaluateExpression.js.map

package/dist/core/expressions/evaluateExpression.js.map

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

package/dist/core/expressions/formulaSource.d.ts

@@ -0,0 +1,24 @@
+import type { MindooDBAppBooleanExpression, MindooDBAppExpression } from "./types";
+/** Syntax error raised while parsing Formula source text into the shared AST. */
+export declare class MindooDBFormulaSyntaxError extends Error {
+    readonly index: number;
+    constructor(message: string, index: number);
+}
+/**
+ * Parses builder-call style Formula source into the shared expression AST.
+ *
+ * Example: `v.eq(v.field("status"), "approved")`
+ */
+export declare function parseMindooDBFormulaExpression(source: string): MindooDBAppExpression;
+/** Parses Formula source and narrows the result to a boolean expression for filter use cases. */
+export declare function parseMindooDBFormulaBooleanExpression(source: string): MindooDBAppBooleanExpression;
+/**
+ * Formats an expression into canonical Formula source with stable indentation
+ * and literal shorthand.
+ */
+export declare function formatMindooDBFormulaExpression(expression: MindooDBAppExpression, options?: {
+    indent?: string;
+}): string;
+/** Best-effort heuristic used by editor integrations to warn about non-boolean filters. */
+export declare function isMindooDBFormulaLikelyBoolean(expression: MindooDBAppExpression): boolean;
+//# sourceMappingURL=formulaSource.d.ts.map

package/dist/core/expressions/formulaSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulaSource.d.ts","sourceRoot":"","sources":["../../../src/core/expressions/formulaSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EAGtB,MAAM,SAAS,CAAC;AAyEjB,iFAAiF;AACjF,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAK3C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAQpF;AAED,iGAAiG;AACjG,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,GAAG,4BAA4B,CAElG;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,MAAM,CAGR;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAWzF"}