@nymphjs/nymph 1.0.0-beta.121 → 1.0.0-beta.123

package/dist/testArtifacts.js

@@ -1,41 +1,120 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
 import Entity from './Entity.js';
+import { transactional } from './decorators/index.js';
+import { transaction } from './helpers/index.js';
 /**
  * This class is a test class that extends the Entity class.
  */
-export class TestModel extends Entity {
-    static ETYPE = 'test_model';
-    static class = 'TestModel';
-    $privateData = ['boolean'];
-    static searchRestrictedData = ['fish'];
-    $allowlistData = ['string', 'array', 'mdate'];
-    $protectedTags = ['test', 'notag'];
-    $allowlistTags = ['newtag'];
-    constructor() {
-        super();
-        this.$addTag('test');
-        this.$data.boolean = true;
-        this.$data.uniques = [];
-    }
-    async $getUniques() {
-        return this.$data.uniques ?? [];
-    }
-    $useProtectedData() {
-        const $allowlistData = this.$allowlistData;
-        const $allowlistTags = this.$allowlistTags;
-        const $protectedData = this.$protectedData;
-        const $protectedTags = this.$protectedTags;
-        delete this.$allowlistData;
-        delete this.$allowlistTags;
-        this.$protectedData = ['number'];
-        this.$protectedTags = [];
-        return () => {
-            this.$allowlistData = $allowlistData;
-            this.$allowlistTags = $allowlistTags;
-            this.$protectedData = $protectedData;
-            this.$protectedTags = $protectedTags;
-        };
-    }
-}
+let TestModel = (() => {
+    let _classSuper = Entity;
+    let _instanceExtraInitializers = [];
+    let _$testTransactionalDecorator_decorators;
+    return class TestModel extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _$testTransactionalDecorator_decorators = [transactional];
+            __esDecorate(this, null, _$testTransactionalDecorator_decorators, { kind: "method", name: "$testTransactionalDecorator", static: false, private: false, access: { has: obj => "$testTransactionalDecorator" in obj, get: obj => obj.$testTransactionalDecorator }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static ETYPE = 'test_model';
+        static class = 'TestModel';
+        $privateData = (__runInitializers(this, _instanceExtraInitializers), ['boolean']);
+        static searchRestrictedData = ['fish'];
+        $allowlistData = ['string', 'array', 'mdate'];
+        $protectedTags = ['test', 'notag'];
+        $allowlistTags = ['newtag'];
+        constructor() {
+            super();
+            this.$addTag('test');
+            this.$data.boolean = true;
+            this.$data.uniques = [];
+        }
+        async $getUniques() {
+            return this.$data.uniques ?? [];
+        }
+        $useProtectedData() {
+            const $allowlistData = this.$allowlistData;
+            const $allowlistTags = this.$allowlistTags;
+            const $protectedData = this.$protectedData;
+            const $protectedTags = this.$protectedTags;
+            delete this.$allowlistData;
+            delete this.$allowlistTags;
+            this.$protectedData = ['number'];
+            this.$protectedTags = [];
+            return () => {
+                this.$allowlistData = $allowlistData;
+                this.$allowlistTags = $allowlistTags;
+                this.$protectedData = $protectedData;
+                this.$protectedTags = $protectedTags;
+            };
+        }
+        async $testTransactionalDecorator(throwError) {
+            this.$data.string = 'this has been changed';
+            if (this.$data.reference) {
+                await this.$data.reference.$wake();
+                this.$data.reference.string = 'this has been changed too';
+                await this.$data.reference.$save();
+            }
+            await this.$save();
+            if (throwError) {
+                throw Error('An error.');
+            }
+            return 'Success.';
+        }
+        async $testTransactionHelper(throwError) {
+            return await transaction(this.$nymph, 'test-transaction', async (nymph) => {
+                this.$setNymph(nymph);
+                this.$data.string = 'this has been changed';
+                if (this.$data.reference) {
+                    await this.$data.reference.$wake();
+                    this.$data.reference.string = 'this has been changed too';
+                    await this.$data.reference.$save();
+                }
+                await this.$save();
+                if (throwError) {
+                    throw Error('An error.');
+                }
+                return 'Success.';
+            }, async (nymph) => {
+                this.$setNymph(nymph);
+            });
+        }
+    };
+})();
+export { TestModel };
 /**
  * This class is a test class that extends the Entity class.
  */

package/dist/testArtifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"testArtifacts.js","sourceRoot":"","sources":["../src/testArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AA0BjC;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAqB;IAClD,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;IAC5B,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;IAEjB,YAAY,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,CAAC,oBAAoB,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,cAAc,GAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,cAAc,GAAI,CAAC,QAAQ,CAAC,CAAC;IAEvC;QACE,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,CAAC;IAEM,iBAAiB;QACtB,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAE3C,OAAO,IAAI,CAAC,cAAc,CAAC;QAC3B,OAAO,IAAI,CAAC,cAAc,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAEzB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;YACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;YACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;YACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,SAAS;IACvC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;IAC9B,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;CAC7B;AAID;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,MAA0B;IAC5D,MAAM,CAAC,KAAK,GAAG,kBAAkB,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC;CACjC"}
+{"version":3,"file":"testArtifacts.js","sourceRoot":"","sources":["../src/testArtifacts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0BjD;;GAEG;IACU,SAAS;sBAAS,MAAM;;;iBAAxB,SAAU,SAAQ,WAAqB;;;uDAyCjD,aAAa;YACd,oOAAa,2BAA2B,6DAgBvC;;;QAzDD,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;QAC5B,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;QAEjB,YAAY,IAJX,mDAAS,EAIK,CAAC,SAAS,CAAC,EAAC;QAC9B,MAAM,CAAC,oBAAoB,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,cAAc,GAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,cAAc,GAAI,CAAC,QAAQ,CAAC,CAAC;QAEvC;YACE,KAAK,EAAE,CAAC;YAER,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;QAC1B,CAAC;QAEM,KAAK,CAAC,WAAW;YACtB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,CAAC;QAEM,iBAAiB;YACtB,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAE3C,OAAO,IAAI,CAAC,cAAc,CAAC;YAC3B,OAAO,IAAI,CAAC,cAAc,CAAC;YAC3B,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;YAEzB,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;gBACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;gBACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;gBACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;YACvC,CAAC,CAAC;QACJ,CAAC;QAGM,KAAK,CAAC,2BAA2B,CAAC,UAAmB;YAC1D,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC;YAE5C,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBACnC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,2BAA2B,CAAC;gBAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrC,CAAC;YAED,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAEnB,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3B,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC;QAEM,KAAK,CAAC,sBAAsB,CAAC,UAAmB;YACrD,OAAO,MAAM,WAAW,CACtB,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,KAAK,EAAE,KAAK,EAAE,EAAE;gBACd,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACtB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC;gBAE5C,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;oBACzB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;oBACnC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,2BAA2B,CAAC;oBAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBACrC,CAAC;gBAED,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBAEnB,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC3B,CAAC;gBAED,OAAO,UAAU,CAAC;YACpB,CAAC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;gBACd,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC,CACF,CAAC;QACJ,CAAC;;;SAtFU,SAAS;AAyFtB;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,SAAS;IACvC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;IAC9B,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;CAC7B;AAID;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,MAA0B;IAC5D,MAAM,CAAC,KAAK,GAAG,kBAAkB,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC;CACjC"}

package/dist/testMocks.js

@@ -1,5 +1,5 @@
 import { guid } from '@nymphjs/guid';
-import { ClassNotAvailableError } from './errors/index.js';
+import { ClassNotAvailableError, EntityConflictError } from './errors/index.js';
 import Entity from './Entity.js';
 const entities = {};
 export class MockNymphDriver {
@@ -75,7 +75,7 @@ export class MockNymph {
         }
         else if (entity.guid in entities &&
             (entity.mdate ?? 0) < (entities[entity.guid].mdate ?? 0)) {
-            return false;
+            throw new EntityConflictError("Entity either doesn't exist or is newer in the DB.");
         }
         entity.mdate = Date.now();
         const entityJson = {

package/dist/testMocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"testMocks.js","sourceRoot":"","sources":["../src/testMocks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"testMocks.js","sourceRoot":"","sources":["../src/testMocks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,23 @@
 {
   "name": "@nymphjs/nymph",
-  "version": "1.0.0-beta.121",
-  "description": "Nymph.js - Nymph ORM",
+  "version": "1.0.0-beta.123",
+  "description": "Application Data and Access Framework for Node.js and the Browser",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "keywords": [
     "nymph",
+    "nymph.js",
+    "application data framework",
+    "application data and access framework",
+    "object relational mapper",
     "ORM",
-    "object relational mapper"
+    "user management",
+    "group management",
+    "application framework",
+    "data framework",
+    "database abstraction",
+    "database abstraction layer"
   ],
   "scripts": {
     "clean": "test -d dist && rm -r dist || true",
@@ -34,7 +43,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@nymphjs/guid": "^1.0.0-beta.121",
+    "@nymphjs/guid": "^1.0.0-beta.123",
     "@sciactive/tokenizer": "^3.4.0",
     "debug": "^4.4.3",
     "joi": "^18.2.5",
@@ -57,5 +66,5 @@
     "ts-node": "^10.9.2",
     "typescript": "^7.0.2"
   },
-  "gitHead": "74e39aff81353d16831656431e97b66ac6effc18"
+  "gitHead": "c37dc940d7bf39e0f63158add6d0c54e7c050782"
 }

package/src/Entity.test.ts

@@ -2,6 +2,7 @@ import { jest } from '@jest/globals';
 
 import { cloneDeep } from 'lodash-es';
 
+import { EntityConflictError } from './errors/index.js';
 import { MockNymph } from './testMocks.js';
 import {
   TestBModel as TestBModelClass,
@@ -44,22 +45,22 @@ describe('Entity', () => {
     expect(testEntity.array).toEqual(['full', 'of', 'values', 500]);
     expect(testEntity.number).toEqual(30);
 
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
     expect(typeof testEntity.guid).toEqual('string');
 
     entityReferenceTest = await TestModel.factory();
     entityReferenceTest.string = 'wrong';
-    expect(await entityReferenceTest.$save()).toEqual(true);
+    await entityReferenceTest.$save();
     entityReferenceGuid = entityReferenceTest.guid as string;
     testEntity.reference = entityReferenceTest;
     testEntity.refArray = [entityReferenceTest];
     testEntity.refObject = {
       entity: entityReferenceTest,
     };
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
 
     entityReferenceTest.test = 'good';
-    expect(await entityReferenceTest.$save()).toEqual(true);
+    await entityReferenceTest.$save();
   });
 
   it('comparisons work', async () => {
@@ -118,14 +119,14 @@ describe('Entity', () => {
   it('refresh updates', async () => {
     expect(testEntity.string).toEqual('test');
     testEntity.string = 'updated';
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
     await testEntity.$refresh();
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
 
     const retrieve = await TestModel.factory(testEntity.guid as string);
     expect(retrieve.string).toEqual('updated');
     retrieve.string = 'test';
-    expect(await retrieve.$save()).toBe(true);
+    await retrieve.$save();
 
     await testEntity.$refresh();
     expect(testEntity.string).toEqual('test');
@@ -135,12 +136,18 @@ describe('Entity', () => {
     await new Promise((resolve) => setTimeout(resolve, 500));
 
     const testEntityCopy = await TestModel.factory(testEntity.guid as string);
-    expect(await testEntityCopy.$save()).toEqual(true);
+    await testEntityCopy.$save();
     expect(testEntityCopy.mdate ?? 0).toBeGreaterThan(testEntity.mdate ?? 0);
 
     await new Promise((resolve) => setTimeout(resolve, 500));
 
-    expect(await testEntity.$save()).toEqual(false);
+    try {
+      await testEntity.$save();
+
+      throw new Error('Should have thrown.');
+    } catch (e: any) {
+      expect(e).toBeInstanceOf(EntityConflictError);
+    }
 
     await testEntity.$refresh();
 
@@ -189,12 +196,12 @@ describe('Entity', () => {
 
     // Remove all tags.
     testEntity.$removeTag('test');
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
     expect(await testEntity.$refresh()).toEqual(true);
     expect(testEntity.$hasTag('test')).toEqual(false);
     expect(testEntity.$getTags()).toEqual([]);
     testEntity.$addTag('test');
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
     expect(testEntity.$hasTag('test')).toEqual(true);
   });
 
@@ -396,7 +403,7 @@ describe('Entity', () => {
     // Test that an old JSON payload causes a conflict.
     const json = JSON.stringify(testEntity);
 
-    expect(await testEntity.$save()).toEqual(true);
+    await testEntity.$save();
 
     let thrown = false;
     let thrownName: string = '';

package/src/Entity.ts

@@ -19,6 +19,7 @@ import {
   EntityIsSleepingReferenceError,
   InvalidParametersError,
   InvalidStateError,
+  MethodFailedError,
 } from './errors/index.js';
 import {
   entitiesToReferences,
@@ -604,6 +605,28 @@ export default class Entity<
     return obj;
   }
 
+  public $setNymph(nymph: Nymph) {
+    this.$nymph = nymph;
+    if (!this.$asleep()) {
+      const recurseData = (data: any) => {
+        if (Array.isArray(data)) {
+          for (let name in data) {
+            recurseData(data[name]);
+          }
+        } else if (data instanceof Entity) {
+          if (data.$nymph !== nymph) {
+            data.$setNymph(nymph);
+          }
+        } else if (typeof data === 'object') {
+          for (let name in data) {
+            recurseData(data[name]);
+          }
+        }
+      };
+      recurseData(this.$data);
+    }
+  }
+
   public $getGuaranteedGUID() {
     if (this.guid !== null) {
       return this.guid;
@@ -648,10 +671,12 @@ export default class Entity<
     return this.$clientEnabledMethods;
   }
 
-  public async $delete(): Promise<boolean> {
-    this.$check();
+  public async $delete(): Promise<void> {
+    await this.$wake();
 
-    return await this.$nymph.deleteEntity(this);
+    if (!(await this.$nymph.deleteEntity(this))) {
+      throw new MethodFailedError('Failed to delete entity.');
+    }
   }
 
   public $equals(object: any) {
@@ -1203,16 +1228,14 @@ export default class Entity<
     }
     const refresh = await this.$nymph.getEntity(
       {
-        class: this.$nymph.getEntityClass(
-          this.constructor as EntityConstructor,
-        ),
+        class: this.constructor as EntityConstructor,
         skipCache: true,
         skipAc: this.$skipAc,
       },
       { type: '&', guid: this.guid },
     );
     if (refresh == null) {
-      return 0;
+      throw new MethodFailedError("The entity's data could not be refreshed.");
     }
     this.tags = refresh.tags;
     this.cdate = refresh.cdate;
@@ -1227,10 +1250,12 @@ export default class Entity<
     this.tags = difference(this.tags, tags);
   }
 
-  public async $save(): Promise<boolean> {
+  public async $save(): Promise<void> {
     await this.$wake();
 
-    return await this.$nymph.saveEntity(this);
+    if (!(await this.$nymph.saveEntity(this))) {
+      throw new MethodFailedError('Failed to save entity.');
+    }
   }
 
   public $toReference(existingOnly?: boolean) {

package/src/Entity.types.ts

@@ -69,9 +69,9 @@ export interface DataObjectInterface {
   /**
    * Delete the object from storage.
    *
-   * @returns True on success, false on failure.
+   * An error is thrown on failure.
    */
-  $delete(): Promise<boolean>;
+  $delete(): Promise<void>;
   /**
    * Perform a more strict comparison of this object to another.
    *
@@ -100,18 +100,16 @@ export interface DataObjectInterface {
   /**
    * Refresh the object from storage. (Bypasses Nymph's cache.)
    *
-   * If the object has been deleted from storage, the database cannot be
-   * reached, or a database error occurs, `refresh()` will return 0.
-   *
-   * @returns False if the data has not been saved, 0 if it can't be refreshed, true on success.
+   * @returns False if the data has not been saved, true on success. An error is
+   *          thrown on failure.
    */
-  $refresh(): Promise<boolean | 0>;
+  $refresh(): Promise<boolean>;
   /**
    * Save the object to storage.
    *
-   * @returns True on success, false on failure.
+   * An error is thrown on failure.
    */
-  $save(): Promise<boolean>;
+  $save(): Promise<void>;
   /**
    * The object's data.
    */
@@ -172,7 +170,8 @@ export interface EntityInterface extends DataObjectInterface {
   /**
    * Get the client enabled methods.
    *
-   * @returns The names of methods allowed to be called by the frontend with serverCall.
+   * @returns The names of methods allowed to be called by the frontend with
+   *          serverCall.
    */
   $getClientEnabledMethods(): string[];
   /**
@@ -181,7 +180,8 @@ export interface EntityInterface extends DataObjectInterface {
    * This should only be used by Nymph to save the data into storage.
    *
    * @param includeSData Whether to include the serialized data as well.
-   * @param referenceOnlyExisting Whether to only turn existing entities into references.
+   * @param referenceOnlyExisting Whether to only turn existing entities into
+   *                              references.
    * @returns The entity's data object.
    */
   $getData(includeSData?: boolean, referenceOnlyExisting?: boolean): EntityData;
@@ -256,8 +256,10 @@ export interface EntityInterface extends DataObjectInterface {
    * - $allowlistTags
    * - $allowlistData
    *
-   * @param input The input data. Please note, this will be modified (destroyed).
-   * @param allowConflict Allow to accept data that is older than the current data.
+   * @param input The input data. Please note, this will be modified
+   *              (destroyed).
+   * @param allowConflict Allow to accept data that is older than the current
+   *                      data.
    */
   $jsonAcceptData(input: EntityJson, allowConflict?: boolean): void;
   /**
@@ -270,8 +272,10 @@ export interface EntityInterface extends DataObjectInterface {
    * - $allowlistTags
    * - $allowlistData
    *
-   * @param patch The patch data. Please note, this will be modified (destroyed).
-   * @param allowConflict Allow to accept data that is older than the current data.
+   * @param patch The patch data. Please note, this will be modified
+   *              (destroyed).
+   * @param allowConflict Allow to accept data that is older than the current
+   *                      data.
    */
   $jsonAcceptPatch(patch: EntityPatch, allowConflict?: boolean): void;
   /**

package/src/decorators/index.ts

@@ -0,0 +1 @@
+export * from './transactional.js';

package/src/decorators/transactional.ts

@@ -0,0 +1,63 @@
+import { nanoid } from '@nymphjs/guid';
+
+import Entity from '../Entity.js';
+
+/**
+ * A decorator that runs the decorated method inside a transaction.
+ *
+ * If the method resolves, the transaction is committed. If the method throws,
+ * the transaction is rolled back.
+ *
+ * Uses $setNymph to set the transactional instance of Nymph on the entity and
+ * return to the original instance after the transaction is committed or rolled
+ * back.
+ */
+export function transactional(
+  target: (...args: any[]) => Promise<any>,
+  context: ClassMethodDecoratorContext,
+) {
+  const name = String(context.name);
+  return async function (this: Entity, ...args: unknown[]) {
+    const transactionName = `${name}-${nanoid()}`;
+    const nymph = this.$nymph;
+    nymph.config.debugInfo(
+      'nymph:transactional',
+      `Starting transaction ${transactionName}`,
+    );
+    const tnymph = await nymph.startTransaction(transactionName);
+    this.$setNymph(tnymph);
+    let committed = false;
+    let result: any;
+    try {
+      result = await target.apply(this, args);
+      nymph.config.debugInfo(
+        'nymph:transactional',
+        `Committing transaction ${transactionName}`,
+      );
+      committed = await tnymph.commit(transactionName);
+    } catch (e: any) {
+      try {
+        nymph.config.debugInfo(
+          'nymph:transactional',
+          `Rolling back transaction ${transactionName}, reason: ${e.message}`,
+        );
+        await tnymph.rollback(transactionName);
+      } catch (e: any) {
+        nymph.config.debugError(
+          'nymph:transactional',
+          `Rollback of transaction ${transactionName} failed, reason: ${e.message}`,
+        );
+      }
+      this.$setNymph(nymph);
+      throw e;
+    }
+
+    this.$setNymph(nymph);
+
+    if (!committed) {
+      throw new Error('Transaction could not be committed.');
+    }
+
+    return result;
+  };
+}

package/src/driver/NymphDriver.ts

@@ -1598,18 +1598,30 @@ export default abstract class NymphDriver {
           sdata,
         );
       }
+
+      if (!success) {
+        entity.guid = originalGuid;
+        entity.cdate = originalCdate;
+        entity.mdate = originalMdate;
+      }
+
+      return success;
     } catch (e: any) {
+      if (commitTransactionCallback) {
+        try {
+          await commitTransactionCallback(false);
+        } catch (e: any) {
+          this.nymph.config.debugError(
+            'nymph',
+            `Rollback of entity save transaction failed, reason: ${e.message}`,
+          );
+        }
+      }
       entity.guid = originalGuid;
       entity.cdate = originalCdate;
       entity.mdate = originalMdate;
       throw e;
     }
-    if (!success) {
-      entity.guid = originalGuid;
-      entity.cdate = originalCdate;
-      entity.mdate = originalMdate;
-    }
-    return success;
   }
 
   /**