joist-orm 0.1.536 → 1.0.0

package/build/{collections → src/relations}/CustomReference.js

@@ -1,8 +1,11 @@
 "use strict";
+var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CustomReference = void 0;
 const index_1 = require("../index");
 const AbstractRelationImpl_1 = require("./AbstractRelationImpl");
+const Reference_1 = require("./Reference");
+const Relation_1 = require("./Relation");
 /**
  * Allows user-defined references that will work in `populate` / preload hints.
  *
@@ -20,6 +23,9 @@ class CustomReference extends AbstractRelationImpl_1.AbstractRelationImpl {
         this.entity = entity;
         this.opts = opts;
         this._isLoaded = false;
+        this[_a] = null;
+        this[_b] = null;
+        this[_c] = null;
     }
     get get() {
         return this.doGet({ withDeleted: false });
@@ -31,7 +37,7 @@ class CustomReference extends AbstractRelationImpl_1.AbstractRelationImpl {
         return this._isLoaded;
     }
     async load(opts) {
-        index_1.ensureNotDeleted(this.entity, { ignore: "pending" });
+        (0, index_1.ensureNotDeleted)(this.entity, { ignore: "pending" });
         if (!this.isLoaded) {
             if (this.loadPromise === undefined) {
                 this.loadPromise = this.opts.load(this.entity);
@@ -53,17 +59,17 @@ class CustomReference extends AbstractRelationImpl_1.AbstractRelationImpl {
         // this._isLoaded = true;
     }
     get id() {
-        return index_1.fail(`CustomReference cannot resolve 'id'`);
+        return (0, index_1.fail)(`CustomReference cannot resolve 'id'`);
     }
     get idOrFail() {
-        return index_1.fail(`CustomReference cannot resolve 'idOrFail'`);
+        return (0, index_1.fail)(`CustomReference cannot resolve 'idOrFail'`);
     }
     get idUntagged() {
         // We don't know the meta here but that is probably a feature in case this is polymorphic
-        return this.id && index_1.unsafeDeTagIds([this.id])[0];
+        return this.id && (0, index_1.unsafeDeTagIds)([this.id])[0];
     }
     get idUntaggedOrFail() {
-        return this.idUntagged || index_1.fail("Reference is unset or assigned to a new entity");
+        return this.idUntagged || (0, index_1.fail)("Reference is unset or assigned to a new entity");
     }
     get isSet() {
         ensureNewOrLoaded(this);
@@ -82,8 +88,8 @@ class CustomReference extends AbstractRelationImpl_1.AbstractRelationImpl {
         this.set(value);
     }
     // these callbacks should be no-ops as they ought to be handled by the underlying relations
-    async onEntityDeletedAndFlushing() { }
-    onEntityDelete() { }
+    async cleanupOnEntityDeleted() { }
+    maybeCascadeDelete() { }
     async refreshIfLoaded() { }
     /** Finds this CustomReferences field name by looking in the entity for the key that we're assigned to. */
     get fieldName() {
@@ -93,15 +99,16 @@ class CustomReference extends AbstractRelationImpl_1.AbstractRelationImpl {
         return `CustomReference(entity: ${this.entity}, fieldName: ${this.fieldName})`;
     }
     doGet(opts) {
-        index_1.ensureNotDeleted(this.entity, { ignore: "pending" });
+        (0, index_1.ensureNotDeleted)(this.entity, { ignore: "pending" });
         ensureNewOrLoaded(this);
         return this.filterDeleted(this.opts.get(this.entity), opts);
     }
     filterDeleted(entity, opts) {
-        return (opts === null || opts === void 0 ? void 0 : opts.withDeleted) === true || entity === undefined || !entity.isDeletedEntity ? entity : undefined;
+        return opts?.withDeleted === true || entity === undefined || !entity.isDeletedEntity ? entity : undefined;
     }
 }
 exports.CustomReference = CustomReference;
+_a = Relation_1.RelationT, _b = Relation_1.RelationU, _c = Reference_1.ReferenceN;
 function ensureNewOrLoaded(reference) {
     if (!(reference.isLoaded || reference.entity.isNewEntity)) {
         // This should only be callable in the type system if we've already resolved this to an instance

package/build/src/relations/CustomReference.js.map

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

package/build/src/relations/LargeCollection.d.ts

@@ -0,0 +1,17 @@
+import { Entity, IdOf } from "../EntityManager";
+import { Relation } from "./Relation";
+/**
+ * A large collection of `U` within `T`, where the parent has so many children
+ * that we cannot load them all at a single time.
+ *
+ * We consider this a `Relation`, but not a true `Collection` b/c it cannot be
+ * loaded.
+ */
+export interface LargeCollection<T extends Entity, U extends Entity> extends Relation<T, U> {
+    /** Looks up the specific `id` without fully loading the collection. */
+    find(id: IdOf<U>): Promise<U | undefined>;
+    /** Looks up the specific `other` without fully loading the collection. */
+    includes(other: U): Promise<boolean>;
+    add(other: U): void;
+    remove(other: U): void;
+}

package/build/src/relations/LargeCollection.js

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

package/build/src/relations/LargeCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LargeCollection.js","sourceRoot":"","sources":["../../../src/relations/LargeCollection.ts"],"names":[],"mappings":""}

package/build/{collections → src/relations}/ManyToManyCollection.d.ts

@@ -1,5 +1,8 @@
 import { Collection, Entity, EntityMetadata, IdOf } from "../";
 import { AbstractRelationImpl } from "./AbstractRelationImpl";
+import { RelationT, RelationU } from "./Relation";
+/** An alias for creating `ManyToManyCollections`s. */
+export declare function hasManyToMany<T extends Entity, U extends Entity>(joinTableName: string, fieldName: keyof T, columnName: string, otherMeta: EntityMetadata<U>, otherFieldName: keyof U, otherColumnName: string): Collection<T, U>;
 export declare class ManyToManyCollection<T extends Entity, U extends Entity> extends AbstractRelationImpl<U[]> implements Collection<T, U> {
     joinTableName: string;
     entity: T;
@@ -18,8 +21,10 @@ export declare class ManyToManyCollection<T extends Entity, U extends Entity> ex
         withDeleted?: boolean;
     }): Promise<ReadonlyArray<U>>;
     find(id: IdOf<U>): Promise<U | undefined>;
+    includes(other: U): Promise<boolean>;
     add(other: U, percolated?: boolean): void;
     remove(other: U, percolated?: boolean): void;
+    get isLoaded(): boolean;
     private doGet;
     get getWithDeleted(): U[];
     get get(): U[];
@@ -28,14 +33,16 @@ export declare class ManyToManyCollection<T extends Entity, U extends Entity> ex
     setFromOpts(others: U[]): void;
     initializeForNewEntity(): void;
     refreshIfLoaded(): Promise<void>;
-    onEntityDelete(): void;
-    onEntityDeletedAndFlushing(): Promise<void>;
+    maybeCascadeDelete(): void;
+    cleanupOnEntityDeleted(): Promise<void>;
     private maybeApplyAddedAndRemovedBeforeLoaded;
     current(opts?: {
         withDeleted?: boolean;
     }): U[];
     get meta(): EntityMetadata<T>;
     toString(): string;
+    [RelationT]: T;
+    [RelationU]: U;
 }
 export declare type JoinRow = {
     id: number | undefined;

package/build/src/relations/ManyToManyCollection.js

@@ -0,0 +1,249 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManyToManyCollection = exports.hasManyToMany = void 0;
+const __1 = require("../");
+const manyToManyDataLoader_1 = require("../dataloaders/manyToManyDataLoader");
+const manyToManyFindDataLoader_1 = require("../dataloaders/manyToManyFindDataLoader");
+const utils_1 = require("../utils");
+const AbstractRelationImpl_1 = require("./AbstractRelationImpl");
+const Relation_1 = require("./Relation");
+/** An alias for creating `ManyToManyCollections`s. */
+function hasManyToMany(joinTableName, fieldName, columnName, otherMeta, otherFieldName, otherColumnName) {
+    const entity = __1.currentlyInstantiatingEntity;
+    return new ManyToManyCollection(joinTableName, entity, fieldName, columnName, otherMeta, otherFieldName, otherColumnName);
+}
+exports.hasManyToMany = hasManyToMany;
+class ManyToManyCollection extends AbstractRelationImpl_1.AbstractRelationImpl {
+    constructor(joinTableName, 
+    // I.e. when entity = Book:
+    // fieldName == tags, because it's our collection to tags
+    // columnName = book_id, what we use as the `where book_id = us` to find our join table rows
+    // otherFieldName = books, how tags points to us
+    // otherColumnName = tag_id, how the other side finds its join table rows
+    entity, fieldName, columnName, otherMeta, otherFieldName, otherColumnName) {
+        super();
+        this.joinTableName = joinTableName;
+        this.entity = entity;
+        this.fieldName = fieldName;
+        this.columnName = columnName;
+        this.otherMeta = otherMeta;
+        this.otherFieldName = otherFieldName;
+        this.otherColumnName = otherColumnName;
+        this.addedBeforeLoaded = [];
+        this.removedBeforeLoaded = [];
+        this[_a] = null;
+        this[_b] = null;
+        this.isCascadeDelete = otherMeta.config.__data.cascadeDeleteFields.includes(fieldName);
+    }
+    filterDeleted(entities, opts) {
+        return opts?.withDeleted === true ? [...entities] : entities.filter((e) => !e.isDeletedEntity);
+    }
+    async load(opts) {
+        (0, __1.ensureNotDeleted)(this.entity, { ignore: "pending" });
+        if (this.loaded === undefined) {
+            const key = `${this.columnName}=${this.entity.id}`;
+            this.loaded = await (0, manyToManyDataLoader_1.manyToManyDataLoader)(this.entity.em, this).load(key);
+            this.maybeApplyAddedAndRemovedBeforeLoaded();
+        }
+        return this.filterDeleted(this.loaded, opts);
+    }
+    async find(id) {
+        (0, __1.ensureNotDeleted)(this.entity, { ignore: "pending" });
+        if (this.loaded !== undefined) {
+            return this.loaded.find((u) => u.id === id);
+        }
+        else {
+            const added = this.addedBeforeLoaded.find((u) => u.id === id);
+            if (added) {
+                return added;
+            }
+            // Make a cacheable tuple to look up this specific m2m row
+            const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${id}`;
+            const includes = await (0, manyToManyFindDataLoader_1.manyToManyFindDataLoader)(this.entity.em, this).load(key);
+            return includes ? this.entity.em.load(id) : undefined;
+        }
+    }
+    async includes(other) {
+        (0, __1.ensureNotDeleted)(this.entity, { ignore: "pending" });
+        if (this.loaded !== undefined) {
+            return this.loaded.includes(other);
+        }
+        else {
+            if (this.addedBeforeLoaded.includes(other)) {
+                return true;
+            }
+            else if (other.isNewEntity) {
+                return false;
+            }
+            // Make a cacheable tuple to look up this specific m2m row
+            const key = `${this.columnName}=${this.entity.idOrFail},${this.otherColumnName}=${other.idOrFail}`;
+            return (0, manyToManyFindDataLoader_1.manyToManyFindDataLoader)(this.entity.em, this).load(key);
+        }
+    }
+    add(other, percolated = false) {
+        (0, __1.ensureNotDeleted)(this.entity);
+        if (this.loaded !== undefined) {
+            if (this.loaded.includes(other)) {
+                return;
+            }
+            this.loaded.push(other);
+        }
+        else {
+            (0, utils_1.remove)(this.removedBeforeLoaded, other);
+            if (!this.addedBeforeLoaded.includes(other)) {
+                this.addedBeforeLoaded.push(other);
+            }
+        }
+        if (!percolated) {
+            const joinRow = {
+                id: undefined,
+                m2m: this,
+                [this.columnName]: this.entity,
+                [this.otherColumnName]: other,
+            };
+            (0, utils_1.getOrSet)(this.entity.em.__data.joinRows, this.joinTableName, []).push(joinRow);
+            other[this.otherFieldName].add(this.entity, true);
+        }
+    }
+    remove(other, percolated = false) {
+        (0, __1.ensureNotDeleted)(this.entity, { ignore: "pending" });
+        if (!percolated) {
+            const joinRows = (0, utils_1.getOrSet)(this.entity.em.__data.joinRows, this.joinTableName, []);
+            const row = joinRows.find((r) => r[this.columnName] === this.entity && r[this.otherColumnName] === other);
+            if (row) {
+                row.deleted = true;
+            }
+            else {
+                const joinRow = {
+                    // Use -1 to force the sortJoinRows to notice us as dirty ("delete: true but id is set")
+                    id: -1,
+                    m2m: this,
+                    [this.columnName]: this.entity,
+                    [this.otherColumnName]: other,
+                    deleted: true,
+                };
+                (0, utils_1.getOrSet)(this.entity.em.__data.joinRows, this.joinTableName, []).push(joinRow);
+            }
+            other[this.otherFieldName].remove(this.entity, true);
+        }
+        if (this.loaded !== undefined) {
+            (0, utils_1.remove)(this.loaded, other);
+        }
+        else {
+            (0, utils_1.remove)(this.addedBeforeLoaded, other);
+            if (!this.removedBeforeLoaded.includes(other)) {
+                this.removedBeforeLoaded.push(other);
+            }
+        }
+    }
+    get isLoaded() {
+        return this.loaded !== undefined;
+    }
+    doGet() {
+        (0, __1.ensureNotDeleted)(this.entity);
+        if (this.loaded === undefined) {
+            if (this.entity.id === undefined) {
+                return this.addedBeforeLoaded;
+            }
+            else {
+                // This should only be callable in the type system if we've already resolved this to an instance
+                throw new Error("get was called when not loaded");
+            }
+        }
+        return this.loaded;
+    }
+    get getWithDeleted() {
+        return this.filterDeleted(this.doGet(), { withDeleted: true });
+    }
+    get get() {
+        return this.filterDeleted(this.doGet(), { withDeleted: false });
+    }
+    set(values) {
+        (0, __1.ensureNotDeleted)(this.entity);
+        if (this.loaded === undefined) {
+            throw new Error("set was called when not loaded");
+        }
+        // Make a copy for safe iteration
+        const loaded = [...this.loaded];
+        // Remove old values
+        for (const other of loaded) {
+            if (!values.includes(other)) {
+                this.remove(other);
+            }
+        }
+        for (const other of values) {
+            if (!loaded.includes(other)) {
+                this.add(other);
+            }
+        }
+    }
+    removeAll() {
+        (0, __1.ensureNotDeleted)(this.entity);
+        if (this.loaded === undefined) {
+            throw new Error("removeAll was called when not loaded");
+        }
+        for (const other of [...this.loaded]) {
+            this.remove(other);
+        }
+    }
+    // impl details
+    setFromOpts(others) {
+        this.loaded = [];
+        others.forEach((o) => this.add(o));
+    }
+    initializeForNewEntity() {
+        // Don't overwrite any opts values
+        if (this.loaded === undefined) {
+            this.loaded = [];
+        }
+    }
+    async refreshIfLoaded() {
+        (0, __1.ensureNotDeleted)(this.entity);
+        // TODO We should remember what load hints have been applied to this collection and re-apply them.
+        if (this.loaded !== undefined && this.entity.id !== undefined) {
+            const key = `${this.columnName}=${this.entity.id}`;
+            this.loaded = await (0, manyToManyDataLoader_1.manyToManyDataLoader)(this.entity.em, this).load(key);
+        }
+    }
+    maybeCascadeDelete() {
+        if (this.isCascadeDelete) {
+            this.current({ withDeleted: true }).forEach((e) => this.entity.em.delete(e));
+        }
+    }
+    async cleanupOnEntityDeleted() {
+        const entities = await this.load({ withDeleted: true });
+        entities.forEach((other) => {
+            const m2m = other[this.otherFieldName];
+            m2m.remove(this.entity);
+        });
+        this.loaded = [];
+    }
+    maybeApplyAddedAndRemovedBeforeLoaded() {
+        if (this.loaded) {
+            // this.loaded.unshift(...this.addedBeforeLoaded);
+            // this.addedBeforeLoaded = [];
+            this.removedBeforeLoaded.forEach((e) => {
+                (0, utils_1.remove)(this.loaded, e);
+                const { em } = this.entity;
+                const row = em.__data.joinRows[this.joinTableName].find((r) => r[this.columnName] === this.entity && r[this.otherColumnName] === e);
+                if (row) {
+                    row.deleted = true;
+                }
+            });
+            this.removedBeforeLoaded = [];
+        }
+    }
+    current(opts) {
+        return this.filterDeleted(this.loaded || this.addedBeforeLoaded, opts);
+    }
+    get meta() {
+        return (0, __1.getMetadata)(this.entity);
+    }
+    toString() {
+        return `OneToManyCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;
+    }
+}
+exports.ManyToManyCollection = ManyToManyCollection;
+_a = Relation_1.RelationT, _b = Relation_1.RelationU;
+//# sourceMappingURL=ManyToManyCollection.js.map

package/build/src/relations/ManyToManyCollection.js.map

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

package/build/src/relations/ManyToManyLargeCollection.d.ts

@@ -0,0 +1,25 @@
+import { Entity, EntityMetadata, IdOf } from "../EntityManager";
+import { LargeCollection } from "./LargeCollection";
+import { RelationT, RelationU } from "./Relation";
+/** An alias for creating `ManyToManyLargeCollection`s. */
+export declare function hasLargeManyToMany<T extends Entity, U extends Entity>(joinTableName: string, fieldName: keyof T, columnName: string, otherMeta: EntityMetadata<U>, otherFieldName: keyof U, otherColumnName: string): LargeCollection<T, U>;
+export declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> implements LargeCollection<T, U> {
+    joinTableName: string;
+    entity: T;
+    fieldName: keyof T;
+    columnName: string;
+    otherMeta: EntityMetadata<U>;
+    otherFieldName: keyof U;
+    otherColumnName: string;
+    private locallyAdded;
+    private locallyRemoved;
+    constructor(joinTableName: string, entity: T, fieldName: keyof T, columnName: string, otherMeta: EntityMetadata<U>, otherFieldName: keyof U, otherColumnName: string);
+    find(id: IdOf<U>): Promise<U | undefined>;
+    includes(other: U): Promise<boolean>;
+    add(other: U): void;
+    remove(other: U): void;
+    get meta(): EntityMetadata<T>;
+    toString(): string;
+    [RelationT]: T;
+    [RelationU]: U;
+}

package/build/src/relations/ManyToManyLargeCollection.js

@@ -0,0 +1,97 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManyToManyLargeCollection = exports.hasLargeManyToMany = void 0;
+const manyToManyFindDataLoader_1 = require("../dataloaders/manyToManyFindDataLoader");
+const EntityManager_1 = require("../EntityManager");
+const index_1 = require("../index");
+const utils_1 = require("../utils");
+const Relation_1 = require("./Relation");
+/** An alias for creating `ManyToManyLargeCollection`s. */
+function hasLargeManyToMany(joinTableName, fieldName, columnName, otherMeta, otherFieldName, otherColumnName) {
+    const entity = EntityManager_1.currentlyInstantiatingEntity;
+    return new ManyToManyLargeCollection(joinTableName, entity, fieldName, columnName, otherMeta, otherFieldName, otherColumnName);
+}
+exports.hasLargeManyToMany = hasLargeManyToMany;
+class ManyToManyLargeCollection {
+    constructor(joinTableName, 
+    // I.e. when entity = Book:
+    // fieldName == tags, because it's our collection to tags
+    // columnName = book_id, what we use as the `where book_id = us` to find our join table rows
+    // otherFieldName = books, how tags points to us
+    // otherColumnName = tag_id, how the other side finds its join table rows
+    entity, fieldName, columnName, otherMeta, otherFieldName, otherColumnName) {
+        this.joinTableName = joinTableName;
+        this.entity = entity;
+        this.fieldName = fieldName;
+        this.columnName = columnName;
+        this.otherMeta = otherMeta;
+        this.otherFieldName = otherFieldName;
+        this.otherColumnName = otherColumnName;
+        // Even though a large collection can never be loaded, we do track local
+        // mutations so that `find` can be accurate.
+        this.locallyAdded = [];
+        this.locallyRemoved = [];
+        this[_a] = null;
+        this[_b] = null;
+    }
+    async find(id) {
+        (0, index_1.ensureNotDeleted)(this.entity, { ignore: "pending" });
+        // locallyAdded is never authorative b/c we never become fully loaded (unlike OneToManyCollection),
+        // so we can probe our local collection, but if we don't find anything, we still have to query
+        const localAdd = this.locallyAdded.find((u) => u.id === id);
+        if (localAdd) {
+            return localAdd;
+        }
+        const localRemove = this.locallyRemoved.find((u) => u.id === id);
+        if (localRemove) {
+            return undefined;
+        }
+        if (this.entity.isNewEntity) {
+            return undefined;
+        }
+        // Make a cacheable tuple to look up this specific m2m row
+        const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${id}`;
+        const includes = await (0, manyToManyFindDataLoader_1.manyToManyFindDataLoader)(this.entity.em, this).load(key);
+        return includes ? this.entity.em.load(id) : undefined;
+    }
+    async includes(other) {
+        const localAdd = this.locallyAdded.includes(other);
+        if (localAdd) {
+            return true;
+        }
+        const localRemove = this.locallyRemoved.includes(other);
+        if (localRemove) {
+            return false;
+        }
+        if (this.entity.isNewEntity || other.isNewEntity) {
+            return false;
+        }
+        // Make a cacheable tuple to look up this specific m2m row
+        const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${other.id}`;
+        return (0, manyToManyFindDataLoader_1.manyToManyFindDataLoader)(this.entity.em, this).load(key);
+    }
+    add(other) {
+        (0, utils_1.remove)(this.locallyRemoved, other);
+        if (!this.locallyAdded.includes(other)) {
+            this.locallyAdded.push(other);
+        }
+        other[this.otherFieldName].add(this.entity, true);
+    }
+    remove(other) {
+        (0, utils_1.remove)(this.locallyAdded, other);
+        if (!this.locallyRemoved.includes(other)) {
+            this.locallyRemoved.push(other);
+        }
+        other[this.otherFieldName].remove(this.entity, true);
+    }
+    get meta() {
+        return (0, index_1.getMetadata)(this.entity);
+    }
+    toString() {
+        return `ManyToManyLargeCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;
+    }
+}
+exports.ManyToManyLargeCollection = ManyToManyLargeCollection;
+_a = Relation_1.RelationT, _b = Relation_1.RelationU;
+//# sourceMappingURL=ManyToManyLargeCollection.js.map

package/build/src/relations/ManyToManyLargeCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManyToManyLargeCollection.js","sourceRoot":"","sources":["../../../src/relations/ManyToManyLargeCollection.ts"],"names":[],"mappings":";;;;AAAA,sFAAmF;AACnF,oDAA8F;AAC9F,oCAA+E;AAC/E,oCAAkC;AAElC,yCAAkD;AAElD,0DAA0D;AAC1D,SAAgB,kBAAkB,CAChC,aAAqB,EACrB,SAAkB,EAClB,UAAkB,EAClB,SAA4B,EAC5B,cAAuB,EACvB,eAAuB;IAEvB,MAAM,MAAM,GAAG,4CAAiC,CAAC;IACjD,OAAO,IAAI,yBAAyB,CAClC,aAAa,EACb,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EACd,eAAe,CAChB,CAAC;AACJ,CAAC;AAlBD,gDAkBC;AAED,MAAa,yBAAyB;IAMpC,YACS,aAAqB;IAC5B,2BAA2B;IAC3B,yDAAyD;IACzD,4FAA4F;IAC5F,gDAAgD;IAChD,yEAAyE;IAClE,MAAS,EACT,SAAkB,EAClB,UAAkB,EAClB,SAA4B,EAC5B,cAAuB,EACvB,eAAuB;QAXvB,kBAAa,GAAb,aAAa,CAAQ;QAMrB,WAAM,GAAN,MAAM,CAAG;QACT,cAAS,GAAT,SAAS,CAAS;QAClB,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAmB;QAC5B,mBAAc,GAAd,cAAc,CAAS;QACvB,oBAAe,GAAf,eAAe,CAAQ;QAjBhC,wEAAwE;QACxE,4CAA4C;QACpC,iBAAY,GAAQ,EAAE,CAAC;QACvB,mBAAc,GAAQ,EAAE,CAAC;QAsFjC,QAAW,GAAM,IAAK,CAAC;QACvB,QAAW,GAAM,IAAK,CAAC;IAxEpB,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,EAAW;QACpB,IAAA,wBAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAErD,mGAAmG;QACnG,8FAA8F;QAC9F,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE;YACZ,OAAO,QAAQ,CAAC;SACjB;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,IAAI,WAAW,EAAE;YACf,OAAO,SAAS,CAAC;SAClB;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YAC3B,OAAO,SAAS,CAAC;SAClB;QAED,0DAA0D;QAC1D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QACjF,MAAM,QAAQ,GAAG,MAAM,IAAA,mDAAwB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChF,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAQ;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE;YACZ,OAAO,IAAI,CAAC;SACb;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,WAAW,EAAE;YACf,OAAO,KAAK,CAAC;SACd;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,EAAE;YAChD,OAAO,KAAK,CAAC;SACd;QAED,0DAA0D;QAC1D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QACvF,OAAO,IAAA,mDAAwB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,GAAG,CAAC,KAAQ;QACV,IAAA,cAAM,EAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAC/B;QACA,KAAK,CAAC,IAAI,CAAC,cAAc,CAAuC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,CAAC,KAAQ;QACb,IAAA,cAAM,EAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YACxC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACjC;QACA,KAAK,CAAC,IAAI,CAAC,cAAc,CAAuC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9F,CAAC;IAED,IAAW,IAAI;QACb,OAAO,IAAA,mBAAW,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAEM,QAAQ;QACb,OAAO,qCAAqC,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,SAAS,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,qBAAqB,IAAI,CAAC,cAAc,GAAG,CAAC;IACtK,CAAC;CAIF;AA5FD,8DA4FC;KAFE,oBAAS,OACT,oBAAS"}

package/build/src/relations/ManyToOneReference.d.ts

@@ -0,0 +1,77 @@
+import { Entity, EntityMetadata, IdOf } from "../EntityManager";
+import { Reference } from "../index";
+import { AbstractRelationImpl } from "./AbstractRelationImpl";
+import { ReferenceN } from "./Reference";
+import { RelationT, RelationU } from "./Relation";
+/** An alias for creating `ManyToOneReference`s. */
+export declare function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(otherMeta: EntityMetadata<U>, fieldName: keyof T, otherFieldName: keyof U): ManyToOneReference<T, U, N>;
+/** Type guard utility for determining if an entity field is a ManyToOneReference. */
+export declare function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any>;
+export interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<T, U, N> {
+    /** Returns the id of the current assigned entity (or `undefined` if its new and has no id yet), or `undefined` if this column is nullable and currently unset. */
+    id: IdOf<U> | undefined;
+    /** Returns the id of the current assigned entity or a runtime error if it's either 1) unset or 2) set to a new entity that doesn't have an `id` yet. */
+    idOrFail: IdOf<U>;
+    idUntagged: string | undefined;
+    idUntaggedOrFail: string;
+    /** Returns `true` if this relation is currently set (i.e. regardless of whether it's loaded, or if it is set but the assigned entity doesn't have an id saved. */
+    readonly isSet: boolean;
+}
+/**
+ * Manages a foreign key from one entity to another, i.e. `Book.author --> Author`.
+ *
+ * We keep the current `author` / `author_id` value in the `__orm.data` hash, where the
+ * current value could be either the (string) author id from the database, or an entity
+ * `Author` that the user has set.
+ *
+ * Note that if our `images.author_id` column is unique, this `ManyToOneReference` will essentially
+ * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the "many"
+ * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.
+ */
+export declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<U> implements ManyToOneReference<T, U, N> {
+    private entity;
+    otherMeta: EntityMetadata<U>;
+    private fieldName;
+    otherFieldName: keyof U;
+    private loaded;
+    private _isLoaded;
+    private readonly isCascadeDelete;
+    constructor(entity: T, otherMeta: EntityMetadata<U>, fieldName: keyof T, otherFieldName: keyof U);
+    load(opts?: {
+        withDeleted?: boolean;
+    }): Promise<U | N>;
+    set(other: U | N): void;
+    get isSet(): boolean;
+    get isLoaded(): boolean;
+    private doGet;
+    get getWithDeleted(): U | N;
+    get get(): U | N;
+    get id(): IdOf<U> | N;
+    set id(id: IdOf<U> | N);
+    get idOrFail(): IdOf<U>;
+    get idUntagged(): string | undefined;
+    get idUntaggedOrFail(): string;
+    setFromOpts(other: U): void;
+    initializeForNewEntity(): void;
+    refreshIfLoaded(): Promise<void>;
+    maybeCascadeDelete(): void;
+    cleanupOnEntityDeleted(): Promise<void>;
+    setImpl(other: U | N): void;
+    maybeRemove(other: U | undefined): void;
+    maybeAdd(other: U | undefined): void;
+    current(opts?: {
+        withDeleted?: boolean;
+    }): U | string | N;
+    toString(): string;
+    private filterDeleted;
+    /** Returns the other relation that points back at us, i.e. we're `book.author_id` and this is `Author.books`. */
+    private getOtherRelation;
+    /**
+     * Looks for an entity in `EntityManager`, b/c we may have it in memory even if
+     * our reference is not specifically loaded.
+     */
+    maybeFindEntity(): U | undefined;
+    [RelationT]: T;
+    [RelationU]: U;
+    [ReferenceN]: N;
+}