@svadmin/core 0.0.6 → 0.4.1

package/src/hook-utils.svelte.ts

@@ -0,0 +1,121 @@
+// Hook Utilities — shared reactive helpers for all hooks
+// Uses Svelte 5 runes ($state, $effect) for automatic lifecycle management
+
+import { useQueryClient } from '@tanstack/svelte-query';
+import type { LiveProvider, LiveEvent, LiveMode } from './live';
+import { toast } from './toast.svelte';
+
+// ─── Overtime Tracker ───────────────────────────────────────────
+// Tracks elapsed time during loading, auto-cleans via $effect
+
+export interface OvertimeOptions {
+  interval?: number; // ms, default 1000
+  onInterval?: (elapsedTime: number) => void;
+}
+
+export interface OvertimeResult {
+  readonly elapsedTime: number;
+}
+
+export function createOvertimeTracker(
+  isLoadingFn: () => boolean,
+  options: OvertimeOptions = {},
+): OvertimeResult {
+  const { interval = 1000, onInterval } = options;
+  let elapsedTime = $state(0);
+
+  $effect(() => {
+    if (isLoadingFn()) {
+      elapsedTime = 0;
+      const timer = setInterval(() => {
+        elapsedTime += interval;
+        onInterval?.(elapsedTime);
+      }, interval);
+      return () => clearInterval(timer);
+    } else {
+      elapsedTime = 0;
+    }
+  });
+
+  return {
+    get elapsedTime() { return elapsedTime; },
+  };
+}
+
+// ─── Live Subscription ──────────────────────────────────────────
+// Auto-subscribes to realtime events, invalidates queries on 'auto' mode
+
+export interface LiveSubscriptionParams {
+  resource: string;
+  liveProvider?: LiveProvider;
+  liveMode?: LiveMode;
+  onLiveEvent?: (event: LiveEvent) => void;
+  liveParams?: Record<string, unknown>;
+  enabled?: boolean;
+}
+
+export function createLiveSubscription(params: LiveSubscriptionParams): void {
+  const {
+    resource,
+    liveProvider,
+    liveMode = 'off',
+    onLiveEvent,
+    enabled = true,
+  } = params;
+
+  if (!liveProvider || liveMode === 'off' || !enabled) return;
+
+  const queryClient = useQueryClient();
+
+  $effect(() => {
+    const unsubscribe = liveProvider.subscribe({
+      resource,
+      callback: (event: LiveEvent) => {
+        onLiveEvent?.(event);
+        if (liveMode === 'auto') {
+          queryClient.invalidateQueries({ queryKey: [resource] });
+        }
+      },
+    });
+    return unsubscribe;
+  });
+}
+
+// ─── Notification Helpers ───────────────────────────────────────
+
+export type NotificationConfig =
+  | string
+  | false
+  | ((data?: unknown, values?: unknown, resource?: string) => { message: string; description?: string; type?: 'success' | 'error' })
+  | undefined;
+
+export function fireSuccessNotification(
+  config: NotificationConfig,
+  defaultMessage: string,
+  data?: unknown,
+  values?: unknown,
+  resource?: string,
+): void {
+  if (config === false) return;
+  if (typeof config === 'function') {
+    const result = config(data, values, resource);
+    toast.success(result.message);
+    return;
+  }
+  toast.success(config || defaultMessage);
+}
+
+export function fireErrorNotification(
+  config: NotificationConfig,
+  defaultMessage: string,
+  error?: unknown,
+): void {
+  if (config === false) return;
+  if (typeof config === 'function') {
+    const result = config(error);
+    toast.error(result.message);
+    return;
+  }
+  const errMsg = error instanceof Error ? error.message : String(error ?? '');
+  toast.error(config || `${defaultMessage}${errMsg ? ': ' + errMsg : ''}`);
+}