@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 +25 -5
- package/package.json +5 -4
- package/src/app.js +9 -0
- package/src/index.d.ts +5 -0
- package/src/modules/auth.js +15 -6
- package/src/modules/notifications.js +9 -4
- package/src/modules/settings.js +8 -4
- package/src/modules/users.js +15 -6
- package/src/utils.js +0 -11
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
|
|
12
|
-
|
|
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,
|
|
51
|
-
|
|
52
|
-
|
|
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": "
|
|
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": "^
|
|
25
|
-
"@astratra/core": "^
|
|
26
|
-
"@astratra/security": "^
|
|
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;
|
package/src/modules/auth.js
CHANGED
|
@@ -1,8 +1,14 @@
|
|
|
1
1
|
const express = require('express');
|
|
2
2
|
const jwt = require('jsonwebtoken');
|
|
3
|
-
const {
|
|
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
|
|
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, {
|
|
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 {
|
|
3
|
-
const {
|
|
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,
|
package/src/modules/settings.js
CHANGED
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
const express = require('express');
|
|
2
|
-
const {
|
|
3
|
-
const {
|
|
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
|
}));
|
package/src/modules/users.js
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
const express = require('express');
|
|
2
|
-
const {
|
|
3
|
-
const {
|
|
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
|
};
|