@zintrust/core 0.1.0

package/src/cli/scaffolding/ModelGenerator.js

@@ -0,0 +1,249 @@
+/**
+ * ModelGenerator - Generate ORM model files
+ * Creates type-safe model modules with relationships and validation
+ */
+import { FileGenerator } from '../scaffolding/FileGenerator';
+import { CommonUtils } from '../../common/index';
+import { Logger } from '../../config/logger';
+import * as path from 'node:path';
+/**
+ * Validate model options
+ */
+export function validateOptions(options) {
+    const errors = [];
+    if (/^[A-Z][a-zA-Z\d]*$/.test(options.name) === false) {
+        errors.push(`Invalid model name '${options.name}'. Must start with uppercase letter.`);
+    }
+    if (options.modelPath === '' || FileGenerator.directoryExists(options.modelPath) === false) {
+        errors.push(`Models directory does not exist: ${options.modelPath}`);
+    }
+    if (options.fields !== undefined && options.fields.length > 0) {
+        const invalidFields = options.fields.filter((f) => f.name === '' || f.type === '');
+        if (invalidFields.length > 0) {
+            errors.push(`Invalid fields: All fields must have name and type`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Generate model file
+ */
+export async function generateModel(options) {
+    const validation = validateOptions(options);
+    if (validation.valid === false) {
+        return {
+            success: false,
+            modelName: options.name,
+            modelFile: '',
+            message: `Validation failed: ${validation.errors.join(', ')}`,
+        };
+    }
+    try {
+        const modelContent = buildModelCode(options);
+        const modelFile = path.join(options.modelPath, `${options.name}.ts`);
+        const created = FileGenerator.writeFile(modelFile, modelContent);
+        if (created === false) {
+            return {
+                success: false,
+                modelName: options.name,
+                modelFile,
+                message: `Failed to create model file`,
+            };
+        }
+        Logger.info(`✅ Generated model: ${options.name}`);
+        return {
+            success: true,
+            modelName: options.name,
+            modelFile,
+            message: `Model ${options.name} created successfully`,
+        };
+    }
+    catch (error) {
+        Logger.error('Model generation failed', error);
+        return {
+            success: false,
+            modelName: options.name,
+            modelFile: '',
+            message: `Error: ${error.message}`,
+        };
+    }
+}
+/**
+ * Build model TypeScript code
+ */
+function buildModelCode(options) {
+    const table = options.table ?? CommonUtils.toSnakeCase(options.name) + 's';
+    const fillable = options.fillable ?? (options.fields ? options.fields.map((f) => f.name) : []);
+    const hidden = options.hidden ?? [];
+    let code = `/**
+ * ${options.name} Model
+ * Auto-generated model file
+ */
+
+import { Model, IModel } from '../../orm/Model';
+
+export const ${options.name} = Object.freeze(
+  Model.define({
+  table: '${table}',
+  fillable: [${fillable.map((f) => `'${f}'`).join(', ')}],
+  hidden: [${hidden.map((f) => `'${f}'`).join(', ')}],
+  timestamps: ${options.timestamps !== false},
+  casts: {
+`;
+    // Add field casts
+    code += buildCasts(options.fields);
+    code += `
+  },
+}, {
+`;
+    // Add relationships
+    code += buildRelationships(options.relationships);
+    // Add soft delete if enabled
+    code += buildSoftDelete(options.softDelete);
+    code += `})
+);
+`;
+    return code;
+}
+/**
+ * Build field casts
+ */
+function buildCasts(fields) {
+    if (fields === undefined)
+        return '';
+    const casts = fields
+        .filter((f) => f.type === 'boolean' || f.type === 'json' || f.type === 'datetime')
+        .map((f) => {
+        const castType = (() => {
+            if (f.type === 'boolean')
+                return "'boolean'";
+            if (f.type === 'json')
+                return "'json'";
+            return "'datetime'";
+        })();
+        return `    ${f.name}: ${castType},`;
+    });
+    return casts.join('\n');
+}
+/**
+ * Build relationship methods
+ */
+function buildRelationships(relationships) {
+    if (!relationships || relationships.length === 0)
+        return '';
+    let code = '';
+    for (const rel of relationships) {
+        const foreignKey = rel.foreignKey ?? `${CommonUtils.toSnakeCase(rel.model)}_id`;
+        const method = CommonUtils.camelCase(rel.model);
+        if (rel.type === 'hasOne') {
+            code += `  /**
+   * Get associated ${rel.model}
+   */
+  async ${method}(model: IModel) {
+    return model.hasOne(${rel.model}, '${foreignKey}');
+  },
+
+`;
+        }
+        else if (rel.type === 'hasMany') {
+            const plural = method + 's';
+            code += `  /**
+   * Get associated ${rel.model} records
+   */
+  async ${plural}(model: IModel) {
+    return model.hasMany(${rel.model}, '${foreignKey}');
+  },
+
+`;
+        }
+        else if (rel.type === 'belongsTo') {
+            code += `  /**
+   * Get parent ${rel.model}
+   */
+  async ${method}(model: IModel) {
+    return model.belongsTo(${rel.model}, '${foreignKey}');
+  },
+
+`;
+        }
+    }
+    return code;
+}
+/**
+ * Build soft delete methods
+ */
+function buildSoftDelete(softDelete) {
+    if (softDelete !== true)
+        return '';
+    return `  /**
+   * Soft delete this model
+   */
+  async softDelete(model: IModel): Promise<void> {
+    model.setAttribute('deleted_at', new Date().toISOString());
+    await model.save();
+  },
+`;
+}
+/**
+ * Get common field types
+ */
+export function getCommonFieldTypes() {
+    return ['string', 'integer', 'float', 'boolean', 'text', 'datetime', 'json'];
+}
+/**
+ * Generate common model fields (User example)
+ */
+export function getUserFields() {
+    return [
+        { name: 'id', type: 'string', unique: true },
+        { name: 'name', type: 'string' },
+        { name: 'email', type: 'string', unique: true },
+        { name: 'password', type: 'string' },
+        { name: 'email_verified_at', type: 'datetime', nullable: true },
+        { name: 'remember_token', type: 'string', nullable: true },
+        { name: 'created_at', type: 'datetime' },
+        { name: 'updated_at', type: 'datetime' },
+    ];
+}
+/**
+ * Generate common model fields (Post example)
+ */
+export function getPostFields() {
+    return [
+        { name: 'id', type: 'string', unique: true },
+        { name: 'user_id', type: 'string' },
+        { name: 'title', type: 'string' },
+        { name: 'content', type: 'text' },
+        { name: 'published_at', type: 'datetime', nullable: true },
+        { name: 'created_at', type: 'datetime' },
+        { name: 'updated_at', type: 'datetime' },
+    ];
+}
+/**
+ * Generate common model fields (Order example)
+ */
+export function getOrderFields() {
+    return [
+        { name: 'id', type: 'string', unique: true },
+        { name: 'user_id', type: 'string' },
+        { name: 'total', type: 'float' },
+        { name: 'status', type: 'string' },
+        { name: 'metadata', type: 'json', nullable: true },
+        { name: 'created_at', type: 'datetime' },
+        { name: 'updated_at', type: 'datetime' },
+    ];
+}
+/**
+ * ModelGenerator creates type-safe ORM models
+ */
+export const ModelGenerator = Object.freeze({
+    validateOptions,
+    generateModel,
+    getCommonFieldTypes,
+    getUserFields,
+    getPostFields,
+    getOrderFields,
+});

package/src/cli/scaffolding/ProjectScaffolder.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Project Scaffolder - New project generation
+ * Handles directory structure and boilerplate file creation
+ */
+export interface ProjectScaffoldOptions {
+    name: string;
+    force?: boolean;
+    overwrite?: boolean;
+    template?: string;
+    port?: number;
+    author?: string;
+    description?: string;
+    git?: boolean;
+    install?: boolean;
+    database?: string;
+    driver?: string;
+}
+export type ProjectOptions = ProjectScaffoldOptions;
+export interface ProjectTemplate {
+    name: string;
+    description: string;
+    directories: string[];
+    files: Record<string, string>;
+}
+export interface ProjectScaffoldResult {
+    success: boolean;
+    projectPath: string;
+    filesCreated: number;
+    directoriesCreated: number;
+    message: string;
+    error?: Error;
+}
+export interface IProjectScaffolder {
+    prepareContext(options: ProjectScaffoldOptions): void;
+    getVariables(): Record<string, unknown>;
+    getTemplateInfo(templateName?: string): ProjectTemplate | undefined;
+    getProjectPath(): string;
+    projectDirectoryExists(): boolean;
+    createDirectories(): number;
+    createFiles(options?: ProjectScaffoldOptions): number;
+    createConfigFile(): boolean;
+    createEnvFile(): boolean;
+    scaffold(options: ProjectScaffoldOptions): Promise<ProjectScaffoldResult>;
+}
+export declare function getAvailableTemplates(): string[];
+export declare function getTemplate(name: string): ProjectTemplate | undefined;
+export declare function validateOptions(options: ProjectScaffoldOptions): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Plain-function scaffolder creator (replaces the function-object factory).
+ */
+export declare function createProjectScaffolder(projectPath?: string): IProjectScaffolder;
+export declare function scaffoldProject(projectPath: string, options: ProjectScaffoldOptions): Promise<ProjectScaffoldResult>;
+/**
+ * Sealed namespace for ProjectScaffolder
+ */
+export declare const ProjectScaffolder: Readonly<{
+    create: typeof createProjectScaffolder;
+    getAvailableTemplates: typeof getAvailableTemplates;
+    getTemplate: typeof getTemplate;
+    validateOptions: typeof validateOptions;
+    scaffold: typeof scaffoldProject;
+}>;
+//# sourceMappingURL=ProjectScaffolder.d.ts.map

package/src/cli/scaffolding/ProjectScaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AA4TD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAMrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AAsID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}