@mdxui/do 4.0.0 → 4.0.8

package/dist/{lib → client}/index.d.ts

@@ -1,102 +1,6 @@
-export { A as APIError, D as DEFAULT_REQUEST_TIMEOUT, F as FetchWithTimeoutOptions, N as NetworkError, R as RetryConfig, S as SyncError, V as ValidationError, c as camelToTitle, a as capitalize, b as cn, v as createFetchWithTimeout, d as debounce, f as fetchWithTimeout, e as formatBytes, g as formatDate, h as formatDateTime, i as formatDuration, j as formatNumber, k as formatRelativeTime, l as formatSemanticId, m as generateId, n as groupBy, o as isAPIError, p as isNetworkError, q as isSyncError, r as isValidationError, s as parseSemanticId, u as retryWithBackoff, t as truncate } from '../errors-DratdVIz.js';
-export { P as Pagination, Q as QueryKeys, a as agentsKeys, c as createQueryKeys, r as relationshipsKeys, t as thingsKeys, w as workflowsKeys } from '../query-keys-CZNFikIi.js';
+export { $ as $DOContext, D as DOContextClient, a as DOContextOptions, S as SQLResult, c as createDOClient } from '../dotdo-client-2DkwXHM2.js';
 import * as zod from 'zod';
-import { T as Thing, S as SemanticType } from '../thing-BF25aUtJ.js';
-export { $ as $CapnwebContext, c as createCapnwebClient } from '../capnweb-client-Bq78FtEA.js';
-import 'clsx';
-import '../schemas/index.js';
-import '../agents-2_r9e9i7.js';
-
-/**
- * URL utilities for @mdxui/do
- *
- * Provides functions to normalize and derive URLs from the configuration.
- * These utilities ensure consistent URL formatting across the package.
- *
- * @module
- */
-/**
- * Normalize a URL to an RPC endpoint
- *
- * Transforms various URL formats into a consistent RPC endpoint URL:
- * - Converts wss:// to https:// and ws:// to http://
- * - Strips trailing /sync or /rpc if present
- * - Appends /rpc
- *
- * @param url - The base URL (e.g., 'https://api.do/admin' or 'wss://api.do/do/workspace')
- * @returns The normalized RPC URL (e.g., 'https://api.do/admin/rpc')
- *
- * @example
- * ```typescript
- * deriveRpcUrl('https://api.do/admin')
- * // => 'https://api.do/admin/rpc'
- *
- * deriveRpcUrl('wss://api.do/do/workspace/sync')
- * // => 'https://api.do/do/workspace/rpc'
- *
- * deriveRpcUrl('https://api.do/admin/rpc')
- * // => 'https://api.do/admin/rpc' (unchanged)
- * ```
- */
-declare function deriveRpcUrl(url: string): string;
-
-/**
- * Configuration for health check behavior
- */
-interface HealthCheckConfig {
-    /** API endpoint base URL (e.g., 'https://api.do/admin') */
-    apiEndpoint: string;
-    /** Optional auth token for Bearer authentication */
-    authToken?: string;
-    /** Request timeout in milliseconds (defaults to DEFAULT_REQUEST_TIMEOUT) */
-    requestTimeout?: number;
-    /** Number of retry attempts (defaults to 3) */
-    healthCheckRetries?: number;
-}
-/**
- * Result of the health check hook
- */
-interface HealthCheckResult {
-    /** Whether the API is reachable */
-    isConnected: boolean;
-    /** Error from the last failed attempt, if any */
-    connectionError?: Error;
-    /** Manually trigger a health check */
-    checkConnection: () => Promise<void>;
-    /** Whether a check is currently in progress */
-    isChecking: boolean;
-}
-/**
- * Hook to perform health checks against an API endpoint
- *
- * Automatically checks connection on mount with retry and exponential backoff.
- * Can also be manually triggered via the returned `checkConnection` function.
- *
- * @param config - Health check configuration
- * @returns Health check state and manual trigger function
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { isConnected, connectionError, checkConnection } = useHealthCheck({
- *     apiEndpoint: 'https://api.do/admin',
- *     authToken: 'my-token',
- *     healthCheckRetries: 3,
- *   })
- *
- *   if (connectionError) {
- *     return <div>Connection failed: {connectionError.message}</div>
- *   }
- *
- *   if (!isConnected) {
- *     return <div>Connecting...</div>
- *   }
- *
- *   return <div>Connected!</div>
- * }
- * ```
- */
-declare function useHealthCheck(config: HealthCheckConfig): HealthCheckResult;
+import { T as Thing, S as SemanticType } from '../thing-Dc3AE2XI.js';
 
 interface MockClientOptions {
     /** Initial data to populate the store */
@@ -143,7 +47,6 @@ declare function createMockClient(options?: MockClientOptions): {
             label: string;
             id: string;
             name: string;
-            namespace: string;
             properties: {
                 label: string;
                 name: string;
@@ -154,6 +57,7 @@ declare function createMockClient(options?: MockClientOptions): {
                 isArray: boolean;
                 defaultValue?: unknown;
             }[];
+            namespace: string;
             parentTypes: string[];
             subtypes: string[];
             description?: string | undefined;
@@ -192,10 +96,10 @@ declare function createMockClient(options?: MockClientOptions): {
                 id: string;
                 type: string;
                 name: string;
-                ns: string;
-                ts: Date;
                 createdAt: Date;
                 updatedAt: Date;
+                ns: string;
+                ts: Date;
                 variant?: string | undefined;
                 createdBy?: string | undefined;
                 updatedBy?: string | undefined;
@@ -218,10 +122,10 @@ declare function createMockClient(options?: MockClientOptions): {
             id: string;
             type: string;
             name: string;
-            ns: string;
-            ts: Date;
             createdAt: Date;
             updatedAt: Date;
+            ns: string;
+            ts: Date;
             variant?: string | undefined;
             createdBy?: string | undefined;
             updatedBy?: string | undefined;
@@ -243,10 +147,10 @@ declare function createMockClient(options?: MockClientOptions): {
             id: string;
             type: string;
             name: string;
-            ns: string;
-            ts: Date;
             createdAt: Date;
             updatedAt: Date;
+            ns: string;
+            ts: Date;
             variant?: string | undefined;
             createdBy?: string | undefined;
             updatedBy?: string | undefined;
@@ -268,10 +172,10 @@ declare function createMockClient(options?: MockClientOptions): {
             id: string;
             type: string;
             name: string;
-            ns: string;
-            ts: Date;
             createdAt: Date;
             updatedAt: Date;
+            ns: string;
+            ts: Date;
             variant?: string | undefined;
             createdBy?: string | undefined;
             updatedBy?: string | undefined;
@@ -362,7 +266,6 @@ declare function $MockContext(options?: MockClientOptions): {
             label: string;
             id: string;
             name: string;
-            namespace: string;
             properties: {
                 label: string;
                 name: string;
@@ -373,6 +276,7 @@ declare function $MockContext(options?: MockClientOptions): {
                 isArray: boolean;
                 defaultValue?: unknown;
             }[];
+            namespace: string;
             parentTypes: string[];
             subtypes: string[];
             description?: string | undefined;
@@ -411,10 +315,10 @@ declare function $MockContext(options?: MockClientOptions): {
                 id: string;
                 type: string;
                 name: string;
-                ns: string;
-                ts: Date;
                 createdAt: Date;
                 updatedAt: Date;
+                ns: string;
+                ts: Date;
                 variant?: string | undefined;
                 createdBy?: string | undefined;
                 updatedBy?: string | undefined;
@@ -437,10 +341,10 @@ declare function $MockContext(options?: MockClientOptions): {
             id: string;
             type: string;
             name: string;
-            ns: string;
-            ts: Date;
             createdAt: Date;
             updatedAt: Date;
+            ns: string;
+            ts: Date;
             variant?: string | undefined;
             createdBy?: string | undefined;
             updatedBy?: string | undefined;
@@ -462,10 +366,10 @@ declare function $MockContext(options?: MockClientOptions): {
             id: string;
             type: string;
             name: string;
-            ns: string;
-            ts: Date;
             createdAt: Date;
             updatedAt: Date;
+            ns: string;
+            ts: Date;
             variant?: string | undefined;
             createdBy?: string | undefined;
             updatedBy?: string | undefined;
@@ -487,10 +391,10 @@ declare function $MockContext(options?: MockClientOptions): {
             id: string;
             type: string;
             name: string;
-            ns: string;
-            ts: Date;
             createdAt: Date;
             updatedAt: Date;
+            ns: string;
+            ts: Date;
             variant?: string | undefined;
             createdBy?: string | undefined;
             updatedBy?: string | undefined;
@@ -549,234 +453,6 @@ declare function $MockContext(options?: MockClientOptions): {
     _reset: () => void;
 };
 
-/**
- * JSON-RPC Client for DO Admin API
- *
- * This client wraps the JSON-RPC API exposed by DO admin servers,
- * translating the standard Thing/Schema interface to the server's
- * actual RPC methods.
- *
- * Auto-discovers available types and endpoints from the server.
- *
- * @module
- */
-/** SQL execution result */
-interface SQLResult {
-    rows: Record<string, unknown>[];
-    columns: {
-        name: string;
-        type: string;
-    }[];
-    rowsAffected?: number;
-    executionTimeMs?: number;
-}
-interface JsonRpcClientOptions {
-    /** Auth token to include in Authorization header */
-    authToken?: string;
-}
-/**
- * Create a JSON-RPC compatible client that matches the DOClient interface
- */
-declare function createJsonRpcClient(baseUrl: string, options?: JsonRpcClientOptions): {
-    /**
-     * Namespace operations
-     */
-    Namespace: {
-        list(_params?: {
-            includeSystem?: boolean;
-        }): Promise<{
-            id: string;
-            name: string;
-        }[]>;
-    };
-    /**
-     * Schema operations
-     */
-    Schema: {
-        discover(_params?: {
-            ns?: string;
-        }): Promise<{
-            namespaces: string[];
-            types: string[];
-            schemas: string[];
-        }>;
-        get(params: {
-            ns?: string;
-            type: string;
-        }): Promise<unknown>;
-    };
-    /**
-     * Thing operations (maps to REST endpoints)
-     */
-    Thing: {
-        types(params: {
-            ns?: string;
-            includeSystem?: boolean;
-        }): Promise<{
-            name: string;
-            ns: string;
-        }[]>;
-        list(params: {
-            ns?: string;
-            type?: string;
-            limit?: number;
-            offset?: number;
-        }): Promise<{
-            data: unknown[];
-            total: number;
-        }>;
-        get(params: {
-            ns?: string;
-            type: string;
-            id: string;
-        }): Promise<unknown>;
-        create(params: {
-            ns?: string;
-            type: string;
-            data: unknown;
-        }): Promise<unknown>;
-        update(params: {
-            ns?: string;
-            type: string;
-            id: string;
-            data: unknown;
-        }): Promise<unknown>;
-        delete(params: {
-            ns?: string;
-            type: string;
-            id: string;
-            hard?: boolean;
-        }): Promise<{
-            success: boolean;
-        }>;
-        versions(_params: {
-            ns?: string;
-            type: string;
-            id: string;
-        }): Promise<never[]>;
-        stats(_params: {
-            ns?: string;
-            type?: string;
-        }): Promise<{
-            total: number;
-            byType: Record<string, number>;
-        }>;
-    };
-    /**
-     * SQL operations
-     */
-    SQL: {
-        execute(params: {
-            query: string;
-            params?: unknown[];
-        }): Promise<SQLResult>;
-    };
-    dup: () => /*elided*/ any;
-    onRpcBroken: (_callback: (error: unknown) => void) => void;
-    [Symbol.dispose]: () => void;
-};
-/**
- * Create a client context - factory function matching $Context interface
- */
-declare function $JsonRpcContext(url: string, options?: JsonRpcClientOptions): {
-    /**
-     * Namespace operations
-     */
-    Namespace: {
-        list(_params?: {
-            includeSystem?: boolean;
-        }): Promise<{
-            id: string;
-            name: string;
-        }[]>;
-    };
-    /**
-     * Schema operations
-     */
-    Schema: {
-        discover(_params?: {
-            ns?: string;
-        }): Promise<{
-            namespaces: string[];
-            types: string[];
-            schemas: string[];
-        }>;
-        get(params: {
-            ns?: string;
-            type: string;
-        }): Promise<unknown>;
-    };
-    /**
-     * Thing operations (maps to REST endpoints)
-     */
-    Thing: {
-        types(params: {
-            ns?: string;
-            includeSystem?: boolean;
-        }): Promise<{
-            name: string;
-            ns: string;
-        }[]>;
-        list(params: {
-            ns?: string;
-            type?: string;
-            limit?: number;
-            offset?: number;
-        }): Promise<{
-            data: unknown[];
-            total: number;
-        }>;
-        get(params: {
-            ns?: string;
-            type: string;
-            id: string;
-        }): Promise<unknown>;
-        create(params: {
-            ns?: string;
-            type: string;
-            data: unknown;
-        }): Promise<unknown>;
-        update(params: {
-            ns?: string;
-            type: string;
-            id: string;
-            data: unknown;
-        }): Promise<unknown>;
-        delete(params: {
-            ns?: string;
-            type: string;
-            id: string;
-            hard?: boolean;
-        }): Promise<{
-            success: boolean;
-        }>;
-        versions(_params: {
-            ns?: string;
-            type: string;
-            id: string;
-        }): Promise<never[]>;
-        stats(_params: {
-            ns?: string;
-            type?: string;
-        }): Promise<{
-            total: number;
-            byType: Record<string, number>;
-        }>;
-    };
-    /**
-     * SQL operations
-     */
-    SQL: {
-        execute(params: {
-            query: string;
-            params?: unknown[];
-        }): Promise<SQLResult>;
-    };
-    dup: () => /*elided*/ any;
-    onRpcBroken: (_callback: (error: unknown) => void) => void;
-    [Symbol.dispose]: () => void;
-};
-
 /**
  * Mock Data Generators for DO Admin
  *
@@ -795,4 +471,80 @@ declare function generateMockThings(type: string, count: number): Thing[];
  */
 declare function generateInitialMockData(): Thing[];
 
-export { $JsonRpcContext, $MockContext, type HealthCheckConfig, type HealthCheckResult, MOCK_TYPES, createJsonRpcClient, createMockClient, deriveRpcUrl, generateInitialMockData, generateMockSchema, generateMockThing, generateMockThings, useHealthCheck };
+/**
+ * Fetch wrapper with configurable timeout
+ *
+ * Prevents indefinite hangs on slow networks or unresponsive servers
+ * by wrapping fetch with AbortController-based timeout.
+ *
+ * @module
+ */
+/**
+ * Default timeout in milliseconds (30 seconds)
+ */
+declare const DEFAULT_REQUEST_TIMEOUT = 30000;
+/**
+ * Extended RequestInit that includes optional timeout
+ */
+interface FetchWithTimeoutOptions extends RequestInit {
+    /** Timeout in milliseconds. Defaults to 30000 (30 seconds) */
+    timeout?: number;
+}
+/**
+ * Fetch wrapper with configurable timeout
+ *
+ * Uses AbortController to cancel requests that exceed the timeout.
+ * If the request already has a signal, a composite abort will be used
+ * that respects both the existing signal and the timeout.
+ *
+ * @param url - The URL to fetch
+ * @param options - Fetch options including optional timeout
+ * @returns Promise resolving to the Response
+ * @throws {DOMException} AbortError if the request times out
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with default 30s timeout
+ * const response = await fetchWithTimeout('https://api.example.com/data')
+ *
+ * // Custom timeout
+ * const response = await fetchWithTimeout('https://api.example.com/data', {
+ *   timeout: 5000, // 5 seconds
+ * })
+ *
+ * // With other fetch options
+ * const response = await fetchWithTimeout('https://api.example.com/data', {
+ *   method: 'POST',
+ *   headers: { 'Content-Type': 'application/json' },
+ *   body: JSON.stringify({ key: 'value' }),
+ *   timeout: 10000,
+ * })
+ * ```
+ */
+declare function fetchWithTimeout(url: string, options?: FetchWithTimeoutOptions): Promise<Response>;
+/**
+ * Create a fetch wrapper with a default timeout from config
+ *
+ * Useful for creating a configured fetch function that can be shared
+ * across multiple hooks/components with consistent timeout behavior.
+ *
+ * @param defaultTimeout - Default timeout in milliseconds
+ * @returns A fetch function with the default timeout applied
+ *
+ * @example
+ * ```typescript
+ * // Create a configured fetch
+ * const configuredFetch = createFetchWithTimeout(5000)
+ *
+ * // Use it (timeout defaults to 5000ms)
+ * const response = await configuredFetch('https://api.example.com/data')
+ *
+ * // Override the default timeout
+ * const response = await configuredFetch('https://api.example.com/data', {
+ *   timeout: 10000,
+ * })
+ * ```
+ */
+declare function createFetchWithTimeout(defaultTimeout: number): (url: string, options?: FetchWithTimeoutOptions) => Promise<Response>;
+
+export { $MockContext, DEFAULT_REQUEST_TIMEOUT, type FetchWithTimeoutOptions, MOCK_TYPES, type MockClientOptions, createFetchWithTimeout, createMockClient, fetchWithTimeout, generateInitialMockData, generateMockSchema, generateMockThing, generateMockThings };

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { $DOContext, $MockContext, DEFAULT_REQUEST_TIMEOUT, MOCK_TYPES, createDOClient, createFetchWithTimeout, createMockClient, fetchWithTimeout, generateInitialMockData, generateMockSchema, generateMockThing, generateMockThings } from '../chunk-KLN5OTQH.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map