@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/cli/commands/factoryStatus.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * factory:status
+ * Lists all registered factories and optionally shows ORM model details or a graph.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.factoryStatus = factoryStatus;
+const chalk_1 = __importDefault(require("chalk"));
+const FactoryDisplay_1 = require("../utils/factories/FactoryDisplay");
+const FactoryGraph_1 = require("../utils/factories/FactoryGraph");
+const FactoryRegistry_1 = require("../utils/factories/FactoryRegistry");
+function hasSchema(modelCtor) {
+    return (typeof modelCtor === "function" &&
+        Object.prototype.hasOwnProperty.call(modelCtor, "schema"));
+}
+function extractRelations(schema) {
+    if (!schema) {
+        return chalk_1.default.gray(FactoryDisplay_1.FACTORY_EMPTY_MARK);
+    }
+    const relations = [];
+    for (const [, def] of Object.entries(schema)) {
+        if (def.kind !== "relation") {
+            continue;
+        }
+        const rel = def;
+        relations.push(`${(0, FactoryDisplay_1.getFactoryRelationArrow)(rel.relation)} ${chalk_1.default.cyanBright(rel.model)} (${rel.relation})`);
+    }
+    return relations.length > 0
+        ? relations.join(chalk_1.default.gray(", "))
+        : chalk_1.default.gray(FactoryDisplay_1.FACTORY_EMPTY_MARK);
+}
+function getFactoryDetails(factory) {
+    const modelClass = factory.model?.name ?? "Unknown";
+    const modelInstance = new factory.model();
+    let tableName = FactoryDisplay_1.FACTORY_EMPTY_MARK;
+    let pivot = "No";
+    let relations = chalk_1.default.gray(FactoryDisplay_1.FACTORY_EMPTY_MARK);
+    if ("tableName" in modelInstance &&
+        typeof modelInstance.tableName === "string") {
+        tableName = modelInstance.tableName;
+    }
+    if (hasSchema(modelInstance.constructor)) {
+        relations = extractRelations(modelInstance.constructor.schema);
+    }
+    if (factory.constructor.name.endsWith("PivotFactory")) {
+        pivot = "Yes";
+    }
+    return { modelClass, tableName, pivot, relations };
+}
+async function factoryStatus(options, _command) {
+    console.log(chalk_1.default.cyanBright("\nEloquentJS Factory Status\n"));
+    try {
+        const factories = FactoryRegistry_1.FactoryRegistry.list();
+        if (factories.length === 0) {
+            console.log(chalk_1.default.yellow("No factories are currently registered.\n"));
+            console.log(chalk_1.default.gray("Tip: Run your app or import FactoryLoader to auto-discover factories.\n"));
+            return;
+        }
+        console.log(chalk_1.default.greenBright(`${factories.length} factories registered.\n`));
+        if (options?.graph) {
+            console.log((0, FactoryGraph_1.generateFactoryGraph)(factories));
+            return;
+        }
+        if (options?.details) {
+            const tableData = factories.map((name) => {
+                const instance = FactoryRegistry_1.FactoryRegistry.make(name);
+                const details = getFactoryDetails(instance);
+                return {
+                    Factory: name,
+                    Type: name.endsWith("PivotFactory")
+                        ? chalk_1.default.magenta("Pivot")
+                        : chalk_1.default.blue("Model"),
+                    Model: details.modelClass,
+                    Table: details.tableName,
+                    Pivot: details.pivot === "Yes" ? chalk_1.default.magenta("Yes") : chalk_1.default.gray("No"),
+                    Relations: details.relations,
+                };
+            });
+            console.table(tableData);
+            console.log(chalk_1.default.gray(FactoryDisplay_1.FACTORY_STATUS_FOOTER));
+            return;
+        }
+        const summaryData = factories.map((name) => ({
+            Factory: name,
+            Type: name.endsWith("PivotFactory")
+                ? chalk_1.default.magenta("Pivot")
+                : chalk_1.default.blue("Model"),
+            Status: chalk_1.default.green("Ready"),
+        }));
+        console.table(summaryData);
+        console.log(chalk_1.default.gray(FactoryDisplay_1.FACTORY_STATUS_FOOTER));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("Failed to fetch factory status."));
+        if (error instanceof Error) {
+            console.error(chalk_1.default.red(error.message));
+        }
+    }
+}
+//# sourceMappingURL=factoryStatus.js.map

package/dist/cli/commands/factoryStatus.js.map

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

package/dist/cli/commands/makeController.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Command: eloquent make:controller
+ * Generates a controller class with REST methods (index, show, store, update, destroy)
+ * Automatically linked to the Model & Service layers
+ */
+export declare function makeController(modelName: string, options?: {
+    soft?: boolean;
+    test?: boolean;
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=makeController.d.ts.map

package/dist/cli/commands/makeController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeController.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/makeController.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,iBAqDlE"}

package/dist/cli/commands/makeController.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeController = makeController;
+const TemplateEngine_1 = require("../utils/TemplateEngine");
+const fileWriter_1 = require("../utils/fileWriter");
+const ScaffoldGeneratorSupport_1 = require("../utils/ScaffoldGeneratorSupport");
+/**
+ * Command: eloquent make:controller
+ * Generates a controller class with REST methods (index, show, store, update, destroy)
+ * Automatically linked to the Model & Service layers
+ */
+async function makeController(modelName, options = {}) {
+    try {
+        const isTest = !!options.test;
+        const softDelete = !!options.soft;
+        const forceWrite = !!options.force;
+        const artifact = (0, ScaffoldGeneratorSupport_1.resolveScaffoldArtifact)("controller", modelName, { test: isTest });
+        const routeName = (0, ScaffoldGeneratorSupport_1.camelCaseScaffoldName)(artifact.modelClassName);
+        const serviceImportPath = `../services/${artifact.modelClassName}Service`;
+        const modelImportPath = isTest
+            ? `../database/models/${artifact.modelClassName}`
+            : `../models/${artifact.modelClassName}`;
+        const softDeleteBlock = softDelete
+            ? `
+  // PATCH /${routeName}/:id/restore
+  async restore(req: Request, res: Response): Promise<void> {
+    try {
+      const id = req.params?.id as unknown as string | number | undefined;
+      if (id === undefined) {
+        res.status(400).json({ error: "Missing id" });
+        return;
+      }
+      await this.service.restore(id);
+      res.json({ message: "${artifact.modelClassName} restored successfully" });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      res.status(400).json({ error: message });
+    }
+  }
+`
+            : "";
+        const template = TemplateEngine_1.TemplateEngine.load("controller");
+        const rendered = TemplateEngine_1.TemplateEngine.render(template, {
+            PascalCase: artifact.modelClassName,
+            camelCase: routeName,
+            serviceImportPath,
+            modelImportPath,
+            softDeleteBlock,
+        });
+        const created = forceWrite
+            ? (0, fileWriter_1.overwriteFile)(artifact.outputPath, rendered)
+            : (0, fileWriter_1.writeFileSafe)(artifact.outputPath, rendered);
+        if (created) {
+            (0, ScaffoldGeneratorSupport_1.logScaffoldCreated)("controller", artifact.relativePath);
+        }
+    }
+    catch (err) {
+        (0, ScaffoldGeneratorSupport_1.logScaffoldFailure)("controller", modelName, err);
+    }
+}
+//# sourceMappingURL=makeController.js.map

package/dist/cli/commands/makeController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeController.js","sourceRoot":"","sources":["../../../src/cli/commands/makeController.ts"],"names":[],"mappings":";;AAcA,wCAuDC;AArED,4DAAyD;AACzD,oDAAmE;AACnE,gFAK2C;AAE3C;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,UAA+D,EAAE;IAEjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAA,kDAAuB,EAAC,YAAY,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,MAAM,SAAS,GAAG,IAAA,gDAAqB,EAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAEjE,MAAM,iBAAiB,GAAG,eAAe,QAAQ,CAAC,cAAc,SAAS,CAAC;QAC1E,MAAM,eAAe,GAAG,MAAM;YAC5B,CAAC,CAAC,sBAAsB,QAAQ,CAAC,cAAc,EAAE;YACjD,CAAC,CAAC,aAAa,QAAQ,CAAC,cAAc,EAAE,CAAC;QAE3C,MAAM,eAAe,GAAG,UAAU;YAChC,CAAC,CAAC;cACM,SAAS;;;;;;;;;6BASM,QAAQ,CAAC,cAAc;;;;;;CAMnD;YACK,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,QAAQ,GAAG,+BAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,+BAAc,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC/C,UAAU,EAAE,QAAQ,CAAC,cAAc;YACnC,SAAS,EAAE,SAAS;YACpB,iBAAiB;YACjB,eAAe;YACf,eAAe;SAChB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,IAAA,0BAAa,EAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;YAC9C,CAAC,CAAC,IAAA,0BAAa,EAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEjD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAA,6CAAkB,EAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,6CAAkB,EAAC,YAAY,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/cli/commands/makeFactory.d.ts

@@ -0,0 +1,14 @@
+type MakeFactoryOptions = {
+    model?: string;
+    overwrite?: boolean;
+    test?: boolean;
+    force?: boolean;
+    mongo?: boolean;
+};
+/**
+ * EloquentJS ORM - make:factory
+ * Generates factories for models and their pivot/morph relations.
+ */
+export declare function makeFactory(factoryName: string, options?: MakeFactoryOptions): Promise<void>;
+export {};
+//# sourceMappingURL=makeFactory.d.ts.map

package/dist/cli/commands/makeFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeFactory.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/makeFactory.ts"],"names":[],"mappings":"AASA,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAqCF;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Nf"}

package/dist/cli/commands/makeFactory.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFactory = makeFactory;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const PathMap_1 = require("../utils/PathMap");
+const TemplateEngine_1 = require("../utils/TemplateEngine");
+const fileWriter_1 = require("../utils/fileWriter");
+const ModelIntrospector_1 = require("../utils/ModelIntrospector");
+const ImportResolver_1 = require("../utils/ImportResolver");
+function ensureDirSync(dir) {
+    if (!fs_1.default.existsSync(dir))
+        fs_1.default.mkdirSync(dir, { recursive: true });
+}
+/**
+ * EloquentJS ORM - make:factory
+ * Generates factories for models and their pivot/morph relations.
+ */
+async function makeFactory(factoryName, options = {}) {
+    try {
+        console.log(chalk_1.default.cyan(`\nGenerating factory: ${factoryName}...`));
+        const FactoryName = factoryName.endsWith("Factory")
+            ? factoryName
+            : `${factoryName}Factory`;
+        const ModelName = options.model ?? factoryName.replace(/Factory$/i, "");
+        // Reflect schema using ModelIntrospector.
+        const analysisRaw = (await ModelIntrospector_1.ModelIntrospector.analyze(ModelName, {
+            test: !!options.test,
+        }));
+        if (!analysisRaw) {
+            console.warn(chalk_1.default.yellow(`WARN: No metadata found for model "${ModelName}". Aborting.`));
+            return;
+        }
+        const analysis = analysisRaw;
+        const fields = analysis.fields ?? [];
+        const relations = analysis.relations ?? [];
+        const features = analysis.features ?? {};
+        const shouldOverwrite = options.overwrite === true || options.force === true;
+        // Map field types to faker paths.
+        const fakerMap = {
+            string: "person.fullName()",
+            text: "lorem.sentence()",
+            email: "internet.email()",
+            password: "internet.password()",
+            int: "number.int()",
+            float: "number.float()",
+            decimal: "number.float()",
+            boolean: "datatype.boolean()",
+            json: "datatype.json()",
+            timestamp: "date.recent()",
+            uuid: "string.uuid()",
+        };
+        const fakeFields = fields.map((f) => ({
+            name: f.name,
+            fakerPath: fakerMap[String(f.type ?? "").toLowerCase()] ?? "lorem.word()",
+        }));
+        // Load the main factory template and fail early if it is missing.
+        const templatePath = PathMap_1.PathMap.template("factory");
+        if (!fs_1.default.existsSync(templatePath)) {
+            console.error(chalk_1.default.red(`ERROR: Factory template not found at: ${templatePath}`));
+            return;
+        }
+        const templateContent = fs_1.default.readFileSync(templatePath, "utf8");
+        // Build relation imports and example usage snippets for template.
+        const relationImports = new Set();
+        const relationExamples = [];
+        for (const rel of relations) {
+            if (rel.target && typeof rel.target === "string") {
+                const candidateFactoryName = `${rel.target}Factory`;
+                const candidateImportPath = `../factories/${candidateFactoryName}`;
+                relationImports.add(`import { ${candidateFactoryName} } from "${candidateImportPath}";`);
+            }
+            const relatedName = String(rel.target ?? "Related");
+            switch (rel.type) {
+                case "belongsTo":
+                    relationExamples.push(`// create ${ModelName} with a new ${relatedName}: ${FactoryName}.with('${rel.name}', ${relatedName}Factory).create();`);
+                    break;
+                case "hasMany":
+                    relationExamples.push(`// create ${ModelName} and 3 ${relatedName}: ${FactoryName}.with('${rel.name}', ${relatedName}Factory, 3).create();`);
+                    break;
+                case "belongsToMany":
+                    relationExamples.push(`// attach existing ${relatedName}: const r = await ${relatedName}Factory.create(); await my${ModelName}.${rel.name}().attach([r.id]);`);
+                    break;
+                case "morphTo":
+                case "morphMany":
+                    relationExamples.push(`// morph example: await ${relatedName}Factory.morphFor(parentInstance, '${rel.name}').create();`);
+                    break;
+                default:
+                    relationExamples.push(`// relation ${rel.name} (${String(rel.type)})`);
+            }
+        }
+        const factoriesDir = PathMap_1.PathMap.factories(!!options.test);
+        const outputPath = path_1.default.join(factoriesDir, `${FactoryName}.ts`);
+        const packageImportPath = ImportResolver_1.ImportResolver.publicApiImportPath(outputPath);
+        const renderData = {
+            ModelName,
+            FactoryName,
+            fields: fakeFields,
+            hasRelations: relations.length > 0,
+            relations,
+            relationImports: Array.from(relationImports),
+            relationExamples,
+            features,
+            packageImportPath,
+        };
+        let rendered = TemplateEngine_1.TemplateEngine.render(templateContent, renderData);
+        if (options.test) {
+            rendered = rendered.replace(/from \"\.\.\/\.\.\/models\//g, 'from "../models/');
+        }
+        // Write the main factory file using writeFileSafe / overwriteFile.
+        ensureDirSync(factoriesDir);
+        if (fs_1.default.existsSync(outputPath)) {
+            if (shouldOverwrite) {
+                (0, fileWriter_1.overwriteFile)(outputPath, rendered);
+            }
+            else {
+                console.log(chalk_1.default.yellow(`INFO: Factory file already exists: ${outputPath}. Use overwrite option to replace.`));
+            }
+        }
+        else {
+            (0, fileWriter_1.writeFileSafe)(outputPath, rendered);
+        }
+        // Generate pivot factories automatically.
+        for (const rel of relations) {
+            if (rel.isPivot && rel.target && typeof rel.target === "string") {
+                const left = ModelName;
+                const right = rel.target;
+                const pivotTable = rel.pivotTable ??
+                    [left.toLowerCase(), right.toLowerCase()].sort().join("_") + "_pivot";
+                const pivotFactoryName = `${left}${right}PivotFactory`;
+                const pivotTemplatePath = PathMap_1.PathMap.template("pivot-factory");
+                if (!fs_1.default.existsSync(pivotTemplatePath)) {
+                    console.warn(chalk_1.default.yellow(`WARN: Pivot template not found at: ${pivotTemplatePath} - skipping pivot ${pivotTable}.`));
+                    continue;
+                }
+                const foreignKey = typeof rel.foreignKey === "string"
+                    ? rel.foreignKey
+                    : `${left.toLowerCase()}_id`;
+                const relatedKey = typeof rel.relatedKey === "string"
+                    ? rel.relatedKey
+                    : `${right.toLowerCase()}_id`;
+                const pivotOutputPath = path_1.default.join(factoriesDir, `${pivotFactoryName}.ts`);
+                const pivotPackageImportPath = ImportResolver_1.ImportResolver.publicApiImportPath(pivotOutputPath);
+                const pivotRenderData = {
+                    PivotFactoryName: pivotFactoryName,
+                    pivotTable,
+                    foreignKey,
+                    relatedKey,
+                    packageImportPath: pivotPackageImportPath,
+                };
+                const pivotRendered = TemplateEngine_1.TemplateEngine.render(fs_1.default.readFileSync(pivotTemplatePath, "utf8"), pivotRenderData);
+                if (fs_1.default.existsSync(pivotOutputPath)) {
+                    if (shouldOverwrite) {
+                        (0, fileWriter_1.overwriteFile)(pivotOutputPath, pivotRendered);
+                    }
+                    else {
+                        console.log(chalk_1.default.yellow(`INFO: Pivot factory already exists: ${pivotOutputPath}`));
+                    }
+                }
+                else {
+                    (0, fileWriter_1.writeFileSafe)(pivotOutputPath, pivotRendered);
+                }
+            }
+        }
+        console.log(chalk_1.default.greenBright(`\nFactory generation complete for model: ${ModelName}\n`));
+    }
+    catch (err) {
+        console.error(chalk_1.default.red("ERROR: Factory generation failed"));
+        if (err instanceof Error) {
+            console.error(chalk_1.default.red(err.message));
+            if (err.stack)
+                console.error(chalk_1.default.gray(err.stack));
+        }
+        else {
+            console.error(chalk_1.default.red(String(err)));
+        }
+    }
+}
+//# sourceMappingURL=makeFactory.js.map

package/dist/cli/commands/makeFactory.js.map

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

package/dist/cli/commands/makeMigration.d.ts

@@ -0,0 +1,18 @@
+import { type ConnectionName } from "../../core/connection/ConnectionFactory";
+interface MigrationOptions {
+    test?: boolean;
+    exit?: boolean;
+    pivotSeparate?: boolean;
+    connectionName?: ConnectionName;
+}
+/**
+ * make:migration (v4.1)
+ *
+ * - Baseline CREATE migrations are generated once.
+ * - UPDATE migrations are append-only.
+ * - Existing migration files are never deleted automatically.
+ * - Duplicate generated SQL bodies are skipped.
+ */
+export declare function makeMigration(modelName: string, options?: MigrationOptions): Promise<void>;
+export {};
+//# sourceMappingURL=makeMigration.d.ts.map

package/dist/cli/commands/makeMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeMigration.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/makeMigration.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,yCAAyC,CAAC;AAIjD,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAoND;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0bf"}