@boxa-devops/depo-shared 1.0.5 → 1.1.0

package/src/api.ts

@@ -963,6 +963,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;
@@ -2876,6 +2927,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;
@@ -7478,6 +7553,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.
@@ -13608,6 +13738,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;
@@ -17419,6 +17658,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?: {