@evergis/react 4.0.64 → 4.0.66

package/dist/components/Dashboard/hooks/index.d.ts

@@ -10,8 +10,13 @@ export * from './useChartData';
 export * from './useDashboardHeader';
 export * from './useDataSources';
 export * from './useDiffPage';
+export * from './useAfterSave';
+export * from './useBeforeSave';
 export * from './useExpandableContainers';
 export * from './useExportPdf';
+export * from './useFeatureSaveHooks';
+export * from './useFeatureSaveHooks.utils';
+export * from './useSavePrototypeBuilder';
 export * from './useWidgetFilters';
 export * from './useGetConfigLayer';
 export * from './useGlobalContext';

package/dist/components/Dashboard/hooks/useAfterSave.d.ts

@@ -0,0 +1,3 @@
+import { TaskPrototypeDto } from '@evergis/api';
+import { ConfigRelatedResource, SaveHookInput } from '../types';
+export declare const useAfterSave: (hook: ConfigRelatedResource | undefined, buildPrototype: (hook: ConfigRelatedResource, input: SaveHookInput) => TaskPrototypeDto) => (input: SaveHookInput) => Promise<void>;

package/dist/components/Dashboard/hooks/useBeforeSave.d.ts

@@ -0,0 +1,3 @@
+import { TaskPrototypeDto } from '@evergis/api';
+import { ConfigRelatedResource, SaveHookInput } from '../types';
+export declare const useBeforeSave: (hook: ConfigRelatedResource | undefined, buildPrototype: (hook: ConfigRelatedResource, input: SaveHookInput) => TaskPrototypeDto) => (input: SaveHookInput) => Promise<boolean>;

package/dist/components/Dashboard/hooks/useFeatureSaveHooks.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Орchestrator-хук для серверных `beforeSave` / `afterSave` python-скриптов,
+ * описанных в `layerInfo.configuration.editConfiguration.options` слоя.
+ *
+ * - `runBeforeSave(input)` — `Promise<boolean>`, resolves `false` если
+ *   серверная проверка не прошла; сохранение должно быть отменено.
+ * - `runAfterSave(input)` — fire-and-forget после успешного save.
+ *
+ * Активируется только если у потребителя в GlobalProvider переданы
+ * `api`, `notification` и `t`, а приложение обёрнуто в
+ * `<ServerNotificationsProvider>` (для SignalR-подписки на прогресс).
+ */
+export declare const useFeatureSaveHooks: () => {
+    readonly runBeforeSave: (input: import('../types').SaveHookInput) => Promise<boolean>;
+    readonly runAfterSave: (input: import('../types').SaveHookInput) => Promise<void>;
+};

package/dist/components/Dashboard/hooks/useFeatureSaveHooks.utils.d.ts

@@ -0,0 +1,4 @@
+import { ConfigRelatedResource } from '../types';
+export declare const SAVE_HOOK_RESULT_DURATION = 4000;
+export declare const isHookActive: (hook?: ConfigRelatedResource) => hook is ConfigRelatedResource;
+export declare const createSaveNotificationId: () => string;

package/dist/components/Dashboard/hooks/useSavePrototypeBuilder.d.ts

@@ -0,0 +1,3 @@
+import { TaskPrototypeDto } from '@evergis/api';
+import { ConfigRelatedResource, SaveHookInput } from '../types';
+export declare const useSavePrototypeBuilder: () => (hook: ConfigRelatedResource, input: SaveHookInput) => TaskPrototypeDto;

package/dist/components/Dashboard/types.d.ts

@@ -59,6 +59,28 @@ export interface ConfigRelatedResource {
     fileName?: string;
     methodName?: string;
 }
+/**
+ * Конфигурация `editConfiguration.options` слоя. Описывает серверные
+ * python-скрипты, выполняемые до и после сохранения объекта в FeatureCard.
+ *
+ * - `beforeSave` — синхронная серверная валидация перед сохранением.
+ *   Save ждёт `Completed`; при `Error` сохранение отменяется.
+ * - `afterSave` — fire-and-forget действие после успешного сохранения.
+ *
+ * Используется хуком `useFeatureSaveHooks`.
+ */
+export interface EditConfigurationOptions {
+    beforeSave?: ConfigRelatedResource;
+    afterSave?: ConfigRelatedResource;
+}
+/**
+ * Вход для `runBeforeSave` / `runAfterSave` хуков `useFeatureSaveHooks`.
+ * `featureId` равен `null` при создании нового объекта.
+ */
+export interface SaveHookInput {
+    featureId: number | string | null;
+    changedProperties: Record<string, unknown>;
+}
 export interface ConfigControl extends Pick<ConfigOptions, "relatedDataSource" | "minValue" | "maxValue" | "step" | "label" | "placeholder" | "width" | "variants"> {
     type: "dropdown" | "checkbox" | "chips" | "string";
     attributeName?: string;

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

@@ -1,4 +1,5 @@
 export * from './constants';
 export * from './usePythonTask';
 export * from './usePythonSandbox';
+export * from './useRemoteTask';
 export * from './types';

package/dist/hooks/task/useRemoteTask.d.ts

@@ -0,0 +1,16 @@
+import { RemoteTaskStatus, TaskPrototypeDto } from '@evergis/api';
+export interface RemoteTaskUpdate {
+    status: RemoteTaskStatus;
+    log?: string;
+}
+export interface RemoteTaskResult {
+    taskId: string;
+    status: RemoteTaskStatus.Completed | RemoteTaskStatus.Error;
+    log?: string;
+}
+export interface UseRemoteTaskOptions {
+    onUpdate?: (update: RemoteTaskUpdate) => void;
+}
+export declare const useRemoteTask: ({ onUpdate }?: UseRemoteTaskOptions) => {
+    runTask: (prototype: TaskPrototypeDto) => Promise<RemoteTaskResult>;
+};