@astratra/saas-kit 1.2.0 → 1.3.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
@@ -87,6 +87,27 @@ L'app retournée expose aussi directement `app.authMiddleware`,
87
87
  `app.csrfMiddleware` et `app.authorizeAdmin`, au cas où tu préfères les
88
88
  monter toi-même après coup plutôt que via `extendRoutes`.
89
89
 
90
+ ## CORS
91
+
92
+ `options.cors` active le CORS pour toute l'app en un seul champ de
93
+ configuration — origines autorisées, credentials, headers/méthodes — sans
94
+ middleware à écrire ni à monter toi-même. Astratra ne fixe pas de liste
95
+ d'origines par défaut (chaque projet a la sienne), mais gère le montage :
96
+ `createCorsMiddleware` (`@astratra/security`) est posé tout en premier,
97
+ avant absolument tout le reste, garantissant que les en-têtes CORS
98
+ s'appliquent à chaque route — y compris la réponse de preflight `OPTIONS` :
99
+
100
+ ```js
101
+ const app = createSaasApp({
102
+ // ...
103
+ cors: { allowedOrigins: [process.env.WEB_ORIGIN] }
104
+ });
105
+ ```
106
+
107
+ S'applique aussi bien aux routes intégrées (`/auth`, `/users`, ...) qu'à
108
+ celles ajoutées via `extendRoutes`. Omets `options.cors` et rien ne change —
109
+ comme avant, à toi de gérer CORS si tu en as besoin.
110
+
90
111
  Le cookie CSRF (`astratra_csrf`) est amorcé automatiquement sur toute
91
112
  requête sûre (GET/HEAD/OPTIONS) dès le démarrage de l'app — y compris tes
92
113
  propres routes `GET` ajoutées via `extendRoutes` — donc pas besoin de monter
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/saas-kit",
3
- "version": "1.2.0",
3
+ "version": "1.3.0",
4
4
  "description": "Reusable backend starter kit that assembles Astratra core, security, and AI packages.",
5
5
  "engines": {
6
6
  "node": ">=20"
@@ -26,7 +26,7 @@
26
26
  "dependencies": {
27
27
  "@astratra/ai": "^1.0.0",
28
28
  "@astratra/core": "^1.0.0",
29
- "@astratra/security": "^1.2.0",
29
+ "@astratra/security": "^1.3.0",
30
30
  "express": "^4.18.3",
31
31
  "express-validator": "^7.3.2",
32
32
  "jsonwebtoken": "^9.0.2"
package/src/app.js CHANGED
@@ -9,6 +9,7 @@ const {
9
9
  cookieParserMiddleware,
10
10
  createApiLimiter,
11
11
  createAuthMiddleware,
12
+ createCorsMiddleware,
12
13
  createCspMiddleware,
13
14
  createCsrfCookiePrimer,
14
15
  createCsrfMiddleware,
@@ -75,6 +76,16 @@ function createSaasApp(options = {}) {
75
76
  const normalized = normalizeOptions(options);
76
77
  const app = express();
77
78
 
79
+ // Astratra imposes no fixed CORS policy — which origins to allow is
80
+ // project-specific — but leaves the primitive available so consumers
81
+ // don't reinvent it. Mounted FIRST, ahead of everything else: CORS
82
+ // headers (including on the OPTIONS preflight response) must be set
83
+ // before any other middleware can short-circuit the request. Omit
84
+ // options.cors and this is a no-op, unchanged from before.
85
+ if (normalized.cors) {
86
+ app.use(createCorsMiddleware(normalized.cors === true ? {} : normalized.cors));
87
+ }
88
+
78
89
  app.use(requestIdMiddleware);
79
90
  app.use(cookieParserMiddleware());
80
91
  // Seeds the CSRF cookie on every safe request (GET/HEAD/OPTIONS), globally,
package/src/index.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import type {
2
2
  AuthMiddlewareOptions,
3
+ CorsMiddlewareOptions,
3
4
  CsrfMiddlewareOptions,
4
5
  CspOptions,
5
6
  LoginLimiterOptions,
@@ -101,6 +102,14 @@ export interface CreateSaasAppOptions {
101
102
  publicUserFields?: string[];
102
103
  cookie?: SessionCookieOptions;
103
104
  csrf?: CsrfMiddlewareOptions;
105
+ /**
106
+ * Mounts createCorsMiddleware as the FIRST middleware, ahead of
107
+ * everything else — required for CORS headers to reach the preflight
108
+ * OPTIONS response. `true` uses the default (dev origins only, no
109
+ * explicit allow-list). Omit entirely for no CORS handling (unchanged
110
+ * default behavior).
111
+ */
112
+ cors?: CorsMiddlewareOptions | true;
104
113
  webauthnStore?: WebauthnStore;
105
114
  webauthn?: WebauthnOptions;
106
115
  waf?: WafOptions;