@loopback/repository 4.0.0-alpha.8 → 4.1.0

package/dist/relations/has-many/has-many.repository.d.ts

@@ -0,0 +1,54 @@
+import { Getter } from '@loopback/core';
+import { Filter, Where } from '@loopback/filter';
+import { Count, DataObject, Options } from '../../common-types';
+import { Entity } from '../../model';
+import { EntityCrudRepository } from '../../repositories';
+/**
+ * CRUD operations for a target repository of a HasMany relation
+ */
+export interface HasManyRepository<Target extends Entity> {
+    /**
+     * Create a target model instance
+     * @param targetModelData - The target model data
+     * @param options - Options for the operation
+     * @returns A promise which resolves to the newly created target model instance
+     */
+    create(targetModelData: DataObject<Target>, options?: Options): Promise<Target>;
+    /**
+     * Find target model instance(s)
+     * @param filter - A filter object for where, order, limit, etc.
+     * @param options - Options for the operation
+     * @returns A promise which resolves with the found target instance(s)
+     */
+    find(filter?: Filter<Target>, options?: Options): Promise<Target[]>;
+    /**
+     * Delete multiple target model instances
+     * @param where - Instances within the where scope are deleted
+     * @param options
+     * @returns A promise which resolves the deleted target model instances
+     */
+    delete(where?: Where<Target>, options?: Options): Promise<Count>;
+    /**
+     * Patch multiple target model instances
+     * @param dataObject - The fields and their new values to patch
+     * @param where - Instances within the where scope are patched
+     * @param options
+     * @returns A promise which resolves the patched target model instances
+     */
+    patch(dataObject: DataObject<Target>, where?: Where<Target>, options?: Options): Promise<Count>;
+}
+export declare class DefaultHasManyRepository<TargetEntity extends Entity, TargetID, TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>> implements HasManyRepository<TargetEntity> {
+    getTargetRepository: Getter<TargetRepository>;
+    constraint: DataObject<TargetEntity>;
+    /**
+     * Constructor of DefaultHasManyEntityCrudRepository
+     * @param getTargetRepository - the getter of the related target model repository instance
+     * @param constraint - the key value pair representing foreign key name to constrain
+     * the target repository instance
+     */
+    constructor(getTargetRepository: Getter<TargetRepository>, constraint: DataObject<TargetEntity>);
+    create(targetModelData: DataObject<TargetEntity>, options?: Options): Promise<TargetEntity>;
+    find(filter?: Filter<TargetEntity>, options?: Options): Promise<TargetEntity[]>;
+    delete(where?: Where<TargetEntity>, options?: Options): Promise<Count>;
+    patch(dataObject: DataObject<TargetEntity>, where?: Where<TargetEntity>, options?: Options): Promise<Count>;
+}

package/dist/relations/has-many/has-many.repository.js

@@ -0,0 +1,38 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultHasManyRepository = void 0;
+const repositories_1 = require("../../repositories");
+class DefaultHasManyRepository {
+    /**
+     * Constructor of DefaultHasManyEntityCrudRepository
+     * @param getTargetRepository - the getter of the related target model repository instance
+     * @param constraint - the key value pair representing foreign key name to constrain
+     * the target repository instance
+     */
+    constructor(getTargetRepository, constraint) {
+        this.getTargetRepository = getTargetRepository;
+        this.constraint = constraint;
+    }
+    async create(targetModelData, options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.create((0, repositories_1.constrainDataObject)(targetModelData, this.constraint), options);
+    }
+    async find(filter, options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.find((0, repositories_1.constrainFilter)(filter, this.constraint), options);
+    }
+    async delete(where, options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.deleteAll((0, repositories_1.constrainWhere)(where, this.constraint), options);
+    }
+    async patch(dataObject, where, options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.updateAll((0, repositories_1.constrainDataObject)(dataObject, this.constraint), (0, repositories_1.constrainWhere)(where, this.constraint), options);
+    }
+}
+exports.DefaultHasManyRepository = DefaultHasManyRepository;
+//# sourceMappingURL=has-many.repository.js.map

package/dist/relations/has-many/has-many.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-many.repository.js","sourceRoot":"","sources":["../../../src/relations/has-many/has-many.repository.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAMhE,qDAK4B;AA4C5B,MAAa,wBAAwB;IAMnC;;;;;OAKG;IACH,YACS,mBAA6C,EAC7C,UAAoC;QADpC,wBAAmB,GAAnB,mBAAmB,CAA0B;QAC7C,eAAU,GAAV,UAAU,CAA0B;IAC1C,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,eAAyC,EACzC,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,MAAM,CAC5B,IAAA,kCAAmB,EAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,EACrD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAA6B,EAC7B,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,IAAI,CAC1B,IAAA,8BAAe,EAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,EACxC,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA2B,EAAE,OAAiB;QACzD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,SAAS,CAC/B,IAAA,6BAAc,EAAC,KAAK,EAAE,IAAI,CAAC,UAAiC,CAAC,EAC7D,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,UAAoC,EACpC,KAA2B,EAC3B,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,SAAS,CAC/B,IAAA,kCAAmB,EAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,EAChD,IAAA,6BAAc,EAAC,KAAK,EAAE,IAAI,CAAC,UAAiC,CAAC,EAC7D,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AA3DD,4DA2DC"}

package/dist/relations/has-many/index.d.ts

@@ -0,0 +1,6 @@
+export * from './has-many.repository-factory';
+export * from './has-many-through.repository-factory';
+export * from './has-many-through.repository';
+export * from './has-many.decorator';
+export * from './has-many.inclusion-resolver';
+export * from './has-many.repository';

package/dist/relations/has-many/index.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./has-many.repository-factory"), exports);
+(0, tslib_1.__exportStar)(require("./has-many-through.repository-factory"), exports);
+(0, tslib_1.__exportStar)(require("./has-many-through.repository"), exports);
+(0, tslib_1.__exportStar)(require("./has-many.decorator"), exports);
+(0, tslib_1.__exportStar)(require("./has-many.inclusion-resolver"), exports);
+(0, tslib_1.__exportStar)(require("./has-many.repository"), exports);
+//# sourceMappingURL=index.js.map

package/dist/relations/has-many/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/relations/has-many/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,6EAA8C;AAC9C,qFAAsD;AACtD,6EAA8C;AAC9C,oEAAqC;AACrC,6EAA8C;AAC9C,qEAAsC"}

package/dist/relations/has-one/has-one.decorator.d.ts

@@ -0,0 +1,3 @@
+import { Entity, EntityResolver } from '../../model';
+import { HasOneDefinition } from '../relation.types';
+export declare function hasOne<T extends Entity>(targetResolver: EntityResolver<T>, definition?: Partial<HasOneDefinition>): (decoratedTarget: object, key: string) => void;

package/dist/relations/has-one/has-one.decorator.js

@@ -0,0 +1,37 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasOne = void 0;
+const relation_decorator_1 = require("../relation.decorator");
+const relation_types_1 = require("../relation.types");
+/*
+ * Decorator for hasOne
+ * infers foreign key name from target model name unless explicitly specified
+ * @param targetResolver - Target model for hasOne relation
+ * @param definition - Optional metadata for setting up hasOne relation
+ * @returns A property decorator
+ */
+function hasOne(targetResolver, definition) {
+    return function (decoratedTarget, key) {
+        // property.array(targetResolver)(decoratedTarget, key);
+        const meta = Object.assign(
+        // default values, can be customized by the caller
+        {}, 
+        // properties provided by the caller
+        definition, 
+        // properties enforced by the decorator
+        {
+            type: relation_types_1.RelationType.hasOne,
+            targetsMany: false,
+            name: key,
+            source: decoratedTarget.constructor,
+            target: targetResolver,
+        });
+        (0, relation_decorator_1.relation)(meta)(decoratedTarget, key);
+    };
+}
+exports.hasOne = hasOne;
+//# sourceMappingURL=has-one.decorator.js.map

package/dist/relations/has-one/has-one.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-one.decorator.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.decorator.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAGhE,8DAA+C;AAC/C,sDAAiE;AAEjE;;;;;;GAMG;AACH,SAAgB,MAAM,CACpB,cAAiC,EACjC,UAAsC;IAEtC,OAAO,UAAU,eAAuB,EAAE,GAAW;QACnD,wDAAwD;QAExD,MAAM,IAAI,GAAqB,MAAM,CAAC,MAAM;QAC1C,kDAAkD;QAClD,EAAE;QACF,oCAAoC;QACpC,UAAU;QACV,uCAAuC;QACvC;YACE,IAAI,EAAE,6BAAY,CAAC,MAAM;YACzB,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,eAAe,CAAC,WAAW;YACnC,MAAM,EAAE,cAAc;SACvB,CACF,CAAC;QACF,IAAA,6BAAQ,EAAC,IAAI,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC;AAvBD,wBAuBC"}

package/dist/relations/has-one/has-one.helpers.d.ts

@@ -0,0 +1,17 @@
+import { HasOneDefinition } from '../relation.types';
+/**
+ * Relation definition with optional metadata (e.g. `keyTo`) filled in.
+ * @internal
+ */
+export declare type HasOneResolvedDefinition = HasOneDefinition & {
+    keyFrom: string;
+    keyTo: string;
+};
+/**
+ * Resolves given hasOne metadata if target is specified to be a resolver.
+ * Mainly used to infer what the `keyTo` property should be from the target's
+ * hasOne metadata
+ * @param relationMeta - hasOne metadata to resolve
+ * @internal
+ */
+export declare function resolveHasOneMetadata(relationMeta: HasOneDefinition): HasOneResolvedDefinition;

package/dist/relations/has-one/has-one.helpers.js

@@ -0,0 +1,64 @@
+"use strict";
+// Copyright IBM Corp. 2019,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveHasOneMetadata = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = (0, tslib_1.__importDefault)(require("debug"));
+const lodash_1 = require("lodash");
+const errors_1 = require("../../errors");
+const type_resolver_1 = require("../../type-resolver");
+const relation_types_1 = require("../relation.types");
+const debug = (0, debug_1.default)('loopback:repository:relations:has-one:helpers');
+/**
+ * Resolves given hasOne metadata if target is specified to be a resolver.
+ * Mainly used to infer what the `keyTo` property should be from the target's
+ * hasOne metadata
+ * @param relationMeta - hasOne metadata to resolve
+ * @internal
+ */
+function resolveHasOneMetadata(relationMeta) {
+    var _a;
+    if (relationMeta.type !== relation_types_1.RelationType.hasOne) {
+        const reason = 'relation type must be HasOne';
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    if (!(0, type_resolver_1.isTypeResolver)(relationMeta.target)) {
+        const reason = 'target must be a type resolver';
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    const targetModel = relationMeta.target();
+    const targetModelProperties = (_a = targetModel.definition) === null || _a === void 0 ? void 0 : _a.properties;
+    const sourceModel = relationMeta.source;
+    if (!sourceModel || !sourceModel.modelName) {
+        const reason = 'source model must be defined';
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    // keyFrom defaults to id property
+    let keyFrom;
+    if (relationMeta.keyFrom &&
+        relationMeta.source.definition.properties[relationMeta.keyFrom]) {
+        keyFrom = relationMeta.keyFrom;
+    }
+    else {
+        keyFrom = sourceModel.getIdProperties()[0];
+    }
+    // Make sure that if it already keys to the foreign key property,
+    // the key exists in the target model
+    if (relationMeta.keyTo && targetModelProperties[relationMeta.keyTo]) {
+        // The explicit cast is needed because of a limitation of type inference
+        return Object.assign(relationMeta, { keyFrom });
+    }
+    debug('Resolved model %s from given metadata: %o', targetModel.modelName, targetModel);
+    const defaultFkName = (0, lodash_1.camelCase)(sourceModel.modelName + '_id');
+    const hasDefaultFkProperty = targetModelProperties[defaultFkName];
+    if (!hasDefaultFkProperty) {
+        const reason = `target model ${targetModel.name} is missing definition of foreign key ${defaultFkName}`;
+        throw new errors_1.InvalidRelationError(reason, relationMeta);
+    }
+    return Object.assign(relationMeta, { keyFrom, keyTo: defaultFkName });
+}
+exports.resolveHasOneMetadata = resolveHasOneMetadata;
+//# sourceMappingURL=has-one.helpers.js.map

package/dist/relations/has-one/has-one.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-one.helpers.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.helpers.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+DAAiC;AACjC,mCAAiC;AACjC,yCAAkD;AAClD,uDAAmD;AACnD,sDAAiE;AAEjE,MAAM,KAAK,GAAG,IAAA,eAAY,EAAC,+CAA+C,CAAC,CAAC;AAW5E;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,YAA8B;;IAE9B,IAAK,YAAY,CAAC,IAAqB,KAAK,6BAAY,CAAC,MAAM,EAAE;QAC/D,MAAM,MAAM,GAAG,8BAA8B,CAAC;QAC9C,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,IAAI,CAAC,IAAA,8BAAc,EAAC,YAAY,CAAC,MAAM,CAAC,EAAE;QACxC,MAAM,MAAM,GAAG,gCAAgC,CAAC;QAChD,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAC1C,MAAM,qBAAqB,GAAG,MAAA,WAAW,CAAC,UAAU,0CAAE,UAAU,CAAC;IAEjE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC;IACxC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;QAC1C,MAAM,MAAM,GAAG,8BAA8B,CAAC;QAC9C,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,kCAAkC;IAClC,IAAI,OAAO,CAAC;IACZ,IACE,YAAY,CAAC,OAAO;QACpB,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAC/D;QACA,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;KAChC;SAAM;QACL,OAAO,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;KAC5C;IAED,iEAAiE;IACjE,qCAAqC;IACrC,IAAI,YAAY,CAAC,KAAK,IAAI,qBAAqB,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;QACnE,wEAAwE;QACxE,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAC,OAAO,EAAC,CAA6B,CAAC;KAC3E;IAED,KAAK,CACH,2CAA2C,EAC3C,WAAW,CAAC,SAAS,EACrB,WAAW,CACZ,CAAC;IACF,MAAM,aAAa,GAAG,IAAA,kBAAS,EAAC,WAAW,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;IAC/D,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAElE,IAAI,CAAC,oBAAoB,EAAE;QACzB,MAAM,MAAM,GAAG,gBAAgB,WAAW,CAAC,IAAI,yCAAyC,aAAa,EAAE,CAAC;QACxG,MAAM,IAAI,6BAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;KACtD;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAC,CAAC,CAAC;AACtE,CAAC;AAtDD,sDAsDC"}

package/dist/relations/has-one/has-one.inclusion-resolver.d.ts

@@ -0,0 +1,14 @@
+import { Entity } from '../../model';
+import { EntityCrudRepository } from '../../repositories';
+import { Getter, HasOneDefinition, InclusionResolver } from '../relation.types';
+/**
+ * Creates InclusionResolver for HasOne relation.
+ * Notice that this function only generates the inclusionResolver.
+ * It doesn't register it for the source repository.
+ *
+ * Notice: scope field for inclusion is not supported yet.
+ *
+ * @param meta
+ * @param getTargetRepo
+ */
+export declare function createHasOneInclusionResolver<Target extends Entity, TargetID, TargetRelations extends object>(meta: HasOneDefinition, getTargetRepo: Getter<EntityCrudRepository<Target, TargetID, TargetRelations>>): InclusionResolver<Entity, Target>;

package/dist/relations/has-one/has-one.inclusion-resolver.js

@@ -0,0 +1,35 @@
+"use strict";
+// Copyright IBM Corp. 2019,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHasOneInclusionResolver = void 0;
+const relation_helpers_1 = require("../relation.helpers");
+const has_one_helpers_1 = require("./has-one.helpers");
+/**
+ * Creates InclusionResolver for HasOne relation.
+ * Notice that this function only generates the inclusionResolver.
+ * It doesn't register it for the source repository.
+ *
+ * Notice: scope field for inclusion is not supported yet.
+ *
+ * @param meta
+ * @param getTargetRepo
+ */
+function createHasOneInclusionResolver(meta, getTargetRepo) {
+    const relationMeta = (0, has_one_helpers_1.resolveHasOneMetadata)(meta);
+    return async function fetchHasOneModel(entities, inclusion, options) {
+        if (!entities.length)
+            return [];
+        const sourceKey = relationMeta.keyFrom;
+        const sourceIds = entities.map(e => e[sourceKey]);
+        const targetKey = relationMeta.keyTo;
+        const scope = typeof inclusion === 'string' ? {} : inclusion.scope;
+        const targetRepo = await getTargetRepo();
+        const targetsFound = await (0, relation_helpers_1.findByForeignKeys)(targetRepo, targetKey, sourceIds, scope, options);
+        return (0, relation_helpers_1.flattenTargetsOfOneToOneRelation)(sourceIds, targetsFound, targetKey);
+    };
+}
+exports.createHasOneInclusionResolver = createHasOneInclusionResolver;
+//# sourceMappingURL=has-one.inclusion-resolver.js.map

package/dist/relations/has-one/has-one.inclusion-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-one.inclusion-resolver.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.inclusion-resolver.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAMhE,0DAI6B;AAE7B,uDAAwD;AAExD;;;;;;;;;GASG;AACH,SAAgB,6BAA6B,CAK3C,IAAsB,EACtB,aAEC;IAED,MAAM,YAAY,GAAG,IAAA,uCAAqB,EAAC,IAAI,CAAC,CAAC;IAEjD,OAAO,KAAK,UAAU,gBAAgB,CACpC,QAAkB,EAClB,SAA0B,EAC1B,OAAiB;QAEjB,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEhC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,YAAY,CAAC,KAA4B,CAAC;QAE5D,MAAM,KAAK,GACT,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,SAAS,CAAC,KAAwB,CAAC;QAE3E,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,MAAM,IAAA,oCAAiB,EAC1C,UAAU,EACV,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;QAEF,OAAO,IAAA,mDAAgC,EAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IAC9E,CAAC,CAAC;AACJ,CAAC;AArCD,sEAqCC"}

package/dist/relations/has-one/has-one.repository-factory.d.ts

@@ -0,0 +1,28 @@
+import { Entity } from '../../model';
+import { EntityCrudRepository } from '../../repositories';
+import { Getter, HasOneDefinition, InclusionResolver } from '../relation.types';
+import { HasOneRepository } from './has-one.repository';
+export interface HasOneRepositoryFactory<Target extends Entity, ForeignKeyType> {
+    /**
+     * Invoke the function to obtain HasOneRepository.
+     */
+    (fkValue: ForeignKeyType): HasOneRepository<Target>;
+    /**
+     * Use `resolver` property to obtain an InclusionResolver for this relation.
+     */
+    inclusionResolver: InclusionResolver<Entity, Target>;
+}
+/**
+ * Enforces a constraint on a repository based on a relationship contract
+ * between models. For example, if a Customer model is related to an Address model
+ * via a HasOne relation, then, the relational repository returned by the
+ * factory function would be constrained by a Customer model instance's id(s).
+ *
+ * @param relationMetadata - The relation metadata used to describe the
+ * relationship and determine how to apply the constraint.
+ * @param targetRepositoryGetter - The repository which represents the target model of a
+ * relation attached to a datasource.
+ * @returns The factory function which accepts a foreign key value to constrain
+ * the given target repository
+ */
+export declare function createHasOneRepositoryFactory<Target extends Entity, TargetID, ForeignKeyType>(relationMetadata: HasOneDefinition, targetRepositoryGetter: Getter<EntityCrudRepository<Target, TargetID>>): HasOneRepositoryFactory<Target, ForeignKeyType>;

package/dist/relations/has-one/has-one.repository-factory.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHasOneRepositoryFactory = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = (0, tslib_1.__importDefault)(require("debug"));
+const has_one_helpers_1 = require("./has-one.helpers");
+const has_one_inclusion_resolver_1 = require("./has-one.inclusion-resolver");
+const has_one_repository_1 = require("./has-one.repository");
+const debug = (0, debug_1.default)('loopback:repository:relations:has-one:repository-factory');
+/**
+ * Enforces a constraint on a repository based on a relationship contract
+ * between models. For example, if a Customer model is related to an Address model
+ * via a HasOne relation, then, the relational repository returned by the
+ * factory function would be constrained by a Customer model instance's id(s).
+ *
+ * @param relationMetadata - The relation metadata used to describe the
+ * relationship and determine how to apply the constraint.
+ * @param targetRepositoryGetter - The repository which represents the target model of a
+ * relation attached to a datasource.
+ * @returns The factory function which accepts a foreign key value to constrain
+ * the given target repository
+ */
+function createHasOneRepositoryFactory(relationMetadata, targetRepositoryGetter) {
+    const meta = (0, has_one_helpers_1.resolveHasOneMetadata)(relationMetadata);
+    debug('Resolved HasOne relation metadata: %o', meta);
+    const result = function (fkValue) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const constraint = { [meta.keyTo]: fkValue };
+        return new has_one_repository_1.DefaultHasOneRepository(targetRepositoryGetter, constraint);
+    };
+    result.inclusionResolver = (0, has_one_inclusion_resolver_1.createHasOneInclusionResolver)(meta, targetRepositoryGetter);
+    return result;
+}
+exports.createHasOneRepositoryFactory = createHasOneRepositoryFactory;
+//# sourceMappingURL=has-one.repository-factory.js.map

package/dist/relations/has-one/has-one.repository-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-one.repository-factory.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.repository-factory.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;;AAEhE,+DAAiC;AAKjC,uDAAwD;AACxD,6EAA2E;AAC3E,6DAA+E;AAE/E,MAAM,KAAK,GAAG,IAAA,eAAY,EACxB,0DAA0D,CAC3D,CAAC;AAgBF;;;;;;;;;;;;GAYG;AACH,SAAgB,6BAA6B,CAK3C,gBAAkC,EAClC,sBAAsE;IAEtE,MAAM,IAAI,GAAG,IAAA,uCAAqB,EAAC,gBAAgB,CAAC,CAAC;IACrD,KAAK,CAAC,uCAAuC,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,MAAM,GAAoD,UAC9D,OAAuB;QAEvB,8DAA8D;QAC9D,MAAM,UAAU,GAAQ,EAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAC,CAAC;QAChD,OAAO,IAAI,4CAAuB,CAIhC,sBAAsB,EAAE,UAAgC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,MAAM,CAAC,iBAAiB,GAAG,IAAA,0DAA6B,EACtD,IAAI,EACJ,sBAAsB,CACvB,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AA1BD,sEA0BC"}

package/dist/relations/has-one/has-one.repository.d.ts

@@ -0,0 +1,53 @@
+import { Getter } from '@loopback/core';
+import { Filter } from '@loopback/filter';
+import { Count, DataObject, Options } from '../../common-types';
+import { Entity } from '../../model';
+import { EntityCrudRepository } from '../../repositories';
+/**
+ * CRUD operations for a target repository of a HasMany relation
+ */
+export interface HasOneRepository<Target extends Entity> {
+    /**
+     * Create a target model instance
+     * @param targetModelData - The target model data
+     * @param options - Options for the operation
+     * @returns A promise which resolves to the newly created target model instance
+     */
+    create(targetModelData: DataObject<Target>, options?: Options): Promise<Target>;
+    /**
+     * Find the only target model instance that belongs to the declaring model.
+     * @param filter - Query filter without a Where condition
+     * @param options - Options for the operations
+     * @returns A promise resolved with the target object or rejected
+     * with an EntityNotFoundError when target model instance was not found.
+     */
+    get(filter?: Pick<Filter<Target>, Exclude<keyof Filter<Target>, 'where'>>, options?: Options): Promise<Target>;
+    /**
+     * Delete the related target model instance
+     * @param options
+     * @returns A promise which resolves the deleted target model instances
+     */
+    delete(options?: Options): Promise<Count>;
+    /**
+     * Patch the  related target model instance
+     * @param dataObject - The target model fields and their new values to patch
+     * @param options
+     * @returns A promise which resolves the patched target model instances
+     */
+    patch(dataObject: DataObject<Target>, options?: Options): Promise<Count>;
+}
+export declare class DefaultHasOneRepository<TargetEntity extends Entity, TargetID, TargetRepository extends EntityCrudRepository<TargetEntity, TargetID>> implements HasOneRepository<TargetEntity> {
+    getTargetRepository: Getter<TargetRepository>;
+    constraint: DataObject<TargetEntity>;
+    /**
+     * Constructor of DefaultHasOneEntityCrudRepository
+     * @param getTargetRepository - the getter of the related target model repository instance
+     * @param constraint - the key value pair representing foreign key name to constrain
+     * the target repository instance
+     */
+    constructor(getTargetRepository: Getter<TargetRepository>, constraint: DataObject<TargetEntity>);
+    create(targetModelData: DataObject<TargetEntity>, options?: Options): Promise<TargetEntity>;
+    get(filter?: Pick<Filter<TargetEntity>, Exclude<keyof Filter<TargetEntity>, 'where'>>, options?: Options): Promise<TargetEntity>;
+    delete(options?: Options): Promise<Count>;
+    patch(dataObject: DataObject<TargetEntity>, options?: Options): Promise<Count>;
+}

package/dist/relations/has-one/has-one.repository.js

@@ -0,0 +1,45 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultHasOneRepository = void 0;
+const errors_1 = require("../../errors");
+const repositories_1 = require("../../repositories");
+class DefaultHasOneRepository {
+    /**
+     * Constructor of DefaultHasOneEntityCrudRepository
+     * @param getTargetRepository - the getter of the related target model repository instance
+     * @param constraint - the key value pair representing foreign key name to constrain
+     * the target repository instance
+     */
+    constructor(getTargetRepository, constraint) {
+        this.getTargetRepository = getTargetRepository;
+        this.constraint = constraint;
+    }
+    async create(targetModelData, options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.create((0, repositories_1.constrainDataObject)(targetModelData, this.constraint), options);
+    }
+    async get(filter, options) {
+        const targetRepository = await this.getTargetRepository();
+        const found = await targetRepository.find(Object.assign({ limit: 1 }, (0, repositories_1.constrainFilter)(filter, this.constraint)), options);
+        if (found.length < 1) {
+            // We don't have a direct access to the foreign key value here :(
+            const id = 'constraint ' + JSON.stringify(this.constraint);
+            throw new errors_1.EntityNotFoundError(targetRepository.entityClass, id);
+        }
+        return found[0];
+    }
+    async delete(options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.deleteAll((0, repositories_1.constrainWhere)({}, this.constraint), options);
+    }
+    async patch(dataObject, options) {
+        const targetRepository = await this.getTargetRepository();
+        return targetRepository.updateAll((0, repositories_1.constrainDataObject)(dataObject, this.constraint), (0, repositories_1.constrainWhere)({}, this.constraint), options);
+    }
+}
+exports.DefaultHasOneRepository = DefaultHasOneRepository;
+//# sourceMappingURL=has-one.repository.js.map

package/dist/relations/has-one/has-one.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-one.repository.js","sourceRoot":"","sources":["../../../src/relations/has-one/has-one.repository.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAKhE,yCAAiD;AAEjD,qDAK4B;AA6C5B,MAAa,uBAAuB;IAMlC;;;;;OAKG;IACH,YACS,mBAA6C,EAC7C,UAAoC;QADpC,wBAAmB,GAAnB,mBAAmB,CAA0B;QAC7C,eAAU,GAAV,UAAU,CAA0B;IAC1C,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,eAAyC,EACzC,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,MAAM,CAC5B,IAAA,kCAAmB,EAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,EACrD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,MAGC,EACD,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,CACvC,MAAM,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,CAAC,EAAC,EAAE,IAAA,8BAAe,EAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EACnE,OAAO,CACR,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;YACpB,iEAAiE;YACjE,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,MAAM,IAAI,4BAAmB,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;SACjE;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,OAAiB;QAC5B,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,SAAS,CAC/B,IAAA,6BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EACnC,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,UAAoC,EACpC,OAAiB;QAEjB,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,SAAS,CAC/B,IAAA,kCAAmB,EAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,EAChD,IAAA,6BAAc,EAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EACnC,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAlED,0DAkEC"}

package/dist/relations/has-one/index.d.ts

@@ -0,0 +1,3 @@
+export * from './has-one.decorator';
+export * from './has-one.repository';
+export * from './has-one.repository-factory';

package/dist/relations/has-one/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./has-one.decorator"), exports);
+(0, tslib_1.__exportStar)(require("./has-one.repository"), exports);
+(0, tslib_1.__exportStar)(require("./has-one.repository-factory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/relations/has-one/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/relations/has-one/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,mEAAoC;AACpC,oEAAqC;AACrC,4EAA6C"}

package/dist/relations/index.d.ts

@@ -0,0 +1,6 @@
+export * from './belongs-to';
+export * from './has-many';
+export * from './has-one';
+export * from './relation.decorator';
+export * from './relation.helpers';
+export * from './relation.types';

package/dist/relations/index.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
+// Node module: @loopback/repository
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./belongs-to"), exports);
+(0, tslib_1.__exportStar)(require("./has-many"), exports);
+(0, tslib_1.__exportStar)(require("./has-one"), exports);
+(0, tslib_1.__exportStar)(require("./relation.decorator"), exports);
+(0, tslib_1.__exportStar)(require("./relation.helpers"), exports);
+(0, tslib_1.__exportStar)(require("./relation.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/relations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/relations/index.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,oCAAoC;AACpC,+CAA+C;AAC/C,gEAAgE;;;AAEhE,4DAA6B;AAC7B,0DAA2B;AAC3B,yDAA0B;AAC1B,oEAAqC;AACrC,kEAAmC;AACnC,gEAAiC"}

package/dist/relations/relation.decorator.d.ts

@@ -0,0 +1,39 @@
+import { Model, RelationDefinitionMap } from '../model';
+export declare const RELATIONS_KEY = "loopback:relations";
+/**
+ * Decorator for relations
+ * @param definition
+ * @returns A property decorator
+ */
+export declare function relation(definition?: Object): PropertyDecorator;
+/**
+ * Get metadata of all relations defined on a given model class.
+ *
+ * @param modelCtor - The model class (the constructor function).
+ * @returns A map of relation definitions
+ */
+export declare function getModelRelations(modelCtor: typeof Model): RelationDefinitionMap;
+/**
+ * Decorator for embedsOne
+ * @param definition
+ * @returns A property decorator
+ */
+export declare function embedsOne(definition?: Object): PropertyDecorator;
+/**
+ * Decorator for embedsMany
+ * @param definition
+ * @returns A property decorator
+ */
+export declare function embedsMany(definition?: Object): PropertyDecorator;
+/**
+ * Decorator for referencesOne
+ * @param definition
+ * @returns A property decorator
+ */
+export declare function referencesOne(definition?: Object): PropertyDecorator;
+/**
+ * Decorator for referencesMany
+ * @param definition
+ * @returns A property decorator
+ */
+export declare function referencesMany(definition?: Object): PropertyDecorator;