@navios/di-react 0.8.0 → 1.0.0-alpha.3

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["unsubscribe: (() => void) | undefined","entry: CacheEntry<any>","entry","unsubscribe: (() => void) | undefined"],"sources":["../src/providers/context.mts","../src/providers/container-provider.mts","../src/providers/scope-provider.mts","../src/hooks/use-container.mts","../src/hooks/use-service.mts","../src/hooks/use-suspense-service.mts","../src/hooks/use-optional-service.mts","../src/hooks/use-invalidate.mts","../src/hooks/use-scope.mts"],"sourcesContent":["import { createContext } from 'react'\n\nimport type { Container, ScopedContainer } from '@navios/di'\n\n/**\n * Context for the root Container.\n * This is set by ContainerProvider and provides the base container.\n */\nexport const ContainerContext = createContext<Container | null>(null)\n\n/**\n * Context for the current ScopedContainer (if inside a ScopeProvider).\n * This allows nested components to access request-scoped services.\n */\nexport const ScopedContainerContext = createContext<ScopedContainer | null>(null)\n","import type { Container } from '@navios/di'\nimport type { ReactNode } from 'react'\n\nimport { jsx } from 'react/jsx-runtime'\n\nimport { ContainerContext } from './context.mjs'\n\nexport interface ContainerProviderProps {\n  container: Container\n  children: ReactNode\n}\n\nexport function ContainerProvider({\n  container,\n  children,\n}: ContainerProviderProps) {\n  return jsx(ContainerContext.Provider, { value: container, children })\n}\n","import type { ReactNode } from 'react'\nimport type { ScopedContainer } from '@navios/di'\n\nimport { useContext, useEffect, useId, useRef } from 'react'\nimport { jsx } from 'react/jsx-runtime'\n\nimport { ContainerContext, ScopedContainerContext } from './context.mjs'\n\nexport interface ScopeProviderProps {\n  /**\n   * Optional explicit scope ID. If not provided, a unique ID will be generated.\n   * Useful when you need to reference the scope externally.\n   */\n  scopeId?: string\n  /**\n   * Optional metadata to attach to the request context.\n   * Can be used to pass data like user info, request headers, etc.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * Priority for service resolution. Higher priority scopes take precedence.\n   * @default 100\n   */\n  priority?: number\n  children: ReactNode\n}\n\n/**\n * ScopeProvider creates a new request scope for dependency injection.\n *\n * Services with `scope: 'Request'` will be instantiated once per ScopeProvider\n * and shared among all components within that provider.\n *\n * This is useful for:\n * - Table rows that need isolated state\n * - Modal dialogs with their own service instances\n * - Multi-tenant scenarios\n * - Any case where you need isolated service instances\n *\n * @example\n * ```tsx\n * // Each row gets its own RowStateService instance\n * {rows.map(row => (\n *   <ScopeProvider key={row.id} scopeId={row.id} metadata={{ rowData: row }}>\n *     <TableRow />\n *   </ScopeProvider>\n * ))}\n * ```\n */\nexport function ScopeProvider({\n  scopeId,\n  metadata,\n  priority = 100,\n  children,\n}: ScopeProviderProps) {\n  const container = useContext(ContainerContext)\n  if (!container) {\n    throw new Error('ScopeProvider must be used within a ContainerProvider')\n  }\n\n  const generatedId = useId()\n  const effectiveScopeId = scopeId ?? generatedId\n  const scopedContainerRef = useRef<ScopedContainer | null>(null)\n\n  // Create ScopedContainer on first render only\n  // We use a ref to track initialization to handle React StrictMode double-renders\n  if (!scopedContainerRef.current) {\n    // Check if this request ID already exists (e.g., from StrictMode double render)\n    if (!container.hasActiveRequest(effectiveScopeId)) {\n      scopedContainerRef.current = container.beginRequest(\n        effectiveScopeId,\n        metadata,\n        priority,\n      )\n    }\n  }\n\n  // End request context on unmount\n  useEffect(() => {\n    const scopedContainer = scopedContainerRef.current\n    return () => {\n      if (scopedContainer) {\n        void scopedContainer.endRequest()\n      }\n    }\n  }, [])\n\n  // If we don't have a scoped container (shouldn't happen normally), don't render\n  if (!scopedContainerRef.current) {\n    return null\n  }\n\n  return jsx(ScopedContainerContext.Provider, {\n    value: scopedContainerRef.current,\n    children,\n  })\n}\n","import type { Container, IContainer, ScopedContainer } from '@navios/di'\n\nimport { useContext } from 'react'\n\nimport { ContainerContext, ScopedContainerContext } from '../providers/context.mjs'\n\n/**\n * Hook to get the current container (ScopedContainer if inside ScopeProvider, otherwise Container).\n *\n * This is the primary hook for accessing the DI container. It automatically\n * returns the correct container based on context:\n * - Inside a ScopeProvider: returns the ScopedContainer for request-scoped services\n * - Outside a ScopeProvider: returns the root Container\n *\n * @returns The current container (ScopedContainer or Container)\n */\nexport function useContainer(): IContainer {\n  const scopedContainer = useContext(ScopedContainerContext)\n  const container = useContext(ContainerContext)\n\n  // Prefer scoped container if available (we're inside a ScopeProvider)\n  if (scopedContainer) {\n    return scopedContainer\n  }\n\n  if (!container) {\n    throw new Error('useContainer must be used within a ContainerProvider')\n  }\n\n  return container\n}\n\n/**\n * Hook to get the root Container, regardless of whether we're inside a ScopeProvider.\n *\n * Use this when you need access to the root container specifically,\n * for example to create new request scopes programmatically.\n *\n * @returns The root Container\n */\nexport function useRootContainer(): Container {\n  const container = useContext(ContainerContext)\n\n  if (!container) {\n    throw new Error('useRootContainer must be used within a ContainerProvider')\n  }\n\n  return container\n}\n\n/**\n * Hook to get the current ScopedContainer if inside a ScopeProvider.\n *\n * @returns The ScopedContainer or null if not inside a ScopeProvider\n */\nexport function useScopedContainer(): ScopedContainer | null {\n  return useContext(ScopedContainerContext)\n}\n","import type {\n  AnyInjectableType,\n  BoundInjectionToken,\n  ClassType,\n  Factorable,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { useCallback, useEffect, useReducer, useRef, useState } from 'react'\n\nimport type { Join, UnionToArray } from '../types.mjs'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\ntype ServiceState<T> =\n  | { status: 'idle' }\n  | { status: 'loading' }\n  | { status: 'success'; data: T }\n  | { status: 'error'; error: Error }\n\ntype ServiceAction<T> =\n  | { type: 'loading' }\n  | { type: 'success'; data: T }\n  | { type: 'error'; error: Error }\n  | { type: 'reset' }\n\nfunction serviceReducer<T>(\n  state: ServiceState<T>,\n  action: ServiceAction<T>,\n): ServiceState<T> {\n  switch (action.type) {\n    case 'loading':\n      return { status: 'loading' }\n    case 'success':\n      return { status: 'success', data: action.data }\n    case 'error':\n      return { status: 'error', error: action.error }\n    case 'reset':\n      return { status: 'idle' }\n    default:\n      return state\n  }\n}\n\nexport interface UseServiceResult<T> {\n  data: T | undefined\n  error: Error | undefined\n  isLoading: boolean\n  isSuccess: boolean\n  isError: boolean\n  refetch: () => void\n}\n\n// #1 Simple class\nexport function useService<T extends ClassType>(\n  token: T,\n): UseServiceResult<\n  InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n>\n\n// #2 Token with required Schema\nexport function useService<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: z.input<S>,\n): UseServiceResult<T>\n\n// #3 Token with optional Schema\nexport function useService<\n  T,\n  S extends InjectionTokenSchemaType,\n  R extends boolean,\n>(\n  token: InjectionToken<T, S, R>,\n): R extends false\n  ? UseServiceResult<T>\n  : S extends ZodType<infer Type>\n    ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}`\n    : 'Error: Your token requires args'\n\n// #4 Token with no Schema\nexport function useService<T>(\n  token: InjectionToken<T, undefined>,\n): UseServiceResult<T>\n\nexport function useService<T>(\n  token: BoundInjectionToken<T, any>,\n): UseServiceResult<T>\n\nexport function useService<T>(\n  token: FactoryInjectionToken<T, any>,\n): UseServiceResult<T>\n\nexport function useService(\n  token:\n    | ClassType\n    | InjectionToken<any, any>\n    | BoundInjectionToken<any, any>\n    | FactoryInjectionToken<any, any>,\n  args?: unknown,\n): UseServiceResult<any> {\n  // useContainer returns ScopedContainer if inside ScopeProvider, otherwise Container\n  // This automatically handles request-scoped services correctly\n  const container = useContainer()\n  const rootContainer = useRootContainer()\n  const serviceLocator = rootContainer.getServiceLocator()\n\n  // Try to get the instance synchronously first for better performance\n  // This avoids the async loading state when the instance is already cached\n  // We use a ref to track this so it doesn't cause effect re-runs\n  const initialSyncInstanceRef = useRef<any>(undefined)\n  const isFirstRenderRef = useRef(true)\n\n  if (isFirstRenderRef.current) {\n    initialSyncInstanceRef.current = container.tryGetSync(token, args)\n    isFirstRenderRef.current = false\n  }\n\n  const initialState: ServiceState<any> = initialSyncInstanceRef.current\n    ? { status: 'success', data: initialSyncInstanceRef.current }\n    : { status: 'idle' }\n\n  const [state, dispatch] = useReducer(serviceReducer, initialState)\n  const instanceNameRef = useRef<string | null>(null)\n  const [refetchCounter, setRefetchCounter] = useState(0)\n\n  if (process.env.NODE_ENV === 'development') {\n    const argsRef = useRef<unknown>(args)\n    useEffect(() => {\n      if (argsRef.current !== args) {\n        if (JSON.stringify(argsRef.current) === JSON.stringify(args)) {\n          console.log(`WARNING: useService called with args that look the same but are different instances: ${JSON.stringify(argsRef.current)} !== ${JSON.stringify(args)}!\n          This is likely because you are using not memoized value that is not stable.\n          Please use a memoized value or use a different approach to pass the args.\n          Example:\n          const args = useMemo(() => ({ userId: '123' }), [])\n          return useService(UserToken, args)\n          `)\n        }\n        argsRef.current = args\n      }\n    }, [args])\n  }\n\n  // Subscribe to invalidation events\n  useEffect(() => {\n    const eventBus = serviceLocator.getEventBus()\n    let unsubscribe: (() => void) | undefined\n    let isMounted = true\n\n    // Fetch the service and set up subscription\n    const fetchAndSubscribe = async () => {\n      try {\n        // The container (either ScopedContainer or Container) handles resolution correctly\n        const instance = await container.get(\n          // @ts-expect-error - token is valid\n          token as AnyInjectableType,\n          args as any,\n        )\n\n        if (!isMounted) return\n\n        // Get instance name for event subscription\n        const instanceName = serviceLocator.getInstanceIdentifier(\n          token as AnyInjectableType,\n          args,\n        )\n        instanceNameRef.current = instanceName\n\n        dispatch({ type: 'success', data: instance })\n\n        // Set up subscription after we have the instance\n        unsubscribe = eventBus.on(instanceName, 'destroy', () => {\n          // Re-fetch when the service is invalidated\n          if (isMounted) {\n            dispatch({ type: 'loading' })\n            void fetchAndSubscribe()\n          }\n        })\n      } catch (error) {\n        if (isMounted) {\n          dispatch({ type: 'error', error: error as Error })\n        }\n      }\n    }\n\n    // If we already have a sync instance from initial render, just set up subscription\n    // Otherwise, fetch async\n    const syncInstance = initialSyncInstanceRef.current\n    if (syncInstance && refetchCounter === 0) {\n      const instanceName = serviceLocator.getInstanceIdentifier(\n        token as AnyInjectableType,\n        args,\n      )\n      instanceNameRef.current = instanceName\n      unsubscribe = eventBus.on(instanceName, 'destroy', () => {\n        if (isMounted) {\n          dispatch({ type: 'loading' })\n          void fetchAndSubscribe()\n        }\n      })\n    } else {\n      dispatch({ type: 'loading' })\n      void fetchAndSubscribe()\n    }\n\n    return () => {\n      isMounted = false\n      unsubscribe?.()\n    }\n  }, [container, serviceLocator, token, args, refetchCounter])\n\n  const refetch = useCallback(() => {\n    setRefetchCounter((c) => c + 1)\n  }, [])\n\n  return {\n    data: state.status === 'success' ? state.data : undefined,\n    error: state.status === 'error' ? state.error : undefined,\n    isLoading: state.status === 'loading',\n    isSuccess: state.status === 'success',\n    isError: state.status === 'error',\n    refetch,\n  }\n}\n","import type {\n  AnyInjectableType,\n  BoundInjectionToken,\n  ClassType,\n  Factorable,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { useCallback, useEffect, useRef, useSyncExternalStore } from 'react'\n\nimport type { Join, UnionToArray } from '../types.mjs'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\n// Cache entry for suspense\ninterface CacheEntry<T> {\n  promise: Promise<T> | null\n  result: T | undefined\n  error: Error | undefined\n  status: 'pending' | 'resolved' | 'rejected'\n  version: number // Increment on each fetch to track changes\n  subscribers: Set<() => void>\n  instanceName: string | null\n  unsubscribe: (() => void) | undefined\n}\n\n// Global cache for service instances (per container + token + args combination)\nconst cacheMap = new WeakMap<object, Map<string, CacheEntry<any>>>()\n\nfunction getCacheKey(token: any, args: unknown): string {\n  const tokenId =\n    typeof token === 'function'\n      ? token.name\n      : token.id || token.token?.id || String(token)\n  return `${tokenId}:${JSON.stringify(args ?? null)}`\n}\n\nfunction getCache(container: object): Map<string, CacheEntry<any>> {\n  let cache = cacheMap.get(container)\n  if (!cache) {\n    cache = new Map()\n    cacheMap.set(container, cache)\n  }\n  return cache\n}\n\n/**\n * Sets up invalidation subscription for a cache entry if not already subscribed.\n * When the service is destroyed, clears the cache and notifies subscribers.\n */\nfunction setupInvalidationSubscription(\n  entry: CacheEntry<any>,\n  serviceLocator: ReturnType<\n    import('@navios/di').Container['getServiceLocator']\n  >,\n): void {\n  if (entry.unsubscribe || !entry.instanceName) return\n\n  const eventBus = serviceLocator.getEventBus()\n  entry.unsubscribe = eventBus.on(entry.instanceName, 'destroy', () => {\n    // Clear cache and notify subscribers to re-fetch\n    entry.result = undefined\n    entry.error = undefined\n    entry.status = 'pending'\n    entry.promise = null\n    // Notify all subscribers\n    entry.subscribers.forEach((callback) => callback())\n  })\n}\n\n// #1 Simple class\nexport function useSuspenseService<T extends ClassType>(\n  token: T,\n): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n\n// #2 Token with required Schema\nexport function useSuspenseService<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: z.input<S>,\n): T\n\n// #3 Token with optional Schema\nexport function useSuspenseService<\n  T,\n  S extends InjectionTokenSchemaType,\n  R extends boolean,\n>(\n  token: InjectionToken<T, S, R>,\n): R extends false\n  ? T\n  : S extends ZodType<infer Type>\n    ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}`\n    : 'Error: Your token requires args'\n\n// #4 Token with no Schema\nexport function useSuspenseService<T>(token: InjectionToken<T, undefined>): T\n\nexport function useSuspenseService<T>(token: BoundInjectionToken<T, any>): T\n\nexport function useSuspenseService<T>(token: FactoryInjectionToken<T, any>): T\n\nexport function useSuspenseService(\n  token:\n    | ClassType\n    | InjectionToken<any, any>\n    | BoundInjectionToken<any, any>\n    | FactoryInjectionToken<any, any>,\n  args?: unknown,\n): any {\n  // useContainer returns ScopedContainer if inside ScopeProvider, otherwise Container\n  const container = useContainer()\n  const rootContainer = useRootContainer()\n  const serviceLocator = rootContainer.getServiceLocator()\n  const cache = getCache(container)\n  const cacheKey = getCacheKey(token, args)\n  const entryRef = useRef<CacheEntry<any> | null>(null)\n  if (process.env.NODE_ENV === 'development') {\n    const argsRef = useRef<unknown>(args)\n    useEffect(() => {\n      if (argsRef.current !== args) {\n        if (JSON.stringify(argsRef.current) === JSON.stringify(args)) {\n          console.log(`WARNING: useService called with args that look the same but are different instances: ${JSON.stringify(argsRef.current)} !== ${JSON.stringify(args)}!\n          This is likely because you are using not memoized value that is not stable.\n          Please use a memoized value or use a different approach to pass the args.\n          Example:\n          const args = useMemo(() => ({ userId: '123' }), [])\n          return useService(UserToken, args)\n          `)\n        }\n        argsRef.current = args\n      }\n    }, [args])\n  }\n\n  // Initialize or get cache entry\n  if (!cache.has(cacheKey)) {\n    // Try to get the instance synchronously first for better performance\n    // This avoids suspense when the instance is already cached\n    const syncInstance = container.tryGetSync(token, args)\n\n    const entry: CacheEntry<any> = {\n      promise: null,\n      result: syncInstance ?? undefined,\n      error: undefined,\n      status: syncInstance ? 'resolved' : 'pending',\n      version: 0,\n      subscribers: new Set(),\n      instanceName: syncInstance\n        ? serviceLocator.getInstanceIdentifier(token as AnyInjectableType, args)\n        : null,\n      unsubscribe: undefined,\n    }\n    cache.set(cacheKey, entry)\n  }\n\n  const entry = cache.get(cacheKey)!\n  entryRef.current = entry\n\n  // Function to fetch the service\n  const fetchService = useCallback(() => {\n    const currentEntry = entryRef.current\n    if (!currentEntry) return\n\n    currentEntry.status = 'pending'\n    currentEntry.version++ // Increment version to signal change to useSyncExternalStore\n    currentEntry.promise = (container.get as any)(token, args)\n      .then((instance: any) => {\n        currentEntry.result = instance\n        currentEntry.status = 'resolved'\n        currentEntry.instanceName = serviceLocator.getInstanceIdentifier(\n          token as AnyInjectableType,\n          args,\n        )\n\n        // Subscribe to invalidation events if not already subscribed\n        setupInvalidationSubscription(currentEntry, serviceLocator)\n\n        // Notify subscribers\n        currentEntry.subscribers.forEach((callback) => callback())\n        return instance\n      })\n      .catch((error: Error) => {\n        currentEntry.error = error\n        currentEntry.status = 'rejected'\n        throw error\n      })\n\n    return currentEntry.promise\n  }, [container, serviceLocator, token, args])\n\n  // Subscribe to cache changes\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      entry.subscribers.add(callback)\n      return () => {\n        entry.subscribers.delete(callback)\n      }\n    },\n    [entry],\n  )\n\n  // Get snapshot of current state - include version to detect invalidation\n  const getSnapshot = useCallback(() => {\n    return `${entry.status}:${entry.version}`\n  }, [entry])\n\n  // Use sync external store to track cache state\n  useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n\n  // Set up subscription for sync instances that don't have one yet\n  useEffect(() => {\n    const currentEntry = entryRef.current\n    if (\n      currentEntry &&\n      currentEntry.status === 'resolved' &&\n      currentEntry.instanceName &&\n      !currentEntry.unsubscribe\n    ) {\n      setupInvalidationSubscription(currentEntry, serviceLocator)\n    }\n  }, [serviceLocator, entry])\n\n  // Start fetching if not already\n  if (entry.status === 'pending' && !entry.promise) {\n    fetchService()\n  }\n\n  // Suspense behavior\n  if (entry.status === 'pending') {\n    throw entry.promise\n  }\n\n  if (entry.status === 'rejected') {\n    throw entry.error\n  }\n\n  return entry.result\n}\n","import type {\n  AnyInjectableType,\n  BoundInjectionToken,\n  ClassType,\n  Factorable,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { useCallback, useEffect, useReducer, useRef } from 'react'\n\nimport type { Join, UnionToArray } from '../types.mjs'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\ntype OptionalServiceState<T> =\n  | { status: 'idle' }\n  | { status: 'loading' }\n  | { status: 'success'; data: T }\n  | { status: 'not-found' }\n  | { status: 'error'; error: Error }\n\ntype OptionalServiceAction<T> =\n  | { type: 'loading' }\n  | { type: 'success'; data: T }\n  | { type: 'not-found' }\n  | { type: 'error'; error: Error }\n  | { type: 'reset' }\n\nfunction optionalServiceReducer<T>(\n  state: OptionalServiceState<T>,\n  action: OptionalServiceAction<T>,\n): OptionalServiceState<T> {\n  switch (action.type) {\n    case 'loading':\n      return { status: 'loading' }\n    case 'success':\n      return { status: 'success', data: action.data }\n    case 'not-found':\n      return { status: 'not-found' }\n    case 'error':\n      return { status: 'error', error: action.error }\n    case 'reset':\n      return { status: 'idle' }\n    default:\n      return state\n  }\n}\n\nexport interface UseOptionalServiceResult<T> {\n  /**\n   * The service instance if found and loaded successfully, otherwise undefined.\n   */\n  data: T | undefined\n  /**\n   * Error that occurred during loading (excludes \"not found\" which is not an error).\n   */\n  error: Error | undefined\n  /**\n   * True while the service is being loaded.\n   */\n  isLoading: boolean\n  /**\n   * True if the service was loaded successfully.\n   */\n  isSuccess: boolean\n  /**\n   * True if the service was not found (not registered in the container).\n   */\n  isNotFound: boolean\n  /**\n   * True if an error occurred during loading.\n   */\n  isError: boolean\n  /**\n   * Function to manually re-fetch the service.\n   */\n  refetch: () => void\n}\n\n// #1 Simple class\nexport function useOptionalService<T extends ClassType>(\n  token: T,\n): UseOptionalServiceResult<\n  InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n>\n\n// #2 Token with required Schema\nexport function useOptionalService<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: z.input<S>,\n): UseOptionalServiceResult<T>\n\n// #3 Token with optional Schema\nexport function useOptionalService<\n  T,\n  S extends InjectionTokenSchemaType,\n  R extends boolean,\n>(\n  token: InjectionToken<T, S, R>,\n): R extends false\n  ? UseOptionalServiceResult<T>\n  : S extends ZodType<infer Type>\n    ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}`\n    : 'Error: Your token requires args'\n\n// #4 Token with no Schema\nexport function useOptionalService<T>(\n  token: InjectionToken<T, undefined>,\n): UseOptionalServiceResult<T>\n\nexport function useOptionalService<T>(\n  token: BoundInjectionToken<T, any>,\n): UseOptionalServiceResult<T>\n\nexport function useOptionalService<T>(\n  token: FactoryInjectionToken<T, any>,\n): UseOptionalServiceResult<T>\n\n/**\n * Hook to optionally load a service from the DI container.\n *\n * Unlike useService, this hook does NOT throw an error if the service is not registered.\n * Instead, it returns `isNotFound: true` when the service doesn't exist.\n *\n * This is useful for:\n * - Optional dependencies that may or may not be configured\n * - Feature flags where a service might not be available\n * - Plugins or extensions that are conditionally registered\n *\n * @example\n * ```tsx\n * function Analytics() {\n *   const { data: analytics, isNotFound } = useOptionalService(AnalyticsService)\n *\n *   if (isNotFound) {\n *     // Analytics service not configured, skip tracking\n *     return null\n *   }\n *\n *   return <AnalyticsTracker service={analytics} />\n * }\n * ```\n */\nexport function useOptionalService(\n  token:\n    | ClassType\n    | InjectionToken<any, any>\n    | BoundInjectionToken<any, any>\n    | FactoryInjectionToken<any, any>,\n  args?: unknown,\n): UseOptionalServiceResult<any> {\n  // useContainer returns ScopedContainer if inside ScopeProvider, otherwise Container\n  const container = useContainer()\n  const rootContainer = useRootContainer()\n  const serviceLocator = rootContainer.getServiceLocator()\n\n  // Try to get the instance synchronously first for better performance\n  // This avoids the async loading state when the instance is already cached\n  // We use a ref to track this so it doesn't cause effect re-runs\n  const initialSyncInstanceRef = useRef<any>(undefined)\n  const isFirstRenderRef = useRef(true)\n\n  if (isFirstRenderRef.current) {\n    try {\n      initialSyncInstanceRef.current = container.tryGetSync(token, args)\n    } catch {\n      // Service not registered, leave as undefined\n    }\n    isFirstRenderRef.current = false\n  }\n\n  const initialState: OptionalServiceState<any> = initialSyncInstanceRef.current\n    ? { status: 'success', data: initialSyncInstanceRef.current }\n    : { status: 'idle' }\n\n  const [state, dispatch] = useReducer(optionalServiceReducer, initialState)\n  const instanceNameRef = useRef<string | null>(null)\n\n  if (process.env.NODE_ENV === 'development') {\n    const argsRef = useRef<unknown>(args)\n    useEffect(() => {\n      if (argsRef.current !== args) {\n        if (JSON.stringify(argsRef.current) === JSON.stringify(args)) {\n          console.log(`WARNING: useOptionalService called with args that look the same but are different instances: ${JSON.stringify(argsRef.current)} !== ${JSON.stringify(args)}!\n          This is likely because you are using not memoized value that is not stable.\n          Please use a memoized value or use a different approach to pass the args.\n          Example:\n          const args = useMemo(() => ({ userId: '123' }), [])\n          return useOptionalService(UserToken, args)\n          `)\n        }\n        argsRef.current = args\n      }\n    }, [args])\n  }\n\n  const fetchService = useCallback(async () => {\n    dispatch({ type: 'loading' })\n    try {\n      // Use the container (ScopedContainer or Container) for resolution\n      const instance = await container.get(\n        // @ts-expect-error - token is valid\n        token as AnyInjectableType,\n        args as any,\n      )\n\n      // Get instance name for event subscription\n      instanceNameRef.current = serviceLocator.getInstanceIdentifier(\n        token as AnyInjectableType,\n        args,\n      )\n      dispatch({ type: 'success', data: instance })\n    } catch (error) {\n      // Caught exceptions are treated as errors\n      const err = error as Error\n      const errorMessage = err.message?.toLowerCase() ?? ''\n      if (\n        errorMessage.includes('not found') ||\n        errorMessage.includes('not registered') ||\n        errorMessage.includes('no provider')\n      ) {\n        dispatch({ type: 'not-found' })\n      } else {\n        dispatch({ type: 'error', error: err })\n      }\n    }\n  }, [container, serviceLocator, token, args])\n\n  // Subscribe to invalidation events\n  useEffect(() => {\n    const eventBus = serviceLocator.getEventBus()\n    let unsubscribe: (() => void) | undefined\n\n    // If we already have a sync instance from initial render, just set up subscription\n    // Otherwise, fetch async\n    const syncInstance = initialSyncInstanceRef.current\n    if (syncInstance) {\n      instanceNameRef.current = serviceLocator.getInstanceIdentifier(\n        token as AnyInjectableType,\n        args,\n      )\n      unsubscribe = eventBus.on(instanceNameRef.current, 'destroy', () => {\n        void fetchService()\n      })\n    } else {\n      void fetchService()\n\n      // Set up subscription after we have the instance name\n      const setupSubscription = () => {\n        if (instanceNameRef.current) {\n          unsubscribe = eventBus.on(instanceNameRef.current, 'destroy', () => {\n            // Re-fetch when the service is invalidated\n            void fetchService()\n          })\n        }\n      }\n\n      // Wait a tick for the instance name to be set\n      const timeoutId = setTimeout(setupSubscription, 10)\n\n      return () => {\n        clearTimeout(timeoutId)\n        unsubscribe?.()\n      }\n    }\n\n    return () => {\n      unsubscribe?.()\n    }\n  }, [fetchService, serviceLocator, token, args])\n\n  return {\n    data: state.status === 'success' ? state.data : undefined,\n    error: state.status === 'error' ? state.error : undefined,\n    isLoading: state.status === 'loading',\n    isSuccess: state.status === 'success',\n    isNotFound: state.status === 'not-found',\n    isError: state.status === 'error',\n    refetch: fetchService,\n  }\n}\n","import type {\n  BoundInjectionToken,\n  ClassType,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\n\nimport { useCallback } from 'react'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\ntype InvalidatableToken =\n  | ClassType\n  | InjectionToken<any, any>\n  | BoundInjectionToken<any, any>\n  | FactoryInjectionToken<any, any>\n\n/**\n * Hook that returns a function to invalidate a service by its token.\n *\n * When called, this will:\n * 1. Destroy the current service instance\n * 2. Trigger re-fetch in all components using useService/useSuspenseService for that token\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { data: user } = useService(UserService)\n *   const invalidateUser = useInvalidate(UserService)\n *\n *   const handleRefresh = () => {\n *     invalidateUser() // All components using UserService will re-fetch\n *   }\n *\n *   return (\n *     <div>\n *       <span>{user?.name}</span>\n *       <button onClick={handleRefresh}>Refresh</button>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useInvalidate<T extends InvalidatableToken>(\n  token: T,\n): () => Promise<void>\n\n/**\n * Hook that returns a function to invalidate a service by its token with args.\n *\n * @example\n * ```tsx\n * function UserProfile({ userId }: { userId: string }) {\n *   const args = useMemo(() => ({ userId }), [userId])\n *   const { data: user } = useService(UserToken, args)\n *   const invalidateUser = useInvalidate(UserToken, args)\n *\n *   return (\n *     <div>\n *       <span>{user?.name}</span>\n *       <button onClick={() => invalidateUser()}>Refresh</button>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useInvalidate<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: S extends undefined ? never : unknown,\n): () => Promise<void>\n\nexport function useInvalidate(\n  token: InvalidatableToken,\n  args?: unknown,\n): () => Promise<void> {\n  const rootContainer = useRootContainer()\n  const serviceLocator = rootContainer.getServiceLocator()\n\n  return useCallback(async () => {\n    const instanceName = serviceLocator.getInstanceIdentifier(token, args)\n    await serviceLocator.invalidate(instanceName)\n  }, [serviceLocator, token, args])\n}\n\n/**\n * Hook that returns a function to invalidate a service instance directly.\n *\n * This is useful when you have the service instance and want to invalidate it\n * without knowing its token.\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { data: user } = useService(UserService)\n *   const invalidateInstance = useInvalidateInstance()\n *\n *   const handleRefresh = () => {\n *     if (user) {\n *       invalidateInstance(user)\n *     }\n *   }\n *\n *   return (\n *     <div>\n *       <span>{user?.name}</span>\n *       <button onClick={handleRefresh}>Refresh</button>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useInvalidateInstance(): (instance: unknown) => Promise<void> {\n  const container = useContainer()\n\n  return useCallback(\n    async (instance: unknown) => {\n      await container.invalidate(instance)\n    },\n    [container],\n  )\n}\n","import type { ScopedContainer } from '@navios/di'\n\nimport { useContext } from 'react'\n\nimport { ScopedContainerContext } from '../providers/context.mjs'\n\n/**\n * Hook to get the current scope ID.\n * Returns null if not inside a ScopeProvider.\n */\nexport function useScope(): string | null {\n  const scopedContainer = useContext(ScopedContainerContext)\n  return scopedContainer?.getRequestId() ?? null\n}\n\n/**\n * Hook to get the current scope ID, throwing if not inside a ScopeProvider.\n * Use this when your component requires a scope to function correctly.\n */\nexport function useScopeOrThrow(): string {\n  const scopeId = useScope()\n  if (scopeId === null) {\n    throw new Error(\n      'useScopeOrThrow must be used within a ScopeProvider. ' +\n        'Wrap your component tree with <ScopeProvider> to create a request scope.',\n    )\n  }\n  return scopeId\n}\n\n/**\n * Hook to get the current ScopedContainer.\n * Returns null if not inside a ScopeProvider.\n *\n * Use this to access scope metadata or other ScopedContainer methods.\n *\n * @example\n * ```tsx\n * function TableRow() {\n *   const scope = useScopedContainer()\n *   const rowData = scope?.getMetadata('rowData')\n *   // ...\n * }\n * ```\n */\nexport function useScopedContainer(): ScopedContainer | null {\n  return useContext(ScopedContainerContext)\n}\n\n/**\n * Hook to get the current ScopedContainer, throwing if not inside a ScopeProvider.\n * Use this when your component requires a scope to function correctly.\n */\nexport function useScopedContainerOrThrow(): ScopedContainer {\n  const scopedContainer = useScopedContainer()\n  if (scopedContainer === null) {\n    throw new Error(\n      'useScopedContainerOrThrow must be used within a ScopeProvider. ' +\n        'Wrap your component tree with <ScopeProvider> to create a request scope.',\n    )\n  }\n  return scopedContainer\n}\n\n/**\n * Hook to get metadata from the current scope.\n * Returns undefined if not inside a ScopeProvider or if the key doesn't exist.\n *\n * @example\n * ```tsx\n * // In parent component:\n * <ScopeProvider metadata={{ userId: '123', theme: 'dark' }}>\n *   <ChildComponent />\n * </ScopeProvider>\n *\n * // In child component:\n * function ChildComponent() {\n *   const userId = useScopeMetadata<string>('userId')\n *   const theme = useScopeMetadata<'light' | 'dark'>('theme')\n *   // ...\n * }\n * ```\n */\nexport function useScopeMetadata<T = unknown>(key: string): T | undefined {\n  const scopedContainer = useContext(ScopedContainerContext)\n  return scopedContainer?.getMetadata(key) as T | undefined\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["unsubscribe: (() => void) | undefined","entry: CacheEntry<any>","entry","unsubscribe: (() => void) | undefined"],"sources":["../src/providers/context.mts","../src/providers/container-provider.mts","../src/providers/scope-provider.mts","../src/hooks/use-container.mts","../src/hooks/use-service.mts","../src/hooks/use-suspense-service.mts","../src/hooks/use-optional-service.mts","../src/hooks/use-invalidate.mts","../src/hooks/use-scope.mts"],"sourcesContent":["import { createContext } from 'react'\n\nimport type { Container, ScopedContainer } from '@navios/di'\n\n/**\n * Context for the root Container.\n * This is set by ContainerProvider and provides the base container.\n */\nexport const ContainerContext = createContext<Container | null>(null)\n\n/**\n * Context for the current ScopedContainer (if inside a ScopeProvider).\n * This allows nested components to access request-scoped services.\n */\nexport const ScopedContainerContext = createContext<ScopedContainer | null>(null)\n","import type { Container } from '@navios/di'\nimport type { ReactNode } from 'react'\n\nimport { jsx } from 'react/jsx-runtime'\n\nimport { ContainerContext } from './context.mjs'\n\nexport interface ContainerProviderProps {\n  container: Container\n  children: ReactNode\n}\n\nexport function ContainerProvider({\n  container,\n  children,\n}: ContainerProviderProps) {\n  return jsx(ContainerContext.Provider, { value: container, children })\n}\n","import type { ScopedContainer } from '@navios/di'\nimport type { ReactNode } from 'react'\n\nimport { useContext, useEffect, useId, useRef } from 'react'\nimport { jsx } from 'react/jsx-runtime'\n\nimport { ContainerContext, ScopedContainerContext } from './context.mjs'\n\nexport interface ScopeProviderProps {\n  /**\n   * Optional explicit scope ID. If not provided, a unique ID will be generated.\n   * Useful when you need to reference the scope externally.\n   */\n  scopeId?: string\n  /**\n   * Optional metadata to attach to the request context.\n   * Can be used to pass data like user info, request headers, etc.\n   */\n  metadata?: Record<string, unknown>\n  children: ReactNode\n}\n\n/**\n * ScopeProvider creates a new request scope for dependency injection.\n *\n * Services with `scope: 'Request'` will be instantiated once per ScopeProvider\n * and shared among all components within that provider.\n *\n * This is useful for:\n * - Table rows that need isolated state\n * - Modal dialogs with their own service instances\n * - Multi-tenant scenarios\n * - Any case where you need isolated service instances\n *\n * @example\n * ```tsx\n * // Each row gets its own RowStateService instance\n * {rows.map(row => (\n *   <ScopeProvider key={row.id} scopeId={row.id} metadata={{ rowData: row }}>\n *     <TableRow />\n *   </ScopeProvider>\n * ))}\n * ```\n */\nexport function ScopeProvider({\n  scopeId,\n  metadata,\n  children,\n}: ScopeProviderProps) {\n  const container = useContext(ContainerContext)\n  if (!container) {\n    throw new Error('ScopeProvider must be used within a ContainerProvider')\n  }\n\n  const generatedId = useId()\n  const effectiveScopeId = scopeId ?? generatedId\n  const scopedContainerRef = useRef<ScopedContainer | null>(null)\n\n  // Create ScopedContainer on first render only\n  // We use a ref to track initialization to handle React StrictMode double-renders\n  if (!scopedContainerRef.current) {\n    // Check if this request ID already exists (e.g., from StrictMode double render)\n    if (!container.hasActiveRequest(effectiveScopeId)) {\n      scopedContainerRef.current = container.beginRequest(\n        effectiveScopeId,\n        metadata,\n      )\n    }\n  }\n\n  // End request context on unmount\n  useEffect(() => {\n    const scopedContainer = scopedContainerRef.current\n    return () => {\n      if (scopedContainer) {\n        void scopedContainer.endRequest()\n      }\n    }\n  }, [])\n\n  // If we don't have a scoped container (shouldn't happen normally), don't render\n  if (!scopedContainerRef.current) {\n    return null\n  }\n\n  return jsx(ScopedContainerContext.Provider, {\n    value: scopedContainerRef.current,\n    children,\n  })\n}\n","import type { Container, ScopedContainer } from '@navios/di'\n\nimport { useContext } from 'react'\n\nimport {\n  ContainerContext,\n  ScopedContainerContext,\n} from '../providers/context.mjs'\n\n/**\n * Hook to get the current container (ScopedContainer if inside ScopeProvider, otherwise Container).\n *\n * This is the primary hook for accessing the DI container. It automatically\n * returns the correct container based on context:\n * - Inside a ScopeProvider: returns the ScopedContainer for request-scoped services\n * - Outside a ScopeProvider: returns the root Container\n *\n * @returns The current container (ScopedContainer or Container)\n */\nexport function useContainer(): Container | ScopedContainer {\n  const scopedContainer = useContext(ScopedContainerContext)\n  const container = useContext(ContainerContext)\n\n  // Prefer scoped container if available (we're inside a ScopeProvider)\n  if (scopedContainer) {\n    return scopedContainer\n  }\n\n  if (!container) {\n    throw new Error('useContainer must be used within a ContainerProvider')\n  }\n\n  return container\n}\n\n/**\n * Hook to get the root Container, regardless of whether we're inside a ScopeProvider.\n *\n * Use this when you need access to the root container specifically,\n * for example to create new request scopes programmatically.\n *\n * @returns The root Container\n */\nexport function useRootContainer(): Container {\n  const container = useContext(ContainerContext)\n\n  if (!container) {\n    throw new Error('useRootContainer must be used within a ContainerProvider')\n  }\n\n  return container\n}\n\n/**\n * Hook to get the current ScopedContainer if inside a ScopeProvider.\n *\n * @returns The ScopedContainer or null if not inside a ScopeProvider\n */\nexport function useScopedContainer(): ScopedContainer | null {\n  return useContext(ScopedContainerContext)\n}\n","import type {\n  AnyInjectableType,\n  BoundInjectionToken,\n  ClassType,\n  Factorable,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { useCallback, useEffect, useReducer, useRef, useState } from 'react'\n\nimport type { Join, UnionToArray } from '../types.mjs'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\ntype ServiceState<T> =\n  | { status: 'idle' }\n  | { status: 'loading' }\n  | { status: 'success'; data: T }\n  | { status: 'error'; error: Error }\n\ntype ServiceAction<T> =\n  | { type: 'loading' }\n  | { type: 'success'; data: T }\n  | { type: 'error'; error: Error }\n  | { type: 'reset' }\n\nfunction serviceReducer<T>(\n  state: ServiceState<T>,\n  action: ServiceAction<T>,\n): ServiceState<T> {\n  switch (action.type) {\n    case 'loading':\n      return { status: 'loading' }\n    case 'success':\n      return { status: 'success', data: action.data }\n    case 'error':\n      return { status: 'error', error: action.error }\n    case 'reset':\n      return { status: 'idle' }\n    default:\n      return state\n  }\n}\n\nexport interface UseServiceResult<T> {\n  data: T | undefined\n  error: Error | undefined\n  isLoading: boolean\n  isSuccess: boolean\n  isError: boolean\n  refetch: () => void\n}\n\n// #1 Simple class\nexport function useService<T extends ClassType>(\n  token: T,\n): UseServiceResult<\n  InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n>\n\n// #2 Token with required Schema\nexport function useService<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: z.input<S>,\n): UseServiceResult<T>\n\n// #3 Token with optional Schema\nexport function useService<\n  T,\n  S extends InjectionTokenSchemaType,\n  R extends boolean,\n>(\n  token: InjectionToken<T, S, R>,\n): R extends false\n  ? UseServiceResult<T>\n  : S extends ZodType<infer Type>\n    ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}`\n    : 'Error: Your token requires args'\n\n// #4 Token with no Schema\nexport function useService<T>(\n  token: InjectionToken<T, undefined>,\n): UseServiceResult<T>\n\nexport function useService<T>(\n  token: BoundInjectionToken<T, any>,\n): UseServiceResult<T>\n\nexport function useService<T>(\n  token: FactoryInjectionToken<T, any>,\n): UseServiceResult<T>\n\nexport function useService(\n  token:\n    | ClassType\n    | InjectionToken<any, any>\n    | BoundInjectionToken<any, any>\n    | FactoryInjectionToken<any, any>,\n  args?: unknown,\n): UseServiceResult<any> {\n  // useContainer returns ScopedContainer if inside ScopeProvider, otherwise Container\n  // This automatically handles request-scoped services correctly\n  const container = useContainer()\n  const rootContainer = useRootContainer()\n\n  // Try to get the instance synchronously first for better performance\n  // This avoids the async loading state when the instance is already cached\n  // We use a ref to track this so it doesn't cause effect re-runs\n  const initialSyncInstanceRef = useRef<any>(undefined)\n  const isFirstRenderRef = useRef(true)\n\n  if (isFirstRenderRef.current) {\n    initialSyncInstanceRef.current = container.tryGetSync(token, args)\n    isFirstRenderRef.current = false\n  }\n\n  const initialState: ServiceState<any> = initialSyncInstanceRef.current\n    ? { status: 'success', data: initialSyncInstanceRef.current }\n    : { status: 'idle' }\n\n  const [state, dispatch] = useReducer(serviceReducer, initialState)\n  const instanceNameRef = useRef<string | null>(null)\n  const [refetchCounter, setRefetchCounter] = useState(0)\n\n  if (process.env.NODE_ENV === 'development') {\n    const argsRef = useRef<unknown>(args)\n    useEffect(() => {\n      if (argsRef.current !== args) {\n        if (JSON.stringify(argsRef.current) === JSON.stringify(args)) {\n          console.warn(`useService called with args that look the same but are different instances: ${JSON.stringify(argsRef.current)} !== ${JSON.stringify(args)}!\nThis is likely because you are using a value that is not memoized.\nPlease use a memoized value or use a different approach to pass the args.\nExample:\n  const args = useMemo(() => ({ userId: '123' }), [])\n  return useService(UserToken, args)`)\n        }\n        argsRef.current = args\n      }\n    }, [args])\n  }\n\n  // Subscribe to invalidation events\n  useEffect(() => {\n    const eventBus = rootContainer.getEventBus()\n    let unsubscribe: (() => void) | undefined\n    let isMounted = true\n\n    // Fetch the service and set up subscription\n    const fetchAndSubscribe = async () => {\n      try {\n        // The container (either ScopedContainer or Container) handles resolution correctly\n        const instance = await container.get(\n          // @ts-expect-error - token is valid\n          token as AnyInjectableType,\n          args as any,\n        )\n\n        if (!isMounted) return\n\n        // Get instance name for event subscription\n        const instanceName = container.calculateInstanceName(token, args)\n        if (instanceName) {\n          instanceNameRef.current = instanceName\n        }\n\n        dispatch({ type: 'success', data: instance })\n\n        // Set up subscription after we have the instance\n        if (instanceName) {\n          unsubscribe = eventBus.on(instanceName, 'destroy', () => {\n            // Re-fetch when the service is invalidated\n            if (isMounted) {\n              dispatch({ type: 'loading' })\n              void fetchAndSubscribe()\n            }\n          })\n        }\n      } catch (error) {\n        if (isMounted) {\n          dispatch({ type: 'error', error: error as Error })\n        }\n      }\n    }\n\n    // If we already have a sync instance from initial render, just set up subscription\n    // Otherwise, fetch async\n    const syncInstance = initialSyncInstanceRef.current\n    if (syncInstance && refetchCounter === 0) {\n      const instanceName = container.calculateInstanceName(token, args)\n      if (instanceName) {\n        instanceNameRef.current = instanceName\n        unsubscribe = eventBus.on(instanceName, 'destroy', () => {\n          if (isMounted) {\n            dispatch({ type: 'loading' })\n            void fetchAndSubscribe()\n          }\n        })\n      }\n    } else {\n      dispatch({ type: 'loading' })\n      void fetchAndSubscribe()\n    }\n\n    return () => {\n      isMounted = false\n      unsubscribe?.()\n    }\n  }, [container, rootContainer, token, args, refetchCounter])\n\n  const refetch = useCallback(() => {\n    setRefetchCounter((c) => c + 1)\n  }, [])\n\n  return {\n    data: state.status === 'success' ? state.data : undefined,\n    error: state.status === 'error' ? state.error : undefined,\n    isLoading: state.status === 'loading',\n    isSuccess: state.status === 'success',\n    isError: state.status === 'error',\n    refetch,\n  }\n}\n","import type {\n  BoundInjectionToken,\n  ClassType,\n  Container,\n  Factorable,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\nimport type { z, ZodType } from 'zod/v4'\n\n\nimport { useCallback, useEffect, useRef, useSyncExternalStore } from 'react'\n\nimport type { Join, UnionToArray } from '../types.mjs'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\n// Cache entry for suspense\ninterface CacheEntry<T> {\n  promise: Promise<T> | null\n  result: T | undefined\n  error: Error | undefined\n  status: 'pending' | 'resolved' | 'rejected'\n  version: number // Increment on each fetch to track changes\n  subscribers: Set<() => void>\n  instanceName: string | null\n  unsubscribe: (() => void) | undefined\n}\n\n// Global cache for service instances (per container + token + args combination)\nconst cacheMap = new WeakMap<object, Map<string, CacheEntry<any>>>()\n\nfunction getCacheKey(token: any, args: unknown): string {\n  const tokenId =\n    typeof token === 'function'\n      ? token.name\n      : token.id || token.token?.id || String(token)\n  return `${tokenId}:${JSON.stringify(args ?? null)}`\n}\n\nfunction getCache(container: object): Map<string, CacheEntry<any>> {\n  let cache = cacheMap.get(container)\n  if (!cache) {\n    cache = new Map()\n    cacheMap.set(container, cache)\n  }\n  return cache\n}\n\n/**\n * Sets up invalidation subscription for a cache entry if not already subscribed.\n * When the service is destroyed, clears the cache and notifies subscribers.\n */\nfunction setupInvalidationSubscription(\n  entry: CacheEntry<any>,\n  rootContainer: Container,\n): void {\n  if (entry.unsubscribe || !entry.instanceName) return\n\n  const eventBus = rootContainer.getEventBus()\n  entry.unsubscribe = eventBus.on(entry.instanceName, 'destroy', () => {\n    // Clear cache and notify subscribers to re-fetch\n    entry.result = undefined\n    entry.error = undefined\n    entry.status = 'pending'\n    entry.promise = null\n    // Notify all subscribers\n    entry.subscribers.forEach((callback) => callback())\n  })\n}\n\n// #1 Simple class\nexport function useSuspenseService<T extends ClassType>(\n  token: T,\n): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n\n// #2 Token with required Schema\nexport function useSuspenseService<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: z.input<S>,\n): T\n\n// #3 Token with optional Schema\nexport function useSuspenseService<\n  T,\n  S extends InjectionTokenSchemaType,\n  R extends boolean,\n>(\n  token: InjectionToken<T, S, R>,\n): R extends false\n  ? T\n  : S extends ZodType<infer Type>\n    ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}`\n    : 'Error: Your token requires args'\n\n// #4 Token with no Schema\nexport function useSuspenseService<T>(token: InjectionToken<T, undefined>): T\n\nexport function useSuspenseService<T>(token: BoundInjectionToken<T, any>): T\n\nexport function useSuspenseService<T>(token: FactoryInjectionToken<T, any>): T\n\nexport function useSuspenseService(\n  token:\n    | ClassType\n    | InjectionToken<any, any>\n    | BoundInjectionToken<any, any>\n    | FactoryInjectionToken<any, any>,\n  args?: unknown,\n): any {\n  // useContainer returns ScopedContainer if inside ScopeProvider, otherwise Container\n  const container = useContainer()\n  const rootContainer = useRootContainer()\n  const cache = getCache(container)\n  const cacheKey = getCacheKey(token, args)\n  const entryRef = useRef<CacheEntry<any> | null>(null)\n  if (process.env.NODE_ENV === 'development') {\n    const argsRef = useRef<unknown>(args)\n    useEffect(() => {\n      if (argsRef.current !== args) {\n        if (JSON.stringify(argsRef.current) === JSON.stringify(args)) {\n          console.warn(`useSuspenseService called with args that look the same but are different instances: ${JSON.stringify(argsRef.current)} !== ${JSON.stringify(args)}!\nThis is likely because you are using a value that is not memoized.\nPlease use a memoized value or use a different approach to pass the args.\nExample:\n  const args = useMemo(() => ({ userId: '123' }), [])\n  return useSuspenseService(UserToken, args)`)\n        }\n        argsRef.current = args\n      }\n    }, [args])\n  }\n\n  // Initialize or get cache entry\n  if (!cache.has(cacheKey)) {\n    // Try to get the instance synchronously first for better performance\n    // This avoids suspense when the instance is already cached\n    const syncInstance = container.tryGetSync(token, args)\n\n    const instanceName = container.calculateInstanceName(token, args)\n    const entry: CacheEntry<any> = {\n      promise: null,\n      result: syncInstance ?? undefined,\n      error: undefined,\n      status: syncInstance ? 'resolved' : 'pending',\n      version: 0,\n      subscribers: new Set(),\n      instanceName,\n      unsubscribe: undefined,\n    }\n    cache.set(cacheKey, entry)\n  }\n\n  const entry = cache.get(cacheKey)!\n  entryRef.current = entry\n\n  // Function to fetch the service\n  const fetchService = useCallback(() => {\n    const currentEntry = entryRef.current\n    if (!currentEntry) return\n\n    currentEntry.status = 'pending'\n    currentEntry.version++ // Increment version to signal change to useSyncExternalStore\n    currentEntry.promise = (container.get as any)(token, args)\n      .then((instance: any) => {\n        currentEntry.result = instance\n        currentEntry.status = 'resolved'\n\n        // Subscribe to invalidation events if not already subscribed\n        setupInvalidationSubscription(currentEntry, rootContainer)\n\n        // Notify subscribers\n        currentEntry.subscribers.forEach((callback) => callback())\n        return instance\n      })\n      .catch((error: Error) => {\n        currentEntry.error = error\n        currentEntry.status = 'rejected'\n        throw error\n      })\n\n    return currentEntry.promise\n  }, [container, rootContainer, token, args])\n\n  // Subscribe to cache changes\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      entry.subscribers.add(callback)\n      return () => {\n        entry.subscribers.delete(callback)\n      }\n    },\n    [entry],\n  )\n\n  // Get snapshot of current state - include version to detect invalidation\n  const getSnapshot = useCallback(() => {\n    return `${entry.status}:${entry.version}`\n  }, [entry])\n\n  // Use sync external store to track cache state\n  useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n\n  // Set up subscription for sync instances that don't have one yet\n  useEffect(() => {\n    const currentEntry = entryRef.current\n    if (\n      currentEntry &&\n      currentEntry.status === 'resolved' &&\n      currentEntry.instanceName &&\n      !currentEntry.unsubscribe\n    ) {\n      setupInvalidationSubscription(currentEntry, rootContainer)\n    }\n  }, [rootContainer, entry])\n\n  // Start fetching if not already\n  if (entry.status === 'pending' && !entry.promise) {\n    fetchService()\n  }\n\n  // Suspense behavior\n  if (entry.status === 'pending') {\n    throw entry.promise\n  }\n\n  if (entry.status === 'rejected') {\n    throw entry.error\n  }\n\n  return entry.result\n}\n","import type {\n  AnyInjectableType,\n  BoundInjectionToken,\n  ClassType,\n  Factorable,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '@navios/di'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { useCallback, useEffect, useReducer, useRef } from 'react'\n\nimport type { Join, UnionToArray } from '../types.mjs'\n\nimport { useContainer, useRootContainer } from './use-container.mjs'\n\ntype OptionalServiceState<T> =\n  | { status: 'idle' }\n  | { status: 'loading' }\n  | { status: 'success'; data: T }\n  | { status: 'not-found' }\n  | { status: 'error'; error: Error }\n\ntype OptionalServiceAction<T> =\n  | { type: 'loading' }\n  | { type: 'success'; data: T }\n  | { type: 'not-found' }\n  | { type: 'error'; error: Error }\n  | { type: 'reset' }\n\nfunction optionalServiceReducer<T>(\n  state: OptionalServiceState<T>,\n  action: OptionalServiceAction<T>,\n): OptionalServiceState<T> {\n  switch (action.type) {\n    case 'loading':\n      return { status: 'loading' }\n    case 'success':\n      return { status: 'success', data: action.data }\n    case 'not-found':\n      return { status: 'not-found' }\n    case 'error':\n      return { status: 'error', error: action.error }\n    case 'reset':\n      return { status: 'idle' }\n    default:\n      return state\n  }\n}\n\nexport interface UseOptionalServiceResult<T> {\n  /**\n   * The service instance if found and loaded successfully, otherwise undefined.\n   */\n  data: T | undefined\n  /**\n   * Error that occurred during loading (excludes \"not found\" which is not an error).\n   */\n  error: Error | undefined\n  /**\n   * True while the service is being loaded.\n   */\n  isLoading: boolean\n  /**\n   * True if the service was loaded successfully.\n   */\n  isSuccess: boolean\n  /**\n   * True if the service was not found (not registered in the container).\n   */\n  isNotFound: boolean\n  /**\n   * True if an error occurred during loading.\n   */\n  isError: boolean\n  /**\n   * Function to manually re-fetch the service.\n   */\n  refetch: () => void\n}\n\n// #1 Simple class\nexport function useOptionalService<T extends ClassType>(\n  token: T,\n): UseOptionalServiceResult<\n  InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n>\n\n// #2 Token with required Schema\nexport function useOptionalService<T, S extends InjectionTokenSchemaType>(\n  token: InjectionToken<T, S>,\n  args: z.input<S>,\n): UseOptionalServiceResult<T>\n\n// #3 Token with optional Schema\nexport function useOptionalService<\n  T,\n  S extends InjectionTokenSchemaType,\n  R extends boolean,\n>(\n  token: InjectionToken<T, S, R>,\n): R extends false\n  ? UseOptionalServiceResult<T>\n  : S extends ZodType<infer Type>\n    ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}`\n    : 'Error: Your token requires args'\n\n// #4 Token with no Schema\nexport function useOptionalService<T>(\n  token: InjectionToken<T, undefined>,\n): UseOptionalServiceResult<T>\n\nexport function useOptionalService<T>(\n  token: BoundInjectionToken<T, any>,\n): UseOptionalServiceResult<T>\n\nexport function useOptionalService<T>(\n  token: FactoryInjectionToken<T, any>,\n): UseOptionalServiceResult<T>\n\n/**\n * Hook to optionally load a service from the DI container.\n *\n * Unlike useService, this hook does NOT throw an error if the service is not registered.\n * Instead, it returns `isNotFound: true` when the service doesn't exist.\n *\n * This is useful for:\n * - Optional dependencies that may or may not be configured\n * - Feature flags where a service might not be available\n * - Plugins or extensions that are conditionally registered\n *\n * @example\n * ```tsx\n * function Analytics() {\n *   const { data: analytics, isNotFound } = useOptionalService(AnalyticsService)\n *\n *   if (isNotFound) {\n *     // Analytics service not configured, skip tracking\n *     return null\n *   }\n *\n *   return <AnalyticsTracker service={analytics} />\n * }\n * ```\n */\nexport function useOptionalService(\n  token:\n    | ClassType\n    | InjectionToken<any, any>\n    | BoundInjectionToken<any, any>\n    | FactoryInjectionToken<any, any>,\n  args?: unknown,\n): UseOptionalServiceResult<any> {\n  // useContainer returns ScopedContainer if inside ScopeProvider, otherwise Container\n  const container = useContainer()\n  const rootContainer = useRootContainer()\n\n  // Try to get the instance synchronously first for better performance\n  // This avoids the async loading state when the instance is already cached\n  // We use a ref to track this so it doesn't cause effect re-runs\n  const initialSyncInstanceRef = useRef<any>(undefined)\n  const isFirstRenderRef = useRef(true)\n\n  if (isFirstRenderRef.current) {\n    try {\n      initialSyncInstanceRef.current = container.tryGetSync(token, args)\n    } catch {\n      // Service not registered, leave as undefined\n    }\n    isFirstRenderRef.current = false\n  }\n\n  const initialState: OptionalServiceState<any> = initialSyncInstanceRef.current\n    ? { status: 'success', data: initialSyncInstanceRef.current }\n    : { status: 'idle' }\n\n  const [state, dispatch] = useReducer(optionalServiceReducer, initialState)\n  const instanceNameRef = useRef<string | null>(null)\n\n  if (process.env.NODE_ENV === 'development') {\n    const argsRef = useRef<unknown>(args)\n    useEffect(() => {\n      if (argsRef.current !== args) {\n        if (JSON.stringify(argsRef.current) === JSON.stringify(args)) {\n          console.warn(`useOptionalService called with args that look the same but are different instances: ${JSON.stringify(argsRef.current)} !== ${JSON.stringify(args)}!\nThis is likely because you are using a value that is not memoized.\nPlease use a memoized value or use a different approach to pass the args.\nExample:\n  const args = useMemo(() => ({ userId: '123' }), [])\n  return useOptionalService(UserToken, args)`)\n        }\n        argsRef.current = args\n      }\n    }, [args])\n  }\n\n  const fetchService = useCallback(async () => {\n    dispatch({ type: 'loading' })\n    try {\n      // Use the container (ScopedContainer or Container) for resolution\n      const instance = await container.get(\n        // @ts-expect-error - token is valid\n        token as AnyInjectableType,\n        args as any,\n      )\n      // Get instance name for event subscription\n      const instanceName = container.calculateInstanceName(token, args)\n      if (instanceName) {\n        instanceNameRef.current = instanceName\n      }\n      dispatch({ type: 'success', data: instance })\n    } catch (error) {\n      // Caught exceptions are treated as errors\n      const err = error as Error\n      const errorMessage = err.message?.toLowerCase() ?? ''\n      if (\n        errorMessage.includes('not found') ||\n        errorMessage.includes('not registered') ||\n        errorMessage.includes('no provider')\n      ) {\n        dispatch({ type: 'not-found' })\n      } else {\n        dispatch({ type: 'error', error: err })\n      }\n    }\n  }, [container, token, args])\n\n  // Subscribe to invalidation events\n  useEffect(() => {\n    const eventBus = rootContainer.getEventBus()\n    let unsubscribe: (() => void) | undefined\n\n    // If we already have a sync instance from initial render, just set up subscription\n    // Otherwise, fetch async\n    const syncInstance = initialSyncInstanceRef.current\n    if (syncInstance) {\n      const instanceName = container.calculateInstanceName(token, args)\n      if (instanceName) {\n        instanceNameRef.current = instanceName\n        unsubscribe = eventBus.on(instanceName, 'destroy', () => {\n          // Re-fetch when the service is invalidated\n          void fetchService()\n        })\n      }\n    } else {\n      void fetchService().then(() => {\n        if (instanceNameRef.current) {\n          unsubscribe = eventBus.on(instanceNameRef.current, 'destroy', () => {\n            // Re-fetch when the service is invalidated\n            void fetchService()\n          })\n        }\n      })\n\n      return () => {\n        unsubscribe?.()\n      }\n    }\n\n    return () => {\n      unsubscribe?.()\n    }\n  }, [fetchService, rootContainer, token, args])\n\n  return {\n    data: state.status === 'success' ? state.data : undefined,\n    error: state.status === 'error' ? state.error : undefined,\n    isLoading: state.status === 'loading',\n    isSuccess: state.status === 'success',\n    isNotFound: state.status === 'not-found',\n    isError: state.status === 'error',\n    refetch: fetchService,\n  }\n}\n","import { useCallback } from 'react'\n\nimport { useContainer } from './use-container.mjs'\n\n/**\n * Hook that returns a function to invalidate a service instance directly.\n *\n * This is useful when you have the service instance and want to invalidate it\n * without knowing its token.\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { data: user } = useService(UserService)\n *   const invalidateInstance = useInvalidateInstance()\n *\n *   const handleRefresh = () => {\n *     if (user) {\n *       invalidateInstance(user)\n *     }\n *   }\n *\n *   return (\n *     <div>\n *       <span>{user?.name}</span>\n *       <button onClick={handleRefresh}>Refresh</button>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useInvalidateInstance(): (instance: unknown) => Promise<void> {\n  const container = useContainer()\n\n  return useCallback(\n    async (instance: unknown) => {\n      await container.invalidate(instance)\n    },\n    [container],\n  )\n}\n","import type { ScopedContainer } from '@navios/di'\n\nimport { useContext } from 'react'\n\nimport { ScopedContainerContext } from '../providers/context.mjs'\n\n/**\n * Hook to get the current scope ID.\n * Returns null if not inside a ScopeProvider.\n */\nexport function useScope(): string | null {\n  const scopedContainer = useContext(ScopedContainerContext)\n  return scopedContainer?.getRequestId() ?? null\n}\n\n/**\n * Hook to get the current scope ID, throwing if not inside a ScopeProvider.\n * Use this when your component requires a scope to function correctly.\n */\nexport function useScopeOrThrow(): string {\n  const scopeId = useScope()\n  if (scopeId === null) {\n    throw new Error(\n      'useScopeOrThrow must be used within a ScopeProvider. ' +\n        'Wrap your component tree with <ScopeProvider> to create a request scope.',\n    )\n  }\n  return scopeId\n}\n\n/**\n * Hook to get the current ScopedContainer.\n * Returns null if not inside a ScopeProvider.\n *\n * Use this to access scope metadata or other ScopedContainer methods.\n *\n * @example\n * ```tsx\n * function TableRow() {\n *   const scope = useScopedContainer()\n *   const rowData = scope?.getMetadata('rowData')\n *   // ...\n * }\n * ```\n */\nexport function useScopedContainer(): ScopedContainer | null {\n  return useContext(ScopedContainerContext)\n}\n\n/**\n * Hook to get the current ScopedContainer, throwing if not inside a ScopeProvider.\n * Use this when your component requires a scope to function correctly.\n */\nexport function useScopedContainerOrThrow(): ScopedContainer {\n  const scopedContainer = useScopedContainer()\n  if (scopedContainer === null) {\n    throw new Error(\n      'useScopedContainerOrThrow must be used within a ScopeProvider. ' +\n        'Wrap your component tree with <ScopeProvider> to create a request scope.',\n    )\n  }\n  return scopedContainer\n}\n\n/**\n * Hook to get metadata from the current scope.\n * Returns undefined if not inside a ScopeProvider or if the key doesn't exist.\n *\n * @example\n * ```tsx\n * // In parent component:\n * <ScopeProvider metadata={{ userId: '123', theme: 'dark' }}>\n *   <ChildComponent />\n * </ScopeProvider>\n *\n * // In child component:\n * function ChildComponent() {\n *   const userId = useScopeMetadata<string>('userId')\n *   const theme = useScopeMetadata<'light' | 'dark'>('theme')\n *   // ...\n * }\n * ```\n */\nexport function useScopeMetadata<T = unknown>(key: string): T | undefined {\n  const scopedContainer = useContext(ScopedContainerContext)\n  return scopedContainer?.getMetadata(key) as T | undefined\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navios/di-react",
-  "version": "0.8.0",
+  "version": "1.0.0-alpha.3",
   "author": {
     "name": "Oleksandr Hanzha",
     "email": "alex@granted.name"
@@ -12,7 +12,7 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@navios/di": "^0.8.0",
+    "@navios/di": "^1.0.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "typings": "./lib/index.d.mts",
@@ -31,7 +31,7 @@
     }
   },
   "devDependencies": {
-    "@navios/di": "^0.8.0",
+    "@navios/di": "^1.0.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.1",
     "@types/react": "^19.2.7",

package/src/hooks/__tests__/use-container.spec.mts

@@ -1,21 +1,26 @@
-import { Container, Injectable, Registry } from '@navios/di'
+import { Container, globalRegistry, Injectable, Registry } from '@navios/di'
 
 import { renderHook } from '@testing-library/react'
 import { createElement } from 'react'
-import { beforeEach, describe, expect, it } from 'vitest'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
 
 import { ContainerProvider } from '../../providers/container-provider.mjs'
-import { useContainer } from '../use-container.mjs'
+import { ScopeProvider } from '../../providers/scope-provider.mjs'
+import { useContainer, useRootContainer } from '../use-container.mjs'
 
 describe('useContainer', () => {
   let container: Container
   let registry: Registry
 
   beforeEach(() => {
-    registry = new Registry()
+    registry = new Registry(globalRegistry)
     container = new Container(registry)
   })
 
+  afterEach(async () => {
+    await container.dispose()
+  })
+
   it('should return the container from context', () => {
     const wrapper = ({ children }: { children: React.ReactNode }) =>
       // @ts-expect-error - container is required
@@ -46,7 +51,93 @@ describe('useContainer', () => {
 
     const { result } = renderHook(() => useContainer(), { wrapper })
 
+    // @ts-expect-error - token is valid
     const service = await result.current.get(TestService)
     expect(service.getValue()).toBe('test-value')
   })
+
+  it('should return ScopedContainer when inside ScopeProvider', () => {
+    const wrapper = ({ children }: { children: React.ReactNode }) =>
+      createElement(
+        ContainerProvider,
+        // @ts-expect-error - props are not typed
+        { container },
+        // @ts-expect-error - props are not typed
+        createElement(ScopeProvider, { scopeId: 'test-scope' }, children),
+      )
+
+    const { result } = renderHook(() => useContainer(), { wrapper })
+
+    // Should return the scoped container, not the root container
+    expect(result.current).not.toBe(container)
+    // @ts-expect-error - getRequestId exists on ScopedContainer
+    expect(result.current.getRequestId?.()).toBe('test-scope')
+  })
+})
+
+describe('useRootContainer', () => {
+  let container: Container
+  let registry: Registry
+
+  beforeEach(() => {
+    registry = new Registry(globalRegistry)
+    container = new Container(registry)
+  })
+
+  afterEach(async () => {
+    await container.dispose()
+  })
+
+  it('should return the root container from context', () => {
+    const wrapper = ({ children }: { children: React.ReactNode }) =>
+      // @ts-expect-error - container is required
+      createElement(ContainerProvider, { container }, children)
+
+    const { result } = renderHook(() => useRootContainer(), { wrapper })
+
+    expect(result.current).toBe(container)
+  })
+
+  it('should throw an error when used outside of ContainerProvider', () => {
+    expect(() => {
+      renderHook(() => useRootContainer())
+    }).toThrow('useRootContainer must be used within a ContainerProvider')
+  })
+
+  it('should return root container even when inside ScopeProvider', () => {
+    const wrapper = ({ children }: { children: React.ReactNode }) =>
+      createElement(
+        ContainerProvider,
+        // @ts-expect-error - props are not typed
+        { container },
+        // @ts-expect-error - props are not typed
+        createElement(ScopeProvider, { scopeId: 'test-scope' }, children),
+      )
+
+    const { result } = renderHook(() => useRootContainer(), { wrapper })
+
+    // Should always return the root container, not the scoped container
+    expect(result.current).toBe(container)
+  })
+
+  it('should return root container from deeply nested scopes', () => {
+    const wrapper = ({ children }: { children: React.ReactNode }) =>
+      createElement(
+        ContainerProvider,
+        // @ts-expect-error - props are not typed
+        { container },
+        createElement(
+          ScopeProvider,
+          // @ts-expect-error - props are not typed
+          { scopeId: 'outer-scope' },
+          // @ts-expect-error - props are not typed
+          createElement(ScopeProvider, { scopeId: 'inner-scope' }, children),
+        ),
+      )
+
+    const { result } = renderHook(() => useRootContainer(), { wrapper })
+
+    // Should always return the root container
+    expect(result.current).toBe(container)
+  })
 })

package/src/hooks/__tests__/use-invalidate.spec.mts

@@ -1,154 +1,13 @@
-import { Container, Injectable, InjectionToken, Registry } from '@navios/di'
+import { Container, Injectable, Registry } from '@navios/di'
 
 import { act, render, screen, waitFor } from '@testing-library/react'
-import { createElement, useMemo } from 'react'
+import { createElement } from 'react'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import { z } from 'zod/v4'
 
 import { ContainerProvider } from '../../providers/container-provider.mjs'
-import { useInvalidate, useInvalidateInstance } from '../use-invalidate.mjs'
+import { useInvalidateInstance } from '../use-invalidate.mjs'
 import { useService } from '../use-service.mjs'
 
-describe('useInvalidate', () => {
-  let container: Container
-  let registry: Registry
-
-  beforeEach(() => {
-    registry = new Registry()
-    container = new Container(registry)
-  })
-
-  afterEach(async () => {
-    await container.dispose()
-    vi.clearAllMocks()
-  })
-
-  const createWrapper = (children: React.ReactNode) =>
-    createElement(ContainerProvider, { container, children })
-
-  describe('with class tokens', () => {
-    it('should invalidate a service and trigger re-fetch', async () => {
-      let instanceCount = 0
-
-      @Injectable({ registry })
-      class CounterService {
-        public readonly id: number
-
-        constructor() {
-          instanceCount++
-          this.id = instanceCount
-        }
-      }
-
-      let invalidateFn: (() => Promise<void>) | null = null
-
-      function TestComponent() {
-        const { data, isSuccess } = useService(CounterService)
-        const invalidate = useInvalidate(CounterService)
-        invalidateFn = invalidate
-
-        if (!isSuccess) {
-          return createElement('div', { 'data-testid': 'loading' }, 'Loading...')
-        }
-
-        return createElement('div', { 'data-testid': 'counter' }, String(data!.id))
-      }
-
-      render(createWrapper(createElement(TestComponent)))
-
-      // Wait for initial load
-      await waitFor(() => {
-        expect(screen.getByTestId('counter')).toBeDefined()
-      })
-
-      expect(screen.getByTestId('counter').textContent).toBe('1')
-
-      // Invalidate the service
-      await act(async () => {
-        await invalidateFn!()
-      })
-
-      // Wait for re-fetch
-      await waitFor(() => {
-        expect(screen.getByTestId('counter').textContent).toBe('2')
-      })
-
-      expect(instanceCount).toBe(2)
-    })
-  })
-
-  describe('with injection tokens and args', () => {
-    it('should invalidate a service with specific args', async () => {
-      let instanceCount = 0
-      const instances = new Map<string, number>()
-
-      const UserSchema = z.object({ userId: z.string() })
-      const UserToken = InjectionToken.create<
-        { userId: string; instanceId: number },
-        typeof UserSchema
-      >('User', UserSchema)
-
-      @Injectable({ registry, token: UserToken })
-      class _UserService {
-        public userId: string
-        public instanceId: number
-
-        constructor(args: z.infer<typeof UserSchema>) {
-          this.userId = args.userId
-          const currentCount = instances.get(args.userId) ?? 0
-          instanceCount++
-          this.instanceId = instanceCount
-          instances.set(args.userId, this.instanceId)
-        }
-      }
-
-      let invalidateUser1: (() => Promise<void>) | null = null
-
-      function TestComponent() {
-        const args1 = useMemo(() => ({ userId: 'user1' }), [])
-        const args2 = useMemo(() => ({ userId: 'user2' }), [])
-
-        const { data: user1, isSuccess: isSuccess1 } = useService(UserToken, args1)
-        const { data: user2, isSuccess: isSuccess2 } = useService(UserToken, args2)
-        const invalidate1 = useInvalidate(UserToken, args1)
-        invalidateUser1 = invalidate1
-
-        if (!isSuccess1 || !isSuccess2) {
-          return createElement('div', { 'data-testid': 'loading' }, 'Loading...')
-        }
-
-        return createElement('div', null, [
-          createElement('span', { key: '1', 'data-testid': 'user1' }, String(user1!.instanceId)),
-          createElement('span', { key: '2', 'data-testid': 'user2' }, String(user2!.instanceId)),
-        ])
-      }
-
-      render(createWrapper(createElement(TestComponent)))
-
-      await waitFor(() => {
-        expect(screen.getByTestId('user1')).toBeDefined()
-        expect(screen.getByTestId('user2')).toBeDefined()
-      })
-
-      expect(screen.getByTestId('user1').textContent).toBe('1')
-      expect(screen.getByTestId('user2').textContent).toBe('2')
-
-      // Invalidate only user1
-      await act(async () => {
-        await invalidateUser1!()
-      })
-
-      // Wait for user1 to be re-fetched
-      await waitFor(() => {
-        expect(screen.getByTestId('user1').textContent).toBe('3')
-      })
-
-      // user2 should still be the same
-      expect(screen.getByTestId('user2').textContent).toBe('2')
-    })
-  })
-})
-
 describe('useInvalidateInstance', () => {
   let container: Container
   let registry: Registry
@@ -179,7 +38,8 @@ describe('useInvalidateInstance', () => {
       }
     }
 
-    let invalidateInstanceFn: ((instance: unknown) => Promise<void>) | null = null
+    let invalidateInstanceFn: ((instance: unknown) => Promise<void>) | null =
+      null
     let currentInstance: CounterService | undefined
 
     function TestComponent() {
@@ -192,7 +52,11 @@ describe('useInvalidateInstance', () => {
         return createElement('div', { 'data-testid': 'loading' }, 'Loading...')
       }
 
-      return createElement('div', { 'data-testid': 'counter' }, String(data!.id))
+      return createElement(
+        'div',
+        { 'data-testid': 'counter' },
+        String(data!.id),
+      )
     }
 
     render(createWrapper(createElement(TestComponent)))