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,177 @@
1
+ import { AuthFnRateLimitedError } from './errors.js';
2
+ const defaultPolicies = {
3
+ password: { ipLimit: 30, identifierLimit: 10, windowSeconds: 60 },
4
+ 'otp-send': { ipLimit: 20, identifierLimit: 5, windowSeconds: 300 },
5
+ 'otp-verify': { ipLimit: 30, identifierLimit: 10, windowSeconds: 300 },
6
+ 'password-reset': { ipLimit: 20, identifierLimit: 5, windowSeconds: 300 },
7
+ 'social-start': { ipLimit: 60, windowSeconds: 60 },
8
+ handoff: { ipLimit: 30, windowSeconds: 60 },
9
+ 'region-lookup': { ipLimit: 120, identifierLimit: 60, windowSeconds: 60 },
10
+ account: { ipLimit: 120, windowSeconds: 60 },
11
+ };
12
+ export function createAuthFnRateLimitMiddleware(config) {
13
+ const rateLimit = config.rateLimit;
14
+ if (!rateLimit?.enabled) {
15
+ return undefined;
16
+ }
17
+ const mode = resolveMode(rateLimit.mode, config);
18
+ if (mode === 'strict' && !config.stores?.atomicKv) {
19
+ throw new Error('AUTHFN_ATOMIC_STORE_REQUIRED: rateLimit strict mode requires stores.atomicKv');
20
+ }
21
+ const localState = createLocalRateLimitState();
22
+ return async (request, _context, next) => {
23
+ const path = new URL(request.url).pathname;
24
+ const scope = scopeForPath(path);
25
+ const policy = policyForScope(config, scope);
26
+ const identifier = await readIdentifier(request.clone());
27
+ const ip = (await rateLimit.resolveClientIp?.(request))?.trim() || 'unknown';
28
+ const checks = await buildChecks(scope, policy, ip, identifier);
29
+ for (const check of checks) {
30
+ const count = await incrementCheck(config, mode, check, localState);
31
+ if (count > check.limit) {
32
+ throw new AuthFnRateLimitedError(undefined, {
33
+ path,
34
+ scope,
35
+ dimension: check.dimension,
36
+ resetAt: new Date(Date.now() + check.windowSeconds * 1000).toISOString()
37
+ });
38
+ }
39
+ }
40
+ return next();
41
+ };
42
+ }
43
+ function resolveMode(mode, config) {
44
+ return mode ?? (config.stores?.atomicKv ? 'strict' : config.stores?.kv ? 'best-effort' : 'local');
45
+ }
46
+ function policyForScope(config, scope) {
47
+ const policies = {
48
+ ...defaultPolicies,
49
+ ...config.rateLimit?.policies
50
+ };
51
+ return policies[scope] ?? defaultPolicies.account;
52
+ }
53
+ function scopeForPath(path) {
54
+ if (path.endsWith('/sign-in/password') || path.endsWith('/sign-up/password'))
55
+ return 'password';
56
+ if (path.endsWith('/otp/send'))
57
+ return 'otp-send';
58
+ if (path.endsWith('/otp/verify'))
59
+ return 'otp-verify';
60
+ if (path.endsWith('/password/reset/start')
61
+ || path.endsWith('/password/reset/complete'))
62
+ return 'password-reset';
63
+ if (path.endsWith('/social/start'))
64
+ return 'social-start';
65
+ if (path.includes('/handoff/'))
66
+ return 'handoff';
67
+ if (path.endsWith('/regions/lookup'))
68
+ return 'region-lookup';
69
+ return 'account';
70
+ }
71
+ async function buildChecks(scope, policy, ip, identifier) {
72
+ const checks = [
73
+ {
74
+ key: `ip:${hashKeyPart(ip)}`,
75
+ limit: policy.ipLimit,
76
+ windowSeconds: policy.windowSeconds,
77
+ dimension: 'ip',
78
+ scope
79
+ }
80
+ ];
81
+ if (identifier && policy.identifierLimit) {
82
+ checks.push({
83
+ key: `identifier:${await hashIdentifier(identifier)}`,
84
+ limit: policy.identifierLimit,
85
+ windowSeconds: policy.windowSeconds,
86
+ dimension: 'identifier',
87
+ scope
88
+ });
89
+ }
90
+ return checks;
91
+ }
92
+ async function incrementCheck(config, mode, check, localState) {
93
+ const windowId = Math.floor(Date.now() / (check.windowSeconds * 1000));
94
+ const key = `authfn:${config.namespace ?? 'authfn'}:ratelimit:${check.scope}:${check.key}:${windowId}`;
95
+ if (mode === 'strict') {
96
+ return incrementAtomic(config.stores.atomicKv, key, check.windowSeconds);
97
+ }
98
+ if (mode === 'best-effort' && config.stores?.kv) {
99
+ return incrementCache(config.stores.kv, key, check.windowSeconds);
100
+ }
101
+ return incrementLocal(localState, key, check.windowSeconds);
102
+ }
103
+ async function incrementAtomic(store, key, windowSeconds) {
104
+ return (await store.incr({ key, by: 1, ttlSeconds: windowSeconds })).value;
105
+ }
106
+ const MAX_LOCAL_RATE_LIMIT_WINDOWS = 10_000;
107
+ const LOCAL_SWEEP_INTERVAL = 128;
108
+ function createLocalRateLimitState() {
109
+ return { windows: new Map(), incrementCount: 0 };
110
+ }
111
+ async function incrementCache(store, key, windowSeconds) {
112
+ const current = Number(await store.get(key) ?? '0');
113
+ const next = current + 1;
114
+ await store.set({
115
+ key,
116
+ value: String(next),
117
+ ttlSeconds: windowSeconds
118
+ });
119
+ return next;
120
+ }
121
+ function incrementLocal(state, key, windowSeconds) {
122
+ const now = Date.now();
123
+ state.incrementCount += 1;
124
+ if (state.incrementCount % LOCAL_SWEEP_INTERVAL === 0) {
125
+ sweepExpiredLocalWindows(state, now);
126
+ }
127
+ const existing = state.windows.get(key);
128
+ if (!existing || existing.expiresAt <= now) {
129
+ if (!existing && state.windows.size >= MAX_LOCAL_RATE_LIMIT_WINDOWS) {
130
+ sweepExpiredLocalWindows(state, now);
131
+ if (state.windows.size >= MAX_LOCAL_RATE_LIMIT_WINDOWS) {
132
+ // Preserve every active counter. Admitting an untracked key here would
133
+ // let key churn reset a victim's limit, so local mode fails closed
134
+ // until an existing window expires.
135
+ return Number.POSITIVE_INFINITY;
136
+ }
137
+ }
138
+ state.windows.set(key, { count: 1, expiresAt: now + windowSeconds * 1000 });
139
+ return 1;
140
+ }
141
+ existing.count += 1;
142
+ return existing.count;
143
+ }
144
+ function sweepExpiredLocalWindows(state, now) {
145
+ for (const [key, window] of state.windows) {
146
+ if (window.expiresAt <= now) {
147
+ state.windows.delete(key);
148
+ }
149
+ }
150
+ }
151
+ function hashKeyPart(value) {
152
+ return value.replace(/[^a-zA-Z0-9_.:-]/g, '_').slice(0, 128);
153
+ }
154
+ async function hashIdentifier(identifier) {
155
+ const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(identifier));
156
+ return Array.from(new Uint8Array(digest))
157
+ .map((byte) => byte.toString(16).padStart(2, '0'))
158
+ .join('');
159
+ }
160
+ async function readIdentifier(request) {
161
+ if (request.method !== 'POST') {
162
+ return null;
163
+ }
164
+ try {
165
+ const body = await request.json();
166
+ const value = typeof body.email === 'string'
167
+ ? body.email
168
+ : typeof body.identifier === 'string'
169
+ ? body.identifier
170
+ : undefined;
171
+ return value?.trim().toLowerCase() ?? null;
172
+ }
173
+ catch {
174
+ return null;
175
+ }
176
+ }
177
+ //# sourceMappingURL=rate-limit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/core/rate-limit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ import type { MultiRegionPluginRuntimeConfig, AuthFnMultiRegionRegionConfig } from '../plugin-types.js';
2
+ import type { AuthFnRuntimeConfig, AuthFnRegionLookup, AuthFnRegionLookupResult, AuthFnRegionProfileRecord, AuthFnEnvironment, AuthFnEnvironmentResolver, AuthFnUserRecord } from '../types.js';
3
+ declare const multiRegionEnvironmentConfig: unique symbol;
4
+ export interface AuthFnMultiRegionEnvironmentResolver extends AuthFnEnvironmentResolver {
5
+ readonly [multiRegionEnvironmentConfig]: MultiRegionPluginRuntimeConfig;
6
+ }
7
+ /**
8
+ * Creates an AuthFn request environment resolver from multi-region routing config.
9
+ */
10
+ export declare function authFnMultiRegionEnvironment(config: MultiRegionPluginRuntimeConfig): AuthFnMultiRegionEnvironmentResolver;
11
+ export declare function getMultiRegionPluginConfig(config: Pick<AuthFnRuntimeConfig, 'plugins' | 'environment'>): MultiRegionPluginRuntimeConfig | null;
12
+ export declare function lookupRegionByIdentifier(config: Pick<AuthFnRuntimeConfig, 'database' | 'stores' | 'namespace' | 'plugins'>, pluginConfig: MultiRegionPluginRuntimeConfig, input: {
13
+ identifier: string;
14
+ request?: Request;
15
+ environment: AuthFnEnvironment;
16
+ bypassCache?: boolean;
17
+ }): Promise<AuthFnRegionLookup | null>;
18
+ export declare function buildLookupResult(config: Pick<AuthFnRuntimeConfig, 'database' | 'stores' | 'namespace' | 'plugins'>, pluginConfig: MultiRegionPluginRuntimeConfig, input: {
19
+ identifier: string;
20
+ request?: Request;
21
+ environment: AuthFnEnvironment;
22
+ }): Promise<AuthFnRegionLookupResult>;
23
+ export declare function ensureRegionAlignmentForUser(config: Pick<AuthFnRuntimeConfig, 'database' | 'stores' | 'namespace' | 'plugins'>, pluginConfig: MultiRegionPluginRuntimeConfig, input: {
24
+ userId: string;
25
+ environment: AuthFnEnvironment;
26
+ request?: Request;
27
+ }): Promise<{
28
+ regionId?: string;
29
+ }>;
30
+ export declare function ensureRegionAlignmentForIdentifier(config: Pick<AuthFnRuntimeConfig, 'database' | 'stores' | 'namespace' | 'plugins'>, pluginConfig: MultiRegionPluginRuntimeConfig, input: {
31
+ identifier: string;
32
+ environment: AuthFnEnvironment;
33
+ request?: Request;
34
+ }): Promise<{
35
+ regionId?: string;
36
+ }>;
37
+ export declare function registerUserRegion(config: Pick<AuthFnRuntimeConfig, 'database' | 'stores' | 'namespace' | 'observability'>, pluginConfig: MultiRegionPluginRuntimeConfig, input: {
38
+ user: Pick<AuthFnUserRecord, 'id' | 'primaryEmail'>;
39
+ environment: AuthFnEnvironment;
40
+ request?: Request;
41
+ }): Promise<AuthFnRegionProfileRecord | null>;
42
+ export declare function unregisterRegionLookupForIdentifier(config: Pick<AuthFnRuntimeConfig, 'stores' | 'namespace'>, pluginConfig: MultiRegionPluginRuntimeConfig, identifier: string): Promise<void>;
43
+ export declare function findRegionProfileByUserId(config: Pick<AuthFnRuntimeConfig, 'database' | 'namespace'>, userId: string): Promise<AuthFnRegionProfileRecord | null>;
44
+ export declare function resolveRegionForRequest(pluginConfig: MultiRegionPluginRuntimeConfig, request: Request, runtime: AuthFnEnvironment): AuthFnMultiRegionRegionConfig | null;
45
+ export declare function normalizeIdentifier(identifier: string): string;
46
+ export {};
47
+ //# sourceMappingURL=regions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../../src/core/regions.ts"],"names":[],"mappings":"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"}