nesoi 3.2.1 → 3.2.2

package/lib/elements/blocks/job/internal/resource_job.js

@@ -30,7 +30,7 @@ class ResourceJob {
             obj = await scope.execMethod({ ...$, obj, bucket: scope.bucket });
         }
         if (scope.afterMethod) {
-            obj = await scope.afterMethod({ ...$, obj, bucket: scope.bucket });
+            await scope.afterMethod({ ...$, obj, bucket: scope.bucket });
         }
         return obj;
     }

package/lib/elements/blocks/resource/resource.builder.js

@@ -63,7 +63,7 @@ class ResourceBuilder extends block_builder_1.BlockBuilder {
         const jobBuilder = new resource_job_builder_1.ResourceJobBuilder(this.module, name, this._bucket.refName, 'query', alias, resource_1.Resource.query, this._authn)
             .input($ => ({
             view: $.enum(views).default(views[0]),
-            query: $.dict($.any).default({}),
+            query: $.dict($.any.optional).default({}),
             page: $.int.default(0),
             perPage: $.int.default(10)
         }))

package/lib/elements/blocks/resource/resource.js

@@ -120,6 +120,7 @@ class Resource extends block_1.Block {
                 if (type === 'query is empty') {
                     out = !(await trx.bucket(bucket.refName)
                         .query(arg)
+                        .params(obj)
                         .first());
                 }
                 else if (type === 'has no link') {

package/lib/elements/entities/bucket/adapters/bucket_adapter.d.ts

@@ -136,10 +136,10 @@ export declare abstract class BucketAdapter<Obj extends NesoiObj> {
     /**
      * Return the results of a query
      */
-    query<MetadataOnly extends boolean>(trx: AnyTrxNode, query: NQL_AnyQuery, pagination?: NQL_Pagination, params?: Record<string, any>, config?: {
+    query<MetadataOnly extends boolean>(trx: AnyTrxNode, query: NQL_AnyQuery, pagination?: NQL_Pagination, params?: Record<string, any>[], config?: {
         view?: string;
         metadataOnly?: MetadataOnly;
-    }): Promise<NQL_Result<MetadataOnly extends true ? {
+    }, runner?: NQLRunner): Promise<NQL_Result<MetadataOnly extends true ? {
         id: Obj['id'];
         [x: string]: any;
     } : Obj>>;

package/lib/elements/entities/bucket/adapters/bucket_adapter.js

@@ -25,14 +25,14 @@ class BucketAdapter {
     /**
      * Return the results of a query
      */
-    async query(trx, query, pagination, params, config) {
+    async query(trx, query, pagination, params, config, runner) {
         const module = trx_node_1.TrxNode.getModule(trx);
         const refName = (module.name === this.schema.module
             ? '' : `${this.schema.module}::`)
             + this.schema.name;
         const compiled = await nql_compiler_1.NQL_Compiler.build(module, refName, query);
         const view = config?.view ? this.schema.views[config.view] : undefined;
-        const result = await module.nql.run(trx, compiled, pagination, params, view);
+        const result = await module.nql.run(trx, compiled, pagination, params, view, runner);
         if (config?.metadataOnly) {
             result.data = result.data.map(obj => ({
                 id: obj.id,

package/lib/elements/entities/bucket/adapters/memory.nql.d.ts

@@ -10,7 +10,7 @@ export declare class MemoryNQLRunner extends NQLRunner {
     protected adapter?: AnyMemoryBucketAdapter;
     constructor();
     bind(adapter: AnyMemoryBucketAdapter): void;
-    run(trx: AnyTrxNode, part: NQL_Part, params: Obj, pagination?: NQL_Pagination): Promise<{
+    run(trx: AnyTrxNode, part: NQL_Part, params: Obj[], pagination?: NQL_Pagination): Promise<{
         data: any[];
         totalItems: number | undefined;
         page: number | undefined;

package/lib/elements/entities/bucket/adapters/memory.nql.js

@@ -21,7 +21,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
         let response;
         // Empty query, don't filter data
         if (part.union.inters.length === 0) {
-            response = data;
+            response = { ...data };
         }
         // Non-empty query
         else {
@@ -105,7 +105,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             for (const rule of inter.rules) {
                 // <Union>
                 if ('inters' in rule) {
-                    if (!_union(rule, objs, objs))
+                    if (!_union(rule, objs, params))
                         return false;
                 }
                 // <Rule>
@@ -132,8 +132,12 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
                     continue;
                 }
                 const obj = objs[id];
-                let match = _obj(rule, obj, params);
-                // console.log(`    -> match: ${match}\n`)
+                let match = false;
+                for (const paramGroup of params) {
+                    match = _obj(rule, obj, paramGroup);
+                    if (match)
+                        break;
+                }
                 if (rule.not) {
                     match = !match;
                 }
@@ -174,7 +178,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             let queryValue;
             // Value is a subquery, run union
             if ('subquery' in rule.value) {
-                const subOut = _union(rule.value.subquery.union, objs, params);
+                const subOut = _union(rule.value.subquery.union, objs, [params]);
                 const subList = Object.values(subOut);
                 // Subquery operator is for a list, filter
                 if (rule.op === 'in' || rule.op === 'contains_any') {

package/lib/elements/entities/bucket/bucket.d.ts

@@ -85,7 +85,7 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
         no_tenancy: boolean;
     }): Promise<Obj[]>;
     /**
-     * Read raw entity of a graph link
+     * Read raw entity of a graph link for 1 object
      *
      * - Options:
      *   - `silent`: If not found, return `undefined` instead of throwing an exception
@@ -95,6 +95,17 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
         silent?: boolean;
         no_tenancy?: boolean;
     }): Promise<Link['#many'] extends true ? Obj[] : (Obj | undefined)>;
+    /**
+     * Read raw entities of a graph link for N objects
+     *
+     * - Options:
+     *   - `silent`: If not found, return `undefined` instead of throwing an exception
+     *   - `no_tenancy`: Don't apply tenancy rules.
+     */
+    readManyLinks<LinkName extends keyof $['graph']['links'], Link extends $['graph']['links'][LinkName], LinkBucket extends Link['#bucket'], V extends ViewName<LinkBucket>, Obj extends ViewObj<LinkBucket, V>>(trx: AnyTrxNode, ids: $['#data']['id'][], link: LinkName, options?: {
+        silent?: boolean;
+        no_tenancy?: boolean;
+    }): Promise<Link['#many'] extends true ? Obj[] : (Obj | undefined)>;
     /**
      * Read the view of an entity of a graph link
      *
@@ -190,7 +201,7 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
      */
     query<V extends ViewName<$>, Obj extends ViewObj<$, V>>(trx: AnyTrxNode, query: NQL_AnyQuery, pagination?: NQL_Pagination, view?: V, options?: {
         no_tenancy?: boolean;
-        params?: Record<string, any>;
+        params?: Record<string, any>[];
     }): Promise<NQL_Result<Obj>>;
     /**
      * Add `created_by`, `created_at`, `updated_by` and `updated_at` fields to object

package/lib/elements/entities/bucket/bucket.js

@@ -120,7 +120,7 @@ class Bucket {
         let raws;
         // With Tenancy
         if (tenancy) {
-            const result = await this.adapter.query(trx, tenancy, undefined, options?.query_view ? { view: options?.query_view } : undefined);
+            const result = await this.adapter.query(trx, tenancy, undefined, options?.query_view ? [{ view: options?.query_view }] : undefined);
             raws = result.data;
         }
         // Without Tenancy
@@ -169,7 +169,7 @@ class Bucket {
     }
     // Graph
     /**
-     * Read raw entity of a graph link
+     * Read raw entity of a graph link for 1 object
      *
      * - Options:
      *   - `silent`: If not found, return `undefined` instead of throwing an exception
@@ -201,6 +201,44 @@ class Bucket {
         }
         return linkObj;
     }
+    /**
+     * Read raw entities of a graph link for N objects
+     *
+     * - Options:
+     *   - `silent`: If not found, return `undefined` instead of throwing an exception
+     *   - `no_tenancy`: Don't apply tenancy rules.
+     */
+    async readManyLinks(trx, ids, link, options) {
+        log_1.Log.debug('bucket', this.schema.name, `Read Link, ids=${ids} l=${link}`);
+        // Validate IDs
+        for (const id of ids) {
+            if (typeof id !== 'string' && typeof id !== 'number') {
+                throw error_1.NesoiError.Bucket.InvalidId({ bucket: this.schema.alias, id });
+            }
+        }
+        // Read object
+        const objs = await this.query(trx, {
+            'id in': ids
+        }).then(res => res.data);
+        // Empty response
+        if (!objs.length) {
+            const schema = this.schema.graph.links[link];
+            if (schema.many) {
+                return [];
+            }
+            return undefined;
+        }
+        // Read link
+        const linkObj = await this.graph.readManyLinks(trx, objs, link, options);
+        // TODO
+        // // Encryption
+        // if (linkObj) {
+        //     if (this.schema.model.hasEncryptedField) {
+        //         await this.decrypt(trx, linkObj);
+        //     }
+        // }
+        return linkObj;
+    }
     /**
      * Read the view of an entity of a graph link
      *

package/lib/elements/entities/bucket/graph/bucket_graph.d.ts

@@ -22,6 +22,17 @@ export declare class BucketGraph<M extends $Module, $ extends $Bucket> {
         silent?: boolean;
         no_tenancy?: boolean;
     }): Promise<Obj | Obj[] | undefined>;
+    /**
+     * Read the data from a link
+     *
+     * - Options
+     *   - `silent`: If not found, returns undefined instead of raising an exception (default: `false`)
+     *   - `no_tenancy`: Don't apply tenancy rules (default: `false`)
+     */
+    readManyLinks<LinkName extends keyof $['graph']['links'], LinkBucketName extends $['graph']['links'][LinkName]['bucket']['refName'], LinkBucket extends M['buckets'][LinkBucketName], Obj = LinkBucket['#data']>(trx: AnyTrxNode, objs: $['#data'][], link: LinkName, options?: {
+        silent?: boolean;
+        no_tenancy?: boolean;
+    }): Promise<Obj[] | Obj[][]>;
     /**
      * Read the data from a link and build it with a given view
      *

package/lib/elements/entities/bucket/graph/bucket_graph.js

@@ -4,6 +4,7 @@ exports.BucketGraph = void 0;
 const trx_node_1 = require("../../../../engine/transaction/trx_node");
 const log_1 = require("../../../../engine/util/log");
 const error_1 = require("../../../../engine/data/error");
+const memory_bucket_adapter_1 = require("../adapters/memory.bucket_adapter");
 /**
  * @category Elements
  * @subcategory Entity
@@ -35,7 +36,7 @@ class BucketGraph {
             '#and': tenancy
         }, {
             perPage: schema.many ? undefined : 1,
-        }, { ...obj });
+        }, [{ ...obj }]);
         // Empty response
         if (!schema.many && !schema.optional && !links.data.length) {
             // silent = undefined
@@ -57,6 +58,52 @@ class BucketGraph {
             return links.data[0];
         }
     }
+    /**
+     * Read the data from a link
+     *
+     * - Options
+     *   - `silent`: If not found, returns undefined instead of raising an exception (default: `false`)
+     *   - `no_tenancy`: Don't apply tenancy rules (default: `false`)
+     */
+    async readManyLinks(trx, objs, link, options) {
+        log_1.Log.trace('bucket', this.bucketName, `Read link ${link}`);
+        const schema = this.schema.links[link];
+        // Make tenancy query
+        const tenancy = (options?.no_tenancy)
+            ? undefined
+            : this.bucket.getTenancyQuery(trx);
+        // Query
+        const otherBucket = trx_node_1.TrxNode.getModule(trx).buckets[schema.bucket.refName];
+        // let tempData: Record<string, any> = {};
+        let tempAdapter;
+        if (otherBucket.adapter instanceof memory_bucket_adapter_1.MemoryBucketAdapter) {
+            tempAdapter = otherBucket.adapter;
+        }
+        else {
+            const allLinks = await otherBucket.adapter.query(trx, {
+                ...schema.query,
+                '#and': tenancy
+            }, undefined, objs.map(obj => ({ ...obj })));
+            const tempData = {};
+            for (const obj of allLinks.data)
+                tempData[obj.id] = obj;
+            tempAdapter = new memory_bucket_adapter_1.MemoryBucketAdapter(otherBucket.schema, tempData);
+        }
+        const links = [];
+        for (const obj of objs) {
+            const result = await tempAdapter.query(trx, schema.query, {
+                perPage: schema.many ? undefined : 1,
+            }, [{ ...obj }], undefined, tempAdapter.nql);
+            if (schema.many) {
+                links.push(result.data);
+            }
+            else {
+                links.push(result.data[0]);
+            }
+        }
+        // Empty response
+        return links;
+    }
     /**
      * Read the data from a link and build it with a given view
      *
@@ -102,7 +149,7 @@ class BucketGraph {
             '#and': tenancy
         }, {
             perPage: 1,
-        }, { ...obj });
+        }, [{ ...obj }]);
         return !!links.data.length;
     }
 }

package/lib/elements/entities/bucket/model/bucket_model.schema.js

@@ -55,7 +55,6 @@ class $BucketModel {
                 }
                 // If it's a list or dict, or an object 
                 if (field.type === 'list' || field.type === 'dict') {
-                    // If not, iterate
                     next.push({
                         i: item.i + 1,
                         field: field.children['#']
@@ -70,6 +69,10 @@ class $BucketModel {
                     })));
                     continue;
                 }
+                if (field.type === 'unknown') {
+                    results.push(field);
+                    continue;
+                }
                 const child = field.children[path];
                 if (child) {
                     next.push({
@@ -127,53 +130,53 @@ class $BucketModel {
         while (poll.length) {
             const next = [];
             for (const entry of poll) {
-                const val = obj[entry.path];
+                const val = entry.obj[entry.path];
                 if (val === undefined) {
                     continue;
                 }
                 if (val === null) {
-                    copy[entry.path] = null;
+                    entry.copy[entry.path] = null;
                     continue;
                 }
                 if (entry.field.type === 'list') {
                     if (!Array.isArray(val))
                         continue;
-                    copy[entry.path] = [];
+                    entry.copy[entry.path] = [];
                     next.push(...val.map((_, i) => ({
                         path: i.toString(),
                         obj: val,
-                        copy: copy[entry.path],
+                        copy: entry.copy[entry.path],
                         field: entry.field.children['*']
                     })));
                 }
                 else if (entry.field.type === 'dict') {
                     if (typeof val !== 'object' || Array.isArray(val))
                         continue;
-                    copy[entry.path] = {};
+                    entry.copy[entry.path] = {};
                     next.push(...Object.keys(val).map((path) => ({
                         path,
                         obj: val,
-                        copy: copy[entry.path],
+                        copy: entry.copy[entry.path],
                         field: entry.field.children['*']
                     })));
                 }
                 else if (entry.field.type === 'obj') {
                     if (typeof val !== 'object' || Array.isArray(val))
                         continue;
-                    copy[entry.path] = {};
+                    entry.copy[entry.path] = {};
                     next.push(...Object.keys(entry.field.children).map(path => ({
                         path: path,
                         obj: val,
-                        copy: copy[entry.path],
+                        copy: entry.copy[entry.path],
                         field: entry.field.children[path]
                     })));
                 }
                 else if (entry.field.type === 'union') {
                     // TODO: ??????????   
-                    copy[entry.path] = obj[entry.path];
+                    entry.copy[entry.path] = entry.obj[entry.path];
                 }
                 else {
-                    copy[entry.path] = obj[entry.path];
+                    entry.copy[entry.path] = entry.obj[entry.path];
                 }
             }
             poll = next;

package/lib/elements/entities/bucket/query/nql_engine.d.ts

@@ -15,7 +15,7 @@ export type NQL_Result<T = Obj> = {
  * @category NQL
  * */
 export declare abstract class NQLRunner {
-    abstract run(trx: AnyTrxNode, part: NQL_Part, params: Record<string, any>, pagination?: NQL_Pagination, view?: $BucketView): Promise<NQL_Result>;
+    abstract run(trx: AnyTrxNode, part: NQL_Part, params: Record<string, any>[], pagination?: NQL_Pagination, view?: $BucketView): Promise<NQL_Result>;
 }
 /**
  * @category NQL
@@ -24,7 +24,7 @@ export declare class NQL_Engine {
     private module;
     private runners;
     constructor(module: AnyModule);
-    run(trx: AnyTrxNode, query: NQL_CompiledQuery, pagination?: NQL_Pagination, params?: Record<string, any>, view?: $BucketView): Promise<NQL_Result>;
+    run(trx: AnyTrxNode, query: NQL_CompiledQuery, pagination?: NQL_Pagination, params?: Record<string, any>[], view?: $BucketView, runner?: NQLRunner): Promise<NQL_Result>;
     linkExternal(bucket: AnyBucket): void;
 }
 export {};

package/lib/elements/entities/bucket/query/nql_engine.js

@@ -22,7 +22,9 @@ class NQL_Engine {
             }
         }
     }
-    async run(trx, query, pagination, params = {}, view) {
+    async run(trx, query, pagination, params = [{}], view, runner) {
+        if (!params.length)
+            params = [{}];
         let result = {
             data: []
         };
@@ -30,8 +32,8 @@ class NQL_Engine {
             const part_i = query.execOrder[i];
             const part = query.parts[part_i];
             // Run part
-            const runner = this.runners[part.union.meta.scope];
-            const out = await runner.run(trx, part, params, pagination, view);
+            const _runner = runner || this.runners[part.union.meta.scope];
+            const out = await _runner.run(trx, part, params, pagination, view);
             result = out;
             // Part failed, return
             // Failure here is only when a single value is expected,
@@ -43,7 +45,9 @@ class NQL_Engine {
                 }
             }
             // Fill part params
-            params[`%__${part_i}__%`] = part.many ? result.data : result.data[0];
+            for (const paramGroup of params) {
+                paramGroup[`%__${part_i}__%`] = part.many ? result.data : result.data[0];
+            }
         }
         return result;
     }

package/lib/elements/entities/bucket/view/bucket_view.js

@@ -4,9 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BucketView = void 0;
+const trx_node_1 = require("../../../../engine/transaction/trx_node");
 const promise_1 = __importDefault(require("../../../../engine/util/promise"));
 const error_1 = require("../../../../engine/data/error");
 const tree_1 = require("../../../../engine/data/tree");
+const dependency_1 = require("../../../../engine/dependency");
 class ViewValue {
     constructor() {
         this.value = undefined;
@@ -27,6 +29,7 @@ class BucketView {
             Object.assign(parsed, raw);
         }
         let layer = Object.values(this.schema.fields).map(field => ({
+            bucket: this.bucket,
             field,
             data: [{
                     raw,
@@ -54,6 +57,7 @@ class BucketView {
             parseds.push(parsed);
         }
         let layer = Object.values(this.schema.fields).map(field => ({
+            bucket: this.bucket,
             field,
             data: raws.map((raw, i) => ({
                 raw,
@@ -89,7 +93,7 @@ class BucketView {
         for (const node of layer) {
             if (node.field.scope !== 'graph')
                 continue;
-            await this.parseGraphProp(trx, node);
+            next.push(...await this.parseGraphProp(trx, node));
         }
         // Drive props
         for (const node of layer) {
@@ -109,6 +113,7 @@ class BucketView {
                 }
             }
             next.push(...Object.values(node.field.children).map(field => ({
+                bucket: node.bucket,
                 field,
                 data: node.data
             })));
@@ -118,6 +123,7 @@ class BucketView {
             if (!node.field.chain)
                 continue;
             next.push({
+                bucket: node.bucket,
                 field: node.field.chain,
                 data: node.data.map(d => ({
                     index: d.index,
@@ -144,6 +150,7 @@ class BucketView {
             if (key === '__raw')
                 continue;
             next.push({
+                bucket: node.bucket,
                 field: node.field.children[key],
                 data: nextData
             });
@@ -249,7 +256,7 @@ class BucketView {
     async parseComputedProp(trx, node) {
         const meta = node.field.meta.computed;
         for (const entry of node.data) {
-            entry.target[node.field.name] = await promise_1.default.solve(meta.fn({ trx, raw: entry.raw, bucket: this.bucket.schema }));
+            entry.target[node.field.name] = await promise_1.default.solve(meta.fn({ trx, raw: entry.raw, bucket: node.bucket.schema }));
         }
     }
     /**
@@ -257,23 +264,69 @@ class BucketView {
      */
     async parseGraphProp(trx, node) {
         const meta = node.field.meta.graph;
-        for (const entry of node.data) {
-            let link;
-            if (!meta.view) {
-                link = this.bucket.graph.readLink(trx, entry.raw, meta.link, { silent: true });
+        const links = await node.bucket.graph.readManyLinks(trx, node.data.map(entry => entry.raw), meta.link, { silent: true });
+        for (let i = 0; i < links.length; i++) {
+            if (meta.view) {
+                const link = node.bucket.schema.graph.links[meta.link];
+                node.data[i].target[node.field.name] = link.many ? [] : {};
             }
             else {
-                link = this.bucket.graph.viewLink(trx, entry.raw, meta.link, meta.view, { silent: true });
+                node.data[i].target[node.field.name] = links[i];
             }
-            entry.target[node.field.name] = await promise_1.default.solve(link);
         }
+        let next = [];
+        if (meta.view) {
+            const schema = node.bucket.schema;
+            const otherBucketDep = schema.graph.links[meta.link].bucket;
+            const module = trx_node_1.TrxNode.getModule(trx);
+            const otherBucket = dependency_1.$Dependency.resolve(module.schema, otherBucketDep);
+            const view = otherBucket.views[meta.view];
+            const { __raw, ...v } = view.fields;
+            const link = node.bucket.schema.graph.links[meta.link];
+            let nextData;
+            if (link.many) {
+                const _links = links;
+                for (let i = 0; i < _links.length; i++) {
+                    const target = node.data[i].target[node.field.name];
+                    for (let j = 0; j < _links[i].length; j++) {
+                        target.push(__raw ? { ..._links[i][j] } : {});
+                        target[j].$v = meta.view;
+                    }
+                }
+                nextData = _links.map((ll, i) => ll.map((l, j) => ({ value: l, target: node.data[i].target[node.field.name][j] }))).flat(1);
+            }
+            else {
+                const _links = links;
+                for (let i = 0; i < _links.length; i++) {
+                    const target = node.data[i].target[node.field.name];
+                    if (__raw) {
+                        Object.assign(target, _links[i]);
+                    }
+                    target.$v = meta.view;
+                }
+                nextData = _links.map((l, i) => ({
+                    value: l, target: node.data[i].target[node.field.name]
+                }));
+            }
+            next = Object.values(v).map(field => ({
+                bucket: module.buckets[otherBucketDep.refName],
+                field,
+                data: nextData.map($ => ({
+                    raw: $.value,
+                    value: $.value,
+                    index: [],
+                    target: $.target
+                }))
+            }));
+        }
+        return next;
     }
     /**
      * [drive]
      */
     async parseDriveProp(trx, node) {
-        if (!this.bucket.drive) {
-            throw error_1.NesoiError.Bucket.Drive.NoAdapter({ bucket: this.bucket.schema.alias });
+        if (!node.bucket.drive) {
+            throw error_1.NesoiError.Bucket.Drive.NoAdapter({ bucket: node.bucket.schema.alias });
         }
         const meta = node.field.meta.drive;
         for (const entry of node.data) {
@@ -281,12 +334,12 @@ class BucketView {
             if (Array.isArray(value)) {
                 const public_urls = [];
                 for (const obj of value) {
-                    public_urls.push(await this.bucket.drive.public(obj));
+                    public_urls.push(await node.bucket.drive.public(obj));
                 }
                 entry.target[node.field.name] = public_urls;
             }
             else {
-                entry.target[node.field.name] = await this.bucket.drive.public(value);
+                entry.target[node.field.name] = await node.bucket.drive.public(value);
             }
         }
     }

package/lib/engine/transaction/nodes/bucket.trx_node.d.ts

@@ -64,6 +64,11 @@ export declare class BucketTrxNode<M extends $Module, $ extends $Bucket> {
      * or `undefined` if the graph link doesn't resolve.
      */
     readLink<LinkName extends keyof $['graph']['links'], Link extends $['graph']['links'][LinkName], Obj extends Link['#bucket']['#data']>(id: $['#data']['id'], link: LinkName): Promise<Link['#many'] extends true ? Obj[] : (Obj | undefined)>;
+    /**
+     * Returns one or more objects referenced by the graph link,
+     * or `undefined` if the graph link doesn't resolve.
+     */
+    readManyLinks<LinkName extends keyof $['graph']['links'], Link extends $['graph']['links'][LinkName], Obj extends Link['#bucket']['#data']>(ids: $['#data']['id'][], link: LinkName): Promise<Link['#many'] extends true ? Obj[] : (Obj | undefined)>;
     /**
      * Returns one or more objects referenced by the graph link built with a view,
      * or `undefined` if the graph link doesn't resolve.

package/lib/engine/transaction/nodes/bucket.trx_node.js

@@ -133,6 +133,16 @@ class BucketTrxNode {
             no_tenancy: !this.enableTenancy
         }));
     }
+    /**
+     * Returns one or more objects referenced by the graph link,
+     * or `undefined` if the graph link doesn't resolve.
+     */
+    async readManyLinks(ids, link) {
+        return this.wrap('readLinks', { ids, link }, trx => this.bucket.readManyLinks(trx, ids, link, {
+            silent: true,
+            no_tenancy: !this.enableTenancy
+        }));
+    }
     /**
      * Returns one or more objects referenced by the graph link built with a view,
      * or `undefined` if the graph link doesn't resolve.

package/lib/engine/transaction/nodes/bucket_query.trx_node.d.ts

@@ -14,8 +14,10 @@ export declare class BucketQueryTrxNode<M extends $Module, B extends $Bucket, V
     private query;
     private enableTenancy;
     private view?;
+    private _params?;
     constructor(trx: TrxNode<any, M, any>, bucket: Bucket<M, B>, query: NQL_AnyQuery, enableTenancy: boolean, view?: V | undefined);
     merge($: NQL_Query<M, B>): void;
+    params(value: Record<string, any>): this;
     first(): Promise<Obj | undefined>;
     firstOrFail(): Promise<Obj>;
     all(): Promise<Obj[]>;