@ballistix.digital/odata-query-builder 0.7.0 → 0.8.0

package/dist/module/query/util/filter/scopeProxy.util.js

@@ -1,93 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rootScope = exports.createMember = exports.nodeOf = void 0;
-/**
- * The JavaScript built-in class `Proxy` behind a filter scope: `createMember`, `rootScope`, and
- * `nodeOf` — the one place a node comes back out of a proxy.
- *
- * THE COLLISION PROBLEM AND ITS FIX
- * ---------------------------------
- * At runtime a property name carries no type, so `a.year` is ambiguous: the
- * `year()` date function, or a column actually called `year`. A single
- * "methods first, path second" Proxy has to guess, and guesses wrong on every
- * entity with a column named `year`, `name`, `length` or `date`.
- *
- * The fix: a property read NEVER resolves a function. Reading `x.foo` always
- * returns a *member* — a callable proxy that remembers (parent node, "foo").
- *   - Read further from it     -> "foo" was a path segment: `parent/foo`.
- *   - CALL it                  -> "foo" was a function: `foo(parent)`.
- * A path segment is never called and a function is never left uncalled, so the
- * two roles are told apart by syntax the caller already writes. A column named
- * `year` therefore works, and so does `year()` over a sibling column, in the
- * same expression.
- *
- * The node itself is reachable only through a Symbol, which no DTO key can be.
- *
- * The import back into `filterFunction.util.ts` is a real (not type-only)
- * cycle, and so is `literal.util.ts`'s import back into this file. Both are
- * safe because nothing here runs at module load: a trap body is entered when a
- * caller builds a filter, long after every module has finished loading.
- */
-const invalidFilter_exception_1 = require("../../exception/invalidFilter.exception");
-const reservedName_exception_1 = require("../../exception/reservedName.exception");
-const filterFunction_util_1 = require("./filterFunction.util");
-const literal_util_1 = require("./literal.util");
-/** The only key that reads a node. A DTO key can never be a symbol. */
-const NODE = Symbol('odata.node');
-/** The node behind a scope proxy, or `undefined` for a plain value. */
-const nodeOf = (value) => typeof value === 'function' || (typeof value === 'object' && value !== null)
-    ? value[NODE]
-    : undefined;
-exports.nodeOf = nodeOf;
-/**
- * `createMember(node)` is a value; `createMember(node, parent, name)` is a
- * member of `parent` that has not yet decided whether it is a path segment or
- * a function call.
- *
- * The target is an arrow function so the proxy is callable. An arrow function
- * has no `prototype`, and its `name`/`length` are configurable, so no Proxy
- * invariant forces a value through — a DTO column called `name` or `length`
- * still reaches the trap.
- *
- * `v.name.eq('x')` on `rootScope()` gives `name eq 'x'`. See
- * docs/maintainer/architecture.md, How `Proxy` works here.
- */
-const createMember = (node, parent, name) => 
-// The target is never invoked: the `apply` trap owns every call. It only
-// has to BE callable, so the Proxy accepts an `apply` trap at all.
-new Proxy(/* istanbul ignore next */ (() => undefined), {
-    get(_target, property) {
-        if (property === NODE)
-            return node;
-        if (typeof property !== 'string')
-            return undefined;
-        // Reserved names THROW rather than return undefined, so `await q`,
-        // `JSON.stringify(q)` and an implicit `${q}`/arithmetic coercion fail
-        // loudly instead of silently — the last two would otherwise reach
-        // `apply` as a call to a function named `toString`/`valueOf` that the
-        // OData function table does not know, a confusing error to land on.
-        if (property === 'then' ||
-            property === 'toJSON' ||
-            property === 'toString' ||
-            property === 'valueOf')
-            throw new reservedName_exception_1.ReservedNameError(property);
-        return (0, exports.createMember)(new literal_util_1.ExpressionNode(node.text ? `${node.text}/${property}` : property, node.depth), node, property);
-    },
-    apply(_target, _thisArgument, callArguments) {
-        if (parent === undefined || name === undefined)
-            throw new invalidFilter_exception_1.InvalidFilterError(`"${node.text}" is a property path, not a function`, node.text);
-        const method = (0, filterFunction_util_1.filterFunction)(name);
-        if (method === undefined)
-            throw new invalidFilter_exception_1.InvalidFilterError(`${name}() is not an OData filter function served by this API`, name);
-        return method(parent, callArguments);
-    },
-    has: (_target, property) => typeof property === 'string',
-});
-exports.createMember = createMember;
-/**
- * The filter scope of an entity: an empty path at lambda depth 0. An expanded
- * entity is filtered relative to itself, so it takes the same empty root.
- */
-const rootScope = () => (0, exports.createMember)(new literal_util_1.ExpressionNode('', 0));
-exports.rootScope = rootScope;
-//# sourceMappingURL=scopeProxy.util.js.map

package/dist/module/query/util/filter/scopeProxy.util.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scopeProxy.util.js","sourceRoot":"","sources":["../../../../../src/module/query/util/filter/scopeProxy.util.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qFAA6E;AAC7E,mFAA2E;AAC3E,+DAAuD;AACvD,iDAAgD;AAEhD,uEAAuE;AACvE,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAElC,uEAAuE;AAChE,MAAM,MAAM,GAAG,CAAC,KAAc,EAA8B,EAAE,CACpE,OAAO,KAAK,KAAK,UAAU,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;IAC3E,CAAC,CAAG,KAAiC,CAAC,IAAI,CAAgC;IAC1E,CAAC,CAAC,SAAS,CAAC;AAHD,QAAA,MAAM,UAGL;AAEd;;;;;;;;;;;;GAYG;AACI,MAAM,YAAY,GAAG,CAC3B,IAAoB,EACpB,MAAuB,EACvB,IAAa,EACP,EAAE;AACR,yEAAyE;AACzE,mEAAmE;AACnE,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAsB,EAAE;IAC5E,GAAG,CAAC,OAAO,EAAE,QAAQ;QACpB,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACnD,mEAAmE;QACnE,sEAAsE;QACtE,kEAAkE;QAClE,sEAAsE;QACtE,oEAAoE;QACpE,IACC,QAAQ,KAAK,MAAM;YACnB,QAAQ,KAAK,QAAQ;YACrB,QAAQ,KAAK,UAAU;YACvB,QAAQ,KAAK,SAAS;YAEtB,MAAM,IAAI,0CAAiB,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,IAAA,oBAAY,EAClB,IAAI,6BAAc,CACjB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,EACjD,IAAI,CAAC,KAAK,CACV,EACD,IAAI,EACJ,QAAQ,CACR,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,aAAwB;QACrD,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAC7C,MAAM,IAAI,4CAAkB,CAC3B,IAAI,IAAI,CAAC,IAAI,sCAAsC,EACnD,IAAI,CAAC,IAAI,CACT,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,oCAAc,EAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS;YACvB,MAAM,IAAI,4CAAkB,CAC3B,GAAG,IAAI,uDAAuD,EAC9D,IAAI,CACJ,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,CAAC;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ;CACxD,CAAC,CAAC;AA/CS,QAAA,YAAY,gBA+CrB;AAEJ;;;GAGG;AACI,MAAM,SAAS,GAAG,GAAQ,EAAE,CAAC,IAAA,oBAAY,EAAC,IAAI,6BAAc,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAA/D,QAAA,SAAS,aAAsD"}