@boxa-devops/depo-shared 1.0.4 → 1.1.0

package/README.md

@@ -33,23 +33,25 @@
 
 ```sh
 pnpm install
-pnpm generate    # openapi.json -> src/api.ts (после ../depo-api: make contract)
+pnpm generate        # openapi.json -> src/api.ts (после ../depo-api: make contract)
 pnpm lint
-pnpm typecheck   # единственный гейт, видящий ошибку типов внутри пакета
+pnpm typecheck       # ошибки типов по исходникам
 pnpm test
-pnpm build       # dist/: ESM + .d.ts + sourcemaps
+pnpm build           # dist/: ESM + .d.ts + sourcemaps
+pnpm consumer-check  # компиляция потребителя против тарболла, skipLibCheck OFF
+pnpm preflight       # тесты обоих фронтендов против этой копии контракта
 ```
 
 ## Релиз
 
-1. `cd ../depo-api && make contract` — перегенерировать контракт сюда.
-2. `pnpm generate && pnpm lint && pnpm typecheck && pnpm test && pnpm build`.
-3. **Прогнать `pnpm test` в `depo-terminal` и `depo-admin`** — одной
-   командой на оба это больше не сделать (было `pnpm -r test`).
-4. Посмотреть `git diff openapi.json` глазами, поднять версию, записать
-   в `CHANGELOG.md`.
-5. Человек: `git commit`, `git tag vX.Y.Z`, `git push --follow-tags` →
-   workflow публикует пакет.
+1. `cd ../depo-api && make release` — весь автоматический круг: генерация
+   контракта, все гейты здесь, плюс `preflight` (тесты обоих фронтендов
+   против этой рабочей копии). Останавливается и печатает диф.
+2. Прочитать `git diff openapi.json` глазами — это и есть гейт контракта.
+3. Поднять версию, запись в `CHANGELOG.md`.
+4. `git commit && git tag vX.Y.Z && git push --follow-tags` → workflow
+   публикует пакет в npmjs.
+5. Ничего. Dependabot во фронтендах сам откроет PR на новую версию.
 
 Правила версионирования и остальные детали — `CLAUDE.md`.
 

package/dist/api.d.ts

@@ -962,6 +962,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/refs/loco-series/{code}/positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Series Positions
+         * @description Every type bound to this series, with the list it carries there.
+         *
+         *     Types with no binding are deliberately absent rather than listed with their
+         *     global list: the visualization has to be able to tell «this series says so»
+         *     from «the type says so», and a merged view cannot.
+         */
+        get: operations["list_series_positions_api_v1_admin_refs_loco_series__code__positions_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/refs/loco-series/{code}/positions/{nomenclature_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Bind Series Positions
+         * @description Create or replace the binding. Idempotent by (series, type).
+         */
+        put: operations["bind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__put"];
+        post?: never;
+        /**
+         * Unbind Series Positions
+         * @description Drop the binding: the type falls back to its global positions list.
+         *
+         *     Absent binding is not an error — the operator's intent («this series has no
+         *     list of its own») already holds.
+         */
+        delete: operations["unbind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/admin/refs/{entity}": {
         parameters: {
             query?: never;
@@ -2875,6 +2926,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/refs/loco-series-positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Loco Series Positions
+         * @description Per-series mount positions, for the terminal's chips.
+         *
+         *     A small dictionary by design: only the types whose positions differ from
+         *     the global `nomenclature.positions` have a row. The client applies it as an
+         *     override — series row first, global list otherwise.
+         */
+        get: operations["loco_series_positions_api_v1_refs_loco_series_positions_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/refs/nomenclature": {
         parameters: {
             query?: never;
@@ -7477,6 +7552,61 @@ export interface components {
             /** Photo Key */
             photo_key: string | null;
         };
+        /**
+         * LocoSeriesPositionIn
+         * @description Bind a part type to a series with that machine's own position list.
+         *
+         *     Normalised by the same validator as nomenclature.positions, so a list means
+         *     the same thing wherever it was typed. An empty list is rejected: «no
+         *     per-series list» is expressed by DELETEing the binding, which falls the
+         *     type back to its global list, not by saving emptiness that would read as
+         *     «this series has no positions».
+         */
+        LocoSeriesPositionIn: {
+            /** Positions */
+            positions: string[];
+        };
+        /**
+         * LocoSeriesPositionOut
+         * @description One binding as the admin visualization draws it.
+         */
+        LocoSeriesPositionOut: {
+            /** Loco Series */
+            loco_series: string;
+            /**
+             * Nomenclature Id
+             * Format: uuid
+             */
+            nomenclature_id: string;
+            /** Code */
+            code: string;
+            /** Name */
+            name: string;
+            /** Positions */
+            positions: string[];
+        };
+        /**
+         * LocoSeriesPositionRef
+         * @description One binding: what positions a part type has on ONE series.
+         *
+         *     Overrides NomenclatureRef.positions for that series only. A type with no
+         *     row here keeps the global list, so this dictionary is usually short and a
+         *     depot that never needs per-series lists syncs an empty one.
+         */
+        LocoSeriesPositionRef: {
+            /** Loco Series */
+            loco_series: string;
+            /**
+             * Nomenclature Id
+             * Format: uuid
+             */
+            nomenclature_id: string;
+            /**
+             * Positions
+             * @default []
+             */
+            positions: string[];
+        };
         /**
          * LocoUnitCard
          * @description Machine card header = the registry row plus the card-only honesty bits.
@@ -13607,6 +13737,115 @@ export interface operations {
             };
         };
     };
+    list_series_positions_api_v1_admin_refs_loco_series__code__positions_get: {
+        parameters: {
+            query?: never;
+            header?: {
+                "x-debug-person-id"?: string | null;
+            };
+            path: {
+                code: string;
+            };
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LocoSeriesPositionOut"][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    bind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__put: {
+        parameters: {
+            query?: never;
+            header?: {
+                "x-debug-person-id"?: string | null;
+            };
+            path: {
+                code: string;
+                nomenclature_id: string;
+            };
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LocoSeriesPositionIn"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LocoSeriesPositionOut"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    unbind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__delete: {
+        parameters: {
+            query?: never;
+            header?: {
+                "x-debug-person-id"?: string | null;
+            };
+            path: {
+                code: string;
+                nomenclature_id: string;
+            };
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_entity_api_v1_admin_refs__entity__get: {
         parameters: {
             query?: never;
@@ -17418,6 +17657,40 @@ export interface operations {
             };
         };
     };
+    loco_series_positions_api_v1_refs_loco_series_positions_get: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+                "x-debug-person-id"?: string | null;
+            };
+            path?: never;
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LocoSeriesPositionRef"][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     nomenclature_api_v1_refs_nomenclature_get: {
         parameters: {
             query?: {