@navios/di-react 0.1.1 → 0.2.0

package/lib/_tsup-dts-rollup.d.mts

@@ -1,304 +0,0 @@
-import type { BoundInjectionToken } from '@navios/di';
-import type { ClassType } from '@navios/di';
-import { Container } from '@navios/di';
-import { Context } from 'react';
-import type { Factorable } from '@navios/di';
-import type { FactoryInjectionToken } from '@navios/di';
-import type { InjectionToken } from '@navios/di';
-import type { InjectionTokenSchemaType } from '@navios/di';
-import { JSXElementConstructor } from 'react';
-import { ReactElement } from 'react';
-import type { ReactNode } from 'react';
-import type { z } from 'zod/v4';
-import type { ZodType } from 'zod/v4';
-
-declare const ContainerContext: Context<Container | null>;
-export { ContainerContext }
-export { ContainerContext as ContainerContext_alias_1 }
-export { ContainerContext as ContainerContext_alias_2 }
-
-declare function ContainerProvider({ container, children, }: ContainerProviderProps): ReactElement<unknown, string | JSXElementConstructor<any>>;
-export { ContainerProvider }
-export { ContainerProvider as ContainerProvider_alias_1 }
-export { ContainerProvider as ContainerProvider_alias_2 }
-
-declare interface ContainerProviderProps {
-    container: Container;
-    children: ReactNode;
-}
-export { ContainerProviderProps }
-export { ContainerProviderProps as ContainerProviderProps_alias_1 }
-export { ContainerProviderProps as ContainerProviderProps_alias_2 }
-
-declare type InvalidatableToken = ClassType | InjectionToken<any, any> | BoundInjectionToken<any, any> | FactoryInjectionToken<any, any>;
-
-declare type Join<T extends any[], Delimiter extends string> = T extends [] ? '' : T extends [infer First extends string | number | symbol] ? First extends string | number ? `${First}` : never : T extends [
-infer First extends string | number | symbol,
-...infer Rest extends any[]
-] ? First extends string | number ? `${First}${Delimiter}${Join<Rest, Delimiter>}` : never : '';
-export { Join }
-export { Join as Join_alias_1 }
-
-/**
- * Context for the current scope ID.
- * This allows nested components to access the current request scope.
- */
-declare const ScopeContext: Context<string | null>;
-export { ScopeContext }
-export { ScopeContext as ScopeContext_alias_1 }
-export { ScopeContext as ScopeContext_alias_2 }
-
-/**
- * ScopeProvider creates a new request scope for dependency injection.
- *
- * Services with `scope: 'Request'` will be instantiated once per ScopeProvider
- * and shared among all components within that provider.
- *
- * This is useful for:
- * - Table rows that need isolated state
- * - Modal dialogs with their own service instances
- * - Multi-tenant scenarios
- * - Any case where you need isolated service instances
- *
- * @example
- * ```tsx
- * // Each row gets its own RowStateService instance
- * {rows.map(row => (
- *   <ScopeProvider key={row.id} scopeId={row.id}>
- *     <TableRow data={row} />
- *   </ScopeProvider>
- * ))}
- * ```
- */
-declare function ScopeProvider({ scopeId, metadata, priority, children, }: ScopeProviderProps): ReactElement<unknown, string | JSXElementConstructor<any>>;
-export { ScopeProvider }
-export { ScopeProvider as ScopeProvider_alias_1 }
-export { ScopeProvider as ScopeProvider_alias_2 }
-
-declare interface ScopeProviderProps {
-    /**
-     * Optional explicit scope ID. If not provided, a unique ID will be generated.
-     * Useful when you need to reference the scope externally.
-     */
-    scopeId?: string;
-    /**
-     * Optional metadata to attach to the request context.
-     * Can be used to pass data like user info, request headers, etc.
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Priority for service resolution. Higher priority scopes take precedence.
-     * @default 100
-     */
-    priority?: number;
-    children: ReactNode;
-}
-export { ScopeProviderProps }
-export { ScopeProviderProps as ScopeProviderProps_alias_1 }
-export { ScopeProviderProps as ScopeProviderProps_alias_2 }
-
-declare type UnionToArray<T> = UnionToArrayImpl<T, never>;
-export { UnionToArray }
-export { UnionToArray as UnionToArray_alias_1 }
-
-declare type UnionToArrayImpl<T, L extends any[]> = T extends any ? UnionToArrayImpl<Exclude<T, T>, [...L, T]> : L;
-
-declare function useContainer(): Container;
-export { useContainer }
-export { useContainer as useContainer_alias_1 }
-export { useContainer as useContainer_alias_2 }
-
-/**
- * Hook that returns a function to invalidate a service by its token.
- *
- * When called, this will:
- * 1. Destroy the current service instance
- * 2. Trigger re-fetch in all components using useService/useSuspenseService for that token
- *
- * @example
- * ```tsx
- * function UserProfile() {
- *   const { data: user } = useService(UserService)
- *   const invalidateUser = useInvalidate(UserService)
- *
- *   const handleRefresh = () => {
- *     invalidateUser() // All components using UserService will re-fetch
- *   }
- *
- *   return (
- *     <div>
- *       <span>{user?.name}</span>
- *       <button onClick={handleRefresh}>Refresh</button>
- *     </div>
- *   )
- * }
- * ```
- */
-declare function useInvalidate<T extends InvalidatableToken>(token: T): () => Promise<void>;
-
-/**
- * Hook that returns a function to invalidate a service by its token with args.
- *
- * @example
- * ```tsx
- * function UserProfile({ userId }: { userId: string }) {
- *   const args = useMemo(() => ({ userId }), [userId])
- *   const { data: user } = useService(UserToken, args)
- *   const invalidateUser = useInvalidate(UserToken, args)
- *
- *   return (
- *     <div>
- *       <span>{user?.name}</span>
- *       <button onClick={() => invalidateUser()}>Refresh</button>
- *     </div>
- *   )
- * }
- * ```
- */
-declare function useInvalidate<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: S extends undefined ? never : unknown): () => Promise<void>;
-export { useInvalidate }
-export { useInvalidate as useInvalidate_alias_1 }
-export { useInvalidate as useInvalidate_alias_2 }
-
-/**
- * Hook that returns a function to invalidate a service instance directly.
- *
- * This is useful when you have the service instance and want to invalidate it
- * without knowing its token.
- *
- * @example
- * ```tsx
- * function UserProfile() {
- *   const { data: user } = useService(UserService)
- *   const invalidateInstance = useInvalidateInstance()
- *
- *   const handleRefresh = () => {
- *     if (user) {
- *       invalidateInstance(user)
- *     }
- *   }
- *
- *   return (
- *     <div>
- *       <span>{user?.name}</span>
- *       <button onClick={handleRefresh}>Refresh</button>
- *     </div>
- *   )
- * }
- * ```
- */
-declare function useInvalidateInstance(): (instance: unknown) => Promise<void>;
-export { useInvalidateInstance }
-export { useInvalidateInstance as useInvalidateInstance_alias_1 }
-export { useInvalidateInstance as useInvalidateInstance_alias_2 }
-
-declare function useOptionalService<T extends ClassType>(token: T): UseOptionalServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
-
-declare function useOptionalService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseOptionalServiceResult<T>;
-
-declare function useOptionalService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseOptionalServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
-
-declare function useOptionalService<T>(token: InjectionToken<T, undefined>): UseOptionalServiceResult<T>;
-
-declare function useOptionalService<T>(token: BoundInjectionToken<T, any>): UseOptionalServiceResult<T>;
-
-declare function useOptionalService<T>(token: FactoryInjectionToken<T, any>): UseOptionalServiceResult<T>;
-export { useOptionalService }
-export { useOptionalService as useOptionalService_alias_1 }
-export { useOptionalService as useOptionalService_alias_2 }
-
-declare interface UseOptionalServiceResult<T> {
-    /**
-     * The service instance if found and loaded successfully, otherwise undefined.
-     */
-    data: T | undefined;
-    /**
-     * Error that occurred during loading (excludes "not found" which is not an error).
-     */
-    error: Error | undefined;
-    /**
-     * True while the service is being loaded.
-     */
-    isLoading: boolean;
-    /**
-     * True if the service was loaded successfully.
-     */
-    isSuccess: boolean;
-    /**
-     * True if the service was not found (not registered in the container).
-     */
-    isNotFound: boolean;
-    /**
-     * True if an error occurred during loading.
-     */
-    isError: boolean;
-    /**
-     * Function to manually re-fetch the service.
-     */
-    refetch: () => void;
-}
-export { UseOptionalServiceResult }
-export { UseOptionalServiceResult as UseOptionalServiceResult_alias_1 }
-export { UseOptionalServiceResult as UseOptionalServiceResult_alias_2 }
-
-/**
- * Hook to get the current scope ID.
- * Returns null if not inside a ScopeProvider.
- */
-declare function useScope(): string | null;
-export { useScope }
-export { useScope as useScope_alias_1 }
-export { useScope as useScope_alias_2 }
-
-/**
- * Hook to get the current scope ID, throwing if not inside a ScopeProvider.
- * Use this when your component requires a scope to function correctly.
- */
-declare function useScopeOrThrow(): string;
-export { useScopeOrThrow }
-export { useScopeOrThrow as useScopeOrThrow_alias_1 }
-export { useScopeOrThrow as useScopeOrThrow_alias_2 }
-
-declare function useService<T extends ClassType>(token: T): UseServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
-
-declare function useService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseServiceResult<T>;
-
-declare function useService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
-
-declare function useService<T>(token: InjectionToken<T, undefined>): UseServiceResult<T>;
-
-declare function useService<T>(token: BoundInjectionToken<T, any>): UseServiceResult<T>;
-
-declare function useService<T>(token: FactoryInjectionToken<T, any>): UseServiceResult<T>;
-export { useService }
-export { useService as useService_alias_1 }
-export { useService as useService_alias_2 }
-
-declare interface UseServiceResult<T> {
-    data: T | undefined;
-    error: Error | undefined;
-    isLoading: boolean;
-    isSuccess: boolean;
-    isError: boolean;
-    refetch: () => void;
-}
-export { UseServiceResult }
-export { UseServiceResult as UseServiceResult_alias_1 }
-export { UseServiceResult as UseServiceResult_alias_2 }
-
-declare function useSuspenseService<T extends ClassType>(token: T): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>;
-
-declare function useSuspenseService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): T;
-
-declare function useSuspenseService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? T : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
-
-declare function useSuspenseService<T>(token: InjectionToken<T, undefined>): T;
-
-declare function useSuspenseService<T>(token: BoundInjectionToken<T, any>): T;
-
-declare function useSuspenseService<T>(token: FactoryInjectionToken<T, any>): T;
-export { useSuspenseService }
-export { useSuspenseService as useSuspenseService_alias_1 }
-export { useSuspenseService as useSuspenseService_alias_2 }
-
-export { }

package/lib/_tsup-dts-rollup.d.ts

@@ -1,304 +0,0 @@
-import type { BoundInjectionToken } from '@navios/di';
-import type { ClassType } from '@navios/di';
-import { Container } from '@navios/di';
-import { Context } from 'react';
-import type { Factorable } from '@navios/di';
-import type { FactoryInjectionToken } from '@navios/di';
-import type { InjectionToken } from '@navios/di';
-import type { InjectionTokenSchemaType } from '@navios/di';
-import { JSXElementConstructor } from 'react';
-import { ReactElement } from 'react';
-import type { ReactNode } from 'react';
-import type { z } from 'zod/v4';
-import type { ZodType } from 'zod/v4';
-
-declare const ContainerContext: Context<Container | null>;
-export { ContainerContext }
-export { ContainerContext as ContainerContext_alias_1 }
-export { ContainerContext as ContainerContext_alias_2 }
-
-declare function ContainerProvider({ container, children, }: ContainerProviderProps): ReactElement<unknown, string | JSXElementConstructor<any>>;
-export { ContainerProvider }
-export { ContainerProvider as ContainerProvider_alias_1 }
-export { ContainerProvider as ContainerProvider_alias_2 }
-
-declare interface ContainerProviderProps {
-    container: Container;
-    children: ReactNode;
-}
-export { ContainerProviderProps }
-export { ContainerProviderProps as ContainerProviderProps_alias_1 }
-export { ContainerProviderProps as ContainerProviderProps_alias_2 }
-
-declare type InvalidatableToken = ClassType | InjectionToken<any, any> | BoundInjectionToken<any, any> | FactoryInjectionToken<any, any>;
-
-declare type Join<T extends any[], Delimiter extends string> = T extends [] ? '' : T extends [infer First extends string | number | symbol] ? First extends string | number ? `${First}` : never : T extends [
-infer First extends string | number | symbol,
-...infer Rest extends any[]
-] ? First extends string | number ? `${First}${Delimiter}${Join<Rest, Delimiter>}` : never : '';
-export { Join }
-export { Join as Join_alias_1 }
-
-/**
- * Context for the current scope ID.
- * This allows nested components to access the current request scope.
- */
-declare const ScopeContext: Context<string | null>;
-export { ScopeContext }
-export { ScopeContext as ScopeContext_alias_1 }
-export { ScopeContext as ScopeContext_alias_2 }
-
-/**
- * ScopeProvider creates a new request scope for dependency injection.
- *
- * Services with `scope: 'Request'` will be instantiated once per ScopeProvider
- * and shared among all components within that provider.
- *
- * This is useful for:
- * - Table rows that need isolated state
- * - Modal dialogs with their own service instances
- * - Multi-tenant scenarios
- * - Any case where you need isolated service instances
- *
- * @example
- * ```tsx
- * // Each row gets its own RowStateService instance
- * {rows.map(row => (
- *   <ScopeProvider key={row.id} scopeId={row.id}>
- *     <TableRow data={row} />
- *   </ScopeProvider>
- * ))}
- * ```
- */
-declare function ScopeProvider({ scopeId, metadata, priority, children, }: ScopeProviderProps): ReactElement<unknown, string | JSXElementConstructor<any>>;
-export { ScopeProvider }
-export { ScopeProvider as ScopeProvider_alias_1 }
-export { ScopeProvider as ScopeProvider_alias_2 }
-
-declare interface ScopeProviderProps {
-    /**
-     * Optional explicit scope ID. If not provided, a unique ID will be generated.
-     * Useful when you need to reference the scope externally.
-     */
-    scopeId?: string;
-    /**
-     * Optional metadata to attach to the request context.
-     * Can be used to pass data like user info, request headers, etc.
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Priority for service resolution. Higher priority scopes take precedence.
-     * @default 100
-     */
-    priority?: number;
-    children: ReactNode;
-}
-export { ScopeProviderProps }
-export { ScopeProviderProps as ScopeProviderProps_alias_1 }
-export { ScopeProviderProps as ScopeProviderProps_alias_2 }
-
-declare type UnionToArray<T> = UnionToArrayImpl<T, never>;
-export { UnionToArray }
-export { UnionToArray as UnionToArray_alias_1 }
-
-declare type UnionToArrayImpl<T, L extends any[]> = T extends any ? UnionToArrayImpl<Exclude<T, T>, [...L, T]> : L;
-
-declare function useContainer(): Container;
-export { useContainer }
-export { useContainer as useContainer_alias_1 }
-export { useContainer as useContainer_alias_2 }
-
-/**
- * Hook that returns a function to invalidate a service by its token.
- *
- * When called, this will:
- * 1. Destroy the current service instance
- * 2. Trigger re-fetch in all components using useService/useSuspenseService for that token
- *
- * @example
- * ```tsx
- * function UserProfile() {
- *   const { data: user } = useService(UserService)
- *   const invalidateUser = useInvalidate(UserService)
- *
- *   const handleRefresh = () => {
- *     invalidateUser() // All components using UserService will re-fetch
- *   }
- *
- *   return (
- *     <div>
- *       <span>{user?.name}</span>
- *       <button onClick={handleRefresh}>Refresh</button>
- *     </div>
- *   )
- * }
- * ```
- */
-declare function useInvalidate<T extends InvalidatableToken>(token: T): () => Promise<void>;
-
-/**
- * Hook that returns a function to invalidate a service by its token with args.
- *
- * @example
- * ```tsx
- * function UserProfile({ userId }: { userId: string }) {
- *   const args = useMemo(() => ({ userId }), [userId])
- *   const { data: user } = useService(UserToken, args)
- *   const invalidateUser = useInvalidate(UserToken, args)
- *
- *   return (
- *     <div>
- *       <span>{user?.name}</span>
- *       <button onClick={() => invalidateUser()}>Refresh</button>
- *     </div>
- *   )
- * }
- * ```
- */
-declare function useInvalidate<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: S extends undefined ? never : unknown): () => Promise<void>;
-export { useInvalidate }
-export { useInvalidate as useInvalidate_alias_1 }
-export { useInvalidate as useInvalidate_alias_2 }
-
-/**
- * Hook that returns a function to invalidate a service instance directly.
- *
- * This is useful when you have the service instance and want to invalidate it
- * without knowing its token.
- *
- * @example
- * ```tsx
- * function UserProfile() {
- *   const { data: user } = useService(UserService)
- *   const invalidateInstance = useInvalidateInstance()
- *
- *   const handleRefresh = () => {
- *     if (user) {
- *       invalidateInstance(user)
- *     }
- *   }
- *
- *   return (
- *     <div>
- *       <span>{user?.name}</span>
- *       <button onClick={handleRefresh}>Refresh</button>
- *     </div>
- *   )
- * }
- * ```
- */
-declare function useInvalidateInstance(): (instance: unknown) => Promise<void>;
-export { useInvalidateInstance }
-export { useInvalidateInstance as useInvalidateInstance_alias_1 }
-export { useInvalidateInstance as useInvalidateInstance_alias_2 }
-
-declare function useOptionalService<T extends ClassType>(token: T): UseOptionalServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
-
-declare function useOptionalService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseOptionalServiceResult<T>;
-
-declare function useOptionalService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseOptionalServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
-
-declare function useOptionalService<T>(token: InjectionToken<T, undefined>): UseOptionalServiceResult<T>;
-
-declare function useOptionalService<T>(token: BoundInjectionToken<T, any>): UseOptionalServiceResult<T>;
-
-declare function useOptionalService<T>(token: FactoryInjectionToken<T, any>): UseOptionalServiceResult<T>;
-export { useOptionalService }
-export { useOptionalService as useOptionalService_alias_1 }
-export { useOptionalService as useOptionalService_alias_2 }
-
-declare interface UseOptionalServiceResult<T> {
-    /**
-     * The service instance if found and loaded successfully, otherwise undefined.
-     */
-    data: T | undefined;
-    /**
-     * Error that occurred during loading (excludes "not found" which is not an error).
-     */
-    error: Error | undefined;
-    /**
-     * True while the service is being loaded.
-     */
-    isLoading: boolean;
-    /**
-     * True if the service was loaded successfully.
-     */
-    isSuccess: boolean;
-    /**
-     * True if the service was not found (not registered in the container).
-     */
-    isNotFound: boolean;
-    /**
-     * True if an error occurred during loading.
-     */
-    isError: boolean;
-    /**
-     * Function to manually re-fetch the service.
-     */
-    refetch: () => void;
-}
-export { UseOptionalServiceResult }
-export { UseOptionalServiceResult as UseOptionalServiceResult_alias_1 }
-export { UseOptionalServiceResult as UseOptionalServiceResult_alias_2 }
-
-/**
- * Hook to get the current scope ID.
- * Returns null if not inside a ScopeProvider.
- */
-declare function useScope(): string | null;
-export { useScope }
-export { useScope as useScope_alias_1 }
-export { useScope as useScope_alias_2 }
-
-/**
- * Hook to get the current scope ID, throwing if not inside a ScopeProvider.
- * Use this when your component requires a scope to function correctly.
- */
-declare function useScopeOrThrow(): string;
-export { useScopeOrThrow }
-export { useScopeOrThrow as useScopeOrThrow_alias_1 }
-export { useScopeOrThrow as useScopeOrThrow_alias_2 }
-
-declare function useService<T extends ClassType>(token: T): UseServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
-
-declare function useService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseServiceResult<T>;
-
-declare function useService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
-
-declare function useService<T>(token: InjectionToken<T, undefined>): UseServiceResult<T>;
-
-declare function useService<T>(token: BoundInjectionToken<T, any>): UseServiceResult<T>;
-
-declare function useService<T>(token: FactoryInjectionToken<T, any>): UseServiceResult<T>;
-export { useService }
-export { useService as useService_alias_1 }
-export { useService as useService_alias_2 }
-
-declare interface UseServiceResult<T> {
-    data: T | undefined;
-    error: Error | undefined;
-    isLoading: boolean;
-    isSuccess: boolean;
-    isError: boolean;
-    refetch: () => void;
-}
-export { UseServiceResult }
-export { UseServiceResult as UseServiceResult_alias_1 }
-export { UseServiceResult as UseServiceResult_alias_2 }
-
-declare function useSuspenseService<T extends ClassType>(token: T): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>;
-
-declare function useSuspenseService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): T;
-
-declare function useSuspenseService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? T : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
-
-declare function useSuspenseService<T>(token: InjectionToken<T, undefined>): T;
-
-declare function useSuspenseService<T>(token: BoundInjectionToken<T, any>): T;
-
-declare function useSuspenseService<T>(token: FactoryInjectionToken<T, any>): T;
-export { useSuspenseService }
-export { useSuspenseService as useSuspenseService_alias_1 }
-export { useSuspenseService as useSuspenseService_alias_2 }
-
-export { }