evacommerce

A Node.js package for e-commerce automation and integration.

Installation

npm install evacommerce

Directories and files

src/ ├── browser/ │ ├── electronMethods.js │ ├── navegation.js │ └── puppeteerInputActions.js ├── config/ │ ├── connectToDatabase.js │ ├── createCronInstance.js │ ├── createSequelizeConnection.js │ └── mongoMethods.js ├── core/ │ ├── controllerMethod.js │ ├── machineIdentification.js │ ├── request.js │ ├── startCronExecution.js │ └── startServer.js ├── integrations/ │ ├── facebook/ │ │ └── navigationFacebook.js │ ├── mercadoLivre/ │ │ ├── accessMercadoLivre.js │ │ ├── editionMercadoLivre.js │ │ └── registerMercadoLivre.js │ ├── nuvemShop/ │ │ ├── createNuvemShopInstance.js │ │ └── navigationNuvemShop.js │ └── softUp/ │ └── loginSoftUp.js ├── services/ │ ├── ai/ │ │ ├── chatGpt.js │ │ ├── deepseekMethods.js │ │ └── geminiMethods.js │ └── google/ │ └── googleImageSearch.js └── utils/ ├── consoleMessages.js ├── dateMethods.js ├── downloadImage.js ├── fileMethods.js ├── phoneMethods.js ├── priceMethods.js ├── urlFormatter.js ├── waitForSelector.js └── waitForTimeout.js

Modules and Functions Documentation

Browser Module

electronMethods.js

Functions for handling Electron-specific browser interactions.

• Functions:
  • openWindowElectron(filePath) - Opens an Electron window with the specified file
• Exports: All Electron window functions

navegation.js

Core navigation utilities for browser automation.

• Functions:
  • getScreenResolution(page) - Gets the screen resolution
  • getChromeExecutablePath() - Gets the Chrome executable path based on platform
  • openBrowserFirstPage(browser) - Opens or reuses the first page in a browser instance
  • openNewPage(browser) - Opens a new browser page with proper viewport settings
  • createNavigationInstance(userDataDir, directoryName) - Creates a configured browser instance
  • getIframe(page, selector) - Gets an iframe from the specified selector
• Exports: All navigation functions

puppeteerInputActions.js

Functions for simulating user input in Puppeteer.

• Functions:
  • ctrlz(page) - Simulates Ctrl+Z keyboard shortcut
  • ctrla(page) - Simulates Ctrl+A keyboard shortcut
  • copyPasteText(page, selector, inputText) - Copies and pastes text using clipboard
  • clearInputAndWrite(page, selector, inputText, secondElement, timeout) - Clears input field and enters new text
  • waitForSelectorAndType(page, selector, inputText) - Waits for a selector to appear and types text
  • deleteFieldValueByBackspace(input) - Deletes field value using backspace
• Exports: All input action functions

Config Module

connectToDatabase.js

Database connection utilities.

• Functions:
  • connectToDatabase(sequelize) - Establishes and verifies database connection with retry
• Exports: Database connection function

createCronInstance.js

Cron job creation and management.

• Functions:
  • createCronInstance(cronTime, functionJob, onComplete, start) - Creates a new cron job with timezone settings
• Exports: Cron instance creation function

createSequelizeConnection.js

Sequelize ORM connection management.

• Functions:
  • createSequelizeConnection({ host, port, username, password, database }, pathModels) - Creates and configures Sequelize connection and loads models
• Exports: Sequelize connection function

mongoMethods.js

MongoDB specific methods.

• Functions:
  • connectToMongo() - Connects to MongoDB with retry functionality
  • isDisconnected() - Checks if MongoDB connection is disconnected
• Exports: MongoDB connection functions

Core Module

controllerMethod.js

Controller functions for application flow.

• Functions:
  • controllerMethod(req, res, schema, methodFunction, parametersMethod) - Handles request validation and execution
  • controllerMiddleware(controller) - Middleware for exception handling in controllers
• Exports: Controller helper functions

machineIdentification.js

Machine identification utilities.

• Functions:
  • getIdMachine() - Gets unique hardware identifier for the machine
• Exports: Machine identification function

request.js

HTTP request utilities.

• Functions:
  • get(url, options) - Makes GET request
  • post(url, data, options) - Makes POST request
  • put(url, data, options) - Makes PUT request
  • delete(url, options) - Makes DELETE request
• Exports: All request functions

startCronExecution.js

Cron execution management.

• Functions:
  • startCron(cronConfig) - Starts cron execution
  • scheduleCronJob(job, schedule) - Schedules a cron job
  • stopAllCronJobs() - Stops all running cron jobs
• Exports: All cron execution functions

startServer.js

Server initialization and management.

• Functions:
  • startServer(port, options) - Starts server on specified port
  • stopServer() - Stops running server
  • restartServer() - Restarts running server
• Exports: All server functions

Integrations Module

Facebook Integration

• navigationFacebook.js
  • Functions:
    • loginToFacebook(credentials) - Logs in to Facebook
    • postToFacebook(content) - Posts content to Facebook
    • navigateToFacebookPage(pageUrl) - Navigates to specific Facebook page
  • Exports: All Facebook navigation functions

MercadoLivre Integration

• accessMercadoLivre.js
  • Functions:
    • loginToML(credentials) - Logs in to MercadoLivre
    • navigateToMLDashboard() - Navigates to ML dashboard
  • Exports: All ML access functions
• editionMercadoLivre.js
  • Functions:
    • editMLListing(listingId, data) - Edits ML listing
    • updateMLPrice(listingId, price) - Updates price on ML listing
    • updateMLStock(listingId, stock) - Updates stock on ML listing
  • Exports: All ML edition functions
• registerMercadoLivre.js
  • Functions:
    • createMLAccount(userData) - Creates ML account
    • registerMLSeller(sellerData) - Registers as ML seller
    • createMLListing(productData) - Creates new ML listing
  • Exports: All ML registration functions

NuvemShop Integration

• createNuvemShopInstance.js
  • Functions:
    • createNuvemShopStore(storeData) - Creates new NuvemShop store
    • configureNuvemShopStore(storeId, config) - Configures store settings
  • Exports: Both NuvemShop store creation functions
• navigationNuvemShop.js
  • Functions:
    • loginToNuvemShop(credentials) - Logs in to NuvemShop
    • addProductToNuvemShop(productData) - Adds product to NuvemShop
    • editProductInNuvemShop(productId, data) - Edits product in NuvemShop
  • Exports: All NuvemShop navigation functions

SoftUp Integration

• loginSoftUp.js
  • Functions:
    • loginToSoftUp(credentials) - Logs in to SoftUp
    • navigateToSoftUpDashboard() - Navigates to SoftUp dashboard
    • logoutFromSoftUp() - Logs out from SoftUp
  • Exports: All SoftUp login functions

Services Module

AI Services

• chatGpt.js
  • Functions:
    • generateChatGptResponse(prompt) - Generates response from ChatGPT
    • optimizeProductDescription(description) - Optimizes product descriptions
  • Exports: Both ChatGPT functions
• deepseekMethods.js
  • Functions:
    • generateDeepseekResponse(prompt) - Generates response from Deepseek
    • analyzeProductImage(imagePath) - Analyzes product images
  • Exports: Both Deepseek functions
• geminiMethods.js
  • Functions:
    • generateGeminiResponse(prompt) - Generates response from Gemini
    • generateProductVariations(baseProduct) - Generates product variations
  • Exports: Both Gemini functions

Google Services

• googleImageSearch.js
  • Functions:
    • searchImages(query) - Searches for images using Google
    • downloadTopImages(query, count) - Downloads top images for query
    • reverseImageSearch(imagePath) - Performs reverse image search
  • Exports: All Google image search functions

Utils Module

• consoleMessages.js
  • Functions:
    • logInfo(message) - Logs informational message
    • logSuccess(message) - Logs success message
    • logWarning(message) - Logs warning message
    • logError(message) - Logs error message
  • Exports: All console message functions
• dateMethods.js
  • Functions:
    • formatDate(date, format) - Formats date to specified format
    • getDateDifference(date1, date2) - Gets difference between dates
    • isDateValid(dateString) - Validates date string
  • Exports: All date utility functions
• downloadImage.js
  • Functions:
    • downloadImage(url, path) - Downloads image from URL to path
    • resizeImage(imagePath, width, height) - Resizes downloaded image
  • Exports: Both image download functions
• fileMethods.js
  • Functions:
    • cleanDirectory(directory) - Cleans all files from a directory
    • checkFileType(url) - Checks if a file is an image or document based on extension
  • Exports: Both file management functions
• phoneMethods.js
  • Functions:
    • addPrefix55IfNotPresent(phoneNumber) - Adds the "55" prefix to a phone number if not present
  • Exports: Phone number formatting function
• priceMethods.js
  • Functions:
    • formatPriceChangePeriodToComma(number) - Formats a price by changing period to comma
  • Exports: Price formatting function
• urlFormatter.js
  • Functions:
    • formatUrlsToHtml(text) - Converts URLs in text to HTML anchor tags
    • extractImageUrls(urls) - Extracts image URLs from a list of URLs
    • getMainDomain(url) - Gets the main domain from a URL
    • buildFullUrl(domain, urlPath) - Builds a full URL from domain and path
    • extractIdFromUrlMercadoLivre(url) - Extracts product ID from a Mercado Livre URL
    • extractUrlsForText(text) - Extracts URLs from text
  • Exports: All URL formatting and extraction functions
• waitForSelector.js
  • Functions:
    • waitForSelector(page, selector, timeout) - Waits for an element with the specified selector to appear
  • Exports: Selector waiting utility function
• waitForTimeout.js
  • Functions:
    • waitForTimeout(ms) - Returns a promise that resolves after the specified milliseconds
  • Exports: Timeout utility function