nesoi 3.2.9 → 3.3.1

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

@@ -4,15 +4,25 @@ exports.BucketDriveTrxNode = exports.BucketUnsafeTrxNode = exports.BucketTrxNode
 const trx_node_1 = require("../trx_node");
 const bucket_query_trx_node_1 = require("./bucket_query.trx_node");
 const error_1 = require("../../data/error");
+const dependency_1 = require("../../dependency");
+const external_trx_node_1 = require("./external.trx_node");
 /**
  * @category Engine
  * @subcategory Transaction
  */
 class BucketTrxNode {
-    constructor(parentTrx, bucket) {
-        this.parentTrx = parentTrx;
-        this.bucket = bucket;
+    constructor(trx, tag) {
+        this.trx = trx;
+        this.tag = tag;
         this.enableTenancy = true;
+        const module = trx_node_1.TrxNode.getModule(trx);
+        this.external = tag.module !== module.name;
+        if (!this.external) {
+            this.bucket = dependency_1.Tag.element(tag, trx);
+            if (!this.bucket) {
+                throw error_1.NesoiError.Trx.NodeNotFound(this.tag.full, trx.globalId);
+            }
+        }
     }
     /*
         Modifiers
@@ -25,17 +35,26 @@ class BucketTrxNode {
         Wrap
     */
     async wrap(action, input, fn, fmtTrxOut) {
-        const trx = trx_node_1.TrxNode.makeChildNode(this.parentTrx, this.bucket.schema.module, 'bucket', this.bucket.schema.name);
-        await trx_node_1.TrxNode.open(trx, action, input);
-        let out;
-        try {
-            out = await fn(trx);
+        const wrapped = async (parentTrx, bucket) => {
+            const trx = trx_node_1.TrxNode.makeChildNode(parentTrx, bucket.schema.module, 'bucket', bucket.schema.name);
+            trx_node_1.TrxNode.open(trx, action, input);
+            let out;
+            try {
+                out = await fn(trx, bucket);
+            }
+            catch (e) {
+                throw trx_node_1.TrxNode.error(trx, e);
+            }
+            trx_node_1.TrxNode.ok(trx, fmtTrxOut ? fmtTrxOut(out) : out);
+            return out;
+        };
+        if (this.external) {
+            const ext = new external_trx_node_1.ExternalTrxNode(this.trx, this.tag);
+            return ext.run(trx => dependency_1.Tag.element(this.tag, trx), wrapped);
         }
-        catch (e) {
-            throw await trx_node_1.TrxNode.error(trx, e);
+        else {
+            return wrapped(this.trx, this.bucket);
         }
-        await trx_node_1.TrxNode.ok(trx, fmtTrxOut ? fmtTrxOut(out) : out);
-        return out;
     }
     /*
         Read/View One
@@ -45,7 +64,7 @@ class BucketTrxNode {
      * or `undefined` if the object was not found.
      */
     async readOne(id) {
-        return this.wrap('readOne', { id }, trx => this.bucket.readOne(trx, id, {
+        return this.wrap('readOne', { id }, (trx, bucket) => bucket.readOne(trx, id, {
             silent: true,
             no_tenancy: !this.enableTenancy
         }));
@@ -57,7 +76,7 @@ class BucketTrxNode {
      * the raw obj, it's recommended to use `readOne` instead.
      */
     async viewOne(id, view = 'default') {
-        return this.wrap('viewOne', { id }, trx => this.bucket.viewOne(trx, id, view, {
+        return this.wrap('viewOne', { id }, (trx, bucket) => bucket.viewOne(trx, id, view, {
             silent: true,
             no_tenancy: !this.enableTenancy
         }));
@@ -67,7 +86,7 @@ class BucketTrxNode {
      * or **throws an exception** if the object was not found.
      */
     async readOneOrFail(id) {
-        return this.wrap('readOneOrFail', { id }, trx => this.bucket.readOne(trx, id, {
+        return this.wrap('readOneOrFail', { id }, (trx, bucket) => bucket.readOne(trx, id, {
             no_tenancy: !this.enableTenancy
         }));
     }
@@ -78,7 +97,7 @@ class BucketTrxNode {
      * the raw obj, it's recommended to use `readOneOrFail` instead.
      */
     async viewOneOrFail(id, view = 'default') {
-        return this.wrap('viewOneOrFail', { id }, trx => this.bucket.viewOne(trx, id, view, {
+        return this.wrap('viewOneOrFail', { id }, (trx, bucket) => bucket.viewOne(trx, id, view, {
             no_tenancy: !this.enableTenancy
         }));
     }
@@ -89,7 +108,7 @@ class BucketTrxNode {
      * Returns a list of all objects, without pre-formatting.
      */
     async readAll() {
-        return this.wrap('readAll', {}, trx => this.bucket.readAll(trx, {
+        return this.wrap('readAll', {}, (trx, bucket) => bucket.readAll(trx, {
             no_tenancy: !this.enableTenancy
         }), objs => ({ length: objs.length }));
     }
@@ -99,7 +118,7 @@ class BucketTrxNode {
      * the raw obj, it's recommended to use `readAll` instead.
      */
     async viewAll(view = 'default') {
-        return this.wrap('viewAll', {}, trx => this.bucket.viewAll(trx, view, {
+        return this.wrap('viewAll', {}, (trx, bucket) => bucket.viewAll(trx, view, {
             no_tenancy: !this.enableTenancy
         }), objs => ({ length: objs.length }));
     }
@@ -110,15 +129,13 @@ class BucketTrxNode {
      * Returns a list containing the results of the query.
      */
     query(query) {
-        const trx = trx_node_1.TrxNode.makeChildNode(this.parentTrx, this.bucket.schema.module, 'bucket', this.bucket.schema.name);
-        return new bucket_query_trx_node_1.BucketQueryTrxNode(trx, this.bucket, query, this.enableTenancy);
+        return new bucket_query_trx_node_1.BucketQueryTrxNode(this.trx, this.tag, query, this.enableTenancy);
     }
     /**
      * Returns a list containing the results of the query built with a view.
      */
     viewQuery(query, view = 'default') {
-        const trx = trx_node_1.TrxNode.makeChildNode(this.parentTrx, this.bucket.schema.module, 'bucket', this.bucket.schema.name);
-        return new bucket_query_trx_node_1.BucketQueryTrxNode(trx, this.bucket, query, this.enableTenancy, view);
+        return new bucket_query_trx_node_1.BucketQueryTrxNode(this.trx, this.tag, query, this.enableTenancy, view);
     }
     /*
         Graph
@@ -128,7 +145,7 @@ class BucketTrxNode {
      * or `undefined` if the graph link doesn't resolve.
      */
     async readLink(id, link) {
-        return this.wrap('readLink', { id, link }, trx => this.bucket.readLink(trx, id, link, {
+        return this.wrap('readLink', { id, link }, (trx, bucket) => bucket.readLink(trx, id, link, {
             silent: true,
             no_tenancy: !this.enableTenancy
         }));
@@ -138,7 +155,7 @@ class BucketTrxNode {
      * 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, {
+        return this.wrap('readLinks', { ids, link }, (trx, bucket) => bucket.readManyLinks(trx, ids, link, {
             silent: true,
             no_tenancy: !this.enableTenancy
         }));
@@ -148,7 +165,7 @@ class BucketTrxNode {
      * or `undefined` if the graph link doesn't resolve.
      */
     async viewLink(id, link, view = 'default') {
-        return this.wrap('viewLink', { id, link, view }, trx => this.bucket.viewLink(trx, id, link, view, {
+        return this.wrap('viewLink', { id, link, view }, (trx, bucket) => bucket.viewLink(trx, id, link, view, {
             silent: true,
             no_tenancy: !this.enableTenancy
         }));
@@ -158,7 +175,7 @@ class BucketTrxNode {
      * or **throws an exception** if the graph link doesn't resolve.
      */
     async readLinkOrFail(id, link) {
-        return this.wrap('readLinkOrFail', { id, link }, trx => this.bucket.readLink(trx, id, link, {
+        return this.wrap('readLinkOrFail', { id, link }, (trx, bucket) => bucket.readLink(trx, id, link, {
             no_tenancy: !this.enableTenancy
         }));
     }
@@ -167,7 +184,7 @@ class BucketTrxNode {
      * or **throws an exception** if the graph link doesn't resolve.
      */
     async viewLinkOrFail(id, link, view = 'default') {
-        return this.wrap('viewLinkOrFail', { id, link, view }, trx => this.bucket.viewLink(trx, id, link, view, {
+        return this.wrap('viewLinkOrFail', { id, link, view }, (trx, bucket) => bucket.viewLink(trx, id, link, view, {
             no_tenancy: !this.enableTenancy
         }));
     }
@@ -175,7 +192,7 @@ class BucketTrxNode {
      * Returns `true` if the graph link resolves to at least 1 object.
      */
     async hasLink(id, link) {
-        return this.wrap('hasLink', { id, link }, trx => this.bucket.hasLink(trx, id, link, {
+        return this.wrap('hasLink', { id, link }, (trx, bucket) => bucket.hasLink(trx, id, link, {
             no_tenancy: !this.enableTenancy
         }));
     }
@@ -190,7 +207,7 @@ class BucketTrxNode {
      * - If `#composition` is wrong, this will throw an exception
      */
     async create(obj) {
-        return this.wrap('create', { obj }, trx => this.bucket.create(trx, obj), () => undefined);
+        return this.wrap('create', { obj }, (trx, bucket) => bucket.create(trx, obj), () => undefined);
     }
     /*
         Update (Patch, Replace)
@@ -207,7 +224,7 @@ class BucketTrxNode {
      * you can use `unsafe.patch`, which doesn't read prior to writing.
      */
     async patch(obj) {
-        return this.wrap('patch', { obj }, trx => this.bucket.update(trx, obj, {
+        return this.wrap('patch', { obj }, (trx, bucket) => bucket.update(trx, obj, {
             mode: 'patch',
             no_tenancy: !this.enableTenancy
         }), () => undefined);
@@ -224,7 +241,7 @@ class BucketTrxNode {
      * you can use `unsafe.replace`, which doesn't read prior to writing.
      */
     async replace(obj) {
-        return this.wrap('replace', { obj }, trx => this.bucket.update(trx, obj, {
+        return this.wrap('replace', { obj }, (trx, bucket) => bucket.update(trx, obj, {
             mode: 'replace',
             no_tenancy: !this.enableTenancy
         }), () => undefined);
@@ -244,7 +261,7 @@ class BucketTrxNode {
      * **WARNING** Tenancy currently not implemented for put.
      */
     async put(obj) {
-        return this.wrap('put', { obj }, trx => this.bucket.put(trx, obj), () => undefined);
+        return this.wrap('put', { obj }, (trx, bucket) => bucket.put(trx, obj), () => undefined);
     }
     /**
      * Create, replace or delete all the objects passed as an argument.
@@ -259,13 +276,13 @@ class BucketTrxNode {
      * **WARNING** Tenancy currently not implemented for put.
      */
     async sync(objs) {
-        return this.wrap('put', { objs }, async (trx) => {
+        return this.wrap('put', { objs }, async (trx, bucket) => {
             for (const obj of objs) {
                 if (obj.id && obj.__delete) {
-                    await this.bucket.delete(trx, obj.id);
+                    await bucket.delete(trx, obj.id);
                 }
                 else {
-                    await this.bucket.put(trx, obj);
+                    await bucket.put(trx, obj);
                 }
             }
         }, () => undefined);
@@ -280,7 +297,7 @@ class BucketTrxNode {
      * so the behavior depends on the bucket used.
      */
     async delete(id) {
-        return this.wrap('delete', { id }, trx => this.bucket.delete(trx, id, {
+        return this.wrap('delete', { id }, (trx, bucket) => bucket.delete(trx, id, {
             no_tenancy: !this.enableTenancy
         }), () => undefined);
     }
@@ -291,7 +308,7 @@ class BucketTrxNode {
      * so the behavior depends on the bucket used.
      */
     async deleteMany(ids) {
-        return this.wrap('deleteMany', { ids }, trx => this.bucket.deleteMany(trx, ids, {
+        return this.wrap('deleteMany', { ids }, (trx, bucket) => bucket.deleteMany(trx, ids, {
             no_tenancy: !this.enableTenancy
         }), () => undefined);
     }
@@ -299,10 +316,10 @@ class BucketTrxNode {
         Build
     */
     async buildOne(obj, view) {
-        return this.wrap('buildOne', { obj }, trx => this.bucket.buildOne(trx, obj, view), () => undefined);
+        return this.wrap('buildOne', { obj }, (trx, bucket) => bucket.buildOne(trx, obj, view), () => undefined);
     }
     async buildMany(objs, view) {
-        return this.wrap('buildMany', { objs }, trx => this.bucket.buildMany(trx, objs, view), () => undefined);
+        return this.wrap('buildMany', { objs }, (trx, bucket) => bucket.buildMany(trx, objs, view), () => undefined);
     }
     /*
         Drive
@@ -311,6 +328,9 @@ class BucketTrxNode {
      * Methods to use the Bucket's drive (file storage).
      */
     get drive() {
+        if (!this.bucket) {
+            throw new Error('Drive not supported for external buckets');
+        }
         return new BucketDriveTrxNode(this, this.bucket);
     }
     /*
@@ -323,6 +343,9 @@ class BucketTrxNode {
      * **Use it carefully.**
      */
     get unsafe() {
+        if (!this.bucket) {
+            throw new Error('Unsafe mode not allowed for external buckets');
+        }
         return new BucketUnsafeTrxNode(this, this.bucket, this.enableTenancy);
     }
 }
@@ -358,7 +381,7 @@ class BucketUnsafeTrxNode {
      * - If `#composition` is wrong, this will throw an exception
      */
     async patch(obj) {
-        return this.bucketTrx.wrap('patch', { obj }, trx => this.bucket.update(trx, obj, {
+        return this.bucketTrx.wrap('patch', { obj }, (trx, bucket) => bucket.update(trx, obj, {
             mode: 'patch',
             unsafe: true,
             no_tenancy: !this.enableTenancy
@@ -375,7 +398,7 @@ class BucketUnsafeTrxNode {
      * - If `#composition` is wrong, this will throw an exception
      */
     async replace(obj) {
-        return this.bucketTrx.wrap('replace', { obj }, trx => this.bucket.update(trx, obj, {
+        return this.bucketTrx.wrap('replace', { obj }, (trx, bucket) => bucket.update(trx, obj, {
             mode: 'replace',
             unsafe: true,
             no_tenancy: !this.enableTenancy
@@ -390,7 +413,7 @@ class BucketUnsafeTrxNode {
      * > This unsafe version does not check if the object exists prior to deleting.
      */
     async delete(id) {
-        return this.bucketTrx.wrap('delete', { id }, trx => this.bucket.delete(trx, id, {
+        return this.bucketTrx.wrap('delete', { id }, (trx, bucket) => bucket.delete(trx, id, {
             unsafe: true,
             no_tenancy: !this.enableTenancy
         }), () => undefined);
@@ -401,7 +424,7 @@ class BucketUnsafeTrxNode {
      * > This unsafe version does not check if the objects exist prior to deleting.
      */
     async deleteMany(ids) {
-        return this.bucketTrx.wrap('deleteMany', { ids }, trx => this.bucket.deleteMany(trx, ids, {
+        return this.bucketTrx.wrap('deleteMany', { ids }, (trx, bucket) => bucket.deleteMany(trx, ids, {
             unsafe: true,
             no_tenancy: !this.enableTenancy
         }), () => undefined);

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

@@ -1,23 +1,29 @@
 import { $Module, ViewName, ViewObj } from "../../../schema";
-import { TrxNode } from '../trx_node';
+import { AnyTrxNode, TrxNode } from '../trx_node';
 import { $Bucket } from "../../../elements/entities/bucket/bucket.schema";
 import { Bucket } from "../../../elements/entities/bucket/bucket";
 import { NQL_AnyQuery, NQL_Pagination, NQL_Query } from "../../../elements/entities/bucket/query/nql.schema";
 import { NQL_Result } from "../../../elements/entities/bucket/query/nql_engine";
+import { Tag } from "../../dependency";
 /**
  * @category Engine
  * @subcategory Transaction
  */
 export declare class BucketQueryTrxNode<M extends $Module, B extends $Bucket, V extends ViewName<B> | undefined = undefined, Obj = V extends string ? ViewObj<B, V> : B['#data']> {
     private trx;
-    private bucket;
+    private tag;
     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);
+    private external;
+    private bucket?;
+    constructor(trx: TrxNode<any, M, any>, tag: Tag, query: NQL_AnyQuery, enableTenancy: boolean, view?: V | undefined);
     merge($: NQL_Query<M, B>): void;
-    params(value?: Record<string, any>): this;
+    params(value?: Record<string, any> | Record<string, any>[]): this;
+    wrap(action: string, input: Record<string, any>, fn: (trx: AnyTrxNode, element: Bucket<M, B>) => Promise<any>): Promise<{
+        data: any[];
+    }>;
     first(): Promise<Obj | undefined>;
     firstOrFail(): Promise<Obj>;
     all(): Promise<Obj[]>;

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

@@ -3,18 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BucketQueryTrxNode = void 0;
 const trx_node_1 = require("../trx_node");
 const error_1 = require("../../data/error");
+const dependency_1 = require("../../dependency");
+const external_trx_node_1 = require("./external.trx_node");
 /**
  * @category Engine
  * @subcategory Transaction
  */
 class BucketQueryTrxNode {
-    constructor(trx, bucket, query, enableTenancy, view) {
+    constructor(trx, tag, query, enableTenancy, view) {
         this.trx = trx;
-        this.bucket = bucket;
+        this.tag = tag;
         this.query = query;
         this.enableTenancy = enableTenancy;
         this.view = view;
         this._params = [];
+        const module = trx_node_1.TrxNode.getModule(trx);
+        this.external = tag.module !== module.name;
+        if (!this.external) {
+            this.bucket = dependency_1.Tag.element(tag, trx);
+        }
     }
     merge($) {
         const and = $['#and'];
@@ -26,79 +33,83 @@ class BucketQueryTrxNode {
         this.query['#or*'] = or; // TODO: make this a little better
     }
     params(value) {
-        this._params = value ? [value] : [];
+        this._params = value
+            ? Array.isArray(value) ? value : [value]
+            : [];
         return this;
     }
+    /*
+        Wrap
+    */
+    async wrap(action, input, fn) {
+        const wrapped = async (parentTrx, bucket) => {
+            const trx = trx_node_1.TrxNode.makeChildNode(parentTrx, bucket.schema.module, 'bucket', bucket.schema.name);
+            trx_node_1.TrxNode.open(trx, action, input);
+            let out;
+            try {
+                out = await fn(trx, bucket);
+            }
+            catch (e) {
+                throw trx_node_1.TrxNode.error(trx, e);
+            }
+            trx_node_1.TrxNode.ok(trx, { length: out.data.length });
+            return out;
+        };
+        if (this.external) {
+            const ext = new external_trx_node_1.ExternalTrxNode(this.trx, this.tag);
+            return ext.run(trx => dependency_1.Tag.element(this.tag, trx), wrapped);
+        }
+        else {
+            return wrapped(this.trx, this.bucket);
+        }
+    }
     async first() {
-        await trx_node_1.TrxNode.open(this.trx, 'queryFirst', { schema: this.query, view: this.view });
-        let results;
-        try {
-            results = await this.bucket.query(this.trx, this.query, {
+        const results = await this.wrap('queryFirst', { schema: this.query, view: this.view }, (trx, bucket) => {
+            return bucket.query(this.trx, this.query, {
                 perPage: 1
             }, this.view, {
                 no_tenancy: !this.enableTenancy,
                 params: this._params
             });
-        }
-        catch (e) {
-            throw await trx_node_1.TrxNode.error(this.trx, e); // Bucket unexpected error
-        }
-        await trx_node_1.TrxNode.ok(this.trx, { length: results.data.length });
+        });
         return results.data.length
             ? results.data[0]
             : undefined;
     }
     async firstOrFail() {
-        await trx_node_1.TrxNode.open(this.trx, 'queryFirstOrFail', { schema: this.query, view: this.view });
-        let results;
-        try {
-            results = await this.bucket.query(this.trx, this.query, undefined, this.view, {
+        const results = await this.wrap('queryFirstOrFail', { schema: this.query, view: this.view }, async (trx, bucket) => {
+            const results = await bucket.query(trx, this.query, undefined, this.view, {
                 no_tenancy: !this.enableTenancy,
                 params: this._params
             });
-        }
-        catch (e) {
-            throw await trx_node_1.TrxNode.error(this.trx, e); // Bucket unexpected error
-        }
-        if (!results.data.length) {
-            const e = error_1.NesoiError.Bucket.Query.NoResults({ bucket: this.bucket.schema.alias, query: this.query });
-            throw await trx_node_1.TrxNode.error(this.trx, e);
-        }
-        await trx_node_1.TrxNode.ok(this.trx, { length: results.data.length });
+            if (!results.data.length) {
+                throw error_1.NesoiError.Bucket.Query.NoResults({ bucket: bucket.schema.alias, query: this.query });
+            }
+            return results;
+        });
         return results.data[0];
     }
     async all() {
-        await trx_node_1.TrxNode.open(this.trx, 'queryAll', { schema: this.query, view: this.view });
-        let results;
-        try {
-            results = await this.bucket.query(this.trx, this.query, undefined, this.view, {
+        const results = await this.wrap('queryAll', { schema: this.query, view: this.view }, async (trx, bucket) => {
+            return bucket.query(trx, this.query, undefined, this.view, {
                 params: this._params
             });
-        }
-        catch (e) {
-            throw await trx_node_1.TrxNode.error(this.trx, e); // Bucket unexpected error
-        }
-        await trx_node_1.TrxNode.ok(this.trx, { length: results.data.length });
+        });
         return results.data;
     }
     async page(pagination) {
         if (!pagination) {
+            const data = await this.all();
             return {
-                data: await this.all()
+                data, totalItems: data.length
             };
         }
-        await trx_node_1.TrxNode.open(this.trx, 'queryPage', { schema: this.query, pagination, view: this.view });
-        let result;
-        try {
-            result = await this.bucket.query(this.trx, this.query, pagination, this.view, {
+        const results = await this.wrap('queryPage', { schema: this.query, view: this.view }, async (trx, bucket) => {
+            return bucket.query(trx, this.query, pagination, this.view, {
                 params: this._params
             });
-        }
-        catch (e) {
-            throw await trx_node_1.TrxNode.error(this.trx, e); // Bucket unexpected error
-        }
-        await trx_node_1.TrxNode.ok(this.trx, { length: result.data.length });
-        return result;
+        });
+        return results;
     }
 }
 exports.BucketQueryTrxNode = BucketQueryTrxNode;

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

@@ -0,0 +1,15 @@
+import { $Module } from "../../../schema";
+import { AnyTrxNode, TrxNode } from '../trx_node';
+import { $Topic } from "../../../elements/blocks/topic/topic.schema";
+import { Tag } from "../../dependency";
+/**
+ * @category Engine
+ * @subcategory Transaction
+ */
+export declare class ExternalTrxNode<M extends $Module, $ extends $Topic> {
+    private trx;
+    private tag;
+    private daemon;
+    constructor(trx: TrxNode<any, M, any>, tag: Tag);
+    run(element: (trx: AnyTrxNode) => any, fn: (trx: AnyTrxNode, element: any) => Promise<any>): Promise<any>;
+}

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

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalTrxNode = void 0;
+const trx_node_1 = require("../trx_node");
+const error_1 = require("../../data/error");
+/**
+ * @category Engine
+ * @subcategory Transaction
+ */
+class ExternalTrxNode {
+    constructor(trx, tag) {
+        this.trx = trx;
+        this.tag = tag;
+        const _module = trx_node_1.TrxNode.getModule(trx);
+        if (!_module.daemon) {
+            throw error_1.NesoiError.Trx.DaemonNotFound(_module.name);
+        }
+        this.daemon = _module.daemon;
+    }
+    async run(element, fn) {
+        const root = this.trx.trx;
+        const module = trx_node_1.TrxNode.getModule(this.trx);
+        const trx = trx_node_1.TrxNode.makeChildNode(this.trx, module.name, 'externals', this.tag.full);
+        trx_node_1.TrxNode.open(trx, '~', {
+            tag: this.tag
+        });
+        let out;
+        try {
+            const res = await this.daemon.trx(this.tag.module).run_and_hold(async (extTrx) => {
+                try {
+                    return await fn(extTrx, element(extTrx));
+                }
+                catch (e) {
+                    throw trx_node_1.TrxNode.error(extTrx, e);
+                }
+                finally {
+                    trx_node_1.TrxNode.merge(trx, extTrx);
+                }
+            }, root.id);
+            if (res.status.state === 'error') {
+                throw res.status.error;
+            }
+            out = res.status.output;
+            root.holdNode(res);
+        }
+        catch (e) {
+            throw trx_node_1.TrxNode.error(trx, e);
+        }
+        trx_node_1.TrxNode.ok(trx, out);
+        return out;
+    }
+}
+exports.ExternalTrxNode = ExternalTrxNode;

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

@@ -1,18 +1,22 @@
 import { $Module } from "../../../schema";
-import { TrxNode } from '../trx_node';
+import { AnyTrxNode, TrxNode } from '../trx_node';
 import { $Job } from "../../../elements/blocks/job/job.schema";
 import { Job } from "../../../elements/blocks/job/job";
 import { Message } from "../../../elements/entities/message/message";
 import { JobInput } from "../../../elements/blocks/job/job.types";
+import { Tag } from "../../dependency";
 /**
  * @category Engine
  * @subcategory Transaction
  */
 export declare class JobTrxNode<M extends $Module, $ extends $Job> {
     private trx;
-    private job;
+    private tag;
     private ctx?;
-    constructor(trx: TrxNode<any, M, any>, job: Job<any, M, $>, ctx?: Record<string, any> | undefined);
+    private external;
+    private job?;
+    constructor(trx: TrxNode<any, M, any>, tag: Tag, ctx?: Record<string, any> | undefined);
+    wrap(action: string, input: Record<string, any>, fn: (trx: AnyTrxNode, element: Job<any, M, $>) => Promise<any>, fmtTrxOut?: (out: any) => any): Promise<any>;
     run(message: JobInput<$>): Promise<$['#output']>;
     forward(message: Message<$['#input']>): Promise<$['#output']>;
 }