@smplcty/auth 2.0.1 → 2.1.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
@@ -222,7 +222,46 @@ const session = await createSession(pool, {
222
222
 
223
223
  Auth **core** depends on neither `oauth4webapi` nor Twilio — the handler subpaths do, as **optional peers**. A password-only app installs neither. OIDC is org-bound (`oauth4webapi` does discovery + PKCE + token exchange + `id_token` verification); Twilio Verify is user-bound (phone/email) and integrates the [dev-OTP](#developer-otp--for-devs-whose-phones-cant-receive-sms) fallback automatically.
224
224
 
225
- **What stays app-side:** parsing the request `Host` → slug, the chooser/redirect UI, and the OIDC **login-state store** — `oidc.initiate` returns `loginState` (`state`/`nonce`/`codeVerifier`) for you to persist in a short-lived signed cookie keyed by `state`, and hand back to `oidc.complete`. The **`client_secret`** lives in your secret store (passed via the `clientSecret` resolver), **not** in `auth_domains` (which holds only `issuer`/`clientId`).
225
+ **What stays app-side:** parsing the request `Host` → slug, the chooser/redirect UI, and the OIDC **login-state store** — `oidc.initiate` returns `loginState` (`state`/`nonce`/`codeVerifier`) for you to persist in a short-lived signed cookie keyed by `state`, and hand back to `oidc.complete`. The **`client_secret`** lives in your secret store (passed via the `clientSecret` resolver), **not** in `auth_domains` (which holds only `issuer`/`clientId`). The [`@smplcty/auth/http`](#http-transport--smpltyauthhttp) tier handles the routes, cookies, and login-state store for you — drop it in and you write only the slug parser + the sign-in screen.
226
+
227
+ ## HTTP transport — `@smplcty/auth/http`
228
+
229
+ The pieces above are primitives. **`@smplcty/auth/http`** wires them into
230
+ ready-made, framework-agnostic HTTP handlers so you don't hand-write the
231
+ `/auth/*` routes, the session cookie, the OIDC login-state cookie, or the
232
+ per-request auth middleware. Every handler is a Web-standard
233
+ `(Request) => Promise<Response>`, so it mounts directly in Hono and Next.js App
234
+ Router — no adapter, and no new heavy dependency (it's built on Web
235
+ `Request`/`Response` + Web Crypto). Twilio and `oauth4webapi` stay optional
236
+ peers: you pass the handlers you constructed.
237
+
238
+ ```ts
239
+ import { createAuthHandlers } from '@smplcty/auth/http';
240
+ import { oidcHandler } from '@smplcty/auth/oidc';
241
+ import { twilioVerifyHandler } from '@smplcty/auth/twilio';
242
+
243
+ const handlers = createAuthHandlers({
244
+ pool,
245
+ cookie: { name: 'app_session', domain: '.app.example.com' },
246
+ loginStateSecret: process.env.LOGIN_STATE_SECRET,
247
+ tenantSlugFromRequest: (req) => new URL(req.url).hostname.split('.')[0],
248
+ otpHandler: twilioVerifyHandler({ client }), // omit for SSO-only
249
+ oidc: oidcHandler({ clientSecret: (ad) => secrets.get(ad.tenantId) }), // omit if no OIDC
250
+ });
251
+
252
+ // Hono — one line:
253
+ app.all('/auth/*', (c) => handlers.handle(c.req.raw).then((r) => r ?? c.notFound()));
254
+ // Next.js App Router — the handlers ARE route handlers:
255
+ // export const GET = (req) => handlers.handle(req).then((r) => r ?? new Response(null, { status: 404 }));
256
+ ```
257
+
258
+ It exposes `GET …/sign-in/options`, `POST …/otp/initiate`, `POST …/otp/complete`,
259
+ `GET …/oidc/start`, `GET …/oidc/callback`, `POST …/sign-out`, and
260
+ `GET …/session`, plus `getSessionToken` / `withRequestSession` for authenticating
261
+ every other request. `returnTo` is open-redirect-guarded, `allow_otp` is enforced
262
+ server-side, and the OIDC login-state cookie is HMAC-signed and freshness-checked.
263
+
264
+ Full reference: **[HTTP transport](https://mabulu-inc.github.io/simplicity-auth/http/transport/)**.
226
265
 
227
266
  ## Developer OTP — for devs whose phones can't receive SMS
228
267
 
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Cookie serialization/parsing and the signed OIDC login-state token.
3
+ *
4
+ * Built on Web standards only (no Node `Buffer`, no framework) so the same
5
+ * code runs on Node and edge runtimes: base64url via `btoa`/`atob`, HMAC via
6
+ * Web Crypto (`globalThis.crypto.subtle`).
7
+ */
8
+ /** Attributes for a `Set-Cookie` header value. */
9
+ export interface SerializeCookieOptions {
10
+ domain?: string;
11
+ path?: string;
12
+ /** Max-Age in seconds. `0` expires the cookie immediately. */
13
+ maxAge?: number;
14
+ httpOnly?: boolean;
15
+ secure?: boolean;
16
+ sameSite?: 'lax' | 'strict' | 'none';
17
+ }
18
+ /** Build one `Set-Cookie` header value. The name/value are not re-encoded — session tokens and signed state are already URL-safe. */
19
+ export declare function serializeCookie(name: string, value: string, opts?: SerializeCookieOptions): string;
20
+ /** Parse a request `Cookie` header into a name→value map. */
21
+ export declare function parseCookies(header: string | null | undefined): Record<string, string>;
22
+ /**
23
+ * The transient OIDC login state, persisted across the IdP redirect in a
24
+ * short-lived **signed** cookie. Carries the `auth_domains` row id (so the
25
+ * callback knows which IdP to complete against) plus the PKCE/state/nonce
26
+ * the library's `OidcHandler` produced, and an optional post-sign-in target.
27
+ */
28
+ export interface LoginState {
29
+ authDomainId: number;
30
+ state: string;
31
+ nonce: string;
32
+ codeVerifier: string;
33
+ returnTo?: string;
34
+ }
35
+ /**
36
+ * Sign a login state into an opaque `<payload>.<sig>` token (HMAC-SHA256 over
37
+ * the payload). `now` is injectable for tests.
38
+ */
39
+ export declare function signLoginState(state: LoginState, secret: string, now?: number): Promise<string>;
40
+ /**
41
+ * Verify and decode a login-state token. Returns the `LoginState` if the
42
+ * signature is valid (constant-time, via `subtle.verify`) and it was issued
43
+ * within `maxAgeSeconds`; otherwise `null`. Never throws on malformed input.
44
+ */
45
+ export declare function verifyLoginState(token: string | undefined | null, secret: string, maxAgeSeconds: number, now?: number): Promise<LoginState | null>;
46
+ //# sourceMappingURL=cookies.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/http/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED,qIAAqI;AACrI,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,CAStG;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWtF;AAMD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqCD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjH;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4B5B"}
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Cookie serialization/parsing and the signed OIDC login-state token.
3
+ *
4
+ * Built on Web standards only (no Node `Buffer`, no framework) so the same
5
+ * code runs on Node and edge runtimes: base64url via `btoa`/`atob`, HMAC via
6
+ * Web Crypto (`globalThis.crypto.subtle`).
7
+ */
8
+ /** Build one `Set-Cookie` header value. The name/value are not re-encoded — session tokens and signed state are already URL-safe. */
9
+ export function serializeCookie(name, value, opts = {}) {
10
+ const parts = [`${name}=${value}`];
11
+ parts.push(`Path=${opts.path ?? '/'}`);
12
+ if (opts.domain)
13
+ parts.push(`Domain=${opts.domain}`);
14
+ if (opts.maxAge !== undefined)
15
+ parts.push(`Max-Age=${Math.floor(opts.maxAge)}`);
16
+ if (opts.httpOnly !== false)
17
+ parts.push('HttpOnly');
18
+ if (opts.secure !== false)
19
+ parts.push('Secure');
20
+ parts.push(`SameSite=${capitalize(opts.sameSite ?? 'lax')}`);
21
+ return parts.join('; ');
22
+ }
23
+ /** Parse a request `Cookie` header into a name→value map. */
24
+ export function parseCookies(header) {
25
+ const out = {};
26
+ if (!header)
27
+ return out;
28
+ for (const pair of header.split(';')) {
29
+ const eq = pair.indexOf('=');
30
+ if (eq === -1)
31
+ continue;
32
+ const name = pair.slice(0, eq).trim();
33
+ if (!name)
34
+ continue;
35
+ out[name] = pair.slice(eq + 1).trim();
36
+ }
37
+ return out;
38
+ }
39
+ function capitalize(s) {
40
+ return s.charAt(0).toUpperCase() + s.slice(1);
41
+ }
42
+ const ENCODER = new TextEncoder();
43
+ /** UTF-8 encode into an explicitly `ArrayBuffer`-backed array (Web Crypto's `BufferSource` excludes `SharedArrayBuffer`). */
44
+ function utf8(s) {
45
+ const enc = ENCODER.encode(s);
46
+ const out = new Uint8Array(new ArrayBuffer(enc.length));
47
+ out.set(enc);
48
+ return out;
49
+ }
50
+ function b64urlEncode(bytes) {
51
+ let bin = '';
52
+ for (const b of bytes)
53
+ bin += String.fromCharCode(b);
54
+ return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
55
+ }
56
+ function b64urlDecode(s) {
57
+ const bin = atob(s.replace(/-/g, '+').replace(/_/g, '/'));
58
+ const bytes = new Uint8Array(new ArrayBuffer(bin.length));
59
+ for (let i = 0; i < bin.length; i++)
60
+ bytes[i] = bin.charCodeAt(i);
61
+ return bytes;
62
+ }
63
+ async function hmacKey(secret) {
64
+ return globalThis.crypto.subtle.importKey('raw', utf8(secret), { name: 'HMAC', hash: 'SHA-256' }, false, [
65
+ 'sign',
66
+ 'verify',
67
+ ]);
68
+ }
69
+ /**
70
+ * Sign a login state into an opaque `<payload>.<sig>` token (HMAC-SHA256 over
71
+ * the payload). `now` is injectable for tests.
72
+ */
73
+ export async function signLoginState(state, secret, now = Date.now()) {
74
+ const payload = { ...state, iat: Math.floor(now / 1000) };
75
+ const body = b64urlEncode(utf8(JSON.stringify(payload)));
76
+ const key = await hmacKey(secret);
77
+ const sig = new Uint8Array(await globalThis.crypto.subtle.sign('HMAC', key, utf8(body)));
78
+ return `${body}.${b64urlEncode(sig)}`;
79
+ }
80
+ /**
81
+ * Verify and decode a login-state token. Returns the `LoginState` if the
82
+ * signature is valid (constant-time, via `subtle.verify`) and it was issued
83
+ * within `maxAgeSeconds`; otherwise `null`. Never throws on malformed input.
84
+ */
85
+ export async function verifyLoginState(token, secret, maxAgeSeconds, now = Date.now()) {
86
+ if (!token)
87
+ return null;
88
+ const dot = token.indexOf('.');
89
+ if (dot === -1)
90
+ return null;
91
+ const body = token.slice(0, dot);
92
+ const sig = token.slice(dot + 1);
93
+ let valid;
94
+ try {
95
+ const key = await hmacKey(secret);
96
+ valid = await globalThis.crypto.subtle.verify('HMAC', key, b64urlDecode(sig), utf8(body));
97
+ }
98
+ catch {
99
+ return null;
100
+ }
101
+ if (!valid)
102
+ return null;
103
+ let payload;
104
+ try {
105
+ payload = JSON.parse(new TextDecoder().decode(b64urlDecode(body)));
106
+ }
107
+ catch {
108
+ return null;
109
+ }
110
+ if (typeof payload.iat !== 'number' || Math.floor(now / 1000) - payload.iat > maxAgeSeconds) {
111
+ return null;
112
+ }
113
+ const { authDomainId, state, nonce, codeVerifier, returnTo } = payload;
114
+ if (typeof authDomainId !== 'number' || !state || !nonce || !codeVerifier)
115
+ return null;
116
+ return { authDomainId, state, nonce, codeVerifier, ...(returnTo ? { returnTo } : {}) };
117
+ }
118
+ //# sourceMappingURL=cookies.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/http/cookies.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { PoolClient } from 'pg';
2
+ import type { SessionContext } from '../types.js';
3
+ import type { AuthHandlers, AuthHttpConfig } from './types.js';
4
+ /** Extract the raw session token from the `Authorization: Bearer` header or the session cookie. */
5
+ export declare function getSessionToken(request: Request, config: AuthHttpConfig): string | null;
6
+ /**
7
+ * Resolve the request's session and run `fn` inside its RLS transaction with
8
+ * the identity GUCs (and the app scope hook) applied. Throws
9
+ * {@link SessionNotFoundError} when no token is present, and whatever
10
+ * `withSession` throws for an invalid/expired session or an unheld role.
11
+ */
12
+ export declare function withRequestSession<TRole extends string = string, T = unknown>(request: Request, config: AuthHttpConfig, fn: (client: PoolClient, ctx: SessionContext<TRole>) => Promise<T>, opts?: {
13
+ roleName?: TRole;
14
+ }): Promise<T>;
15
+ export declare function createAuthHandlers(config: AuthHttpConfig): AuthHandlers;
16
+ //# sourceMappingURL=handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/http/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,UAAU,EAAE,MAAM,IAAI,CAAC;AAe3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmB/D,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAQvF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EAC3E,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAClE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAO,GAC9B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAkDD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAkMvE"}
@@ -0,0 +1,297 @@
1
+ import { createSession } from '../create-session.js';
2
+ import { revokeSession } from '../revoke-session.js';
3
+ import { withSession } from '../with-session.js';
4
+ import { createMethodRouter } from '../methods/router.js';
5
+ import { AuthError, InvalidInputError, RoleNotHeldError, SessionExpiredError, SessionNotFoundError, } from '../errors.js';
6
+ import { OtpNotAllowedError, VerificationFailedError } from '../methods/errors.js';
7
+ import { parseCookies, serializeCookie, signLoginState, verifyLoginState, } from './cookies.js';
8
+ const DEFAULT_SESSION_TTL = '30 days';
9
+ const DEFAULT_LOGIN_STATE_TTL = 600;
10
+ const SELECT_TENANT_ID = `SELECT tenant_id AS "tenantId" FROM tenants WHERE slug = $1 AND deleted_at IS NULL LIMIT 1`;
11
+ const SELECT_AUTH_DOMAIN = `
12
+ SELECT
13
+ auth_domain_id AS "authDomainId",
14
+ tenant_id AS "tenantId",
15
+ display_name AS "displayName",
16
+ integration_type AS "integrationType",
17
+ integration_params AS "integrationParams"
18
+ FROM auth_domains
19
+ WHERE auth_domain_id = $1 AND deleted_at IS NULL
20
+ LIMIT 1
21
+ `;
22
+ /** Extract the raw session token from the `Authorization: Bearer` header or the session cookie. */
23
+ export function getSessionToken(request, config) {
24
+ const auth = request.headers.get('authorization');
25
+ if (auth && auth.startsWith('Bearer ')) {
26
+ const token = auth.slice('Bearer '.length).trim();
27
+ if (token)
28
+ return token;
29
+ }
30
+ const cookies = parseCookies(request.headers.get('cookie'));
31
+ return cookies[config.cookie.name] ?? null;
32
+ }
33
+ /**
34
+ * Resolve the request's session and run `fn` inside its RLS transaction with
35
+ * the identity GUCs (and the app scope hook) applied. Throws
36
+ * {@link SessionNotFoundError} when no token is present, and whatever
37
+ * `withSession` throws for an invalid/expired session or an unheld role.
38
+ */
39
+ export function withRequestSession(request, config, fn, opts = {}) {
40
+ const token = getSessionToken(request, config);
41
+ if (!token)
42
+ return Promise.reject(new SessionNotFoundError('No session token on request'));
43
+ return withSession(config.pool, { token, roleName: opts.roleName }, fn, {
44
+ scope: config.scope,
45
+ logger: config.logger,
46
+ });
47
+ }
48
+ function json(body, status = 200) {
49
+ return new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json' } });
50
+ }
51
+ function redirect(location) {
52
+ return new Response(null, { status: 302, headers: { location } });
53
+ }
54
+ async function readJson(request) {
55
+ try {
56
+ const body = await request.json();
57
+ if (body === null || typeof body !== 'object')
58
+ throw new InvalidInputError('request body must be a JSON object');
59
+ return body;
60
+ }
61
+ catch (err) {
62
+ if (err instanceof AuthError)
63
+ throw err;
64
+ throw new InvalidInputError('request body must be valid JSON');
65
+ }
66
+ }
67
+ function requireString(body, key) {
68
+ const value = body[key];
69
+ if (typeof value !== 'string' || value.length === 0) {
70
+ throw new InvalidInputError(`${key} must be a non-empty string`);
71
+ }
72
+ return value;
73
+ }
74
+ /** Map a thrown auth error to an HTTP response. Unknown errors become an opaque 500. */
75
+ function toErrorResponse(err) {
76
+ if (err instanceof InvalidInputError)
77
+ return json({ error: err.message, code: err.code }, 400);
78
+ if (err instanceof OtpNotAllowedError)
79
+ return json({ error: 'OTP sign-in is not allowed', code: err.code }, 403);
80
+ if (err instanceof VerificationFailedError)
81
+ return json({ error: 'Verification failed', code: err.code }, 401);
82
+ if (err instanceof RoleNotHeldError)
83
+ return json({ error: 'Role not held', code: err.code }, 403);
84
+ if (err instanceof SessionExpiredError)
85
+ return json({ error: 'Session expired', code: err.code }, 401);
86
+ if (err instanceof SessionNotFoundError)
87
+ return json({ error: 'Not authenticated', code: err.code }, 401);
88
+ return json({ error: 'Internal error' }, 500);
89
+ }
90
+ /**
91
+ * Only allow same-origin relative redirects — never an absolute URL,
92
+ * protocol-relative `//host`, or the backslash variant `/\host` that browsers
93
+ * normalize to `//host` (open-redirect guard).
94
+ */
95
+ function sanitizeReturnTo(raw) {
96
+ if (!raw || raw[0] !== '/' || raw[1] === '/' || raw[1] === '\\')
97
+ return undefined;
98
+ return raw;
99
+ }
100
+ export function createAuthHandlers(config) {
101
+ const pool = config.pool;
102
+ const router = createMethodRouter({ db: pool, otpHandler: config.otpHandler });
103
+ const sessionTtl = config.sessionTtl ?? DEFAULT_SESSION_TTL;
104
+ const loginStateTtl = config.loginStateTtlSeconds ?? DEFAULT_LOGIN_STATE_TTL;
105
+ const loginStateCookieName = `${config.cookie.name}_oidc`;
106
+ function sessionCookieOptions(maxAge) {
107
+ return {
108
+ domain: config.cookie.domain,
109
+ path: config.cookie.path ?? '/',
110
+ sameSite: config.cookie.sameSite ?? 'lax',
111
+ secure: config.cookie.secure ?? true,
112
+ httpOnly: true,
113
+ maxAge,
114
+ };
115
+ }
116
+ async function resolveTenantId(request) {
117
+ const slug = await config.tenantSlugFromRequest(request);
118
+ if (!slug)
119
+ return null;
120
+ const { rows } = await pool.query(SELECT_TENANT_ID, [slug]);
121
+ return rows[0]?.tenantId ?? null;
122
+ }
123
+ /** Create a session for the verified user and return the Set-Cookie value. */
124
+ async function mintSessionCookie(request, user) {
125
+ const meta = config.sessionMeta?.(request);
126
+ const session = await createSession(pool, {
127
+ userCommunicationMethodId: user.userCommunicationMethodId,
128
+ ttl: sessionTtl,
129
+ ip: meta?.ip,
130
+ geo: meta?.geo,
131
+ });
132
+ // createSession owns the authoritative server-side expiry; the cookie
133
+ // Max-Age is only a client hint (default 30 days).
134
+ return serializeCookie(config.cookie.name, session.token, sessionCookieOptions(config.cookie.maxAgeSeconds ?? 60 * 60 * 24 * 30));
135
+ }
136
+ const handlers = {
137
+ async signInOptions(request) {
138
+ try {
139
+ const slug = await config.tenantSlugFromRequest(request);
140
+ if (!slug)
141
+ return json({ error: 'tenant could not be resolved from the request' }, 400);
142
+ const opts = await router.signInOptions({ tenantSlug: slug });
143
+ if (!opts)
144
+ return json({ error: 'unknown tenant' }, 404);
145
+ return json({
146
+ tenantId: opts.tenantId,
147
+ otpAllowed: opts.otpAllowed,
148
+ authDomains: opts.authDomains.map((d) => ({
149
+ authDomainId: d.authDomainId,
150
+ displayName: d.displayName,
151
+ integrationType: d.integrationType,
152
+ })),
153
+ });
154
+ }
155
+ catch (err) {
156
+ return toErrorResponse(err);
157
+ }
158
+ },
159
+ async otpInitiate(request) {
160
+ try {
161
+ const tenantId = await resolveTenantId(request);
162
+ if (tenantId === null)
163
+ return json({ error: 'unknown tenant' }, 404);
164
+ const body = await readJson(request);
165
+ const identifier = requireString(body, 'identifier');
166
+ const result = await router.initiateOtp({ tenantId, identifier });
167
+ return json(result);
168
+ }
169
+ catch (err) {
170
+ return toErrorResponse(err);
171
+ }
172
+ },
173
+ async otpComplete(request) {
174
+ try {
175
+ const tenantId = await resolveTenantId(request);
176
+ if (tenantId === null)
177
+ return json({ error: 'unknown tenant' }, 404);
178
+ const body = await readJson(request);
179
+ const identifier = requireString(body, 'identifier');
180
+ const credential = requireString(body, 'credential');
181
+ const user = await router.completeOtp({ tenantId, identifier, credential });
182
+ const cookie = await mintSessionCookie(request, user);
183
+ const returnTo = sanitizeReturnTo(typeof body.returnTo === 'string' ? body.returnTo : undefined);
184
+ const res = json({ ok: true, returnTo: returnTo ?? config.returnToDefault ?? '/' });
185
+ res.headers.append('set-cookie', cookie);
186
+ return res;
187
+ }
188
+ catch (err) {
189
+ return toErrorResponse(err);
190
+ }
191
+ },
192
+ async oidcStart(request) {
193
+ try {
194
+ if (!config.oidc)
195
+ return json({ error: 'OIDC is not configured' }, 404);
196
+ const url = new URL(request.url);
197
+ const idRaw = url.searchParams.get('authDomainId');
198
+ const authDomainId = idRaw ? Number(idRaw) : NaN;
199
+ if (!Number.isInteger(authDomainId) || authDomainId <= 0) {
200
+ throw new InvalidInputError('authDomainId query parameter must be a positive integer');
201
+ }
202
+ const authDomain = await getAuthDomain(pool, authDomainId);
203
+ if (!authDomain)
204
+ return json({ error: 'unknown auth domain' }, 404);
205
+ const { redirectUrl, loginState } = await config.oidc.initiate(authDomain);
206
+ const returnTo = sanitizeReturnTo(url.searchParams.get('returnTo'));
207
+ const stateToken = await signLoginState({ authDomainId, ...loginState, ...(returnTo ? { returnTo } : {}) }, config.loginStateSecret);
208
+ const res = redirect(redirectUrl);
209
+ res.headers.append('set-cookie', serializeCookie(loginStateCookieName, stateToken, {
210
+ ...sessionCookieOptions(loginStateTtl),
211
+ // Lax so the cookie is sent on the top-level GET redirect back from the IdP.
212
+ sameSite: 'lax',
213
+ }));
214
+ return res;
215
+ }
216
+ catch (err) {
217
+ return toErrorResponse(err);
218
+ }
219
+ },
220
+ async oidcCallback(request) {
221
+ try {
222
+ if (!config.oidc)
223
+ return json({ error: 'OIDC is not configured' }, 404);
224
+ const cookies = parseCookies(request.headers.get('cookie'));
225
+ const loginState = await verifyLoginState(cookies[loginStateCookieName], config.loginStateSecret, loginStateTtl);
226
+ if (!loginState)
227
+ return json({ error: 'missing or invalid login state' }, 400);
228
+ const authDomain = await getAuthDomain(pool, loginState.authDomainId);
229
+ if (!authDomain)
230
+ return json({ error: 'unknown auth domain' }, 404);
231
+ const user = await config.oidc.complete({
232
+ db: pool,
233
+ authDomain,
234
+ callbackUrl: request.url,
235
+ loginState: { state: loginState.state, nonce: loginState.nonce, codeVerifier: loginState.codeVerifier },
236
+ });
237
+ const cookie = await mintSessionCookie(request, user);
238
+ const res = redirect(sanitizeReturnTo(loginState.returnTo) ?? config.returnToDefault ?? '/');
239
+ res.headers.append('set-cookie', cookie);
240
+ // Clear the one-time login-state cookie.
241
+ res.headers.append('set-cookie', serializeCookie(loginStateCookieName, '', sessionCookieOptions(0)));
242
+ return res;
243
+ }
244
+ catch (err) {
245
+ return toErrorResponse(err);
246
+ }
247
+ },
248
+ async signOut(request) {
249
+ try {
250
+ const token = getSessionToken(request, config);
251
+ if (token)
252
+ await revokeSession(pool, token);
253
+ const res = json({ ok: true });
254
+ res.headers.append('set-cookie', serializeCookie(config.cookie.name, '', sessionCookieOptions(0)));
255
+ return res;
256
+ }
257
+ catch (err) {
258
+ return toErrorResponse(err);
259
+ }
260
+ },
261
+ async session(request) {
262
+ try {
263
+ const ctx = await withRequestSession(request, config, async (_client, ctx) => ctx);
264
+ return json({ authenticated: true, ...ctx });
265
+ }
266
+ catch (err) {
267
+ return toErrorResponse(err);
268
+ }
269
+ },
270
+ async handle(request) {
271
+ const { pathname } = new URL(request.url);
272
+ const method = request.method.toUpperCase();
273
+ const at = (suffix, verb) => method === verb && pathname.endsWith(suffix);
274
+ if (at('/sign-in/options', 'GET'))
275
+ return handlers.signInOptions(request);
276
+ if (at('/otp/initiate', 'POST'))
277
+ return handlers.otpInitiate(request);
278
+ if (at('/otp/complete', 'POST'))
279
+ return handlers.otpComplete(request);
280
+ if (at('/oidc/start', 'GET'))
281
+ return handlers.oidcStart(request);
282
+ if (at('/oidc/callback', 'GET'))
283
+ return handlers.oidcCallback(request);
284
+ if (at('/sign-out', 'POST'))
285
+ return handlers.signOut(request);
286
+ if (at('/session', 'GET'))
287
+ return handlers.session(request);
288
+ return null;
289
+ },
290
+ };
291
+ return handlers;
292
+ }
293
+ async function getAuthDomain(pool, authDomainId) {
294
+ const { rows } = await pool.query(SELECT_AUTH_DOMAIN, [authDomainId]);
295
+ return rows[0] ?? null;
296
+ }
297
+ //# sourceMappingURL=handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/http/handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAInF,OAAO,EACL,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAGtB,MAAM,mBAAmB,GAAG,SAAS,CAAC;AACtC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,gBAAgB,GAAG,4FAA4F,CAAC;AAEtH,MAAM,kBAAkB,GAAG;;;;;;;;;;CAU1B,CAAC;AAEF,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,MAAsB;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClD,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,MAAsB,EACtB,EAAkE,EAClE,OAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC3F,OAAO,WAAW,CAAW,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE;QAChF,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,IAAa,EAAE,MAAM,GAAG,GAAG;IACvC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,OAAgB;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;QACjH,OAAO,IAA+B,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS;YAAE,MAAM,GAAG,CAAC;QACxC,MAAM,IAAI,iBAAiB,CAAC,iCAAiC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAA6B,EAAE,GAAW;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,iBAAiB,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,GAAG,YAAY,iBAAiB;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/F,IAAI,GAAG,YAAY,kBAAkB;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACjH,IAAI,GAAG,YAAY,uBAAuB;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/G,IAAI,GAAG,YAAY,gBAAgB;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAClG,IAAI,GAAG,YAAY,mBAAmB;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACvG,IAAI,GAAG,YAAY,oBAAoB;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAC1G,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,GAA8B;IACtD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,IAAI,GAAS,MAAM,CAAC,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC5D,MAAM,aAAa,GAAG,MAAM,CAAC,oBAAoB,IAAI,uBAAuB,CAAC;IAC7E,MAAM,oBAAoB,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC;IAE1D,SAAS,oBAAoB,CAAC,MAAc;QAC1C,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;YAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG;YAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK;YACzC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI;YACpC,QAAQ,EAAE,IAAI;YACd,MAAM;SACP,CAAC;IACJ,CAAC;IAED,KAAK,UAAU,eAAe,CAAC,OAAgB;QAC7C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAuB,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;IACnC,CAAC;IAED,8EAA8E;IAC9E,KAAK,UAAU,iBAAiB,CAAC,OAAgB,EAAE,IAAkB;QACnE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;YACxC,yBAAyB,EAAE,IAAI,CAAC,yBAAyB;YACzD,GAAG,EAAE,UAAU;YACf,EAAE,EAAE,IAAI,EAAE,EAAE;YACZ,GAAG,EAAE,IAAI,EAAE,GAAG;SACf,CAAC,CAAC;QACH,sEAAsE;QACtE,mDAAmD;QACnD,OAAO,eAAe,CACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAClB,OAAO,CAAC,KAAK,EACb,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAiB;QAC7B,KAAK,CAAC,aAAa,CAAC,OAAO;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBACzD,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,EAAE,GAAG,CAAC,CAAC;gBACxF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9D,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACzD,OAAO,IAAI,CAAC;oBACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACxC,YAAY,EAAE,CAAC,CAAC,YAAY;wBAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;qBACnC,CAAC,CAAC;iBACJ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,OAAO;YACvB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAChD,IAAI,QAAQ,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACrE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;gBAClE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,OAAO;YACvB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAChD,IAAI,QAAQ,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACrE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBACrD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC5E,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACjG,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,IAAI,MAAM,CAAC,eAAe,IAAI,GAAG,EAAE,CAAC,CAAC;gBACpF,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBACzC,OAAO,GAAG,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,OAAO;YACrB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACxE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACjC,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBACjD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;oBACzD,MAAM,IAAI,iBAAiB,CAAC,yDAAyD,CAAC,CAAC;gBACzF,CAAC;gBACD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBAC3D,IAAI,CAAC,UAAU;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACpE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAC3E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;gBACpE,MAAM,UAAU,GAAG,MAAM,cAAc,CACrC,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAClE,MAAM,CAAC,gBAAgB,CACxB,CAAC;gBACF,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAClC,GAAG,CAAC,OAAO,CAAC,MAAM,CAChB,YAAY,EACZ,eAAe,CAAC,oBAAoB,EAAE,UAAU,EAAE;oBAChD,GAAG,oBAAoB,CAAC,aAAa,CAAC;oBACtC,6EAA6E;oBAC7E,QAAQ,EAAE,KAAK;iBAChB,CAAC,CACH,CAAC;gBACF,OAAO,GAAG,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,OAAO;YACxB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACxE,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC5D,MAAM,UAAU,GAAG,MAAM,gBAAgB,CACvC,OAAO,CAAC,oBAAoB,CAAC,EAC7B,MAAM,CAAC,gBAAgB,EACvB,aAAa,CACd,CAAC;gBACF,IAAI,CAAC,UAAU;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC/E,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;gBACtE,IAAI,CAAC,UAAU;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAC;gBACpE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;oBACtC,EAAE,EAAE,IAAI;oBACR,UAAU;oBACV,WAAW,EAAE,OAAO,CAAC,GAAG;oBACxB,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE;iBACxG,CAAC,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC;gBAC7F,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBACzC,yCAAyC;gBACzC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,oBAAoB,EAAE,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrG,OAAO,GAAG,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/C,IAAI,KAAK;oBAAE,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnG,OAAO,GAAG,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;gBACnF,OAAO,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,EAAE,GAAG,CAAC,MAAc,EAAE,IAAY,EAAW,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAEnG,IAAI,EAAE,CAAC,kBAAkB,EAAE,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC1E,IAAI,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC;gBAAE,OAAO,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACtE,IAAI,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC;gBAAE,OAAO,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACtE,IAAI,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACjE,IAAI,EAAE,CAAC,gBAAgB,EAAE,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACvE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;gBAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9D,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAU,EAAE,YAAoB;IAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAyB,kBAAkB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9F,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzB,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * `@smplcty/auth/http` — the framework-agnostic transport tier.
3
+ *
4
+ * Wires the library's primitives (the method router, the OIDC handler, the
5
+ * session lifecycle) into Web-standard `(Request) => Promise<Response>`
6
+ * handlers, plus cookie / signed-login-state helpers and a per-request session
7
+ * resolver. Built on Web standards only — mount the handlers directly in Hono
8
+ * (`app.all('/auth/*', (c) => handlers.handle(c.req.raw))`) or as Next.js App
9
+ * Router route handlers (`export const GET = handlers.signInOptions`).
10
+ */
11
+ export { createAuthHandlers, getSessionToken, withRequestSession } from './handlers.js';
12
+ export { serializeCookie, parseCookies, signLoginState, verifyLoginState, type SerializeCookieOptions, type LoginState, } from './cookies.js';
13
+ export type { AuthHttpConfig, AuthCookieConfig, AuthHandlers, RequestSessionMeta } from './types.js';
14
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * `@smplcty/auth/http` — the framework-agnostic transport tier.
3
+ *
4
+ * Wires the library's primitives (the method router, the OIDC handler, the
5
+ * session lifecycle) into Web-standard `(Request) => Promise<Response>`
6
+ * handlers, plus cookie / signed-login-state helpers and a per-request session
7
+ * resolver. Built on Web standards only — mount the handlers directly in Hono
8
+ * (`app.all('/auth/*', (c) => handlers.handle(c.req.raw))`) or as Next.js App
9
+ * Router route handlers (`export const GET = handlers.signInOptions`).
10
+ */
11
+ export { createAuthHandlers, getSessionToken, withRequestSession } from './handlers.js';
12
+ export { serializeCookie, parseCookies, signLoginState, verifyLoginState, } from './cookies.js';
13
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,GAGjB,MAAM,cAAc,CAAC"}
@@ -0,0 +1,79 @@
1
+ import type { Pool } from 'pg';
2
+ import type { GeoLocation, Logger, ScopeHook } from '../types.js';
3
+ import type { MethodHandler } from '../methods/types.js';
4
+ import type { OidcHandler } from '../methods/oidc/index.js';
5
+ /** Session-cookie attributes. The `domain` covers sub-domain sharing (e.g. `.app.example.com`). */
6
+ export interface AuthCookieConfig {
7
+ /** Cookie name, e.g. `pn_session`. */
8
+ name: string;
9
+ /** Cookie domain — set to a parent domain to share the session across tenant sub-domains. */
10
+ domain?: string;
11
+ /** Path; defaults to `/`. */
12
+ path?: string;
13
+ /** SameSite; defaults to `lax` (survives the top-level GET redirect back from an IdP). */
14
+ sameSite?: 'lax' | 'strict' | 'none';
15
+ /** Secure; defaults to `true`. Set `false` only for local HTTP dev. */
16
+ secure?: boolean;
17
+ /** Cookie `Max-Age` in seconds; defaults to 30 days. The authoritative expiry is server-side on the session row — this is the browser hint. */
18
+ maxAgeSeconds?: number;
19
+ }
20
+ /** Per-request session metadata captured at sign-in (stored on the `sessions` row). */
21
+ export interface RequestSessionMeta {
22
+ ip?: string;
23
+ geo?: GeoLocation;
24
+ }
25
+ /**
26
+ * Everything the transport tier needs. The app supplies its pool, cookie
27
+ * policy, a tenant-slug resolver (Host parsing is deployment-specific), and —
28
+ * opt-in — the OTP handler and/or the OIDC handler it constructed (so auth core
29
+ * pulls neither Twilio nor `oauth4webapi`).
30
+ */
31
+ export interface AuthHttpConfig {
32
+ /** The RLS pool used for session + method + OIDC operations. */
33
+ pool: Pool;
34
+ cookie: AuthCookieConfig;
35
+ /** Secret used to HMAC-sign the short-lived OIDC login-state cookie. */
36
+ loginStateSecret: string;
37
+ /** Session lifetime as a Postgres interval. Defaults to `'30 days'`. */
38
+ sessionTtl?: string;
39
+ /** Max age of the OIDC login-state cookie, in seconds. Defaults to `600`. */
40
+ loginStateTtlSeconds?: number;
41
+ /** Resolve the tenant slug from the request (e.g. parse the Host sub-domain). */
42
+ tenantSlugFromRequest: (request: Request) => string | null | Promise<string | null>;
43
+ /** Where to send the browser after sign-in when no safe `returnTo` is supplied. Defaults to `'/'`. */
44
+ returnToDefault?: string;
45
+ /** The user-bound OTP handler (e.g. `twilioVerifyHandler`). Omit for SSO-only. */
46
+ otpHandler?: MethodHandler;
47
+ /** The org-bound OIDC handler (`oidcHandler` from `@smplcty/auth/oidc`). Omit if the app has no OIDC. */
48
+ oidc?: OidcHandler;
49
+ /** App-owned intra-tenant scope hook, applied by `withRequestSession` / the session endpoint. */
50
+ scope?: ScopeHook;
51
+ logger?: Logger;
52
+ /** Derive IP/geo for the `sessions` row from the request. */
53
+ sessionMeta?: (request: Request) => RequestSessionMeta | undefined;
54
+ }
55
+ /**
56
+ * The framework-agnostic auth endpoints, each a Web-standard
57
+ * `(Request) => Promise<Response>`. Mount `handle` under a base path (it
58
+ * returns `null` when no auth route matches, so the host can fall through),
59
+ * or wire the individual handlers as explicit routes.
60
+ */
61
+ export interface AuthHandlers {
62
+ /** Dispatch any auth route by method + path suffix; `null` if none matches. */
63
+ handle(request: Request): Promise<Response | null>;
64
+ /** `GET …/sign-in/options` — the tenant's IdPs + whether OTP is offered. */
65
+ signInOptions(request: Request): Promise<Response>;
66
+ /** `POST …/otp/initiate` — send an OTP `{ identifier }`. */
67
+ otpInitiate(request: Request): Promise<Response>;
68
+ /** `POST …/otp/complete` — verify `{ identifier, credential }`, mint a session. */
69
+ otpComplete(request: Request): Promise<Response>;
70
+ /** `GET …/oidc/start?authDomainId=&returnTo=` — redirect to the IdP. */
71
+ oidcStart(request: Request): Promise<Response>;
72
+ /** `GET …/oidc/callback` — complete the IdP flow, mint a session, redirect. */
73
+ oidcCallback(request: Request): Promise<Response>;
74
+ /** `POST …/sign-out` — revoke the session and clear the cookie. */
75
+ signOut(request: Request): Promise<Response>;
76
+ /** `GET …/session` — the current identity context, or 401. */
77
+ session(request: Request): Promise<Response>;
78
+ }
79
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,mGAAmG;AACnG,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+IAA+I;IAC/I,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iFAAiF;IACjF,qBAAqB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpF,sGAAsG;IACtG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,yGAAyG;IACzG,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,iGAAiG;IACjG,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,kBAAkB,GAAG,SAAS,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACnD,4EAA4E;IAC5E,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,4DAA4D;IAC5D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,mFAAmF;IACnF,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,wEAAwE;IACxE,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,+EAA+E;IAC/E,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClD,mEAAmE;IACnE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9C"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smplcty/auth",
3
- "version": "2.0.1",
3
+ "version": "2.1.0",
4
4
  "description": "Robust, type-safe session and role-based authentication primitives for PostgreSQL apps using Row-Level Security.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -26,6 +26,11 @@
26
26
  "types": "./dist/scope/flat-tenant.d.ts",
27
27
  "import": "./dist/scope/flat-tenant.js",
28
28
  "default": "./dist/scope/flat-tenant.js"
29
+ },
30
+ "./http": {
31
+ "types": "./dist/http/index.d.ts",
32
+ "import": "./dist/http/index.js",
33
+ "default": "./dist/http/index.js"
29
34
  }
30
35
  },
31
36
  "files": [