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

$3

#### 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

$3

#### 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

$3

#### 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

$3

#### 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

$3

#### 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

$3

- 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