flowquery 1.0.86 → 1.0.88

package/dist/graph/relationship_reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationship_reference.d.ts","sourceRoot":"","sources":["../../src/graph/relationship_reference.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAG1C,cAAM,qBAAsB,SAAQ,YAAY;IAC5C,OAAO,CAAC,UAAU,CAA6B;gBACnC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY;IASzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,cAAc,CAAC,IAAI,CAAC;CAY7E;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"relationship_reference.d.ts","sourceRoot":"","sources":["../../src/graph/relationship_reference.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAG1C,cAAM,qBAAsB,SAAQ,YAAY;IAC5C,OAAO,CAAC,UAAU,CAA6B;gBACnC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY;IASzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,cAAc,CAAC,IAAI,CAAC;CAU7E;AAED,eAAe,qBAAqB,CAAC"}

package/dist/graph/relationship_reference.js

@@ -42,9 +42,8 @@ class RelationshipReference extends relationship_1.default {
     }
     find(left_id_1) {
         return __asyncGenerator(this, arguments, function* find_1(left_id, hop = 0) {
-            var _a;
             this.setValue(this._reference);
-            const data = (_a = this._reference.getData()) === null || _a === void 0 ? void 0 : _a.current(hop);
+            const data = this._reference.currentRecord(hop);
             const followId = this._direction === "left" ? "left_id" : "right_id";
             if (this._target) {
                 yield __await(yield* __asyncDelegator(__asyncValues(this._target.find(data[followId], hop))));

package/dist/graph/relationship_reference.js.map

@@ -1 +1 @@
-{"version":3,"file":"relationship_reference.js","sourceRoot":"","sources":["../../src/graph/relationship_reference.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kEAA0C;AAG1C,MAAM,qBAAsB,SAAQ,sBAAY;IAE5C,YAAY,IAAkB,EAAE,SAAuB;QACnD,KAAK,EAAE,CAAC;QAFJ,eAAU,GAAwB,IAAI,CAAC;QAG3C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAK,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IACa,IAAI;kEAAC,OAAe,EAAE,MAAc,CAAC;;YAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAW,CAAC,CAAC;YAChC,MAAM,IAAI,GAAuB,MAAA,IAAI,CAAC,UAAW,CAAC,OAAO,EAAE,0CAAE,OAAO,CAChE,GAAG,CACgB,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;YACrE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,cAAA,KAAK,CAAC,CAAC,iBAAA,cAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAA,CAAA,CAAA,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACJ,2BAAK,CAAC;YACV,CAAC;QACL,CAAC;KAAA;CACJ;AAED,kBAAe,qBAAqB,CAAC"}
+{"version":3,"file":"relationship_reference.js","sourceRoot":"","sources":["../../src/graph/relationship_reference.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kEAA0C;AAG1C,MAAM,qBAAsB,SAAQ,sBAAY;IAE5C,YAAY,IAAkB,EAAE,SAAuB;QACnD,KAAK,EAAE,CAAC;QAFJ,eAAU,GAAwB,IAAI,CAAC;QAG3C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAK,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IACa,IAAI;kEAAC,OAAe,EAAE,MAAc,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAW,CAAC,CAAC;YAChC,MAAM,IAAI,GAAuB,IAAI,CAAC,UAAW,CAAC,aAAa,CAAC,GAAG,CAAuB,CAAC;YAC3F,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;YACrE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,cAAA,KAAK,CAAC,CAAC,iBAAA,cAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAA,CAAA,CAAA,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACJ,2BAAK,CAAC;YACV,CAAC;QACL,CAAC;KAAA;CACJ;AAED,kBAAe,qBAAqB,CAAC"}

package/dist/graph/source_access.d.ts

@@ -0,0 +1,107 @@
+import ASTNode from "../parsing/ast_node";
+import Expression from "../parsing/expressions/expression";
+import SourceContext from "./source_context";
+import { NodeSourceProvider, PredicateCapabilities, PredicateOperator, RelationshipSourceProvider, SourcePredicate, SourceRow } from "./source_provider";
+/** A constraint FlowQuery may push to a source (evaluated per request). */
+export interface PushTerm {
+    op: PredicateOperator;
+    property: string;
+    value?: any;
+    values?: any[];
+}
+/** A WHERE comparison attached to a pattern node for push-down. */
+export interface PushedPredicate {
+    op: "gt" | "gte" | "lt" | "lte" | "in";
+    property: string;
+    expression: ASTNode;
+}
+export interface SourceTerms {
+    terms: PushTerm[];
+    /** Legacy `$args` equality map from the element's own static properties. */
+    args: Record<string, any> | null;
+}
+/**
+ * True when the expression only depends on literals and query
+ * parameters, i.e. its value is fixed for the whole query.
+ */
+export declare function isStaticExpression(node: ASTNode): boolean;
+/** Evaluate static element properties and pushed WHERE predicates into push terms. */
+export declare function buildTerms(properties: Map<string, Expression>, pushed: PushedPredicate[]): SourceTerms;
+export declare function predicateFor(caps: PredicateCapabilities | undefined, terms: PushTerm[]): SourcePredicate | null;
+/** Common node access used by deferred traversal. */
+export interface NodeAccess {
+    readonly deferred: boolean;
+    scan(terms: PushTerm[], args: Record<string, any> | null): AsyncIterable<SourceRow[]>;
+    lookup(id: any, terms: PushTerm[], args: Record<string, any> | null): Promise<SourceRow[]>;
+    prefetch(ids: any[], terms: PushTerm[], args: Record<string, any> | null): Promise<void>;
+    /** Selectivity hints for start-point selection. */
+    canLookup(): boolean;
+    pushes(terms: PushTerm[]): boolean;
+    estimate(terms: PushTerm[], args: Record<string, any> | null): number | undefined;
+}
+/** Common relationship access used by deferred traversal. */
+export interface RelationshipAccess {
+    readonly deferred: boolean;
+    /** Relationships whose `${side}_id` equals `anchor`, as pages. */
+    expand(anchor: any, side: "left" | "right", terms: PushTerm[], args: Record<string, any> | null): AsyncIterable<SourceRow[]>;
+    /**
+     * Batch-fetch relationships for many anchors.  Returns the buffered
+     * rows, or null when nothing was prefetched (not batch-capable or the
+     * buffer limit was exceeded).
+     */
+    prefetch(anchors: any[], side: "left" | "right", terms: PushTerm[], args: Record<string, any> | null): Promise<SourceRow[] | null>;
+}
+/** Provider-backed node access across one or more labels. */
+export declare class NodeSourceAccess implements NodeAccess {
+    private readonly ctx;
+    readonly deferred = true;
+    private _entries;
+    private _buffer;
+    constructor(ctx: SourceContext, entries: {
+        label: string;
+        provider: NodeSourceProvider;
+    }[]);
+    scan(terms: PushTerm[], args: Record<string, any> | null): AsyncGenerator<SourceRow[]>;
+    prefetch(ids: any[], terms: PushTerm[], args: Record<string, any> | null): Promise<void>;
+    lookup(id: any, terms: PushTerm[], args: Record<string, any> | null): Promise<SourceRow[]>;
+    canLookup(): boolean;
+    pushes(terms: PushTerm[]): boolean;
+    estimate(terms: PushTerm[], args: Record<string, any> | null): number | undefined;
+}
+/** Provider-backed relationship access across one or more types/endpoints. */
+export declare class RelationshipSourceAccess implements RelationshipAccess {
+    private readonly ctx;
+    readonly deferred = true;
+    private _entries;
+    private _buffer;
+    private _bufferSide;
+    constructor(ctx: SourceContext, entries: {
+        type: string;
+        sourceLabel: string | null;
+        targetLabel: string | null;
+        provider: RelationshipSourceProvider;
+    }[]);
+    expand(anchor: any, side: "left" | "right", terms: PushTerm[], args: Record<string, any> | null): AsyncGenerator<SourceRow[]>;
+    prefetch(anchors: any[], side: "left" | "right", terms: PushTerm[], args: Record<string, any> | null): Promise<SourceRow[] | null>;
+}
+/** In-memory node access over materialized legacy records (used by reversed plans). */
+export declare class MemoryNodeAccess implements NodeAccess {
+    private readonly _records;
+    readonly deferred = false;
+    constructor(_records: SourceRow[]);
+    scan(): AsyncGenerator<SourceRow[]>;
+    lookup(id: any): Promise<SourceRow[]>;
+    prefetch(): Promise<void>;
+    canLookup(): boolean;
+    pushes(): boolean;
+    estimate(): number | undefined;
+}
+/** In-memory relationship access over materialized legacy records (used by reversed plans). */
+export declare class MemoryRelationshipAccess implements RelationshipAccess {
+    private readonly _records;
+    readonly deferred = false;
+    constructor(_records: SourceRow[]);
+    expand(anchor: any, side: "left" | "right"): AsyncGenerator<SourceRow[]>;
+    prefetch(): Promise<SourceRow[] | null>;
+}
+//# sourceMappingURL=source_access.d.ts.map

package/dist/graph/source_access.d.ts.map

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