@astratra/saas-kit 1.6.1 → 1.7.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/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Astratra
3
+ Copyright (c) 2026 Astratra contributors
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -90,6 +90,30 @@ L'app retournée expose aussi directement `app.authMiddleware`,
90
90
  `app.csrfMiddleware` et `app.authorizeAdmin`, au cas où tu préfères les
91
91
  monter toi-même après coup plutôt que via `extendRoutes`.
92
92
 
93
+ ### Ouvrir une session depuis ta propre route (Google, Apple, invitation)
94
+
95
+ Quand ta route a prouvé l'identité elle-même (jeton d'identité vérifié par
96
+ `createGoogleIdTokenVerifier` de `@astratra/security`, invitation acceptée),
97
+ `issueSession(res, compte)` ouvre **exactement** la session de `/auth/login` :
98
+ même jeton d'accès, même cookie `HttpOnly`, même chaîne de renouvellement.
99
+ Une seule fabrique, pour que les deux portes ne divergent jamais.
100
+
101
+ ```js
102
+ createSaasApp({
103
+ // ...
104
+ extendRoutes: (app, { issueSession }) => {
105
+ app.post('/auth/external/google', async (req, res) => {
106
+ const profile = await google(req.body.idToken);
107
+ const account = await accounts.findBySubject('google', profile.subject);
108
+ if (!account) return res.status(403).json({ code: 'not_invited' });
109
+ res.json(await issueSession(res, account)); // { token, user, refreshToken? }
110
+ });
111
+ }
112
+ });
113
+ ```
114
+
115
+ Elle est aussi exposée en `app.issueSession`.
116
+
93
117
  ## CORS
94
118
 
95
119
  `options.cors` active le CORS pour toute l'app en un seul champ de
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/saas-kit",
3
- "version": "1.6.1",
3
+ "version": "1.7.0",
4
4
  "description": "Reusable backend starter kit that assembles Astratra core, security, and AI packages.",
5
5
  "engines": {
6
6
  "node": ">=20"
package/src/app.js CHANGED
@@ -212,11 +212,15 @@ function createSaasApp(options = {}) {
212
212
  || Boolean(userLoginSkip && userLoginSkip(req, res))
213
213
  });
214
214
 
215
- app.use('/auth', loginLimiter, createAuthRoutes({
215
+ const authRoutes = createAuthRoutes({
216
216
  ...normalized,
217
217
  authMiddleware,
218
218
  csrfMiddleware
219
- }));
219
+ });
220
+ app.use('/auth', loginLimiter, authRoutes);
221
+ /* Opens the same session as /auth/login for an identity the product proved
222
+ itself (Google, Apple, an invitation): one issuer, never a second one. */
223
+ const issueSession = authRoutes.issueSession;
220
224
 
221
225
  app.use('/users', authMiddleware, csrfMiddleware, createUsersRoutes({
222
226
  usersStore: normalized.usersStore,
@@ -242,6 +246,7 @@ function createSaasApp(options = {}) {
242
246
  app.authMiddleware = authMiddleware;
243
247
  app.csrfMiddleware = csrfMiddleware;
244
248
  app.authorizeAdmin = authorizeAdmin;
249
+ app.issueSession = issueSession;
245
250
 
246
251
  // createSaasApp() already terminates its own middleware stack with a
247
252
  // catch-all 404 + error handler below. Any route registered on `app`
@@ -258,7 +263,7 @@ function createSaasApp(options = {}) {
258
263
  // }
259
264
  // });
260
265
  if (typeof normalized.extendRoutes === 'function') {
261
- normalized.extendRoutes(app, { authMiddleware, csrfMiddleware, authorizeAdmin, authorizeRoles });
266
+ normalized.extendRoutes(app, { authMiddleware, csrfMiddleware, authorizeAdmin, authorizeRoles, issueSession });
262
267
  }
263
268
 
264
269
  app.use(notFoundMiddleware);
package/src/index.d.ts CHANGED
@@ -79,14 +79,30 @@ export interface SaasApp {
79
79
  csrfMiddleware: RequestHandler;
80
80
  /** authorizeRoles(...options.roles.adminRoles) — the exact admin-role guard used internally. */
81
81
  authorizeAdmin: RequestHandler;
82
+ /** Opens the same session as /auth/login for an account the product proved itself. */
83
+ issueSession: IssueSession;
82
84
  [key: string]: unknown;
83
85
  }
84
86
 
87
+ /** The body /auth/login answers with. */
88
+ export interface IssuedSession {
89
+ token: string;
90
+ user: Record<string, unknown>;
91
+ refreshToken?: string;
92
+ }
93
+
94
+ /**
95
+ * Opens a session (access token, session cookie when `res` is given, refresh
96
+ * chain when enabled) for an account whose identity is already proven.
97
+ */
98
+ export type IssueSession = (res: unknown, user: { id: unknown; [key: string]: unknown }) => Promise<IssuedSession>;
99
+
85
100
  export interface ExtendRoutesContext {
86
101
  authMiddleware: RequestHandler;
87
102
  csrfMiddleware: RequestHandler;
88
103
  authorizeAdmin: RequestHandler;
89
104
  authorizeRoles: (...roles: string[]) => RequestHandler;
105
+ issueSession: IssueSession;
90
106
  }
91
107
 
92
108
  export interface CreateSaasAppOptions {
@@ -70,13 +70,15 @@ function createAuthRoutes(options) {
70
70
  }
71
71
  );
72
72
 
73
- router.post('/login', validateMiddleware(loginValidation), asyncHandler(async (req, res) => {
74
- const user = await usersStore.findByEmail(req.body.email);
75
- const valid = user ? await verifyPassword(user, req.body.password) : false;
76
- if (!user || !valid) {
77
- throw new AppError('Invalid credentials.', 401);
78
- }
79
-
73
+ /**
74
+ * Open a session for an account whose identity is already proven — by the
75
+ * password here, or by the product's own route (an ID token from Google or
76
+ * Apple, an invitation). One function, so that every way in yields exactly
77
+ * the same session: same access token, same cookie, same refresh chain.
78
+ * Returns the body the login route answers with.
79
+ */
80
+ async function issueSession(res, user) {
81
+ if (!user || user.id === undefined || user.id === null) throw new Error('issueSession requires an account with an id.');
80
82
  const publicUser = pickPublicUser(user, publicUserFields);
81
83
 
82
84
  /* A refresh token is issued only when the product asked for one. The web
@@ -90,13 +92,23 @@ function createAuthRoutes(options) {
90
92
  /* The family id travels in the access token so that signing out can revoke
91
93
  the refresh chain without the client having to hand it back. */
92
94
  const token = signAccessToken(publicUser, refresh ? { rfid: refresh.familyId } : {});
93
- setSessionCookie(res, token, cookieOptions);
95
+ if (res) setSessionCookie(res, token, cookieOptions);
94
96
 
95
- return apiResponse(res, 200, 'Login successful', {
97
+ return {
96
98
  token,
97
99
  user: publicUser,
98
100
  ...(refresh ? { refreshToken: refresh.token } : {})
99
- });
101
+ };
102
+ }
103
+
104
+ router.post('/login', validateMiddleware(loginValidation), asyncHandler(async (req, res) => {
105
+ const user = await usersStore.findByEmail(req.body.email);
106
+ const valid = user ? await verifyPassword(user, req.body.password) : false;
107
+ if (!user || !valid) {
108
+ throw new AppError('Invalid credentials.', 401);
109
+ }
110
+
111
+ return apiResponse(res, 200, 'Login successful', await issueSession(res, user));
100
112
  }));
101
113
 
102
114
  if (refreshTokenService) {
@@ -253,6 +265,7 @@ function createAuthRoutes(options) {
253
265
  }));
254
266
  }
255
267
 
268
+ router.issueSession = issueSession;
256
269
  return router;
257
270
  }
258
271