@icomponents/shell 0.1.3 → 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
- ilanding `/platform/modules.json` — пункт меняется выкаткой ilanding. Свои разделы модуль отдаёт ДАННЫМИ
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 мин, потом «Войти»; 502/503 — без ухода. Отключённые гранты в меню не попадают;
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
- **Меню доезжает без пересборки модулей.** ilanding отдаёт реестр документом
83
- `/platform/modules.json` на общем домене; `DashboardShell` забирает его при загрузке, первый кадр —
84
- вшитый список пакета, он же запас при сбое. Смена пункта — строка в `nav.ts` и выкатка ilanding;
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` (`createPlatformIdentityHandler({ issuer, resolve })`):
257
- `resolve` берёт сессию модуля и её access token (better-auth: `auth.api.getAccessToken`), имя и
258
- организацию из клеймов. Маршрут — закрытый (без сессии 401) в тесте анонимной поверхности.
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",
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.3",
33
- "@icomponents/react": "^0.1.3",
34
- "@icomponents/theme": "^0.1.3",
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
  },
@@ -91,7 +91,7 @@ export interface DashboardShellProps {
91
91
  */
92
92
  brandSlot?: React.ReactNode;
93
93
  /**
94
- * Реестр модулей. По умолчанию — документ ilanding `/platform/modules.json` поверх вшитого списка;
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
- // Реестр — документ ilanding (меню меняется без пересборки модуля), первый кадр — вшитый список.
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("/platform/modules.json");
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);
@@ -1,14 +1,14 @@
1
1
  /**
2
- * МЕНЮ ПЛАТФОРМЫ ДАННЫМИ. Реестр `PLATFORM_MODULES` отдаёт ilanding документом на общем домене, и
3
- * оболочка каждого модуля забирает его при загрузке: смена пункта — выкатка одного ilanding, а не
2
+ * МЕНЮ ПЛАТФОРМЫ ДАННЫМИ. Реестр — статика icrm (`icrm/public/modules.json`) на общем домене, и
3
+ * оболочка каждого модуля забирает его при загрузке: смена пункта — правка документа icrm, а не
4
4
  * выпуск пакета и пересборка всех модулей. Вшитый список остаётся первым кадром и запасом.
5
5
  *
6
- * Здесь без React: формат документа нужен и серверу ilanding, и браузеру.
6
+ * Здесь без React: формат документа нужен и проверке icrm, и браузеру.
7
7
  */
8
8
  import { PLATFORM_MODULES, type PlatformModule } from "./nav";
9
9
 
10
10
  /** Адрес документа — от корня домена: все модули живут на одном хосте, CORS не нужен. */
11
- export const MODULES_PATH = "/platform/modules.json";
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
- * зависят), затем — документ ilanding, если он пришёл и прошёл проверку. Свой `explicit` (тесты,
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
- /** Что рисовать: свой список модуля, иначе документ ilanding, иначе вшитый. */
34
+ /** Что рисовать: свой список модуля, иначе документ icrm, иначе вшитый. */
35
35
  export function pickModules(
36
36
  explicit: readonly PlatformModule[] | undefined,
37
37
  loaded: readonly PlatformModule[] | null