@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/cli/utils/factories/Factory.d.ts

@@ -0,0 +1,61 @@
+import { BaseModel } from "../../../core/model/BaseModel";
+/** Plain object for attributes */
+export type PlainObject = Record<string, unknown>;
+/** Constructor helper */
+export type ModelCtor<T> = new (...args: unknown[]) => T;
+/** Factory constructor type */
+export type FactoryCtor<K extends BaseModel> = new () => Factory<K>;
+/** Shape of models supporting instance create() */
+export interface InstanceCreatable {
+    create(data: PlainObject): Promise<void>;
+}
+/** Shape of models supporting instance save() */
+export interface InstanceSavable {
+    save(): Promise<void>;
+}
+/** Shape of static creatable constructors */
+export interface StaticCreatableCtor<T> {
+    create(data: PlainObject): Promise<T>;
+}
+/**
+ * 🧩 Base Factory
+ * Fully strict, no `any` used anywhere.
+ */
+export declare abstract class Factory<T extends BaseModel> {
+    /** Model constructor reference */
+    abstract model: ModelCtor<T>;
+    /** Faker instance */
+    protected faker: import("@faker-js/faker").Faker;
+    /**
+     * Must return fake attributes.
+     * Index helps create sequences (createMany)
+     */
+    abstract definition(index?: number): PlainObject;
+    /**
+     * Optional hooks
+     */
+    beforeCreate?(attrs: Partial<T>, index: number): Promise<Partial<T> | void>;
+    afterCreate?(instance: T): Promise<void>;
+    /**
+     * Create one record
+     */
+    create(attrs?: Partial<T>, index?: number): Promise<T>;
+    /**
+     * 🔁 Create many with optional concurrency
+     */
+    createMany(count: number, callback?: (model: T, index: number) => void | Promise<void>, concurrency?: number): Promise<T[]>;
+    /**
+     * Helper: create related records
+     */
+    protected related<K extends BaseModel>(factoryOrCtor: Factory<K> | FactoryCtor<K>, count?: number): Promise<K | K[]>;
+    /**
+     * Helper: create pivot relations
+     */
+    protected relatedPivot<K extends BaseModel>(factory: {
+        createPivot: (foreignId: string | number, relatedIds: (string | number)[], extra?: Record<string, unknown>) => Promise<void>;
+    }, pivotTable: string, foreignKey: string, relatedKey: string, foreignId: string | number, relatedIds: (string | number)[], extraPivotAttrs?: Record<string, unknown>): Promise<void>;
+    private hasInstanceCreate;
+    private hasStaticCreate;
+    private hasInstanceSave;
+}
+//# sourceMappingURL=Factory.d.ts.map

package/dist/cli/utils/factories/Factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/factories/Factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD,yBAAyB;AACzB,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAEzD,+BAA+B;AAC/B,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI,UAAU,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,8BAAsB,OAAO,CAAC,CAAC,SAAS,SAAS;IAC/C,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAE7B,qBAAqB;IACrB,SAAS,CAAC,KAAK,kCAAS;IAExB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW;IAEhD;;OAEG;IACG,YAAY,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3E,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9C;;OAEG;IACG,MAAM,CAAC,KAAK,GAAE,OAAO,CAAC,CAAC,CAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IA6C3D;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC5D,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,EAAE,CAAC;IAuDf;;OAEG;cACa,OAAO,CAAC,CAAC,SAAS,SAAS,EACzC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAC1C,KAAK,SAAI,GACR,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAWnB;;OAEG;cACa,YAAY,CAAC,CAAC,SAAS,SAAS,EAC9C,OAAO,EAAE;QACP,WAAW,EAAE,CACX,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;KACpB,EACD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAahB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/cli/utils/factories/Factory.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Factory = void 0;
+// src/cli/utils/factories/Factory.ts
+const faker_1 = require("@faker-js/faker");
+/**
+ * 🧩 Base Factory
+ * Fully strict, no `any` used anywhere.
+ */
+class Factory {
+    constructor() {
+        /** Faker instance */
+        this.faker = faker_1.faker;
+    }
+    /**
+     * Create one record
+     */
+    async create(attrs = {}, index = 0) {
+        const base = this.definition(index);
+        const merged = { ...base, ...attrs };
+        if (this.beforeCreate) {
+            const modified = await this.beforeCreate(merged, index);
+            if (modified && typeof modified === "object") {
+                Object.assign(merged, modified);
+            }
+        }
+        // Always instantiate the model
+        let instance = new this.model();
+        // Case 1: Instance has create()
+        if (this.hasInstanceCreate(instance)) {
+            const created = await instance.create(merged);
+            if (created) {
+                instance = created;
+            }
+        }
+        // Case 2: Static create()
+        else if (this.hasStaticCreate(this.model)) {
+            const created = await this.model.create(merged);
+            // if static create returns an instance, override
+            return created;
+        }
+        // Case 3: Instance has save()
+        else if (this.hasInstanceSave(instance)) {
+            Object.assign(instance, merged);
+            await instance.save();
+        }
+        else {
+            throw new Error(`Model '${this.model.name}' has no valid create/save method.`);
+        }
+        if (this.afterCreate) {
+            await this.afterCreate(instance);
+        }
+        return instance;
+    }
+    /**
+     * 🔁 Create many with optional concurrency
+     */
+    async createMany(count, callback, concurrency = 1) {
+        const results = [];
+        const executeCreate = async (i) => {
+            const model = await this.create({}, i);
+            if (callback)
+                await callback(model, i);
+            results[i] = model;
+        };
+        if (concurrency <= 1) {
+            for (let i = 0; i < count; i++) {
+                await executeCreate(i);
+            }
+            return results;
+        }
+        let active = 0;
+        let index = 0;
+        let settled = false;
+        return new Promise((resolve, reject) => {
+            const maybeResolve = () => {
+                if (!settled && index >= count && active === 0) {
+                    settled = true;
+                    resolve(results);
+                }
+            };
+            const next = () => {
+                if (settled)
+                    return;
+                while (active < concurrency && index < count && !settled) {
+                    const i = index++;
+                    active++;
+                    void executeCreate(i)
+                        .catch((err) => {
+                        if (settled)
+                            return;
+                        settled = true;
+                        reject(err);
+                    })
+                        .finally(() => {
+                        active--;
+                        if (settled)
+                            return;
+                        next();
+                    });
+                }
+                maybeResolve();
+            };
+            next();
+        });
+    }
+    /**
+     * Helper: create related records
+     */
+    async related(factoryOrCtor, count = 1) {
+        const factory = typeof factoryOrCtor === "function"
+            ? new factoryOrCtor()
+            : factoryOrCtor;
+        if (count === 1)
+            return factory.create();
+        return factory.createMany(count);
+    }
+    /**
+     * Helper: create pivot relations
+     */
+    async relatedPivot(factory, pivotTable, foreignKey, relatedKey, foreignId, relatedIds, extraPivotAttrs) {
+        await factory.createPivot(foreignId, relatedIds, extraPivotAttrs);
+        // eslint-disable-next-line no-console
+        console.log(`🔗 [Pivot Attached] Table "${pivotTable}" (${foreignKey} → ${relatedKey})`);
+    }
+    //
+    // 👇 Type Guards — STRICT, no any
+    //
+    hasInstanceCreate(obj) {
+        return typeof obj.create === "function";
+    }
+    hasStaticCreate(ctor) {
+        return typeof ctor.create === "function";
+    }
+    hasInstanceSave(obj) {
+        return typeof obj.save === "function";
+    }
+}
+exports.Factory = Factory;
+//# sourceMappingURL=Factory.js.map

package/dist/cli/utils/factories/Factory.js.map

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

package/dist/cli/utils/factories/FactoryDisplay.d.ts

@@ -0,0 +1,6 @@
+import type { RelationDefinition } from "../../../core/schema/SchemaBlueprint";
+export declare const FACTORY_EMPTY_MARK = "-";
+export declare const FACTORY_STATUS_FOOTER = "\nUse factories directly via FactoryRegistry.make(<name>)\n";
+export declare const FACTORY_GRAPH_HEADER = "\nModel Relationship Graph\n\n";
+export declare function getFactoryRelationArrow(relation: RelationDefinition["relation"] | string): string;
+//# sourceMappingURL=FactoryDisplay.d.ts.map

package/dist/cli/utils/factories/FactoryDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryDisplay.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryDisplay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,qBAAqB,gEAC6B,CAAC;AAChE,eAAO,MAAM,oBAAoB,mCAAmC,CAAC;AAErE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,MAAM,GAChD,MAAM,CAaR"}

package/dist/cli/utils/factories/FactoryDisplay.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FACTORY_GRAPH_HEADER = exports.FACTORY_STATUS_FOOTER = exports.FACTORY_EMPTY_MARK = void 0;
+exports.getFactoryRelationArrow = getFactoryRelationArrow;
+const chalk_1 = __importDefault(require("chalk"));
+exports.FACTORY_EMPTY_MARK = "-";
+exports.FACTORY_STATUS_FOOTER = "\nUse factories directly via FactoryRegistry.make(<name>)\n";
+exports.FACTORY_GRAPH_HEADER = "\nModel Relationship Graph\n\n";
+function getFactoryRelationArrow(relation) {
+    switch (relation) {
+        case "belongsTo":
+            return chalk_1.default.blue("<-");
+        case "hasOne":
+            return chalk_1.default.green("->");
+        case "hasMany":
+            return chalk_1.default.green("->>");
+        case "belongsToMany":
+            return chalk_1.default.magenta("<->");
+        default:
+            return relation.startsWith("morph") ? chalk_1.default.yellow("~>") : "->";
+    }
+}
+//# sourceMappingURL=FactoryDisplay.js.map

package/dist/cli/utils/factories/FactoryDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryDisplay.js","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryDisplay.ts"],"names":[],"mappings":";;;;;;AAQA,0DAeC;AAvBD,kDAA0B;AAGb,QAAA,kBAAkB,GAAG,GAAG,CAAC;AACzB,QAAA,qBAAqB,GAChC,6DAA6D,CAAC;AACnD,QAAA,oBAAoB,GAAG,gCAAgC,CAAC;AAErE,SAAgB,uBAAuB,CACrC,QAAiD;IAEjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,KAAK,eAAe;YAClB,OAAO,eAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B;YACE,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/cli/utils/factories/FactoryGraph.d.ts

@@ -0,0 +1,6 @@
+/**
+ * FactoryGraph
+ * Generates an ASCII relationship graph from registered factories.
+ */
+export declare function generateFactoryGraph(factoryNames: string[]): string;
+//# sourceMappingURL=FactoryGraph.d.ts.map

package/dist/cli/utils/factories/FactoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryGraph.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryGraph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsEH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAiCnE"}

package/dist/cli/utils/factories/FactoryGraph.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * FactoryGraph
+ * Generates an ASCII relationship graph from registered factories.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFactoryGraph = generateFactoryGraph;
+const chalk_1 = __importDefault(require("chalk"));
+const FactoryDisplay_1 = require("./FactoryDisplay");
+const FactoryRegistry_1 = require("./FactoryRegistry");
+function hasSchema(modelCtor) {
+    return (typeof modelCtor === "function" &&
+        Object.prototype.hasOwnProperty.call(modelCtor, "schema"));
+}
+function collectLinks(factoryNames) {
+    const links = [];
+    for (const factoryName of factoryNames) {
+        const factory = FactoryRegistry_1.FactoryRegistry.make(factoryName);
+        const modelCtor = factory.model;
+        const modelName = modelCtor.name.replace("Factory", "");
+        const modelInstance = new modelCtor();
+        if (!hasSchema(modelInstance.constructor)) {
+            continue;
+        }
+        for (const field of Object.values(modelInstance.constructor.schema)) {
+            if (field.kind !== "relation") {
+                continue;
+            }
+            const rel = field;
+            links.push({
+                from: modelName,
+                to: rel.model,
+                rel: rel.relation,
+            });
+        }
+    }
+    return links;
+}
+function dedupeLinks(links) {
+    return links.filter((link, index, array) => index ===
+        array.findIndex((candidate) => (candidate.from === link.from && candidate.to === link.to) ||
+            (candidate.from === link.to && candidate.to === link.from)));
+}
+function generateFactoryGraph(factoryNames) {
+    let output = chalk_1.default.cyanBright(FactoryDisplay_1.FACTORY_GRAPH_HEADER);
+    if (factoryNames.length === 0) {
+        return output + chalk_1.default.gray("No factories registered.\n");
+    }
+    const uniqueLinks = dedupeLinks(collectLinks(factoryNames));
+    if (uniqueLinks.length === 0) {
+        return output + chalk_1.default.gray("No relationships detected.\n");
+    }
+    const grouped = new Map();
+    for (const { from, to, rel } of uniqueLinks) {
+        if (!grouped.has(from)) {
+            grouped.set(from, []);
+        }
+        grouped.get(from).push({ to, rel });
+    }
+    for (const [node, relations] of grouped.entries()) {
+        output += chalk_1.default.greenBright(`${node}\n`);
+        for (const { to, rel } of relations) {
+            output += `${chalk_1.default.gray(`  ${(0, FactoryDisplay_1.getFactoryRelationArrow)(rel)} `)}${chalk_1.default.cyan(to)} ${chalk_1.default.gray(`(${rel})`)}\n`;
+        }
+        output += "\n";
+    }
+    return output;
+}
+//# sourceMappingURL=FactoryGraph.js.map

package/dist/cli/utils/factories/FactoryGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryGraph.js","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryGraph.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAsEH,oDAiCC;AArGD,kDAA0B;AAK1B,qDAG0B;AAC1B,uDAAoD;AAEpD,SAAS,SAAS,CAChB,SAAkB;IAElB,OAAO,CACL,OAAO,SAAS,KAAK,UAAU;QAC/B,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAC1D,CAAC;AACJ,CAAC;AAQD,SAAS,YAAY,CAAC,YAAsB;IAC1C,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,iCAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;QAChC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,IAAI,SAAS,EAAE,CAAC;QAEtC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YAED,MAAM,GAAG,GAAG,KAA2B,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,SAAS;gBACf,EAAE,EAAE,GAAG,CAAC,KAAK;gBACb,GAAG,EAAE,GAAG,CAAC,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB;IACxC,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACrB,KAAK;QACL,KAAK,CAAC,SAAS,CACb,CAAC,SAAS,EAAE,EAAE,CACZ,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1D,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,CAC7D,CACJ,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,YAAsB;IACzD,IAAI,MAAM,GAAG,eAAK,CAAC,UAAU,CAAC,qCAAoB,CAAC,CAAC;IAEpD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,GAAG,eAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IAE5D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,GAAG,eAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8C,CAAC;IAEtE,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,WAAW,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,eAAK,CAAC,WAAW,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACzC,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,eAAK,CAAC,IAAI,CAAC,KAAK,IAAA,wCAAuB,EAAC,GAAG,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CACxE,EAAE,CACH,IAAI,eAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/utils/factories/FactoryLoader.d.ts

@@ -0,0 +1,16 @@
+import type { StorageKind } from "../ArtifactStorage";
+/**
+ *  FactoryLoader
+ * Automatically discovers and registers all factories at runtime.
+ *
+ * Usage:
+ *   import { loadFactories } from "./FactoryLoader";
+ *
+ * After import, you can do:
+ *   const userFactory = FactoryRegistry.make("UserFactory");
+ *   const user = await userFactory.create();
+ */
+export declare function loadFactories(isTest?: boolean, options?: {
+    storageKind?: Exclude<StorageKind, "unknown" | "mixed">;
+}): Promise<void>;
+//# sourceMappingURL=FactoryLoader.d.ts.map

package/dist/cli/utils/factories/FactoryLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;GAUG;AAEH,wBAAsB,aAAa,CACjC,MAAM,UAAQ,EACd,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,CAAA;CAAO,GACxE,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/cli/utils/factories/FactoryLoader.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFactories = loadFactories;
+const chalk_1 = __importDefault(require("chalk"));
+const FactoryRegistry_1 = require("./FactoryRegistry");
+/**
+ *  FactoryLoader
+ * Automatically discovers and registers all factories at runtime.
+ *
+ * Usage:
+ *   import { loadFactories } from "./FactoryLoader";
+ *
+ * After import, you can do:
+ *   const userFactory = FactoryRegistry.make("UserFactory");
+ *   const user = await userFactory.create();
+ */
+async function loadFactories(isTest = false, options = {}) {
+    console.log(chalk_1.default.cyanBright("Initializing FactoryRegistry..."));
+    try {
+        FactoryRegistry_1.FactoryRegistry.clear();
+        await FactoryRegistry_1.FactoryRegistry.autoDiscover(isTest, options);
+        const count = FactoryRegistry_1.FactoryRegistry.list().length;
+        console.log(chalk_1.default.greenBright(`Loaded ${count} factories.`));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("Failed to initialize factories."));
+        if (error instanceof Error)
+            console.error(chalk_1.default.red(error.message));
+    }
+}
+// Note: no auto-run here. The CLI entrypoint calls loadFactories explicitly.
+//# sourceMappingURL=FactoryLoader.js.map

package/dist/cli/utils/factories/FactoryLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryLoader.js","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryLoader.ts"],"names":[],"mappings":";;;;;AAgBA,sCAgBC;AAhCD,kDAA0B;AAC1B,uDAAoD;AAGpD;;;;;;;;;;GAUG;AAEI,KAAK,UAAU,aAAa,CACjC,MAAM,GAAG,KAAK,EACd,UAAuE,EAAE;IAEzE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAEjE,IAAI,CAAC;QACH,iCAAe,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,iCAAe,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEpD,MAAM,KAAK,GAAG,iCAAe,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,WAAW,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC;QAC5D,IAAI,KAAK,YAAY,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,6EAA6E"}

package/dist/cli/utils/factories/FactoryRegistry.d.ts

@@ -0,0 +1,16 @@
+import type { BaseModel } from "../../../core/model/BaseModel";
+import { type StorageKind } from "../ArtifactStorage";
+import type { Factory } from "./Factory";
+export declare class FactoryRegistry {
+    private static registry;
+    static register<T extends Factory<BaseModel>>(name: string, factory: new () => T): void;
+    static registerBulk<T extends Record<string, new () => Factory<BaseModel>>>(factories: T): void;
+    static make<T extends Factory<BaseModel>>(name: string): T;
+    static makePivot<T extends Factory<BaseModel>>(name: string): T;
+    static autoDiscover(isTest?: boolean, options?: {
+        storageKind?: Exclude<StorageKind, "unknown" | "mixed">;
+    }): Promise<void>;
+    static list(): string[];
+    static clear(): void;
+}
+//# sourceMappingURL=FactoryRegistry.d.ts.map

package/dist/cli/utils/factories/FactoryRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryRegistry.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/factories/FactoryRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmD;IAE1E,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,OAAO,CAAC,SAAS,CAAC,EAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,GACnB,IAAI;IASP,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,OAAO,CAAC,SAAS,CAAC,CAAC,EACxE,SAAS,EAAE,CAAC,GACX,IAAI;IAMP,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAS1D,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;WAOlD,YAAY,CACvB,MAAM,UAAQ,EACd,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,CAAA;KAAO,GACxE,OAAO,CAAC,IAAI,CAAC;IA2DhB,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE;IAIvB,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/cli/utils/factories/FactoryRegistry.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryRegistry = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ArtifactRoutingReport_1 = require("../ArtifactRoutingReport");
+const ArtifactStorage_1 = require("../ArtifactStorage");
+const PathMap_1 = require("../PathMap");
+const tsRuntime_1 = require("../typescript/tsRuntime");
+class FactoryRegistry {
+    static register(name, factory) {
+        if (this.registry.has(name)) {
+            console.warn(chalk_1.default.yellow(`Factory already registered: ${name}`));
+            return;
+        }
+        this.registry.set(name, factory);
+    }
+    static registerBulk(factories) {
+        for (const [key, factory] of Object.entries(factories)) {
+            this.register(key, factory);
+        }
+    }
+    static make(name) {
+        const entry = this.registry.get(name);
+        if (!entry) {
+            throw new Error(`Factory '${name}' not found in registry.`);
+        }
+        return new entry();
+    }
+    static makePivot(name) {
+        const pivotName = name.endsWith("PivotFactory")
+            ? name
+            : `${name}PivotFactory`;
+        return this.make(pivotName);
+    }
+    static async autoDiscover(isTest = false, options = {}) {
+        const dir = PathMap_1.PathMap.factories(isTest);
+        if (!fs_1.default.existsSync(dir)) {
+            console.log(chalk_1.default.gray(`No factories folder found at: ${dir}`));
+            return;
+        }
+        const files = fs_1.default.readdirSync(dir).filter((file) => file.endsWith(".ts"));
+        for (const file of files) {
+            const fullPath = path_1.default.join(dir, file);
+            try {
+                const importedModule = (0, tsRuntime_1.loadModule)(fullPath);
+                for (const [name, exported] of Object.entries(importedModule)) {
+                    if (typeof exported !== "function" ||
+                        !exported.name.endsWith("Factory")) {
+                        continue;
+                    }
+                    const factoryStorageKind = (0, ArtifactStorage_1.resolveFactoryStorageKindFromCtor)(exported);
+                    if (options.storageKind &&
+                        !(0, ArtifactStorage_1.matchesTargetStorageKind)(factoryStorageKind, options.storageKind)) {
+                        const message = (0, ArtifactRoutingReport_1.summarizeSkippedArtifacts)("factory", [
+                            (0, ArtifactRoutingReport_1.createTargetedArtifactDecision)(name, factoryStorageKind, options.storageKind),
+                        ], options.storageKind);
+                        console.warn(chalk_1.default.yellow(message));
+                        continue;
+                    }
+                    this.register(name, exported);
+                    console.log(chalk_1.default.green(`Registered factory: ${name}`));
+                }
+            }
+            catch (err) {
+                console.error(chalk_1.default.red(`Failed to import factory file: ${file}`));
+                if (err instanceof Error) {
+                    console.error(chalk_1.default.red(err.message));
+                }
+            }
+        }
+        console.log(chalk_1.default.cyanBright("\nFactory auto-discovery complete.\n"));
+    }
+    static list() {
+        return Array.from(this.registry.keys());
+    }
+    static clear() {
+        this.registry.clear();
+    }
+}
+exports.FactoryRegistry = FactoryRegistry;
+FactoryRegistry.registry = new Map();
+//# sourceMappingURL=FactoryRegistry.js.map

package/dist/cli/utils/factories/FactoryRegistry.js.map

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

package/dist/cli/utils/fileWriter.d.ts

@@ -0,0 +1,7 @@
+export declare function writeFileSafe(filePath: string, content: string): boolean;
+/**
+ * Utility: overwriteFile
+ * Forces file writing (replaces existing file).
+ */
+export declare function overwriteFile(filePath: string, content: string): boolean;
+//# sourceMappingURL=fileWriter.d.ts.map

package/dist/cli/utils/fileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWriter.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/fileWriter.ts"],"names":[],"mappings":"AAwBA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAgBxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUxE"}

package/dist/cli/utils/fileWriter.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFileSafe = writeFileSafe;
+exports.overwriteFile = overwriteFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Utility: writeFileSafe
+ * Creates directories recursively and writes the file safely.
+ * Returns true if created, false if skipped.
+ */
+function ensureParentDirectory(filePath) {
+    const dir = path_1.default.dirname(filePath);
+    if (!fs_1.default.existsSync(dir)) {
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        console.log(chalk_1.default.cyan(`Created directory: ${dir}`));
+    }
+}
+function logFileWriteError(action, filePath, err) {
+    console.error(chalk_1.default.red(`Error ${action} file: ${filePath}`));
+    if (err instanceof Error) {
+        console.error(chalk_1.default.red(`Reason: ${err.message}`));
+    }
+}
+function writeFileSafe(filePath, content) {
+    try {
+        ensureParentDirectory(filePath);
+        if (fs_1.default.existsSync(filePath)) {
+            console.log(chalk_1.default.yellow(`File already exists, skipped: ${filePath}`));
+            return false;
+        }
+        fs_1.default.writeFileSync(filePath, content, "utf8");
+        console.log(chalk_1.default.greenBright(`Created file: ${filePath}`));
+        return true;
+    }
+    catch (err) {
+        logFileWriteError("writing", filePath, err);
+        return false;
+    }
+}
+/**
+ * Utility: overwriteFile
+ * Forces file writing (replaces existing file).
+ */
+function overwriteFile(filePath, content) {
+    try {
+        ensureParentDirectory(filePath);
+        fs_1.default.writeFileSync(filePath, content, "utf8");
+        console.log(chalk_1.default.green(`Overwritten: ${filePath}`));
+        return true;
+    }
+    catch (err) {
+        logFileWriteError("overwriting", filePath, err);
+        return false;
+    }
+}
+//# sourceMappingURL=fileWriter.js.map

package/dist/cli/utils/fileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWriter.js","sourceRoot":"","sources":["../../../src/cli/utils/fileWriter.ts"],"names":[],"mappings":";;;;;AAwBA,sCAgBC;AAMD,sCAUC;AAxDD,4CAAoB;AACpB,gDAAwB;AACxB,kDAA0B;AAE1B;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,YAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAiC,EAAE,QAAgB,EAAE,GAAY;IAC1F,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,MAAM,UAAU,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9D,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,IAAI,CAAC;QACH,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEhC,IAAI,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,WAAW,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,IAAI,CAAC;QACH,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAChC,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iBAAiB,CAAC,aAAa,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cli/utils/migrations/MigrationLockStrategy.d.ts

@@ -0,0 +1,21 @@
+import type { DriverAdapter } from "../../../core/connection/DriverAdapter";
+export type SqlMigrationDriver = "mysql" | "pg" | "sqlite";
+export interface MigrationLockStrategy {
+    ensureBootstrap(db: DriverAdapter, driver: SqlMigrationDriver): Promise<void>;
+    acquire(db: DriverAdapter, owner: string): Promise<void>;
+    release(db: DriverAdapter, owner: string, outcome?: {
+        success?: boolean;
+    }): Promise<void>;
+}
+declare class NativeSqlMigrationLockStrategy implements MigrationLockStrategy {
+    ensureBootstrap(): Promise<void>;
+    acquire(db: DriverAdapter, owner: string): Promise<void>;
+    release(db: DriverAdapter, owner: string, outcome?: {
+        success?: boolean;
+    }): Promise<void>;
+}
+export declare function getMigrationLockStrategy(): MigrationLockStrategy;
+export declare function setMigrationLockStrategy(strategy: MigrationLockStrategy): void;
+export declare function resetMigrationLockStrategy(): void;
+export { NativeSqlMigrationLockStrategy };
+//# sourceMappingURL=MigrationLockStrategy.d.ts.map

package/dist/cli/utils/migrations/MigrationLockStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationLockStrategy.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/migrations/MigrationLockStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAG5E,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,CACL,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAiCD,cAAM,8BAA+B,YAAW,qBAAqB;IAC7D,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxD,OAAO,CACX,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;CAkDjB;AAID,wBAAgB,wBAAwB,IAAI,qBAAqB,CAEhE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAE9E;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,OAAO,EAAE,8BAA8B,EAAE,CAAC"}