@nmshd/consumption 3.4.2 → 3.5.0

package/dist/buildInformation.js

@@ -6,10 +6,10 @@ const content_1 = require("@nmshd/content");
 const crypto_1 = require("@nmshd/crypto");
 const transport_1 = require("@nmshd/transport");
 exports.buildInformation = {
-    version: "3.4.2",
-    build: "110",
-    date: "2023-10-17T05:41:49+00:00",
-    commit: "40d88048ab6ca06125a903f680a965a17b952850",
+    version: "3.5.0",
+    build: "112",
+    date: "2023-10-31T10:17:19+00:00",
+    commit: "cc4cf4fbea8615d02b0ad15ab787b4b6dc355bb5",
     dependencies: {"@js-soft/docdb-querytranslator":"^1.1.1","@nmshd/iql":"^0.0.4","ts-simple-nameof":"^1.3.1"},
     libraries: {
         transport: transport_1.buildInformation,

package/dist/consumption/CoreErrors.d.ts

@@ -1,7 +1,20 @@
 import { ApplicationError } from "@js-soft/ts-utils";
 import { CoreError, CoreId } from "@nmshd/transport";
 declare class Attributes {
-    cannotSucceedAttributesWithAParent(parentId: string | CoreId): CoreError;
+    successionMustNotChangeKey(): CoreError;
+    successionPeerIsNotOwner(): CoreError;
+    invalidSuccessionOfOwnSharedIdentityAttribute(comment?: string): CoreError;
+    cannotSucceedPartOfComplexAttribute(parentId: string | CoreId): CoreError;
+    successorMustNotYetExist(): CoreError;
+    successorMustNotHaveASuccessor(comment?: string): CoreError;
+    invalidPredecessor(comment?: string): CoreError;
+    invalidSuccessor(comment?: string): CoreError;
+    predecessorDoesNotExist(): CoreError;
+    successionMustNotChangeOwner(): CoreError;
+    successionMustNotChangeValueType(): CoreError;
+    successionMustNotChangeContentType(): CoreError;
+    successionMustNotChangePeer(comment?: string): CoreError;
+    cannotSucceedAttributesWithASuccessor(successorId: string | CoreId): CoreError;
 }
 declare class Requests {
     unexpectedErrorDuringRequestItemProcessing(error: any): CoreError;

package/dist/consumption/CoreErrors.js

@@ -4,8 +4,62 @@ exports.CoreErrors = void 0;
 const ts_utils_1 = require("@js-soft/ts-utils");
 const transport_1 = require("@nmshd/transport");
 class Attributes {
-    cannotSucceedAttributesWithAParent(parentId) {
-        return new transport_1.CoreError("error.consumption.attributes.cannotSucceedAttributesWithAParent", `The Attribute you want to succeed has a parent (id: ${parentId.toString()}). You cannot succeed Attributes with a parent. Instead, succeed the parent, which will implicitly succeed all its children.`);
+    successionMustNotChangeKey() {
+        return new transport_1.CoreError("error.consumption.attributes.successionMustNotChangeKey", "The predecessor attribute's key does not match that of the successor. The succession of a relationship attribute must not change the key.");
+    }
+    successionPeerIsNotOwner() {
+        return new transport_1.CoreError("error.consumption.attributes.successionPeerIsNotOwner", "The peer of the succeeded attribute is not its owner. This may be an attempt of spoofing.");
+    }
+    invalidSuccessionOfOwnSharedIdentityAttribute(comment) {
+        let errorMessage = "Invalid succession of own shared identity attribute.";
+        if (comment)
+            errorMessage += ` ${comment}`;
+        return new transport_1.CoreError("error.consumption.attributes.invalidSuccessionOfOwnSharedIdentityAttribute", errorMessage);
+    }
+    cannotSucceedPartOfComplexAttribute(parentId) {
+        return new transport_1.CoreError("error.consumption.attributes.cannotSucceedPartOfComplexAttribute", `The attribute you want to succeed is part of a complex attribute (id: ${parentId}), and cannot be succeeded on its own. Instead, succeed the parent which will implicitly succeed all its children.`);
+    }
+    successorMustNotYetExist() {
+        return new transport_1.CoreError("error.consumption.attributes.successorMustNotYetExist", "The predecessor attribute's successor must not exist. It will be created by the succession handlers and must not be created manually.");
+    }
+    successorMustNotHaveASuccessor(comment) {
+        let errorMessage = "The successor must not have a successor itself.";
+        if (comment)
+            errorMessage += ` ${comment}`;
+        return new transport_1.CoreError("error.consumption.attributes.successorMustNotHaveASuccessor", errorMessage);
+    }
+    invalidPredecessor(comment) {
+        let errorMessage = "Invalid predecessor.";
+        if (comment)
+            errorMessage += ` ${comment}`;
+        return new transport_1.CoreError("error.consumption.attributes.invalidPredecessor", errorMessage);
+    }
+    invalidSuccessor(comment) {
+        let errorMessage = "Invalid successor.";
+        if (comment)
+            errorMessage += ` ${comment}`;
+        return new transport_1.CoreError("error.consumption.attributes.invalidSuccessor", errorMessage);
+    }
+    predecessorDoesNotExist() {
+        return new transport_1.CoreError("error.consumption.attributes.predecessorDoesNotExist", "The predecessor does not exist.");
+    }
+    successionMustNotChangeOwner() {
+        return new transport_1.CoreError("error.consumption.attributes.successionMustNotChangeOwner", "The successor attribute's owner does not match that of the predecessor. An attribute succession must not change the attribute's owner.");
+    }
+    successionMustNotChangeValueType() {
+        return new transport_1.CoreError("error.consumption.attributes.successionMustNotChangeValueType", "The successor attribute's value type does not match that of the predecessor. An attribute succession must not change the attribute's value type.");
+    }
+    successionMustNotChangeContentType() {
+        return new transport_1.CoreError("error.consumption.attributes.successionMustNotChangeContentType", "The successor attribute's content type does not match that of the predecessor. An attribute succession must not change the attribute's content type, i.e. an identity attribute must not be succeeded by a relationship attribute and v.v.");
+    }
+    successionMustNotChangePeer(comment) {
+        let errorMessage = "The peer of the shared attribute must not change.";
+        if (comment)
+            errorMessage += ` ${comment}`;
+        return new transport_1.CoreError("error.consumption.attributes.successionMustNotChangePeer", errorMessage);
+    }
+    cannotSucceedAttributesWithASuccessor(successorId) {
+        return new transport_1.CoreError("error.consumption.attributes.cannotSucceedAttributesWithASuccessor", `The Attribute you want to succeed has a successor (id: ${successorId}). You cannot succeed Attributes with a successor. Instead, succeed the successor.`);
     }
 }
 class Requests {

package/dist/consumption/CoreErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoreErrors.js","sourceRoot":"","sources":["../../src/consumption/CoreErrors.ts"],"names":[],"mappings":";;;AAAA,gDAAoD;AACpD,gDAAoD;AAEpD,MAAM,UAAU;IACL,kCAAkC,CAAC,QAAyB;QAC/D,OAAO,IAAI,qBAAS,CAChB,iEAAiE,EACjE,uDAAuD,QAAQ,CAAC,QAAQ,EAAE,8HAA8H,CAC3M,CAAA;IACL,CAAC;CACJ;AAED,MAAM,QAAQ;IAAd;QAkEoB,qBAAgB,GAAG,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAA;IACvE,CAAC;IAlEU,0CAA0C,CAAC,KAAU;QACxD,OAAO,IAAI,qBAAS,CAChB,uEAAuE,EACvE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EACpF,SAAS,EACT,SAAS,EACT,KAAK,CACR,CAAA;IACL,CAAC;IAEM,sCAAsC,CAAC,KAAU;QACpD,OAAO,IAAI,qBAAS,CAChB,mEAAmE,EACnE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EACnF,SAAS,EACT,SAAS,EACT,KAAK,CACR,CAAA;IACL,CAAC;IAEM,uBAAuB;QAC1B,OAAO,IAAI,2BAAgB,CACvB,8DAA8D,EAC9D,yDAAyD,CAC5D,CAAA;IACL,CAAC;IAEM,kBAAkB,CAAC,OAAe;QACrC,OAAO,IAAI,qBAAS,CAAC,+CAA+C,EAAE,OAAO,CAAC,CAAA;IAClF,CAAC;;AAEuB,0BAAiB,GAAG;IACjC,oBAAoB,CAAC,OAAe;QACvC,OAAO,IAAI,2BAAgB,CAAC,mEAAmE,EAAE,OAAO,CAAC,CAAA;IAC7G,CAAC;IAEM,gCAAgC,CAAC,OAAe;QACnD,OAAO,IAAI,2BAAgB,CACvB,+EAA+E,EAC/E,OAAO,CACV,CAAA;IACL,CAAC;IAEM,6BAA6B,CAAC,OAAe;QAChD,OAAO,IAAI,2BAAgB,CACvB,4EAA4E,EAC5E,OAAO,CACV,CAAA;IACL,CAAC;IAEM,qCAAqC;QACxC,OAAO,IAAI,2BAAgB,CACvB,oFAAoF,EACpF,qDAAqD,CACxD,CAAA;IACL,CAAC;IAEM,qCAAqC;QACxC,OAAO,IAAI,2BAAgB,CACvB,oFAAoF,EACpF,qDAAqD,CACxD,CAAA;IACL,CAAC;CACJ,AAhCwC,CAgCxC;AAKL,MAAa,UAAU;;AAAvB,gCAGC;AAFiB,qBAAU,GAAG,IAAI,UAAU,EAAE,CAAA;AAC7B,mBAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"CoreErrors.js","sourceRoot":"","sources":["../../src/consumption/CoreErrors.ts"],"names":[],"mappings":"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"}

package/dist/modules/attributes/AttributesController.d.ts

@@ -1,14 +1,14 @@
 import { EventBus } from "@js-soft/ts-utils";
 import { IIQLQuery, IIdentityAttributeQuery, IRelationshipAttributeQuery, IThirdPartyRelationshipAttributeQuery } from "@nmshd/content";
-import { CoreAddress, CoreId } from "@nmshd/transport";
+import { CoreAddress, CoreId, ICoreDate, ICoreId } from "@nmshd/transport";
 import { ConsumptionBaseController } from "../../consumption/ConsumptionBaseController";
 import { ConsumptionController } from "../../consumption/ConsumptionController";
+import { ValidationResult } from "../common";
 import { ICreateLocalAttributeParams } from "./local/CreateLocalAttributeParams";
 import { ICreatePeerLocalAttributeParams } from "./local/CreatePeerLocalAttributeParams";
 import { ICreateSharedLocalAttributeCopyParams } from "./local/CreateSharedLocalAttributeCopyParams";
-import { LocalAttribute } from "./local/LocalAttribute";
-import { ISucceedLocalAttributeParams } from "./local/SucceedLocalAttributeParams";
-import { IUpdateLocalAttributeParams } from "./local/UpdateLocalAttributeParams";
+import { IAttributeSuccessorParams } from "./local/IAttributeSuccessorParams";
+import { ILocalAttribute, LocalAttribute } from "./local/LocalAttribute";
 export declare class AttributesController extends ConsumptionBaseController {
     private readonly eventBus;
     private readonly identity;
@@ -30,9 +30,40 @@ export declare class AttributesController extends ConsumptionBaseController {
     executeIdentityAttributeQuery(query: IIdentityAttributeQuery): Promise<LocalAttribute[]>;
     createLocalAttribute(params: ICreateLocalAttributeParams): Promise<LocalAttribute>;
     private createLocalAttributesForNestedAttributeValues;
-    succeedLocalAttribute(params: ISucceedLocalAttributeParams): Promise<LocalAttribute>;
     createSharedLocalAttributeCopy(params: ICreateSharedLocalAttributeCopyParams): Promise<LocalAttribute>;
     createPeerLocalAttribute(params: ICreatePeerLocalAttributeParams): Promise<LocalAttribute>;
-    updateLocalAttribute(params: IUpdateLocalAttributeParams): Promise<LocalAttribute>;
     deleteAttribute(attribute: LocalAttribute): Promise<void>;
+    succeedRepositoryAttribute(predecessorId: CoreId, successorParams: IAttributeSuccessorParams, validate?: boolean): Promise<{
+        predecessor: LocalAttribute;
+        successor: LocalAttribute;
+    }>;
+    succeedOwnSharedIdentityAttribute(predecessorId: CoreId, successorParams: IAttributeSuccessorParams, validate?: boolean): Promise<{
+        predecessor: LocalAttribute;
+        successor: LocalAttribute;
+    }>;
+    succeedOwnSharedRelationshipAttribute(predecessorId: CoreId, successorParams: IAttributeSuccessorParams, validate?: boolean): Promise<{
+        predecessor: LocalAttribute;
+        successor: LocalAttribute;
+    }>;
+    succeedPeerSharedIdentityAttribute(predecessorId: CoreId, successorParams: IAttributeSuccessorParams, validate?: boolean): Promise<{
+        predecessor: LocalAttribute;
+        successor: LocalAttribute;
+    }>;
+    succeedPeerSharedRelationshipAttribute(predecessorId: CoreId, successorParams: IAttributeSuccessorParams, validate?: boolean): Promise<{
+        predecessor: LocalAttribute;
+        successor: LocalAttribute;
+    }>;
+    private _succeedAttributeUnsafe;
+    validateRepositoryAttributeSuccession(predecessorId: CoreId, successorParams: IAttributeSuccessorParams): Promise<ValidationResult>;
+    validateOwnSharedIdentityAttributeSuccession(predecessorId: CoreId, successorParams: IAttributeSuccessorParams): Promise<ValidationResult>;
+    validateOwnSharedRelationshipAttributeSuccession(predecessorId: CoreId, successorParams: IAttributeSuccessorParams): Promise<ValidationResult>;
+    validatePeerSharedIdentityAttributeSuccession(predecessorId: CoreId, successorParams: IAttributeSuccessorParams): Promise<ValidationResult>;
+    validatePeerSharedRelationshipAttributeSuccession(predecessorId: CoreId, successorParams: IAttributeSuccessorParams): Promise<ValidationResult>;
+    validateAttributeSuccessionCommon(predecessorId: CoreId, successorParams: IAttributeSuccessorParams): Promise<ValidationResult>;
+    createAttributeUnsafe(attributeData: Omit<ILocalAttribute, "id" | "createdAt"> & {
+        id?: ICoreId;
+        createdAt?: ICoreDate;
+    }): Promise<LocalAttribute>;
+    updateAttributeUnsafe(attributeParams: ILocalAttribute): Promise<void>;
+    deleteAttributeUnsafe(id: CoreId): Promise<void>;
 }

package/dist/modules/attributes/AttributesController.js

@@ -22,23 +22,28 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttributesController = void 0;
 const content_1 = require("@nmshd/content");
 const Iql = __importStar(require("@nmshd/iql"));
 const transport_1 = require("@nmshd/transport");
+const lodash_1 = __importDefault(require("lodash"));
 const ts_simple_nameof_1 = require("ts-simple-nameof");
 const ConsumptionBaseController_1 = require("../../consumption/ConsumptionBaseController");
 const ConsumptionControllerName_1 = require("../../consumption/ConsumptionControllerName");
 const ConsumptionError_1 = require("../../consumption/ConsumptionError");
 const ConsumptionIds_1 = require("../../consumption/ConsumptionIds");
 const CoreErrors_1 = require("../../consumption/CoreErrors");
+const common_1 = require("../common");
 const events_1 = require("./events");
+const CreateLocalAttributeParams_1 = require("./local/CreateLocalAttributeParams");
 const CreateSharedLocalAttributeCopyParams_1 = require("./local/CreateSharedLocalAttributeCopyParams");
 const LocalAttribute_1 = require("./local/LocalAttribute");
 const LocalAttributeShareInfo_1 = require("./local/LocalAttributeShareInfo");
 const QueryTranslator_1 = require("./local/QueryTranslator");
-const SucceedLocalAttributeParams_1 = require("./local/SucceedLocalAttributeParams");
 class AttributesController extends ConsumptionBaseController_1.ConsumptionBaseController {
     constructor(parent, eventBus, identity) {
         super(ConsumptionControllerName_1.ConsumptionControllerName.AttributesController, parent);
@@ -142,9 +147,12 @@ class AttributesController extends ConsumptionBaseController_1.ConsumptionBaseCo
     }
     async executeIQLQuery(query) {
         /* Fetch subset of attributes relevant for IQL queries. We filter for
-         * local identity attributes. */
-        const envelopedAttributes = (await this.attributes.find()).filter((e) => {
-            return e["@type"] === "LocalAttribute" && e.content["@type"] === "IdentityAttribute";
+         * identity attributes which are not shared. */
+        const envelopedAttributes = await this.attributes.find({
+            "content.@type": "IdentityAttribute",
+            shareInfo: {
+                $exists: false
+            }
         });
         /* Remove envelope from attributes and execute query. IQL makes no use
          * of the envelope data. */
@@ -181,11 +189,14 @@ class AttributesController extends ConsumptionBaseController_1.ConsumptionBaseCo
         return this.parseArray(attributes, LocalAttribute_1.LocalAttribute);
     }
     async createLocalAttribute(params) {
+        const parsedParams = CreateLocalAttributeParams_1.CreateLocalAttributeParams.from(params);
         const localAttribute = LocalAttribute_1.LocalAttribute.from({
-            id: await ConsumptionIds_1.ConsumptionIds.attribute.generate(),
+            id: parsedParams.id ?? (await ConsumptionIds_1.ConsumptionIds.attribute.generate()),
             createdAt: transport_1.CoreDate.utc(),
-            content: params.content,
-            parentId: params.parentId
+            content: parsedParams.content,
+            parentId: parsedParams.parentId,
+            succeeds: parsedParams.succeeds,
+            shareInfo: parsedParams.shareInfo
         });
         await this.attributes.create(localAttribute);
         if (localAttribute.content instanceof content_1.IdentityAttribute && // nested Local Attributes should only be created for Identity Attributes
@@ -208,29 +219,6 @@ class AttributesController extends ConsumptionBaseController_1.ConsumptionBaseCo
             await this.createLocalAttribute({ content: nestedAttribute, parentId: localAttribute.id });
         }
     }
-    async succeedLocalAttribute(params) {
-        const parsedParams = SucceedLocalAttributeParams_1.SucceedLocalAttributeParams.from(params);
-        const currentAttributeDoc = await this.attributes.findOne({
-            [(0, ts_simple_nameof_1.nameof)((c) => c.id)]: params.succeeds.toString()
-        });
-        const currentAttribute = LocalAttribute_1.LocalAttribute.from(currentAttributeDoc);
-        if (currentAttribute.parentId) {
-            throw CoreErrors_1.CoreErrors.attributes.cannotSucceedAttributesWithAParent(parsedParams.succeeds.toString());
-        }
-        if (!currentAttributeDoc) {
-            throw transport_1.CoreErrors.general.recordNotFound(LocalAttribute_1.LocalAttribute, parsedParams.succeeds.toString());
-        }
-        if (!parsedParams.successorContent.validFrom) {
-            parsedParams.successorContent.validFrom = transport_1.CoreDate.utc();
-        }
-        const validFrom = parsedParams.successorContent.validFrom;
-        currentAttribute.content.validTo = validFrom.subtract(1);
-        await this.attributes.update(currentAttributeDoc, currentAttribute);
-        const successor = await LocalAttribute_1.LocalAttribute.fromAttribute(parsedParams.successorContent, parsedParams.succeeds);
-        await this.attributes.create(successor);
-        this.eventBus.publish(new events_1.AttributeSucceededEvent(this.identity.address.toString(), successor));
-        return successor;
-    }
     async createSharedLocalAttributeCopy(params) {
         const parsedParams = CreateSharedLocalAttributeCopyParams_1.CreateSharedLocalAttributeCopyParams.from(params);
         const sourceAttribute = await this.getLocalAttribute(parsedParams.sourceAttributeId);
@@ -262,28 +250,349 @@ class AttributesController extends ConsumptionBaseController_1.ConsumptionBaseCo
         this.eventBus.publish(new events_1.AttributeCreatedEvent(this.identity.address.toString(), peerLocalAttribute));
         return peerLocalAttribute;
     }
-    async updateLocalAttribute(params) {
-        const current = await this.attributes.findOne({
-            [(0, ts_simple_nameof_1.nameof)((c) => c.id)]: params.id.toString()
+    async deleteAttribute(attribute) {
+        await this.deleteAttributeUnsafe(attribute.id);
+        this.eventBus.publish(new events_1.AttributeDeletedEvent(this.identity.address.toString(), attribute));
+    }
+    async succeedRepositoryAttribute(predecessorId, successorParams, validate = true) {
+        if (validate) {
+            const validationResult = await this.validateRepositoryAttributeSuccession(predecessorId, successorParams);
+            if (validationResult.isError()) {
+                throw validationResult.error;
+            }
+        }
+        const { predecessor, successor } = await this._succeedAttributeUnsafe(predecessorId, {
+            id: successorParams.id,
+            content: successorParams.content,
+            succeeds: predecessorId,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId,
+            createdAt: successorParams.createdAt,
+            succeededBy: successorParams.succeededBy
         });
-        if (!current) {
-            throw transport_1.CoreErrors.general.recordNotFound(LocalAttribute_1.LocalAttribute, params.id.toString());
+        this.eventBus.publish(new events_1.RepositoryAttributeSucceededEvent(this.identity.address.toString(), predecessor, successor));
+        return { predecessor, successor };
+    }
+    async succeedOwnSharedIdentityAttribute(predecessorId, successorParams, validate = true) {
+        if (validate) {
+            const validationResult = await this.validateOwnSharedIdentityAttributeSuccession(predecessorId, successorParams);
+            if (validationResult.isError()) {
+                throw validationResult.error;
+            }
         }
-        const updatedLocalAttribute = LocalAttribute_1.LocalAttribute.from({
-            id: current.id,
-            content: params.content,
-            createdAt: current.createdAt,
-            shareInfo: current.shareInfo,
-            succeededBy: current.succeededBy,
-            succeeds: current.succeeds
+        const { predecessor, successor } = await this._succeedAttributeUnsafe(predecessorId, {
+            id: successorParams.id,
+            content: successorParams.content,
+            succeeds: predecessorId,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId,
+            createdAt: successorParams.createdAt,
+            succeededBy: successorParams.succeededBy
         });
-        await this.attributes.update(current, updatedLocalAttribute);
-        this.eventBus.publish(new events_1.AttributeUpdatedEvent(this.identity.address.toString(), updatedLocalAttribute));
-        return updatedLocalAttribute;
+        this.eventBus.publish(new events_1.OwnSharedAttributeSucceededEvent(this.identity.address.toString(), predecessor, successor));
+        return { predecessor, successor };
     }
-    async deleteAttribute(attribute) {
-        await this.attributes.delete(attribute);
-        this.eventBus.publish(new events_1.AttributeDeletedEvent(this.identity.address.toString(), attribute));
+    async succeedOwnSharedRelationshipAttribute(predecessorId, successorParams, validate = true) {
+        if (validate) {
+            const validationResult = await this.validateOwnSharedRelationshipAttributeSuccession(predecessorId, successorParams);
+            if (validationResult.isError()) {
+                throw validationResult.error;
+            }
+        }
+        const { predecessor, successor } = await this._succeedAttributeUnsafe(predecessorId, {
+            id: successorParams.id,
+            content: successorParams.content,
+            succeeds: predecessorId,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId,
+            createdAt: successorParams.createdAt,
+            succeededBy: successorParams.succeededBy
+        });
+        this.eventBus.publish(new events_1.OwnSharedAttributeSucceededEvent(this.identity.address.toString(), predecessor, successor));
+        return { predecessor, successor };
+    }
+    async succeedPeerSharedIdentityAttribute(predecessorId, successorParams, validate = true) {
+        if (validate) {
+            const validationResult = await this.validatePeerSharedIdentityAttributeSuccession(predecessorId, successorParams);
+            if (validationResult.isError()) {
+                throw validationResult.error;
+            }
+        }
+        const { predecessor, successor } = await this._succeedAttributeUnsafe(predecessorId, {
+            id: successorParams.id,
+            content: successorParams.content,
+            succeeds: predecessorId,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId,
+            createdAt: successorParams.createdAt,
+            succeededBy: successorParams.succeededBy
+        });
+        /* No succeeded attribute event fired here. This is done by the notification system. */
+        return { predecessor, successor };
+    }
+    async succeedPeerSharedRelationshipAttribute(predecessorId, successorParams, validate = true) {
+        if (validate) {
+            const validationResult = await this.validatePeerSharedRelationshipAttributeSuccession(predecessorId, successorParams);
+            if (validationResult.isError()) {
+                throw validationResult.error;
+            }
+        }
+        const { predecessor, successor } = await this._succeedAttributeUnsafe(predecessorId, {
+            id: successorParams.id,
+            content: successorParams.content,
+            succeeds: predecessorId,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId,
+            createdAt: successorParams.createdAt,
+            succeededBy: successorParams.succeededBy
+        });
+        /* No succeeded attribute event fired here. This is done by the notification system. */
+        return { predecessor, successor };
+    }
+    async _succeedAttributeUnsafe(predecessorId, successorParams) {
+        const successor = await this.createAttributeUnsafe({
+            id: successorParams.id,
+            content: successorParams.content,
+            succeeds: predecessorId,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId,
+            createdAt: successorParams.createdAt,
+            succeededBy: successorParams.succeededBy
+        });
+        const predecessor = (await this.getLocalAttribute(predecessorId));
+        predecessor.succeededBy = successor.id;
+        await this.updateAttributeUnsafe(predecessor);
+        return { predecessor, successor };
+    }
+    async validateRepositoryAttributeSuccession(predecessorId, successorParams) {
+        const commonValidation = await this.validateAttributeSuccessionCommon(predecessorId, successorParams);
+        if (commonValidation.isError())
+            return commonValidation;
+        const predecessor = (await this.getLocalAttribute(predecessorId));
+        const successor = LocalAttribute_1.LocalAttribute.from({
+            id: transport_1.CoreId.from(successorParams.id ?? "dummy"),
+            content: successorParams.content,
+            createdAt: successorParams.createdAt ?? transport_1.CoreDate.utc(),
+            succeeds: successorParams.succeeds,
+            succeededBy: successorParams.succeededBy,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId
+        });
+        if (!predecessor.isIdentityAttribute() || predecessor.isShared()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("Predecessor is not a valid repository attribute."));
+        }
+        if (!successor.isIdentityAttribute() || successor.isShared()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("Successor is not a valid repository attribute."));
+        }
+        return common_1.ValidationResult.success();
+    }
+    async validateOwnSharedIdentityAttributeSuccession(predecessorId, successorParams) {
+        const commonValidation = await this.validateAttributeSuccessionCommon(predecessorId, successorParams);
+        if (commonValidation.isError())
+            return commonValidation;
+        const predecessor = (await this.getLocalAttribute(predecessorId));
+        const successor = LocalAttribute_1.LocalAttribute.from({
+            id: transport_1.CoreId.from(successorParams.id ?? "dummy"),
+            content: successorParams.content,
+            createdAt: successorParams.createdAt ?? transport_1.CoreDate.utc(),
+            succeeds: successorParams.succeeds,
+            succeededBy: successorParams.succeededBy,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId
+        });
+        if (!predecessor.isOwnSharedIdentityAttribute(this.identity.address)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("Predecessor is not a valid own shared identity attribute."));
+        }
+        if (!successor.isOwnSharedIdentityAttribute(this.identity.address)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessor("Successor is not a valid peer shared identity attribute."));
+        }
+        if (!predecessor.shareInfo.peer.equals(successor.shareInfo.peer)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangePeer());
+        }
+        /* Succession of own shared identity attribute must be matched by their
+         * respective repository attributes. */
+        const predecessorSource = await this.getLocalAttribute(predecessor.shareInfo.sourceAttribute);
+        const successorSource = await this.getLocalAttribute(successor.shareInfo.sourceAttribute);
+        if (typeof predecessorSource === "undefined" || !predecessorSource.isRepositoryAttribute()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessionOfOwnSharedIdentityAttribute());
+        }
+        if (typeof successorSource === "undefined" || !successorSource.isRepositoryAttribute()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessionOfOwnSharedIdentityAttribute("Source attribute is not a valid repository attribute."));
+        }
+        if (typeof successorSource.succeeds === "undefined" ||
+            !successorSource.succeeds.equals(predecessorSource.id) ||
+            typeof predecessorSource.succeededBy === "undefined" ||
+            !predecessorSource.succeededBy.equals(successorSource.id)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessionOfOwnSharedIdentityAttribute("Prdeecessor source attribute is not succeeded by successor source attribute."));
+        }
+        const repositoryAttributeContentMatchesItsSharedAttribute = lodash_1.default.isEqual(predecessorSource.content, predecessor.content) &&
+            lodash_1.default.isEqual(successorSource.content, successor.content);
+        if (!repositoryAttributeContentMatchesItsSharedAttribute) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessionOfOwnSharedIdentityAttribute("Successor source attribute contents don't match successor shared attribute copy."));
+        }
+        return common_1.ValidationResult.success();
+    }
+    async validateOwnSharedRelationshipAttributeSuccession(predecessorId, successorParams) {
+        const commonValidation = await this.validateAttributeSuccessionCommon(predecessorId, successorParams);
+        if (commonValidation.isError())
+            return commonValidation;
+        const predecessor = (await this.getLocalAttribute(predecessorId));
+        const successor = LocalAttribute_1.LocalAttribute.from({
+            id: transport_1.CoreId.from(successorParams.id ?? "dummy"),
+            content: successorParams.content,
+            createdAt: successorParams.createdAt ?? transport_1.CoreDate.utc(),
+            succeeds: successorParams.succeeds,
+            succeededBy: successorParams.succeededBy,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId
+        });
+        if (!predecessor.isOwnSharedRelationshipAttribute(this.identity.address)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("Predecessor is not a valid own shared relationship attribute."));
+        }
+        if (!successor.isOwnSharedRelationshipAttribute(this.identity.address)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessor("Successor is not a valid own shared relationship attribute."));
+        }
+        if (successor.content.key !== predecessor.content.key) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangeKey());
+        }
+        if (!predecessor.shareInfo.peer.equals(successor.shareInfo.peer)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangePeer());
+        }
+        return common_1.ValidationResult.success();
+    }
+    async validatePeerSharedIdentityAttributeSuccession(predecessorId, successorParams) {
+        const commonValidation = await this.validateAttributeSuccessionCommon(predecessorId, successorParams);
+        if (commonValidation.isError())
+            return commonValidation;
+        const predecessor = (await this.getLocalAttribute(predecessorId));
+        const successor = LocalAttribute_1.LocalAttribute.from({
+            id: transport_1.CoreId.from(successorParams.id ?? "dummy"),
+            content: successorParams.content,
+            createdAt: successorParams.createdAt ?? transport_1.CoreDate.utc(),
+            succeeds: successorParams.succeeds,
+            succeededBy: successorParams.succeededBy,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId
+        });
+        if (!predecessor.isPeerSharedIdentityAttribute()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("Predecessor is not a valid peer shared identity attribute."));
+        }
+        if (!successor.isPeerSharedIdentityAttribute()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessor("Successor is not a valid peer shared identity attribute."));
+        }
+        if (!predecessor.shareInfo.peer.equals(successor.shareInfo.peer)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangePeer());
+        }
+        return common_1.ValidationResult.success();
+    }
+    async validatePeerSharedRelationshipAttributeSuccession(predecessorId, successorParams) {
+        const commonValidation = await this.validateAttributeSuccessionCommon(predecessorId, successorParams);
+        if (commonValidation.isError())
+            return commonValidation;
+        const predecessor = (await this.getLocalAttribute(predecessorId));
+        const successor = LocalAttribute_1.LocalAttribute.from({
+            id: transport_1.CoreId.from(successorParams.id ?? "dummy"),
+            content: successorParams.content,
+            createdAt: successorParams.createdAt ?? transport_1.CoreDate.utc(),
+            succeeds: successorParams.succeeds,
+            succeededBy: successorParams.succeededBy,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId
+        });
+        if (!predecessor.isPeerSharedRelationshipAttribute()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("Predecessor is not a valid peer shared relationship attribute."));
+        }
+        if (!successor.isPeerSharedRelationshipAttribute()) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidSuccessor("Successor is not a valid peer shared relationship attribute."));
+        }
+        if (successor.content.key !== predecessor.content.key) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangeKey());
+        }
+        if (!predecessor.shareInfo.peer.equals(successor.shareInfo.peer)) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangePeer());
+        }
+        return common_1.ValidationResult.success();
+    }
+    async validateAttributeSuccessionCommon(predecessorId, successorParams) {
+        const successor = LocalAttribute_1.LocalAttribute.from({
+            id: transport_1.CoreId.from(successorParams.id ?? "dummy"),
+            content: successorParams.content,
+            createdAt: successorParams.createdAt ?? transport_1.CoreDate.utc(),
+            succeeds: successorParams.succeeds,
+            succeededBy: successorParams.succeededBy,
+            shareInfo: successorParams.shareInfo,
+            parentId: successorParams.parentId
+        });
+        if (typeof successorParams.id !== "undefined") {
+            const successor = await this.getLocalAttribute(transport_1.CoreId.from(successorParams.id));
+            if (typeof successor !== "undefined") {
+                return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successorMustNotYetExist());
+            }
+        }
+        if (typeof successor.succeeds !== "undefined" && !predecessorId.equals(successor.succeeds.toString())) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.invalidPredecessor("The predecessor's id and the explicitly set value for the successor's succeeds field don't match."));
+        }
+        if (typeof successor.succeededBy !== "undefined") {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successorMustNotHaveASuccessor());
+        }
+        if (typeof successor.parentId !== "undefined") {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.cannotSucceedPartOfComplexAttribute(predecessorId.toString()));
+        }
+        const predecessor = await this.getLocalAttribute(predecessorId);
+        if (typeof predecessor === "undefined") {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.predecessorDoesNotExist());
+        }
+        if (typeof predecessor.succeededBy !== "undefined") {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.cannotSucceedAttributesWithASuccessor(predecessor.succeededBy.toString()));
+        }
+        if (predecessor.parentId) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.cannotSucceedPartOfComplexAttribute(predecessorId.toString()));
+        }
+        if (!predecessor.content.owner.equals(transport_1.CoreAddress.from(successor.content.owner))) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangeOwner());
+        }
+        if (successor.content.constructor !== predecessor.content.constructor) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangeContentType());
+        }
+        if (predecessor.content.value.constructor !== successor.content.value.constructor) {
+            return common_1.ValidationResult.error(CoreErrors_1.CoreErrors.attributes.successionMustNotChangeValueType());
+        }
+        return common_1.ValidationResult.success();
+    }
+    async createAttributeUnsafe(attributeData) {
+        const localAttribute = LocalAttribute_1.LocalAttribute.from({
+            id: attributeData.id ?? (await ConsumptionIds_1.ConsumptionIds.attribute.generate()),
+            content: attributeData.content,
+            createdAt: attributeData.createdAt ?? transport_1.CoreDate.utc(),
+            shareInfo: attributeData.shareInfo,
+            parentId: attributeData.parentId,
+            succeededBy: attributeData.succeededBy,
+            succeeds: attributeData.succeeds
+        });
+        await this.attributes.create(localAttribute);
+        return localAttribute;
+    }
+    async updateAttributeUnsafe(attributeParams) {
+        const doc = await this.attributes.findOne({
+            [(0, ts_simple_nameof_1.nameof)((c) => c.id)]: attributeParams.id.toString()
+        });
+        if (!doc) {
+            throw transport_1.CoreErrors.general.recordNotFound(LocalAttribute_1.LocalAttribute, attributeParams.id.toString());
+        }
+        const params = {
+            id: attributeParams.id,
+            content: attributeParams.content,
+            createdAt: attributeParams.createdAt,
+            parentId: attributeParams.parentId,
+            shareInfo: attributeParams.shareInfo,
+            succeededBy: attributeParams.succeededBy,
+            succeeds: attributeParams.succeeds
+        };
+        const newAttribute = LocalAttribute_1.LocalAttribute.from(params);
+        await this.attributes.update(doc, newAttribute);
+    }
+    async deleteAttributeUnsafe(id) {
+        await this.attributes.delete({ id: id });
     }
 }
 exports.AttributesController = AttributesController;