@reopt-ai/brandapp-sdk 3.3.0 → 3.5.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 (104) hide show
  1. package/CHANGELOG.md +115 -0
  2. package/README.md +10 -1
  3. package/dist/abort--nOBFN4M.js +50 -0
  4. package/dist/ai/index.d.ts +2 -314
  5. package/dist/ai/index.js +3 -8
  6. package/dist/ai-provider/index.d.ts +79 -163
  7. package/dist/ai-provider/index.js +752 -685
  8. package/dist/auth/index.d.ts +27 -27
  9. package/dist/auth/index.js +41 -34
  10. package/dist/better-auth/client.d.ts +6 -5
  11. package/dist/better-auth/client.js +28 -5
  12. package/dist/better-auth/index.d.ts +19 -17
  13. package/dist/better-auth/index.js +180 -144
  14. package/dist/client-61ldOHMz.js +503 -0
  15. package/dist/client-7PCoxVhZ.js +28 -0
  16. package/dist/client-B7rZQ8Zi.d.ts +272 -0
  17. package/dist/client-BGGd_cpV.d.ts +103 -0
  18. package/dist/client-BoIuyx4S.js +273 -0
  19. package/dist/client-BruP5_nU.d.ts +147 -0
  20. package/dist/client-BxtZt405.js +305 -0
  21. package/dist/client-ByN3EQdk.js +83 -0
  22. package/dist/client-CAghoGD_.js +53 -0
  23. package/dist/client-C_pHsPlj.js +81 -0
  24. package/dist/client-D0eBxh8j.d.ts +284 -0
  25. package/dist/client-D6gs61w8.d.ts +53 -0
  26. package/dist/client-DDw5yz_h.d.ts +53 -0
  27. package/dist/client-Dxg8_DIH.d.ts +71 -0
  28. package/dist/client-aMR4CRB8.d.ts +211 -0
  29. package/dist/client-lk6wBu_0.d.ts +48 -0
  30. package/dist/client-wEVKLdly.js +55 -0
  31. package/dist/client-zF1RG2uA.js +86 -0
  32. package/dist/cms/index.d.ts +52 -108
  33. package/dist/cms/index.js +103 -86
  34. package/dist/config-CRytOPPl.d.ts +394 -0
  35. package/dist/config-aml9oQpX.js +487 -0
  36. package/dist/dev/index.d.ts +2 -528
  37. package/dist/dev/index.js +3047 -2967
  38. package/dist/eav/coerce.d.ts +3 -1
  39. package/dist/eav/coerce.js +72 -46
  40. package/dist/eav/index.d.ts +72 -100
  41. package/dist/eav/index.js +158 -126
  42. package/dist/eav/migrate.d.ts +112 -109
  43. package/dist/eav/migrate.js +230 -196
  44. package/dist/eav/schema.d.ts +111 -150
  45. package/dist/eav/schema.js +624 -603
  46. package/dist/encoding-Bwfm3iaE.js +21 -0
  47. package/dist/{errors-BjDFIyA6.d.ts → errors-CRCcErNC.d.ts} +55 -53
  48. package/dist/feedback/index.d.ts +2 -132
  49. package/dist/feedback/index.js +3 -6
  50. package/dist/files/index.d.ts +14 -14
  51. package/dist/files/index.js +41 -25
  52. package/dist/http-client-BZc2mngq.js +386 -0
  53. package/dist/index-1j_738qk.d.ts +470 -0
  54. package/dist/index-CeOLGdyL.d.ts +169 -0
  55. package/dist/index.d.ts +6 -230
  56. package/dist/index.js +119 -71
  57. package/dist/logout/index.d.ts +56 -53
  58. package/dist/logout/index.js +232 -289
  59. package/dist/plans/index.d.ts +2 -236
  60. package/dist/plans/index.js +3 -6
  61. package/dist/push/index.d.ts +2 -79
  62. package/dist/push/index.js +3 -6
  63. package/dist/query-xWqtfkvR.js +35 -0
  64. package/dist/react/hooks.d.ts +157 -100
  65. package/dist/react/hooks.js +862 -406
  66. package/dist/sse-parser-FMjxM7sY.js +86 -0
  67. package/dist/terms/index.d.ts +3 -79
  68. package/dist/terms/index.js +3 -6
  69. package/dist/testing/index.d.ts +52 -104
  70. package/dist/testing/index.js +94 -72
  71. package/dist/types-B-SMkH6s.d.ts +26 -0
  72. package/dist/types-BXDcoJHG.d.ts +131 -0
  73. package/dist/types-BrghN2rJ.d.ts +105 -0
  74. package/dist/types-DjDRszNj.js +11 -0
  75. package/dist/webhooks/index.d.ts +77 -50
  76. package/dist/webhooks/index.js +150 -127
  77. package/docs/api-reference.md +121 -8
  78. package/docs/errors.md +19 -0
  79. package/docs/files.md +165 -7
  80. package/package.json +7 -6
  81. package/dist/chunk-2LSCQHAU.js +0 -21
  82. package/dist/chunk-4U4ZPPL4.js +0 -599
  83. package/dist/chunk-55KHY5GH.js +0 -96
  84. package/dist/chunk-C5VTRZWX.js +0 -458
  85. package/dist/chunk-F7BXBTZI.js +0 -54
  86. package/dist/chunk-FJUCWXX3.js +0 -350
  87. package/dist/chunk-H33OTQEN.js +0 -112
  88. package/dist/chunk-L4DHB36G.js +0 -75
  89. package/dist/chunk-OG7R3UAR.js +0 -105
  90. package/dist/chunk-PF24XU54.js +0 -32
  91. package/dist/chunk-QN3QD67K.js +0 -49
  92. package/dist/chunk-REIKXSMY.js +0 -7
  93. package/dist/chunk-UGBBXCZE.js +0 -157
  94. package/dist/chunk-UVT2E6KD.js +0 -81
  95. package/dist/chunk-YPLT3RFL.js +0 -63
  96. package/dist/chunk-YTKSAWV2.js +0 -463
  97. package/dist/client-BkcO-0C2.d.ts +0 -216
  98. package/dist/client-CN5_tNOC.d.ts +0 -147
  99. package/dist/client-DttyeM_h.d.ts +0 -102
  100. package/dist/config-CtxyJsDR.d.ts +0 -397
  101. package/dist/typed-client-BxOVIiMU.d.ts +0 -40
  102. package/dist/types-6E3ZLL9X.d.ts +0 -24
  103. package/dist/types-DskYLVb8.d.ts +0 -104
  104. package/dist/types-ckmDDW3N.d.ts +0 -129
@@ -1,321 +1,264 @@
1
- import { resolveIdBaseUrl, ReoptSDKError } from '../chunk-C5VTRZWX.js';
1
+ import { a as resolveIdBaseUrl, x as ReoptSDKError } from "../config-aml9oQpX.js";
2
2
 
3
- // src/logout/verify.ts
4
- var BACKCHANNEL_LOGOUT_EVENT = "http://schemas.openid.net/event/backchannel-logout";
5
- var JWKS_CACHE_TTL_MS = 10 * 60 * 1e3;
6
- var DEFAULT_MAX_TOKEN_AGE_MS = 5 * 60 * 1e3;
7
- var VERIFICATION_FETCH_TIMEOUT_MS = 5 * 1e3;
8
- var JWKS_MIN_FORCED_REFETCH_INTERVAL_MS = 30 * 1e3;
9
- var jwksCache = /* @__PURE__ */ new Map();
10
- var jwksInflight = /* @__PURE__ */ new Map();
11
- var jwksLastForcedRefetch = /* @__PURE__ */ new Map();
12
- var discoveryCache = /* @__PURE__ */ new Map();
3
+ //#region src/logout/verify.ts
4
+ /**
5
+ * OIDC Back-Channel Logout 1.0 — logout_token 검증 (수신 측).
6
+ *
7
+ * reopt(IdP)가 IdP 세션 폐기 시 등록된 RP의 backchannel_logout_uri로 POST하는
8
+ * logout_token(EdDSA JWT)을 검증한다. 검증에 성공하면 `{ sid, sub }`를 반환하고,
9
+ * 실패하면 ReoptSDKError를 던진다.
10
+ *
11
+ * 서명 검증은 **Web Crypto(Ed25519)** 로 하며 외부 의존이 없다 — reopt jwks_uri의
12
+ * 공개키(OKP/Ed25519)를 fetch해 검증한다. reopt jwt 플러그인은 EdDSA로 서명하며
13
+ * (기본값, keyPairConfig 미지정), 프로덕션 `id.reopt.ai/api/auth/jwks`가 실제로
14
+ * `alg:EdDSA, kty:OKP, crv:Ed25519`를 노출함을 확인했다(2026-07-24). ⚠️ Ed25519
15
+ * Web Crypto는 Node 20+ · 최신 브라우저 · Deno · Cloudflare Workers에서 지원된다
16
+ * (back-channel 수신은 서버 사이드라 Node 20+ 환경이면 충분).
17
+ *
18
+ * 스펙 §2.6 검증 규칙 전부 적용: 서명·iss·aud·iat·events·(sid|sub)·nonce 금지.
19
+ */
20
+ const BACKCHANNEL_LOGOUT_EVENT = "http://schemas.openid.net/event/backchannel-logout";
21
+ /** JWKS 캐시 TTL — 키 로테이션과 조회 비용의 절충. 검증 실패 시 강제 refetch도 있음. */
22
+ const JWKS_CACHE_TTL_MS = 600 * 1e3;
23
+ /** logout_token iat 허용 나이 — 지연 전달·시계 편차를 감안. */
24
+ const DEFAULT_MAX_TOKEN_AGE_MS = 300 * 1e3;
25
+ /**
26
+ * discovery/JWKS fetch 타임아웃. back-channel 엔드포인트는 공개(무인증)라, 느린
27
+ * IdP로의 무한 fetch가 요청 핸들러를 붙잡지 못하게 상한을 둔다(fail-closed).
28
+ */
29
+ const VERIFICATION_FETCH_TIMEOUT_MS = 5 * 1e3;
30
+ /**
31
+ * jwks_uri별 *강제* refetch 최소 간격. 서명 불일치는 강제 refetch(키 로테이션 대응)를
32
+ * 부르는데, 이 스로틀이 위조 토큰 폭주가 공유 JWKS 엔드포인트로 부하를 반사시키는 것을
33
+ * 막는다. 초기 캐시 채우기 fetch(forceRefresh=false)는 이 창에 포함되지 않으므로, 실제
34
+ * 로테이션은 단일 검증 안에서 여전히 복구된다.
35
+ */
36
+ const JWKS_MIN_FORCED_REFETCH_INTERVAL_MS = 30 * 1e3;
37
+ const jwksCache = /* @__PURE__ */ new Map();
38
+ const jwksInflight = /* @__PURE__ */ new Map();
39
+ const jwksLastForcedRefetch = /* @__PURE__ */ new Map();
40
+ const discoveryCache = /* @__PURE__ */ new Map();
13
41
  function base64UrlDecode(input) {
14
- const pad = input.length % 4 === 0 ? "" : "=".repeat(4 - input.length % 4);
15
- const base64 = (input + pad).replace(/-/g, "+").replace(/_/g, "/");
16
- const binary = atob(base64);
17
- const bytes = new Uint8Array(binary.length);
18
- for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
19
- return bytes;
42
+ const base64 = (input + (input.length % 4 === 0 ? "" : "=".repeat(4 - input.length % 4))).replace(/-/g, "+").replace(/_/g, "/");
43
+ const binary = atob(base64);
44
+ const bytes = new Uint8Array(binary.length);
45
+ for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
46
+ return bytes;
20
47
  }
21
48
  function decodeJson(segment) {
22
- return JSON.parse(new TextDecoder().decode(base64UrlDecode(segment)));
49
+ return JSON.parse(new TextDecoder().decode(base64UrlDecode(segment)));
23
50
  }
24
51
  function fail(message, cause) {
25
- throw new ReoptSDKError(message, 400, "invalid_logout_token", void 0, {
26
- cause,
27
- fix: "reopt\uAC00 \uBCF4\uB0B8 logout_token\uB9CC \uC774 \uD578\uB4E4\uB7EC\uB85C \uC804\uB2EC\uB418\uB294\uC9C0, client_id\xB7idBaseUrl \uC124\uC815\uC774 \uB9DE\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694.",
28
- doc: "logout.md"
29
- });
52
+ throw new ReoptSDKError(message, 400, "invalid_logout_token", void 0, {
53
+ cause,
54
+ fix: "reopt가 보낸 logout_token만 이 핸들러로 전달되는지, client_id·idBaseUrl 설정이 맞는지 확인하세요.",
55
+ doc: "logout.md"
56
+ });
30
57
  }
58
+ /**
59
+ * 검증 *인프라*(discovery/JWKS)가 일시적으로 불가한 경우 — 토큰이 잘못된 게 아니다.
60
+ * 500대(retryable)로 던져, 핸들러가 IdP에 재시도 가능 응답(503)을 주게 한다. 이는
61
+ * 스펙 §2.8의 "처리 실패"에 해당하며, 정상 토큰을 400(영구 거부)으로 오분류하지 않는다.
62
+ */
31
63
  function failUnavailable(message, cause) {
32
- throw new ReoptSDKError(
33
- message,
34
- 503,
35
- "logout_verification_unavailable",
36
- void 0,
37
- {
38
- cause,
39
- fix: "reopt IdP\uC758 discovery/JWKS \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 \uC77C\uC2DC\uC801\uC73C\uB85C \uC751\uB2F5\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC7A0\uC2DC \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694.",
40
- doc: "logout.md"
41
- }
42
- );
64
+ throw new ReoptSDKError(message, 503, "logout_verification_unavailable", void 0, {
65
+ cause,
66
+ fix: "reopt IdP의 discovery/JWKS 엔드포인트가 일시적으로 응답하지 않습니다. 잠시 후 재시도하세요.",
67
+ doc: "logout.md"
68
+ });
43
69
  }
44
70
  async function fetchDiscovery(idBaseUrl) {
45
- const cached = discoveryCache.get(idBaseUrl);
46
- if (cached && Date.now() - cached.fetchedAt < JWKS_CACHE_TTL_MS) {
47
- return { issuer: cached.issuer, jwksUri: cached.jwksUri };
48
- }
49
- const discoveryUrl = `${idBaseUrl}/api/auth/.well-known/openid-configuration`;
50
- let res;
51
- try {
52
- res = await fetch(discoveryUrl, {
53
- cache: "no-store",
54
- signal: AbortSignal.timeout(VERIFICATION_FETCH_TIMEOUT_MS)
55
- });
56
- } catch (error) {
57
- failUnavailable(
58
- "OIDC discovery\uB97C \uBD88\uB7EC\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
59
- `discovery fetch \uC2E4\uD328: ${String(error)}`
60
- );
61
- }
62
- if (!res.ok) {
63
- failUnavailable(
64
- "OIDC discovery \uC751\uB2F5\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
65
- `discovery HTTP ${res.status}`
66
- );
67
- }
68
- const doc = await res.json();
69
- if (!doc.issuer || !doc.jwks_uri) {
70
- failUnavailable(
71
- "OIDC discovery\uC5D0 issuer/jwks_uri\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
72
- "discovery \uD544\uB4DC \uB204\uB77D"
73
- );
74
- }
75
- discoveryCache.set(idBaseUrl, {
76
- issuer: doc.issuer,
77
- jwksUri: doc.jwks_uri,
78
- fetchedAt: Date.now()
79
- });
80
- return { issuer: doc.issuer, jwksUri: doc.jwks_uri };
71
+ const cached = discoveryCache.get(idBaseUrl);
72
+ if (cached && Date.now() - cached.fetchedAt < JWKS_CACHE_TTL_MS) return {
73
+ issuer: cached.issuer,
74
+ jwksUri: cached.jwksUri
75
+ };
76
+ const discoveryUrl = `${idBaseUrl}/api/auth/.well-known/openid-configuration`;
77
+ let res;
78
+ try {
79
+ res = await fetch(discoveryUrl, {
80
+ cache: "no-store",
81
+ signal: AbortSignal.timeout(VERIFICATION_FETCH_TIMEOUT_MS)
82
+ });
83
+ } catch (error) {
84
+ failUnavailable("OIDC discovery를 불러오지 못했습니다.", `discovery fetch 실패: ${String(error)}`);
85
+ }
86
+ if (!res.ok) failUnavailable("OIDC discovery 응답이 올바르지 않습니다.", `discovery HTTP ${res.status}`);
87
+ const doc = await res.json();
88
+ if (!doc.issuer || !doc.jwks_uri) failUnavailable("OIDC discovery에 issuer/jwks_uri가 없습니다.", "discovery 필드 누락");
89
+ discoveryCache.set(idBaseUrl, {
90
+ issuer: doc.issuer,
91
+ jwksUri: doc.jwks_uri,
92
+ fetchedAt: Date.now()
93
+ });
94
+ return {
95
+ issuer: doc.issuer,
96
+ jwksUri: doc.jwks_uri
97
+ };
81
98
  }
82
99
  async function fetchJwks(jwksUri, forceRefresh) {
83
- const cached = jwksCache.get(jwksUri);
84
- const now = Date.now();
85
- if (!forceRefresh && cached && now - cached.fetchedAt < JWKS_CACHE_TTL_MS) {
86
- return cached.keys;
87
- }
88
- const inflight = jwksInflight.get(jwksUri);
89
- if (inflight) return inflight;
90
- if (forceRefresh && cached) {
91
- const lastForced = jwksLastForcedRefetch.get(jwksUri) ?? 0;
92
- if (now - lastForced < JWKS_MIN_FORCED_REFETCH_INTERVAL_MS) {
93
- return cached.keys;
94
- }
95
- }
96
- if (forceRefresh) jwksLastForcedRefetch.set(jwksUri, now);
97
- const promise = fetchJwksUncached(jwksUri).finally(() => {
98
- jwksInflight.delete(jwksUri);
99
- });
100
- jwksInflight.set(jwksUri, promise);
101
- return promise;
100
+ const cached = jwksCache.get(jwksUri);
101
+ const now = Date.now();
102
+ if (!forceRefresh && cached && now - cached.fetchedAt < JWKS_CACHE_TTL_MS) return cached.keys;
103
+ const inflight = jwksInflight.get(jwksUri);
104
+ if (inflight) return inflight;
105
+ if (forceRefresh && cached) {
106
+ if (now - (jwksLastForcedRefetch.get(jwksUri) ?? 0) < JWKS_MIN_FORCED_REFETCH_INTERVAL_MS) return cached.keys;
107
+ }
108
+ if (forceRefresh) jwksLastForcedRefetch.set(jwksUri, now);
109
+ const promise = fetchJwksUncached(jwksUri).finally(() => {
110
+ jwksInflight.delete(jwksUri);
111
+ });
112
+ jwksInflight.set(jwksUri, promise);
113
+ return promise;
102
114
  }
103
115
  async function fetchJwksUncached(jwksUri) {
104
- let res;
105
- try {
106
- res = await fetch(jwksUri, {
107
- cache: "no-store",
108
- signal: AbortSignal.timeout(VERIFICATION_FETCH_TIMEOUT_MS)
109
- });
110
- } catch (error) {
111
- failUnavailable(
112
- "JWKS\uB97C \uBD88\uB7EC\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
113
- `jwks fetch \uC2E4\uD328: ${String(error)}`
114
- );
115
- }
116
- if (!res.ok) {
117
- failUnavailable(
118
- "JWKS \uC751\uB2F5\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
119
- `jwks HTTP ${res.status}`
120
- );
121
- }
122
- const doc = await res.json();
123
- const keys = (doc.keys ?? []).filter(
124
- (k) => k.kty === "OKP" && k.crv === "Ed25519" && typeof k.x === "string"
125
- );
126
- jwksCache.set(jwksUri, { keys, fetchedAt: Date.now(), jwksUri });
127
- return keys;
116
+ let res;
117
+ try {
118
+ res = await fetch(jwksUri, {
119
+ cache: "no-store",
120
+ signal: AbortSignal.timeout(VERIFICATION_FETCH_TIMEOUT_MS)
121
+ });
122
+ } catch (error) {
123
+ failUnavailable("JWKS를 불러오지 못했습니다.", `jwks fetch 실패: ${String(error)}`);
124
+ }
125
+ if (!res.ok) failUnavailable("JWKS 응답이 올바르지 않습니다.", `jwks HTTP ${res.status}`);
126
+ const keys = ((await res.json()).keys ?? []).filter((k) => k.kty === "OKP" && k.crv === "Ed25519" && typeof k.x === "string");
127
+ jwksCache.set(jwksUri, {
128
+ keys,
129
+ fetchedAt: Date.now(),
130
+ jwksUri
131
+ });
132
+ return keys;
128
133
  }
129
134
  async function verifyEd25519(jwk, signingInput, signature) {
130
- try {
131
- const key = await crypto.subtle.importKey(
132
- "jwk",
133
- { kty: jwk.kty, crv: jwk.crv, x: jwk.x },
134
- { name: "Ed25519" },
135
- false,
136
- ["verify"]
137
- );
138
- return await crypto.subtle.verify(
139
- { name: "Ed25519" },
140
- key,
141
- // TS 5.7의 Uint8Array<ArrayBufferLike>는 BufferSource와 직접 호환되지
142
- // 않아 캐스팅한다(런타임 값은 표준 Uint8Array).
143
- signature,
144
- new TextEncoder().encode(signingInput)
145
- );
146
- } catch {
147
- return false;
148
- }
135
+ try {
136
+ const key = await crypto.subtle.importKey("jwk", {
137
+ kty: jwk.kty,
138
+ crv: jwk.crv,
139
+ x: jwk.x
140
+ }, { name: "Ed25519" }, false, ["verify"]);
141
+ return await crypto.subtle.verify({ name: "Ed25519" }, key, signature, new TextEncoder().encode(signingInput));
142
+ } catch {
143
+ return false;
144
+ }
149
145
  }
146
+ /**
147
+ * logout_token을 검증하고 폐기 대상 클레임(sid·sub)을 반환한다.
148
+ * 검증 실패는 ReoptSDKError(400, invalid_logout_token)로 던진다.
149
+ */
150
150
  async function verifyBackchannelLogoutToken(logoutToken, options = {}) {
151
- const config = options.config ?? {};
152
- const clientId = options.clientId ?? config.clientId ?? (typeof process !== "undefined" ? process.env?.BRANDAPP_CLIENT_ID : void 0);
153
- if (!clientId) {
154
- fail(
155
- "client_id\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
156
- "clientId \uBBF8\uC124\uC815 \u2014 options.clientId \uB610\uB294 BRANDAPP_CLIENT_ID env \uD544\uC694"
157
- );
158
- }
159
- const idBaseUrl = (options.idBaseUrl ?? resolveIdBaseUrl(config)).replace(
160
- /\/$/,
161
- ""
162
- );
163
- const parts = logoutToken.split(".");
164
- if (parts.length !== 3) {
165
- fail("logout_token \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", "JWT \uC138\uADF8\uBA3C\uD2B8 \uAC1C\uC218 \uC624\uB958");
166
- }
167
- const [headerB64, payloadB64, sigB64] = parts;
168
- let header;
169
- let payload;
170
- try {
171
- header = decodeJson(headerB64);
172
- payload = decodeJson(payloadB64);
173
- } catch {
174
- fail("logout_token \uB514\uCF54\uB4DC\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", "base64url/JSON \uD30C\uC2F1 \uC624\uB958");
175
- }
176
- if (header.alg !== "EdDSA") {
177
- fail(
178
- "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uC11C\uBA85 \uC54C\uACE0\uB9AC\uC998\uC785\uB2C8\uB2E4.",
179
- `alg=${header.alg ?? "none"} (EdDSA\uB9CC \uD5C8\uC6A9)`
180
- );
181
- }
182
- const { issuer, jwksUri } = await fetchDiscovery(idBaseUrl);
183
- const signature = base64UrlDecode(sigB64);
184
- const signingInput = `${headerB64}.${payloadB64}`;
185
- const tryVerify = async (forceRefresh) => {
186
- const keys = await fetchJwks(jwksUri, forceRefresh);
187
- const candidates = header.kid ? keys.filter((k) => k.kid === header.kid) : keys;
188
- const pool = candidates.length > 0 ? candidates : keys;
189
- for (const jwk of pool) {
190
- if (await verifyEd25519(jwk, signingInput, signature)) return true;
191
- }
192
- return false;
193
- };
194
- let verified = await tryVerify(false);
195
- if (!verified) verified = await tryVerify(true);
196
- if (!verified) {
197
- fail("logout_token \uC11C\uBA85 \uAC80\uC99D\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", "\uC11C\uBA85 \uBD88\uC77C\uCE58 \uB610\uB294 \uD0A4 \uC5C6\uC74C");
198
- }
199
- if (payload.iss !== issuer) {
200
- fail("issuer\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", `iss=${payload.iss} != ${issuer}`);
201
- }
202
- const aud = Array.isArray(payload.aud) ? payload.aud : payload.aud ? [payload.aud] : [];
203
- if (!aud.includes(clientId)) {
204
- fail("audience\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", "aud\uC5D0 client_id \uC5C6\uC74C");
205
- }
206
- if (typeof payload.iat !== "number") {
207
- fail("iat\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.", "iat \uD074\uB808\uC784 \uB204\uB77D");
208
- }
209
- const maxAge = options.maxTokenAgeMs ?? DEFAULT_MAX_TOKEN_AGE_MS;
210
- if (Date.now() - payload.iat * 1e3 > maxAge) {
211
- fail("logout_token\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "iat\uAC00 \uD5C8\uC6A9 \uB098\uC774\uB97C \uCD08\uACFC");
212
- }
213
- if (payload.exp && Date.now() > payload.exp * 1e3) {
214
- fail("logout_token\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4(exp).", "exp \uACBD\uACFC");
215
- }
216
- if (payload.nonce !== void 0) {
217
- fail("logout_token\uC5D0 nonce\uAC00 \uC788\uC73C\uBA74 \uC548 \uB429\uB2C8\uB2E4.", "nonce \uD074\uB808\uC784 \uC874\uC7AC");
218
- }
219
- const hasEvent = !!payload.events && Object.prototype.hasOwnProperty.call(
220
- payload.events,
221
- BACKCHANNEL_LOGOUT_EVENT
222
- );
223
- if (!hasEvent) {
224
- fail(
225
- "back-channel logout \uC774\uBCA4\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
226
- "events\uC5D0 backchannel-logout \uBA64\uBC84 \uC5C6\uC74C"
227
- );
228
- }
229
- if (!payload.sid && !payload.sub) {
230
- fail("sid \uB610\uB294 sub\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.", "sid/sub \uBAA8\uB450 \uC5C6\uC74C");
231
- }
232
- if (!payload.sid) {
233
- fail("sid\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.", "reopt logout_token\uC740 sid \uD544\uC218");
234
- }
235
- return {
236
- sid: payload.sid,
237
- sub: payload.sub,
238
- iss: issuer,
239
- aud
240
- };
151
+ const config = options.config ?? {};
152
+ const clientId = options.clientId ?? config.clientId ?? (typeof process !== "undefined" ? process.env?.BRANDAPP_CLIENT_ID : void 0);
153
+ if (!clientId) fail("client_id가 필요합니다.", "clientId 미설정 — options.clientId 또는 BRANDAPP_CLIENT_ID env 필요");
154
+ const idBaseUrl = (options.idBaseUrl ?? resolveIdBaseUrl(config)).replace(/\/$/, "");
155
+ const parts = logoutToken.split(".");
156
+ if (parts.length !== 3) fail("logout_token 형식이 올바르지 않습니다.", "JWT 세그먼트 개수 오류");
157
+ const [headerB64, payloadB64, sigB64] = parts;
158
+ let header;
159
+ let payload;
160
+ try {
161
+ header = decodeJson(headerB64);
162
+ payload = decodeJson(payloadB64);
163
+ } catch {
164
+ fail("logout_token 디코드에 실패했습니다.", "base64url/JSON 파싱 오류");
165
+ }
166
+ if (header.alg !== "EdDSA") fail("지원하지 않는 서명 알고리즘입니다.", `alg=${header.alg ?? "none"} (EdDSA만 허용)`);
167
+ const { issuer, jwksUri } = await fetchDiscovery(idBaseUrl);
168
+ const signature = base64UrlDecode(sigB64);
169
+ const signingInput = `${headerB64}.${payloadB64}`;
170
+ const tryVerify = async (forceRefresh) => {
171
+ const keys = await fetchJwks(jwksUri, forceRefresh);
172
+ const candidates = header.kid ? keys.filter((k) => k.kid === header.kid) : keys;
173
+ const pool = candidates.length > 0 ? candidates : keys;
174
+ for (const jwk of pool) if (await verifyEd25519(jwk, signingInput, signature)) return true;
175
+ return false;
176
+ };
177
+ let verified = await tryVerify(false);
178
+ if (!verified) verified = await tryVerify(true);
179
+ if (!verified) fail("logout_token 서명 검증에 실패했습니다.", "서명 불일치 또는 키 없음");
180
+ if (payload.iss !== issuer) fail("issuer가 일치하지 않습니다.", `iss=${payload.iss} != ${issuer}`);
181
+ const aud = Array.isArray(payload.aud) ? payload.aud : payload.aud ? [payload.aud] : [];
182
+ if (!aud.includes(clientId)) fail("audience가 일치하지 않습니다.", "aud에 client_id 없음");
183
+ if (typeof payload.iat !== "number") fail("iat가 없습니다.", "iat 클레임 누락");
184
+ const maxAge = options.maxTokenAgeMs ?? DEFAULT_MAX_TOKEN_AGE_MS;
185
+ if (Date.now() - payload.iat * 1e3 > maxAge) fail("logout_token이 만료되었습니다.", "iat가 허용 나이를 초과");
186
+ if (payload.exp && Date.now() > payload.exp * 1e3) fail("logout_token이 만료되었습니다(exp).", "exp 경과");
187
+ if (payload.nonce !== void 0) fail("logout_token에 nonce가 있으면 안 됩니다.", "nonce 클레임 존재");
188
+ if (!(!!payload.events && Object.prototype.hasOwnProperty.call(payload.events, BACKCHANNEL_LOGOUT_EVENT))) fail("back-channel logout 이벤트가 없습니다.", "events에 backchannel-logout 멤버 없음");
189
+ if (!payload.sid && !payload.sub) fail("sid 또는 sub가 필요합니다.", "sid/sub 모두 없음");
190
+ if (!payload.sid) fail("sid가 없습니다.", "reopt logout_token은 sid 필수");
191
+ return {
192
+ sid: payload.sid,
193
+ sub: payload.sub,
194
+ iss: issuer,
195
+ aud
196
+ };
241
197
  }
198
+ /** 테스트·장수명 프로세스용 — JWKS/discovery 캐시와 refetch 스로틀 상태를 비운다. */
242
199
  function clearLogoutTokenCaches() {
243
- jwksCache.clear();
244
- jwksInflight.clear();
245
- jwksLastForcedRefetch.clear();
246
- discoveryCache.clear();
200
+ jwksCache.clear();
201
+ jwksInflight.clear();
202
+ jwksLastForcedRefetch.clear();
203
+ discoveryCache.clear();
247
204
  }
248
205
 
249
- // src/logout/handler.ts
206
+ //#endregion
207
+ //#region src/logout/handler.ts
208
+ /** OIDC Back-Channel Logout 응답은 캐시 금지가 스펙 요구. */
250
209
  function response(body, status) {
251
- return new Response(JSON.stringify(body), {
252
- status,
253
- headers: {
254
- "Content-Type": "application/json",
255
- "Cache-Control": "no-store"
256
- }
257
- });
210
+ return new Response(JSON.stringify(body), {
211
+ status,
212
+ headers: {
213
+ "Content-Type": "application/json",
214
+ "Cache-Control": "no-store"
215
+ }
216
+ });
258
217
  }
259
218
  function createBackchannelLogoutHandler(config) {
260
- return async (request) => {
261
- if (request.method !== "POST") {
262
- return response({ error: "Method not allowed" }, 405);
263
- }
264
- let logoutToken = null;
265
- try {
266
- const form = await request.formData();
267
- const value = form.get("logout_token");
268
- logoutToken = typeof value === "string" ? value : null;
269
- } catch {
270
- return response({ error: "invalid_request" }, 400);
271
- }
272
- if (!logoutToken) {
273
- return response({ error: "invalid_request" }, 400);
274
- }
275
- let claims;
276
- try {
277
- claims = await verifyBackchannelLogoutToken(logoutToken, {
278
- clientId: config.clientId,
279
- idBaseUrl: config.idBaseUrl,
280
- config: config.config,
281
- maxTokenAgeMs: config.maxTokenAgeMs
282
- });
283
- } catch (error) {
284
- if (error instanceof ReoptSDKError && error.status >= 500) {
285
- return response({ error: error.code }, 503);
286
- }
287
- const code = error instanceof ReoptSDKError ? error.code : "invalid_logout_token";
288
- return response({ error: code }, 400);
289
- }
290
- try {
291
- await config.onLogout(claims);
292
- } catch {
293
- return response({ error: "logout_processing_failed" }, 501);
294
- }
295
- return response({ ok: true }, 200);
296
- };
219
+ return async (request) => {
220
+ if (request.method !== "POST") return response({ error: "Method not allowed" }, 405);
221
+ let logoutToken = null;
222
+ try {
223
+ const value = (await request.formData()).get("logout_token");
224
+ logoutToken = typeof value === "string" ? value : null;
225
+ } catch {
226
+ return response({ error: "invalid_request" }, 400);
227
+ }
228
+ if (!logoutToken) return response({ error: "invalid_request" }, 400);
229
+ let claims;
230
+ try {
231
+ claims = await verifyBackchannelLogoutToken(logoutToken, {
232
+ clientId: config.clientId,
233
+ idBaseUrl: config.idBaseUrl,
234
+ config: config.config,
235
+ maxTokenAgeMs: config.maxTokenAgeMs
236
+ });
237
+ } catch (error) {
238
+ if (error instanceof ReoptSDKError && error.status >= 500) return response({ error: error.code }, 503);
239
+ return response({ error: error instanceof ReoptSDKError ? error.code : "invalid_logout_token" }, 400);
240
+ }
241
+ try {
242
+ await config.onLogout(claims);
243
+ } catch {
244
+ return response({ error: "logout_processing_failed" }, 501);
245
+ }
246
+ return response({ ok: true }, 200);
247
+ };
297
248
  }
298
249
 
299
- // src/logout/end-session.ts
250
+ //#endregion
251
+ //#region src/logout/end-session.ts
300
252
  function buildEndSessionUrl(options) {
301
- const idBaseUrl = (options.idBaseUrl ?? resolveIdBaseUrl(options.config ?? {})).replace(/\/$/, "");
302
- const url = new URL(`${idBaseUrl}/api/auth/oauth2/end-session`);
303
- url.searchParams.set("id_token_hint", options.idToken);
304
- if (options.clientId) {
305
- url.searchParams.set("client_id", options.clientId);
306
- }
307
- if (options.postLogoutRedirectUri) {
308
- url.searchParams.set(
309
- "post_logout_redirect_uri",
310
- options.postLogoutRedirectUri
311
- );
312
- }
313
- if (options.state) {
314
- url.searchParams.set("state", options.state);
315
- }
316
- return url.toString();
253
+ const idBaseUrl = (options.idBaseUrl ?? resolveIdBaseUrl(options.config ?? {})).replace(/\/$/, "");
254
+ const url = new URL(`${idBaseUrl}/api/auth/oauth2/end-session`);
255
+ url.searchParams.set("id_token_hint", options.idToken);
256
+ if (options.clientId) url.searchParams.set("client_id", options.clientId);
257
+ if (options.postLogoutRedirectUri) url.searchParams.set("post_logout_redirect_uri", options.postLogoutRedirectUri);
258
+ if (options.state) url.searchParams.set("state", options.state);
259
+ return url.toString();
317
260
  }
318
261
 
262
+ //#endregion
319
263
  export { buildEndSessionUrl, clearLogoutTokenCaches, createBackchannelLogoutHandler, verifyBackchannelLogoutToken };
320
- //# sourceMappingURL=index.js.map
321
264
  //# sourceMappingURL=index.js.map