Security News
Namecheap Takes Down Polyfill.io Service Following Supply Chain Attack
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
@bgroup/data-model
Advanced tools
Readme
El proyecto se basa en objetos del modelo que manejan y gestionan las consultas recibidas de tipo objetos. Existe un objeto base llamado DataModel que se encarga de cargar los modelos definidos con sequelize o sequelize-auto, proporcionando una interfaz sencilla para interactuar con ellos. Por otro lado, la clase Action define las acciones que se deben realizar en la base de datos para efectuar el impacto deseado.
Para utilizar este proyecto, simplemente importa el DataModel en tus modelos y el objeto Action en tus acciones. De esta manera, podrás hacer uso de las consultas en cualquier parte del código, manteniendo una estructura clara y coherente.
A medida que avances en el proyecto, se proporcionarán más detalles sobre el funcionamiento y las mejores prácticas para su uso.
Una vez tengas incorporado en el data-models en tu proyecto se debe realizar la importación de la siguiente manera:
import {DataModel, actions} from "@bgroup/data-model/db"
Ya obteniendo ambos objetos podemos comenzar con el funcionamiento. A continuación se indicará el uso de cada método para el Data Model
- conexión a la BD de datos:
```
const dbConnected = DataModel.connectDB(credentials);
```
En donde credentials tiene las siguientes propiedad definidas en el .env:
* dbName: Indica el nombre de la BD a conectar
* dbUser: Usuario
* dbPass: Contraseña
* dbHost: Dirección de la BD de datos
* dbTimeZone: EL horario del lugar (opcional)
* dialect: gestor de base datos a usar. Opciones: mysql, mariadb, sqlite, postgres, oracle
- Modelos
```
const models = DataModel.models;
```
Contiene los modelos de la BD
- sequelize: Usa toda funcionalidad de sequelize que requieras hacer. Por ejemplo:
```
const query = await DataModel.sequelize.query('
SELECT * FROM user;
')
```
Ahora para actions
- La propiedad DEFAULT puedes modificar los valores por defecto del order, limit, start (offset). Tiene por defecto "timeCreated", 30, 0, respectivamente
```
Actions.DEFAULT = { order: "timeCreated", limit: 30, start: 0 };
```
- La propiedad OPERATORS devuelve la lista de operadores soportados como key en el objeto para las consultas
```
console.log(actions.OPERATORS)
```
- La propiedad op permite usar los demás operadores de sequelize para consultas personalizadas
- La función processFilters te permite construir el filtrado para realizar la consulta por sequelize
```
const where = {
id: [10,30,40,50],
date: {
between: ['2020-01-01','2020-12-31']
},
and: {
name: "pedro",
quatity: {
gt: 10
},
or: {status: 1}
},
}
const filter = actions.processFilters(DataModel.models.Modelo, where);
```
- La función list permite listar una consulta. Por ejemplo:
```
const params = {
order: "id",
asc: "ASC",
limit: 10,
start: 10,
attributes: ["id", "name", "quantity"],
where = {
id: [10,30,40,50],
date: {
between: ['2020-01-01','2020-12-31']
},
and: {
name: "pedro",
quatity: {
gt: 10
},
or: {status: 1}
},
}
}
const results = await actions.list(model, params, target)
```
En donde model son los modelos que contiene DataModel.models, target el lugar donde se realizó el error y params que está distribuído de la siguiente manera:
* limit: limite de elementos, por defecto 30
* start: desplazamiento de los elementos a traer, por defecto 0
* order: campo a ordenar
* asc: boleano para indicar si es ascendente o descendente
* where: formato where como el ejemplo anterior
* attributes: indicar por un arreglo de string los atributos a mostrar
- La función data toma la información de un solo registro de la base de datos por medio de un id. Por ejemplo:
```
const params = {
id: 2
}
const data = await actions.data(model, params, target)
```
En donde model son los modelos que contiene DataModel.models, target el lugar donde se realizó el error y params es el id del registro
- La función remove tiene como objetivo borrar un registro por id
```
const params = {
id: 2
}
const remove = await actions.remove(params, model, target);
```
En donde model son los modelos que contiene DataModel.models, target el lugar donde se realizó el error y params es el id del registro
- La función publish en donde se pasará los atributos para actualizar el registro o crearlo. En los parámetros si se incluye el id se actualiza el registro, sino lo crea. Ejemplo
```
const create = {
name: "Tomas",
phone: "+xxxxxxxxxxxx"
}
const update = {
id: 1,
name: "Pedro"
}
const publish = await actions.publish(model, create, target);
const publish = await actions.publish(model, update, target)
```
- La función bulkSave permite hacer un upsert para una cantidad masiva
```
const params = [
{
name: "Maria"
},
{
id: 2,
name: "tomas"
}
]
const saveAll = await actions.bulkSave(model, params, target)
```
const { DB_HOST, DB_USER, DB_PASS, DB_NAME, DB_TIMEZONE } = process.env;
const config = {
name: DB_NAME,
user: DB_USER,
password: DB_PASS,
host: DB_HOST,
timeZone: DB_TIMEZONE,
dialect: 'mssql',
dialectOptions: {
options: {
encrypt: false,
trustServerCertificate: true,
},
},
initModels,
};
export /*bundle*/ const DataModel = DM.get(config);
Queremos agradecer a todas las personas que han contribuido a este proyecto y a los recursos que hemos utilizado.
FAQs
Handler ORM to process data from DATABASE
The npm package @bgroup/data-model receives a total of 160 weekly downloads. As such, @bgroup/data-model popularity was classified as not popular.
We found that @bgroup/data-model demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.
Security News
A JavaScript library maintainer is under fire after merging a controversial PR to support legacy versions of Node.js.