@astratra/saas-kit 0.1.1 → 1.0.0

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.
package/README.md CHANGED
@@ -8,8 +8,9 @@ génériques auth, users, settings, notifications et dashboard. Il assemble :
8
8
 
9
9
  - `@astratra/core` pour les request IDs, le format de réponse API, le 404 et
10
10
  la gestion d'erreurs.
11
- - `@astratra/security` pour les primitives JWT/RBAC, le rate limiting, le WAF
12
- heuristique et le service WebAuthn optionnel.
11
+ - `@astratra/security` pour les primitives JWT/RBAC, le rate limiting, une
12
+ CSP restrictive par défaut, le WAF heuristique et le service WebAuthn
13
+ optionnel.
13
14
  - `@astratra/ai` en dépendance du package pour qu'un projet puisse composer
14
15
  des fonctionnalités IA à côté du starter, sans que le kit n'impose de
15
16
  routes IA métier.
@@ -50,13 +51,26 @@ app.listen(3000);
50
51
  - `GET /dashboard/summary`
51
52
 
52
53
  Toutes les routes protégées suivent le même ordre de middlewares de
53
- sécurité que la mini-app de démo : request id, parseur JSON, WAF heuristique,
54
- limiteur API, limiteur de login pour `/auth`, auth JWT pour les modules protégés,
55
- puis 404 et gestion d'erreurs.
54
+ sécurité que la mini-app de démo : request id, CSP (`default-src 'none'` par
55
+ défaut, adapté à une API JSON — surchargeable via `options.csp`), parseur
56
+ JSON, WAF heuristique, limiteur API, limiteur de login pour `/auth`, auth JWT
57
+ pour les modules protégés, puis 404 et gestion d'erreurs.
56
58
 
57
59
  `jwtAlgorithms` vaut `['HS256']` par defaut. `jwtIssuer` et `jwtAudience` sont
58
60
  optionnels, mais recommandes des qu'une app sort du simple developpement local.
59
61
 
62
+ ## Validation des entrées
63
+
64
+ `POST /auth/login`, `POST /users`, `PATCH /settings/:key` et
65
+ `POST /notifications/send` valident leur payload via
66
+ `validateMiddleware` (`@astratra/core`) et `express-validator` avant
67
+ d'appeler ton store — email au bon format, champs requis réellement présents
68
+ (pas juste "truthy"), longueurs raisonnables sur les champs texte libres
69
+ (titre, message). Une entrée invalide renvoie `400` avant même de toucher
70
+ `usersStore`/`settingsStore`/`notify`. Le kit ne valide que les champs qu'il
71
+ connaît lui-même — le reste du payload (champs propres à ton store) passe
72
+ tel quel, sans schéma imposé.
73
+
60
74
  ## Adapters requis
61
75
 
62
76
  Une vraie application en production doit injecter ses propres adapters. Le
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/saas-kit",
3
- "version": "0.1.1",
3
+ "version": "1.0.0",
4
4
  "description": "Reusable backend starter kit that assembles Astratra core, security, and AI packages.",
5
5
  "main": "src/index.js",
6
6
  "types": "src/index.d.ts",
@@ -21,10 +21,11 @@
21
21
  "access": "public"
22
22
  },
23
23
  "dependencies": {
24
- "@astratra/ai": "^0.1.0",
25
- "@astratra/core": "^0.1.0",
26
- "@astratra/security": "^0.1.1",
24
+ "@astratra/ai": "^1.0.0",
25
+ "@astratra/core": "^1.0.0",
26
+ "@astratra/security": "^1.0.0",
27
27
  "express": "^4.18.3",
28
+ "express-validator": "^7.3.2",
28
29
  "jsonwebtoken": "^9.0.2"
29
30
  },
30
31
  "devDependencies": {
package/src/app.js CHANGED
@@ -8,6 +8,7 @@ const {
8
8
  authorizeRoles,
9
9
  createApiLimiter,
10
10
  createAuthMiddleware,
11
+ createCspMiddleware,
11
12
  createLoginLimiter,
12
13
  createWafMiddleware
13
14
  } = require('@astratra/security');
@@ -64,6 +65,7 @@ function createSaasApp(options = {}) {
64
65
  const app = express();
65
66
 
66
67
  app.use(requestIdMiddleware);
68
+ app.use(createCspMiddleware(normalized.csp));
67
69
  app.use(express.json());
68
70
  app.use(createWafMiddleware(normalized.waf));
69
71
  app.use(createApiLimiter(normalized.apiRateLimit));
package/src/index.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import type {
2
2
  AuthMiddlewareOptions,
3
+ CspOptions,
3
4
  LoginLimiterOptions,
4
5
  RateLimitOptions,
5
6
  WafOptions,
@@ -81,6 +82,7 @@ export interface CreateSaasAppOptions {
81
82
  webauthnStore?: WebauthnStore;
82
83
  webauthn?: WebauthnOptions;
83
84
  waf?: WafOptions;
85
+ csp?: CspOptions;
84
86
  apiRateLimit?: RateLimitOptions;
85
87
  loginRateLimit?: LoginLimiterOptions;
86
88
  [key: string]: unknown;
@@ -1,8 +1,14 @@
1
1
  const express = require('express');
2
2
  const jwt = require('jsonwebtoken');
3
- const { apiResponse, AppError, asyncHandler } = require('@astratra/core');
3
+ const { body } = require('express-validator');
4
+ const { apiResponse, AppError, asyncHandler, validateMiddleware } = require('@astratra/core');
4
5
  const { createWebauthnService } = require('@astratra/security');
5
- const { pickPublicUser, requireBodyFields } = require('../utils');
6
+ const { pickPublicUser } = require('../utils');
7
+
8
+ const loginValidation = [
9
+ body('email').isEmail().withMessage('email must be a valid email address'),
10
+ body('password').notEmpty().withMessage('password is required')
11
+ ];
6
12
 
7
13
  function createAuthRoutes(options) {
8
14
  const router = express.Router();
@@ -15,9 +21,7 @@ function createAuthRoutes(options) {
15
21
  webauthn
16
22
  } = options;
17
23
 
18
- router.post('/login', asyncHandler(async (req, res) => {
19
- requireBodyFields(req.body || {}, ['email', 'password']);
20
-
24
+ router.post('/login', validateMiddleware(loginValidation), asyncHandler(async (req, res) => {
21
25
  const user = await usersStore.findByEmail(req.body.email);
22
26
  const valid = user ? await verifyPassword(user, req.body.password) : false;
23
27
  if (!user || !valid) {
@@ -1,14 +1,19 @@
1
1
  const express = require('express');
2
- const { apiResponse, asyncHandler } = require('@astratra/core');
3
- const { requireBodyFields } = require('../utils');
2
+ const { body } = require('express-validator');
3
+ const { apiResponse, asyncHandler, validateMiddleware } = require('@astratra/core');
4
+
5
+ const sendNotificationValidation = [
6
+ body('userId').trim().notEmpty().withMessage('userId is required'),
7
+ body('title').trim().notEmpty().isLength({ max: 200 }).withMessage('title must be between 1 and 200 characters'),
8
+ body('message').trim().notEmpty().isLength({ max: 5000 }).withMessage('message must be between 1 and 5000 characters')
9
+ ];
4
10
 
5
11
  function createNotificationsRoutes({ notify, authorizeAdmin }) {
6
12
  const router = express.Router();
7
13
 
8
14
  router.use(authorizeAdmin);
9
15
 
10
- router.post('/send', asyncHandler(async (req, res) => {
11
- requireBodyFields(req.body || {}, ['userId', 'title', 'message']);
16
+ router.post('/send', validateMiddleware(sendNotificationValidation), asyncHandler(async (req, res) => {
12
17
  const notification = {
13
18
  title: req.body.title,
14
19
  message: req.body.message,
@@ -1,6 +1,11 @@
1
1
  const express = require('express');
2
- const { apiResponse, asyncHandler } = require('@astratra/core');
3
- const { requireBodyFields } = require('../utils');
2
+ const { body, param } = require('express-validator');
3
+ const { apiResponse, asyncHandler, validateMiddleware } = require('@astratra/core');
4
+
5
+ const updateSettingValidation = [
6
+ param('key').trim().notEmpty().isLength({ max: 200 }).withMessage('key must be between 1 and 200 characters'),
7
+ body('value').exists().withMessage('value is required')
8
+ ];
4
9
 
5
10
  function createSettingsRoutes({ settingsStore, authorizeAdmin }) {
6
11
  const router = express.Router();
@@ -12,8 +17,7 @@ function createSettingsRoutes({ settingsStore, authorizeAdmin }) {
12
17
  return apiResponse(res, 200, 'Settings list', settings);
13
18
  }));
14
19
 
15
- router.patch('/:key', asyncHandler(async (req, res) => {
16
- requireBodyFields(req.body || {}, ['value']);
20
+ router.patch('/:key', validateMiddleware(updateSettingValidation), asyncHandler(async (req, res) => {
17
21
  const value = await settingsStore.set(req.params.key, req.body.value);
18
22
  return apiResponse(res, 200, 'Setting updated', { key: req.params.key, value });
19
23
  }));
@@ -1,6 +1,16 @@
1
1
  const express = require('express');
2
- const { apiResponse, AppError, asyncHandler } = require('@astratra/core');
3
- const { requireBodyFields, sanitizeUser, toPagination } = require('../utils');
2
+ const { body, param } = require('express-validator');
3
+ const { apiResponse, AppError, asyncHandler, validateMiddleware } = require('@astratra/core');
4
+ const { sanitizeUser, toPagination } = require('../utils');
5
+
6
+ const createUserValidation = [
7
+ body('email').isEmail().withMessage('email must be a valid email address'),
8
+ body('role').optional().isString().trim().notEmpty().withMessage('role must not be empty when provided')
9
+ ];
10
+
11
+ const userIdValidation = [
12
+ param('id').notEmpty().withMessage('id is required')
13
+ ];
4
14
 
5
15
  function createUsersRoutes({ usersStore, authorizeAdmin }) {
6
16
  const router = express.Router();
@@ -17,7 +27,7 @@ function createUsersRoutes({ usersStore, authorizeAdmin }) {
17
27
  });
18
28
  }));
19
29
 
20
- router.get('/:id', asyncHandler(async (req, res) => {
30
+ router.get('/:id', validateMiddleware(userIdValidation), asyncHandler(async (req, res) => {
21
31
  const user = await usersStore.findById(req.params.id);
22
32
  if (!user) {
23
33
  throw new AppError('User not found.', 404);
@@ -26,13 +36,12 @@ function createUsersRoutes({ usersStore, authorizeAdmin }) {
26
36
  return apiResponse(res, 200, 'User found', sanitizeUser(user));
27
37
  }));
28
38
 
29
- router.post('/', asyncHandler(async (req, res) => {
30
- requireBodyFields(req.body || {}, ['email']);
39
+ router.post('/', validateMiddleware(createUserValidation), asyncHandler(async (req, res) => {
31
40
  const user = await usersStore.create(req.body);
32
41
  return apiResponse(res, 201, 'User created', sanitizeUser(user));
33
42
  }));
34
43
 
35
- router.patch('/:id', asyncHandler(async (req, res) => {
44
+ router.patch('/:id', validateMiddleware(userIdValidation), asyncHandler(async (req, res) => {
36
45
  const user = await usersStore.update(req.params.id, req.body || {});
37
46
  if (!user) {
38
47
  throw new AppError('User not found.', 404);
package/src/utils.js CHANGED
@@ -1,5 +1,3 @@
1
- const { AppError } = require('@astratra/core');
2
-
3
1
  const DEFAULT_PUBLIC_USER_FIELDS = ['id', 'email', 'role'];
4
2
  const SENSITIVE_USER_FIELDS = new Set(['password', 'passwordHash', 'hash', 'salt', 'tokens']);
5
3
 
@@ -41,19 +39,10 @@ function toPagination(query = {}) {
41
39
  };
42
40
  }
43
41
 
44
- function requireBodyFields(body, fields) {
45
- for (const field of fields) {
46
- if (body[field] === undefined || body[field] === null || body[field] === '') {
47
- throw new AppError(`${field} is required.`, 400);
48
- }
49
- }
50
- }
51
-
52
42
  module.exports = {
53
43
  DEFAULT_PUBLIC_USER_FIELDS,
54
44
  assertAdapter,
55
45
  pickPublicUser,
56
- requireBodyFields,
57
46
  sanitizeUser,
58
47
  toPagination
59
48
  };