@sitecore/sc-contenthub-webclient-sdk 1.1.0 → 1.2.0

package/dist/contracts/base/property-definitions/long-property-definition.js

@@ -26,8 +26,9 @@ let LongPropertyDefinition = class LongPropertyDefinition extends property_defin
     }
 };
 LongPropertyDefinition = __decorate([
-    ta_json_1.JsonObject(),
-    ta_json_1.JsonDiscriminatorValue(data_type_1.default.Long),
+    (0, ta_json_1.JsonObject)(),
+    (0, ta_json_1.JsonDiscriminatorValue)(data_type_1.default.Long),
     __metadata("design:paramtypes", [String, Object])
 ], LongPropertyDefinition);
 exports.LongPropertyDefinition = LongPropertyDefinition;
+//# sourceMappingURL=long-property-definition.js.map

package/dist/contracts/base/property-definitions/string-property-definition.js

@@ -40,16 +40,17 @@ let StringPropertyDefinition = class StringPropertyDefinition extends property_d
     }
 };
 __decorate([
-    ta_json_1.JsonProperty("content_type"),
+    (0, ta_json_1.JsonProperty)("content_type"),
     __metadata("design:type", String)
 ], StringPropertyDefinition.prototype, "contentType", void 0);
 __decorate([
-    ta_json_1.JsonProperty("validation_expression"),
+    (0, ta_json_1.JsonProperty)("validation_expression"),
     __metadata("design:type", Object)
 ], StringPropertyDefinition.prototype, "validationExpression", void 0);
 StringPropertyDefinition = __decorate([
-    ta_json_1.JsonObject(),
-    ta_json_1.JsonDiscriminatorValue(data_type_1.default.String),
+    (0, ta_json_1.JsonObject)(),
+    (0, ta_json_1.JsonDiscriminatorValue)(data_type_1.default.String),
     __metadata("design:paramtypes", [String, Object])
 ], StringPropertyDefinition);
 exports.StringPropertyDefinition = StringPropertyDefinition;
+//# sourceMappingURL=string-property-definition.js.map

package/dist/contracts/base/property-manager.js

@@ -114,3 +114,4 @@ class PropertyManager {
     }
 }
 exports.PropertyManager = PropertyManager;
+//# sourceMappingURL=property-manager.js.map

package/dist/contracts/base/property.js

@@ -29,3 +29,4 @@ class PropertyBase extends member_1.MemberBase {
     }
 }
 exports.PropertyBase = PropertyBase;
+//# sourceMappingURL=property.js.map

package/dist/contracts/base/related-path.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=related-path.js.map

package/dist/contracts/base/relation-cardinality.js

@@ -20,3 +20,4 @@ var RelationCardinality;
      */
     RelationCardinality[RelationCardinality["OneToOne"] = 2] = "OneToOne";
 })(RelationCardinality = exports.RelationCardinality || (exports.RelationCardinality = {}));
+//# sourceMappingURL=relation-cardinality.js.map

package/dist/contracts/base/relation-container.js

@@ -46,7 +46,7 @@ class RelationContainer {
     getRelation(role) {
         if (role == null) {
             if (this.isSelfRelation) {
-                throw new Error(string_format_1.default(error_messages_1.default.Entity.SelfReferencingRelation, this.relationName));
+                throw new Error((0, string_format_1.default)(error_messages_1.default.Entity.SelfReferencingRelation, this.relationName));
             }
             if (this.parentRelation != null) {
                 return this.parentRelation;
@@ -62,7 +62,7 @@ class RelationContainer {
             return this.childRelation;
         }
         else {
-            throw new Error(string_format_1.default(error_messages_1.default.RelationRoleMapper.UnknownRole, role));
+            throw new Error((0, string_format_1.default)(error_messages_1.default.RelationRoleMapper.UnknownRole, role));
         }
     }
     /**
@@ -93,7 +93,7 @@ class RelationContainer {
             return this.childRelation != null;
         }
         else {
-            throw new Error(string_format_1.default(error_messages_1.default.RelationRoleMapper.UnknownRole, role));
+            throw new Error((0, string_format_1.default)(error_messages_1.default.RelationRoleMapper.UnknownRole, role));
         }
     }
     /**
@@ -111,8 +111,9 @@ class RelationContainer {
             this._childRelation = relation;
         }
         else {
-            throw new Error(string_format_1.default(error_messages_1.default.RelationRoleMapper.UnknownRole, relation.role));
+            throw new Error((0, string_format_1.default)(error_messages_1.default.RelationRoleMapper.UnknownRole, relation.role));
         }
     }
 }
 exports.RelationContainer = RelationContainer;
+//# sourceMappingURL=relation-container.js.map

package/dist/contracts/base/relation-definition.js

@@ -36,85 +36,86 @@ let RelationDefinition = class RelationDefinition extends member_definition_1.Me
     }
 };
 __decorate([
-    ta_json_1.JsonProperty("role"),
+    (0, ta_json_1.JsonProperty)("role"),
     __metadata("design:type", Number)
 ], RelationDefinition.prototype, "role", void 0);
 __decorate([
-    ta_json_1.JsonProperty("cardinality"),
+    (0, ta_json_1.JsonProperty)("cardinality"),
     __metadata("design:type", Number)
 ], RelationDefinition.prototype, "cardinality", void 0);
 __decorate([
-    ta_json_1.JsonProperty("associated_entitydefinition"),
+    (0, ta_json_1.JsonProperty)("associated_entitydefinition"),
     __metadata("design:type", String)
 ], RelationDefinition.prototype, "associatedEntityDefinitionName", void 0);
 __decorate([
-    ta_json_1.JsonProperty("child_is_mandatory"),
+    (0, ta_json_1.JsonProperty)("child_is_mandatory"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "childIsMandatory", void 0);
 __decorate([
-    ta_json_1.JsonProperty("parent_is_mandatory"),
+    (0, ta_json_1.JsonProperty)("parent_is_mandatory"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "parentIsMandatory", void 0);
 __decorate([
-    ta_json_1.JsonProperty("inherits_security"),
+    (0, ta_json_1.JsonProperty)("inherits_security"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "inheritsSecurity", void 0);
 __decorate([
-    ta_json_1.JsonProperty("allow_navigation"),
+    (0, ta_json_1.JsonProperty)("allow_navigation"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "allowNavigation", void 0);
 __decorate([
-    ta_json_1.JsonProperty("is_nested"),
+    (0, ta_json_1.JsonProperty)("is_nested"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "isNested", void 0);
 __decorate([
-    ta_json_1.JsonProperty("nested_properties"),
-    ta_json_1.JsonElementType(String),
+    (0, ta_json_1.JsonProperty)("nested_properties"),
+    (0, ta_json_1.JsonElementType)(String),
     __metadata("design:type", Array)
 ], RelationDefinition.prototype, "nestedProperties", void 0);
 __decorate([
-    ta_json_1.JsonProperty("nested_permissions"),
+    (0, ta_json_1.JsonProperty)("nested_permissions"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "nestedPermissions", void 0);
 __decorate([
-    ta_json_1.JsonProperty("is_taxonomy_relation"),
+    (0, ta_json_1.JsonProperty)("is_taxonomy_relation"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "isTaxonomyRelation", void 0);
 __decorate([
-    ta_json_1.JsonProperty("is_taxonomy_hierarchy_relation"),
+    (0, ta_json_1.JsonProperty)("is_taxonomy_hierarchy_relation"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "isTaxonomyHierarchyRelation", void 0);
 __decorate([
-    ta_json_1.JsonProperty("content_is_copied"),
+    (0, ta_json_1.JsonProperty)("content_is_copied"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "contentIsCopied", void 0);
 __decorate([
-    ta_json_1.JsonProperty("completion_is_copied"),
+    (0, ta_json_1.JsonProperty)("completion_is_copied"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "completionIsCopied", void 0);
 __decorate([
-    ta_json_1.JsonProperty("is_path_relation"),
+    (0, ta_json_1.JsonProperty)("is_path_relation"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "isPathRelation", void 0);
 __decorate([
-    ta_json_1.JsonProperty("is_path_hierarchy_relation"),
+    (0, ta_json_1.JsonProperty)("is_path_hierarchy_relation"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "isPathHierarchyRelation", void 0);
 __decorate([
-    ta_json_1.JsonProperty("path_hierarchy_score"),
+    (0, ta_json_1.JsonProperty)("path_hierarchy_score"),
     __metadata("design:type", String)
 ], RelationDefinition.prototype, "pathHierarchyScore", void 0);
 __decorate([
-    ta_json_1.JsonProperty("is_rendition_relation"),
+    (0, ta_json_1.JsonProperty)("is_rendition_relation"),
     __metadata("design:type", Boolean)
 ], RelationDefinition.prototype, "isRenditionRelation", void 0);
 __decorate([
-    ta_json_1.JsonProperty("associated_labels"),
+    (0, ta_json_1.JsonProperty)("associated_labels"),
     __metadata("design:type", Object)
 ], RelationDefinition.prototype, "associatedLabels", void 0);
 RelationDefinition = __decorate([
-    ta_json_1.JsonObject(),
-    ta_json_1.JsonDiscriminatorValue(data_type_1.default.Relation),
+    (0, ta_json_1.JsonObject)(),
+    (0, ta_json_1.JsonDiscriminatorValue)(data_type_1.default.Relation),
     __metadata("design:paramtypes", [String, Object])
 ], RelationDefinition);
 exports.RelationDefinition = RelationDefinition;
+//# sourceMappingURL=relation-definition.js.map

package/dist/contracts/base/relation-manager.d.ts

@@ -63,7 +63,7 @@ export declare class RelationManager {
      */
     private fetchRelationAsync;
     /**
-     * Adds the relation to the loaded relations and updates the count.
+     * Adds the relation to the loaded relations and updates the count (when the relation doesn't exist yet).
      * @param relation - Relation to add
      */
     private addRelation;

package/dist/contracts/base/relation-manager.js

@@ -13,15 +13,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RelationManager = void 0;
-const string_format_1 = __importDefault(require("string-format"));
 const base_types_1 = require("../../base-types");
-const error_messages_1 = __importDefault(require("../../error-messages"));
 const guard_1 = __importDefault(require("../../guard"));
 const culture_load_option_1 = require("../querying/culture-load-option");
 const entity_load_configuration_1 = require("../querying/entity-load-configuration");
 const load_options_1 = require("../querying/load-options");
 const property_load_option_1 = require("../querying/property-load-option");
 const relation_load_option_1 = require("../querying/relation-load-option");
+const relation_specification_1 = require("../querying/relation-specification");
 const lazy_loading_manager_1 = require("./lazy-loading-manager");
 const relation_container_1 = require("./relation-container");
 class RelationManager {
@@ -167,8 +166,8 @@ class RelationManager {
      */
     fetchRelationAsync(relationName, role) {
         return __awaiter(this, void 0, void 0, function* () {
-            const relationLoadOption = new relation_load_option_1.RelationLoadOption([relationName]);
-            const loadConfig = new entity_load_configuration_1.EntityLoadConfiguration(culture_load_option_1.CultureLoadOption.None, property_load_option_1.PropertyLoadOption.None, relationLoadOption);
+            const relationLoadOption = new relation_load_option_1.RelationLoadOption([new relation_specification_1.RelationSpecification(relationName, role)]);
+            const loadConfig = new entity_load_configuration_1.EntityLoadConfiguration(new culture_load_option_1.CultureLoadOption([...this._entity.cultures]), property_load_option_1.PropertyLoadOption.None, relationLoadOption);
             const tempEntity = yield this._client.entities.getAsync(this._entity.id, loadConfig);
             if (tempEntity == null) {
                 return null;
@@ -178,7 +177,7 @@ class RelationManager {
         });
     }
     /**
-     * Adds the relation to the loaded relations and updates the count.
+     * Adds the relation to the loaded relations and updates the count (when the relation doesn't exist yet).
      * @param relation - Relation to add
      */
     addRelation(relation) {
@@ -188,10 +187,11 @@ class RelationManager {
             this._relations[relation.name] = container;
         }
         if (container.relationExists(relation.role)) {
-            throw new Error(string_format_1.default(error_messages_1.default.RelationManager.RelationWasAlreadyAdded, relation.name, relation.role));
+            return;
         }
         container.setRelation(relation);
         this._count++;
     }
 }
 exports.RelationManager = RelationManager;
+//# sourceMappingURL=relation-manager.js.map

package/dist/contracts/base/relation-role.js

@@ -15,3 +15,4 @@ var RelationRole;
      */
     RelationRole[RelationRole["Child"] = 1] = "Child";
 })(RelationRole = exports.RelationRole || (exports.RelationRole = {}));
+//# sourceMappingURL=relation-role.js.map

package/dist/contracts/base/relation.d.ts

@@ -1,4 +1,5 @@
-import { MapNumberTo, MapStringTo, Nullable, Object_Unknown } from "../..";
+import { MapNumberTo, MapStringTo, Nullable, Object_Unknown, Optional } from "../..";
+import { IContentHubClient } from "../../clients/content-hub-client";
 import DirtyValueCalculator from "../../dirty-value-calculator";
 import { IMember, MemberBase } from "./member";
 import { RelationRole } from "./relation-role";
@@ -41,6 +42,16 @@ export interface IRelation extends IMember {
      * @param ids - The ids of the entities to link
      */
     setIds(ids: Array<number>): void;
+    /**
+     * Sets the related entities.
+     *
+     * In case of an {@link IToManyRelation}, the list of ids will be set on the relation.
+     * In case of an {@link IToOneRelation}, ids can have at most one value.
+     *
+     * If the list is empty then the value will be set to null.
+     * @param identifiers - The identifiers of the entities to link
+     */
+    setIdentifiersAsync(identifiers: Array<string>): Promise<void>;
     /**
      * Clears the value(s) of the relation.
      */
@@ -51,9 +62,11 @@ export declare abstract class RelationBase extends MemberBase implements IRelati
     abstract readonly isMultiValue: boolean;
     readonly properties: MapNumberTo<MapStringTo<Object_Unknown>>;
     protected _dirtyValueCalculator: DirtyValueCalculator;
-    protected constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>);
+    protected client: Optional<IContentHubClient>;
+    protected constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>, client?: IContentHubClient);
     abstract getIds(): Array<number>;
     abstract setIds(ids: Array<number>): void;
+    setIdentifiersAsync(identifiers: Array<string>): Promise<void>;
     abstract clear(): void;
     protected getTypeName(): string;
     static isChildRelation(r: IRelation): r is IChildRelation;
@@ -72,7 +85,7 @@ export interface IChildRelation extends IRelation {
 }
 export declare abstract class ChildRelationBase extends RelationBase implements IChildRelation {
     inheritsSecurity: boolean;
-    constructor(name: string, properties: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>);
+    constructor(name: string, properties: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>, client?: IContentHubClient);
 }
 /** Base interface for all parent relations. */
 export interface IParentRelation extends IRelation {

package/dist/contracts/base/relation.js

@@ -1,14 +1,38 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChildRelationBase = exports.RelationBase = void 0;
+const guard_1 = __importDefault(require("../../guard"));
+const entity_load_configuration_1 = require("../querying/entity-load-configuration");
 const member_1 = require("./member");
 const member_definition_type_1 = require("./member-definition-type");
 const relation_role_1 = require("./relation-role");
 class RelationBase extends member_1.MemberBase {
-    constructor(name, properties = null) {
+    constructor(name, properties = null, client) {
         super(name, member_definition_type_1.MemberDefinitionType.Relation);
+        this.client = client;
         this.properties = properties == null ? {} : properties;
     }
+    setIdentifiersAsync(identifiers) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            guard_1.default.arrayNoneNullOrEmptyString(identifiers);
+            guard_1.default.notNullOrUndefined(this.client);
+            const entities = yield this.client.entities.getManyAsync(identifiers, entity_load_configuration_1.EntityLoadConfiguration.Minimal);
+            this.setIds((_a = entities === null || entities === void 0 ? void 0 : entities.filter(x => x.id !== null).map(x => x.id)) !== null && _a !== void 0 ? _a : []);
+        });
+    }
     getTypeName() {
         return relation_role_1.RelationRole[this.role];
     }
@@ -33,9 +57,10 @@ class RelationBase extends member_1.MemberBase {
 }
 exports.RelationBase = RelationBase;
 class ChildRelationBase extends RelationBase {
-    constructor(name, properties) {
-        super(name, properties);
+    constructor(name, properties, client) {
+        super(name, properties, client);
         this.inheritsSecurity = true;
     }
 }
 exports.ChildRelationBase = ChildRelationBase;
+//# sourceMappingURL=relation.js.map

package/dist/contracts/base/relations/child-to-many-parents-relation.d.ts

@@ -1,4 +1,5 @@
 import { MapNumberTo, MapStringTo, Nullable, Object_Unknown } from "../../..";
+import { IContentHubClient } from "../../../clients/content-hub-client";
 import { ChildRelationBase, IChildRelation } from "../relation";
 import { RelationRole } from "../relation-role";
 import { IToManyRelation } from "./to-many-relation";
@@ -24,12 +25,14 @@ export declare class ChildToManyParentsRelation extends ChildRelationBase implem
     readonly isMultiValue: boolean;
     get isDirty(): boolean;
     get parents(): Array<number>;
-    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>);
+    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>, client?: IContentHubClient);
     getIds(): Array<number>;
     setIds(ids: Array<number>): void;
     clear(): void;
     add(id: number): void;
     addRange(ids: Array<number>): void;
+    addAsync(identifier: string): Promise<void>;
+    addRangeAsync(identifiers: Array<string>): Promise<void>;
     startTracking(): void;
     markClean(): void;
     getParentProperties(id: number): MapStringTo<Object_Unknown>;

package/dist/contracts/base/relations/child-to-many-parents-relation.js

@@ -1,4 +1,13 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,11 +15,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChildToManyParentsRelation = void 0;
 const dirty_value_calculator_1 = __importDefault(require("../../../dirty-value-calculator"));
 const guard_1 = __importDefault(require("../../../guard"));
+const entity_load_configuration_1 = require("../../querying/entity-load-configuration");
 const relation_1 = require("../relation");
 const relation_role_1 = require("../relation-role");
 class ChildToManyParentsRelation extends relation_1.ChildRelationBase {
-    constructor(name, properties = null) {
-        super(name, properties);
+    constructor(name, properties = null, client) {
+        super(name, properties, client);
         this._parents = [];
         this.role = relation_role_1.RelationRole.Child;
         this.isMultiValue = true;
@@ -51,6 +61,26 @@ class ChildToManyParentsRelation extends relation_1.ChildRelationBase {
             }
         });
     }
+    addAsync(identifier) {
+        return __awaiter(this, void 0, void 0, function* () {
+            guard_1.default.notNullOrUndefined(this.client);
+            guard_1.default.stringNotNullOrEmpty(identifier);
+            const entity = yield this.client.entities.getAsync(identifier, entity_load_configuration_1.EntityLoadConfiguration.Minimal);
+            if (entity && entity.id) {
+                this.add(entity.id);
+            }
+        });
+    }
+    addRangeAsync(identifiers) {
+        return __awaiter(this, void 0, void 0, function* () {
+            guard_1.default.notNullOrUndefined(this.client);
+            guard_1.default.arrayNoneNullOrEmptyString(identifiers);
+            const entities = yield this.client.entities.getManyAsync(identifiers, entity_load_configuration_1.EntityLoadConfiguration.Minimal);
+            if (entities) {
+                this.addRange(entities.filter(x => x.id !== null).map(x => x.id));
+            }
+        });
+    }
     startTracking() {
         if (this.isTracking)
             return;
@@ -68,3 +98,4 @@ class ChildToManyParentsRelation extends relation_1.ChildRelationBase {
     }
 }
 exports.ChildToManyParentsRelation = ChildToManyParentsRelation;
+//# sourceMappingURL=child-to-many-parents-relation.js.map

package/dist/contracts/base/relations/child-to-one-parent-relation.d.ts

@@ -1,4 +1,5 @@
 import { MapNumberTo, MapStringTo, Nullable, Object_Unknown } from "../../../base-types";
+import { IContentHubClient } from "../../../clients/content-hub-client";
 import { ChildRelationBase, IChildRelation } from "../relation";
 import { RelationRole } from "../relation-role";
 import { IToOneRelation } from "./to-one-relation";
@@ -21,12 +22,13 @@ export declare class ChildToOneParentRelation extends ChildRelationBase implemen
     get isDirty(): boolean;
     get parent(): Nullable<number>;
     set parent(id: Nullable<number>);
-    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>);
+    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>, client?: IContentHubClient);
     getIds(): Array<number>;
     setIds(ids: Array<number>): void;
     clear(): void;
     getId(): Nullable<number>;
     setId(id: Nullable<number>): void;
+    setIdentifierAsync(identifier: Nullable<string>): Promise<void>;
     startTracking(): void;
     markClean(): void;
     getParentProperties(): MapStringTo<Object_Unknown>;

package/dist/contracts/base/relations/child-to-one-parent-relation.js

@@ -1,4 +1,13 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,11 +15,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChildToOneParentRelation = void 0;
 const dirty_value_calculator_1 = __importDefault(require("../../../dirty-value-calculator"));
 const guard_1 = __importDefault(require("../../../guard"));
+const entity_load_configuration_1 = require("../../querying/entity-load-configuration");
 const relation_1 = require("../relation");
 const relation_role_1 = require("../relation-role");
 class ChildToOneParentRelation extends relation_1.ChildRelationBase {
-    constructor(name, properties = null) {
-        super(name, properties);
+    constructor(name, properties = null, client) {
+        super(name, properties, client);
         this._parent = null;
         this.role = relation_role_1.RelationRole.Child;
         this.isMultiValue = false;
@@ -58,6 +68,20 @@ class ChildToOneParentRelation extends relation_1.ChildRelationBase {
         guard_1.default.validIdOrNull(id);
         this._parent = id;
     }
+    setIdentifierAsync(identifier) {
+        return __awaiter(this, void 0, void 0, function* () {
+            guard_1.default.notNullOrUndefined(this.client);
+            guard_1.default.stringNotNullOrEmpty(identifier);
+            if (identifier) {
+                const entity = yield this.client.entities.getAsync(identifier, entity_load_configuration_1.EntityLoadConfiguration.Minimal);
+                if (entity && entity.id) {
+                    this.setId(entity.id);
+                    return;
+                }
+            }
+            this.setId(null);
+        });
+    }
     startTracking() {
         if (this.isTracking)
             return;
@@ -78,3 +102,4 @@ class ChildToOneParentRelation extends relation_1.ChildRelationBase {
     }
 }
 exports.ChildToOneParentRelation = ChildToOneParentRelation;
+//# sourceMappingURL=child-to-one-parent-relation.js.map

package/dist/contracts/base/relations/parent-to-many-children-relation.d.ts

@@ -1,4 +1,5 @@
 import { MapNumberTo, MapStringTo, Nullable, Object_Unknown } from "../../..";
+import { IContentHubClient } from "../../../clients/content-hub-client";
 import { IParentRelation, RelationBase } from "../relation";
 import { RelationRole } from "../relation-role";
 import { IToManyRelation } from "./to-many-relation";
@@ -24,12 +25,14 @@ export declare class ParentToManyChildrenRelation extends RelationBase implement
     readonly isMultiValue: boolean;
     get isDirty(): boolean;
     get children(): Array<number>;
-    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>);
+    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>, client?: IContentHubClient);
     getIds(): Array<number>;
     setIds(ids: Array<number>): void;
     clear(): void;
     add(id: number): void;
     addRange(ids: Array<number>): void;
+    addAsync(identifier: string): Promise<void>;
+    addRangeAsync(identifiers: Array<string>): Promise<void>;
     startTracking(): void;
     markClean(): void;
     getChildProperties(id: number): MapStringTo<Object_Unknown>;

package/dist/contracts/base/relations/parent-to-many-children-relation.js

@@ -1,4 +1,13 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,11 +15,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParentToManyChildrenRelation = void 0;
 const dirty_value_calculator_1 = __importDefault(require("../../../dirty-value-calculator"));
 const guard_1 = __importDefault(require("../../../guard"));
+const entity_load_configuration_1 = require("../../querying/entity-load-configuration");
 const relation_1 = require("../relation");
 const relation_role_1 = require("../relation-role");
 class ParentToManyChildrenRelation extends relation_1.RelationBase {
-    constructor(name, properties = null) {
-        super(name, properties);
+    constructor(name, properties = null, client) {
+        super(name, properties, client);
         this._children = [];
         this.role = relation_role_1.RelationRole.Parent;
         this.isMultiValue = true;
@@ -51,6 +61,26 @@ class ParentToManyChildrenRelation extends relation_1.RelationBase {
             }
         });
     }
+    addAsync(identifier) {
+        return __awaiter(this, void 0, void 0, function* () {
+            guard_1.default.notNullOrUndefined(this.client);
+            guard_1.default.stringNotNullOrEmpty(identifier);
+            const entity = yield this.client.entities.getAsync(identifier, entity_load_configuration_1.EntityLoadConfiguration.Minimal);
+            if (entity && entity.id) {
+                this.add(entity.id);
+            }
+        });
+    }
+    addRangeAsync(identifiers) {
+        return __awaiter(this, void 0, void 0, function* () {
+            guard_1.default.notNullOrUndefined(this.client);
+            guard_1.default.arrayNoneNullOrEmptyString(identifiers);
+            const entities = yield this.client.entities.getManyAsync(identifiers, entity_load_configuration_1.EntityLoadConfiguration.Minimal);
+            if (entities) {
+                this.addRange(entities.filter(x => x.id !== null).map(x => x.id));
+            }
+        });
+    }
     startTracking() {
         if (this.isTracking)
             return;
@@ -68,3 +98,4 @@ class ParentToManyChildrenRelation extends relation_1.RelationBase {
     }
 }
 exports.ParentToManyChildrenRelation = ParentToManyChildrenRelation;
+//# sourceMappingURL=parent-to-many-children-relation.js.map

package/dist/contracts/base/relations/parent-to-one-child-relation.d.ts

@@ -1,4 +1,5 @@
 import { MapNumberTo, MapStringTo, Nullable, Object_Unknown } from "../../../base-types";
+import { IContentHubClient } from "../../../clients/content-hub-client";
 import { IParentRelation, RelationBase } from "../relation";
 import { RelationRole } from "../relation-role";
 import { IToOneRelation } from "./to-one-relation";
@@ -24,9 +25,10 @@ export declare class ParentToOneChildRelation extends RelationBase implements IP
     get child(): Nullable<number>;
     set child(id: Nullable<number>);
     get isDirty(): boolean;
-    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>);
+    constructor(name: string, properties?: Nullable<MapNumberTo<MapStringTo<Object_Unknown>>>, client?: IContentHubClient);
     getIds(): Array<number>;
     setIds(ids: Array<number>): void;
+    setIdentifierAsync(identifier: Nullable<string>): Promise<void>;
     clear(): void;
     getId(): Nullable<number>;
     setId(id: Nullable<number>): void;