typeorm-autofixtures 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andre Carlucci
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/array-helper.d.ts

@@ -0,0 +1,4 @@
+export default class ArrayHelper {
+    static last<T>(arr: T[]): T | undefined;
+}
+//# sourceMappingURL=array-helper.d.ts.map

package/dist/array-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-helper.d.ts","sourceRoot":"","sources":["../src/array-helper.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS;CAGxC"}

package/dist/array-helper.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ArrayHelper {
+    static last(arr) {
+        return arr.length > 0 ? arr[arr.length - 1] : undefined;
+    }
+}
+exports.default = ArrayHelper;
+//# sourceMappingURL=array-helper.js.map

package/dist/array-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-helper.js","sourceRoot":"","sources":["../src/array-helper.ts"],"names":[],"mappings":";;AAAA,MAAqB,WAAW;IAC9B,MAAM,CAAC,IAAI,CAAI,GAAQ;QACrB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;CACF;AAJD,8BAIC"}

package/dist/constructor-params.d.ts

@@ -0,0 +1,7 @@
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type RequiredProps<T> = Pick<T, RequiredKeys<T>>;
+export type ConstructorParams<T> = RequiredProps<T> & Partial<T>;
+export {};
+//# sourceMappingURL=constructor-params.d.ts.map

package/dist/constructor-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-params.d.ts","sourceRoot":"","sources":["../src/constructor-params.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,CAAC,CAAC,IAAI;KACpB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CACpD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,KAAK,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/constructor-params.js

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

package/dist/constructor-params.js.map

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

package/dist/fixture-context.d.ts

@@ -0,0 +1,17 @@
+export declare class FixtureContext {
+    dictionary: TypeRegistry;
+    getLast<T>(type: Ctor<T>): T | undefined;
+    count<T>(type: Ctor<T>): number;
+    merge(otherContext: FixtureContext): void;
+}
+export type Ctor<T = object> = {
+    prototype: T;
+};
+export declare class TypeRegistry {
+    map: Map<Ctor<any>, any[]>;
+    set<T>(classReference: Ctor<T>, instances: T[]): void;
+    get<T>(classReference: Ctor<T>): T[] | undefined;
+    getOrCreate<T>(classReference: Ctor<T>, factory: () => T[]): T[];
+    merge(otherRegistry: TypeRegistry): void;
+}
+//# sourceMappingURL=fixture-context.d.ts.map

package/dist/fixture-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-context.d.ts","sourceRoot":"","sources":["../src/fixture-context.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAClB,UAAU,EAAE,YAAY,CAAsB;IAE9C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAKxC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM;IAK/B,KAAK,CAAC,YAAY,EAAE,cAAc,GAAG,IAAI;CAGjD;AAED,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,CAAC;AAEhD,qBAAa,YAAY;IAChB,GAAG,wBAA+B;IAElC,GAAG,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,IAAI;IAIrD,GAAG,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS;IAIhD,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE;IAUhE,KAAK,CAAC,aAAa,EAAE,YAAY,GAAG,IAAI;CAMhD"}

package/dist/fixture-context.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeRegistry = exports.FixtureContext = void 0;
+const array_helper_1 = __importDefault(require("./array-helper"));
+class FixtureContext {
+    constructor() {
+        this.dictionary = new TypeRegistry();
+    }
+    getLast(type) {
+        const array = this.dictionary.get(type);
+        return array ? array_helper_1.default.last(array) : undefined;
+    }
+    count(type) {
+        const array = this.dictionary.get(type);
+        return array ? array.length : 0;
+    }
+    merge(otherContext) {
+        this.dictionary.merge(otherContext.dictionary);
+    }
+}
+exports.FixtureContext = FixtureContext;
+class TypeRegistry {
+    constructor() {
+        this.map = new Map();
+    }
+    set(classReference, instances) {
+        this.map.set(classReference, instances);
+    }
+    get(classReference) {
+        return this.map.get(classReference);
+    }
+    getOrCreate(classReference, factory) {
+        const existing = this.get(classReference);
+        if (existing) {
+            return existing;
+        }
+        const created = factory();
+        this.set(classReference, created);
+        return created;
+    }
+    merge(otherRegistry) {
+        for (const [key, value] of otherRegistry.map.entries()) {
+            const existingArray = this.getOrCreate(key, () => []);
+            existingArray.push(...value);
+        }
+    }
+}
+exports.TypeRegistry = TypeRegistry;
+//# sourceMappingURL=fixture-context.js.map

package/dist/fixture-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-context.js","sourceRoot":"","sources":["../src/fixture-context.ts"],"names":[],"mappings":";;;;;;AAAA,kEAAyC;AAEzC,MAAa,cAAc;IAA3B;QACS,eAAU,GAAiB,IAAI,YAAY,EAAE,CAAC;IAevD,CAAC;IAbQ,OAAO,CAAI,IAAa;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,CAAC,CAAC,sBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IAEM,KAAK,CAAI,IAAa;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,YAA4B;QACvC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;CACF;AAhBD,wCAgBC;AAID,MAAa,YAAY;IAAzB;QACS,QAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IA0B3C,CAAC;IAxBQ,GAAG,CAAI,cAAuB,EAAE,SAAc;QACnD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAEM,GAAG,CAAI,cAAuB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAoB,CAAC;IACzD,CAAC;IAEM,WAAW,CAAI,cAAuB,EAAE,OAAkB;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,aAA2B;QACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACtD,aAAa,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AA3BD,oCA2BC"}

package/dist/fixture-relation.helper.d.ts

@@ -0,0 +1,22 @@
+import { EntityTarget } from "typeorm";
+import { RelationMetadata } from "typeorm/metadata/RelationMetadata";
+export declare class FixtureRelationHelper<T> {
+    relationType: "one-to-one" | "one-to-many" | "many-to-one" | "many-to-many";
+    sourceTypeName: string;
+    sourceType: EntityTarget<any>;
+    sourcePropertyName: string;
+    isNullable: boolean;
+    targetPropertyName: string;
+    targetTypeName: string;
+    targetType: EntityTarget<any>;
+    instance: T;
+    providedValue: any;
+    constructor(instance: T, relation: RelationMetadata, providedValues: Partial<T>);
+    private getSourcePropertyName;
+    userProvidedValue(): boolean;
+    setInstanceProperty(value: any): void;
+    addValueToInstanceArray(value: any): void;
+    addThisInstanceToTheTargetSideArray(targetSide: any): void;
+    getLogMessage(suffix: string): string;
+}
+//# sourceMappingURL=fixture-relation.helper.d.ts.map

package/dist/fixture-relation.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-relation.helper.d.ts","sourceRoot":"","sources":["../src/fixture-relation.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,qBAAa,qBAAqB,CAAC,CAAC;IAC3B,YAAY,EAAE,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC;IACZ,aAAa,EAAE,GAAG,CAAC;gBAEP,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAetF,OAAO,CAAC,qBAAqB;IAItB,iBAAiB,IAAI,OAAO;IAI5B,mBAAmB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAIrC,uBAAuB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAOzC,mCAAmC,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAS1D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAK7C"}

package/dist/fixture-relation.helper.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixtureRelationHelper = void 0;
+class FixtureRelationHelper {
+    constructor(instance, relation, providedValues) {
+        this.relationType = relation.relationType;
+        this.sourceTypeName = relation.entityMetadata.name;
+        this.sourceType = relation.entityMetadata.target;
+        this.sourcePropertyName = relation.propertyName;
+        this.isNullable = relation.isNullable;
+        this.targetTypeName = relation.inverseEntityMetadata.name;
+        this.targetType = relation.inverseEntityMetadata.target;
+        this.targetPropertyName = relation.inverseRelation
+            ? relation.inverseRelation.propertyName
+            : relation.inverseSidePropertyPath;
+        this.instance = instance;
+        this.providedValue = providedValues[this.getSourcePropertyName()];
+    }
+    getSourcePropertyName() {
+        return this.sourcePropertyName;
+    }
+    userProvidedValue() {
+        return this.providedValue !== undefined;
+    }
+    setInstanceProperty(value) {
+        this.instance[this.getSourcePropertyName()] = value;
+    }
+    addValueToInstanceArray(value) {
+        if (!this.instance[this.getSourcePropertyName()]) {
+            this.instance[this.getSourcePropertyName()] = [];
+        }
+        this.instance[this.getSourcePropertyName()].push(value);
+    }
+    addThisInstanceToTheTargetSideArray(targetSide) {
+        if (this.targetPropertyName) {
+            if (!targetSide[this.targetPropertyName]) {
+                targetSide[this.targetPropertyName] = [];
+            }
+            targetSide[this.targetPropertyName].push(this.instance);
+        }
+    }
+    getLogMessage(suffix) {
+        return `${this.relationType.toUpperCase()} for ${this.sourceTypeName}.${this.sourcePropertyName} -> ${this.targetTypeName}.${this.targetPropertyName}: ${suffix}`;
+    }
+}
+exports.FixtureRelationHelper = FixtureRelationHelper;
+//# sourceMappingURL=fixture-relation.helper.js.map

package/dist/fixture-relation.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-relation.helper.js","sourceRoot":"","sources":["../src/fixture-relation.helper.ts"],"names":[],"mappings":";;;AAGA,MAAa,qBAAqB;IAYhC,YAAmB,QAAW,EAAE,QAA0B,EAAE,cAA0B;QACpF,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC;QACnD,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,MAA2B,CAAC;QACtE,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,YAAY,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,qBAAqB,CAAC,MAA2B,CAAC;QAC7E,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,eAAe;YAChD,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY;YACvC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACpE,CAAC;IAEO,qBAAqB;QAC3B,OAAO,IAAI,CAAC,kBAA6B,CAAC;IAC5C,CAAC;IAEM,iBAAiB;QACtB,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;IAC1C,CAAC;IAEM,mBAAmB,CAAC,KAAU;QACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,GAAG,KAAK,CAAC;IACtD,CAAC;IAEM,uBAAuB,CAAC,KAAU;QACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,GAAG,EAAS,CAAC;QAC1D,CAAC;QACA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAEM,mCAAmC,CAAC,UAAe;QACxD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACzC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;YAC3C,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAEM,aAAa,CAAC,MAAc;QACjC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,kBAAkB,OAC7F,IAAI,CAAC,cACP,IAAI,IAAI,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;IAC3C,CAAC;CACF;AA5DD,sDA4DC"}

package/dist/fixture.d.ts

@@ -0,0 +1,40 @@
+import { DataSource, EntityTarget } from "typeorm";
+export declare class Fixture {
+    private dataSource;
+    private repository;
+    private context;
+    private contextHistory;
+    private static globalCounter;
+    static IsLogEnabled: boolean;
+    constructor(dataSource: DataSource);
+    create<T>(type: EntityTarget<T>, providedValues?: Partial<T>): Promise<T>;
+    private createInternal;
+    private logInstanceCreated;
+    createMany<T>(times: number, type: EntityTarget<T>, providedValues?: Partial<T>): Promise<T[]>;
+    private allRequiredColumnsAreSet;
+    private handleScalarColumns;
+    private defaultForColumn;
+    private getMaxLengthForColumn;
+    private assignProvidedValuesToInstance;
+    private assignProvidedValueToInstance;
+    private handleOneToOne;
+    private handleManyToOne;
+    private handleManyToMany;
+    private handleOneToMany;
+    private addToContext;
+    private getFromContext;
+    private getIndex;
+    /**
+     * Resets the context, so previously created entities are no longer reused.
+     */
+    resetContext(): void;
+    private resetContextHistory;
+    /**
+     * Resets the DataSource and the repository used by the Fixture.
+     * It's called by TestManager to reset the same instance of Fixture when the DataSource is changed.
+     * Other than that, this is only useful when you want to use a different DataSource (e.g., different database connection) in the same test suite.
+     */
+    resetDataSource(dataSource: DataSource): void;
+    private log;
+}
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAiC,YAAY,EAAE,MAAM,SAAS,CAAC;AAGlF,qBAAa,OAAO;IAOC,OAAO,CAAC,UAAU;IANrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAK;IACjC,OAAc,YAAY,UAAS;gBAER,UAAU,EAAE,UAAU;IAIpC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,GAAE,OAAO,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAQ5E,cAAc;IAoB5B,OAAO,CAAC,kBAAkB;IAMb,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,GAAE,OAAO,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ/G,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,8BAA8B;IAStC,OAAO,CAAC,6BAA6B;YAMvB,cAAc;YA6Bd,eAAe;YAkCf,gBAAgB;YAuChB,eAAe;IAe7B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACI,YAAY,IAAI,IAAI;IAK3B,OAAO,CAAC,mBAAmB;IAK3B;;;;OAIG;IACI,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAQpD,OAAO,CAAC,GAAG;CAMZ"}

package/dist/fixture.js

@@ -0,0 +1,329 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fixture = void 0;
+const fixture_relation_helper_1 = require("./fixture-relation.helper");
+class Fixture {
+    constructor(dataSource) {
+        this.dataSource = dataSource;
+        this.context = new Map();
+        this.contextHistory = new Map();
+        this.repository = this.dataSource.manager;
+    }
+    create(type_1) {
+        return __awaiter(this, arguments, void 0, function* (type, providedValues = {}) {
+            const name = this.dataSource.getMetadata(type).name;
+            this.log(`===> User Call: Create ${name} ===`);
+            const instance = yield this.createInternal(type, providedValues);
+            yield this.repository.save(instance);
+            return instance;
+        });
+    }
+    createInternal(type_1) {
+        return __awaiter(this, arguments, void 0, function* (type, providedValues = {}) {
+            const meta = this.dataSource.getMetadata(type);
+            const instance = Object.create(meta.target.prototype);
+            this.log(`### Create ${meta.name} Started`);
+            this.handleScalarColumns(instance, meta, providedValues);
+            this.assignProvidedValuesToInstance(instance, meta, providedValues);
+            this.addToContext(instance, meta.name);
+            if (this.allRequiredColumnsAreSet(instance, meta)) {
+                yield this.repository.save(instance);
+            }
+            yield this.handleOneToOne(instance, meta, providedValues);
+            yield this.handleManyToOne(instance, meta, providedValues);
+            yield this.handleOneToMany(instance, meta, providedValues);
+            yield this.handleManyToMany(instance, meta, providedValues);
+            yield this.repository.save(instance);
+            this.logInstanceCreated(instance, meta);
+            return instance;
+        });
+    }
+    logInstanceCreated(instance, meta) {
+        const primaryKeyColumnName = meta.primaryColumns[0].propertyName;
+        const primaryKeyValue = instance[primaryKeyColumnName];
+        this.log(`### Created ${meta.name}. PK: ${primaryKeyColumnName} = ${primaryKeyValue}`);
+    }
+    createMany(times_1, type_1) {
+        return __awaiter(this, arguments, void 0, function* (times, type, providedValues = {}) {
+            const results = [];
+            for (let i = 0; i < times; i++) {
+                results.push(yield this.create(type, providedValues));
+            }
+            return results;
+        });
+    }
+    allRequiredColumnsAreSet(instance, meta) {
+        let foundRequiredWithNull = false;
+        for (const column of meta.columns) {
+            const name = column.propertyName;
+            if (column.generationStrategy === "increment" || column.isNullable) {
+                continue;
+            }
+            if (instance[name] === undefined || instance[name] === null) {
+                foundRequiredWithNull = true;
+                break;
+            }
+        }
+        return !foundRequiredWithNull;
+    }
+    handleScalarColumns(instance, meta, providedValues) {
+        for (const column of meta.columns) {
+            const name = column.propertyName;
+            const provided = providedValues[name];
+            if (provided !== undefined) {
+                instance[name] = provided;
+                continue;
+            }
+            if (column.generationStrategy === "increment") {
+                continue;
+            }
+            if (column.isNullable ||
+                column.relationMetadata ||
+                column.isCreateDate ||
+                column.isUpdateDate ||
+                column.isVersion) {
+                continue;
+            }
+            const isColumnUsedInRelation = meta.relations
+                .map((r) => r.joinColumns)
+                .map((jcs) => jcs.map((jc) => jc.propertyAliasName))
+                .flat();
+            if (isColumnUsedInRelation.includes(column.databaseName)) {
+                continue;
+            }
+            instance[name] = this.defaultForColumn(column, meta);
+        }
+    }
+    defaultForColumn(column, meta) {
+        const columnType = column.type;
+        if (typeof columnType !== "string") {
+            return null;
+        }
+        if (column.default !== undefined && typeof column.default !== "function") {
+            return column.default;
+        }
+        const s = columnType.toLowerCase();
+        if (["int", "integer", "bigint", "smallint", "decimal", "numeric", "float", "double", "real"].some((x) => s.includes(x))) {
+            return 0;
+        }
+        if (["bool", "boolean"].some((x) => s.includes(x)))
+            return false;
+        if (["date", "time", "timestamp", "datetime"].some((x) => s.includes(x)))
+            return new Date(0);
+        if (["json", "jsonb"].some((x) => s.includes(x)))
+            return {};
+        if (["uuid"].some((x) => s.includes(x)))
+            return undefined;
+        if (columnType.includes("enum") && column.enum) {
+            return column.enum[0];
+        }
+        // Use global counter for guaranteed uniqueness across all test runs.
+        // The counter persists for the entire test suite run, including across database resets.
+        // Trim from the prefix to always preserve the suffix, which contains the uniqueness guarantee.
+        Fixture.globalCounter++;
+        const counterSuffix = `-${Fixture.globalCounter.toString(36)}`;
+        const max = this.getMaxLengthForColumn(column);
+        if (counterSuffix.length >= max) {
+            return counterSuffix.slice(-max);
+        }
+        const prefixBudget = max - counterSuffix.length;
+        const prefix = `${column.propertyName}${this.getIndex(meta.name)}`.substring(0, prefixBudget);
+        return `${prefix}${counterSuffix}`;
+    }
+    getMaxLengthForColumn(column) {
+        let max = 255;
+        if (column.length !== "" && column.length !== undefined && !isNaN(Number(column.length))) {
+            max = Number(column.length);
+        }
+        return max;
+    }
+    assignProvidedValuesToInstance(instance, meta, params) {
+        for (const column of meta.columns) {
+            this.assignProvidedValueToInstance(instance, column.propertyName, params[column.propertyName]);
+        }
+        for (const relation of meta.relations) {
+            this.assignProvidedValueToInstance(instance, relation.propertyName, params[relation.propertyName]);
+        }
+    }
+    assignProvidedValueToInstance(instance, propertyName, provideValue) {
+        if (provideValue !== undefined) {
+            instance[propertyName] = provideValue;
+        }
+    }
+    handleOneToOne(instance, meta, params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (const relation of meta.relations.filter((r) => r.isOneToOne && !r.isOwning)) {
+                const helper = new fixture_relation_helper_1.FixtureRelationHelper(instance, relation, params);
+                if (helper.userProvidedValue()) {
+                    helper.setInstanceProperty(helper.providedValue);
+                    this.log(helper.getLogMessage("Use Provided"));
+                    continue;
+                }
+                if (helper.isNullable) {
+                    this.log(helper.getLogMessage("No Action Because Nullable"));
+                    continue;
+                }
+                if (!this.dataSource.hasMetadata(helper.targetType)) {
+                    this.log(helper.getLogMessage("No Action Because Other Type Not Found"));
+                    continue;
+                }
+                this.log(`${helper.getLogMessage("-> Create")}`);
+                const created = yield this.createInternal(helper.targetType, {
+                    [helper.targetPropertyName]: instance,
+                });
+                helper.setInstanceProperty(created);
+                this.log(helper.getLogMessage("Assigned"));
+            }
+        });
+    }
+    handleManyToOne(instance, meta, params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (const relation of meta.relations.filter((r) => r.isManyToOne)) {
+                const helper = new fixture_relation_helper_1.FixtureRelationHelper(instance, relation, params);
+                if (helper.userProvidedValue()) {
+                    helper.setInstanceProperty(helper.providedValue);
+                    this.log(helper.getLogMessage("Use Provided Value"));
+                    helper.addThisInstanceToTheTargetSideArray(helper.providedValue);
+                    continue;
+                }
+                if (helper.isNullable) {
+                    this.log(helper.getLogMessage("No Action Because Nullable"));
+                    continue;
+                }
+                const reuse = this.getFromContext(helper.targetTypeName);
+                if (reuse) {
+                    helper.setInstanceProperty(reuse);
+                    this.log(helper.getLogMessage("Use Cached"));
+                    continue;
+                }
+                if (this.dataSource.hasMetadata(helper.targetType)) {
+                    const createDependencyReferencingMe = {
+                        [helper.targetPropertyName]: [instance],
+                    };
+                    this.log(helper.getLogMessage("Create " + helper.targetTypeName));
+                    const created = yield this.createInternal(helper.targetType, createDependencyReferencingMe);
+                    helper.setInstanceProperty(created);
+                }
+            }
+        });
+    }
+    handleManyToMany(instance, meta, providedValues) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            for (const relation of meta.relations.filter((r) => r.isManyToMany)) {
+                const helper = new fixture_relation_helper_1.FixtureRelationHelper(instance, relation, providedValues);
+                if (helper.userProvidedValue()) {
+                    helper.setInstanceProperty(helper.providedValue);
+                    this.log(helper.getLogMessage("Use Provided Value"));
+                    for (const p of helper.providedValue) {
+                        if (!p[helper.targetPropertyName]) {
+                            p[helper.targetPropertyName] = [];
+                        }
+                        if (relation.isOwning) {
+                            if (!p[helper.targetPropertyName].includes(instance)) {
+                                p[helper.targetPropertyName].push(instance);
+                                yield this.repository.save(p);
+                            }
+                        }
+                    }
+                    helper.addThisInstanceToTheTargetSideArray(helper.providedValue);
+                    continue;
+                }
+                const reuse = this.getFromContext(helper.targetTypeName);
+                if (reuse) {
+                    this.log(helper.getLogMessage("Use Cached"));
+                    if ((_a = instance[helper.sourcePropertyName]) === null || _a === void 0 ? void 0 : _a.includes(reuse)) {
+                        //I'm already part of the list
+                        continue;
+                    }
+                    helper.addThisInstanceToTheTargetSideArray(reuse);
+                    yield this.repository.save(reuse);
+                    helper.addValueToInstanceArray(reuse);
+                    continue;
+                }
+                this.log(helper.getLogMessage("No Action"));
+            }
+        });
+    }
+    handleOneToMany(instance, meta, params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (const relation of meta.relations.filter((r) => r.isOneToMany)) {
+                const helper = new fixture_relation_helper_1.FixtureRelationHelper(instance, relation, params);
+                if (helper.userProvidedValue()) {
+                    this.log(helper.getLogMessage("Use Provided"));
+                    helper.setInstanceProperty(helper.providedValue);
+                    yield this.repository.save(instance);
+                    continue;
+                }
+                this.log(helper.getLogMessage("No Action"));
+            }
+        });
+    }
+    addToContext(instance, name) {
+        if (!this.context.has(name)) {
+            this.context.set(name, []);
+        }
+        this.context.get(name).push(instance);
+        //indexes
+        if (!this.contextHistory.has(name)) {
+            this.contextHistory.set(name, 1);
+            return;
+        }
+        this.contextHistory.set(name, this.contextHistory.get(name) + 1);
+    }
+    getFromContext(name) {
+        if (!this.context.has(name)) {
+            this.context.set(name, []);
+        }
+        const items = this.context.get(name);
+        return items[items.length - 1];
+    }
+    getIndex(name) {
+        if (!this.contextHistory.has(name)) {
+            this.contextHistory.set(name, 1);
+        }
+        return this.contextHistory.get(name);
+    }
+    /**
+     * Resets the context, so previously created entities are no longer reused.
+     */
+    resetContext() {
+        this.context = new Map();
+        this.log("=== Context Reset ===");
+    }
+    resetContextHistory() {
+        this.contextHistory = new Map();
+        this.log("=== Context History Reset ===");
+    }
+    /**
+     * Resets the DataSource and the repository used by the Fixture.
+     * It's called by TestManager to reset the same instance of Fixture when the DataSource is changed.
+     * Other than that, this is only useful when you want to use a different DataSource (e.g., different database connection) in the same test suite.
+     */
+    resetDataSource(dataSource) {
+        this.dataSource = dataSource;
+        this.repository = this.dataSource.manager;
+        this.resetContext();
+        this.resetContextHistory();
+        this.log("=== DataSource Reset ===");
+    }
+    log(message) {
+        if (!Fixture.IsLogEnabled) {
+            return;
+        }
+        console.log(message);
+    }
+}
+exports.Fixture = Fixture;
+Fixture.globalCounter = 0;
+Fixture.IsLogEnabled = false;
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,uEAAkE;AAElE,MAAa,OAAO;IAOlB,YAA2B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;QALzC,YAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;QACnC,mBAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QAKjD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IAC5C,CAAC;IAEY,MAAM;6DAAI,IAAqB,EAAE,iBAA6B,EAAE;YAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,0BAA0B,IAAI,MAAM,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACjE,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAEa,cAAc;6DAAI,IAAqB,EAAE,iBAA6B,EAAE;YACpF,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAE,IAAI,CAAC,MAAc,CAAC,SAAS,CAAM,CAAC;YACpE,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YACzD,IAAI,CAAC,8BAA8B,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YACpE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YAC3D,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YAC3D,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YAE5D,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAEO,kBAAkB,CAAI,QAAW,EAAE,IAAoB;QAC7D,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QACjE,MAAM,eAAe,GAAG,QAAQ,CAAC,oBAA+B,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,IAAI,SAAS,oBAAoB,MAAM,eAAe,EAAE,CAAC,CAAC;IACzF,CAAC;IAEY,UAAU;6DAAI,KAAa,EAAE,IAAqB,EAAE,iBAA6B,EAAE;YAC9F,MAAM,OAAO,GAAQ,EAAE,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KAAA;IAEO,wBAAwB,CAAI,QAAW,EAAE,IAAoB;QACnE,IAAI,qBAAqB,GAAG,KAAK,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;YACjC,IAAI,MAAM,CAAC,kBAAkB,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACnE,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,IAAe,CAAC,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAe,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClF,qBAAqB,GAAG,IAAI,CAAC;gBAC7B,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,CAAC,qBAAqB,CAAC;IAChC,CAAC;IAEO,mBAAmB,CAAI,QAAW,EAAE,IAAoB,EAAE,cAA0B;QAC1F,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAe,CAAC,CAAC;YACjD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAe,CAAC,GAAG,QAAe,CAAC;gBAC5C,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,kBAAkB,KAAK,WAAW,EAAE,CAAC;gBAC9C,SAAS;YACX,CAAC;YACD,IACE,MAAM,CAAC,UAAU;gBACjB,MAAM,CAAC,gBAAgB;gBACvB,MAAM,CAAC,YAAY;gBACnB,MAAM,CAAC,YAAY;gBACnB,MAAM,CAAC,SAAS,EAChB,CAAC;gBACD,SAAS;YACX,CAAC;YACD,MAAM,sBAAsB,GAAG,IAAI,CAAC,SAAS;iBAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;iBACzB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;iBACnD,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAe,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,MAAsB,EAAE,IAAoB;QACnE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;QAE/B,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACnC,IACE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACnG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CACd,EACD,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAE1D,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,qEAAqE;QACrE,wFAAwF;QACxF,+FAA+F;QAC/F,OAAO,CAAC,aAAa,EAAE,CAAC;QACxB,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,aAAa,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAChC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,YAAY,GAAG,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC;QAChD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9F,OAAO,GAAG,MAAM,GAAG,aAAa,EAAE,CAAC;IACrC,CAAC;IAEO,qBAAqB,CAAC,MAAsB;QAClD,IAAI,GAAG,GAAG,GAAG,CAAC;QACd,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACzF,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,8BAA8B,CAAI,QAAW,EAAE,IAAoB,EAAE,MAAkB;QAC7F,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAuB,CAAC,CAAC,CAAC;QAC5G,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAuB,CAAC,CAAC,CAAC;QAChH,CAAC;IACH,CAAC;IAEO,6BAA6B,CAAI,QAAW,EAAE,YAAoB,EAAE,YAAiB;QAC3F,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,QAAQ,CAAC,YAAuB,CAAC,GAAG,YAAY,CAAC;QACnD,CAAC;IACH,CAAC;IAEa,cAAc,CAAI,QAAW,EAAE,IAAoB,EAAE,MAAkB;;YACnF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjF,MAAM,MAAM,GAAG,IAAI,+CAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAErE,IAAI,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC;oBAC/B,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACjD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;oBAC/C,SAAS;gBACX,CAAC;gBAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC,CAAC;oBAC7D,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACpD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC,CAAC;oBACzE,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACjD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE;oBAC3D,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,QAAQ;iBACtC,CAAC,CAAC;gBACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBACpC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;KAAA;IAEa,eAAe,CAAI,QAAW,EAAE,IAAoB,EAAE,MAAkB;;YACpF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;gBACnE,MAAM,MAAM,GAAG,IAAI,+CAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAErE,IAAI,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC;oBAC/B,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACjD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;oBACrD,MAAM,CAAC,mCAAmC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACjE,SAAS;gBACX,CAAC;gBAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC,CAAC;oBAC7D,SAAS;gBACX,CAAC;gBAED,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBACzD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;oBAClC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;oBAC7C,SAAS;gBACX,CAAC;gBAED,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACnD,MAAM,6BAA6B,GAAG;wBACpC,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,CAAC;qBACxC,CAAC;oBACF,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;oBAClE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;oBAC5F,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;KAAA;IAEa,gBAAgB,CAAI,QAAW,EAAE,IAAoB,EAAE,cAA0B;;;YAC7F,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpE,MAAM,MAAM,GAAG,IAAI,+CAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;gBAE7E,IAAI,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC;oBAC/B,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACjD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;oBACrD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;wBACrC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;4BAClC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;wBACpC,CAAC;wBACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;4BACtB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gCACrD,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gCAC5C,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;4BAChC,CAAC;wBACH,CAAC;oBACH,CAAC;oBACD,MAAM,CAAC,mCAAmC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACjE,SAAS;gBACX,CAAC;gBAED,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBACzD,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;oBAC7C,IAAI,MAAC,QAAQ,CAAC,MAAM,CAAC,kBAA6B,CAAS,0CAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC7E,8BAA8B;wBAC9B,SAAS;oBACX,CAAC;oBACD,MAAM,CAAC,mCAAmC,CAAC,KAAK,CAAC,CAAC;oBAClD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClC,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;oBACtC,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;KAAA;IAEa,eAAe,CAAI,QAAW,EAAE,IAAoB,EAAE,MAAkB;;YACpF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;gBACnE,MAAM,MAAM,GAAG,IAAI,+CAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAErE,IAAI,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC;oBAC/B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;oBAC/C,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACjD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACrC,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;KAAA;IAEO,YAAY,CAAI,QAAW,EAAE,IAAY;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvC,SAAS;QACT,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,cAAc,CAAI,IAAY;QACpC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACtC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpC,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,UAAsB;QAC3C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACvC,CAAC;IAEO,GAAG,CAAC,OAAe;QACzB,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;;AAnVH,0BAoVC;AAhVgB,qBAAa,GAAG,CAAC,AAAJ,CAAK;AACnB,oBAAY,GAAG,KAAK,AAAR,CAAS"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Fixture } from "./fixture";
+export { ConstructorParams } from "./constructor-params";
+export { ValidValues } from "./valid-values";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fixture = void 0;
+var fixture_1 = require("./fixture");
+Object.defineProperty(exports, "Fixture", { enumerable: true, get: function () { return fixture_1.Fixture; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}

package/dist/valid-values.d.ts

@@ -0,0 +1,2 @@
+export type ValidValues = string | number | boolean | Date;
+//# sourceMappingURL=valid-values.d.ts.map

package/dist/valid-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valid-values.d.ts","sourceRoot":"","sources":["../src/valid-values.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC"}

package/dist/valid-values.js

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

package/dist/valid-values.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "typeorm-autofixtures",
+  "version": "0.0.1",
+  "description": "Automatic fixtures for typeorm",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "test": "jest"
+  },
+  "keywords": [
+    "typeorm",
+    "fixtures",
+    "testing",
+    "test-data",
+    "auto-fixtures"
+  ],
+  "author": "andrecarlucci",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andrecarlucci/typeorm-fixtures.git"
+  },
+  "peerDependencies": {
+    "typeorm": ">=0.3.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "pg": "^8.17.1",
+    "pg-mem": "^3.0.5",
+    "ts-jest": "^29.4.6",
+    "typeorm": "^0.3.28",
+    "typescript": "^5.9.3"
+  }
+}

package/readme.md

@@ -0,0 +1,87 @@
+# Fixtures
+
+You can use Fixture to speed up creating the database entities you need for your tests.
+
+The fixture object will automatically create and keep track of every entity required to construct the target one. It has an internal context to and reuses the last created entity of a given type every time it is required to create a new object.
+
+## Rules to have in mind
+
+- it only creates non-nullable properties and relations
+- for relations
+  - One-to-One: create only if not owner
+  - Many-to-One: always create
+  - One-to-Many: never create
+  - Many-to-Many: never create
+
+\*Owner: side of the relation with join column (Many-to-Many or One-to-One)
+
+## Simple use
+
+```
+beforeEach(async () => {
+    await database.refreshDatabase();
+    repository = (await database.getDataSource()).createEntityManager();
+    fixture = new Fixture(await database.getDataSource());
+});
+
+it('Creates a Task', async () => {
+  const task = await fixture.create(Task);
+  expect(task.id).toBeDefined();
+  expect(task.project).toBeDefined();
+  expect(task.users).toBeUndefined();
+});
+```
+
+Fixture will:
+
+1. Create the object Task and stub all of its non-nullable properties.
+2. Loop through all its properties and relations:
+   1. Find MANY-TO-ONE for Task.project -> Project.tasks: Create a Project
+   2. Loop through all Project properties and relations:
+      1. Find ONE-TO-MANY for Project.tasks -> Task.project: No Action (one-to-many)
+   3. Find MANY-TO-MANY for Task.users -> User.tasks: No Action (many-to-many)
+3. Returns the Task object populated.
+
+## Using the context
+
+Every time an object is created, it stays in the context.
+So, calling methods like this:
+
+```
+const task1 = await fixture.create(Task);
+const task2 = await fixture.create(Task);
+expect(task1.project).toBe(task2.project);
+```
+
+Will automatically reuse the previously created Project for both Tasks.
+
+If you don't want this behaviour, just call `fixture.resetContext()` and your next calls will be in a completely different object graph.
+
+```
+const task1 = await fixture.create(Task);
+fixture.resetContext();
+const task2 = await fixture.create(Task);
+expect(task1.project).not.toBe(task2.project);
+```
+
+## Provide your own values
+
+Every `fixture.create(Type)` accepts a `Partial<Type>` as a parameter where you can specify your own values for the creation of the object.
+
+Ex:
+Scalar types:
+
+```
+const project = await fixture.create(Project, { name: 'My Project' });
+expect(project.name).toBe('My Project');
+```
+
+Or objects:
+
+```
+const project = await fixture.create(Project);
+const task = await fixture.create(Task, { project });
+expect(task.project).toBe(project);
+```
+
+You can find many more examples in the [fixture's test](./test/fixture.test.ts) file.