@mdxui/do 2.1.1 → 4.0.0

package/dist/hooks/index.js

@@ -1,7 +1,9 @@
-export { AdminError, AdminProvider, DO, AdminProvider2 as DotdoAdminProvider, DotdoDataProvider, agentsKeys, createCacheKey, createResourceFromSchema, formatAdminError, inferFieldsFromSchema, invalidateCache, isAdminError, relationshipsKeys, thingsKeys, use$, useAdminContext, useAgent, useAgentExecution, useAgentExecutions, useAgentMetrics, useAgents, useCancelExecution, useCreateAgent, useCreateRelationship, useCreateThing, useCreateWorkflow, useDOAdmin, useDOContext, useDOResource, useDeleteAgent, useDeleteRelationship, useDeleteThing, useDeleteWorkflow, useEntityRelationships, useExecuteAgent, useGraphStats, useGraphTraversal, useIsDOEnabled, useOptimisticUpdate, useRelationships, useSubmitAgentFeedback, useThing, useThingVersions, useThings, useTriggerWorkflow, useTypeStats, useUpdateAgent, useUpdateThing, useUpdateWorkflow, useWorkflow, useWorkflowExecution, useWorkflowExecutions, useWorkflows, workflowsKeys } from '../chunk-EEDMN7UF.js';
-import '../chunk-GKSP5RIA.js';
+export { namespacesKeys, schemaKeys, typesKeys, useBreadcrumbs, useEditHistory, useKeyboardShortcuts, useNamespaces, useSchema, useSchemaDefinition, useSingleThingSubscription, useThingSubscription, useTypes } from '../chunk-NA652ART.js';
+export { useCreateThing, useDeleteThing, useThing, useThingVersions, useThings, useTypeStats, useUpdateThing } from '../chunk-5SHZZC7L.js';
+export { thingsKeys } from '../chunk-4KXVN3EQ.js';
+import '../chunk-WMNT4OIE.js';
+import '../chunk-OVLO7UOH.js';
+import '../chunk-Y52IEYVM.js';
 import '../chunk-GGO5GW72.js';
-import '../chunk-XF6LKY2M.js';
-import '../chunk-G3PMV62Z.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/hooks/things/index.d.ts

@@ -0,0 +1,298 @@
+import { f as ThingQueryResult, T as Thing, j as ThingVersion, k as TypeStats, g as ThingCreateInput, h as ThingUpdateInput, c as ThingFilter, d as ThingSort, e as ThingPagination } from '../../thing-BF25aUtJ.js';
+import { QueryObserverResult } from '@tanstack/react-query';
+export { t as thingsKeys } from '../../query-keys-CZNFikIi.js';
+import 'zod';
+import '../../schemas/index.js';
+import '../../agents-2_r9e9i7.js';
+
+/**
+ * Type definitions for Things hooks
+ *
+ * Provides return types for query and mutation hooks.
+ */
+
+/**
+ * Parameters for useThing, useThingVersions hooks
+ *
+ * The object-based API provides better DX with named parameters.
+ *
+ * @example
+ * ```tsx
+ * // Object-based (preferred)
+ * const { data } = useThing({ ns: 'default', type: 'Task', id: 'task-123' })
+ * ```
+ */
+interface ThingParams {
+    /** Namespace identifier */
+    ns: string;
+    /** Thing type (e.g., 'Task', 'User') */
+    type: string;
+    /** Thing ID */
+    id: string;
+}
+/**
+ * Parameters for useTypeStats hook
+ *
+ * @example
+ * ```tsx
+ * // Object-based (preferred)
+ * const { data } = useTypeStats({ ns: 'default', type: 'Task' })
+ * ```
+ */
+interface TypeStatsParams {
+    /** Namespace identifier */
+    ns: string;
+    /** Thing type (e.g., 'Task', 'User') */
+    type: string;
+}
+/**
+ * Return type for useThings hook
+ */
+interface UseThingsResult {
+    /** The query result data, or null if not yet loaded */
+    data: ThingQueryResult | null;
+    /** True during initial load */
+    isLoading: boolean;
+    /** Error from the query, or null */
+    error: Error | null;
+    /** Function to manually refetch the data */
+    refetch: () => Promise<QueryObserverResult<ThingQueryResult, Error>>;
+    /** The query key used for cache management */
+    queryKey: readonly unknown[];
+    /** True if refetching in the background */
+    isRefetching: boolean;
+    /** True if any fetch is in progress */
+    isFetching: boolean;
+    /** Query status: 'pending', 'success', or 'error' */
+    status: 'pending' | 'success' | 'error';
+}
+/**
+ * Return type for useThing hook
+ */
+interface UseThingResult {
+    /** The Thing data, or null if not yet loaded */
+    data: Thing | null;
+    /** True during initial load */
+    isLoading: boolean;
+    /** Error from the query, or null */
+    error: Error | null;
+    /** Function to manually refetch the data */
+    refetch: () => Promise<QueryObserverResult<Thing, Error>>;
+    /** The query key used for cache management */
+    queryKey: readonly unknown[];
+    /** True if refetching in the background */
+    isRefetching: boolean;
+    /** True if any fetch is in progress */
+    isFetching: boolean;
+    /** Query status: 'pending', 'success', or 'error' */
+    status: 'pending' | 'success' | 'error';
+}
+/**
+ * Return type for useThingVersions hook
+ */
+interface UseThingVersionsResult {
+    /** The versions array, or null if not yet loaded */
+    data: ThingVersion[] | null;
+    /** True during initial load */
+    isLoading: boolean;
+    /** Error from the query, or null */
+    error: Error | null;
+    /** Function to manually refetch the data */
+    refetch: () => Promise<QueryObserverResult<ThingVersion[], Error>>;
+    /** The query key used for cache management */
+    queryKey: readonly unknown[];
+    /** True if refetching in the background */
+    isRefetching: boolean;
+    /** True if any fetch is in progress */
+    isFetching: boolean;
+    /** Query status: 'pending', 'success', or 'error' */
+    status: 'pending' | 'success' | 'error';
+}
+/**
+ * Return type for useTypeStats hook
+ */
+interface UseTypeStatsResult {
+    /** The type statistics, or null if not yet loaded */
+    data: TypeStats | null;
+    /** True during initial load */
+    isLoading: boolean;
+    /** Error from the query, or null */
+    error: Error | null;
+    /** Function to manually refetch the data */
+    refetch: () => Promise<QueryObserverResult<TypeStats, Error>>;
+    /** The query key used for cache management */
+    queryKey: readonly unknown[];
+    /** True if refetching in the background */
+    isRefetching: boolean;
+    /** True if any fetch is in progress */
+    isFetching: boolean;
+    /** Query status: 'pending', 'success', or 'error' */
+    status: 'pending' | 'success' | 'error';
+}
+/**
+ * Return type for useCreateThing hook
+ */
+interface UseCreateThingResult {
+    /** Trigger the mutation */
+    mutate: (input: ThingCreateInput) => void;
+    /** Trigger the mutation and return a promise */
+    mutateAsync: (input: ThingCreateInput) => Promise<Thing>;
+    /** True while mutation is in progress */
+    isLoading: boolean;
+    /** Error from the mutation, or null */
+    error: Error | null;
+    /** True if the mutation succeeded */
+    isSuccess: boolean;
+    /** Reset the mutation state */
+    reset: () => void;
+}
+/**
+ * Return type for useUpdateThing hook
+ */
+interface UseUpdateThingResult {
+    /** Trigger the mutation */
+    mutate: (input: ThingUpdateInput) => void;
+    /** Trigger the mutation and return a promise */
+    mutateAsync: (input: ThingUpdateInput) => Promise<Thing>;
+    /** True while mutation is in progress */
+    isLoading: boolean;
+    /** Error from the mutation, or null */
+    error: Error | null;
+    /** True if the mutation succeeded */
+    isSuccess: boolean;
+    /** Reset the mutation state */
+    reset: () => void;
+}
+/**
+ * Options for delete operation
+ */
+interface DeleteThingOptions {
+    /** If true, permanently delete instead of soft delete */
+    hard?: boolean;
+}
+/**
+ * Return type for useDeleteThing hook
+ */
+interface UseDeleteThingResult {
+    /** Trigger the mutation */
+    mutate: (options?: DeleteThingOptions) => void;
+    /** Trigger the mutation and return a promise */
+    mutateAsync: (options?: DeleteThingOptions) => Promise<void>;
+    /** True while mutation is in progress */
+    isLoading: boolean;
+    /** Error from the mutation, or null */
+    error: Error | null;
+    /** True if the mutation succeeded */
+    isSuccess: boolean;
+    /** Reset the mutation state */
+    reset: () => void;
+}
+
+/**
+ * Hook to fetch a list of Things
+ *
+ * Uses React Query for caching with @dotdo/client RPC for data fetching.
+ */
+declare function useThings(filter?: ThingFilter, sort?: ThingSort, pagination?: ThingPagination): UseThingsResult;
+/**
+ * Hook to fetch a single Thing
+ *
+ * Uses React Query for caching with @dotdo/client RPC calls.
+ *
+ * @example Object-based API (preferred)
+ * ```tsx
+ * const { data } = useThing({ ns: 'default', type: 'Task', id: 'task-123' })
+ * ```
+ *
+ * @example Positional API (deprecated)
+ * ```tsx
+ * const { data } = useThing('default', 'Task', 'task-123')
+ * ```
+ */
+declare function useThing(params: ThingParams): UseThingResult;
+/**
+ * @deprecated Use object-based API: `useThing({ ns, type, id })` instead
+ */
+declare function useThing(ns: string, type: string, id: string): UseThingResult;
+/**
+ * Hook to fetch Thing version history
+ *
+ * @example Object-based API (preferred)
+ * ```tsx
+ * const { data } = useThingVersions({ ns: 'default', type: 'Task', id: 'task-123' })
+ * ```
+ *
+ * @example Positional API (deprecated)
+ * ```tsx
+ * const { data } = useThingVersions('default', 'Task', 'task-123')
+ * ```
+ */
+declare function useThingVersions(params: ThingParams): UseThingVersionsResult;
+/**
+ * @deprecated Use object-based API: `useThingVersions({ ns, type, id })` instead
+ */
+declare function useThingVersions(ns: string, type: string, id: string): UseThingVersionsResult;
+/**
+ * Hook to fetch type statistics
+ *
+ * @example Object-based API (preferred)
+ * ```tsx
+ * const { data } = useTypeStats({ ns: 'default', type: 'Task' })
+ * ```
+ *
+ * @example Positional API (deprecated)
+ * ```tsx
+ * const { data } = useTypeStats('default', 'Task')
+ * ```
+ */
+declare function useTypeStats(params: TypeStatsParams): UseTypeStatsResult;
+/**
+ * @deprecated Use object-based API: `useTypeStats({ ns, type })` instead
+ */
+declare function useTypeStats(ns: string, type: string): UseTypeStatsResult;
+
+/**
+ * Hook to create a Thing
+ *
+ * Automatically invalidates the things list cache on success.
+ *
+ * Supports two modes:
+ * 1. **DataProvider mode**: Uses DataProvider.create() when available (via DoDataProviderProvider)
+ * 2. **RPC mode**: Uses @dotdo/client for backend communication
+ */
+declare function useCreateThing(): UseCreateThingResult;
+/**
+ * Hook to update a Thing
+ *
+ * Automatically invalidates the related cache entries on success.
+ *
+ * @example Object-based API (preferred)
+ * ```tsx
+ * const updateThing = useUpdateThing({ ns: 'default', type: 'Task', id: 'task-123' })
+ * updateThing.mutate({ name: 'Updated Task' })
+ * ```
+ */
+declare function useUpdateThing(params: ThingParams): UseUpdateThingResult;
+/**
+ * @deprecated Use object-based API: `useUpdateThing({ ns, type, id })` instead
+ */
+declare function useUpdateThing(ns: string, type: string, id: string): UseUpdateThingResult;
+/**
+ * Hook to delete a Thing (soft delete by default)
+ *
+ * Automatically invalidates the related cache entries on success.
+ *
+ * @example Object-based API (preferred)
+ * ```tsx
+ * const deleteThing = useDeleteThing({ ns: 'default', type: 'Task', id: 'task-123' })
+ * deleteThing.mutate() // soft delete
+ * deleteThing.mutate({ hard: true }) // hard delete
+ * ```
+ */
+declare function useDeleteThing(params: ThingParams): UseDeleteThingResult;
+/**
+ * @deprecated Use object-based API: `useDeleteThing({ ns, type, id })` instead
+ */
+declare function useDeleteThing(ns: string, type: string, id: string): UseDeleteThingResult;
+
+export { type DeleteThingOptions, type ThingParams, type TypeStatsParams, type UseCreateThingResult, type UseDeleteThingResult, type UseThingResult, type UseThingVersionsResult, type UseThingsResult, type UseTypeStatsResult, type UseUpdateThingResult, useCreateThing, useDeleteThing, useThing, useThingVersions, useThings, useTypeStats, useUpdateThing };

package/dist/hooks/things/index.js

@@ -0,0 +1,8 @@
+export { useCreateThing, useDeleteThing, useThing, useThingVersions, useThings, useTypeStats, useUpdateThing } from '../../chunk-5SHZZC7L.js';
+export { thingsKeys } from '../../chunk-4KXVN3EQ.js';
+import '../../chunk-WMNT4OIE.js';
+import '../../chunk-OVLO7UOH.js';
+import '../../chunk-Y52IEYVM.js';
+import '../../chunk-GGO5GW72.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/hooks/things/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}