@acmekit/dashboard 2.13.33 → 2.13.35

package/src/hooks/api/workflow-executions.tsx

@@ -1,5 +1,12 @@
-import { QueryKey, UseQueryOptions, useQuery } from "@tanstack/react-query"
+import {
+  QueryKey,
+  UseMutationOptions,
+  UseQueryOptions,
+  useMutation,
+  useQuery,
+} from "@tanstack/react-query"
 import { sdk } from "../../lib/client"
+import { queryClient } from "../../lib/query-client"
 import { queryKeysFactory } from "../../lib/query-key-factory"
 import { HttpTypes } from "@acmekit/types"
 import { FetchError } from "@acmekit/js-sdk"
@@ -50,3 +57,140 @@ export const useWorkflowExecution = (
 
   return { ...data, ...rest }
 }
+
+export const useRunWorkflow = (
+  workflowId: string,
+  options?: UseMutationOptions<
+    Record<string, unknown>,
+    FetchError,
+    { input?: Record<string, unknown>; transaction_id?: string }
+  >
+) => {
+  return useMutation({
+    mutationFn: (payload) =>
+      sdk.admin.workflowExecution.run(workflowId, payload),
+    onSuccess: (data, variables, context) => {
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.lists(),
+      })
+      options?.onSuccess?.(data, variables, context)
+    },
+    ...options,
+  })
+}
+
+export const useCancelWorkflowExecution = (
+  workflowId: string,
+  transactionId: string,
+  options?: UseMutationOptions<
+    Record<string, unknown>,
+    FetchError,
+    { reason?: string } | void
+  >
+) => {
+  return useMutation({
+    mutationFn: (payload) =>
+      sdk.admin.workflowExecution.cancel(
+        workflowId,
+        transactionId,
+        (payload as { reason?: string }) || {}
+      ),
+    onSuccess: (data, variables, context) => {
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.lists(),
+      })
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.details(),
+      })
+      options?.onSuccess?.(data, variables, context)
+    },
+    ...options,
+  })
+}
+
+export const useRetryStep = (
+  workflowId: string,
+  transactionId: string,
+  options?: UseMutationOptions<
+    Record<string, unknown>,
+    FetchError,
+    { step_id: string; action?: string }
+  >
+) => {
+  return useMutation({
+    mutationFn: (payload) =>
+      sdk.admin.workflowExecution.retryStep(
+        workflowId,
+        transactionId,
+        payload
+      ),
+    onSuccess: (data, variables, context) => {
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.lists(),
+      })
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.details(),
+      })
+      options?.onSuccess?.(data, variables, context)
+    },
+    ...options,
+  })
+}
+
+export const useSetStepSuccess = (
+  workflowId: string,
+  options?: UseMutationOptions<
+    Record<string, unknown>,
+    FetchError,
+    {
+      transaction_id: string
+      step_id: string
+      response?: Record<string, unknown>
+      action?: string
+    }
+  >
+) => {
+  return useMutation({
+    mutationFn: (payload) =>
+      sdk.admin.workflowExecution.setStepSuccess(workflowId, payload),
+    onSuccess: (data, variables, context) => {
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.lists(),
+      })
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.details(),
+      })
+      options?.onSuccess?.(data, variables, context)
+    },
+    ...options,
+  })
+}
+
+export const useSetStepFailure = (
+  workflowId: string,
+  options?: UseMutationOptions<
+    Record<string, unknown>,
+    FetchError,
+    {
+      transaction_id: string
+      step_id: string
+      response?: Record<string, unknown>
+      action?: string
+    }
+  >
+) => {
+  return useMutation({
+    mutationFn: (payload) =>
+      sdk.admin.workflowExecution.setStepFailure(workflowId, payload),
+    onSuccess: (data, variables, context) => {
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.lists(),
+      })
+      queryClient.invalidateQueries({
+        queryKey: workflowExecutionsQueryKeys.details(),
+      })
+      options?.onSuccess?.(data, variables, context)
+    },
+    ...options,
+  })
+}

package/src/hooks/api/workflow-metrics.tsx

@@ -0,0 +1,48 @@
+import { QueryKey, UseQueryOptions, useQuery } from "@tanstack/react-query"
+import { sdk } from "../../lib/client"
+import { queryKeysFactory } from "../../lib/query-key-factory"
+import { FetchError } from "@acmekit/js-sdk"
+
+export type WorkflowMetricsResponse = {
+  total_24h: number
+  success_rate_24h: number
+  avg_duration_ms_24h: number
+  running_now: number
+  per_workflow: Array<{
+    workflow_id: string
+    runs: number
+    success_rate: number
+    avg_duration_ms: number
+  }>
+}
+
+const WORKFLOW_METRICS_QUERY_KEY = "workflow_metrics" as const
+export const workflowMetricsQueryKeys = queryKeysFactory(
+  WORKFLOW_METRICS_QUERY_KEY
+)
+
+export const useWorkflowMetrics = (
+  options?: Omit<
+    UseQueryOptions<
+      WorkflowMetricsResponse,
+      FetchError,
+      WorkflowMetricsResponse,
+      QueryKey
+    >,
+    "queryKey" | "queryFn"
+  >
+) => {
+  const { data, ...rest } = useQuery({
+    queryFn: async () => {
+      const result = await sdk.client.fetch<WorkflowMetricsResponse>(
+        "/admin/workflows-executions/metrics"
+      )
+      return result as unknown as WorkflowMetricsResponse
+    },
+    queryKey: workflowMetricsQueryKeys.all,
+    refetchInterval: 30000,
+    ...options,
+  })
+
+  return { ...data, ...rest }
+}

package/src/hooks/use-workflow-sse.tsx

@@ -0,0 +1,78 @@
+import { useEffect, useRef, useState } from "react"
+import { backendUrl } from "../lib/client"
+
+export interface WorkflowSSEEvent {
+  event_type: string
+  workflow_id: string
+  transaction_id: string
+  step?: Record<string, unknown>
+  response?: Record<string, unknown>
+  result?: Record<string, unknown>
+  errors?: Array<Record<string, unknown>>
+}
+
+interface UseWorkflowSSEOptions {
+  enabled?: boolean
+  onEvent?: (event: WorkflowSSEEvent) => void
+}
+
+export const useWorkflowSSE = (
+  workflowId: string | undefined,
+  options?: UseWorkflowSSEOptions
+) => {
+  const { enabled = true, onEvent } = options || {}
+  const [isConnected, setIsConnected] = useState(false)
+  const eventSourceRef = useRef<EventSource | null>(null)
+  const onEventRef = useRef(onEvent)
+  onEventRef.current = onEvent
+
+  useEffect(() => {
+    if (!enabled || !workflowId) {
+      if (eventSourceRef.current) {
+        eventSourceRef.current.close()
+        eventSourceRef.current = null
+        setIsConnected(false)
+      }
+      return
+    }
+
+    const base = backendUrl === "/" ? "" : backendUrl
+    const url = `${base}/admin/workflows-executions/${workflowId}/subscribe`
+
+    const es = new EventSource(url, { withCredentials: true })
+    eventSourceRef.current = es
+
+    es.onopen = () => {
+      setIsConnected(true)
+    }
+
+    es.onmessage = (e) => {
+      try {
+        const data = JSON.parse(e.data) as WorkflowSSEEvent
+        onEventRef.current?.(data)
+      } catch {
+        // ignore parse errors
+      }
+    }
+
+    es.onerror = () => {
+      setIsConnected(false)
+    }
+
+    return () => {
+      es.close()
+      eventSourceRef.current = null
+      setIsConnected(false)
+    }
+  }, [enabled, workflowId])
+
+  const disconnect = () => {
+    if (eventSourceRef.current) {
+      eventSourceRef.current.close()
+      eventSourceRef.current = null
+      setIsConnected(false)
+    }
+  }
+
+  return { isConnected, disconnect }
+}