@reopt-ai/brandapp-sdk 4.7.0-rc.2 → 4.7.0-rc.20
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/CHANGELOG.md +440 -0
- package/README.md +258 -53
- package/dist/ai/index.d.ts +52 -2
- package/dist/ai/index.js +32 -2
- package/dist/ai-provider/index.d.ts +61 -6
- package/dist/ai-provider/index.js +456 -119
- package/dist/analytics/index.d.ts +1 -1
- package/dist/analytics/index.js +1 -1
- package/dist/auth/index.d.ts +1 -1
- package/dist/auth/index.js +1 -1
- package/dist/better-auth/client.d.ts +7 -2
- package/dist/better-auth/client.js +5 -4
- package/dist/better-auth/index.d.ts +143 -7
- package/dist/better-auth/index.js +272 -11
- package/dist/{client-CsWSxMhB.d.ts → client-1bKsyJyo.d.ts} +2 -2
- package/dist/{client-Cod87ThY.d.ts → client-B8pBCudo.d.ts} +2 -2
- package/dist/{client-CSl3o0s3.d.ts → client-BT1MQfQF.d.ts} +2 -2
- package/dist/{client-BeiMpmXQ.js → client-BtL2fs57.js} +2 -2
- package/dist/{client--ELBxfna.js → client-CS_M5e7e.js} +3 -3
- package/dist/{client-C6lx3RUQ.d.ts → client-CTagug07.d.ts} +2 -2
- package/dist/{client-xblzWFAL.d.ts → client-CUC1Ignp.d.ts} +2 -2
- package/dist/{client-BVBl3gPQ.js → client-D07nDbmU.js} +213 -37
- package/dist/{client-MDNS9Ubf.d.ts → client-D9z_dcrN.d.ts} +2 -2
- package/dist/{client-D6333rpA.js → client-DTwWumrT.js} +40 -6
- package/dist/{client-DNZsyjA0.js → client-DZsjTjME.js} +11 -5
- package/dist/{client-Cnq_X3Wp.d.ts → client-DqZXU9pY.d.ts} +139 -13
- package/dist/{client-DE1ynLgS.js → client-Dt31kxzA.js} +46 -2
- package/dist/{client-DfnaH99z.d.ts → client-DuzINPQo.d.ts} +2 -2
- package/dist/{client-DFxq2GcS.js → client-Dvx9kruP.js} +2 -2
- package/dist/client-KkCYwia-.d.ts +152 -0
- package/dist/{client-iyzEsEEg.js → client-LVjMTBHf.js} +2 -2
- package/dist/{client-CGulAXhy.js → client-RP8n-H2b.js} +2 -2
- package/dist/{client-C7X3w8t6.js → client-_xAfhDr9.js} +2 -2
- package/dist/{client-BQJepjoD.d.ts → client-qL_92Irv.d.ts} +47 -6
- package/dist/cms/index.d.ts +1 -1
- package/dist/cms/index.js +1 -1
- package/dist/{config-B6U6kZxR.js → config-Bc5hVJH5.js} +127 -78
- package/dist/{config-CnFnzh7Q.d.ts → config-BugNVP5q.d.ts} +29 -7
- package/dist/dev/index.js +120 -13
- package/dist/eav/index.d.ts +24 -21
- package/dist/eav/index.js +6 -3
- package/dist/eav/migrate.d.ts +17 -2
- package/dist/eav/migrate.js +15 -0
- package/dist/eav/schema.d.ts +12 -2
- package/dist/eav/schema.js +11 -1
- package/dist/{errors-U3TsyWVq.d.ts → errors-suUYUdWb.d.ts} +21 -4
- package/dist/feedback/index.d.ts +1 -1
- package/dist/feedback/index.js +1 -1
- package/dist/files/index.d.ts +12 -1
- package/dist/files/index.js +14 -1
- package/dist/{http-client-pEcJtik8.js → http-client-DsdczDjM.js} +31 -7
- package/dist/{index-Bkci7euU.d.ts → index-nJgNCO5P.d.ts} +42 -15
- package/dist/index.d.ts +6 -6
- package/dist/index.js +13 -13
- package/dist/installation/index.d.ts +1 -0
- package/dist/installation/index.js +3 -0
- package/dist/logout/index.d.ts +1 -1
- package/dist/logout/index.js +1 -1
- package/dist/machine/index.d.ts +1 -72
- package/dist/machine/index.js +2 -3
- package/dist/machine/keygen-cli.d.ts +1 -7
- package/dist/machine/keygen-cli.js +2 -55
- package/dist/plans/index.d.ts +1 -1
- package/dist/plans/index.js +1 -1
- package/dist/push/index.d.ts +1 -1
- package/dist/push/index.js +1 -1
- package/dist/{query-MrzuQOFF.js → query-FKNS-Wso.js} +2 -2
- package/dist/react/hooks.d.ts +5 -5
- package/dist/resource/index.d.ts +1 -0
- package/dist/resource/index.js +3 -0
- package/dist/social/index.d.ts +1 -0
- package/dist/social/index.js +3 -0
- package/dist/{sse-parser-FMjxM7sY.js → sse-parser-D65dmL4A.js} +15 -18
- package/dist/superadmin/index.d.ts +1 -0
- package/dist/superadmin/index.js +3 -0
- package/dist/terms/index.d.ts +1 -1
- package/dist/terms/index.js +1 -1
- package/dist/testing/index.d.ts +1 -1
- package/dist/{types-MXLudLBP.d.ts → types-BFg1ywqD.d.ts} +3 -3
- package/dist/types-Dq032jKk.js +12 -0
- package/dist/workspace/index.d.ts +1 -654
- package/dist/workspace/index.js +2 -735
- package/docs/api-reference.md +199 -17
- package/docs/dev-server.md +6 -1
- package/docs/environment.md +40 -15
- package/docs/errors.md +66 -0
- package/docs/files.md +6 -1
- package/docs/superadmin.md +20 -0
- package/docs/testing.md +4 -4
- package/package.json +21 -4
- package/dist/client-C2W4RAZV.d.ts +0 -103
- package/dist/client-RPOH-LNC.js +0 -194
- package/dist/keys-B2pA8EkU.d.ts +0 -44
- package/dist/keys-B_R_lsyF.js +0 -102
- package/dist/types-DjDRszNj.js +0 -11
- package/docs/machine.md +0 -104
- package/docs/workspace.md +0 -153
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,446 @@ This project adheres to [Semantic Versioning](https://semver.org/).
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [4.7.0-rc.20] — 2026-11-22
|
|
11
|
+
|
|
12
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — `@reopt-ai/workspace-sdk@0.1.0-rc.11`을 싣는다(`/workspace` 재수출에
|
|
13
|
+
위임 클라이언트의 `customers`가 더해진다). 브랜드앱 표면은 바뀌지 않았다.
|
|
14
|
+
|
|
15
|
+
## [4.7.0-rc.19] — 2026-11-22
|
|
16
|
+
|
|
17
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — `@reopt-ai/workspace-sdk@0.1.0-rc.10`을 싣는다.
|
|
18
|
+
|
|
19
|
+
### Changed (breaking — `/workspace` 재수출만)
|
|
20
|
+
|
|
21
|
+
- `@reopt-ai/brandapp-sdk/workspace`는 `@reopt-ai/workspace-sdk`의 재수출이라 그 패키지의 rc.10 변경이 그대로 온다: 위임
|
|
22
|
+
클라이언트(`createConnectClient`)의 목록이 전부 `{ items, nextOffset }`, 쓰기가 객체 전체, 기계 `platform.posts.list`가
|
|
23
|
+
`{ posts }` → `{ items }`. 옮기는 표는 workspace-sdk의 `docs/workspace.md` "Migrating from 0.1.0-rc.9". 브랜드앱 표면
|
|
24
|
+
(`createBrandappSdk`·`cms`·`eav`·결제·인증)은 바뀌지 않았다.
|
|
25
|
+
- 새 서브패스(`/connect`·`/permissions`·`/webhooks`)는 여기서 재수출하지 않는다 — 워크스페이스 앱은 `@reopt-ai/workspace-sdk`를 직접 쓴다
|
|
26
|
+
(`/workspace` 재수출은 5.0에서 제거).
|
|
27
|
+
|
|
28
|
+
### Fixed
|
|
29
|
+
|
|
30
|
+
- **400 `VALIDATION_ERROR`의 필드별 이유가 버려지던 것.** 서버는 요청 검증 실패를 400 + `fields`로 보내는데 SDK는 422에서만
|
|
31
|
+
읽었다. `BadRequestError`가 `fieldErrors`·`getFieldError()`·`toFieldMap()`을 갖고(클래스·상태·코드는 그대로),
|
|
32
|
+
`fieldErrorsOf(error)`가 400·422를 가리지 않고 읽는다.
|
|
33
|
+
|
|
34
|
+
### Security
|
|
35
|
+
|
|
36
|
+
- `/resource` 재수출 — 키에 묶인 위임 토큰의 DPoP 증명 검증, 재생 저장소 기본값(workspace-sdk rc.10 "Security").
|
|
37
|
+
|
|
38
|
+
## [4.7.0-rc.18] — 2026-11-21
|
|
39
|
+
|
|
40
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — `@reopt-ai/workspace-sdk@0.1.0-rc.9`를 싣는다. 소비자 SDK 리뷰 결과:
|
|
41
|
+
브라우저 앱 자격 거절(Security), `/superadmin`·EAV 스키마 변경 표면 deprecated(관리자 표면은 workspace-sdk·CLI로).
|
|
42
|
+
|
|
43
|
+
### Deprecated
|
|
44
|
+
|
|
45
|
+
- EAV **스키마 변경** 표면 — `eav.entities.create/update/delete`·`eav.attributes.*`, `/eav/schema`의 `syncSchema`·`applySync`,
|
|
46
|
+
`/eav/migrate`의 실행기 `runMigration*`·`createMigrationContext`. (`defineMigration`·`isMigration`·마이그레이션 타입은
|
|
47
|
+
사용자 마이그레이션 파일이 import하는 **정의** 도우미라 남는다.) CLI는 이 실행기를 자기 사본(`@reopt-ai/cli` 내부)으로 돌려
|
|
48
|
+
더 이상 이 경로를 쓰지 않는다. 스키마 변경은 관리자 표면이라 소비자 SDK에서는
|
|
49
|
+
5.0에서 뺀다. 서버 관리 도구는 `@reopt-ai/workspace-sdk`의 `createPlatformClient().eav.applySchema`(기계 자격, scope
|
|
50
|
+
`workspace:admin`)를, 손으로는 CLI `reopt brandapp eav sync`를 쓴다. 스키마 **정의**(`defineSchema`·`defineEntity`·타입이 있는
|
|
51
|
+
`entity()`)와 레코드 API, `computeDiff`·`assessCompatibility` 같은 순수 도우미는 그대로 남는다.
|
|
52
|
+
- `/superadmin` — 운영자 가드는 관리자 표면이라 `@reopt-ai/workspace-sdk/operator`로 옮겼다. 이 서브패스는 그 재수출이고
|
|
53
|
+
5.0에서 지운다(import 경로만 바꾸면 된다). `REOPT_PROVIDER_ID`·`REOPT_PROVIDER_IDS`·`REOPT_STEP_UP_PROVIDER_ID`·
|
|
54
|
+
`STEP_UP_MAX_AUTH_AGE_SECONDS`도 정본이 그 모듈이고 `/better-auth`가 재수출한다 — 로그인과 가드가 다른 값을 들 수 없다.
|
|
55
|
+
|
|
56
|
+
### Security
|
|
57
|
+
|
|
58
|
+
- **Breaking (browser)** — 브라우저·워커에서 **앱 자격**을 모두 거절한다. 종전엔 `clientSecret`만 막고 브라우저용으로
|
|
59
|
+
`/token/mint` 서비스 토큰을 권했는데, 그 토큰은 고객 구분이 없는 앱 전체 자격이라 받은 방문자 누구나 모든 고객의
|
|
60
|
+
EAV 레코드·파일을 읽고 바꾸고(기본 scope `eav:migrate`로는 스키마까지) 바꿀 수 있었다. 이제 서비스 토큰(`iss`
|
|
61
|
+
`reopt-cli-mint`)·기계 자격(`authorization`)은 `CONFIG_BROWSER_APP_CREDENTIAL`, `clientSecret`은 종전대로
|
|
62
|
+
`CONFIG_BROWSER_SECRET`. 브라우저 자격은 로그인한 **고객의 액세스 토큰**(`{ token }`) 하나다 — 고객 표면(CMS·AI·플랜·
|
|
63
|
+
약관·분석·`/me`)에만 닿는다. 모듈 클라이언트(`createReoptEavClient` 등)를 직접 만들어도 같은 가드를 지난다(종전엔
|
|
64
|
+
`createReoptSDK`·`createBrandappProvider`만).
|
|
65
|
+
|
|
66
|
+
## [4.7.0-rc.17] — 2026-11-20
|
|
67
|
+
|
|
68
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — `@reopt-ai/workspace-sdk@0.1.0-rc.1`을 싣는다. 옛 서브패스
|
|
69
|
+
(`/workspace`·`/installation` 등)로도 새 기능이 보인다: `connection.registerKeys()`(설치 단언으로 공개키 등록 요청)·
|
|
70
|
+
`connect.eav.*`·`PLATFORM_EAV_DATA_TYPES`, EAV 속성 연산의 `dataType`·`label` 검사. 상세는 workspace-sdk CHANGELOG.
|
|
71
|
+
|
|
72
|
+
## [4.7.0-rc.16] — 2026-11-20
|
|
73
|
+
|
|
74
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 플랫폼 계층을 `@reopt-ai/workspace-sdk@0.1.0-rc.0`으로 분리하고,
|
|
75
|
+
워크스페이스 앱(RFC-0043)의 위임 클라이언트·게시본 읽기를 더했다.
|
|
76
|
+
|
|
77
|
+
### Changed
|
|
78
|
+
|
|
79
|
+
- **플랫폼 계층을 `@reopt-ai/workspace-sdk`로 분리**(RFC-0043 — 워크스페이스 계층이 브랜드앱 계층 아래다). `/workspace`·
|
|
80
|
+
`/social`·`/machine`·`/installation`·`/resource`는 그 패키지의 **재수출**이 되고(같은 구현 — `PlatformApiError` 등
|
|
81
|
+
클래스 정체성도 같다), 이 SDK가 그 패키지에 의존한다. 새 코드는 `@reopt-ai/workspace-sdk`를 직접 import한다 —
|
|
82
|
+
이 서브패스들은 5.0에서 지운다. `reopt-keygen` bin은 그대로 쓸 수 있다(그 패키지 구현을 부르는 shim). id 호스트
|
|
83
|
+
해석(`resolveIdBaseUrl`·`deriveIdFromBaseUrl`·`REOPT_ID_BASE_URLS`)도 그 패키지의 `/urls` 한 벌을 재수출한다.
|
|
84
|
+
|
|
85
|
+
### Added
|
|
86
|
+
|
|
87
|
+
- **설치 매니페스트 `kind`**(RFC-0043 워크스페이스 앱) — `kind: "workspace"`는 브랜드·브랜드앱을 만들지 않는 설치다.
|
|
88
|
+
클라이언트는 설치에만 묶이고 용도는 `connect`(멤버 위임 로그인)·`machine`(앱 서버) 둘뿐, `workspace.brandapps`
|
|
89
|
+
선언은 거절된다. 생략은 `"brandapp"`(종전)이고 기본값을 채우지 않으므로 기존 매니페스트의 해시는 그대로다.
|
|
90
|
+
`INSTALLATION_KINDS`·`WORKSPACE_APP_CLIENT_PURPOSES`·`installationKindOf`, `deriveInstallationManifest({ kind })`.
|
|
91
|
+
- **위임 클라이언트 `createConnectClient`**(`/workspace`, RFC-0043) — 워크스페이스 앱의 직원이 리옵트로 로그인해 받은
|
|
92
|
+
**자기** 토큰(설치의 `connect` 클라이언트)으로 `/v1/connect/*`를 부른다: `me`(권한 키 `permissions`)·`members`,
|
|
93
|
+
`works`(파이프라인·업무 목록·생성·수정·이동·삭제), `posts`(그룹·목록·읽기·생성·수정(`baseVersion`)·게시·내리기·삭제),
|
|
94
|
+
`folders`·`files`(업로드 4MB·원본 바이트), `forms`, `inquiries`(목록 — `customer:read`, 단계 이동). 워크스페이스와 행위자는
|
|
95
|
+
요청에 없다(동의 바인딩·토큰의 사용자). 응답 스키마(`connect*Schema`)는 약속한 필드만 검사하고 서버가 더한 필드는 통과시킨다.
|
|
96
|
+
- **게시된 글 읽기**(`/workspace`, RFC-0043 §3.6, scope `posts:read`) — `platform.posts.list({ groupId, limit, offset })`·
|
|
97
|
+
`platform.posts.get(slug)`. 게시된 글만 나온다(초안·보관은 없음). 워크스페이스 앱 공개 사이트의 소식 페이지용 —
|
|
98
|
+
브랜드앱 CMS(`sdk.cms`)는 브랜드앱이 없는 자격에서 쓸 수 없다. `platformPublishedPost{,Summary,Page,ListQuery}Schema`.
|
|
99
|
+
|
|
100
|
+
### Fixed
|
|
101
|
+
|
|
102
|
+
- **`platform.me()`가 워크스페이스 앱 자격에서 파싱 실패하던 것** — 서버는 브랜드앱이 없는 자격에 `brandappId`·
|
|
103
|
+
`defaultBrandId`를 `null`로 답하는데 스키마가 문자열을 요구했다. `PlatformMe`의 두 필드가 `string | null`이다
|
|
104
|
+
(⚠️ 타입이 넓어졌다 — 브랜드앱 자격만 쓰는 코드는 값이 그대로지만 `string`으로 받던 곳은 좁혀야 한다).
|
|
105
|
+
|
|
106
|
+
### Changed
|
|
107
|
+
|
|
108
|
+
- `TypedPatch` 값에 `undefined`도 받는다(`?: T | null | undefined`) — `exactOptionalPropertyTypes`에서 zod
|
|
109
|
+
`.partial()` 출력을 그대로 넘기면 TS2375가 났다. `undefined` 키는 JSON에서 빠지므로 값은 그대로 둔다.
|
|
110
|
+
|
|
111
|
+
## [4.7.0-rc.15] — 2026-11-20
|
|
112
|
+
|
|
113
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — rc.14 타입 클라이언트의 타입 갭 둘(enterprise-bootstrap 보고).
|
|
114
|
+
런타임 동작은 rc.14와 같다.
|
|
115
|
+
|
|
116
|
+
### Changed
|
|
117
|
+
|
|
118
|
+
- **`entity()`의 속성 참조가 스키마 이름으로 좁혀진다** — `filters[].attributeId`·`sortBy`·`select`·`increments`가
|
|
119
|
+
`string`이 아니라 그 엔티티의 속성 이름이라 오타가 컴파일 에러가 된다(rc.14는 런타임 `UNKNOWN_ATTRIBUTE`뿐).
|
|
120
|
+
`where("name")`이 리터럴 이름을 유지하도록 `where`·`FilterExpression`·`AttributeFilter`가 키 타입 인자를 받는다
|
|
121
|
+
(기본값 `string`이라 원시 API·`createFilterBuilder`는 그대로). 스키마 없이 만든 SDK는 종전처럼 아무 문자열이나
|
|
122
|
+
받는다. ⚠️ 타입 클라이언트에 속성 ID를 키로 넘기던 코드는 런타임에선 여전히 통하지만 타입은 이름만 받는다.
|
|
123
|
+
- **`update`·`bulkUpdate`·`backfill`의 값에 `null`을 쓸 수 있다**(`TypedPatch` — 값 지우기, 서버가 받는다).
|
|
124
|
+
`exactOptionalPropertyTypes`에서도 캐스트가 필요 없다.
|
|
125
|
+
- 새 공개 타입: `TypedPatch`, `TypedAttributeFilter`, `TypedListQuery`, `TypedCountQuery`, `TypedDeleteWhereInput`,
|
|
126
|
+
`TypedUpdateInput`, `TypedBackfillOptions`, `AttributeName`(`@reopt-ai/brandapp-sdk/eav`).
|
|
127
|
+
|
|
128
|
+
## [4.7.0-rc.14] — 2026-11-20
|
|
129
|
+
|
|
130
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 타입 EAV 클라이언트(`sdk.eav.entity(name)`)가 실서버에서
|
|
131
|
+
쓰기를 조용히 잃던 결함을 고친다. 🔴 rc.13 이하에서 `entity()`로 값을 썼다면 실서버에는 아무것도 저장되지 않았다
|
|
132
|
+
(아래 Fixed 첫 항목).
|
|
133
|
+
|
|
134
|
+
### Fixed
|
|
135
|
+
|
|
136
|
+
- **`sdk.eav.entity(name)`가 속성 이름을 속성 ID로 바꿔 보낸다.** 서버는 레코드 값·필터·`sortBy`·`select`를 속성
|
|
137
|
+
ID로만 읽고 모르는 키는 말없이 버린다. 그런데 타입 클라이언트는 이름 키(`values: { title }`)를 그대로 보냈다 —
|
|
138
|
+
생성은 필수값 누락 422, 조회 결과는 ID 키라 `record.values.title`이 `undefined`, **수정은 200을 돌려주고 아무것도
|
|
139
|
+
바꾸지 않았다**. 이제 `values`·`increments`·`filters[].attributeId`(`where("name")` 포함)·`sortBy`·`select`를
|
|
140
|
+
이름 → ID로 바꿔 보내고, 응답 레코드의 `values`를 ID → 이름으로 돌려준다(`backfill`의 `transform`도 이름 키로
|
|
141
|
+
받고 이름 키로 돌려준다). 속성 ID를 키로 넘겨도 그대로 통한다(우회해 둔 코드가 깨지지 않는다).
|
|
142
|
+
모르는 키는 서버에 보내기 전에 `UNKNOWN_ATTRIBUTE`(`BadRequestError`)로 거절한다 — 스키마가 바뀐 직후일 수 있어
|
|
143
|
+
엔티티를 한 번 다시 읽은 뒤에 판정한다. 엔티티 속성 목록은 엔티티 이름 캐시와 함께 5분 캐시된다.
|
|
144
|
+
⚠️ 응답의 `values`가 이름 키가 됐다 — rc.13에서 `entity()` 결과를 `values[attributeId]`로 읽어 우회했다면
|
|
145
|
+
`values.<이름>`으로 바꾼다. ID 키 원시 API(`sdk.eav.records.*`)는 바뀌지 않았다.
|
|
146
|
+
- **dev 서버가 속성 ID를 실서버처럼 따로 발급한다.** 지금까지는 속성 이름을 ID로 써서 위 결함이 로컬에서
|
|
147
|
+
드러나지 않았고, 한 전역 맵에 넣어 서로 다른 엔티티의 같은 이름 속성(예: 두 엔티티의 `title`)이 마지막 것으로
|
|
148
|
+
덮였다. 레코드 값도 실서버처럼 그 엔티티의 속성 ID가 아닌 키를 버린다. `dev.seed()`·`seedAll`은 종전대로 이름
|
|
149
|
+
키를 받는다(ID로 바꿔 저장). ⚠️ dev 서버에 원시 HTTP·ID 키 API로 이름 키를 보내던 테스트는 실서버와 같이
|
|
150
|
+
값이 버려진다 — `entity()`를 쓰거나 `GET /entities/:id`의 속성 ID로 바꾼다.
|
|
151
|
+
- **`eav sync`가 선언하지 않은 `icon`을 변경으로 보지 않는다.** 서버는 icon 없이 만든 엔티티에 기본값(📊)을
|
|
152
|
+
넣는데, diff가 "미선언 = null"로 읽어 매 dry-run마다 `icon: null` 갱신을 내놓았다. 이제 `defineEntity`에
|
|
153
|
+
`icon`을 적었을 때만 맞춘다(서버의 icon을 지우려면 다른 값을 선언한다).
|
|
154
|
+
- **`REOPT_IMAGE_REMOTE_PATTERNS`에 실제 파일 호스트를 넣었다** — `sdk.files`가 돌려주는 `url`은
|
|
155
|
+
`https://studio.reopt.ai/api/blob/...`(리옵트 서빙 프록시)인데 목록에는 Vercel Blob 호스트만 있어 `next/image`가
|
|
156
|
+
거절했다. `ImageRemotePattern`에 `pathname`이 생겼다. 로컬(`studio.local.reopt.io`)은 루프백이라 Next.js가
|
|
157
|
+
패턴과 무관하게 거절한다 — `docs/files.md` 참고.
|
|
158
|
+
|
|
159
|
+
## [4.7.0-rc.13] — 2026-11-08
|
|
160
|
+
|
|
161
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 앱 심사용 번호를 리옵트 콘솔로 옮기고, 전화번호 정본을 E.164로
|
|
162
|
+
바꾼다. 🔴 rc.11·12로 받은 사용자가 있으면 배포 전에 번호를 옮긴다(아래 Changed 둘째 항목).
|
|
163
|
+
|
|
164
|
+
### Removed
|
|
165
|
+
|
|
166
|
+
- **`createReoptPhoneNumber`의 `reviewAccounts` 옵션과 `ReoptPhoneReviewAccounts` 타입**(rc.12). 앱 심사용 번호는
|
|
167
|
+
이제 리옵트 콘솔(브랜드앱 설정 → 앱 심사용 번호)에서 등록한다 — 앱을 다시 배포하지 않고 번호·코드를 바꾸거나 지울
|
|
168
|
+
수 있고, 코드는 앱 env가 아니라 리옵트에 암호화돼 남는다. 옮길 때: 옵션과 그 env를 지우고 같은 번호·코드를
|
|
169
|
+
콘솔에 등록한다(등록은 2단계 인증으로 로그인한 지 5분 안에).
|
|
170
|
+
|
|
171
|
+
### Changed
|
|
172
|
+
|
|
173
|
+
- 콘솔에 등록된 심사용 번호면 리옵트가 문자를 보내지 않고 고정 코드를 돌려주고(`{ sent: false, via: "review", code }`),
|
|
174
|
+
플러그인이 그 코드를 이번 인증번호로 저장한다. 검증·시도 횟수·만료·가입은 다른 번호와 같다. 코드 길이가
|
|
175
|
+
`otpLength`와 다르면 `REVIEW_CODE_LENGTH_MISMATCH`(Better Auth 503). 플러그인은 요청에 `acceptsReviewCode: true`를
|
|
176
|
+
싣는다 — 싣지 않는 호출자(rc.12 이하, 직접 배선한 앱)에게 리옵트는 그 번호를 409 `REVIEW_ACCOUNT_SDK_OUTDATED`로
|
|
177
|
+
거절한다(코드를 돌려줘도 버려지기 때문). `createReoptOtpSmsSender`의 입력에 `acceptsReviewCode`, 결과 타입
|
|
178
|
+
`ReoptOtpSmsResult`에 `review`가 생겼다.
|
|
179
|
+
|
|
180
|
+
- **전화번호 정본이 E.164로 바뀐다**(`+821012345678`, rc.11·12는 국내 표기 `01012345678`). 해외 번호를 받을 준비다 —
|
|
181
|
+
리옵트 서버는 두 표기를 모두 받아 E.164로 저장하고 기존 행도 옮기므로 rc.11·12와도 함께 동작한다.
|
|
182
|
+
🔴 **앱의 Better Auth 사용자 행은 앱이 옮긴다** — rc.11·12는 `user.phoneNumber`에 `01012345678`을 저장했고 rc.13은
|
|
183
|
+
`+821012345678`로 찾는다. 옮기지 않으면 그 사용자가 같은 번호로 **새로 가입**된다. 업그레이드 배포 전에 한 번
|
|
184
|
+
(테이블·컬럼 이름은 앱 스키마에 맞춘다):
|
|
185
|
+
`UPDATE "user" SET "phoneNumber" = '+82' || substr("phoneNumber", 2) WHERE "phoneNumber" ~ '^01[016789][0-9]{7,8}$';`
|
|
186
|
+
번호를 앱 저장소의 다른 곳에도 두었다면 그 값도 E.164로 맞춘다. 임시 이메일은 `+`를 뺀 숫자다
|
|
187
|
+
(`821012345678.<난수>@…`). 기존 사용자의 임시 이메일은 바뀌지 않는다.
|
|
188
|
+
- `+국가코드`로 쓴 다른 국가 번호는 SDK가 거절하지 않고 리옵트로 넘긴다 — 리옵트가 브랜드앱 설정(지금은 한국만)으로
|
|
189
|
+
판정해 `PHONE_COUNTRY_NOT_ALLOWED`(Better Auth 400)로 거절한다. 표기가 이상한 번호는 종전대로 `INVALID_PHONE_NUMBER`.
|
|
190
|
+
|
|
191
|
+
### Added
|
|
192
|
+
|
|
193
|
+
- `formatReoptPhoneNumber` — 저장된 번호를 화면 표기로(`010-1234-5678`, 다른 국가는 E.164 그대로).
|
|
194
|
+
- 리옵트 거절 코드 `PHONE_LOGIN_DISABLED`(콘솔에서 전화번호 로그인을 끈 앱, Better Auth 403)·
|
|
195
|
+
`PHONE_COUNTRY_NOT_ALLOWED`(400)를 Better Auth 오류로 넘긴다.
|
|
196
|
+
|
|
197
|
+
## [4.7.0-rc.12] — 2026-11-07
|
|
198
|
+
|
|
199
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 전화번호 로그인 앱 심사 계정.
|
|
200
|
+
|
|
201
|
+
### Added
|
|
202
|
+
|
|
203
|
+
- `createReoptPhoneNumber(config, { reviewAccounts: { phoneNumbers, code } })` — 문자를 받을 수 없는
|
|
204
|
+
앱스토어·플레이 심사자를 위한 고정 번호·고정 코드. 목록 번호는 리옵트를 부르지 않고(문자·비용 없음)
|
|
205
|
+
플러그인이 저장한 이번 코드를 `code`로 바꾼다. 검증·시도 횟수·만료·가입은 다른 번호와 같다. 번호는 국내
|
|
206
|
+
휴대폰으로 정본화되고 `code`는 `otpLength` 자리 숫자여야 한다(아니면 만들 때 던진다). 실제 개통된 번호를
|
|
207
|
+
넣지 말 것 — 그 주인은 로그인할 수 없고 코드를 아는 사람이 그 계정에 들어간다. 타입
|
|
208
|
+
`ReoptPhoneReviewAccounts`.
|
|
209
|
+
|
|
210
|
+
## [4.7.0-rc.11] — 2026-11-07
|
|
211
|
+
|
|
212
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 전화번호 로그인. 어댑터 모드 앱(앱이 Better Auth를 직접
|
|
213
|
+
돌리는 앱)이 리옵트 계정이나 소셜 API 키 없이 문자 인증번호로 가입·로그인할 수 있다. `better-auth` 1.7.16 이상 필요.
|
|
214
|
+
|
|
215
|
+
### Added
|
|
216
|
+
|
|
217
|
+
- 전화번호 로그인 — `createReoptPhoneNumber(config, options?)`(`/better-auth`)가 Better Auth `phoneNumber`
|
|
218
|
+
플러그인을 리옵트 문자 발송(`POST /api/v1/brandapp/{id}/auth/otp/sms`, 어댑터 자격)과 함께 돌려준다.
|
|
219
|
+
`createReoptBetterAuth()` 번들에도 `phoneNumber`가 실린다. 번호만으로 가입하면 임시 이메일이 들어가고,
|
|
220
|
+
리옵트 콘솔은 그 사용자를 번호로 보이며 **인증된** 번호가 같은 CRM 고객에 잇는다.
|
|
221
|
+
플러그인 없이 발송만 쓰려면 `createReoptOtpSmsSender(config)`. 서버가 워크스페이스 Solapi 연결이 없으면
|
|
222
|
+
`409 SMS_NOT_CONNECTED`로 거절한다(리옵트 시스템 브랜드·데모·테스트 조직은 리옵트 번호로 대신 보낸다).
|
|
223
|
+
번호 정본화·형식 판정 `canonicalizeReoptPhoneNumber`·`isValidReoptPhoneNumber`는 서버와 같은 규칙이다.
|
|
224
|
+
- 보안: **국내 휴대폰만** 받고 `/phone-number/*` 요청의 번호를 플러그인이 보기 전에 `01012345678`로 맞춘다
|
|
225
|
+
(플러그인은 입력 문자열 그대로 사용자를 찾아, 표기만 다른 같은 번호가 두 계정이 될 수 있었다). 임시 이메일은
|
|
226
|
+
`<숫자>.<난수>@phone-login.reopt.app`(번호가 다른 사람에게 넘어가도 유일). 최종 사용자 IP를 함께 보내 리옵트가
|
|
227
|
+
IP 단위 상한을 건다. 리옵트의 거절은 Better Auth 오류로 바꿔 앱 사용자에게 429·503·400이 간다. `better-auth`
|
|
228
|
+
1.7.16 미만이면 만들 때 던진다(그 전 판은 가입 때 미인증 번호를 저장한다). `otpLength` 4~8·`expiresIn` 60~1800.
|
|
229
|
+
`createReoptBetterAuth().phoneNumber`는 접근할 때 만든다.
|
|
230
|
+
|
|
231
|
+
## [4.7.0-rc.10] — 2026-11-02
|
|
232
|
+
|
|
233
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 스트리밍 줄바꿈 결함 수정. rc.9에서 `sdk.ai.stream`으로 받은
|
|
234
|
+
YAML·Markdown 펜스가 한 줄로 붙었다면 이 버전으로 올린다.
|
|
235
|
+
|
|
236
|
+
### Fixed
|
|
237
|
+
|
|
238
|
+
- SSE 파서가 줄바꿈만 있는 `text-delta`를 버리고, 줄바꿈으로 시작하는 델타의 앞머리 줄바꿈을 잃던 것.
|
|
239
|
+
서버는 규격대로 `"\n"`을 `data: \ndata: \n\n`으로 보내는데 파서가 빈 `data:` 값을 "데이터 없음"으로
|
|
240
|
+
읽었다 — 줄바꿈이 문법인 YAML·Markdown 펜스가 한 줄로 붙었다(`sdk.ai.stream`·`streamWithMetadata`·
|
|
241
|
+
`/ai-provider` 공통). `data:` 줄을 봤는지를 값과 따로 기억한다.
|
|
242
|
+
- dev 서버 `/ai/evaluations`의 choice 답이 고른 선택지 하나만 담은 분포(`{ [choice]: 1 }`)를 내 AI SDK
|
|
243
|
+
`experimental_decide`가 "complete distribution"으로 거절하던 것 — 이제 선택지 전부를 덮는다(고른 것 1, 나머지 0).
|
|
244
|
+
`sdk.ai.evaluate`·json-render 평가자는 영향이 없었다.
|
|
245
|
+
|
|
246
|
+
### Docs
|
|
247
|
+
|
|
248
|
+
- AI SDK 결정 함수 이름을 `experimental_decide`로 고쳤다 — `experimental_evaluate`는 AI SDK가 deprecated로 남긴
|
|
249
|
+
옛 이름인데 주석이 거꾸로 적고 있었다. 과금 호출이라 `maxRetries: 0`을 권한다.
|
|
250
|
+
|
|
251
|
+
## [4.7.0-rc.9] — 2026-10-30
|
|
252
|
+
|
|
253
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 평가(Jev)·json-render 조립(RFC-0041). 서버 평가 중계는
|
|
254
|
+
플랫폼이 열기 전까지 503 `EVALUATIONS_UNAVAILABLE`이다 — 그동안은 dev 서버로 개발한다.
|
|
255
|
+
|
|
256
|
+
### Added
|
|
257
|
+
|
|
258
|
+
- `sdk.ai.evaluate()` — 평가 모델(Jev)에 상태와 질문(choice·score·boolean, 최대 128개)을 보내 답과 확률을 받는다
|
|
259
|
+
(`POST /ai/evaluations`, RFC-0041). 브랜드앱 AI 설정 "평가 허용"이 켜져 있어야 하고, 답을 못 준 호출은
|
|
260
|
+
과금되지 않으며, 과금 호출이라 재시도하지 않는다.
|
|
261
|
+
- `createBrandappEvaluator(sdk)` — json-render `experimental_composeSpec`의 `evaluate`에 그대로 꽂는 평가자.
|
|
262
|
+
json-render를 의존성으로 들이지 않는다(구조 호환, 테스트가 실제 `composeSpec`으로 확인).
|
|
263
|
+
`onEvaluation` 콜백으로 평가마다의 실제 크레딧(`creditCostMilli`)을 받는다.
|
|
264
|
+
- `brandapp.decisionModel()`(`/ai-provider`) — AI SDK `experimental_evaluate`용 결정 모델(`Experimental_DecisionModelV4`).
|
|
265
|
+
`evaluationModel()`은 옛 이름. 크레딧은 `providerMetadata.brandapp`. 중계하지 않는 모델 id는 `NoSuchModelError`.
|
|
266
|
+
- dev 서버 `/ai/evaluations` — 결정적인 흉내(실서버와 같은 상한)로 json-render 조립이 오프라인에서 끝까지 돈다.
|
|
267
|
+
- 평가 오류 코드 7종의 `diagnostic`(원인·해결·과금 여부)과 `docs/errors.md` 표. 평가 타입을 루트에서도 export한다.
|
|
268
|
+
|
|
269
|
+
### Fixed
|
|
270
|
+
|
|
271
|
+
- AI provider가 503 `EVALUATIONS_UNAVAILABLE`을 재시도 가능으로 표시하던 것 — 다시 보내도 같은 답이라 AI SDK의 자동
|
|
272
|
+
재시도가 헛돈다.
|
|
273
|
+
|
|
274
|
+
### Docs
|
|
275
|
+
|
|
276
|
+
- `/ai-provider` 진입점 주석이 도구 호출·구조화 출력을 "미지원"으로 적고 있었다(실제로는 4.7부터 지원) —
|
|
277
|
+
지원 범위를 구현과 맞추고, 예시를 기계 자격(`authorization: machine.headers`) 기준으로 바꿨다.
|
|
278
|
+
- `docs/api-reference.md`에 json-render(Standalone·Inline) 연결 예시를 더했다.
|
|
279
|
+
|
|
280
|
+
## [4.7.0-rc.8] — 2026-10-29
|
|
281
|
+
|
|
282
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 도구 루프 정산·경고·끊김 처리.
|
|
283
|
+
|
|
284
|
+
### Added
|
|
285
|
+
|
|
286
|
+
- `usage.creditCostMilli`·`providerMetadata.brandapp.creditCostMilli` — 실제 사용량(1/1000 크레딧).
|
|
287
|
+
`creditCost`는 올림한 정수 표시값이라 1크레딧 미만 단계도 1로 보인다. 도구 루프처럼 한 턴에 여러 단계를
|
|
288
|
+
부르는 앱은 milli를 더한 뒤 한 번만 올림한다. 옛 서버 응답에는 없으므로 선택 필드다.
|
|
289
|
+
- 서버·모델 경고가 AI SDK의 `warnings`로 온다 — 모델이 무시한 설정, 도구 강제로 꺼진 thinking 등. 비스트리밍은
|
|
290
|
+
응답 `warnings`, 스트리밍은 첫 `warnings` SSE 이벤트(SDK가 `stream-start`에 합친다). `sdk.ai` 타입에
|
|
291
|
+
`CompletionWarning`을 더했다.
|
|
292
|
+
- 403 `CLIENT_TOOLS_DISABLED`·`CLIENT_TOOLS_PLAN_REQUIRED`의 `diagnostic`이 고칠 자리(AI 설정의 도구 호출
|
|
293
|
+
허용 · Business 플랜)를 가리킨다.
|
|
294
|
+
|
|
295
|
+
### Changed
|
|
296
|
+
|
|
297
|
+
- 비스트리밍(`generateText`)의 기본 한도를 응답 전체 300초로 늘렸다 — 예전에는 스트리밍 유휴 한도와 같은
|
|
298
|
+
60초가 응답 본문까지 덮어 추론·긴 JSON 응답이 끊겼다. 스트리밍은 그대로 청크 사이 60초다. `timeout`을
|
|
299
|
+
지정하면 둘 다 그 값이다.
|
|
300
|
+
- 서버: 호출 앱이 연결을 끊으면(`abortSignal`, 탭 닫기) 모델 호출도 멈춘다 — 예전에는 끝까지 생성하고 전액
|
|
301
|
+
과금했다. 끊긴 단계는 읽은 입력 + 이미 보낸 출력으로 과금한다.
|
|
302
|
+
- 서버: `maxTokens`(AI SDK `maxOutputTokens`)를 주지 않으면 4096이 아니라 앱 AI 설정의 최대 출력 토큰
|
|
303
|
+
(기본 8192)까지 쓴다 — 추론 모델과 큰 JSON 응답이 잘렸다.
|
|
304
|
+
- 서버: `-thinking` Anthropic 모델에 사고 요약(`display: "summarized"`)을 요청한다 — Claude 5 계열 기본값
|
|
305
|
+
(`omitted`)에서는 추론 파트가 텍스트 없이 서명만 왔다.
|
|
306
|
+
|
|
307
|
+
## [4.7.0-rc.7] — 2026-10-28
|
|
308
|
+
|
|
309
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — AI SDK provider의 도구 호출·구조화 출력·추론 파트 왕복.
|
|
310
|
+
|
|
311
|
+
### Added
|
|
312
|
+
|
|
313
|
+
- `createBrandappProvider` — **도구 호출·구조화 출력·추론 파트 왕복**. `tools`·`toolChoice`(auto·none·required·
|
|
314
|
+
특정 도구), `responseFormat: json`을 더 이상 `UnsupportedFunctionalityError`로 거절하지 않는다. 도구는 앱이
|
|
315
|
+
실행하고 서버는 호출만 돌려준다 — `ToolLoopAgent`·`streamText` + `stopWhen` 루프가 그대로 동작하고, 단계마다
|
|
316
|
+
`providerMetadata.brandapp.creditCost`가 실린다. 스트림은 `reasoning-start/delta/end`·`tool-input-start/delta/end`·
|
|
317
|
+
`tool-call`(한 단계에 여럿 가능) 파트를 내고, 추론 파트의 `providerMetadata`(Anthropic 서명 등)를 다음 요청으로
|
|
318
|
+
되돌린다. 도구 결과는 `execution-denied`·`content`(텍스트)까지 손실 없이 옮긴다(예전에는 텍스트로 뭉갰다).
|
|
319
|
+
`usage`에 캐시 읽기·쓰기·추론 토큰이 채워진다. 추론 강도는 `providerOptions.brandapp.reasoningEffort`
|
|
320
|
+
(또는 `anthropic.effort`·`openai.reasoningEffort`). 그 밖의 요청 단위 `providerOptions`는 무시한다.
|
|
321
|
+
**서버 쪽 전제**: 브랜드앱 AI 설정의 "도구 호출·구조화 출력 허용" + Business 플랜 — 아니면
|
|
322
|
+
`403 CLIENT_TOOLS_DISABLED` / `CLIENT_TOOLS_PLAN_REQUIRED`.
|
|
323
|
+
- `/ai` 타입 — `CompletionResult.content`(응답 파트), `CompletionUsage`(캐시·추론 토큰), `CompletionContentPart`,
|
|
324
|
+
`PartProviderMetadata`.
|
|
325
|
+
|
|
326
|
+
### Changed
|
|
327
|
+
|
|
328
|
+
- provider 실행 도구(`type: "provider"`)는 요청 전에 `UnsupportedFunctionalityError`로 거절한다. 비전·파일 입력은
|
|
329
|
+
여전히 거절한다.
|
|
330
|
+
|
|
331
|
+
- `@reopt-ai/brandapp-sdk/social` — 소셜 운영 플랫폼 API(RFC-0037 §7) 클라이언트 `createSocialClient`(scope
|
|
332
|
+
`social:read`·`social:write`): `accounts.list`, `contents.list/convert`, `posts.list/get/transition/propose`,
|
|
333
|
+
`reviews.run`. 모든 채널은 직접 게시라 플랫폼에 올리는 호출은 없고, 승인·게시 기록·취소는 승인함 **제안**이다.
|
|
334
|
+
- `/social` 계정 `profile.reviewChecklist`(RFC-0038) — 계정별 검수 기준 항목 `{text, severity}`. 응답·저장 스키마 둘 다 선택 칸.
|
|
335
|
+
`/workspace`와 요청기를 공유한다(`createPlatformRequester`). 문서 `docs/social.md`.
|
|
336
|
+
- `/social` — 글(`SocialPost`)에 `links`(변환이 본문 URL을 바꿔 넣은 추적 링크: `originalUrl`·`shortUrl`·`clicks`).
|
|
337
|
+
`clicks`는 리옵트 링크 원장의 누적 클릭이지 플랫폼 반응이 아니다.
|
|
338
|
+
|
|
339
|
+
### Fixed
|
|
340
|
+
|
|
341
|
+
- 기계 자격(`authorization: machine.headers`, RFC-0034)이 **손으로 짠 요청 경로**에도 실린다 —
|
|
342
|
+
`ai.stream()`·`ai.streamWithMetadata()`(SSE), `files.upload()`, `files.readContent()`,
|
|
343
|
+
`createBrandappProvider`(언어·이미지 모델). 지금까지 이 경로들은 정적 `Basic base64("<clientId>:")`를
|
|
344
|
+
보내 `401 Missing clientId or clientSecret`로 실패했다(`http.fetch`를 타는 `models`·`complete` 등은 정상).
|
|
345
|
+
DPoP 증명은 요청마다, 스트림 연결 재시도마다 새로 받는다. `createBrandappProvider`가 `authorization`을 받는다.
|
|
346
|
+
손으로 요청을 짜는 코드는 `http.authorizationHeader` 대신 `http.requestAuthHeaders({ method, url })`를 쓴다.
|
|
347
|
+
|
|
348
|
+
- 서버 — `changePlan`으로 바꾼 플랜의 `paymentEnvironment`가 `null`로 오던 것. 바뀐 플랜에는 자기 체크아웃이 없어
|
|
349
|
+
"모름"이 됐고, 그 값으로 실 결제·테스트 결제만 인정하는 앱은 올린 고객의 이용권을 거뒀다. 이제 그 구독을 시작한
|
|
350
|
+
체크아웃의 환경을 말한다(SDK 코드 변경 없음, 문서만).
|
|
351
|
+
|
|
352
|
+
## [4.7.0-rc.6] — 2026-10-15
|
|
353
|
+
|
|
354
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 해지 예약 구독 재개(`plans.resume`)와 해지 기간 중 새 결제 차단.
|
|
355
|
+
|
|
356
|
+
### Added
|
|
357
|
+
|
|
358
|
+
- `plans.resume(accessToken)` — 결제한 기간이 남은 해지 예약 구독을 되살린다(`POST /me/subscription/resume`, Lemon
|
|
359
|
+
Squeezy). 같은 구독이 갱신일 그대로 이어지고 바뀐 플랜(`getMyPlan`과 같은 모양)을 돌려준다. 거절은
|
|
360
|
+
`NO_RESUMABLE_SUBSCRIPTION`(409), 결제사 실패는 `PROVIDER_ERROR`(502, 재시도).
|
|
361
|
+
|
|
362
|
+
### Changed
|
|
363
|
+
|
|
364
|
+
- `plans.createCheckout` — 해지 예약 구독이 결제한 기간을 남기고 있으면 `SUBSCRIPTION_CANCEL_PENDING`(409)으로
|
|
365
|
+
거절한다. 새 구독을 열면 옛 구독과 겹친 기간을 두 번 내기 때문이다 — `resume` 뒤 다른 플랜이면 `changePlan`.
|
|
366
|
+
|
|
367
|
+
## [4.7.0-rc.5] — 2026-10-14
|
|
368
|
+
|
|
369
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 구독 중 플랜 변경(`plans.changePlan`)과 Lemon Squeezy 해지 계약, 5xx 오류 코드 보존.
|
|
370
|
+
|
|
371
|
+
### Added
|
|
372
|
+
|
|
373
|
+
- `plans.changePlan(planId, accessToken)` — 구독 중인 플랜을 바꾼다(`POST /me/subscription/change`).
|
|
374
|
+
새 체크아웃 없이 결제사 구독의 가격을 그 자리에서 바꾸므로 구독은 하나이고 갱신일이 이어진다.
|
|
375
|
+
즉시 적용되고 바뀐 플랜(`getMyPlan`과 같은 모양)을 돌려준다. 올리면 차액을 지금 청구하고 내리면
|
|
376
|
+
다음 청구서에서 차감한다. Lemon Squeezy 구독만 지원한다.
|
|
377
|
+
|
|
378
|
+
### Changed
|
|
379
|
+
|
|
380
|
+
- 5xx 오류가 서버가 준 코드와 실제 상태를 담는다 — 상류(결제사) 실패는 `ServerError`이면서 `code`가
|
|
381
|
+
`PROVIDER_ERROR`·`PROVIDER_CANCEL_FAILED`, `status`가 502다. 코드 없는 5xx는 예전처럼 `SERVER_ERROR`이고
|
|
382
|
+
`status`는 실제 응답 상태다(전에는 항상 500).
|
|
383
|
+
- `plans.cancel` — Lemon Squeezy 구독은 결제사 해지가 먼저다. 결제사 해지가 실패하면 아무것도 바뀌지
|
|
384
|
+
않고 `PROVIDER_CANCEL_FAILED`(HTTP 502)로 실패한다 — 다시 시도하면 된다. 성공하면 `accessUntil`이
|
|
385
|
+
결제사의 결제 기간 끝이다.
|
|
386
|
+
|
|
387
|
+
## [4.7.0-rc.4] — 2026-10-14
|
|
388
|
+
|
|
389
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — EAV `listAll()` 커서 훑기와 설치 back-channel 재생 거절 보강.
|
|
390
|
+
|
|
391
|
+
### Changed
|
|
392
|
+
|
|
393
|
+
- **`eav.records.listAll()`이 커서로 훑는다.** 번호 페이지로 훑으면 필터가 있을 때 서버가 페이지마다 조건에 맞는 행
|
|
394
|
+
전체를 다시 읽어 그 페이지만 잘랐다 — 훑는 비용이 행 수의 제곱이었다. 이제 `GET …/records?cursor=`로 앞 페이지의
|
|
395
|
+
마지막 자리 다음부터 그 페이지 분량만 읽는다. 호출부는 바꿀 것이 없다(`backfill()`·typed `entity().listAll()` 포함).
|
|
396
|
+
- 정렬이 `createdAt`(기본)·`updatedAt`일 때만 커서를 쓴다. 커스텀 속성 정렬은 종전대로 번호 페이지다.
|
|
397
|
+
- 커서를 모르는 서버(이전 버전의 reopt, 로컬 dev 서버)는 `cursor`를 무시하고 1페이지를 주므로, 그때는 2페이지부터
|
|
398
|
+
번호로 이어 간다 — 결과는 같다.
|
|
399
|
+
- 같은 정렬 키를 가진 행들의 순서는 커서 방식에서 id가 정한다(번호 페이지는 createdAt → id). `updatedAt` 정렬로
|
|
400
|
+
훑는 도중 갱신된 행은 자리를 옮기므로, 전 행을 정확히 한 번씩 읽어야 하면 기본값인 `createdAt`을 쓴다.
|
|
401
|
+
- SQL로 좁혀지지 않는 필터(`neq`·`not_in`·`after`·`before`)로 큰 엔티티를 훑어도 `QUERY_TOO_BROAD`(422)가 나지
|
|
402
|
+
않는다 — 서버가 요청 한 건이 읽는 행 수를 묶고 커서로 이어 준다.
|
|
403
|
+
- 새 에러 코드 `CURSOR_SCAN_INTERRUPTED`(훑는 도중 커서를 모르는 인스턴스가 응답 — 처음부터 다시),
|
|
404
|
+
`CURSOR_SCAN_STALLED`(서버가 커서를 전진시키지 않음).
|
|
405
|
+
|
|
406
|
+
### Fixed
|
|
407
|
+
|
|
408
|
+
- **`createInstallationBackchannelHandler`의 재생 거절에 빈틈이 있었다.** 통지의 jti를 `exp`까지만 기억했는데 검증은
|
|
409
|
+
`clockToleranceSeconds`(기본 60초)만큼 더 받아 주므로, `exp` 직후 그 시간 동안은 같은 통지가 다시 통과했다. 이제
|
|
410
|
+
받아 줄 수 있는 마지막 순간(`exp + clockTolerance`)까지 기억한다.
|
|
411
|
+
- `createMemoryBackchannelReplayStore(now?)` — 시계를 받는다. 핸들러의 `now` 옵션이 기본 메모리 저장소에도 적용돼
|
|
412
|
+
만료 판정과 기억을 지우는 시점이 같은 시계를 본다(예전에는 저장소만 실제 시계를 봤다).
|
|
413
|
+
|
|
414
|
+
## [4.7.0-rc.3] — 2026-10-11
|
|
415
|
+
|
|
416
|
+
Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — RFC-0034 2·3단계: 리소스 서버 검증기와 운영자 가드.
|
|
417
|
+
|
|
418
|
+
### Added
|
|
419
|
+
|
|
420
|
+
- **`@reopt-ai/brandapp-sdk/resource`** (RFC-0034 §4.3) — 서브 제품 API가 리옵트 id의 기계 토큰(`at+jwt` + DPoP)을 받는
|
|
421
|
+
검증기 **한 벌**. `createResourceVerifier({ issuer, audience, jwks?, dpop: { required, replayStore }, allowUserTokens?, publicUrl? })`
|
|
422
|
+
→ `verify(request, { scope })`는 `MachinePrincipal`을 주거나 `ResourceAuthError`(`code` 12종, `status` 401|403,
|
|
423
|
+
`wwwAuthenticate()`)를 던진다. `verify.safe()`·`verify.looksLikeAccessToken()`. 저수준 `verifyMachineToken(input)`(결과 유니언),
|
|
424
|
+
`createRedisDpopReplayStore(redis, { keyPrefix, onFallback })`(`SET NX PX`, fail-closed)·`createMemoryDpopReplayStore()`,
|
|
425
|
+
`resolvePublicRequestUrl()`(proxy 뒤 `x-forwarded-*` → DPoP `htu`). 리옵트 본체의 플랫폼·브랜드앱 미들웨어도 같은 구현을 쓴다.
|
|
426
|
+
- **`@reopt-ai/brandapp-sdk/superadmin`** (RFC-0034 §5.2) — 운영자 가드. 리옵트가 id token·userinfo·access token에
|
|
427
|
+
`reopt_operator`·`reopt_mfa`·`auth_time`을 싣고, `evaluateOperator(claims, { maxAuthAgeSeconds })`/`requireOperator()`가
|
|
428
|
+
① claim ② 운영자 ③ 2단계 인증 **수행** ④ 로그인 나이 순으로 판정한다(`OperatorAccessError`: `no_claims`·`not_operator`·
|
|
429
|
+
`mfa_not_performed`·`reauth_required`, 403). `decodeIdTokenClaims()`(백채널 id token 전용, 서명 미검증), `latestReoptAccount()`,
|
|
430
|
+
`stepUpAuthorizationParams()`, `OPERATOR_ACCESS_MESSAGES`. 서브 제품은 자기 allowlist를 지운다.
|
|
431
|
+
- **`@reopt-ai/brandapp-sdk/installation`** (RFC-0034 §6–§8) — 설치(리옵트 연결). `installationManifestSchema`·`manifestHash`·
|
|
432
|
+
`signManifest`/`verifyManifestJws`(본문의 `jwksUri`에서 키를 받아 검증, `ManifestVerifyError`), `deriveInstallationManifest`
|
|
433
|
+
(RFC-0030 선언 파일 → 매니페스트, 웹훅 `secret` 필수), `signInstallationAssertion`(`reopt-installation-assertion+jwt`),
|
|
434
|
+
`createInstallationClient`(`request`·`get`·`reinstall`·`revoke`·`refreshJwks`·`health` — 승인 전엔 단언, 활성 뒤엔 설치의
|
|
435
|
+
machine 토큰), `createInstallationBackchannelHandler`(`reopt-installation-event+jwt`, id JWKS·iss·aud·재생 검사),
|
|
436
|
+
`createReoptConnection`(§7.6 headless 상태 `unconnected|pending|connected|suspended|rejected|revoked` + `describe()` 문구),
|
|
437
|
+
`selfCheckJwks`, `planKeyRotation`/`confirmKeyRecognized`(회전 ②, 최대 5분 재시도). 서버 전용, `zod` 필요.
|
|
438
|
+
- `createMachineClient`: `scopes: []`면 토큰 요청에 `scope`를 **보내지 않는다** — id가 클라이언트 행에 등록된 scope 전부를 발급한다
|
|
439
|
+
(설치 클라이언트의 최소 권한). 예전엔 빈 문자열을 보냈다.
|
|
440
|
+
- `createReoptOAuth({ stepUp: true | seconds })` — step-up 재로그인 제공자 `reopt-step-up`(`prompt=login&max_age`)을 함께 등록한다.
|
|
441
|
+
`signInWithReopt(client, { stepUp: true })`가 그 제공자로 authorize를 다시 탄다. `REOPT_PROVIDER_IDS`를
|
|
442
|
+
`account.accountLinking.trustedProviders`에 넣고, 콜백 `/api/auth/callback/reopt-step-up`을 리옵트 클라이언트에 등록한다.
|
|
443
|
+
|
|
444
|
+
### Changed
|
|
445
|
+
|
|
446
|
+
- 문서·예제를 서버 자격 기준으로 바꿨다 — README Quick Start·`createReoptSDK` JSDoc·`createReoptAdapter` JSDoc·설정 표·env 표가
|
|
447
|
+
`createMachineClient({ keyRing })` + `authorization: machine.headers`를 먼저 보여 주고, `clientSecret`은 로그인 클라이언트의
|
|
448
|
+
code 교환(과도기 Basic)으로만 남긴다. `validateConfig`의 자격 누락 메시지도 `authorization`을 첫 선택지로 안내한다(동작 변화 없음).
|
|
449
|
+
|
|
10
450
|
## [4.7.0-rc.2] — 2026-10-10
|
|
11
451
|
|
|
12
452
|
### Changed
|