@svadmin/core 0.21.0 → 0.21.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/core",
-  "version": "0.21.0",
+  "version": "0.21.2",
   "author": "zuohuadong",
   "repository": {
     "type": "git",

package/src/auth-hooks.svelte.ts

@@ -123,7 +123,9 @@ export function useGetIdentity() {
     });
   }
 
-  fetch();
+  if (typeof window !== 'undefined') {
+    fetch();
+  }
 
   return {
     get data() { return data; },
@@ -141,13 +143,19 @@ export function useIsAuthenticated() {
   let isLoading = $state(true);
 
   if (provider) {
-    provider.check().then((result: CheckResult) => {
-      isAuthenticated = result.authenticated;
-      isLoading = false;
-    }).catch(() => {
+    if (typeof window !== 'undefined') {
+      provider.check().then((result: CheckResult) => {
+        isAuthenticated = result.authenticated;
+        isLoading = false;
+      }).catch(() => {
+        isAuthenticated = false;
+        isLoading = false;
+      });
+    } else {
+      // In SSR we assume false to prevent hydration mismatch before check
       isAuthenticated = false;
       isLoading = false;
-    });
+    }
   } else {
     // No auth provider — treat as authenticated
     isAuthenticated = true;
@@ -230,7 +238,9 @@ export function usePermissions<T = unknown>() {
     });
   }
 
-  fetch();
+  if (typeof window !== 'undefined') {
+    fetch();
+  }
 
   return {
     get isLoading() { return isLoading; },

package/src/context.svelte.ts

@@ -72,8 +72,10 @@ export function setAuthProvider(provider: AuthProvider): void {
   authProvider = provider;
 }
 
-export function getAuthProvider(): AuthProvider {
-  if (!authProvider) throw new Error('AuthProvider not found. Did you call setAuthProvider in App.svelte?');
+export function getAuthProvider(): AuthProvider;
+export function getAuthProvider(options: { optional: true }): AuthProvider | null;
+export function getAuthProvider(options?: { optional?: boolean }): AuthProvider | null {
+  if (!authProvider && !options?.optional) throw new Error('AuthProvider not found. Did you call setAuthProvider in App.svelte?');
   return authProvider;
 }
 

package/src/data-transfer.svelte.ts

@@ -21,7 +21,7 @@ export interface UseExportOptions<TData extends BaseRecord = BaseRecord> {
  */
 export function useExport<TData extends BaseRecord = BaseRecord>(options: UseExportOptions<TData> = {}) {
   const parsed = useParsed();
-  const resource = options.resource ?? parsed.resource ?? '';
+  const resource = $derived(options.resource ?? parsed.resource ?? '');
   let isLoading = $state(false);
 
   async function triggerExport() {
@@ -55,7 +55,7 @@ export function useExport<TData extends BaseRecord = BaseRecord>(options: UseExp
         ? allRecords.map(options.mapData)
         : allRecords.map(r => r as unknown as Record<string, unknown>);
 
-      if (options.download !== false) {
+      if (options.download !== false && typeof document !== 'undefined') {
         const fields = Object.keys(mapped[0]);
         const header = fields.join(',');
         const rows = mapped.map(record =>
@@ -109,7 +109,7 @@ export interface UseImportOptions<TData = Record<string, unknown>> {
  */
 export function useImport<TData = Record<string, unknown>>(options: UseImportOptions<TData> = {}) {
   const parsed = useParsed();
-  const resource = options.resource ?? parsed.resource ?? '';
+  const resource = $derived(options.resource ?? parsed.resource ?? '');
   let isLoading = $state(false);
   let mutationResult = $state<{ succeeded: unknown[]; errored: { request: unknown; error: unknown }[] } | null>(null);
 

package/src/form-hooks.svelte.ts

@@ -1,12 +1,12 @@
 import { useQueryClient } from '@tanstack/svelte-query';
 import { useParsed } from './useParsed.svelte';
 import { getAdminOptions } from './options.svelte';
-import { getDataProviderForResource } from './context.svelte';
+import { getDataProviderForResource, getResource } from './context.svelte';
 import { createQuery, createMutation } from '@tanstack/svelte-query';
 import { notify } from './notification.svelte';
 import { t } from './i18n.svelte';
 import { audit } from './audit';
-import { navigate } from './router';
+import { navigate, currentPath } from './router';
 import { HttpError } from './types';
 import type { BaseRecord, MutationMode, KnownResources } from './types';
 
@@ -110,14 +110,16 @@ export interface UseFormReturn<
   /** Reset form to initial/query values. Clears tainted and errors. */
   reset: () => void;
 
-  // ─── State ────────────────────────────────────────────────────
+  // ─── State ──────────────────────────────────────────────────────
   readonly loading: boolean;
   readonly submitting: boolean;
-  readonly resource: string;
   readonly action: 'create' | 'edit' | 'clone';
+  readonly resource: string;
   readonly id: string | number | undefined;
-  setId: (newId: string | number) => void;
-  readonly mutationMode: MutationMode;
+  readonly isDirty: boolean;
+  setId: (id: string | number | undefined) => void;
+  setAction: (action: 'create' | 'edit' | 'clone') => void;
+  mutationMode: MutationMode;
   redirect: (to: 'list' | 'edit' | 'show' | false) => void;
 
   // ─── AutoSave ─────────────────────────────────────────────────
@@ -140,12 +142,13 @@ export function useForm<
   const parsed = useParsed();
   const adminOptions = getAdminOptions();
 
-  const resource = options.resource ?? parsed.resource ?? '';
-  const action = options.action ?? (parsed.action === 'list' ? 'create' : parsed.action as 'create' | 'edit' | 'clone') ?? 'create';
+  const resource = $derived(options.resource ?? parsed.resource ?? '');
+  let action = $state<'create' | 'edit' | 'clone'>(options.action ?? (parsed.action === 'list' ? 'create' : parsed.action as 'create' | 'edit' | 'clone') ?? 'create');
   let currentId = $state<string | number | undefined>(options.id ?? parsed.id);
 
+  const defaultRedirectOpt = $derived(action === 'clone' ? adminOptions.redirect?.afterClone : action === 'edit' ? adminOptions.redirect?.afterEdit : adminOptions.redirect?.afterCreate);
   const {
-    redirect: redirectDefault = 'list',
+    redirect: redirectOption,
     successNotification, errorNotification,
     onMutationSuccess, onMutationError,
     meta: hookMeta, queryMeta: hookQueryMeta, mutationMeta: hookMutationMeta,
@@ -158,13 +161,17 @@ export function useForm<
     onChange: onChangeFn,
     onSubmit: onSubmitFn,
   } = options;
+  // Reactive redirect: uses $derived `defaultRedirectOpt` so redirect target
+  // updates when `action` changes at runtime (e.g., via `setAction`).
+  const redirectDefault = $derived(redirectOption ?? defaultRedirectOpt ?? 'list');
 
-  const provider = getDataProviderForResource(resource, dataProviderName);
-  const parsedMeta = typeof window !== 'undefined' ? Object.fromEntries(new URLSearchParams(window.location.search).entries()) : {};
+  const provider = $derived(getDataProviderForResource(resource, dataProviderName));
+  const parsedMeta = useParsed().params || {};
   const queryMeta = { ...parsedMeta, ...hookMeta, ...hookQueryMeta };
   const mutationMeta = { ...parsedMeta, ...hookMeta, ...hookMutationMeta };
 
-  function setId(newId: string | number) { currentId = newId; }
+  function setId(newId: string | number | undefined) { currentId = newId; }
+  function setAction(newAction: 'create' | 'edit' | 'clone') { action = newAction; }
 
   // ─── Form values (single source of truth) ───────────────────────
   let values = $state<TVariables>((options.defaultValues ?? {}) as TVariables);
@@ -252,30 +259,35 @@ export function useForm<
   }
 
   // ─── Query (edit/clone mode) ────────────────────────────────────
-  const query = (action === 'edit' || action === 'clone')
-    ? createQuery(() => ({
-        queryKey: [resource, 'one', currentId],
-        queryFn: async () => {
-          const result = await provider.getOne<BaseRecord>({ resource, id: currentId!, meta: queryMeta });
-          return result.data;
-        },
-        enabled: (queryOptions?.enabled ?? true) && currentId != null,
-        staleTime: queryOptions?.staleTime,
-      }))
-    : null;
+  // Always create the query — use `enabled` to conditionally activate.
+  // This ensures setAction('edit') at runtime will trigger a fetch.
+  const query = createQuery(() => ({
+    queryKey: [resource, 'one', currentId],
+    queryFn: async () => {
+      const result = await provider.getOne<BaseRecord>({ resource, id: currentId!, meta: queryMeta });
+      return result.data;
+    },
+    enabled: (queryOptions?.enabled ?? true) && (action === 'edit' || action === 'clone') && currentId != null,
+    staleTime: queryOptions?.staleTime,
+  }));
 
   // Auto-populate values from query data
-  let queryInitialized = false;
-  if (query) {
+  let queryInitializedId: string | number | undefined = undefined;
+  {
     $effect.pre(() => {
-      if (queryInitialized) return;
+      if (queryInitializedId === currentId) return;
       const data = query.data as Record<string, unknown> | undefined;
-      if (data) {
+      const pk = getResource(resource).primaryKey ?? 'id';
+      if (data && (currentId == null || String(data[pk]) === String(currentId) || !data[pk])) {
+        // In clone mode, strip out identifiers
+        const targetData = action === 'clone' 
+          ? Object.fromEntries(Object.entries(data).filter(([k]) => k !== 'id' && k !== '_id' && k !== pk))
+          : data;
         // Merge: defaultValues < query data
-        const merged = { ...(options.defaultValues ?? {}), ...data } as TVariables;
+        const merged = { ...(options.defaultValues ?? {}), ...targetData } as TVariables;
         values = merged;
         initialValues = { ...merged } as TVariables;
-        queryInitialized = true;
+        queryInitializedId = currentId;
       }
     });
   }
@@ -289,9 +301,14 @@ export function useForm<
     onSuccess: (data: { data: TData }) => {
       if (invalidateScopes !== false) queryClient.invalidateQueries({ queryKey: [resource] });
       if (successNotification !== false) notify({ type: 'success', message: typeof successNotification === 'string' ? successNotification : t('common.createSuccess') });
-      audit({ action: 'create', resource, recordId: String((data.data as Record<string, unknown>).id) });
+      const pk = getResource(resource).primaryKey ?? 'id';
+      audit({ action: 'create', resource, recordId: String((data.data as Record<string, unknown>)[pk]) });
       onMutationSuccess?.(data);
-      if (redirectOverride !== false) doRedirect(redirectOverride ?? redirectDefault);
+      if (redirectOverride !== false) {
+        const newId = (data.data as Record<string, unknown>)[pk];
+        if (newId != null) currentId = newId as string | number;
+        doRedirect(redirectOverride ?? redirectDefault);
+      }
     },
     onError: (error: Error) => { handleHttpError(error); onMutationError?.(error); },
   }));
@@ -310,9 +327,14 @@ export function useForm<
   }));
 
   function doRedirect(to: 'list' | 'edit' | 'show' | false) {
-    if (to === 'list') navigate(`/${resource}`);
-    else if (to === 'edit' && currentId) navigate(`/${resource}/edit/${currentId}`);
-    else if (to === 'show' && currentId) navigate(`/${resource}/show/${currentId}`);
+    const path = currentPath().split('?')[0];
+    const parts = path.split('/');
+    const resIdx = parts.lastIndexOf(String(resource));
+    const base = resIdx >= 0 ? parts.slice(0, resIdx + 1).join('/') : `/${resource}`;
+
+    if (to === 'list') navigate(base);
+    else if (to === 'edit' && currentId) navigate(`${base}/edit/${currentId}`);
+    else if (to === 'show' && currentId) navigate(`${base}/show/${currentId}`);
   }
 
   // ─── Submit ─────────────────────────────────────────────────────
@@ -344,7 +366,8 @@ export function useForm<
   let lastAutoSaveError = $state<unknown>(null);
 
   function triggerAutoSave() {
-    if (!autoSaveOpts?.enabled || action === 'create') return;
+    const currentAction = action; // read $state reactively at call time
+    if (!autoSaveOpts?.enabled || currentAction === 'create' || currentAction === 'clone') return;
     if (autoSaveTimer) clearTimeout(autoSaveTimer);
 
     autoSaveTimer = setTimeout(async () => {
@@ -410,11 +433,16 @@ export function useForm<
     reset,
 
     // State
-    get loading() { return query?.isLoading ?? false; },
+    get loading() { return query.isLoading ?? false; },
     get submitting() { return createMut.isPending || updateMut.isPending; },
-    resource, action,
+    get action() { return action; },
+    get resource() { return resource; },
     get id() { return currentId; },
-    setId, mutationMode, redirect: doRedirect,
+    get isDirty() { return Object.keys(tainted).length > 0; },
+    setId,
+    setAction,
+    mutationMode,
+    redirect: doRedirect,
 
     // AutoSave
     triggerAutoSave,
@@ -428,6 +456,6 @@ export function useForm<
 
     // Raw escape hatches
     query,
-    mutation: action === 'edit' ? updateMut : createMut,
+    get mutation() { return action === 'edit' ? updateMut : createMut; },
   };
 }

package/src/hook-utils.svelte.ts

@@ -54,26 +54,24 @@ export interface LiveSubscriptionParams {
   enabled?: boolean;
 }
 
-export function createLiveSubscription(params: LiveSubscriptionParams): void {
-  const {
-    resource,
-    liveProvider,
-    liveMode = 'off',
-    onLiveEvent,
-    enabled = true,
-  } = params;
-
-  if (!liveProvider || liveMode === 'off' || !enabled) return;
-
+export function createLiveSubscription(paramsFn: () => LiveSubscriptionParams): void {
   const queryClient = useQueryClient();
 
   $effect(() => {
+    const params = paramsFn();
+    const liveProvider = params.liveProvider;
+    const liveMode = params.liveMode ?? 'off';
+    const enabled = params.enabled ?? true;
+
+    if (!liveProvider || liveMode === 'off' || !enabled) return;
+
     const unsubscribe = liveProvider.subscribe({
-      resource,
+      resource: params.resource,
+      liveParams: params.liveParams,
       callback: (event: LiveEvent) => {
-        onLiveEvent?.(event);
+        params.onLiveEvent?.(event);
         if (liveMode === 'auto') {
-          queryClient.invalidateQueries({ queryKey: [resource] });
+          queryClient.invalidateQueries({ queryKey: [params.resource] });
         }
       },
     });

package/src/hooks.svelte.ts

@@ -54,9 +54,10 @@ export function useInfiniteList<TData extends BaseRecord = BaseRecord, TError =
   const parsed = useParsed();
   const resource = options.resource ?? parsed.resource ?? '';
   const adminOptions = getAdminOptions();
-  const provider = getDataProviderForResource(resource, options.dataProviderName);
 
-  const query = createInfiniteQuery<{ data: TData[]; total: number }, TError>(() => ({
+  const query = createInfiniteQuery<{ data: TData[]; total: number }, TError>(() => {
+    const provider = getDataProviderForResource(resource, options.dataProviderName);
+    return {
     queryKey: [resource, 'infiniteList', options.sorters, options.filters, options.meta],
     queryFn: async ({ pageParam = 1 }) => {
       const result = await provider.getList<TData>({
@@ -76,7 +77,8 @@ export function useInfiniteList<TData extends BaseRecord = BaseRecord, TError =
     },
     enabled: options.queryOptions?.enabled ?? true,
     staleTime: options.queryOptions?.staleTime ?? adminOptions.reactQuery?.staleTime,
-  }));
+    };
+  });
 
   const overtime = createOvertimeTracker(() => query.isLoading, options.overtimeOptions ?? adminOptions.overtime);
 
@@ -108,7 +110,6 @@ export interface UseSelectOptions<TData extends BaseRecord = BaseRecord, TOption
 export function useSelect<TData extends BaseRecord = BaseRecord, TOption = { label: string; value: string | number }>(options: UseSelectOptions<TData, TOption>) {
   const { resource, optionLabel = 'title', optionValue = 'id', sorters, filters, pagination, meta, dataProviderName, onSearch, debounce: debounceMs = 300 } = options;
   const adminOptions = getAdminOptions();
-  const provider = getDataProviderForResource(resource, dataProviderName);
 
   let searchText = $state('');
   let debounceTimer: ReturnType<typeof setTimeout> | null = null;
@@ -122,26 +123,32 @@ export function useSelect<TData extends BaseRecord = BaseRecord, TOption = { lab
 
   const effectivePageSize = options.fetchSize ?? pagination?.pageSize ?? 999;
 
-  const query = createQuery<{ data: TData[]; total: number }>(() => ({
+  const query = createQuery<{ data: TData[]; total: number }>(() => {
+    const provider = getDataProviderForResource(resource, dataProviderName);
+    return {
     queryKey: [resource, 'select', allFilters, sorters, pagination, meta],
     queryFn: () => provider.getList<TData>({ resource, sorters, filters: allFilters, pagination: { current: 1, pageSize: effectivePageSize }, meta }),
     enabled: options.queryOptions?.enabled ?? true,
     staleTime: options.queryOptions?.staleTime ?? adminOptions.reactQuery?.staleTime,
-  }));
+    };
+  });
 
   // Parallel query to ensure default values are always available in options
   const defaultValueIds = options.defaultValue ?? [];
   const defaultValueQuery = defaultValueIds.length > 0
-    ? createQuery<{ data: TData[] }>(() => ({
-        queryKey: [resource, 'select-defaults', defaultValueIds],
-        queryFn: async () => {
-          if (provider.getMany) return provider.getMany<TData>({ resource, ids: defaultValueIds, meta });
-          const results = await Promise.all(defaultValueIds.map(id => provider.getOne<TData>({ resource, id, meta })));
-          return { data: results.map(r => r.data) };
-        },
-        enabled: (options.defaultValueQueryOptions?.enabled ?? true) && defaultValueIds.length > 0,
-        staleTime: options.defaultValueQueryOptions?.staleTime ?? Infinity,
-      }))
+    ? createQuery<{ data: TData[] }>(() => {
+        const provider = getDataProviderForResource(resource, dataProviderName);
+        return {
+          queryKey: [resource, 'select-defaults', defaultValueIds],
+          queryFn: async () => {
+            if (provider.getMany) return provider.getMany<TData>({ resource, ids: defaultValueIds, meta });
+            const results = await Promise.all(defaultValueIds.map(id => provider.getOne<TData>({ resource, id, meta })));
+            return { data: results.map(r => r.data) };
+          },
+          enabled: (options.defaultValueQueryOptions?.enabled ?? true) && defaultValueIds.length > 0,
+          staleTime: options.defaultValueQueryOptions?.staleTime ?? Infinity,
+        };
+      })
     : null;
 
   const selectOptions = $derived.by(() => {
@@ -151,14 +158,14 @@ export function useSelect<TData extends BaseRecord = BaseRecord, TOption = { lab
     const defaultQueryResult = defaultValueQuery as { data: { data: TData[] } | undefined } | null;
     const defaultData: TData[] = defaultQueryResult?.data?.data ?? [];
     const allData: TData[] = [...data];
-    const existingIds = new Set(data.map((d: TData) => String((d as Record<string, unknown>)[typeof optionValue === 'string' ? optionValue : 'id'])));
+    const resolveValue = (item: TData) => typeof optionValue === 'function' ? optionValue(item) : (item as Record<string, unknown>)[optionValue];
+    const existingIds = new Set(data.map((d: TData) => String(resolveValue(d))));
     for (const item of defaultData) {
-      const itemId = String((item as Record<string, unknown>)[typeof optionValue === 'string' ? optionValue : 'id']);
-      if (!existingIds.has(itemId)) allData.push(item);
+      if (!existingIds.has(String(resolveValue(item)))) allData.push(item);
     }
     return allData.map((item: TData) => {
       const label = typeof optionLabel === 'function' ? optionLabel(item) : String((item as Record<string, unknown>)[optionLabel] ?? '');
-      const value = typeof optionValue === 'function' ? optionValue(item) : (item as Record<string, unknown>)[optionValue];
+      const value = resolveValue(item);
       return { label, value } as unknown as TOption;
     });
   });
@@ -199,9 +206,10 @@ export interface UseCustomOptions<TData = unknown, TError = HttpError> {
 
 export function useCustom<TData = unknown, TError = HttpError>(options: UseCustomOptions<TData, TError>) {
   const adminOptions = getAdminOptions();
-  const provider = getDataProvider(options.dataProviderName);
 
-  const query = createQuery<{ data: TData }, TError>(() => ({
+  const query = createQuery<{ data: TData }, TError>(() => {
+    const provider = getDataProvider(options.dataProviderName);
+    return {
     queryKey: ['custom', options.url, options.method, options.config, options.meta],
     queryFn: async () => {
       if (!provider.custom) throw new Error('DataProvider does not support custom method');
@@ -218,7 +226,8 @@ export function useCustom<TData = unknown, TError = HttpError>(options: UseCusto
     },
     enabled: options.queryOptions?.enabled ?? true,
     staleTime: options.queryOptions?.staleTime ?? adminOptions.reactQuery?.staleTime,
-  }));
+    };
+  });
 
   const overtime = createOvertimeTracker(() => query.isLoading, options.overtimeOptions ?? adminOptions.overtime);
 
@@ -228,11 +237,11 @@ export function useCustom<TData = unknown, TError = HttpError>(options: UseCusto
 // ─── useCustomMutation ──────────────────────────────────────────────
 
 export function useCustomMutation<TData = unknown, TError = HttpError, TVariables = unknown>(dataProviderName?: string) {
-  const provider = getDataProvider(dataProviderName);
   const queryClient = useQueryClient();
 
   const mutation = createMutation<{ data: TData }, TError, { url: string; method: 'get' | 'post' | 'put' | 'patch' | 'delete'; values?: TVariables; meta?: Record<string, unknown> }>(() => ({
     mutationFn: async (params) => {
+      const provider = getDataProvider(dataProviderName);
       if (!provider.custom) throw new Error('DataProvider does not support custom method');
       return provider.custom<TData>({ url: params.url, method: params.method, payload: params.values, meta: params.meta });
     },
@@ -328,7 +337,14 @@ export function useInvalidate() {
       queryClient.invalidateQueries();
       return;
     }
-    queryClient.invalidateQueries({ queryKey: [params.resource] });
+    const scopes = params.invalidates || ['resourceAll'];
+    for (const scope of scopes) {
+      if (scope === 'resourceAll') queryClient.invalidateQueries({ queryKey: [params.resource] });
+      else if ((scope === 'detail' || scope === 'one') && params.id) queryClient.invalidateQueries({ queryKey: [params.resource, 'one', params.id] });
+      else if (scope === 'one') queryClient.invalidateQueries({ queryKey: [params.resource, 'one'] });
+      else if (scope === 'list') queryClient.invalidateQueries({ queryKey: [params.resource, 'list'] });
+      else if (scope === 'many') queryClient.invalidateQueries({ queryKey: [params.resource, 'many'] });
+    }
   };
 }
 

package/src/i18n.svelte.ts

@@ -46,6 +46,7 @@ const locales: Record<string, Record<string, string>> = {
     'common.darkMode': '暗色模式',
     'common.lightMode': '亮色模式',
     'common.detail': '详情',
+    'common.show': '查看',
     'common.loadFailed': '加载失败: {message}',
     'common.pageNotFound': '页面未找到',
     'common.error': '出错了',
@@ -283,6 +284,7 @@ const locales: Record<string, Record<string, string>> = {
     'common.darkMode': 'Dark mode',
     'common.lightMode': 'Light mode',
     'common.detail': 'Detail',
+    'common.show': 'Show',
     'common.loadFailed': 'Load failed: {message}',
     'common.pageNotFound': 'Page not found',
     'common.error': 'Something went wrong',
@@ -513,7 +515,7 @@ export function t(key: string, params?: Record<string, string | number>): string
 
   if (params) {
     for (const [k, v] of Object.entries(params)) {
-      text = text.replace(`{${k}}`, String(v));
+      text = text.replaceAll(`{${k}}`, String(v));
     }
   }
   return text;

package/src/index.ts

@@ -5,6 +5,7 @@ export {
   setAuthProvider, getAuthProvider,
   setResources, getResources, getResource,
   setRouterProvider, getRouterProvider,
+  setLiveProvider, getLiveProvider,
 } from './context.svelte';
 export type { DataProviderInput } from './context.svelte';
 export {

package/src/live-sse.ts

@@ -29,6 +29,7 @@ export function createSSELiveProvider(options: SSELiveProviderOptions): LiveProv
   const subscribers = new Map<string, Set<Callback>>();
   let eventSource: EventSource | null = null;
   let status: 'connecting' | 'connected' | 'disconnected' = 'disconnected';
+  const registeredListeners = new Set<string>();
 
   function connect() {
     if (eventSource) return;
@@ -64,7 +65,8 @@ export function createSSELiveProvider(options: SSELiveProviderOptions): LiveProv
   }
 
   function addNamedListener(resource: string) {
-    if (!eventSource) return;
+    if (!eventSource || registeredListeners.has(resource)) return;
+    registeredListeners.add(resource);
     eventSource.addEventListener(resource, ((event: MessageEvent) => {
       try {
         const parsed = JSON.parse(event.data);
@@ -109,12 +111,15 @@ export function createSSELiveProvider(options: SSELiveProviderOptions): LiveProv
       eventSource = null;
     }
     status = 'disconnected';
+    registeredListeners.clear();
   }
 
   return {
     subscribe({ resource, callback }) {
+      let isNewResource = false;
       if (!subscribers.has(resource)) {
         subscribers.set(resource, new Set());
+        isNewResource = true;
       }
       subscribers.get(resource)!.add(callback);
 
@@ -123,7 +128,7 @@ export function createSSELiveProvider(options: SSELiveProviderOptions): LiveProv
         connect();
       }
       // Add named listener for this resource if connected
-      if (eventSource && resource !== '*') {
+      if (eventSource && resource !== '*' && isNewResource) {
         addNamedListener(resource);
       }
 

package/src/live-websocket.ts

@@ -104,10 +104,7 @@ export function createWebSocketLiveProvider(options: WebSocketLiveProviderOption
     status = 'disconnected';
   }
 
-  // Auto-connect on creation
-  if (typeof WebSocket !== 'undefined') {
-    connect();
-  }
+
 
   return {
     subscribe({ resource, callback }) {

package/src/live.svelte.ts

@@ -13,8 +13,8 @@ export interface LiveEvent {
 }
 
 export interface LiveProvider {
-  subscribe(params: { resource: string; callback: (event: LiveEvent) => void }): () => void;
-  unsubscribe?(params: { resource: string }): void;
+  subscribe(params: { resource: string; liveParams?: Record<string, unknown>; callback: (event: LiveEvent) => void }): () => void;
+  unsubscribe?(params: { resource: string; liveParams?: Record<string, unknown> }): void;
   publish?(event: LiveEvent): void;
 }