@dxos/echo-query 0.8.4-main.f9ba587 → 0.8.4-main.fcc0d83b33

package/dist/types/src/parser/query-builder.d.ts

@@ -0,0 +1,89 @@
+import { type Tree } from '@lezer/common';
+import { Filter, type Tag } from '@dxos/echo';
+export type BuildResult = {
+    filter?: Filter.Any;
+    name?: string;
+};
+/**
+ * Stateless query builder that parses DSL trees into filters.
+ *
+ * NOTE: QueryBuilder was largely developed using Claude Sonnet 4.5 (in Windsurf)..
+ * To modify the functionality, create a minimal breaking test and direct the LLM to fix either the grammar or builder.
+ */
+export declare class QueryBuilder {
+    private readonly _tags?;
+    private readonly _parser;
+    constructor(_tags?: Tag.Map | undefined);
+    /**
+     * Check valid input.
+     */
+    validate(input: string): boolean;
+    /**
+     * Build a query from the input string.
+     */
+    build(input: string): BuildResult;
+    /**
+     * Build a query from a parsed DSL tree.
+     */
+    buildQuery(tree: Tree, input: string): BuildResult;
+    /**
+     * Parse an assignment node.
+     */
+    private _parseAssignment;
+    /**
+     * Parse an expression node.
+     */
+    private _parseExpression;
+    /**
+     * Parse a binary expression (AND/OR).
+     */
+    private _parseBinaryExpression;
+    /**
+     * Parse a Filter node.
+     */
+    private _parseFilter;
+    /**
+     * Parse a TypeFilter node (type:typename).
+     */
+    private _parseTypeFilter;
+    /**
+     * Parse a TextFilter node (quoted string).
+     */
+    private _parseTextFilter;
+    /**
+     * Parse an ObjectLiteral node.
+     */
+    private _parseObjectLiteral;
+    /**
+     * Parse an ObjectProperty node.
+     */
+    private _parseObjectProperty;
+    /**
+     * Parse a PropertyFilter node (property:value).
+     */
+    private _parsePropertyFilter;
+    /**
+     * Parse a PropertyPath node (supports dot notation).
+     */
+    private _parsePropertyPath;
+    /**
+     * Parse a TagFilter node (#tag).
+     */
+    private _parseTagFilter;
+    /**
+     * Parse a Value node.
+     */
+    private _parseValue;
+    /**
+     * Get the text content of the current node.
+     */
+    private _getNodeText;
+}
+/**
+ * Normalize raw user input into a form the lezer grammar can parse.
+ * - Bare text fragments (e.g. `foo`) are wrapped in quotes so they parse as TextFilter.
+ * - Property values that aren't already quoted/numeric/boolean (e.g. `from:rich@dxos.org`) are quoted.
+ * - Tags, type filters, operators, parens, braces, quoted strings, and assignments pass through unchanged.
+ */
+export declare const normalizeInput: (input: string) => string;
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/types/src/parser/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../../src/parser/query-builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,IAAI,EAAmB,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAFnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuD;IAE/E,YAA6B,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,YAAA,EAAI;IAEhD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO/B;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAQhC;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAuCjD;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmExB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwF9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAsCpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwDnB;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB;AA2BD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,MA+M9C,CAAC"}

package/dist/types/src/parser/query.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query.test.d.ts.map

package/dist/types/src/parser/query.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.test.d.ts","sourceRoot":"","sources":["../../../../src/parser/query.test.ts"],"names":[],"mappings":""}

package/dist/types/src/query-lite/index.d.ts

@@ -0,0 +1,2 @@
+export * from './query-lite';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/query-lite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/query-lite/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC"}

package/dist/types/src/query-lite/query-lite.d.ts

@@ -0,0 +1,8 @@
+import type { Filter as Filter$, Order as Order$, Query as Query$ } from '@dxos/echo';
+declare const Order2: typeof Order$;
+export { Order2 as Order };
+export declare const Filter1: typeof Filter$;
+export { Filter1 as Filter };
+export declare const Query1: typeof Query$;
+export { Query1 as Query };
+//# sourceMappingURL=query-lite.d.ts.map

package/dist/types/src/query-lite/query-lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-lite.d.ts","sourceRoot":"","sources":["../../../../src/query-lite/query-lite.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,IAAI,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,MAAM,EAAO,MAAM,YAAY,CAAC;AAsC3F,QAAA,MAAM,MAAM,EAAE,OAAO,MAAe,CAAC;AACrC,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;AAoR3B,eAAO,MAAM,OAAO,EAAE,OAAO,OAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAC;AA8Q7B,eAAO,MAAM,MAAM,EAAE,OAAO,MAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC"}

package/dist/types/src/sandbox/index.d.ts

@@ -0,0 +1,2 @@
+export * from './query-sandbox';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/sandbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC"}

package/dist/types/src/sandbox/query-sandbox.d.ts

@@ -0,0 +1,21 @@
+import { Resource } from '@dxos/context';
+import { type QueryAST } from '@dxos/echo';
+import { type QuickJSWASMModule } from '@dxos/vendor-quickjs';
+/**
+ * Evaluates queries written in JavaScript using QuickJS.
+ * Queries are expected to use the echo Query API.
+ * `Query`, `Filter` and `Order` are provided as globals.
+ */
+export declare class QuerySandbox extends Resource {
+    #private;
+    private static quickJS;
+    static getQuickJS(): Promise<QuickJSWASMModule>;
+    protected _open(): Promise<void>;
+    protected _close(): Promise<void>;
+    /**
+     * Evaluates the query code.
+     * @param queryCode Example: `Query.select(Filter.typename('org.dxos.type.person'))`
+     */
+    eval(queryCode: string): QueryAST.Query;
+}
+//# sourceMappingURL=query-sandbox.d.ts.map

package/dist/types/src/sandbox/query-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-sandbox.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/query-sandbox.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAuB,KAAK,iBAAiB,EAAiB,MAAM,sBAAsB,CAAC;AAMlG;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,QAAQ;;IAExC,OAAO,CAAC,MAAM,CAAC,OAAO,CAA2C;IACjE,MAAM,CAAC,UAAU,+BAMhB;IAID,UAAyB,KAAK,kBAY7B;IAED,UAAyB,MAAM,kBAE9B;IAED;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,KAAK,CAiBtC;CACF"}

package/dist/types/src/sandbox/query-sandbox.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-sandbox.test.d.ts.map

package/dist/types/src/sandbox/query-sandbox.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-sandbox.test.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/query-sandbox.test.ts"],"names":[],"mappings":""}

package/dist/types/src/sandbox/quickjs.d.ts

@@ -0,0 +1,8 @@
+import { type QuickJSContext, type QuickJSHandle, type SuccessOrFail } from '@dxos/vendor-quickjs';
+/**
+ * Unwraps a result and throws the underlying error.
+ *
+ * Replacement for `QuickJScontext.unwrapResult` because that seems to cause an OOM.
+ */
+export declare const unwrapResult: <T>(context: QuickJSContext, result: SuccessOrFail<T, QuickJSHandle>) => T;
+//# sourceMappingURL=quickjs.d.ts.map

package/dist/types/src/sandbox/quickjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickjs.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/quickjs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEnG;;;;GAIG;AAEH,eAAO,MAAM,YAAY,GAAI,CAAC,WAAW,cAAc,UAAU,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,KAAG,CAoBlG,CAAC"}

package/dist/types/src/sandbox/quickjs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quickjs.test.d.ts.map

package/dist/types/src/sandbox/quickjs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickjs.test.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/quickjs.test.ts"],"names":[],"mappings":""}