@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.76

package/dist/hooks/useDebounce.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hook for debouncing values - reduces frequency of updates
+ * Critical for performance optimization in forms
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+/**
+ * Hook for debouncing callbacks - prevents excessive function calls
+ * Optimizes performance for validation and character counting
+ */
+export declare function useDebouncedCallback<T extends (...args: unknown[]) => void>(callback: T, delay: number): T;
+/**
+ * Hook for throttling callbacks - ensures function doesn't run too frequently
+ * Useful for expensive operations like preview updates
+ */
+export declare function useThrottle<T extends (...args: unknown[]) => void>(callback: T, delay: number): T;
+/**
+ * Hook for optimized form validation with debounce
+ * Specifically designed for react-hook-form integration
+ */
+export declare function useDebouncedValidation(validateFn: () => void, delay?: number): () => void;
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/hooks/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAczD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EACzE,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,GACZ,CAAC,CAgCH;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAChE,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,GACZ,CAAC,CA0CH;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,IAAI,EACtB,KAAK,GAAE,MAAY,SADD,IAAI,CAMvB"}

package/dist/hooks/useEnabledEntities.d.ts

@@ -0,0 +1,25 @@
+import type { EntityConfig } from '../lib/entities/types';
+/**
+ * Hook to get all enabled entities for dynamic navigation
+ * Filters entities based on enabled status and showInMenu flag
+ *
+ * NOTE: Entities must be initialized via EntityProvider in parent server component
+ */
+export declare function useEnabledEntities(): {
+    entities: EntityConfig[];
+    isLoading: boolean;
+    error: Error;
+    refetch: () => void;
+};
+/**
+ * Hook to check if a specific entity is enabled
+ * Optimized to avoid re-calling useEnabledEntities multiple times
+ */
+export declare function useIsEntityEnabled(entityName: string): boolean;
+/**
+ * Hook to get a specific entity configuration from enabled entities list
+ * Optimized to avoid re-calling useEnabledEntities multiple times
+ * @deprecated Use useEntityConfig from './useEntityConfig' for full-featured config loading
+ */
+export declare function useEnabledEntityConfig(entityName: string): EntityConfig | null;
+//# sourceMappingURL=useEnabledEntities.d.ts.map

package/dist/hooks/useEnabledEntities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEnabledEntities.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnabledEntities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,kBAAkB;;;;;EAkDjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAM9E"}

package/dist/hooks/useEnsureUserMetadata.d.ts

@@ -0,0 +1,2 @@
+export declare function useEnsureUserMetadata(): void;
+//# sourceMappingURL=useEnsureUserMetadata.d.ts.map

package/dist/hooks/useEnsureUserMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEnsureUserMetadata.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnsureUserMetadata.ts"],"names":[],"mappings":"AAMA,wBAAgB,qBAAqB,SAuEpC"}

package/dist/hooks/useEntity.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Universal Entity Data Hook
+ *
+ * Provides CRUD operations for any entity based on configuration.
+ * Now powered by TanStack Query for:
+ * - Automatic caching (5min stale, 1hr gc)
+ * - Request deduplication
+ * - Optimistic updates
+ * - Parallel fetching
+ * - Background refetch
+ */
+import type { EntityConfig } from '../lib/entities/types';
+export interface UseEntityOptions {
+    entityConfig: EntityConfig;
+    enableRealtime?: boolean;
+    enableCache?: boolean;
+    pageSize?: number;
+    includeChildren?: boolean;
+    autoFetch?: boolean;
+}
+export interface EntityHookResult {
+    items: Record<string, unknown>[];
+    item: Record<string, unknown> | null;
+    childData: Record<string, unknown>;
+    isLoading: boolean;
+    isCreating: boolean;
+    isUpdating: boolean;
+    isDeleting: boolean;
+    error: string | null;
+    validationErrors: Record<string, string>;
+    currentPage: number;
+    totalPages: number;
+    totalItems: number;
+    searchQuery: string;
+    filters: Record<string, unknown>;
+    sort: {
+        field: string;
+        direction: 'asc' | 'desc';
+    } | null;
+    canCreate: boolean;
+    canRead: boolean;
+    canUpdate: boolean;
+    canDelete: boolean;
+    fetchAll: (options?: {
+        page?: number;
+        search?: string;
+        filters?: Record<string, unknown>;
+    }) => Promise<void>;
+    fetchOne: (id: string) => Promise<void>;
+    create: (data: Record<string, unknown>) => Promise<unknown>;
+    update: (id: string, data: Record<string, unknown>) => Promise<unknown>;
+    delete: (id: string) => Promise<void>;
+    bulkDelete: (ids: string[]) => Promise<void>;
+    setSearchQuery: (query: string) => void;
+    setFilters: (filters: Record<string, unknown>) => void;
+    setSort: (field: string, direction: 'asc' | 'desc') => void;
+    createChild: () => Promise<void>;
+    updateChild: () => Promise<void>;
+    deleteChild: () => Promise<void>;
+    refresh: () => Promise<void>;
+    reset: () => void;
+}
+/**
+ * useEntity - TanStack Query powered entity hook
+ *
+ * Provides complete entity management with automatic caching and optimizations
+ */
+export declare function useEntity(options: UseEntityOptions): EntityHookResult;
+//# sourceMappingURL=useEntity.d.ts.map

package/dist/hooks/useEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntity.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntity.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useEntityConfig.d.ts

@@ -0,0 +1,41 @@
+import { EntityConfig } from '../lib/entities/types';
+interface EntityConfigState {
+    config: EntityConfig | null;
+    isLoading: boolean;
+    error: string | null;
+    isOverride: boolean;
+}
+interface UseEntityConfigOptions {
+    /**
+     * Si true, no muestra logs de debug en consola
+     */
+    silent?: boolean;
+    /**
+     * Si true, cachea la configuración para evitar re-fetches
+     */
+    cache?: boolean;
+}
+/**
+ * Hook centralizado para cargar y manejar configuraciones de entidades
+ * Elimina la duplicación de código entre EntityListWrapper, EntityFormWrapper y EntityDetailWrapper
+ */
+export declare function useEntityConfig(entityType: string, options?: UseEntityConfigOptions): EntityConfigState;
+/**
+ * Función para pre-cargar y cachear todas las configuraciones de entidades
+ * Útil para llamar en el layout principal
+ */
+export declare function preloadEntityConfigs(): void;
+/**
+ * Función para limpiar el cache (útil para testing)
+ */
+export declare function clearEntityConfigCache(): void;
+/**
+ * Función para obtener estadísticas del cache
+ */
+export declare function getEntityConfigCacheStats(): {
+    size: number;
+    entities: string[];
+    registryLoaded: boolean;
+};
+export {};
+//# sourceMappingURL=useEntityConfig.d.ts.map

package/dist/hooks/useEntityConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityConfig.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntityConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,UAAU,iBAAiB;IACzB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,UAAU,sBAAsB;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,iBAAiB,CAsHnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAmB3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;GAEG;AACH,wBAAgB,yBAAyB;;;;EAMxC"}

package/dist/hooks/useEntityMutations.d.ts

@@ -0,0 +1,31 @@
+import type { EntityConfig } from '../lib/entities/types';
+export interface UseEntityMutationsOptions {
+    entityConfig: EntityConfig;
+    onSuccess?: (data: unknown, variables: unknown) => void;
+    onError?: (error: Error, variables: unknown) => void;
+}
+export declare function useEntityMutations(options: UseEntityMutationsOptions): {
+    create: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, Record<string, unknown>, {
+        previousData: [readonly unknown[], unknown][];
+    }>;
+    update: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
+        id: string;
+        data: Record<string, unknown>;
+    }, {
+        previousData: [readonly unknown[], unknown][];
+    }>;
+    delete: import("@tanstack/react-query").UseMutateAsyncFunction<{
+        id: string;
+    }, Error, string, {
+        previousData: [readonly unknown[], unknown][];
+    }>;
+    bulkDelete: import("@tanstack/react-query").UseMutateAsyncFunction<{
+        ids: string[];
+    }, Error, string[], {
+        previousData: [readonly unknown[], unknown][];
+    }>;
+    isCreating: boolean;
+    isUpdating: boolean;
+    isDeleting: boolean;
+};
+//# sourceMappingURL=useEntityMutations.d.ts.map

package/dist/hooks/useEntityMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityMutations.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntityMutations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB;;;;;YA+D1B,MAAM;cAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;EA6J/E"}

package/dist/hooks/useEntityQuery.d.ts

@@ -0,0 +1,207 @@
+import type { EntityConfig } from '../lib/entities/types';
+export interface UseEntityQueryOptions {
+    entityConfig: EntityConfig;
+    pageSize?: number;
+    includeChildren?: boolean;
+    search?: string;
+    filters?: Record<string, unknown>;
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    enabled?: boolean;
+    staleTime?: number;
+    gcTime?: number;
+}
+export interface EntityQueryResult {
+    items: Record<string, unknown>[];
+    total: number;
+    page: number;
+    totalPages: number;
+}
+export declare function useEntityQuery(options: UseEntityQueryOptions): {
+    items: Record<string, unknown>[];
+    total: number;
+    totalPages: number;
+    data: EntityQueryResult;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<EntityQueryResult, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<EntityQueryResult>;
+} | {
+    items: Record<string, unknown>[];
+    total: number;
+    totalPages: number;
+    data: EntityQueryResult;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<EntityQueryResult, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<EntityQueryResult>;
+} | {
+    items: Record<string, unknown>[];
+    total: number;
+    totalPages: number;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<EntityQueryResult, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<EntityQueryResult>;
+} | {
+    items: Record<string, unknown>[];
+    total: number;
+    totalPages: number;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<EntityQueryResult, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<EntityQueryResult>;
+} | {
+    items: Record<string, unknown>[];
+    total: number;
+    totalPages: number;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<EntityQueryResult, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<EntityQueryResult>;
+} | {
+    items: Record<string, unknown>[];
+    total: number;
+    totalPages: number;
+    data: EntityQueryResult;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<EntityQueryResult, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<EntityQueryResult>;
+};
+export declare function useEntityOne(entityConfig: EntityConfig, id: string, options?: {
+    includeChildren?: boolean;
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<any, Error>;
+//# sourceMappingURL=useEntityQuery.d.ts.map

package/dist/hooks/useEntityQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntityQuery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAA;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8E5D;AAGD,wBAAgB,YAAY,CAC1B,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,8DA6B/D"}

package/dist/hooks/useEntitySearch.d.ts

@@ -0,0 +1,35 @@
+import type { EntityConfig } from '../lib/entities/types';
+export interface EntitySearchResult {
+    id: string;
+    title: string;
+    description?: string;
+    entityType: string;
+    type: 'entity' | 'system';
+    url: string;
+    category?: string;
+    priority?: 'low' | 'medium' | 'high';
+    completed?: boolean;
+    icon?: string;
+    limitInfo?: {
+        current: number;
+        max: number | 'unlimited';
+        canCreate: boolean;
+    };
+}
+interface EntitySearchHookResult {
+    query: string;
+    setQuery: (query: string) => void;
+    results: EntitySearchResult[];
+    isSearching: boolean;
+    clearSearch: () => void;
+    hasResults: boolean;
+    isEmpty: boolean;
+    availableEntities: EntityConfig[];
+}
+/**
+ * Enhanced search hook that integrates with the Entity System
+ * Supports automatic entity discovery, permission validation, and plan limits
+ */
+export declare function useEntitySearch(): EntitySearchHookResult;
+export {};
+//# sourceMappingURL=useEntitySearch.d.ts.map

package/dist/hooks/useEntitySearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntitySearch.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntitySearch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACpC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAA;QACf,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;QACzB,SAAS,EAAE,OAAO,CAAA;KACnB,CAAA;CACF;AAED,UAAU,sBAAsB;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,YAAY,EAAE,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,sBAAsB,CA8OxD"}

package/dist/hooks/useEntityTranslations.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Entity Translation Hooks
+ *
+ * React hooks for accessing entity-specific translations
+ */
+/**
+ * Hook to get translations for a specific entity
+ */
+export declare function useEntityTranslations(entityName: string): {
+    translations: Record<string, unknown>;
+    t: (key: string, fallback?: string) => string;
+    hasTranslation: (key: string) => boolean;
+    isLoading: boolean;
+    error: string;
+    reload: () => Promise<void>;
+};
+/**
+ * Hook to get all entity translations for current locale
+ */
+export declare function useAllEntityTranslations(): {
+    translations: Record<string, unknown>;
+    isLoading: boolean;
+    error: string;
+    reload: () => Promise<void>;
+};
+//# sourceMappingURL=useEntityTranslations.d.ts.map

package/dist/hooks/useEntityTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityTranslations.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntityTranslations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM;;aAwC1B,MAAM,aAAa,MAAM,KAAG,MAAM;0BAkBrB,MAAM,KAAG,OAAO;;;;EAuB1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB;;;;;EAmCvC"}

package/dist/hooks/useEntityWithMeta.d.ts

@@ -0,0 +1,80 @@
+import { EntityType } from '../types/meta.types';
+interface UseEntityWithMetaOptions {
+    includeMeta?: string[] | boolean;
+    autoFetch?: boolean;
+    staleTime?: number;
+    gcTime?: number;
+}
+/**
+ * useEntityWithMeta - TanStack Query powered entity + metadata hook
+ *
+ * Provides entity management with metadata support:
+ * - Automatic caching
+ * - Optimistic updates for metadata
+ * - No unnecessary refetches
+ */
+export declare function useEntityWithMeta<T = Record<string, unknown>>(entityType: EntityType, entityId: string, options?: UseEntityWithMetaOptions): {
+    data: import("@tanstack/react-query").NoInfer<T & {
+        meta?: Record<string, unknown>;
+    }>;
+    entity: import("@tanstack/react-query").NoInfer<T & {
+        meta?: Record<string, unknown>;
+    }> & {
+        meta: any;
+    };
+    meta: Record<string, unknown>;
+    loading: boolean;
+    error: string;
+    updateEntity: (updates: Partial<T>, metaUpdates?: Record<string, unknown>) => Promise<any>;
+    updateMeta: (metaUpdates: Record<string, unknown>) => Promise<any>;
+    getMeta: <MetaT = unknown>(metaKey: string, defaultValue?: MetaT) => MetaT;
+    hasMeta: (metaKey: string) => boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").NoInfer<T & {
+        meta?: Record<string, unknown>;
+    }>, Error>>;
+    isUpdating: boolean;
+};
+export declare function useUserWithMeta(userId: string, options?: UseEntityWithMetaOptions): {
+    data: Record<string, unknown> & {
+        meta?: Record<string, unknown>;
+    };
+    entity: Record<string, unknown> & {
+        meta?: Record<string, unknown>;
+    } & {
+        meta: any;
+    };
+    meta: Record<string, unknown>;
+    loading: boolean;
+    error: string;
+    updateEntity: (updates: Partial<Record<string, unknown>>, metaUpdates?: Record<string, unknown>) => Promise<any>;
+    updateMeta: (metaUpdates: Record<string, unknown>) => Promise<any>;
+    getMeta: <MetaT = unknown>(metaKey: string, defaultValue?: MetaT) => MetaT;
+    hasMeta: (metaKey: string) => boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<Record<string, unknown> & {
+        meta?: Record<string, unknown>;
+    }, Error>>;
+    isUpdating: boolean;
+};
+export declare function useTaskWithMeta(taskId: string, options?: UseEntityWithMetaOptions): {
+    data: Record<string, unknown> & {
+        meta?: Record<string, unknown>;
+    };
+    entity: Record<string, unknown> & {
+        meta?: Record<string, unknown>;
+    } & {
+        meta: any;
+    };
+    meta: Record<string, unknown>;
+    loading: boolean;
+    error: string;
+    updateEntity: (updates: Partial<Record<string, unknown>>, metaUpdates?: Record<string, unknown>) => Promise<any>;
+    updateMeta: (metaUpdates: Record<string, unknown>) => Promise<any>;
+    getMeta: <MetaT = unknown>(metaKey: string, defaultValue?: MetaT) => MetaT;
+    hasMeta: (metaKey: string) => boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<Record<string, unknown> & {
+        meta?: Record<string, unknown>;
+    }, Error>>;
+    isUpdating: boolean;
+};
+export {};
+//# sourceMappingURL=useEntityWithMeta.d.ts.map

package/dist/hooks/useEntityWithMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityWithMeta.d.ts","sourceRoot":"","sources":["../../src/hooks/useEntityWithMeta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErE,UAAU,wBAAwB;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAChC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B;;eAsBF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;eAAvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;4BA4GhD,OAAO,CAAC,CAAC,CAAC,gBACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8BAPA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAa7C,KAAK,qBAAqB,MAAM,iBAAiB,KAAK,KAAG,KAAK;uBAKrD,MAAM,KAAG,OAAO;;eAxHN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAyI5D;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB;;eA5I5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;eAAvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;4EA6G3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8BAPA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAa7C,KAAK,qBAAqB,MAAM;uBAKvB,MAAM,KAAG,OAAO;;eAxHN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EA8I5D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB;;eAhJ5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;eAAvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;4EA6G3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8BAPA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAa7C,KAAK,qBAAqB,MAAM;uBAKvB,MAAM,KAAG,OAAO;;eAxHN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAkJ5D"}

package/dist/hooks/useFeature.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Hook to check if a feature is available on the current plan
+ *
+ * @param featureSlug - The slug of the feature to check (e.g., 'advanced_analytics')
+ * @returns boolean - Whether the feature is available
+ *
+ * @example
+ * ```tsx
+ * const hasAdvancedAnalytics = useFeature('advanced_analytics')
+ * if (hasAdvancedAnalytics) {
+ *   // Show advanced analytics UI
+ * }
+ * ```
+ */
+export declare function useFeature(featureSlug: string): boolean;
+//# sourceMappingURL=useFeature.d.ts.map

package/dist/hooks/useFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeature.d.ts","sourceRoot":"","sources":["../../src/hooks/useFeature.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAavD"}

package/dist/hooks/useInvoice.d.ts

@@ -0,0 +1,14 @@
+import type { Invoice } from '../components/billing';
+interface UseInvoiceOptions {
+    invoiceNumber: string;
+    enabled?: boolean;
+}
+interface InvoiceResponse {
+    success: boolean;
+    data: Invoice & {
+        description?: string;
+    };
+}
+export declare function useInvoice(options: UseInvoiceOptions): import("@tanstack/react-query").UseQueryResult<InvoiceResponse, Error>;
+export {};
+//# sourceMappingURL=useInvoice.d.ts.map

package/dist/hooks/useInvoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInvoice.d.ts","sourceRoot":"","sources":["../../src/hooks/useInvoice.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEpD,UAAU,iBAAiB;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,GAAG;QACd,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,0EA0BpD"}

package/dist/hooks/useInvoices.d.ts

@@ -0,0 +1,21 @@
+import type { Invoice } from '../components/billing';
+interface UseInvoicesOptions {
+    limit?: number;
+    offset?: number;
+    enabled?: boolean;
+}
+interface InvoicesResponse {
+    success: boolean;
+    data: Invoice[];
+    info: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPrevPage: boolean;
+    };
+}
+export declare function useInvoices(options?: UseInvoicesOptions): import("@tanstack/react-query").UseQueryResult<InvoicesResponse, Error>;
+export {};
+//# sourceMappingURL=useInvoices.d.ts.map

package/dist/hooks/useInvoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInvoices.d.ts","sourceRoot":"","sources":["../../src/hooks/useInvoices.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEpD,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,OAAO,CAAA;QACpB,WAAW,EAAE,OAAO,CAAA;KACrB,CAAA;CACF;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,2EA0B3D"}