@astratra/saas-kit 0.1.0 → 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 le WAF, le rate limiting, l'auth JWT,
12
- l'autorisation par rôle, 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.
@@ -21,6 +22,9 @@ const { createSaasApp } = require('@astratra/saas-kit');
21
22
 
22
23
  const app = createSaasApp({
23
24
  jwtSecret: process.env.JWT_SECRET,
25
+ jwtAlgorithms: ['HS256'],
26
+ jwtIssuer: 'mon-app',
27
+ jwtAudience: 'mon-api',
24
28
  usersStore,
25
29
  settingsStore,
26
30
  verifyPassword: async (user, password) => passwordService.verify(user, password),
@@ -47,9 +51,25 @@ app.listen(3000);
47
51
  - `GET /dashboard/summary`
48
52
 
49
53
  Toutes les routes protégées suivent le même ordre de middlewares de
50
- sécurité que la mini-app de démo : request id, parseur JSON, WAF, limiteur
51
- API, limiteur de login pour `/auth`, auth JWT pour les modules protégés,
52
- 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.
58
+
59
+ `jwtAlgorithms` vaut `['HS256']` par defaut. `jwtIssuer` et `jwtAudience` sont
60
+ optionnels, mais recommandes des qu'une app sort du simple developpement local.
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é.
53
73
 
54
74
  ## Adapters requis
55
75
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/saas-kit",
3
- "version": "0.1.0",
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.0",
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');
@@ -27,6 +28,7 @@ const DEFAULT_ROLES = {
27
28
 
28
29
  function normalizeOptions(options = {}) {
29
30
  const jwtSecret = options.jwtSecret || process.env.JWT_SECRET || DEFAULT_JWT_SECRET;
31
+ const jwtAlgorithms = options.jwtAlgorithms || ['HS256'];
30
32
  const usersStore = options.usersStore || createMemoryUsersStore();
31
33
  const settingsStore = options.settingsStore || createMemorySettingsStore();
32
34
  const notify = options.notify;
@@ -46,6 +48,9 @@ function normalizeOptions(options = {}) {
46
48
  return {
47
49
  ...options,
48
50
  jwtSecret,
51
+ jwtAlgorithms,
52
+ jwtIssuer: options.jwtIssuer,
53
+ jwtAudience: options.jwtAudience,
49
54
  usersStore,
50
55
  settingsStore,
51
56
  notify,
@@ -60,6 +65,7 @@ function createSaasApp(options = {}) {
60
65
  const app = express();
61
66
 
62
67
  app.use(requestIdMiddleware);
68
+ app.use(createCspMiddleware(normalized.csp));
63
69
  app.use(express.json());
64
70
  app.use(createWafMiddleware(normalized.waf));
65
71
  app.use(createApiLimiter(normalized.apiRateLimit));
@@ -67,6 +73,9 @@ function createSaasApp(options = {}) {
67
73
  const authMiddleware = createAuthMiddleware({
68
74
  secret: normalized.jwtSecret,
69
75
  legacySecret: normalized.legacyJwtSecret,
76
+ algorithms: normalized.jwtAlgorithms,
77
+ issuer: normalized.jwtIssuer,
78
+ audience: normalized.jwtAudience,
70
79
  verifySession: normalized.verifySession,
71
80
  extractToken: normalized.extractToken
72
81
  });
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,
@@ -67,6 +68,9 @@ export interface CreateSaasAppOptions {
67
68
  jwtSecret?: string;
68
69
  legacyJwtSecret?: string;
69
70
  jwtExpiresIn?: string | number;
71
+ jwtAlgorithms?: string[];
72
+ jwtIssuer?: string;
73
+ jwtAudience?: string | string[];
70
74
  usersStore?: UsersStore;
71
75
  settingsStore?: SettingsStore;
72
76
  notify: (userId: string, notification: NotificationPayload) => Awaitable<unknown>;
@@ -78,6 +82,7 @@ export interface CreateSaasAppOptions {
78
82
  webauthnStore?: WebauthnStore;
79
83
  webauthn?: WebauthnOptions;
80
84
  waf?: WafOptions;
85
+ csp?: CspOptions;
81
86
  apiRateLimit?: RateLimitOptions;
82
87
  loginRateLimit?: LoginLimiterOptions;
83
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) {
@@ -25,7 +29,12 @@ function createAuthRoutes(options) {
25
29
  }
26
30
 
27
31
  const publicUser = pickPublicUser(user, publicUserFields);
28
- const token = jwt.sign(publicUser, jwtSecret, { expiresIn: options.jwtExpiresIn || '1h' });
32
+ const token = jwt.sign(publicUser, jwtSecret, {
33
+ expiresIn: options.jwtExpiresIn || '1h',
34
+ algorithm: options.jwtAlgorithms[0],
35
+ ...(options.jwtIssuer ? { issuer: options.jwtIssuer } : {}),
36
+ ...(options.jwtAudience ? { audience: options.jwtAudience } : {})
37
+ });
29
38
  return apiResponse(res, 200, 'Login successful', { token, user: publicUser });
30
39
  }));
31
40
 
@@ -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
  };