@nar-bus/ui-shared 1.22.0 → 2.1.0

package/dist/components/order-forms/AstroConfigForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AstroConfigForm.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/AstroConfigForm.tsx"],"names":[],"mappings":"AA2CA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,+BA+K/D"}
+{"version":3,"file":"AstroConfigForm.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/AstroConfigForm.tsx"],"names":[],"mappings":"AAyCA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,+BAuK/D"}

package/dist/components/order-forms/DirectiveForms.d.ts

@@ -1,12 +1,25 @@
 interface FormProps {
     params: Record<string, string>;
-    onChange: (key: string, value: string) => void;
+    /** `undefined` removes the key from the payload (see OrderCreateSheet `handleParamChange`). */
+    onChange: (key: string, value: string | undefined) => void;
+    /**
+     * Directive picker options. OPTIONAL override — when omitted the form loads
+     * the directive catalogue itself (see `useDirectiveOptions`). `value` is the
+     * directive's `name` — the id the gateway knows it by.
+     */
     directiveOptions?: Array<{
         value: string;
         label: string;
     }>;
 }
-/** DirectiveQueryForm — select directive to query */
+/**
+ * DirectiveQueryForm — list the directives on the gateway, all or one.
+ *
+ * Wire: `{operation: "list"}` for "Tümü" (no `filter` — an empty filter's
+ * meaning is not specified), `{operation: "list", filter: {"id": name}}` for one
+ * directive. `operation` is what the handler sends anyway; it is also what makes
+ * "Tümü" a filled form (the sheet enables submit on a non-empty param).
+ */
 export declare function DirectiveQueryForm({ params, onChange, directiveOptions }: FormProps): import("react").JSX.Element;
 /** DirectiveChangeForm — multi-select directives to push to modem (FIX-166/FIX-168) */
 export declare function DirectiveChangeForm({ params, onChange }: FormProps): import("react").JSX.Element;

package/dist/components/order-forms/DirectiveForms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectiveForms.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/DirectiveForms.tsx"],"names":[],"mappings":"AAQA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAqB,EAAE,EAAE,SAAS,+BAexF;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,+BAiFlE;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAqB,EAAE,EAAE,SAAS,+BA+B1F"}
+{"version":3,"file":"DirectiveForms.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/DirectiveForms.tsx"],"names":[],"mappings":"AAQA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+FAA+F;IAC/F,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3D;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAgGD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,SAAS,+BAqBnF;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,+BA2ElE;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,SAAS,+BAmCrF"}

package/dist/components/order-forms/FirmwareUpdateForm.d.ts

@@ -1,11 +1,19 @@
 interface FormProps {
     params: Record<string, string>;
-    onChange: (key: string, value: string) => void;
+    /** `undefined` removes the key from the payload (see OrderCreateSheet `handleParamChange`). */
+    onChange: (key: string, value: string | undefined) => void;
+    /**
+     * Firmware picker options. OPTIONAL override — when omitted the form loads the
+     * packages for the modem's brand/model itself (see `useFirmwareOptions`).
+     * `value` is the firmware's `versionName`; it becomes the `versionName` param.
+     */
     firmwareOptions?: Array<{
         value: string;
         label: string;
     }>;
+    /** Modem whose brand/model selects the packages. Ignored when `firmwareOptions` is supplied. */
+    modemId?: number;
 }
-export declare function FirmwareUpdateForm({ params, onChange, firmwareOptions }: FormProps): import("react").JSX.Element;
+export declare function FirmwareUpdateForm({ params, onChange, firmwareOptions, modemId }: FormProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=FirmwareUpdateForm.d.ts.map

package/dist/components/order-forms/FirmwareUpdateForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FirmwareUpdateForm.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/FirmwareUpdateForm.tsx"],"names":[],"mappings":"AAGA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAoB,EAAE,EAAE,SAAS,+BAcvF"}
+{"version":3,"file":"FirmwareUpdateForm.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/FirmwareUpdateForm.tsx"],"names":[],"mappings":"AASA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+FAA+F;IAC/F,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3D;;;;OAIG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiFD,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,SAAS,+BA6C3F"}

package/dist/components/order-forms/modemDetailQuery.d.ts

@@ -0,0 +1,17 @@
+import { ModemDetail } from '../../types/modem.types';
+/**
+ * The modem detail query the order forms share (Astro: location + astroDefaults;
+ * Firmware: brand/model for the package list).
+ *
+ * ONE definition on purpose: both forms read the same cache entry
+ * (`queryKeys.modems.detail`), so they must agree on the cached shape — a
+ * second, slightly different queryFn under the same key would hand one form the
+ * other's data.
+ */
+export declare function modemDetailQuery(modemId: number | undefined): {
+    queryKey: readonly ["modems", "detail", number];
+    queryFn: () => Promise<ModemDetail | null>;
+    staleTime: number;
+    enabled: boolean;
+};
+//# sourceMappingURL=modemDetailQuery.d.ts.map

package/dist/components/order-forms/modemDetailQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modemDetailQuery.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/modemDetailQuery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;;mBAGrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;;;EAOjD"}

package/dist/hooks/index.d.ts

@@ -7,7 +7,7 @@ export { useSSE, setSSEDefaultMode } from './useSSE';
 export type { SSEConnectionState, SSEOptions, SSEMode, SSEModeOption } from './useSSE';
 export { useNotifications } from './useNotifications';
 export type { UseNotificationsReturn } from './useNotifications';
-export { useEnumValues } from './useEnumValues';
+export { useEnumValues, fetchEnumValues, enumValuesQueryOptions } from './useEnumValues';
 export type { EnumOption, UseEnumValuesReturn } from './useEnumValues';
 export { useOrderDetail } from './useOrderDetail';
 export type { UseOrderDetailOptions } from './useOrderDetail';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/useEnumValues.d.ts

@@ -1,6 +1,21 @@
 export interface EnumOption {
     value: string;
     label: string;
+    /**
+     * NB-ENUM-EN-01 — the English display label: the catalogue's `enumValueEn` when
+     * the value has one, otherwise `label` — so it is never blank. In an English UI
+     * show `option.labelEn` instead of `option.label`.
+     *
+     * Optional in the type only because consumers build `EnumOption`s themselves
+     * (tests, mocks, their own cache warm-up); `useEnumValues` always fills it.
+     */
+    labelEn?: string;
+    /**
+     * NB-ENUM-EN-01 — the English label exactly as the catalogue stores it, `null`
+     * when the value has no translation. Read it when an untranslated value should
+     * fall back to something other than the Turkish `label` (e.g. a humanized key).
+     */
+    enumValueEn?: string | null;
     /**
      * NB-ENUMOPT-RELKEY-01 — the backend `EnumValueResponse.relationKey` classifies
      * an option (e.g. `FIELD_OPERATION_TITLE` values carry `relationKey="MODEM"`).
@@ -10,15 +25,65 @@ export interface EnumOption {
     relationKey?: string | null;
 }
 export interface UseEnumValuesReturn {
+    /** The catalogue, sorted by `sortOrder`. `[]` while loading and after a failed fetch — see `isError`. */
     options: EnumOption[];
     isLoading: boolean;
+    /**
+     * True when the last fetch failed (server error envelope or transport error) and
+     * there is no catalogue to show. Lets a mandatory picker say "could not load"
+     * instead of looking like an empty catalogue. Cleared by the next successful fetch.
+     *
+     * Optional in the type only because consumers declare `UseEnumValuesReturn` on their
+     * own wrappers and mocks; `useEnumValues` always fills it.
+     */
+    isError?: boolean;
 }
+/**
+ * Fetches one enum catalogue and maps it to `EnumOption`s, sorted by `sortOrder`.
+ *
+ * An error envelope REJECTS instead of resolving to `[]`. The API client reports a
+ * failed request as `{ status: "error" }` rather than throwing; resolving that to an
+ * empty list made TanStack cache "this catalogue has no values" as a SUCCESS for the
+ * full stale time, so a mandatory picker stayed empty for five minutes after a
+ * transient error, even once the server had recovered. Rejecting lets the query's
+ * retry/error semantics run and leaves nothing in the cache, so the next mount or
+ * refetch asks the server again. (HES fixed the same bug in its own prefetch copy,
+ * FIX-817 — this is the package-side root fix.)
+ *
+ * The rejection value is the envelope's `ApiError` (`{ code, … }`), or
+ * `{ code: "UNKNOWN_ERROR" }` when the envelope carries none.
+ */
+export declare function fetchEnumValues(enumCode: string): Promise<EnumOption[]>;
+/**
+ * The exact query `useEnumValues` runs — key, fetch and stale time — for a consumer
+ * that warms the cache ahead of time:
+ *
+ * ```ts
+ * void queryClient.prefetchQuery(enumValuesQueryOptions("ORDER_STATUS"));
+ * ```
+ *
+ * A prefetch built from this writes what the hook would write (same `EnumOption`
+ * shape, `labelEn` included) and follows the same error rule: a failed prefetch
+ * caches nothing, so the hook fetches on demand instead of serving a cached `[]`.
+ */
+export declare function enumValuesQueryOptions(enumCode: string): {
+    queryKey: readonly ["enums", "values", string];
+    queryFn: () => Promise<EnumOption[]>;
+    staleTime: number;
+};
 /**
  * Fetches enum values from the management API for a given enum definition code.
  * Uses TanStack Query with 5-minute stale time for caching.
  *
+ * Each option carries the Turkish `label` and the English `labelEn` (NB-ENUM-EN-01);
+ * the hook does not pick one for you — `label` stays what it always was.
+ *
+ * A failed fetch is an error, not an empty catalogue: `options` is `[]` and
+ * `isError` is true, and nothing is cached, so the next mount refetches (see
+ * `fetchEnumValues`). Retries follow the app's QueryClient defaults.
+ *
  * @param enumCode — The enum definition code (e.g. "LIFECYCLE_STATUS", "PHASE_TYPE")
- * @returns { options, isLoading } — SelectOption-compatible array
+ * @returns { options, isLoading, isError } — SelectOption-compatible array
  */
 export declare function useEnumValues(enumCode: string): UseEnumValuesReturn;
 //# sourceMappingURL=useEnumValues.d.ts.map

package/dist/hooks/useEnumValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEnumValues.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnumValues.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAwBnE"}
+{"version":3,"file":"useEnumValues.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnumValues.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,yGAAyG;IACzG,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA+CD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAW7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM;;;;EAMtD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAanE"}