nesoi 3.3.5 → 3.3.7

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

@@ -51,7 +51,9 @@ class ResourceJobBuilder extends block_builder_1.BlockBuilder {
     input(def) {
         this._msg.template($ => {
             const fields = def($);
-            for (const f in this.implicitFields || []) {
+            for (const f in this.implicitFields || {}) {
+                if (f in fields)
+                    continue;
                 const [type, arg, required] = this.implicitFields[f];
                 fields[f] = arg
                     ? $[type](arg)

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

@@ -42,8 +42,7 @@ class ResourceBuilder extends block_builder_1.BlockBuilder {
             id: $.string_or_number.optional,
             perPage: $.int.default(10),
             page: $.int.default(0),
-            orderBy: $.string.optional,
-            orderDesc: $.boolean.default(false)
+            sort: $.list($.literal(/.@(asc|desc)/)).optional
         }))
             .prepare(resource_job_1.ResourceJob.prepareMsgData);
         this._inlineNodes.push(new dependency_1.BuilderNode({
@@ -170,7 +169,7 @@ class ResourceBuilder extends block_builder_1.BlockBuilder {
             const defaultTrigger = (0, bucket_model_convert_1.convertToMessage)(module.name, model, createDep.tag.name, `Create ${node.builder._alias || node.builder.name}`, [], [], ['id']);
             inlineJobsConfig[createDep.tag.name] = {
                 ResourceJob: {
-                    idType: null,
+                    idType: undefined,
                     output: { raw: modelName },
                     defaultTrigger
                 }

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

@@ -76,6 +76,7 @@ class Resource extends block_1.Block {
     /* Implementations */
     static view($) {
         const scope = $.job.scope;
+        // TODO: sort
         return $.msg.id
             ? $.trx.bucket(scope.bucket).viewOneOrFail($.msg.id, $.msg.view)
             : $.trx.bucket(scope.bucket).viewAll($.msg.view);

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

@@ -136,8 +136,12 @@ export declare abstract class BucketAdapter<Obj extends NesoiObj> {
     };
     /**
      * Return the results of a query
+     * - `pagination`: Limits the number of results.
+     *  - `perPage`: If 0, returns no results (useful with config.metadataOnly). If -1, returns all results.
+     * - `params`: Objects to be used when filling param values. The query returns objects matching *any* of the param objects.
+     * - `param_templates`: Path parameter replacements to be used when filling param_with_$ values. The query returns objects matching *any* of the param objects.
      */
-    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>[], param_templates?: Record<string, string>[], config?: {
         view?: string;
         metadataOnly?: MetadataOnly;
     }, custom?: {

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

@@ -24,8 +24,12 @@ class BucketAdapter {
     /* Generic Implementation */
     /**
      * Return the results of a query
+     * - `pagination`: Limits the number of results.
+     *  - `perPage`: If 0, returns no results (useful with config.metadataOnly). If -1, returns all results.
+     * - `params`: Objects to be used when filling param values. The query returns objects matching *any* of the param objects.
+     * - `param_templates`: Path parameter replacements to be used when filling param_with_$ values. The query returns objects matching *any* of the param objects.
      */
-    async query(trx, query, pagination, params, config, 
+    async query(trx, query, pagination, params, param_templates, config, 
     // When running a temporary local memory adapter,
     // these are required
     custom) {
@@ -33,7 +37,7 @@ class BucketAdapter {
         const moduleName = custom?.module || module.name;
         const compiled = await nql_compiler_1.NQL_Compiler.build(module.daemon, moduleName, this.schema.name, query, custom?.metadata);
         const view = config?.view ? this.schema.views[config.view] : undefined;
-        const result = await module.nql.run(trx, compiled, pagination, params, view, custom?.runners);
+        const result = await module.nql.run(trx, compiled, pagination, params, param_templates, view, custom?.runners);
         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[], param_templates: Record<string, string>[], pagination?: NQL_Pagination): Promise<{
         data: any[];
         totalItems: number | undefined;
         page: number | undefined;

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

@@ -13,7 +13,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
     bind(adapter) {
         this.adapter = adapter;
     }
-    async run(trx, part, params, pagination) {
+    async run(trx, part, params, param_templates, pagination) {
         if (!this.adapter) {
             throw new Error('No adapter bound to NQL Runner');
         }
@@ -25,33 +25,35 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
         }
         // Non-empty query
         else {
-            response = await this.filter(part, data, params);
+            response = await this.filter(part, data, params, param_templates);
         }
         let output = Object.values(response);
-        if (part.union.order) {
-            const by = part.union.order.by.length
-                ? part.union.order.by
-                : [this.adapter.config.meta.updated_at];
+        if (part.union.sort) {
+            const sort = part.union.sort.length
+                ? part.union.sort
+                : [{ key: this.adapter.config.meta.updated_at, dir: 'desc' }];
             output.sort((a, b) => {
-                for (let i = 0; i < by.length; i++) {
-                    const key = by[i];
-                    if (typeof a[key] == 'number') {
-                        if (typeof b[key] !== 'number')
-                            throw new Error(`Cannot compare number and ${typeof b[key]}`);
-                        let d = a[key] - b[key];
+                for (let i = 0; i < sort.length; i++) {
+                    const s = sort[i];
+                    const a_val = tree_1.Tree.get(a, s.key);
+                    const b_val = tree_1.Tree.get(b, s.key);
+                    if (typeof a_val == 'number') {
+                        if (typeof b_val !== 'number')
+                            throw new Error(`Cannot compare number and ${typeof b_val}`);
+                        let d = a_val - b_val;
                         if (d !== 0) {
-                            if (part.union.order.dir[i] === 'desc') {
+                            if (s.dir === 'desc') {
                                 d *= -1;
                             }
                             return d;
                         }
                     }
-                    else if (typeof a[key] == 'string') {
-                        if (typeof b[key] !== 'string')
-                            throw new Error(`Cannot compare string and ${typeof b[key]}`);
-                        let d = a[key].localeCompare(b[key]);
+                    else if (typeof a_val == 'string') {
+                        if (typeof b_val !== 'string')
+                            throw new Error(`Cannot compare string and ${typeof b_val}`);
+                        let d = a_val.localeCompare(b_val);
                         if (d !== 0) {
-                            if (part.union.order.dir[i] === 'desc') {
+                            if (s.dir === 'desc') {
                                 d *= -1;
                             }
                             return d;
@@ -67,8 +69,8 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
                 totalItems = output.length;
             }
             if (pagination.page !== undefined || pagination.perPage !== undefined) {
-                const a = ((pagination.page || 1) - 1) * (pagination.perPage || 10);
-                const b = a + (pagination.perPage || 10);
+                const a = ((pagination.page || 1) - 1) * (pagination.perPage ?? 10);
+                const b = a + (pagination.perPage ?? 10);
                 output = output.slice(a, b);
             }
         }
@@ -84,16 +86,16 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
      * testing objects unnecessarily. Returns a dict of results by id.
      * @returns A dict of results by id
      */
-    filter(part, objs, params) {
+    filter(part, objs, params, param_templates) {
         // Accumulate results from n intersections,
         // avoiding a re-check of already matched objects.
-        const _union = (union, objs, params) => {
+        const _union = (union, objs, params, param_templates) => {
             const out = {};
             const remaining = { ...objs };
             for (const inter of union.inters) {
                 if (Object.keys(remaining).length === 0)
                     break;
-                const interOut = _inter(inter, remaining, params);
+                const interOut = _inter(inter, remaining, params, param_templates);
                 Object.assign(out, interOut);
                 for (const k in interOut) {
                     delete remaining[k];
@@ -103,7 +105,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
         };
         // Sieves results from n unions or rules,
         // avoiding a re-check of already filtered-out objects.
-        const _inter = (inter, objs, params) => {
+        const _inter = (inter, objs, params, param_templates) => {
             let out = {};
             const remaining = { ...objs };
             for (const rule of inter.rules) {
@@ -111,11 +113,11 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
                     break;
                 // <Union>
                 if ('inters' in rule) {
-                    out = _union(rule, remaining, params);
+                    out = _union(rule, remaining, params, param_templates);
                 }
                 // <Rule>
                 else {
-                    out = _rule(rule, remaining, params);
+                    out = _rule(rule, remaining, params, param_templates);
                 }
                 for (const k in remaining) {
                     if (!(k in out)) {
@@ -125,13 +127,24 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             }
             return out;
         };
-        const _rule = (rule, objs, params) => {
+        const _rule = (rule, objs, params, param_templates) => {
             const out = {};
             for (const id in objs) {
                 const obj = objs[id];
                 let match = false;
-                for (const paramGroup of params) {
-                    match = _obj(rule, obj, paramGroup);
+                const combos = [];
+                for (const param of params) {
+                    if (param_templates.length) {
+                        for (const template of param_templates) {
+                            combos.push({ params: param, param_template: template });
+                        }
+                    }
+                    else {
+                        combos.push({ params: param, param_template: {} });
+                    }
+                }
+                for (const combo of combos) {
+                    match = _obj(rule, obj, combo.params, combo.param_template);
                     if (match)
                         break;
                 }
@@ -149,7 +162,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             }
             return out;
         };
-        const _obj = (rule, obj, params) => {
+        const _obj = (rule, obj, params, param_template) => {
             const fieldValue = tree_1.Tree.get(obj, rule.fieldpath);
             // Value is undefined, only 'present' rule applies
             if (fieldValue === undefined) {
@@ -161,7 +174,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             // Fieldpath is a spread, apply rule to each item
             if (rule.fieldpath.includes('.#')) {
                 for (const item of fieldValue) {
-                    if (_obj(rule, item, params))
+                    if (_obj(rule, item, params, param_template))
                         return true;
                 }
                 return false;
@@ -169,7 +182,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], Object.keys(param_template).length ? [param_template] : []);
                 const subList = Object.values(subOut);
                 // Subquery operator is for a list, filter
                 if (rule.op === 'in' || rule.op === 'contains_any') {
@@ -182,11 +195,18 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             }
             else if ('param' in rule.value) {
                 if (Array.isArray(rule.value.param)) {
-                    queryValue = rule.value.param.map(p => params[p]);
+                    queryValue = rule.value.param.map(p => tree_1.Tree.get(params, p));
                 }
                 else {
-                    queryValue = params[rule.value.param];
+                    queryValue = tree_1.Tree.get(params, rule.value.param);
+                }
+            }
+            else if ('param_with_$' in rule.value) {
+                let path = rule.value.param_with_$;
+                for (const key in param_template) {
+                    path = path.replace(new RegExp(key.replace('$', '\\$'), 'g'), param_template[key]);
                 }
+                queryValue = tree_1.Tree.get(params, path);
             }
             else if ('static' in rule.value) {
                 queryValue = rule.value.static;
@@ -278,7 +298,7 @@ class MemoryNQLRunner extends nql_engine_1.NQLRunner {
             }
             return false;
         };
-        return _union(part.union, objs, params);
+        return _union(part.union, objs, params, param_templates);
     }
 }
 exports.MemoryNQLRunner = MemoryNQLRunner;

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

@@ -98,7 +98,7 @@ class BucketBuilder {
             Object.assign(views, ext.views);
         }
         for (const v in builder._views) {
-            views[v] = bucket_view_builder_1.BucketViewBuilder.build(builder._views[v], model, graph, views);
+            views[v] = bucket_view_builder_1.BucketViewBuilder.build(builder._views[v], model, graph, views, tree);
         }
         return views;
     }

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

@@ -95,6 +95,7 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
     readLink<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, id: $['#data']['id'], link: LinkName, options?: {
         silent?: boolean;
         no_tenancy?: boolean;
+        index?: string[];
     }): Promise<Link['#many'] extends true ? Obj[] : (Obj | undefined)>;
     /**
      * Read raw entities of a graph link for N objects
@@ -106,6 +107,7 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
     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;
+        indexes?: string[][];
     }): Promise<Link['#many'] extends true ? Obj[] : (Obj | undefined)>;
     /**
      * Read the view of an entity of a graph link
@@ -117,6 +119,7 @@ export declare class Bucket<M extends $Module, $ extends $Bucket> {
     viewLink<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, id: $['#data']['id'], link: LinkName, view: V, options?: {
         silent?: boolean;
         no_tenancy?: boolean;
+        index?: string[];
     }): Promise<Obj | Obj[] | undefined>;
     /**
      * Return true if the graph link refers to at least one object
@@ -203,6 +206,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>[];
+        param_templates?: 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.infer.d.ts

@@ -1,17 +1,17 @@
 import { $BucketViewField, $BucketViewFields } from './view/bucket_view.schema';
 import { BucketViewFieldBuilder, BucketViewFieldBuilders } from './view/bucket_view_field.builder';
-export type $BucketViewFieldsInfer<Builder extends BucketViewFieldBuilders> = Builder extends (...args: any[]) => $BucketViewFields ? ReturnType<Builder> : {
-    [K in keyof Builder]: Builder[K] extends BucketViewFieldBuilders ? ($BucketViewField & {
+export type $BucketViewFieldsInfer<Builder extends BucketViewFieldBuilders<any>> = Builder extends (...args: any[]) => $BucketViewFields ? ReturnType<Builder> : {
+    [K in keyof Builder]: Builder[K] extends BucketViewFieldBuilders<any> ? ($BucketViewField & {
         '#data': $BucketViewFieldsInfer<Builder[K]>;
-    }) : Builder[K] extends BucketViewFieldBuilder<any, any, any> ? $BucketViewField & {
-        '#data': Builder[K] extends BucketViewFieldBuilder<infer X, any> ? X : never;
+    }) : Builder[K] extends BucketViewFieldBuilder<any, any, any, any, any> ? $BucketViewField & {
+        '#data': Builder[K] extends BucketViewFieldBuilder<any, any, any, infer X, any> ? X : never;
     } : never;
 };
-export type $BucketViewDataInfer<Builder extends BucketViewFieldBuilders> = {
-    [K in keyof Builder]: Builder[K] extends BucketViewFieldBuilders ? $BucketViewDataInfer<Builder[K]> : Builder[K] extends BucketViewFieldBuilder<infer X, any> ? X : never;
+export type $BucketViewDataInfer<Builders extends BucketViewFieldBuilders<any>> = {
+    [K in keyof Builders]: Builders[K] extends BucketViewFieldBuilder<any, any, any, infer X, any> ? X : never;
 };
 export type $BucketViewFieldBuilderInfer<Data> = {
-    [K in keyof Data]: BucketViewFieldBuilder<Data[K], any>;
+    [K in keyof Data]: BucketViewFieldBuilder<any, any, any, Data[K], any>;
 };
 /**
  * [Fieldpaths]

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

@@ -84,7 +84,7 @@ class Bucket {
             const result = await adapter.query(trx, {
                 id,
                 '#and __tenancy__': tenancy
-            }, { perPage: 1 }, undefined, options?.query_view ? { view: options?.query_view } : undefined);
+            }, { perPage: 1 }, undefined, undefined, options?.query_view ? { view: options?.query_view } : undefined);
             raw = result.data[0];
         }
         // Without Tenancy
@@ -190,7 +190,7 @@ class Bucket {
             return undefined;
         }
         // Read link
-        const linkObj = await this.graph.readLink(trx, obj, link, options);
+        const linkObj = await this.graph.readLink(trx, obj, { name: link, index: options?.index || [] }, options);
         // Encryption
         if (linkObj) {
             if (this.schema.model.hasEncryptedField) {
@@ -227,7 +227,7 @@ class Bucket {
             return undefined;
         }
         // Read link
-        const linkObj = await this.graph.readManyLinks(trx, objs, link, options);
+        const linkObj = await this.graph.readManyLinks(trx, objs, { name: link, indexes: options?.indexes || [] }, options);
         // TODO
         // // Encryption
         // if (linkObj) {
@@ -261,7 +261,7 @@ class Bucket {
             return undefined;
         }
         // View link
-        const linkObj = await this.graph.viewLink(trx, obj, link, view, options);
+        const linkObj = await this.graph.viewLink(trx, obj, { name: link, index: options?.index || [] }, view, options);
         // Encryption
         if (linkObj && this.schema.model.hasEncryptedField) {
             if (Array.isArray(linkObj)) {
@@ -430,7 +430,7 @@ class Bucket {
                 const result = await adapter.query(trx, {
                     id: obj.id,
                     '#and __tenancy__': tenancy
-                }, { perPage: 1 }, undefined, {
+                }, { perPage: 1 }, undefined, undefined, {
                     metadataOnly: true
                 });
                 oldObj = result.data[0];
@@ -563,7 +563,7 @@ class Bucket {
             // Check if object exists
             result = await this.adapter.query(trx, {
                 id, '#and __tenancy__': tenancy
-            }, { perPage: 1 }, undefined, {
+            }, { perPage: 1 }, undefined, undefined, {
                 metadataOnly: true
             });
             if (!result.data.length && !options?.unsafe) {
@@ -598,7 +598,7 @@ class Bucket {
             const linked = result
                 // If safe, avoid reading the object again inside readLink.
                 // Instead, use graph's readLink which takes the object.
-                ? await this.graph.readLink(trx, result.data[0], link.name, {
+                ? await this.graph.readLink(trx, result.data[0], { name: link.name, index: [] }, {
                     silent: true
                 })
                 // If unsafe, read the link base by id.
@@ -643,7 +643,7 @@ class Bucket {
             result = await this.adapter.query(trx, {
                 'id in': ids,
                 '#and __tenancy__': tenancy
-            }, undefined, undefined, {
+            }, undefined, undefined, undefined, {
                 metadataOnly: true
             });
             ids = result.data.map(obj => obj.id);
@@ -712,9 +712,14 @@ class Bucket {
             ...query,
             '#and __tenancy__': tenancy
         };
+        // Pagination
+        if (pagination) {
+            if (pagination.perPage && pagination.perPage < 0)
+                pagination.perPage = undefined;
+        }
         // Query
         const adapter = this.cache || this.adapter;
-        const result = await adapter.query(trx, query, pagination, options?.params);
+        const result = await adapter.query(trx, query, pagination, options?.params, options?.param_templates);
         if (!result.data.length)
             return result;
         // Encryption

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

@@ -29,7 +29,7 @@ export declare class $Bucket {
         optional: boolean;
     }>;
     '#modelpath': {};
-    '#querypath': {};
+    '#querypath': Record<never, any>;
     '#defaults': Record<string, any>;
     constructor(module: string, name: string, alias: string, model: $BucketModel, graph: $BucketGraph, views: $BucketViews, tenancy?: $BucketTenancy<any, any> | undefined, extendsFrom?: Tag | undefined);
 }

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

@@ -90,7 +90,7 @@ class BucketCache {
             const { action, sync } = await this.syncAll(trx);
             log_1.Log.debug('bucket', this.bucket.schema.name, `CACHE query.all, ${action}`);
             const meta = this.innerAdapter.getQueryMeta();
-            const entries = (await this.innerAdapter.query(trx, query, pagination, params, undefined, {
+            const entries = (await this.innerAdapter.query(trx, query, pagination, params, undefined, undefined, {
                 module: this.bucket.schema.module,
                 runners: {
                     [meta.scope]: this.innerAdapter.nql
@@ -180,7 +180,7 @@ class BucketCache {
     }
     async syncQuery(trx, query, pagination, params) {
         // 1. Query id and epoch from outer adapter
-        const outerMetadata = await this.outerAdapter.query(trx, query, pagination, params, {
+        const outerMetadata = await this.outerAdapter.query(trx, query, pagination, params, undefined, {
             metadataOnly: true
         });
         if (!outerMetadata.data.length) {
@@ -190,7 +190,7 @@ class BucketCache {
         const meta = this.innerAdapter.getQueryMeta();
         const innerData = await this.innerAdapter.query(trx, {
             'id in': outerMetadata.data.map(obj => obj.id)
-        }, undefined, undefined, undefined, {
+        }, undefined, undefined, undefined, undefined, {
             module: this.bucket.schema.module,
             runners: {
                 [meta.scope]: this.innerAdapter.nql

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

@@ -18,7 +18,10 @@ export declare class BucketGraph<M extends $Module, $ extends $Bucket> {
      *   - `silent`: If not found, returns undefined instead of raising an exception (default: `false`)
      *   - `no_tenancy`: Don't apply tenancy rules (default: `false`)
      */
-    readLink<LinkName extends keyof $['graph']['links'], LinkBucketName extends $['graph']['links'][LinkName]['bucket']['short'], LinkBucket extends M['buckets'][LinkBucketName], Obj = LinkBucket['#data']>(trx: AnyTrxNode, obj: $['#data'], link: LinkName, options?: {
+    readLink<LinkName extends keyof $['graph']['links'], LinkBucketName extends $['graph']['links'][LinkName]['bucket']['short'], LinkBucket extends M['buckets'][LinkBucketName], Obj = LinkBucket['#data']>(trx: AnyTrxNode, obj: $['#data'], link: {
+        name: LinkName;
+        index: string[];
+    }, options?: {
         silent?: boolean;
         no_tenancy?: boolean;
     }): Promise<Obj | Obj[] | undefined>;
@@ -29,7 +32,10 @@ export declare class BucketGraph<M extends $Module, $ extends $Bucket> {
      *   - `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']['short'], LinkBucket extends M['buckets'][LinkBucketName], Obj = LinkBucket['#data']>(trx: AnyTrxNode, objs: $['#data'][], link: LinkName, options?: {
+    readManyLinks<LinkName extends keyof $['graph']['links'], LinkBucketName extends $['graph']['links'][LinkName]['bucket']['short'], LinkBucket extends M['buckets'][LinkBucketName], Obj = LinkBucket['#data']>(trx: AnyTrxNode, objs: $['#data'][], link: {
+        name: LinkName;
+        indexes: string[][];
+    }, options?: {
         silent?: boolean;
         no_tenancy?: boolean;
     }): Promise<Obj[] | Obj[][]>;
@@ -40,9 +46,13 @@ export declare class BucketGraph<M extends $Module, $ extends $Bucket> {
      *   - `silent`: If not found, returns undefined instead of raising an exception (default: `false`)
      *   - `no_tenancy`: Don't apply tenancy rules (default: `false`)
      */
-    viewLink<LinkName extends keyof $['graph']['links'], LinkBucketName extends $['graph']['links'][LinkName]['bucket']['short'], LinkBucket extends M['buckets'][LinkBucketName], V extends ViewName<LinkBucket>, Obj extends ViewObj<LinkBucket, V>>(trx: AnyTrxNode, obj: $['#data'], link: LinkName, view: V, options?: {
+    viewLink<LinkName extends keyof $['graph']['links'], LinkBucketName extends $['graph']['links'][LinkName]['bucket']['short'], LinkBucket extends M['buckets'][LinkBucketName], V extends ViewName<LinkBucket>, Obj extends ViewObj<LinkBucket, V>>(trx: AnyTrxNode, obj: $['#data'], link: {
+        name: LinkName;
+        index: string[];
+    }, view: V, options?: {
         silent?: boolean;
         no_tenancy?: boolean;
+        param_templates?: Record<string, any>;
     }): Promise<Obj | Obj[] | undefined>;
     /**
      * Return true if the link resolves to at least one object

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

@@ -5,7 +5,7 @@ type Replace<T extends string> = T extends `${infer L}$${infer R}` ? `${L}${stri
 export type $BucketGraphLinksInfer<Builders extends BucketGraphLinkBuilders> = {
     [K in keyof Builders as Replace<K & string>]: Overlay<$BucketGraphLink, {
         '#bucket': Builders[K]['#other'];
-        '#data': Builders[K]['#other']['#data'];
+        '#many': Builders[K]['#many'];
     }>;
 };
 export {};