@ecopex/ecopex-framework 1.0.0 → 1.0.2

package/index.js

@@ -0,0 +1,5 @@
+const { start: fastifyStart } = require('./libraries/fastify');
+
+module.exports = {
+    fastifyStart
+}

package/libraries/fastify.js

@@ -0,0 +1,120 @@
+require('dotenv').config(); 
+
+const fastify = require('fastify')({
+    logger: {
+        level: process.env.LOG_LEVEL || 'info'
+    }
+});
+
+const { loadRoutes } = require('@root/utils/routeLoader');
+const Middleware = require('@root/utils/middleware');
+
+// Register plugins
+async function registerPlugins() {
+    // Set error handler first, before any plugins
+    fastify.setErrorHandler(Middleware.errorHandler);
+    fastify.setNotFoundHandler(Middleware.errorNotFoundHandler);
+    
+    // CORS plugin
+    await fastify.register(require('@fastify/cors'), {
+        origin: process.env.CORS_ORIGIN || '*',
+        credentials: true
+    });
+
+    // Swagger documentation
+    const swaggerConfig = require('@root/config/swagger/admin');
+    
+    await fastify.register(require('@fastify/swagger'), swaggerConfig.swagger);
+
+    // Swagger UI
+    await fastify.register(require('@fastify/swagger-ui'), swaggerConfig.swaggerUi);
+
+    // Fastify Multipart plugin
+    fastify.register(require('@fastify/multipart'), {
+        attachFieldsToBody: true, // Optional: attaches fields to the body object
+        throwFileSizeLimit: true, // Optional: throws an error if the file size limit is exceeded
+        limits: {
+        fieldNameSize: 100, // Max field name size in bytes
+        fieldSize: 100,     // Max field value size in bytes
+        fields: 10,         // Max number of non-file fields
+        fileSize: 1000000,  // For multipart forms, the max file size in bytes
+        files: 1,           // Max number of file fields
+        headerPairs: 2000,  // Max number of header key=>value pairs
+        parts: 1000         // For multipart forms, the max number of parts (fields + files)
+        }
+    });
+
+    // Register other middleware
+    fastify.addHook('preHandler', Middleware.languageDetection());
+    fastify.addHook('preHandler', Middleware.responseFormatter());
+
+    // Health check endpoint
+    fastify.get('/health', async (request, reply) => {
+        return { 
+        status: 'ok', 
+        service: 'admin',
+        timestamp: new Date().toISOString(),
+        uptime: process.uptime(),
+        pid: process.pid
+        };
+    });
+}
+
+// Load admin routes, common routes, and auto routes
+async function loadAdminRoutes() {
+    try {
+        // Load admin routes
+        await loadRoutes(fastify, __dirname + '/../routes/admin', true, 'admin');
+    } catch (error) {
+        console.error('Error loading admin routes:', error);
+        process.exit(1);
+    }
+}
+
+// Start admin service
+async function start() {
+    try {
+
+        // Register plugins
+        await registerPlugins();
+
+        // Load admin routes
+        await loadAdminRoutes();
+
+        // Start server
+        const port = process.env.PORT || 3001;
+        const host = process.env.HOST || '127.0.0.1';
+        
+        fastify.listen({ port, host });
+
+    } catch (error) {
+        console.error('Error starting admin service:', error);
+        process.exit(1);
+    }
+}
+
+// Graceful shutdown
+process.on('SIGINT', async () => {
+    try {
+        await fastify.close();
+        process.exit(0);
+    } catch (error) {
+        console.error('Error during admin service shutdown:', error);
+        process.exit(1);
+    }
+});
+
+process.on('SIGTERM', async () => {
+    try {
+        await fastify.close();
+        process.exit(0);
+    } catch (error) {
+        console.error('Error during admin service shutdown:', error);
+        process.exit(1);
+    }
+});
+
+// Start the admin service
+module.exports = {
+    start
+}

package/libraries/knex.js

@@ -1,6 +1,6 @@
 const knex = require('knex');
 
-const config = require('@root/config/database');
+const config = require('../config/database');
 
 const db = knex(config[process.env.NODE_ENV || 'development']);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopex/ecopex-framework",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Javascript Framework for API and Admin Panel",
   "main": "ecosystem.config.js",
   "scripts": {
@@ -13,7 +13,11 @@
     "prod": "pm2 start ecosystem.config.js --env production",
     "migrate": "knex migrate:latest",
     "migrate:rollback": "knex migrate:rollback",
-    "seed": "knex seed:run"
+    "seed": "knex seed:run",
+    "npm:publish": "npm version patch && npm publish"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.958.0",

package/stores/base.js

@@ -1,4 +1,4 @@
-const knex = require('@root/libraries/knex');
+const knex = require('../libraries/knex');
 
 module.exports = class StoreModel {
     constructor(name = 'store_model', primary_key = 'id', schema = {}) {

package/utils/jsonRouteLoader.js

@@ -1,8 +1,8 @@
 const fs = require('fs');
 const path = require('path');
-const handlers = require('@root/routes/auto/handler');
-const general = require('@root/libraries/general');
-const { add_model } = require('@root/stores');
+const handlers = require('../routes/auto/handler');
+const general = require('../libraries/general');
+const { add_model } = require('../stores');
 
 /**
  * JSON Route Loader

package/utils/middleware.js

@@ -1,5 +1,5 @@
 const i18n = require('./i18n');
-const db = require('@root/libraries/knex');
+const db = require('../libraries/knex');
 /**
  * Middleware utilities for Fastify
  */

package/utils/routeLoader.js

@@ -1,7 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const JsonRouteLoader = require('./jsonRouteLoader');
-const general = require('@root/libraries/general');
+const general = require('../libraries/general');
 
 /**
  * Automatically loads routes from the routes directory

package/.env

@@ -1,73 +0,0 @@
-# ===========================================
-# SB System Environment Configuration
-# ===========================================
-
-# Application Environment
-NODE_ENV=development
-LOG_LEVEL=error
-
-# Server Configuration
-HOST=0.0.0.0
-API_PORT=3000
-ADMIN_PORT=3001
-
-# Database Configuration
-DB_HOST=127.0.0.1
-DB_PORT=3306
-DB_USER=root
-DB_PASSWORD=Gs1905ua
-DB_NAME=ecommerce
-
-# Alternative: Use DATABASE_URL for production
-# DATABASE_URL=mysql://username:password@host:port/database
-
-# CORS Configuration
-CORS_ORIGIN=*
-
-# PM2 Process Management
-API_INSTANCES=1
-API_EXEC_MODE=fork
-ADMIN_INSTANCES=1
-ADMIN_EXEC_MODE=fork
-
-# Internationalization
-DEFAULT_LOCALE=en
-SUPPORTED_LOCALES=en,tr,es
-
-# Security (for production)
-# JWT_SECRET=your_jwt_secret_here
-# BCRYPT_ROUNDS=12
-# SESSION_SECRET=your_session_secret_here
-
-# Redis (for caching/sessions)
-# REDIS_HOST=localhost
-# REDIS_PORT=6379
-# REDIS_PASSWORD=
-
-# Email Configuration (for notifications)
-# SMTP_HOST=smtp.gmail.com
-# SMTP_PORT=587
-# SMTP_USER=your_email@gmail.com
-# SMTP_PASS=your_app_password
-# FROM_EMAIL=noreply@yoursystem.com
-
-# File Upload Configuration
-# UPLOAD_MAX_SIZE=10485760
-# UPLOAD_ALLOWED_TYPES=image/jpeg,image/png,image/gif,application/pdf
-
-# Rate Limiting
-# RATE_LIMIT_WINDOW_MS=900000
-# RATE_LIMIT_MAX_REQUESTS=100
-
-# Logging
-# LOG_FILE_PATH=./logs/app.log
-# LOG_MAX_SIZE=10m
-# LOG_MAX_FILES=5
-
-# Monitoring
-# HEALTH_CHECK_INTERVAL=30000
-# METRICS_ENABLED=true
-
-# Development Tools
-# DEBUG=sb_system:*
-# NODE_OPTIONS=--max-old-space-size=4096

package/database/migrations/20240000135243_timezones.js

@@ -1,22 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('timezones', function(table) {
-        // Primary key
-        table.increments('timezone_id').primary();
-        table.string('name', 100).notNullable();
-        table.string('code', 100).notNullable();
-        table.string('offset', 100).notNullable();
-        table.string('gmt', 100).notNullable();
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-    return knex.schema.dropTable('timezones');
-};

package/database/migrations/20240000135244_countries.js

@@ -1,23 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('countries', function(table) {
-        // Primary key
-        table.increments('country_id').primary();
-        table.string('name', 100).notNullable();
-        table.string('code', 100).notNullable();
-        table.string('iso_code', 100).notNullable();
-        table.string('phone_code', 100).notNullable();
-        table.string('flag', 100).notNullable();
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-    return knex.schema.dropTable('countries');
-};

package/database/migrations/20240000135244_create_admins_table.js

@@ -1,66 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-  return knex.schema.createTable('admins', function(table) {
-    // Primary key
-    table.increments('admin_id').primary();
-    table.integer('country_id').unsigned().references('country_id').inTable('countries');
-    
-    // Basic admin information
-    table.string('firstname', 100).nullable();
-    table.string('lastname', 100).nullable();
-    table.string('username', 100).notNullable().unique();
-    table.string('email', 255).nullable().unique();
-    table.string('password', 255).notNullable();
-    table.enum('role', ['admin', 'manager']).defaultTo('manager');
-    
-    // Two-factor authentication fields
-    table.boolean('two_factor_enabled').defaultTo(false);
-    table.string('two_factor_secret', 32).nullable(); // TOTP secret
-    table.string('phone_number', 20).nullable();
-    table.boolean('phone_verified').defaultTo(false);
-    table.boolean('email_verified').defaultTo(false);
-    
-    // Login security
-    table.integer('login_attempts').defaultTo(0);
-    table.timestamp('locked_until').nullable();
-    
-    // Password security
-    table.timestamp('password_changed_at').nullable();
-    table.string('password_reset_token', 255).nullable();
-    
-    // Email verification
-    table.string('email_verification_token', 255).nullable();
-    
-    // Phone verification
-    table.string('phone_verification_code', 10).nullable();
-
-    // Address information
-    table.string('address', 255).nullable();
-    table.string('city', 100).nullable();
-    table.string('state', 100).nullable();
-    table.string('zip', 20).nullable();
-    
-    // Status and timestamps
-    table.boolean('is_active').defaultTo(true);
-    
-    // Audit timestamps
-    table.timestamps(true, true); // created_at and updated_at
-    
-    // Indexes for performance
-    table.index(['role']);
-    table.index(['is_active']);
-    table.index(['two_factor_enabled']);
-    table.index(['created_at']);
-  });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-  return knex.schema.dropTable('admins');
-};

package/database/migrations/20240000135244_currencies.js

@@ -1,21 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('currencies', function(table) {
-        // Primary key
-        table.increments('currency_id').primary();
-        table.string('name', 100).notNullable();
-        table.string('code', 100).notNullable();
-        table.string('symbol', 100).notNullable();
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-    return knex.schema.dropTable('currencies');
-};

package/database/migrations/20240000135244_languages.js

@@ -1,21 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('languages', function(table) {
-        // Primary key
-        table.increments('language_id').primary();
-        table.string('name', 100).notNullable();
-        table.string('code', 100).notNullable();
-        table.string('flag', 100).notNullable();
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-    return knex.schema.dropTable('languages');
-};

package/database/migrations/20240000135244_taxes.js

@@ -1,10 +0,0 @@
-
-exports.up = knex =>
-    knex.schema.createTable('taxes', table => {
-        table.increments('tax_id').primary();
-        table.string('name').notNullable();
-        table.decimal('rate', 5, 2).notNullable();
-    });
-
-exports.down = knex =>
-    knex.schema.dropTable('taxes');

package/database/migrations/20240000135245_sites.js

@@ -1,37 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('sites', function(table) {
-        table.increments('site_id').primary();
-        table.integer('admin_id').unsigned().references('admin_id').inTable('admins');
-        table.integer('currency_id').unsigned().references('currency_id').inTable('currencies');
-        table.integer('timezone_id').unsigned().references('timezone_id').inTable('timezones');
-        table.integer('language_id').unsigned().references('language_id').inTable('languages');
-        table.integer('country_id').unsigned().references('country_id').inTable('countries');
-        table.integer('tax_id').unsigned().references('tax_id').inTable('taxes');
-        table.string('name', 100).notNullable();
-        table.string('domain', 100).notNullable().unique();
-        table.string('logo', 100).notNullable();
-        table.string('favicon', 100).notNullable();
-        table.string('description', 100).notNullable();
-        table.string('keywords', 100).notNullable();
-        table.boolean('is_active').defaultTo(true);
-        table.datetime('expires_at').notNullable();
-        table.timestamps(true, true);
-        table.index(['admin_id'], 'site_admin_id_index');
-        table.index(['name'], 'site_name_index');
-        table.index(['domain'], 'site_domain_index');
-        table.index(['created_at'], 'site_created_at_index');
-        table.index(['updated_at'], 'site_updated_at_index');
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-    return knex.schema.dropTable('sites');
-};

package/database/migrations/20240000135246_payment_methods.js

@@ -1,33 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = knex => knex.schema.createTable('payment_methods', function(table) {
-        // Primary key
-        table.increments('payment_method_id').primary();
-        table.integer('site_id').unsigned().references('site_id').inTable('sites');
-        table.integer('currency_id').unsigned().references('currency_id').inTable('currencies');
-        table.string('logo').defaultTo(null);
-        table.string('name').notNullable();
-        table.string('code').unique().notNullable();
-        table.string('provider').defaultTo(null);
-        table.string('api_key').defaultTo(null);
-        table.string('api_secret').defaultTo(null);
-        table.string('api_url').defaultTo(null);
-        table.string('api_version').defaultTo(null);
-        table.boolean('is_active').defaultTo(true);
-        table.timestamps(true, true);
-    }).createTable('payment_method_translations', table => {
-        table.increments('payment_method_translation_id').primary();
-        table.integer('payment_method_id').unsigned().references('payment_method_id').inTable('payment_methods').onDelete('CASCADE');
-        table.integer('language_id').unsigned().references('language_id').inTable('languages');
-        table.string('description').notNullable();
-    });
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = knex =>
-    knex.schema.dropTable('payment_method_translations')
-        .dropTable('payment_methods');

package/database/migrations/20251016113547_devices.js

@@ -1,37 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('devices', function (table) {
-        table.increments('device_id').unsigned().notNullable().primary();
-        table.integer('personal_id');
-        table.enum('personal_type', ['admin', 'site', 'user']).notNullable();
-        table.string('unique_id', 100).notNullable();
-        table.string('ip_address', 100).notNullable();
-        table.text('device_information').notNullable();
-        table.boolean('two_factor_approved').defaultTo(false);
-        table.string('token', 255).notNullable();
-        table.datetime('last_login_at').notNullable();
-        table.string('last_login_ip', 100).notNullable();
-        table.datetime('created_at').notNullable().defaultTo(knex.fn.now());
-        table.datetime('updated_at').notNullable().defaultTo(knex.raw('CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP'));
-        table.unique(['unique_id', 'personal_id', 'personal_type'], 'device_unique_index')
-        table.index(['personal_id', 'personal_type'], 'device_personal_index')
-        table.index(['token'], 'device_token_index')
-    })
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = async function(knex) {
-    if (process.env.NODE_ENV === 'production') {
-        throw new Error('Cannot drop table in production environment.')
-    } else {
-        if(await knex.schema.hasTable('devices')) {
-            return knex.schema.dropTable('devices');
-        }
-    }
-};

package/database/migrations/20251019192600_users.js

@@ -1,62 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('users', function(table) {
-        // Primary key
-        table.increments('user_id').primary();
-
-        table.integer('site_id').unsigned().references('site_id').inTable('sites');
-        
-        // Basic manager information
-        table.string('username', 50).notNullable().unique();
-        table.string('email', 255).nullable().unique();
-        table.string('password', 255).notNullable();
-        table.enum('type_user', ['vip', 'new', 'risky']).defaultTo('new');
-        
-        // Two-factor authentication fields
-        table.boolean('two_factor_enabled').defaultTo(false);
-        table.string('two_factor_secret', 32).nullable(); // TOTP secret
-        table.string('phone_number', 20).nullable();
-        table.boolean('phone_verified').defaultTo(false);
-        table.boolean('email_verified').defaultTo(false);
-        
-        // Login security
-        table.integer('login_attempts').defaultTo(0);
-        table.timestamp('locked_until').nullable();
-        
-        // Password security and reset
-        table.timestamp('password_changed_at').nullable();
-        table.string('password_reset_token', 255).nullable();
-        
-        // Email verification and reset
-        table.string('email_verification_token', 255).nullable();
-        
-        // Phone verification and reset
-        table.string('phone_verification_code', 10).nullable();
-        
-        // Account security
-        table.boolean('is_active').defaultTo(true);
-        
-        // Audit timestamps
-        table.timestamps(true, true); // created_at and updated_at
-        
-        // Indexes for performance and security
-        table.index(['type_user']);
-        table.index(['is_active']);
-        table.index(['two_factor_enabled']);
-        table.index(['phone_verified']);
-        table.index(['email_verified']);
-        table.index(['created_at']);
-        table.index(['locked_until']);
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-    return knex.schema.dropTable('users');
-};

package/database/migrations/20251019213551_language_lines.js

@@ -1,35 +0,0 @@
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.up = function(knex) {
-    return knex.schema.createTable('language_lines', function(table) {
-        // Primary key
-        table.increments('language_line_id').primary();
-        
-        // Basic manager information
-        table.integer('language_id').notNullable();
-        table.string('group', 50).notNullable();
-        table.string('key', 50).notNullable();
-        table.text('text').notNullable();
-        table.boolean('is_modified').defaultTo(false);
-
-        table.timestamps(true, true);
-
-        table.unique(['language_id', 'group', 'key'], 'language_line_unique_index');
-        table.index(['language_id'], 'language_line_language_index');
-        table.index(['group'], 'language_line_group_index');
-        table.index(['key'], 'language_line_key_index');
-        table.index(['is_modified'], 'language_line_is_modified_index');
-        table.index(['created_at'], 'language_line_created_at_index');
-        table.index(['updated_at'], 'language_line_updated_at_index');
-    });
-};
-
-/**
- * @param { import("knex").Knex } knex
- * @returns { Promise<void> }
- */
-exports.down = function(knex) {
-  return knex.schema.dropTable('language_lines');
-};

package/database/migrations/20251222214131_category_groups.js

@@ -1,18 +0,0 @@
-exports.up = knex =>
-    knex.schema
-        .createTable('category_groups', table => {
-            table.increments('category_group_id').primary();
-            table.integer('site_id').unsigned().references('site_id').inTable('sites');
-            table.timestamps(true, true);
-        })
-        .createTable('category_group_translations', table => {
-            table.increments('category_group_translation_id').primary();
-            table.integer('category_group_id').unsigned().references('category_group_id').inTable('category_groups').onDelete('CASCADE');
-            table.integer('language_id').unsigned().references('language_id').inTable('languages');
-            table.string('name').notNullable();
-        });
-
-exports.down = knex =>
-    knex.schema
-        .dropTable('category_group_translations')
-        .dropTable('category_groups');