FormulateJS

Framework simples para aplicações Full-Stack em Node.js. O objetivo do FormulateJS é acelerar o desenvolvimento de CRUDs, relatórios, API's e interfaces dinâmicas a partir da estrutura do banco de dados.

🚀 Instalação

npm install formulatejs
npx create-formulatejs

Esse comando npx create-formulatejs prepara a estrutura inicial da aplicação com pastas e arquivos padrões.

📦 Funcionalidades

Nome	Descrição
MailSender	Envia e-mails utilizando nodemailer com configuração personalizada.
DateFormatter	Utilitários para formatação de datas e horas.
Report	Cria botões e estruturas de relatório dinâmico.
DocumentFormatter	Formata documentos como CPF, CNPJ, RG, CNH, telefone e celular.
CurrencyFormatter	Formata valores monetários (R$, $, €) com casas decimais e separadores.
ActionButtons	Cria botões de ação (editar, excluir, visualizar) com estilização.
LoadReport	Carrega relatórios dinamicamente via URL e parâmetros.
TableActions	Gera ações interativas sobre tabelas HTML (clicks, botões, etc.).
FormGenerator	Gera formulários HTML com base em metadados do banco de dados (genérico).
FormGeneratorMySQL	Gera formulários a partir da estrutura de tabelas do MySQL.
FormGeneratorMSSQL	Gera formulários a partir da estrutura de tabelas MSSQL.
FormGeneratorSQLite	Gera formulários a partir da estrutura de tabelas SQLite.
MakeaFormsDB	Cria arquivos de configuração com campos e botões para cada tabela do banco.
makeFormView	Gera HTML de visualização de formulário.
saveHTMLView	Salva o HTML gerado do formulário no sistema de arquivos.
MakeaTableDB	Cria arquivos de configuração para tabelas.
makeTableView	Gera HTML de visualização de tabela.
saveHTMLTableView	Salva a visualização HTML de uma tabela.

📁 Exemplos de uso

MailSender

const { MailSender } = require('formulatejs');
const mailer = new MailSender({ host: 'smtp.exemplo.com', port: 587, secure: false, auth: { user: 'user', pass: 'pass' } });
await mailer.sendMail({ to: 'alguem@exemplo.com', subject: 'Assunto', text: 'Mensagem' });

DateFormatter

const { DateFormatter } = require('formulatejs');
console.log(DateFormatter.format('2024-12-25')); // 25/12/2024

Report

const { Report } = require('formulatejs');
const html = Report.createButton('Exportar', '/export');

DocumentFormatter

const { DocumentFormatter } = require('formulatejs');
console.log(DocumentFormatter.formatCPF('12345678901'));

CurrencyFormatter

const { CurrencyFormatter } = require('formulatejs');
console.log(CurrencyFormatter.format(1234.56)); // R$ 1.234,56

ActionButtons

const { ActionButtons } = require('formulatejs');
const html = ActionButtons.generate('editar', 1);

LoadReport

const { LoadReport } = require('formulatejs');
LoadReport('/api/relatorio', { filtro: 'ativo' });

TableActions

const { TableActions } = require('formulatejs');
TableActions.attachListeners('minhaTabela');

FormGenerator

const { FormGenerator } = require('formulatejs');
FormGenerator.generateFromMetadata({ table: 'usuarios', fields: ['nome', 'email'] });

FormGeneratorMySQL

const { FormGeneratorMySQL } = require('formulatejs');
const formGen = new FormGeneratorMySQL({ host: 'localhost', user: 'root', database: 'app' });
formGen.generateForm('clientes').then(console.log);

FormGeneratorMSSQL

const { FormGeneratorMSSQL } = require('formulatejs');
const formGen = new FormGeneratorMSSQL({ user: 'sa', password: 'pass', server: 'localhost', database: 'app' });
formGen.generateForm('produtos').then(console.log);

FormGeneratorSQLite

const { FormGeneratorSQLite } = require('formulatejs');
const formGen = new FormGeneratorSQLite('./app.db');
formGen.generateForm('usuarios').then(console.log);

MakeaFormsDB

const { MakeaFormsDB } = require('formulatejs');
const maker = new MakeaFormsDB();
maker.create('clientes', ['nome', 'email']);

makeFormView e saveHTMLView

const { makeFormView, saveHTMLView } = require('formulatejs');
const html = makeFormView({ nome: 'Nome' });
saveHTMLView('form-clientes.html', html);

MakeaTableDB

const { MakeaTableDB } = require('formulatejs');
const tableMaker = new MakeaTableDB();
tableMaker.create('clientes', ['nome', 'email']);

makeTableView e saveHTMLTableView

const { makeTableView, saveHTMLTableView } = require('formulatejs');
const html = makeTableView([{ nome: 'João' }, { nome: 'Maria' }]);
saveHTMLTableView('clientes.html', html);

🤝 Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

📄 Licença

Este projeto está licenciado sob a Licença MIT.