authfn 0.1.1 → 0.2.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.
Files changed (118) hide show
  1. package/README.md +124 -249
  2. package/dist/core/account-linking.d.ts +30 -0
  3. package/dist/core/account-linking.d.ts.map +1 -0
  4. package/dist/core/account-linking.js +80 -0
  5. package/dist/core/account-linking.js.map +1 -0
  6. package/dist/core/account.d.ts +38 -0
  7. package/dist/core/account.d.ts.map +1 -0
  8. package/dist/core/account.js +164 -0
  9. package/dist/core/account.js.map +1 -0
  10. package/dist/core/admin-users.d.ts +50 -0
  11. package/dist/core/admin-users.d.ts.map +1 -0
  12. package/dist/core/admin-users.js +227 -0
  13. package/dist/core/admin-users.js.map +1 -0
  14. package/dist/core/api-keys.d.ts +40 -0
  15. package/dist/core/api-keys.d.ts.map +1 -0
  16. package/dist/core/api-keys.js +165 -0
  17. package/dist/core/api-keys.js.map +1 -0
  18. package/dist/core/cache.d.ts +18 -0
  19. package/dist/core/cache.d.ts.map +1 -0
  20. package/dist/core/cache.js +54 -0
  21. package/dist/core/cache.js.map +1 -0
  22. package/dist/core/cookies.d.ts +25 -0
  23. package/dist/core/cookies.d.ts.map +1 -0
  24. package/dist/core/cookies.js +89 -0
  25. package/dist/core/cookies.js.map +1 -0
  26. package/dist/core/delivery.d.ts +4 -0
  27. package/dist/core/delivery.d.ts.map +1 -0
  28. package/dist/core/delivery.js +37 -0
  29. package/dist/core/delivery.js.map +1 -0
  30. package/dist/core/environment.d.ts +4 -0
  31. package/dist/core/environment.d.ts.map +1 -0
  32. package/dist/core/environment.js +50 -0
  33. package/dist/core/environment.js.map +1 -0
  34. package/dist/core/errors.d.ts +120 -0
  35. package/dist/core/errors.d.ts.map +1 -0
  36. package/dist/core/errors.js +428 -0
  37. package/dist/core/errors.js.map +1 -0
  38. package/dist/core/gateway-routing.d.ts +88 -0
  39. package/dist/core/gateway-routing.d.ts.map +1 -0
  40. package/dist/core/gateway-routing.js +902 -0
  41. package/dist/core/gateway-routing.js.map +1 -0
  42. package/dist/core/oauth-accounts.d.ts +29 -0
  43. package/dist/core/oauth-accounts.d.ts.map +1 -0
  44. package/dist/core/oauth-accounts.js +104 -0
  45. package/dist/core/oauth-accounts.js.map +1 -0
  46. package/dist/core/observability.d.ts +4 -0
  47. package/dist/core/observability.d.ts.map +1 -0
  48. package/dist/core/observability.js +38 -0
  49. package/dist/core/observability.js.map +1 -0
  50. package/dist/core/passwords.d.ts +52 -0
  51. package/dist/core/passwords.d.ts.map +1 -0
  52. package/dist/core/passwords.js +449 -0
  53. package/dist/core/passwords.js.map +1 -0
  54. package/dist/core/plugin-runtime.d.ts +8 -0
  55. package/dist/core/plugin-runtime.d.ts.map +1 -0
  56. package/dist/core/plugin-runtime.js +15 -0
  57. package/dist/core/plugin-runtime.js.map +1 -0
  58. package/dist/core/rate-limit.d.ts +4 -0
  59. package/dist/core/rate-limit.d.ts.map +1 -0
  60. package/dist/core/rate-limit.js +177 -0
  61. package/dist/core/rate-limit.js.map +1 -0
  62. package/dist/core/regions.d.ts +47 -0
  63. package/dist/core/regions.d.ts.map +1 -0
  64. package/dist/core/regions.js +620 -0
  65. package/dist/core/regions.js.map +1 -0
  66. package/dist/core/session-responses.d.ts +10 -0
  67. package/dist/core/session-responses.d.ts.map +1 -0
  68. package/dist/core/session-responses.js +22 -0
  69. package/dist/core/session-responses.js.map +1 -0
  70. package/dist/core/sessions.d.ts +50 -0
  71. package/dist/core/sessions.d.ts.map +1 -0
  72. package/dist/core/sessions.js +421 -0
  73. package/dist/core/sessions.js.map +1 -0
  74. package/dist/core/two-factor.d.ts +34 -0
  75. package/dist/core/two-factor.d.ts.map +1 -0
  76. package/dist/core/two-factor.js +494 -0
  77. package/dist/core/two-factor.js.map +1 -0
  78. package/dist/core/users.d.ts +12 -0
  79. package/dist/core/users.d.ts.map +1 -0
  80. package/dist/core/users.js +71 -0
  81. package/dist/core/users.js.map +1 -0
  82. package/dist/core/verifications.d.ts +52 -0
  83. package/dist/core/verifications.d.ts.map +1 -0
  84. package/dist/core/verifications.js +521 -0
  85. package/dist/core/verifications.js.map +1 -0
  86. package/dist/http/envelopes.d.ts +10 -0
  87. package/dist/http/envelopes.d.ts.map +1 -0
  88. package/dist/http/envelopes.js +99 -0
  89. package/dist/http/envelopes.js.map +1 -0
  90. package/dist/http/router.d.ts +16 -0
  91. package/dist/http/router.d.ts.map +1 -0
  92. package/dist/http/router.js +347 -0
  93. package/dist/http/router.js.map +1 -0
  94. package/dist/index.d.ts +10 -6
  95. package/dist/index.d.ts.map +1 -1
  96. package/dist/index.js +92 -227
  97. package/dist/index.js.map +1 -1
  98. package/dist/openapi.d.ts +4 -0
  99. package/dist/openapi.d.ts.map +1 -0
  100. package/dist/openapi.js +43 -0
  101. package/dist/openapi.js.map +1 -0
  102. package/dist/plugin-runner.d.ts +12 -0
  103. package/dist/plugin-runner.d.ts.map +1 -0
  104. package/dist/plugin-runner.js +206 -0
  105. package/dist/plugin-runner.js.map +1 -0
  106. package/dist/plugin-types.d.ts +205 -0
  107. package/dist/plugin-types.d.ts.map +1 -0
  108. package/dist/plugin-types.js +2 -0
  109. package/dist/plugin-types.js.map +1 -0
  110. package/dist/schema.d.ts +5 -10
  111. package/dist/schema.d.ts.map +1 -1
  112. package/dist/schema.js +113 -70
  113. package/dist/schema.js.map +1 -1
  114. package/dist/types.d.ts +433 -69
  115. package/dist/types.d.ts.map +1 -1
  116. package/dist/types.js +1 -4
  117. package/dist/types.js.map +1 -1
  118. package/package.json +44 -18
@@ -0,0 +1,99 @@
1
+ import { randomBytes } from 'node:crypto';
2
+ import { toAuthFnError } from '../core/errors.js';
3
+ const requestIds = new WeakMap();
4
+ export function resolveRequestId(request) {
5
+ const cached = requestIds.get(request);
6
+ if (cached) {
7
+ return cached;
8
+ }
9
+ const incoming = request.headers.get('x-request-id')?.trim();
10
+ if (incoming) {
11
+ requestIds.set(request, incoming);
12
+ return incoming;
13
+ }
14
+ const generated = createRequestId();
15
+ requestIds.set(request, generated);
16
+ return generated;
17
+ }
18
+ export function createRequestId() {
19
+ return `req_${randomBytes(8).toString('hex')}`;
20
+ }
21
+ export function successEnvelope(requestId, data) {
22
+ return {
23
+ ok: true,
24
+ data,
25
+ requestId
26
+ };
27
+ }
28
+ export function errorEnvelope(requestId, error) {
29
+ const authError = normalizeEnvelopeError(error);
30
+ return {
31
+ ok: false,
32
+ error: {
33
+ code: authError.code,
34
+ message: authError.message,
35
+ retryable: authError.retryable,
36
+ details: authError.details
37
+ },
38
+ requestId
39
+ };
40
+ }
41
+ export function jsonSuccess(request, data, init) {
42
+ const requestId = resolveRequestId(request);
43
+ return jsonWithHeaders(successEnvelope(requestId, data), requestId, init);
44
+ }
45
+ export function jsonError(request, error) {
46
+ const requestId = resolveRequestId(request);
47
+ const authError = normalizeEnvelopeError(error);
48
+ return jsonWithHeaders(errorEnvelope(requestId, authError), requestId, {
49
+ status: authError.status
50
+ });
51
+ }
52
+ function normalizeEnvelopeError(error) {
53
+ if (isAuthFnErrorLike(error)) {
54
+ return {
55
+ code: error.code,
56
+ message: error.message,
57
+ retryable: error.retryable,
58
+ details: isRecord(error.details) ? error.details : undefined,
59
+ status: normalizeHttpStatus(error.status)
60
+ };
61
+ }
62
+ return toAuthFnError(error);
63
+ }
64
+ function isAuthFnErrorLike(error) {
65
+ if (!error || typeof error !== 'object') {
66
+ return false;
67
+ }
68
+ const candidate = error;
69
+ return typeof candidate.code === 'string'
70
+ && candidate.code.startsWith('AUTHFN_')
71
+ && typeof candidate.message === 'string'
72
+ && typeof candidate.retryable === 'boolean'
73
+ && (candidate.details === undefined || isRecord(candidate.details))
74
+ && (candidate.status === undefined || typeof candidate.status === 'number');
75
+ }
76
+ function isRecord(value) {
77
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
78
+ }
79
+ function normalizeHttpStatus(status) {
80
+ return typeof status === 'number'
81
+ && Number.isInteger(status)
82
+ && status >= 400
83
+ && status <= 599
84
+ ? status
85
+ : 500;
86
+ }
87
+ function jsonWithHeaders(body, requestId, init) {
88
+ const headers = new Headers(init?.headers);
89
+ headers.set('content-type', 'application/json');
90
+ headers.set('x-request-id', requestId);
91
+ for (const cookie of init?.setCookies ?? []) {
92
+ headers.append('set-cookie', cookie);
93
+ }
94
+ return new Response(JSON.stringify(body), {
95
+ ...init,
96
+ headers
97
+ });
98
+ }
99
+ //# sourceMappingURL=envelopes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"envelopes.js","sourceRoot":"","sources":["../../src/http/envelopes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { type Route, type Router } from '@superfunctions/http';
2
+ import type { AuthFnRuntimeConfig, AuthFnHooks } from '../types.js';
3
+ export declare function createAuthFnRouter(config: AuthFnRuntimeConfig, _hooks: Partial<AuthFnHooks>, pluginRoutes: Route[]): Router;
4
+ export declare function createBaseRoutes(config: AuthFnRuntimeConfig, _hooks: Partial<AuthFnHooks>): Route[];
5
+ export declare function createPlaceholderRoute(method: Route['method'], path: string, operationId: string): Route;
6
+ export declare function cookieNamesForRequest(config: AuthFnRuntimeConfig, request: Request): Promise<{
7
+ sessionCookieName: string;
8
+ csrfCookieName: string;
9
+ }>;
10
+ export declare function issueCookiesForRequest(config: AuthFnRuntimeConfig, request: Request, sessionToken: string, csrfToken: string): Promise<string[]>;
11
+ export declare function createAuthFnRouteMeta(operationId: string, summary: string, auth: {
12
+ mode: 'none' | 'cookie-session' | 'bearer' | 'hybrid';
13
+ csrf?: boolean;
14
+ }): Route['meta'];
15
+ export declare function readOptionalJson<T extends Record<string, unknown>>(request: Request): Promise<T>;
16
+ //# sourceMappingURL=router.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/http/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqBpE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAC5B,YAAY,EAAE,KAAK,EAAE,GACpB,MAAM,CA2CR;AAqCD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAC3B,KAAK,EAAE,CAqMT;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EACvB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,KAAK,CAgBP;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5F,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAKD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9E,KAAK,CAAC,MAAM,CAAC,CASf;AAED,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,CAAC,CAAC,CAaZ"}
@@ -0,0 +1,347 @@
1
+ import { createObservabilityMiddleware, createRouter } from '@superfunctions/http';
2
+ import { AuthFnNotImplementedError, AuthFnUnauthenticatedError } from '../core/errors.js';
3
+ import { AuthFnValidationError } from '../core/errors.js';
4
+ import { clearSessionCookies, issueSessionCookies } from '../core/cookies.js';
5
+ import { assertValidCsrf, authenticateRequest, getCookieSessionState, listActiveSessionsForUser, requireCookieSession, revokeSessionById, revokeSessionsForUser } from '../core/sessions.js';
6
+ import { deleteAccountForUser, getAccountDetailsForUser } from '../core/account.js';
7
+ import { emitAuthEvent, eventRequestId } from '../core/observability.js';
8
+ import { createAuthFnRateLimitMiddleware } from '../core/rate-limit.js';
9
+ import { createAuthFnCellPlacementMiddleware } from '../core/gateway-routing.js';
10
+ import { getMultiRegionPluginConfig } from '../core/regions.js';
11
+ import { findUserById } from '../core/users.js';
12
+ import { jsonError, jsonSuccess } from './envelopes.js';
13
+ export function createAuthFnRouter(config, _hooks, pluginRoutes) {
14
+ const rateLimitMiddleware = createAuthFnRateLimitMiddleware(config);
15
+ const multiRegionConfig = getMultiRegionPluginConfig(config);
16
+ const placementMiddleware = multiRegionConfig
17
+ ? createAuthFnCellPlacementMiddleware(config, multiRegionConfig)
18
+ : null;
19
+ const middleware = [
20
+ ...(config.observability
21
+ ? [
22
+ createObservabilityMiddleware({
23
+ observability: config.observability,
24
+ serverTiming: true,
25
+ headers: { prefix: 'x-authfn' }
26
+ })
27
+ ]
28
+ : []),
29
+ ...(placementMiddleware ? [placementMiddleware] : []),
30
+ ...(rateLimitMiddleware ? [rateLimitMiddleware] : [])
31
+ ];
32
+ return createRouter({
33
+ basePath: config.basePath ?? '/auth',
34
+ middleware: middleware.length > 0 ? middleware : undefined,
35
+ routes: [...createBaseRoutes(config, _hooks), ...pluginRoutes],
36
+ onError: async (error, request) => {
37
+ const metadata = sanitizeErrorMetadata(describeRouteError(error, request));
38
+ if (isDebugErrorLoggingEnabled()) {
39
+ console.error('[authfn route error]', JSON.stringify(metadata));
40
+ }
41
+ try {
42
+ await emitAuthEvent(config, {
43
+ type: 'authfn.request.failed',
44
+ requestId: eventRequestId(request),
45
+ outcome: 'error',
46
+ metadata
47
+ });
48
+ }
49
+ catch {
50
+ // Error handling must still return the original auth response.
51
+ }
52
+ return jsonError(request, error);
53
+ }
54
+ });
55
+ }
56
+ function isDebugErrorLoggingEnabled() {
57
+ const globalProcess = globalThis;
58
+ return globalProcess.process?.env?.AUTHFN_DEBUG_ERRORS === 'true';
59
+ }
60
+ function describeRouteError(error, request) {
61
+ const raw = error && typeof error === 'object'
62
+ ? error
63
+ : {};
64
+ const cause = raw.cause;
65
+ return {
66
+ method: request.method,
67
+ path: new URL(request.url).pathname,
68
+ name: error instanceof Error ? error.name : typeof error,
69
+ errorKind: typeof raw.code === 'string' ? raw.code : undefined,
70
+ message: error instanceof Error ? error.message : String(error),
71
+ status: typeof raw.status === 'number' ? raw.status : undefined,
72
+ retryable: typeof raw.retryable === 'boolean' ? raw.retryable : undefined,
73
+ details: isRecord(raw.details) ? raw.details : undefined,
74
+ cause: cause instanceof Error
75
+ ? {
76
+ name: cause.name,
77
+ message: cause.message
78
+ }
79
+ : typeof cause === 'string'
80
+ ? cause
81
+ : undefined
82
+ };
83
+ }
84
+ export function createBaseRoutes(config, _hooks) {
85
+ return [
86
+ {
87
+ method: 'GET',
88
+ path: '/session',
89
+ meta: createAuthFnRouteMeta('getSession', 'Get the current session', {
90
+ mode: 'hybrid'
91
+ }),
92
+ handler: async (request) => {
93
+ const state = await getCookieSessionState(config, request);
94
+ const cookiesToClear = state.failureReason
95
+ ? Object.values(clearSessionCookies(state.cookiePolicy))
96
+ : [];
97
+ const session = state.session ?? await authenticateRequest(config, request);
98
+ return jsonSuccess(request, {
99
+ session: session?.type === 'session' && session.actorType === 'user'
100
+ ? session
101
+ : null
102
+ }, {
103
+ setCookies: cookiesToClear
104
+ });
105
+ }
106
+ },
107
+ {
108
+ method: 'GET',
109
+ path: '/account',
110
+ meta: createAuthFnRouteMeta('getAccountDetails', 'Get current user account details', {
111
+ mode: 'hybrid'
112
+ }),
113
+ handler: async (request) => {
114
+ const session = await authenticateRequest(config, request);
115
+ if (!session || session.type !== 'session' || session.actorType !== 'user') {
116
+ throw new AuthFnUnauthenticatedError();
117
+ }
118
+ const user = await findUserById(config, session.actorId);
119
+ if (!user) {
120
+ throw new AuthFnUnauthenticatedError('Authenticated user no longer exists');
121
+ }
122
+ const account = await getAccountDetailsForUser(config, user);
123
+ return jsonSuccess(request, {
124
+ ...account,
125
+ regionId: session.regionId
126
+ });
127
+ }
128
+ },
129
+ {
130
+ method: 'DELETE',
131
+ path: '/account',
132
+ meta: createAuthFnRouteMeta('deleteAccount', 'Delete the current user account', {
133
+ mode: 'hybrid',
134
+ csrf: true
135
+ }),
136
+ handler: async (request) => {
137
+ const cookieState = await getCookieSessionState(config, request);
138
+ let session = cookieState.session ?? null;
139
+ if (session) {
140
+ assertValidCsrf(request, cookieState);
141
+ }
142
+ else {
143
+ session = await authenticateRequest(config, request);
144
+ }
145
+ if (!session || session.type !== 'session' || session.actorType !== 'user') {
146
+ throw new AuthFnUnauthenticatedError();
147
+ }
148
+ const user = await findUserById(config, session.actorId);
149
+ if (!user) {
150
+ throw new AuthFnUnauthenticatedError('Authenticated user no longer exists');
151
+ }
152
+ const deletion = await deleteAccountForUser(config, _hooks, {
153
+ user,
154
+ session,
155
+ request
156
+ });
157
+ const cookiesToClear = cookieState.session || cookieState.failureReason
158
+ ? Object.values(clearSessionCookies(cookieState.cookiePolicy))
159
+ : [];
160
+ return jsonSuccess(request, deletion, {
161
+ setCookies: cookiesToClear
162
+ });
163
+ }
164
+ },
165
+ {
166
+ method: 'GET',
167
+ path: '/sessions',
168
+ meta: createAuthFnRouteMeta('listSessions', 'List active sessions for the current user', {
169
+ mode: 'cookie-session'
170
+ }),
171
+ handler: async (request) => {
172
+ const state = await requireCookieSession(config, request);
173
+ const sessions = await listActiveSessionsForUser(config, state.user, {
174
+ regionId: state.runtime.regionId
175
+ });
176
+ return jsonSuccess(request, {
177
+ sessions,
178
+ currentSessionId: state.session.id
179
+ });
180
+ }
181
+ },
182
+ {
183
+ method: 'POST',
184
+ path: '/sign-out',
185
+ meta: createAuthFnRouteMeta('signOut', 'Revoke the current session', {
186
+ mode: 'cookie-session',
187
+ csrf: true
188
+ }),
189
+ handler: async (request) => {
190
+ const state = await getCookieSessionState(config, request);
191
+ const body = await readOptionalJson(request);
192
+ if (!state.session || !state.sessionRecord || !state.user) {
193
+ const cookies = Object.values(clearSessionCookies(state.cookiePolicy));
194
+ return jsonSuccess(request, {
195
+ revoked: false,
196
+ allSessions: Boolean(body.allSessions)
197
+ }, {
198
+ setCookies: cookies
199
+ });
200
+ }
201
+ assertValidCsrf(request, state);
202
+ if (body.allSessions) {
203
+ await revokeSessionsForUser(config, state.user.id);
204
+ }
205
+ else {
206
+ await revokeSessionById(config, state.session.id, {
207
+ userId: state.user.id
208
+ });
209
+ }
210
+ await emitAuthEvent(config, {
211
+ type: 'authfn.session.revoked',
212
+ requestId: eventRequestId(request),
213
+ actorId: state.user.id,
214
+ sessionId: body.allSessions ? undefined : state.session.id,
215
+ userId: state.user.id,
216
+ regionId: state.session.regionId,
217
+ outcome: body.allSessions ? 'revoked-all' : 'revoked-current',
218
+ metadata: {
219
+ allSessions: Boolean(body.allSessions)
220
+ }
221
+ });
222
+ const cookies = Object.values(clearSessionCookies(state.cookiePolicy));
223
+ return jsonSuccess(request, {
224
+ revoked: true,
225
+ allSessions: Boolean(body.allSessions)
226
+ }, {
227
+ setCookies: cookies
228
+ });
229
+ }
230
+ },
231
+ {
232
+ method: 'POST',
233
+ path: '/sessions/:sessionId/revoke',
234
+ meta: createAuthFnRouteMeta('revokeSession', 'Revoke a specific session', {
235
+ mode: 'cookie-session',
236
+ csrf: true
237
+ }),
238
+ handler: async (request, context) => {
239
+ const state = await requireCookieSession(config, request);
240
+ assertValidCsrf(request, state);
241
+ await revokeSessionById(config, context.params.sessionId, {
242
+ userId: state.user.id
243
+ });
244
+ await emitAuthEvent(config, {
245
+ type: 'authfn.session.revoked',
246
+ requestId: eventRequestId(request),
247
+ actorId: state.user.id,
248
+ sessionId: context.params.sessionId,
249
+ userId: state.user.id,
250
+ regionId: state.session.regionId,
251
+ outcome: 'revoked-specific'
252
+ });
253
+ const cookies = context.params.sessionId === state.session.id
254
+ ? Object.values(clearSessionCookies(state.cookiePolicy))
255
+ : [];
256
+ return jsonSuccess(request, {
257
+ revoked: true,
258
+ sessionId: context.params.sessionId
259
+ }, {
260
+ setCookies: cookies
261
+ });
262
+ }
263
+ }
264
+ ];
265
+ }
266
+ export function createPlaceholderRoute(method, path, operationId) {
267
+ return {
268
+ method,
269
+ path,
270
+ meta: createAuthFnRouteMeta(operationId, `Placeholder route for ${path}`, {
271
+ mode: method === 'GET' ? 'none' : 'cookie-session',
272
+ csrf: method !== 'GET'
273
+ }),
274
+ handler: async (request) => jsonError(request, new AuthFnNotImplementedError('This authfn route is not implemented in the current phase', {
275
+ operationId
276
+ }))
277
+ };
278
+ }
279
+ export function cookieNamesForRequest(config, request) {
280
+ return getCookieSessionState(config, request).then((state) => ({
281
+ sessionCookieName: state.cookiePolicy.sessionCookieName,
282
+ csrfCookieName: state.cookiePolicy.csrfCookieName
283
+ }));
284
+ }
285
+ export function issueCookiesForRequest(config, request, sessionToken, csrfToken) {
286
+ return getCookieSessionState(config, request).then((state) => Object.values(issueSessionCookies(state.cookiePolicy, sessionToken, csrfToken)));
287
+ }
288
+ export function createAuthFnRouteMeta(operationId, summary, auth) {
289
+ return {
290
+ auth,
291
+ openapi: {
292
+ operationId,
293
+ summary,
294
+ tags: ['authfn']
295
+ }
296
+ };
297
+ }
298
+ export async function readOptionalJson(request) {
299
+ const raw = await request.text();
300
+ if (!raw) {
301
+ return {};
302
+ }
303
+ try {
304
+ return JSON.parse(raw);
305
+ }
306
+ catch (error) {
307
+ throw new AuthFnValidationError('Request body must be valid JSON', {
308
+ cause: error instanceof Error ? error.message : String(error)
309
+ });
310
+ }
311
+ }
312
+ function isRecord(value) {
313
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
314
+ }
315
+ const SENSITIVE_ERROR_METADATA_KEY = /(authorization|cookie|password|secret|token|code|hash|access|refresh|idtoken|clientsecret)/i;
316
+ function sanitizeErrorMetadata(value, key) {
317
+ const sanitized = sanitizeErrorMetadataValue(value, key, new WeakSet());
318
+ return isRecord(sanitized) ? sanitized : {};
319
+ }
320
+ function sanitizeErrorMetadataValue(value, key, seen) {
321
+ if (key && SENSITIVE_ERROR_METADATA_KEY.test(key)) {
322
+ return '[redacted]';
323
+ }
324
+ if (Array.isArray(value)) {
325
+ if (seen.has(value)) {
326
+ return '[Circular]';
327
+ }
328
+ seen.add(value);
329
+ const sanitized = value.map((entry) => sanitizeErrorMetadataValue(entry, undefined, seen));
330
+ seen.delete(value);
331
+ return sanitized;
332
+ }
333
+ if (isRecord(value)) {
334
+ if (seen.has(value)) {
335
+ return '[Circular]';
336
+ }
337
+ seen.add(value);
338
+ const sanitized = Object.fromEntries(Object.entries(value).map(([entryKey, entryValue]) => [
339
+ entryKey,
340
+ sanitizeErrorMetadataValue(entryValue, entryKey, seen)
341
+ ]));
342
+ seen.delete(value);
343
+ return sanitized;
344
+ }
345
+ return value;
346
+ }
347
+ //# sourceMappingURL=router.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/http/router.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,11 +1,15 @@
1
+ import type { AuthFnApp, AuthFnConfig, AuthFnPluginList } from './types.js';
2
+ export type * from './types.js';
3
+ export type { AuthFnApiKeyRecord, AuthFnAccountDeletionResult, AuthFnConfig, AuthFnErrorEnvelope, AuthFnApp, AuthFnAnyPlugin, AuthFnRuntimeConfig, AuthFnServer, AuthFnServerConfig, AuthFnNativeHandoffCodeRecord, AuthFnPasswordCredentialRecord, AuthFnPlugin, AuthFnPluginList, AuthFnPluginRuntimeConfigFor, AuthFnSchemaDefinition, AuthFnSession, AuthFnSessionRecord, AuthFnSuccessEnvelope, AuthFnUserRecord } from './types.js';
4
+ export { AuthFnAdminAmbiguousUserError, AuthFnAdminConfigError, AuthFnAdminUnauthorizedError, AuthFnApiKeyRevokedError, AuthFnConfigError, AuthFnConflictError, AuthFnCsrfInvalidError, AuthFnEmailNotVerifiedError, AuthFnError, AuthFnInternalError, AuthFnInvalidCredentialsError, AuthFnNotFoundError, AuthFnNotImplementedError, AuthFnOAuthCallbackInvalidError, AuthFnOAuthProviderUnsupportedError, AuthFnOAuthStateInvalidError, AuthFnOAuthStateReplayedError, AuthFnPlacementDirectoryUnavailableError, AuthFnPlacementMovingError, AuthFnPluginAbortedError, AuthFnRateLimitedError, AuthFnRedirectUriDisallowedError, AuthFnRegionMismatchError, AuthFnRegionNotFoundError, AuthFnRoutingAssertionInvalidError, AuthFnRoutingCellUnavailableError, AuthFnSessionExpiredError, AuthFnSessionRevokedError, AuthFnTwoFactorInvalidCodeError, AuthFnTwoFactorRequiredError, AuthFnUnauthenticatedError, AuthFnValidationError } from './types.js';
5
+ export { AUTHFN_SCHEMA_VERSION, createCoreTables, getSchema } from './schema.js';
6
+ export { createAuthFnOpenApiDocument } from './openapi.js';
1
7
  /**
2
- * authfn - API key authentication using Superfunctions abstractions
8
+ * Preserves exact plugin identity so AuthFn can infer runtime dependencies.
3
9
  */
4
- import type { AuthFnConfig, AuthFnInstance } from './types.js';
10
+ export declare function authFnPlugins<const TPlugins extends AuthFnPluginList>(...plugins: TPlugins): TPlugins;
5
11
  /**
6
- * Create authfn instance
12
+ * Declares a side-effect-free AuthFn app for codegen and runtime use.
7
13
  */
8
- export declare function createAuthFn(config: AuthFnConfig): AuthFnInstance;
9
- export type { AuthFnConfig, AuthFnInstance, ApiKey, ApiKeySession } from './types.js';
10
- export { getSchema } from './schema.js';
14
+ export declare function authfn<const TPlugins extends AuthFnPluginList>(config: AuthFnConfig<TPlugins>): AuthFnApp<TPlugins>;
11
15
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAsBtF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CA+PjE;AAGD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAIZ,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAKpB,mBAAmB,YAAY,CAAC;AAChC,YAAY,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,YAAY,EACZ,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,EACX,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACnB,yBAAyB,EACzB,+BAA+B,EAC/B,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC7B,wCAAwC,EACxC,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,gCAAgC,EAChC,yBAAyB,EACzB,yBAAyB,EACzB,kCAAkC,EAClC,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,QAAQ,SAAS,gBAAgB,EACnE,GAAG,OAAO,EAAE,QAAQ,GACnB,QAAQ,CAEV;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,QAAQ,SAAS,gBAAgB,EAC5D,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC7B,SAAS,CAAC,QAAQ,CAAC,CAarB"}