nesoi 3.0.0 → 3.0.6

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

@@ -1,522 +1,417 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BucketTrxNode = void 0;
-const error_1 = require("../../data/error");
+exports.BucketDriveTrxNode = exports.BucketUnsafeTrxNode = exports.BucketTrxNode = void 0;
 const trx_node_1 = require("../trx_node");
 const bucket_query_trx_node_1 = require("./bucket_query.trx_node");
+const error_1 = require("../../data/error");
 class BucketTrxNode {
     constructor(parentTrx, bucket) {
         this.parentTrx = parentTrx;
         this.bucket = bucket;
+        this.enableTenancy = true;
     }
-    // Read/View One
-    async readOne(id) {
+    /*
+        Modifiers
+    */
+    get no_tenancy() {
+        this.enableTenancy = false;
+        return this;
+    }
+    /*
+        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, 'readOne', { id });
-        let obj;
+        await trx_node_1.TrxNode.open(trx, action, input);
+        let out;
         try {
-            obj = await this.bucket.readOne(trx, id);
+            out = await fn(trx);
         }
         catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
+            await trx_node_1.TrxNode.error(trx, e);
             throw e;
         }
-        await trx_node_1.TrxNode.ok(trx, obj);
-        return obj;
+        await trx_node_1.TrxNode.ok(trx, fmtTrxOut ? fmtTrxOut(out) : out);
+        return out;
+    }
+    /*
+        Read/View One
+    */
+    /**
+     * Returns one object by `id`, without pre-formatting,
+     * or `undefined` if the object was not found.
+     */
+    async readOne(id) {
+        return this.wrap('readOne', { id }, trx => this.bucket.readOne(trx, id, {
+            silent: true,
+            no_tenancy: !this.enableTenancy
+        }));
     }
+    /**
+     * Returns one object by `id` formated with the specified view,
+     * or `undefined` if the object was not found.
+     * - The formating process can impact performance. If you just need
+     * the raw obj, it's recommended to use `readOne` instead.
+     */
     async viewOne(id, view = 'default') {
-        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, 'viewOne', { id, view });
-        let obj;
-        try {
-            obj = await this.bucket.viewOne(trx, id, view);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, obj);
-        return obj;
+        return this.wrap('viewOne', { id }, trx => this.bucket.viewOne(trx, id, view, {
+            silent: true,
+            no_tenancy: !this.enableTenancy
+        }));
     }
+    /**
+     * Returns one object by `id`, without pre-formatting,
+     * or **throws an exception** if the object was not found.
+     */
     async readOneOrFail(id) {
-        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, 'readOneOrFail', { id });
-        let obj;
-        try {
-            obj = await this.bucket.readOne(trx, id);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        if (!obj) {
-            const e = error_1.NesoiError.Bucket.ObjNotFound({ bucket: this.bucket.schema.alias, id: id });
-            await trx_node_1.TrxNode.error(trx, e);
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, obj);
-        return obj;
+        return this.wrap('readOneOrFail', { id }, trx => this.bucket.readOne(trx, id, {
+            no_tenancy: !this.enableTenancy
+        }));
     }
+    /**
+     * Returns one object by `id`, without pre-formatting,
+     * or **throws an exception** if the object was not found.
+     * - The formating process can impact performance. If you just need
+     * the raw obj, it's recommended to use `readOneOrFail` instead.
+     */
     async viewOneOrFail(id, view = 'default') {
-        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, 'viewOneOrFail', { id, view });
-        let obj;
-        try {
-            obj = await this.bucket.viewOne(trx, id, view);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        if (!obj) {
-            const e = error_1.NesoiError.Bucket.ObjNotFound({ bucket: this.bucket.schema.alias, id: id });
-            await trx_node_1.TrxNode.error(trx, e);
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, obj);
-        return obj;
+        return this.wrap('viewOneOrFail', { id }, trx => this.bucket.viewOne(trx, id, view, {
+            no_tenancy: !this.enableTenancy
+        }));
     }
-    // All
-    async readAll(pagination, order) {
-        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, 'readAll', { pagination, order });
-        let objs;
-        try {
-            objs = await this.bucket.readAll(trx, pagination, order);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, { length: objs.length });
-        return objs;
+    /*
+        Read/View All
+    */
+    /**
+     * Returns a list of all objects, without pre-formatting.
+     */
+    async readAll() {
+        return this.wrap('readAll', {}, trx => this.bucket.readAll(trx, {
+            no_tenancy: !this.enableTenancy
+        }), objs => ({ length: objs.length }));
     }
-    async viewAll(view = 'default', pagination, order) {
-        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, 'viewAll', { view, pagination, order });
-        let objs;
-        try {
-            objs = await this.bucket.viewAll(trx, view, pagination, order);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, { length: objs.length });
-        return objs;
+    /**
+     * Returns a list of all objects formated with the specified view.
+     * - The formating process can impact performance. If you just need
+     * the raw obj, it's recommended to use `readAll` instead.
+     */
+    async viewAll(view = 'default') {
+        return this.wrap('viewAll', {}, trx => this.bucket.viewAll(trx, view, {
+            no_tenancy: !this.enableTenancy
+        }), objs => ({ length: objs.length }));
     }
-    // Query
+    /*
+        Query
+    */
+    /**
+     * Returns a list containing the results of the query.
+     */
     query(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, view);
+        return new bucket_query_trx_node_1.BucketQueryTrxNode(trx, this.bucket, query, view, this.enableTenancy);
     }
-    // Graph Links
-    async readLink(id, link, view = 'default') {
-        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, 'readLink', { id, link });
-        let obj;
-        let linkObj;
-        try {
-            obj = await this.bucket.readOne(trx, id);
-            if (!obj) {
-                const schema = this.bucket.schema.graph.links[link];
-                if (schema.many) {
-                    return [];
-                }
-                return undefined;
-            }
-            linkObj = await this.bucket.graph.readLink(trx, link, obj, view);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, linkObj);
-        return linkObj;
+    /*
+        Graph
+    */
+    /**
+     * Returns one or more objects referenced by the graph link,
+     * 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, {
+            silent: true,
+            no_tenancy: !this.enableTenancy
+        }));
     }
-    async readLinkOrFail(id, link, view = 'default') {
-        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, 'readLinkOrFail', { id, link });
-        let obj;
-        let linkObj;
-        try {
-            obj = await this.bucket.readOne(trx, id);
-            if (!obj) {
-                const e = error_1.NesoiError.Bucket.ObjNotFound({ bucket: this.bucket.schema.alias, id: id });
-                await trx_node_1.TrxNode.error(trx, e);
-                throw e;
-            }
-            linkObj = await this.bucket.graph.readLink(trx, link, obj, view);
-            if (!linkObj) {
-                const e = error_1.NesoiError.Bucket.Graph.LinkNotFound({ bucket: this.bucket.schema.alias, link: link });
-                await trx_node_1.TrxNode.error(trx, e);
-                throw e;
-            }
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx);
-        return linkObj;
+    /**
+     * Returns one or more objects referenced by the graph link built with a view,
+     * 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, {
+            silent: true,
+            no_tenancy: !this.enableTenancy
+        }));
     }
-    async hasLink(id, link) {
-        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, 'hasLink', { id, link });
-        let obj;
-        let result;
-        try {
-            obj = await this.bucket.readOne(trx, id);
-            if (!obj) {
-                return undefined;
-            }
-            result = await this.bucket.graph.hasLink(trx, id, obj);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx, { result });
-        return result;
+    /**
+     * Returns one or more objects referenced by the graph link,
+     * 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, {
+            no_tenancy: !this.enableTenancy
+        }));
     }
-    // Put / Create / Update
     /**
-     * Updates an object by passing it directly to the bucket adapter,
-     * without checking if it exists. This creates an object if a new
-     * id is passed.
+     * Returns one or more objects referenced by the graph link built with a view,
+     * or **throws an exception** if the graph link doesn't resolve.
      */
-    async put(obj) {
-        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, 'put', { obj });
-        let _obj;
-        try {
-            _obj = await this.bucket.put(trx, obj);
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx);
-        return _obj;
+    async viewLinkOrFail(id, link, view = 'default') {
+        return this.wrap('viewLinkOrFail', { id, link, view }, trx => this.bucket.viewLink(trx, id, link, view, {
+            no_tenancy: !this.enableTenancy
+        }));
     }
     /**
-     * Creates an object by passing it to the bucket adapter,
-     * without an ID (it's removed if passed).
-     * This is a safer version of `put`, which ensures no update will happen.
+     * 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, {
+            no_tenancy: !this.enableTenancy
+        }));
+    }
+    /*
+        Create
+    */
+    /**
+     * Creates an object by passing it to the bucket adapter.
+     * Also creates the compositions of this bucket, from the
+     * `#composition` field passed in the message.
+     *
+     * - If `#composition` is wrong, this will throw an exception
      */
     async create(obj) {
-        delete obj['id'];
-        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, 'create', { obj });
-        const composition = obj['#composition'] || {};
-        delete obj['#composition'];
-        const input = Object.assign({}, this.bucket.schema.model.defaults, obj);
-        let _obj;
-        try {
-            _obj = await this.bucket.put(trx, input);
-            // Composition
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                const linkObj = composition[link.name];
-                if (!linkObj) {
-                    const e = error_1.NesoiError.Bucket.MissingComposition({ method: 'create', bucket: this.bucket.schema.name, link: link.name });
-                    await trx_node_1.TrxNode.error(trx, e);
-                    throw e;
-                }
-                if (link.many) {
-                    if (!Array.isArray(linkObj)) {
-                        const e = error_1.NesoiError.Bucket.CompositionValueShouldBeArray({ method: 'create', bucket: this.bucket.schema.name, link: link.name });
-                        await trx_node_1.TrxNode.error(trx, e);
-                        throw e;
-                    }
-                    for (const linkObjItem of linkObj) {
-                        await trx.bucket(link.bucket.refName).create(linkObjItem);
-                    }
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).create(linkObj);
-                }
-            }
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx);
-        return _obj;
+        return this.wrap('create', { obj }, trx => this.bucket.create(trx, obj), () => undefined);
+    }
+    /*
+        Update (Patch, Replace)
+    */
+    /**
+     * Reads one object by `id` and `patch` (modify) it based on the one passed as an argument.
+     * Also patches the compositions of this bucket, from the
+     * `#composition` field passed in the message.
+     *
+     * - If the object is not found, this will throw an exception
+     * - If `#composition` is wrong, this will throw an exception
+     * - The read query before updating might impact performance and be unnecessary
+     * when you're updating from code that's sure the object exists. In that case,
+     * 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, {
+            mode: 'patch',
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
     }
     /**
-     * Reads the id from the bucket adapter to ensure the object exists
-     * before updating.
-     * This is a safer version of `put`, suited for updating data.
+     * Reads one object by `id` and `replace` it with the one passed as an argument.
+     * Also patches the compositions of this bucket, from the
+     * `#composition` field passed in the message.
+     *
+     * - If the object is not found, this will throw an exception
+     * - If `#composition` is wrong, this will throw an exception
+     * - The read query before updating might impact performance and be unnecessary
+     * when you're updating from code that's sure the object exists. In that case,
+     * you can use `unsafe.replace`, which doesn't read prior to writing.
      */
     async replace(obj) {
-        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, 'replace', { obj });
-        const composition = obj['#composition'] || {};
-        delete obj['#composition'];
-        let newObj;
-        try {
-            const oldObj = await this.bucket.readOne(trx, obj['id']);
-            if (!oldObj) {
-                const e = error_1.NesoiError.Bucket.ObjNotFound({ bucket: this.bucket.schema.alias, id: obj['id'] });
-                await trx_node_1.TrxNode.error(trx, e);
-                throw e;
-            }
-            newObj = await this.bucket.put(trx, obj);
-            // Composition
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                const linkObj = composition[link.name];
-                if (!linkObj) {
-                    const e = error_1.NesoiError.Bucket.MissingComposition({ method: 'replace', bucket: this.bucket.schema.name, link: link.name });
-                    await trx_node_1.TrxNode.error(trx, e);
-                    throw e;
-                }
-                if (link.many) {
-                    if (!Array.isArray(linkObj)) {
-                        const e = error_1.NesoiError.Bucket.CompositionValueShouldBeArray({ method: 'replace', bucket: this.bucket.schema.name, link: link.name });
-                        await trx_node_1.TrxNode.error(trx, e);
-                        throw e;
-                    }
-                    for (const linkObjItem of linkObj) {
-                        await trx.bucket(link.bucket.refName).replace(linkObjItem);
-                    }
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).replace(linkObj);
-                }
-            }
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx);
-        return newObj;
+        return this.wrap('replace', { obj }, trx => this.bucket.update(trx, obj, {
+            mode: 'replace',
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
+    }
+    /*
+        Put
+    */
+    /**
+     * Creates or replaces (by `id`) the object passed as an argument.
+     * Does the same for compositions of this bucket, from the
+     * `#composition` field passed in the message.
+     *
+     * - If `#composition` is wrong, this will throw an exception.
+     * - This will **REPLACE** objects and it's compositions if they already exist,
+     *  so there might be unexpected data loss, use it carefully.
+     *
+     * **WARNING** Tenancy currently not implemented for put.
+     */
+    async put(obj) {
+        return this.wrap('put', { obj }, trx => this.bucket.put(trx, obj), () => undefined);
     }
+    /*
+        Delete
+    */
     /**
-     * Reads the id from the bucket adapter to ensure the object exists
-     * before updating. Applies changes to the object instead of replacing it.
+     * Attempts to read an object by `id`, if found, deletes it.
+     *
+     * - If you want to skip the read query, use the `unsafe.delete` method,
+     * so the behavior depends on the bucket used.
+     */
+    async delete(id) {
+        return this.wrap('delete', { id }, trx => this.bucket.delete(trx, id, {
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
+    }
+    /**
+     * Attempts to read an object by `id`, if found, deletes it.
+     *
+     * - If you want to skip the read query, use the `unsafe.delete` method,
+     * so the behavior depends on the bucket used.
+     */
+    async deleteMany(ids) {
+        return this.wrap('deleteMany', { ids }, trx => this.bucket.deleteMany(trx, ids, {
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
+    }
+    /*
+        Build
+    */
+    async buildOne(obj, view) {
+        return this.wrap('buildOne', { obj }, trx => this.bucket.buildOne(trx, obj, view), () => undefined);
+    }
+    async buildMany(objs, view) {
+        return this.wrap('buildMany', { objs }, trx => this.bucket.buildMany(trx, objs, view), () => undefined);
+    }
+    /*
+        Drive
+    */
+    /**
+     * Methods to use the Bucket's drive (file storage).
+     */
+    get drive() {
+        return new BucketDriveTrxNode(this, this.bucket);
+    }
+    /*
+        Unsafe
+    */
+    /**
+     * Unsafe versions of methods, which improve performance
+     * by avoiding some validations and queries.
+     *
+     * **Use it carefully.**
+     */
+    get unsafe() {
+        return new BucketUnsafeTrxNode(this, this.bucket, this.enableTenancy);
+    }
+}
+exports.BucketTrxNode = BucketTrxNode;
+class BucketUnsafeTrxNode {
+    constructor(bucketTrx, bucket, enableTenancy) {
+        this.bucketTrx = bucketTrx;
+        this.bucket = bucket;
+        this.enableTenancy = enableTenancy;
+    }
+    /*
+        Modifiers
+    */
+    get no_tenancy() {
+        this.enableTenancy = false;
+        return this;
+    }
+    /*
+        Update (Patch, Replace)
+    */
+    /**
+     * Directly `patch` (modify) an object based on the one passed as an argument.
+     * Also patches the compositions of this bucket, from the
+     * `#composition` field passed in the message.
+     *
+     * > This unsafe version does not check if the object exists prior to patching.
+     *
+     * - If the object is not found, this will throw an exception
+     * - If `#composition` is wrong, this will throw an exception
      */
     async patch(obj) {
-        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, 'patch', { obj });
-        const composition = obj['#composition'] || {};
-        delete obj['#composition'];
-        let newObj;
-        try {
-            const oldObj = await this.bucket.readOne(trx, obj['id']);
-            if (!oldObj) {
-                const e = error_1.NesoiError.Bucket.ObjNotFound({ bucket: this.bucket.schema.alias, id: obj['id'] });
-                await trx_node_1.TrxNode.error(trx, e);
-                throw e;
-            }
-            // TODO: deep merge
-            const putObj = Object.assign({}, oldObj, obj);
-            newObj = await this.bucket.put(trx, putObj);
-            // Composition
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                const linkObj = composition[link.name];
-                if (!linkObj) {
-                    const e = error_1.NesoiError.Bucket.MissingComposition({ method: 'patch', bucket: this.bucket.schema.name, link: link.name });
-                    await trx_node_1.TrxNode.error(trx, e);
-                    throw e;
-                }
-                if (link.many) {
-                    if (!Array.isArray(linkObj)) {
-                        const e = error_1.NesoiError.Bucket.CompositionValueShouldBeArray({ method: 'patch', bucket: this.bucket.schema.name, link: link.name });
-                        await trx_node_1.TrxNode.error(trx, e);
-                        throw e;
-                    }
-                    for (const linkObjItem of linkObj) {
-                        await trx.bucket(link.bucket.refName).patch(linkObjItem);
-                    }
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).patch(linkObj);
-                }
-            }
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx);
-        return newObj;
+        return this.bucketTrx.wrap('patch', { obj }, trx => this.bucket.update(trx, obj, {
+            mode: 'patch',
+            unsafe: true,
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
     }
-    // Delete
+    /**
+     * Directly `replace` on object with the one passed as an argument.
+     * Also replaces the compositions of this bucket, from the
+     * `#composition` field passed in the message.
+     *
+     * > This unsafe version does not check if the object exists prior to replacing.
+     *
+     * - If the object is not found, this will throw an exception
+     * - If `#composition` is wrong, this will throw an exception
+     */
+    async replace(obj) {
+        return this.bucketTrx.wrap('replace', { obj }, trx => this.bucket.update(trx, obj, {
+            mode: 'replace',
+            unsafe: true,
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
+    }
+    /*
+        Delete
+    */
+    /**
+     * Deletes an object
+     *
+     * > This unsafe version does not check if the object exists prior to deleting.
+     */
     async delete(id) {
-        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, 'delete', { id });
-        try {
-            // Composition (with other key)
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                if (link.keyOwner !== 'other')
-                    continue;
-                const linked = await this.readLink(id, link.name);
-                if (link.many) {
-                    for (const linkedItem of linked) {
-                        await trx.bucket(link.bucket.refName).delete(linkedItem.id);
-                    }
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).delete(linked.id);
-                }
-            }
-            // The object itself
-            await this.bucket.delete(trx, id);
-            // Composition (with self key)
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                if (link.keyOwner !== 'self')
-                    continue;
-                const linked = await this.readLink(id, link.name);
-                if (link.many) {
-                    await trx.bucket(link.bucket.refName).deleteMany(linked.map((l) => l.id));
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).delete(linked.id);
-                }
-            }
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
-        }
-        await trx_node_1.TrxNode.ok(trx);
+        return this.bucketTrx.wrap('delete', { id }, trx => this.bucket.delete(trx, id, {
+            unsafe: true,
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
     }
     /**
-     * **WARNING**: This does not currently implement composition
+     * Attempts to read an object by `id`, if found, deletes it.
+     *
+     * > This unsafe version does not check if the objects exist prior to deleting.
      */
     async deleteMany(ids) {
-        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, 'deleteMany', { ids });
-        try {
-            // Composition (with other key)
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                if (link.keyOwner !== 'other')
-                    continue;
-                for (const id of ids) {
-                    const linked = await this.readLink(id, link.name);
-                    if (link.many) {
-                        await trx.bucket(link.bucket.refName).deleteMany(linked.map((l) => l.id));
-                    }
-                    else {
-                        await trx.bucket(link.bucket.refName).delete(linked.id);
-                    }
-                }
-            }
-            await this.bucket.deleteMany(trx, ids);
-            // Composition (with self key)
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                if (link.keyOwner !== 'self')
-                    continue;
-                for (const id of ids) {
-                    const linked = await this.readLink(id, link.name);
-                    if (link.many) {
-                        await trx.bucket(link.bucket.refName).deleteMany(linked.map((l) => l.id));
-                    }
-                    else {
-                        await trx.bucket(link.bucket.refName).delete(linked.id);
-                    }
-                }
-            }
-        }
-        catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
-            throw e;
+        return this.bucketTrx.wrap('deleteMany', { ids }, trx => this.bucket.deleteMany(trx, ids, {
+            unsafe: true,
+            no_tenancy: !this.enableTenancy
+        }), () => undefined);
+    }
+}
+exports.BucketUnsafeTrxNode = BucketUnsafeTrxNode;
+class BucketDriveTrxNode {
+    constructor(bucketTrx, bucket) {
+        this.bucketTrx = bucketTrx;
+        this.bucket = bucket;
+        if (!this.bucket.drive) {
+            throw error_1.NesoiError.Bucket.Drive.NoAdapter({ bucket: this.bucket.schema.alias });
         }
-        await trx_node_1.TrxNode.ok(trx);
     }
-    async deleteOrFail(id) {
-        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, 'deleteOrFail', { id });
+    /**
+     * Read the contents of a File of this bucket's drive
+     */
+    read(file, options) {
         try {
-            // Composition (with other key)
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                if (link.keyOwner !== 'other')
-                    continue;
-                const linked = await this.readLink(id, link.name);
-                if (link.many) {
-                    for (const linkedItem of linked) {
-                        await trx.bucket(link.bucket.refName).deleteOrFail(linkedItem.id);
-                    }
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).deleteOrFail(linked.id);
-                }
-            }
-            const obj = await this.bucket.readOne(trx, id);
-            if (!obj) {
-                const e = error_1.NesoiError.Bucket.ObjNotFound({ bucket: this.bucket.schema.alias, id: id });
-                await trx_node_1.TrxNode.error(trx, e);
-                throw e;
-            }
-            await this.bucket.delete(trx, id);
-            // Composition (with self key)
-            for (const link of Object.values(this.bucket.schema.graph.links)) {
-                if (link.rel !== 'composition')
-                    continue;
-                if (link.keyOwner !== 'self')
-                    continue;
-                const linked = await this.readLink(id, link.name);
-                if (link.many) {
-                    for (const linkedItem of linked) {
-                        await trx.bucket(link.bucket.refName).deleteOrFail(linkedItem.id);
-                    }
-                }
-                else {
-                    await trx.bucket(link.bucket.refName).deleteOrFail(linked.id);
-                }
-            }
+            return this.bucket.drive.read(file);
         }
         catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
+            if (options?.silent) {
+                console.error(e);
+                return;
+            }
             throw e;
         }
-        await trx_node_1.TrxNode.ok(trx);
     }
-    async buildOne(obj, view) {
-        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, 'buildOne', { obj });
-        let result;
+    /**
+     * Move the file on disk
+     */
+    move(file, to, options) {
         try {
-            result = await this.bucket.buildOne(trx, obj, view);
+            return this.bucket.drive.move(file, to);
         }
         catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
+            if (options?.silent) {
+                console.error(e);
+                return;
+            }
             throw e;
         }
-        await trx_node_1.TrxNode.ok(trx);
-        return result;
     }
-    async buildAll(objs, view) {
-        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, 'buildAll', { objs });
-        let result;
+    /**
+     * Delete a file of this bucket's drive
+     */
+    delete(file, options) {
         try {
-            result = await this.bucket.buildAll(trx, objs, view);
+            return this.bucket.drive.delete(file);
         }
         catch (e) {
-            await trx_node_1.TrxNode.error(trx, e); // Bucket unexpected error
+            if (options?.silent) {
+                console.error(e);
+                return;
+            }
             throw e;
         }
-        await trx_node_1.TrxNode.ok(trx);
-        return result;
     }
 }
-exports.BucketTrxNode = BucketTrxNode;
+exports.BucketDriveTrxNode = BucketDriveTrxNode;