@seip/blue-bird 0.4.5 → 0.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/.env_example +26 -25
  2. package/AGENTS.md +199 -199
  3. package/README.md +79 -79
  4. package/backend/index.js +13 -13
  5. package/backend/routes/frontend.js +41 -41
  6. package/backend/routes/seo.js +39 -39
  7. package/core/app.js +330 -325
  8. package/core/auth.js +142 -114
  9. package/core/cache.js +44 -44
  10. package/core/cli/component.js +42 -42
  11. package/core/cli/init.js +119 -118
  12. package/core/cli/react.js +435 -435
  13. package/core/cli/route.js +42 -42
  14. package/core/config.js +51 -47
  15. package/core/debug.js +248 -248
  16. package/core/logger.js +100 -100
  17. package/core/middleware.js +27 -27
  18. package/core/router.js +333 -333
  19. package/core/seo.js +95 -100
  20. package/core/template.js +478 -462
  21. package/core/upload.js +77 -76
  22. package/core/validate.js +380 -380
  23. package/frontend/index.html +31 -26
  24. package/frontend/landing.html +70 -69
  25. package/frontend/resources/css/tailwind.css +17 -17
  26. package/frontend/resources/js/App.jsx +70 -70
  27. package/frontend/resources/js/Main.jsx +18 -18
  28. package/frontend/resources/js/blue-bird/components/Button.jsx +67 -67
  29. package/frontend/resources/js/blue-bird/components/Card.jsx +18 -18
  30. package/frontend/resources/js/blue-bird/components/DataTable.jsx +126 -126
  31. package/frontend/resources/js/blue-bird/components/Input.jsx +21 -21
  32. package/frontend/resources/js/blue-bird/components/Label.jsx +12 -12
  33. package/frontend/resources/js/blue-bird/components/LanguageButton.jsx +23 -23
  34. package/frontend/resources/js/blue-bird/components/Link.jsx +15 -15
  35. package/frontend/resources/js/blue-bird/components/Modal.jsx +27 -27
  36. package/frontend/resources/js/blue-bird/components/Skeleton.jsx +44 -44
  37. package/frontend/resources/js/blue-bird/components/Translate.jsx +12 -12
  38. package/frontend/resources/js/blue-bird/components/Typography.jsx +69 -69
  39. package/frontend/resources/js/blue-bird/contexts/LanguageContext.jsx +41 -41
  40. package/frontend/resources/js/blue-bird/contexts/SPAContext.jsx +239 -237
  41. package/frontend/resources/js/blue-bird/contexts/SnackbarContext.jsx +38 -38
  42. package/frontend/resources/js/blue-bird/contexts/ThemeContext.jsx +49 -49
  43. package/frontend/resources/js/blue-bird/locales/en.json +47 -47
  44. package/frontend/resources/js/blue-bird/locales/es.json +47 -47
  45. package/frontend/resources/js/components/Header.jsx +55 -55
  46. package/frontend/resources/js/pages/About.jsx +31 -31
  47. package/frontend/resources/js/pages/Home.jsx +82 -82
  48. package/package.json +1 -1
  49. package/vite.config.js +22 -22
  50. package/frontend/public/robots.txt +0 -0
  51. package/frontend/public/sitemap.xml +0 -0
package/core/validate.js CHANGED
@@ -1,380 +1,380 @@
1
- import xss from "xss";
2
-
3
- const messages_default = {
4
- es: {
5
- required: (f) => `El campo ${f} es obligatorio`,
6
- min: (f, n) => `El campo ${f} debe tener al menos ${n} caracteres`,
7
- max: (f, n) => `El campo ${f} no puede tener más de ${n} caracteres`,
8
- email: (f) => `El campo ${f} debe ser un email válido`,
9
- number: (f) => `El campo ${f} debe ser numérico`,
10
- alpha: (f) => `El campo ${f} solo puede contener letras`,
11
- alphanumeric: (f) => `El campo ${f} solo puede contener letras y números`,
12
- boolean: (f) => `El campo ${f} debe ser verdadero o falso`,
13
- date: (f) => `El campo ${f} debe ser una fecha válida`,
14
- url: (f) => `El campo ${f} debe ser una URL válida`,
15
- in: (f, v) => `El campo ${f} debe ser uno de: ${v.join(", ")}`,
16
- equals: (f, v) => `El campo ${f} debe ser igual a ${v}`,
17
- password: () => `La contraseña debe tener mayúsculas, minúsculas y números`,
18
- pattern: (f) => `El campo ${f} no cumple el patrón requerido`,
19
- },
20
- en: {
21
- required: (f) => `${f} is required`,
22
- min: (f, n) => `${f} must be at least ${n} characters`,
23
- max: (f, n) => `${f} must be at most ${n} characters`,
24
- email: (f) => `${f} must be a valid email`,
25
- number: (f) => `${f} must be numeric`,
26
- alpha: (f) => `${f} must contain only letters`,
27
- alphanumeric: (f) => `${f} must contain only letters and numbers`,
28
- boolean: (f) => `${f} must be true or false`,
29
- date: (f) => `${f} must be a valid date`,
30
- url: (f) => `${f} must be a valid URL`,
31
- in: (f, v) => `${f} must be one of: ${v.join(", ")}`,
32
- equals: (f, v) => `${f} must equal ${v}`,
33
- password: () => `Password must contain uppercase, lowercase and numbers`,
34
- pattern: (f) => `${f} does not match the required pattern`,
35
- },
36
- pt: {
37
- required: (f) => `O campo ${f} é obrigatório`,
38
- min: (f, n) => `O campo ${f} deve ter pelo menos ${n} caracteres`,
39
- max: (f, n) => `O campo ${f} não pode ter mais de ${n} caracteres`,
40
- email: (f) => `O campo ${f} deve ser um email válido`,
41
- number: (f) => `O campo ${f} deve ser numérico`,
42
- alpha: (f) => `O campo ${f} só pode conter letras`,
43
- alphanumeric: (f) => `O campo ${f} só pode conter letras e números`,
44
- boolean: (f) => `O campo ${f} deve ser verdadeiro ou falso`,
45
- date: (f) => `O campo ${f} deve ser uma data válida`,
46
- url: (f) => `O campo ${f} deve ser uma URL válida`,
47
- in: (f, v) => `O campo ${f} deve ser um de: ${v.join(", ")}`,
48
- equals: (f, v) => `O campo ${f} deve ser igual a ${v}`,
49
- password: () => `A senha deve conter maiúsculas, minúsculas e números`,
50
- pattern: (f) => `O campo ${f} não corresponde ao padrão exigido`,
51
- },
52
- br: {
53
- required: (f) => `O campo ${f} é obrigatório`,
54
- min: (f, n) => `O campo ${f} deve ter pelo menos ${n} caracteres`,
55
- max: (f, n) => `O campo ${f} não pode ter mais de ${n} caracteres`,
56
- email: (f) => `O campo ${f} deve ser um email válido`,
57
- number: (f) => `O campo ${f} deve ser numérico`,
58
- alpha: (f) => `O campo ${f} só pode conter letras`,
59
- alphanumeric: (f) => `O campo ${f} só pode conter letras e números`,
60
- boolean: (f) => `O campo ${f} deve ser verdadeiro ou falso`,
61
- date: (f) => `O campo ${f} deve ser uma data válida`,
62
- url: (f) => `O campo ${f} deve ser uma URL válida`,
63
- in: (f, v) => `O campo ${f} deve ser um de: ${v.join(", ")}`,
64
- equals: (f, v) => `O campo ${f} deve ser igual a ${v}`,
65
- password: () => `A senha deve conter maiúsculas, minúsculas e números`,
66
- pattern: (f) => `O campo ${f} não corresponde ao padrão exigido`,
67
- },
68
- fr: {
69
- required: (f) => `Le champ ${f} est obligatoire`,
70
- min: (f, n) => `Le champ ${f} doit contenir au moins ${n} caractères`,
71
- max: (f, n) => `Le champ ${f} ne peut pas contenir plus de ${n} caractères`,
72
- email: (f) => `Le champ ${f} doit être un email valide`,
73
- number: (f) => `Le champ ${f} doit être numérique`,
74
- alpha: (f) => `Le champ ${f} ne peut contenir que des lettres`,
75
- alphanumeric: (f) =>
76
- `Le champ ${f} ne peut contenir que des lettres et des chiffres`,
77
- boolean: (f) => `Le champ ${f} doit être vrai ou faux`,
78
- date: (f) => `Le champ ${f} doit être une date valide`,
79
- url: (f) => `Le champ ${f} doit être une URL valide`,
80
- in: (f, v) => `Le champ ${f} doit être l'un de: ${v.join(", ")}`,
81
- equals: (f, v) => `Le champ ${f} doit être égal à ${v}`,
82
- password: () =>
83
- `Le mot de passe doit contenir des majuscules, des minuscules et des chiffres`,
84
- pattern: (f) => `Le champ ${f} ne correspond pas au modèle requis`,
85
- },
86
- };
87
-
88
- const validators = {
89
- isEmpty: (value) => value === undefined || value === null || value === "",
90
- isEmail: (value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value),
91
- isNumeric: (value) => !isNaN(value) && !isNaN(parseFloat(value)),
92
- isAlpha: (value) => /^[a-zA-Z]+$/.test(value),
93
- isAlphanumeric: (value) => /^[a-zA-Z0-9]+$/.test(value),
94
- isBoolean: (value) =>
95
- value === true || value === false || value === "true" || value === "false",
96
- isISO8601: (value) => !isNaN(Date.parse(value)),
97
- isURL: (value) => {
98
- try {
99
- new URL(value);
100
- return true;
101
- } catch {
102
- return false;
103
- }
104
- },
105
- isLength: (value, { min, max }) => {
106
- const len = String(value).length;
107
- if (min !== undefined && len < min) return false;
108
- if (max !== undefined && len > max) return false;
109
- return true;
110
- },
111
- isIn: (value, values) => values.includes(value),
112
- equals: (value, comparison) => value === comparison,
113
- matches: (value, pattern) => pattern.test(value),
114
- };
115
-
116
- /**
117
- * Comprehensive Validator class for handling multi-language data validation.
118
- */
119
- class Validator {
120
- /**
121
- * Initializes the Validator instance with a schema and optional language settings.
122
- * @param {Object} schema - Validation rules for each field (e.g., { email: { required: true, email: true } }).
123
- * @param {string} [lang_default=null] - Default language for error messages (e.g., "en", "es").
124
- * @param {Object} [messages=null] - Custom message overrides for validation rules.
125
- * @example
126
- * const loginSchema = {
127
- * email: { required: true, email: true },
128
- * password: { required: true, min: 6 }
129
- * };
130
- * const loginValidator = new Validator(loginSchema, 'es');
131
- */
132
- constructor(schema, lang_default = null, messages = null) {
133
- this.schema = schema;
134
- this.lang_default = lang_default;
135
- this.messages = messages ? messages : messages_default;
136
- }
137
-
138
- /**
139
- * Validates the request body against the defined schema.
140
- * @param {import('express').Request} req - The Express request object containing the body to validate.
141
- * @returns {Promise<{success: boolean, error: boolean, errors: Array<{field: string, message: string}>, message: Array<string>, html: Array<string>}>} Validation results.
142
- * @example
143
- * const loginSchema = {
144
- * email: { required: true, email: true },
145
- * password: { required: true, min: 6 }
146
- * };
147
- * const loginValidator = new Validator(loginSchema, 'es');
148
- * const result = await loginValidator.validate(req);
149
- */
150
- async validate(req) {
151
- let lang =
152
- req?.body?.lang ||
153
- req?.query?.lang ||
154
- req?.params?.lang ||
155
- req?.cookies?.lang ||
156
- req?.headers["accept-language"]?.split(",")[0]?.split("-")[0] ||
157
- req?.session?.lang ||
158
- this.lang_default ||
159
- "es";
160
- const msg = this.messages[lang] || this.messages.es;
161
- const errors = [];
162
- const messages = [];
163
- const body = req.body || {};
164
-
165
- for (const [field, config] of Object.entries(this.schema)) {
166
- let value = body[field];
167
-
168
- if (config.xss !== false && typeof value === "string") {
169
- body[field] = xss(value);
170
- value = body[field];
171
- }
172
-
173
- if (config.required && validators.isEmpty(value)) {
174
- messages.push(config.messages?.required || msg.required(field));
175
- errors.push({
176
- field: field,
177
- message: config.messages?.required || msg.required(field),
178
- });
179
- continue;
180
- }
181
-
182
- if (!validators.isEmpty(value)) {
183
- if (
184
- config.min !== undefined &&
185
- !validators.isLength(value, { min: config.min })
186
- ) {
187
- messages.push(config.messages?.min || msg.min(field, config.min));
188
- errors.push({
189
- field: field,
190
- message: config.messages?.min || msg.min(field, config.min),
191
- });
192
- }
193
- if (
194
- config.max !== undefined &&
195
- !validators.isLength(value, { max: config.max })
196
- ) {
197
- messages.push(config.messages?.max || msg.max(field, config.max));
198
- errors.push({
199
- field: field,
200
- message: config.messages?.max || msg.max(field, config.max),
201
- });
202
- }
203
- if (config.email && !validators.isEmail(value)) {
204
- messages.push(config.messages?.email || msg.email(field));
205
- errors.push({
206
- field: field,
207
- message: config.messages?.email || msg.email(field),
208
- });
209
- }
210
- if (config.number && !validators.isNumeric(value)) {
211
- messages.push(config.messages?.number || msg.number(field));
212
- errors.push({
213
- field: field,
214
- message: config.messages?.number || msg.number(field),
215
- });
216
- }
217
- if (config.alpha && !validators.isAlpha(value)) {
218
- messages.push(config.messages?.alpha || msg.alpha(field));
219
- errors.push({
220
- field: field,
221
- message: config.messages?.alpha || msg.alpha(field),
222
- });
223
- }
224
- if (config.alphanumeric && !validators.isAlphanumeric(value)) {
225
- messages.push(
226
- config.messages?.alphanumeric || msg.alphanumeric(field),
227
- );
228
- errors.push({
229
- field: field,
230
- message: config.messages?.alphanumeric || msg.alphanumeric(field),
231
- });
232
- }
233
- if (config.boolean && !validators.isBoolean(value)) {
234
- messages.push(config.messages?.boolean || msg.boolean(field));
235
- errors.push({
236
- field: field,
237
- message: config.messages?.boolean || msg.boolean(field),
238
- });
239
- }
240
- if (config.date && !validators.isISO8601(value)) {
241
- messages.push(config.messages?.date || msg.date(field));
242
- errors.push({
243
- field: field,
244
- message: config.messages?.date || msg.date(field),
245
- });
246
- }
247
- if (config.url && !validators.isURL(value)) {
248
- messages.push(config.messages?.url || msg.url(field));
249
- errors.push({
250
- field: field,
251
- message: config.messages?.url || msg.url(field),
252
- });
253
- }
254
- if (config.in && !validators.isIn(value, config.in)) {
255
- messages.push(config.messages?.in || msg.in(field, config.in));
256
- errors.push({
257
- field: field,
258
- message: config.messages?.in || msg.in(field, config.in),
259
- });
260
- }
261
- if (
262
- config.equals !== undefined &&
263
- !validators.equals(value, config.equals)
264
- ) {
265
- messages.push(
266
- config.messages?.equals || msg.equals(field, config.equals),
267
- );
268
- errors.push({
269
- field: field,
270
- message:
271
- config.messages?.equals || msg.equals(field, config.equals),
272
- });
273
- }
274
- if (
275
- config.password &&
276
- !validators.matches(value, /^(?=.*[A-Z])(?=.*[a-z])(?=.*\d).{6,}$/)
277
- ) {
278
- messages.push(config.messages?.password || msg.password(field));
279
- errors.push({
280
- field: field,
281
- message: config.messages?.password || msg.password(field),
282
- });
283
- }
284
- if (config.pattern && !validators.matches(value, config.pattern)) {
285
- messages.push(config.messages?.pattern || msg.pattern(field));
286
- errors.push({
287
- field: field,
288
- message: config.messages?.pattern || msg.pattern(field),
289
- });
290
- }
291
- }
292
- }
293
-
294
- if (errors.length > 0 || messages.length > 0) {
295
- return {
296
- success: false,
297
- error: true,
298
- errors: errors,
299
- message: messages,
300
- };
301
- }
302
-
303
- return { success: true, error: false, errors: [], message: [], html: [] };
304
- }
305
-
306
- /**
307
- * Express middleware for automated validation of the request body.
308
- * Returns a 400 Bad Request response with validation results if errors occur.
309
- * @returns {Function} Express middleware function (req, res, next).
310
- * @example
311
- *
312
- * const loginSchema = {
313
- * email: { required: true, email: true },
314
- * password: { required: true, min: 6 }
315
- * };
316
- * const loginValidator = new Validator(loginSchema, 'es');
317
- * routerUsers.post('/login', loginValidator.middleware(), (req, res) => {
318
- * res.json({ message: 'Login successful' });
319
- * });
320
- */
321
- middleware() {
322
- return async (req, res, next) => {
323
- const result = await this.validate(req);
324
- if (!result.success) {
325
- return res.status(400).json(result);
326
- }
327
- next();
328
- };
329
- }
330
-
331
- /**
332
- * Express middleware for explicitly sanitizing request data against XSS.
333
- * Can be used on specific routes where HTML input is not expected.
334
- * @returns {Function} Express middleware function.
335
- */
336
- static xssMiddleware() {
337
- return (req, res, next) => {
338
- if (req.body && typeof req.body === "object") {
339
- Validator.mutateSanitized(req.body);
340
- }
341
- if (req.query && typeof req.query === "object") {
342
- Validator.mutateSanitized(req.query);
343
- }
344
- if (req.params && typeof req.params === "object") {
345
- Validator.mutateSanitized(req.params);
346
- }
347
- next();
348
- };
349
- }
350
-
351
- static mutateSanitized(obj) {
352
- for (const key in obj) {
353
- if (typeof obj[key] === "string") {
354
- obj[key] = xss(obj[key]);
355
- } else if (typeof obj[key] === "object" && obj[key] !== null) {
356
- Validator.mutateSanitized(obj[key]);
357
- }
358
- }
359
- }
360
-
361
- static sanitizeObject(obj) {
362
- if (typeof obj === "string") return xss(obj);
363
-
364
- if (Array.isArray(obj)) {
365
- return obj.map((item) => Validator.sanitizeObject(item));
366
- }
367
-
368
- if (typeof obj === "object" && obj !== null) {
369
- const sanitized = {};
370
- for (const key in obj) {
371
- sanitized[key] = Validator.sanitizeObject(obj[key]);
372
- }
373
- return sanitized;
374
- }
375
-
376
- return obj;
377
- }
378
- }
379
-
380
- export default Validator;
1
+ import xss from "xss";
2
+
3
+ const messages_default = {
4
+ es: {
5
+ required: (f) => `El campo ${f} es obligatorio`,
6
+ min: (f, n) => `El campo ${f} debe tener al menos ${n} caracteres`,
7
+ max: (f, n) => `El campo ${f} no puede tener más de ${n} caracteres`,
8
+ email: (f) => `El campo ${f} debe ser un email válido`,
9
+ number: (f) => `El campo ${f} debe ser numérico`,
10
+ alpha: (f) => `El campo ${f} solo puede contener letras`,
11
+ alphanumeric: (f) => `El campo ${f} solo puede contener letras y números`,
12
+ boolean: (f) => `El campo ${f} debe ser verdadero o falso`,
13
+ date: (f) => `El campo ${f} debe ser una fecha válida`,
14
+ url: (f) => `El campo ${f} debe ser una URL válida`,
15
+ in: (f, v) => `El campo ${f} debe ser uno de: ${v.join(", ")}`,
16
+ equals: (f, v) => `El campo ${f} debe ser igual a ${v}`,
17
+ password: () => `La contraseña debe tener mayúsculas, minúsculas y números`,
18
+ pattern: (f) => `El campo ${f} no cumple el patrón requerido`,
19
+ },
20
+ en: {
21
+ required: (f) => `${f} is required`,
22
+ min: (f, n) => `${f} must be at least ${n} characters`,
23
+ max: (f, n) => `${f} must be at most ${n} characters`,
24
+ email: (f) => `${f} must be a valid email`,
25
+ number: (f) => `${f} must be numeric`,
26
+ alpha: (f) => `${f} must contain only letters`,
27
+ alphanumeric: (f) => `${f} must contain only letters and numbers`,
28
+ boolean: (f) => `${f} must be true or false`,
29
+ date: (f) => `${f} must be a valid date`,
30
+ url: (f) => `${f} must be a valid URL`,
31
+ in: (f, v) => `${f} must be one of: ${v.join(", ")}`,
32
+ equals: (f, v) => `${f} must equal ${v}`,
33
+ password: () => `Password must contain uppercase, lowercase and numbers`,
34
+ pattern: (f) => `${f} does not match the required pattern`,
35
+ },
36
+ pt: {
37
+ required: (f) => `O campo ${f} é obrigatório`,
38
+ min: (f, n) => `O campo ${f} deve ter pelo menos ${n} caracteres`,
39
+ max: (f, n) => `O campo ${f} não pode ter mais de ${n} caracteres`,
40
+ email: (f) => `O campo ${f} deve ser um email válido`,
41
+ number: (f) => `O campo ${f} deve ser numérico`,
42
+ alpha: (f) => `O campo ${f} só pode conter letras`,
43
+ alphanumeric: (f) => `O campo ${f} só pode conter letras e números`,
44
+ boolean: (f) => `O campo ${f} deve ser verdadeiro ou falso`,
45
+ date: (f) => `O campo ${f} deve ser uma data válida`,
46
+ url: (f) => `O campo ${f} deve ser uma URL válida`,
47
+ in: (f, v) => `O campo ${f} deve ser um de: ${v.join(", ")}`,
48
+ equals: (f, v) => `O campo ${f} deve ser igual a ${v}`,
49
+ password: () => `A senha deve conter maiúsculas, minúsculas e números`,
50
+ pattern: (f) => `O campo ${f} não corresponde ao padrão exigido`,
51
+ },
52
+ br: {
53
+ required: (f) => `O campo ${f} é obrigatório`,
54
+ min: (f, n) => `O campo ${f} deve ter pelo menos ${n} caracteres`,
55
+ max: (f, n) => `O campo ${f} não pode ter mais de ${n} caracteres`,
56
+ email: (f) => `O campo ${f} deve ser um email válido`,
57
+ number: (f) => `O campo ${f} deve ser numérico`,
58
+ alpha: (f) => `O campo ${f} só pode conter letras`,
59
+ alphanumeric: (f) => `O campo ${f} só pode conter letras e números`,
60
+ boolean: (f) => `O campo ${f} deve ser verdadeiro ou falso`,
61
+ date: (f) => `O campo ${f} deve ser uma data válida`,
62
+ url: (f) => `O campo ${f} deve ser uma URL válida`,
63
+ in: (f, v) => `O campo ${f} deve ser um de: ${v.join(", ")}`,
64
+ equals: (f, v) => `O campo ${f} deve ser igual a ${v}`,
65
+ password: () => `A senha deve conter maiúsculas, minúsculas e números`,
66
+ pattern: (f) => `O campo ${f} não corresponde ao padrão exigido`,
67
+ },
68
+ fr: {
69
+ required: (f) => `Le champ ${f} est obligatoire`,
70
+ min: (f, n) => `Le champ ${f} doit contenir au moins ${n} caractères`,
71
+ max: (f, n) => `Le champ ${f} ne peut pas contenir plus de ${n} caractères`,
72
+ email: (f) => `Le champ ${f} doit être un email valide`,
73
+ number: (f) => `Le champ ${f} doit être numérique`,
74
+ alpha: (f) => `Le champ ${f} ne peut contenir que des lettres`,
75
+ alphanumeric: (f) =>
76
+ `Le champ ${f} ne peut contenir que des lettres et des chiffres`,
77
+ boolean: (f) => `Le champ ${f} doit être vrai ou faux`,
78
+ date: (f) => `Le champ ${f} doit être une date valide`,
79
+ url: (f) => `Le champ ${f} doit être une URL valide`,
80
+ in: (f, v) => `Le champ ${f} doit être l'un de: ${v.join(", ")}`,
81
+ equals: (f, v) => `Le champ ${f} doit être égal à ${v}`,
82
+ password: () =>
83
+ `Le mot de passe doit contenir des majuscules, des minuscules et des chiffres`,
84
+ pattern: (f) => `Le champ ${f} ne correspond pas au modèle requis`,
85
+ },
86
+ };
87
+
88
+ const validators = {
89
+ isEmpty: (value) => value === undefined || value === null || value === "",
90
+ isEmail: (value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value),
91
+ isNumeric: (value) => !isNaN(value) && !isNaN(parseFloat(value)),
92
+ isAlpha: (value) => /^[a-zA-Z]+$/.test(value),
93
+ isAlphanumeric: (value) => /^[a-zA-Z0-9]+$/.test(value),
94
+ isBoolean: (value) =>
95
+ value === true || value === false || value === "true" || value === "false",
96
+ isISO8601: (value) => !isNaN(Date.parse(value)),
97
+ isURL: (value) => {
98
+ try {
99
+ new URL(value);
100
+ return true;
101
+ } catch {
102
+ return false;
103
+ }
104
+ },
105
+ isLength: (value, { min, max }) => {
106
+ const len = String(value).length;
107
+ if (min !== undefined && len < min) return false;
108
+ if (max !== undefined && len > max) return false;
109
+ return true;
110
+ },
111
+ isIn: (value, values) => values.includes(value),
112
+ equals: (value, comparison) => value === comparison,
113
+ matches: (value, pattern) => pattern.test(value),
114
+ };
115
+
116
+ /**
117
+ * Comprehensive Validator class for handling multi-language data validation.
118
+ */
119
+ class Validator {
120
+ /**
121
+ * Initializes the Validator instance with a schema and optional language settings.
122
+ * @param {Object} schema - Validation rules for each field (e.g., { email: { required: true, email: true } }).
123
+ * @param {string} [lang_default=null] - Default language for error messages (e.g., "en", "es").
124
+ * @param {Object} [messages=null] - Custom message overrides for validation rules.
125
+ * @example
126
+ * const loginSchema = {
127
+ * email: { required: true, email: true },
128
+ * password: { required: true, min: 6 }
129
+ * };
130
+ * const loginValidator = new Validator(loginSchema, 'es');
131
+ */
132
+ constructor(schema, lang_default = null, messages = null) {
133
+ this.schema = schema;
134
+ this.lang_default = lang_default;
135
+ this.messages = messages ? messages : messages_default;
136
+ }
137
+
138
+ /**
139
+ * Validates the request body against the defined schema.
140
+ * @param {import('express').Request} req - The Express request object containing the body to validate.
141
+ * @returns {Promise<{success: boolean, error: boolean, errors: Array<{field: string, message: string}>, message: Array<string>, html: Array<string>}>} Validation results.
142
+ * @example
143
+ * const loginSchema = {
144
+ * email: { required: true, email: true },
145
+ * password: { required: true, min: 6 }
146
+ * };
147
+ * const loginValidator = new Validator(loginSchema, 'es');
148
+ * const result = await loginValidator.validate(req);
149
+ */
150
+ async validate(req) {
151
+ let lang =
152
+ req?.body?.lang ||
153
+ req?.query?.lang ||
154
+ req?.params?.lang ||
155
+ req?.cookies?.lang ||
156
+ req?.headers["accept-language"]?.split(",")[0]?.split("-")[0] ||
157
+ req?.session?.lang ||
158
+ this.lang_default ||
159
+ "es";
160
+ const msg = this.messages[lang] || this.messages.es;
161
+ const errors = [];
162
+ const messages = [];
163
+ const body = req.body || {};
164
+
165
+ for (const [field, config] of Object.entries(this.schema)) {
166
+ let value = body[field];
167
+
168
+ if (config.xss !== false && typeof value === "string") {
169
+ body[field] = xss(value);
170
+ value = body[field];
171
+ }
172
+
173
+ if (config.required && validators.isEmpty(value)) {
174
+ messages.push(config.messages?.required || msg.required(field));
175
+ errors.push({
176
+ field: field,
177
+ message: config.messages?.required || msg.required(field),
178
+ });
179
+ continue;
180
+ }
181
+
182
+ if (!validators.isEmpty(value)) {
183
+ if (
184
+ config.min !== undefined &&
185
+ !validators.isLength(value, { min: config.min })
186
+ ) {
187
+ messages.push(config.messages?.min || msg.min(field, config.min));
188
+ errors.push({
189
+ field: field,
190
+ message: config.messages?.min || msg.min(field, config.min),
191
+ });
192
+ }
193
+ if (
194
+ config.max !== undefined &&
195
+ !validators.isLength(value, { max: config.max })
196
+ ) {
197
+ messages.push(config.messages?.max || msg.max(field, config.max));
198
+ errors.push({
199
+ field: field,
200
+ message: config.messages?.max || msg.max(field, config.max),
201
+ });
202
+ }
203
+ if (config.email && !validators.isEmail(value)) {
204
+ messages.push(config.messages?.email || msg.email(field));
205
+ errors.push({
206
+ field: field,
207
+ message: config.messages?.email || msg.email(field),
208
+ });
209
+ }
210
+ if (config.number && !validators.isNumeric(value)) {
211
+ messages.push(config.messages?.number || msg.number(field));
212
+ errors.push({
213
+ field: field,
214
+ message: config.messages?.number || msg.number(field),
215
+ });
216
+ }
217
+ if (config.alpha && !validators.isAlpha(value)) {
218
+ messages.push(config.messages?.alpha || msg.alpha(field));
219
+ errors.push({
220
+ field: field,
221
+ message: config.messages?.alpha || msg.alpha(field),
222
+ });
223
+ }
224
+ if (config.alphanumeric && !validators.isAlphanumeric(value)) {
225
+ messages.push(
226
+ config.messages?.alphanumeric || msg.alphanumeric(field),
227
+ );
228
+ errors.push({
229
+ field: field,
230
+ message: config.messages?.alphanumeric || msg.alphanumeric(field),
231
+ });
232
+ }
233
+ if (config.boolean && !validators.isBoolean(value)) {
234
+ messages.push(config.messages?.boolean || msg.boolean(field));
235
+ errors.push({
236
+ field: field,
237
+ message: config.messages?.boolean || msg.boolean(field),
238
+ });
239
+ }
240
+ if (config.date && !validators.isISO8601(value)) {
241
+ messages.push(config.messages?.date || msg.date(field));
242
+ errors.push({
243
+ field: field,
244
+ message: config.messages?.date || msg.date(field),
245
+ });
246
+ }
247
+ if (config.url && !validators.isURL(value)) {
248
+ messages.push(config.messages?.url || msg.url(field));
249
+ errors.push({
250
+ field: field,
251
+ message: config.messages?.url || msg.url(field),
252
+ });
253
+ }
254
+ if (config.in && !validators.isIn(value, config.in)) {
255
+ messages.push(config.messages?.in || msg.in(field, config.in));
256
+ errors.push({
257
+ field: field,
258
+ message: config.messages?.in || msg.in(field, config.in),
259
+ });
260
+ }
261
+ if (
262
+ config.equals !== undefined &&
263
+ !validators.equals(value, config.equals)
264
+ ) {
265
+ messages.push(
266
+ config.messages?.equals || msg.equals(field, config.equals),
267
+ );
268
+ errors.push({
269
+ field: field,
270
+ message:
271
+ config.messages?.equals || msg.equals(field, config.equals),
272
+ });
273
+ }
274
+ if (
275
+ config.password &&
276
+ !validators.matches(value, /^(?=.*[A-Z])(?=.*[a-z])(?=.*\d).{6,}$/)
277
+ ) {
278
+ messages.push(config.messages?.password || msg.password(field));
279
+ errors.push({
280
+ field: field,
281
+ message: config.messages?.password || msg.password(field),
282
+ });
283
+ }
284
+ if (config.pattern && !validators.matches(value, config.pattern)) {
285
+ messages.push(config.messages?.pattern || msg.pattern(field));
286
+ errors.push({
287
+ field: field,
288
+ message: config.messages?.pattern || msg.pattern(field),
289
+ });
290
+ }
291
+ }
292
+ }
293
+
294
+ if (errors.length > 0 || messages.length > 0) {
295
+ return {
296
+ success: false,
297
+ error: true,
298
+ errors: errors,
299
+ message: messages,
300
+ };
301
+ }
302
+
303
+ return { success: true, error: false, errors: [], message: [], html: [] };
304
+ }
305
+
306
+ /**
307
+ * Express middleware for automated validation of the request body.
308
+ * Returns a 400 Bad Request response with validation results if errors occur.
309
+ * @returns {Function} Express middleware function (req, res, next).
310
+ * @example
311
+ *
312
+ * const loginSchema = {
313
+ * email: { required: true, email: true },
314
+ * password: { required: true, min: 6 }
315
+ * };
316
+ * const loginValidator = new Validator(loginSchema, 'es');
317
+ * routerUsers.post('/login', loginValidator.middleware(), (req, res) => {
318
+ * res.json({ message: 'Login successful' });
319
+ * });
320
+ */
321
+ middleware() {
322
+ return async (req, res, next) => {
323
+ const result = await this.validate(req);
324
+ if (!result.success) {
325
+ return res.status(400).json(result);
326
+ }
327
+ next();
328
+ };
329
+ }
330
+
331
+ /**
332
+ * Express middleware for explicitly sanitizing request data against XSS.
333
+ * Can be used on specific routes where HTML input is not expected.
334
+ * @returns {Function} Express middleware function.
335
+ */
336
+ static xssMiddleware() {
337
+ return (req, res, next) => {
338
+ if (req.body && typeof req.body === "object") {
339
+ Validator.mutateSanitized(req.body);
340
+ }
341
+ if (req.query && typeof req.query === "object") {
342
+ Validator.mutateSanitized(req.query);
343
+ }
344
+ if (req.params && typeof req.params === "object") {
345
+ Validator.mutateSanitized(req.params);
346
+ }
347
+ next();
348
+ };
349
+ }
350
+
351
+ static mutateSanitized(obj) {
352
+ for (const key in obj) {
353
+ if (typeof obj[key] === "string") {
354
+ obj[key] = xss(obj[key]);
355
+ } else if (typeof obj[key] === "object" && obj[key] !== null) {
356
+ Validator.mutateSanitized(obj[key]);
357
+ }
358
+ }
359
+ }
360
+
361
+ static sanitizeObject(obj) {
362
+ if (typeof obj === "string") return xss(obj);
363
+
364
+ if (Array.isArray(obj)) {
365
+ return obj.map((item) => Validator.sanitizeObject(item));
366
+ }
367
+
368
+ if (typeof obj === "object" && obj !== null) {
369
+ const sanitized = {};
370
+ for (const key in obj) {
371
+ sanitized[key] = Validator.sanitizeObject(obj[key]);
372
+ }
373
+ return sanitized;
374
+ }
375
+
376
+ return obj;
377
+ }
378
+ }
379
+
380
+ export default Validator;