@icomponents/shell 0.1.0 → 0.1.4
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/AGENTS.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
роли и вход, `@icomponents/theme` — вид кабинета, `@icomponents/registry` — экран-реестр.
|
|
14
14
|
`@iconicompany/ui` (ilanding) заменён ими и больше не развивается.
|
|
15
15
|
- Меню — реестр `PLATFORM_MODULES` (`@icomponents/shell/nav`); оболочка берёт его документом
|
|
16
|
-
|
|
16
|
+
icrm `/icrm/modules.json` — пункт меняется правкой `icrm/public/modules.json`. Свои разделы модуль отдаёт ДАННЫМИ
|
|
17
17
|
(`sections` / `sectionGroups`), сессию — данными (`session`), а не вёрсткой. `headerSlot` устарел.
|
|
18
18
|
- **Роли меню — от СВОЕГО модуля, не от iprofile.** Модуль монтирует `GET /<модуль>/api/platform/me`
|
|
19
19
|
обработчиком `createPlatformIdentityHandler` из `@icomponents/auth/server`: он берёт access token
|
|
@@ -22,7 +22,8 @@
|
|
|
22
22
|
502 `zitadel-rejected`. Кука iprofile больше ни при чём: меню живёт, пока жива сессия модуля.
|
|
23
23
|
- Оболочка запрашивает этот ответ сама: не передавай `roles` (и `organization`). На 401 —
|
|
24
24
|
`session.onSignIn` модуля (без `session` — перезагрузка, гейт отдаёт 302 на вход), не чаще раза за
|
|
25
|
-
5 мин, потом
|
|
25
|
+
5 мин, потом «Войти». 502 `zitadel-rejected` (вошёл до добавления скоупа) — один новый вход через
|
|
26
|
+
`session.onSignIn` за сессию вкладки, меню пустое, имя остаётся. Прочие 5xx и сеть — без ухода. Отключённые гранты в меню не попадают;
|
|
26
27
|
`iprofile:impersonator` добавляется по роли инстанса, как раньше в whoami iprofile. Адрес — `identityUrl`, по умолчанию
|
|
27
28
|
`/<первый сегмент пути>/api/platform/me`. Свой fetch whoami в модуле — удалить. Имя для шапки —
|
|
28
29
|
`usePlatformIdentity({ url })` из `@icomponents/auth/client/use-platform-identity` (тот же запрос).
|
|
@@ -77,11 +78,11 @@
|
|
|
77
78
|
|
|
78
79
|
Реестр `PLATFORM_MODULES` в `@icomponents/shell/nav` — единственный ответ на «из чего состоит
|
|
79
80
|
кабинет». Видимость — по РОЛЯМ ПРОЕКТА (`<проект>:<роль>`), а не по правам: право — дело самого
|
|
80
|
-
модуля. Новый модуль
|
|
81
|
+
модуля. Новый модуль — строкой в `icrm/public/modules.json` (и в `PLATFORM_MODULES` пакета как запас); в продукте список модулей не заводят.
|
|
81
82
|
|
|
82
|
-
**Меню доезжает без пересборки модулей.**
|
|
83
|
-
|
|
84
|
-
вшитый список пакета, он же запас при сбое. Смена пункта — строка в `nav.ts`
|
|
83
|
+
**Меню доезжает без пересборки модулей.** Реестр — статика icrm `/icrm/modules.json` на общем
|
|
84
|
+
домене (источник `icrm/public/modules.json`); `DashboardShell` забирает его при загрузке, первый кадр —
|
|
85
|
+
вшитый список пакета, он же запас при сбое. Смена пункта — правка документа icrm и строка в `nav.ts` (запас);
|
|
85
86
|
выпуск пакета и пересборка модулей для этого не нужны.
|
|
86
87
|
Свой `modules` у оболочки (тесты, превью) побеждает, документ тогда не запрашивается.
|
|
87
88
|
|
|
@@ -253,9 +254,23 @@ const { draft, set, dirty } = useFilterDraft(applied); // правки копя
|
|
|
253
254
|
`@icomponents/registry/…`; `use-platform-identity` → `@icomponents/auth/client/use-platform-identity`
|
|
254
255
|
(теперь `usePlatformIdentity({ url: platformIdentityUrl(pathname) })`, поле ответа — `identity`).
|
|
255
256
|
3. `@source` на `@iconicompany/ui/src` → три строки на `@icomponents/{shell,theme,registry}/src`.
|
|
256
|
-
4. Сервер: смонтировать `GET /api/platform/me
|
|
257
|
-
|
|
258
|
-
|
|
257
|
+
4. Сервер: смонтировать `GET /api/platform/me`. Модуль на better-auth — готовым `resolve`:
|
|
258
|
+
```ts
|
|
259
|
+
createPlatformIdentityHandler({
|
|
260
|
+
issuer,
|
|
261
|
+
resolve: createBetterAuthSessionResolver({ api: auth.api, providerId: "zitadel" }),
|
|
262
|
+
});
|
|
263
|
+
```
|
|
264
|
+
Он берёт аккаунт IdP сессии (`listUserAccounts`) и токен по `accountId` — в better-auth 1.7
|
|
265
|
+
`getAccessToken` с `providerId` в теле не работает; организация — из клеймов `id_token`. Вошёл
|
|
266
|
+
паролем — 200 `roles: []` без петли входа; refresh не удался — 401; сбой базы — 503.
|
|
267
|
+
`authorize: (request, userId) => …` — проверка модуля (блокировка учётки, совпадение с принципалом
|
|
268
|
+
периметра): getSession better-auth её не делает; `false` — 401. Периметр (trusted-header) —
|
|
269
|
+
`principal: (request) => { userId } | null`: впущенный без своей куки better-auth получает 200
|
|
270
|
+
`roles: []`, а не 401 (вход в периметре — 403, петля).
|
|
271
|
+
502 в 401 у себя не переводить: повторный вход за модуль делает оболочка, один раз за вкладку —
|
|
272
|
+
better-auth 1.7 не обновляет `account.scope` при повторном входе, но новый токен скоуп несёт. Свою
|
|
273
|
+
копию этой цепочки модулю не держать. Маршрут — закрытый (без сессии 401) в тесте анонимной поверхности.
|
|
259
274
|
5. Вход: добавить скоуп `urn:zitadel:iam:org:project:id:zitadel:aud`. Проверка — после входа ответ
|
|
260
275
|
`/api/platform/me` 200 с ролями соседних проектов, а не 502.
|
|
261
276
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@icomponents/shell",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Оболочка кабинета платформы: сайдбар с меню модулей, шапка, вход и выход, реестр модулей",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "UNLICENSED",
|
|
@@ -29,9 +29,9 @@
|
|
|
29
29
|
"lucide-react": "^1.28.0"
|
|
30
30
|
},
|
|
31
31
|
"peerDependencies": {
|
|
32
|
-
"@icomponents/auth": "^0.1.
|
|
33
|
-
"@icomponents/react": "^0.1.
|
|
34
|
-
"@icomponents/theme": "^0.1.
|
|
32
|
+
"@icomponents/auth": "^0.1.4",
|
|
33
|
+
"@icomponents/react": "^0.1.4",
|
|
34
|
+
"@icomponents/theme": "^0.1.4",
|
|
35
35
|
"react": ">=19",
|
|
36
36
|
"react-dom": ">=19"
|
|
37
37
|
},
|
package/src/dashboard-shell.tsx
CHANGED
|
@@ -91,7 +91,7 @@ export interface DashboardShellProps {
|
|
|
91
91
|
*/
|
|
92
92
|
brandSlot?: React.ReactNode;
|
|
93
93
|
/**
|
|
94
|
-
* Реестр модулей. По умолчанию — документ
|
|
94
|
+
* Реестр модулей. По умолчанию — документ icrm `/icrm/modules.json` поверх вшитого списка;
|
|
95
95
|
* заданный здесь (тесты, превью) побеждает, и документ не запрашивается.
|
|
96
96
|
*/
|
|
97
97
|
modules?: readonly PlatformModule[];
|
|
@@ -214,7 +214,7 @@ export function DashboardShell({
|
|
|
214
214
|
// Сессии модуля нет, а уход на вход уже был — «Войти» вместо имени, вход модуля.
|
|
215
215
|
const session =
|
|
216
216
|
sessionProp && identity.status === "signed-out" ? { ...sessionProp, user: null } : sessionProp;
|
|
217
|
-
// Реестр — документ
|
|
217
|
+
// Реестр — документ icrm (меню меняется без пересборки модуля), первый кадр — вшитый список.
|
|
218
218
|
const registry = usePlatformModules(modules);
|
|
219
219
|
const visible = visibleModules(roles, registry);
|
|
220
220
|
const active = activeModuleId(pathname, registry);
|
|
@@ -34,7 +34,7 @@ describe("документ меню", () => {
|
|
|
34
34
|
const doc = modulesDocument();
|
|
35
35
|
expect(doc.format).toBe(MODULES_FORMAT);
|
|
36
36
|
expect(doc.modules).toEqual(PLATFORM_MODULES);
|
|
37
|
-
expect(MODULES_PATH).toBe("/
|
|
37
|
+
expect(MODULES_PATH).toBe("/icrm/modules.json");
|
|
38
38
|
expect(MODULES_CACHE_SECONDS).toBe(300);
|
|
39
39
|
// Документ переживает сериализацию без потерь: его отдают по сети.
|
|
40
40
|
expect(parseModulesDocument(JSON.parse(JSON.stringify(doc)))).toEqual(PLATFORM_MODULES);
|
package/src/platform-modules.ts
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* МЕНЮ ПЛАТФОРМЫ ДАННЫМИ. Реестр
|
|
3
|
-
* оболочка каждого модуля забирает его при загрузке: смена пункта —
|
|
2
|
+
* МЕНЮ ПЛАТФОРМЫ ДАННЫМИ. Реестр — статика icrm (`icrm/public/modules.json`) на общем домене, и
|
|
3
|
+
* оболочка каждого модуля забирает его при загрузке: смена пункта — правка документа icrm, а не
|
|
4
4
|
* выпуск пакета и пересборка всех модулей. Вшитый список остаётся первым кадром и запасом.
|
|
5
5
|
*
|
|
6
|
-
* Здесь без React: формат документа нужен и
|
|
6
|
+
* Здесь без React: формат документа нужен и проверке icrm, и браузеру.
|
|
7
7
|
*/
|
|
8
8
|
import { PLATFORM_MODULES, type PlatformModule } from "./nav";
|
|
9
9
|
|
|
10
10
|
/** Адрес документа — от корня домена: все модули живут на одном хосте, CORS не нужен. */
|
|
11
|
-
export const MODULES_PATH = "/
|
|
11
|
+
export const MODULES_PATH = "/icrm/modules.json";
|
|
12
12
|
|
|
13
13
|
/** Номер формата. Меняется только при несовместимой правке — старая оболочка тогда останется на вшитом. */
|
|
14
14
|
export const MODULES_FORMAT = 1;
|
|
@@ -8,7 +8,7 @@ let pending: Promise<readonly PlatformModule[] | null> | undefined;
|
|
|
8
8
|
|
|
9
9
|
/**
|
|
10
10
|
* Реестр модулей для оболочки. Первый кадр — вшитый список (серверный рендер и гидратация от сети не
|
|
11
|
-
* зависят), затем — документ
|
|
11
|
+
* зависят), затем — документ icrm, если он пришёл и прошёл проверку. Свой `explicit` (тесты,
|
|
12
12
|
* превью) побеждает и документ не запрашивает.
|
|
13
13
|
*/
|
|
14
14
|
export function usePlatformModules(
|
|
@@ -31,7 +31,7 @@ export function usePlatformModules(
|
|
|
31
31
|
return pickModules(explicit, loaded);
|
|
32
32
|
}
|
|
33
33
|
|
|
34
|
-
/** Что рисовать: свой список модуля, иначе документ
|
|
34
|
+
/** Что рисовать: свой список модуля, иначе документ icrm, иначе вшитый. */
|
|
35
35
|
export function pickModules(
|
|
36
36
|
explicit: readonly PlatformModule[] | undefined,
|
|
37
37
|
loaded: readonly PlatformModule[] | null
|