@mdxui/do 4.0.0 → 4.0.8

package/dist/common-DW_JM2dW.d.ts

@@ -0,0 +1,454 @@
+import { z } from 'zod';
+
+/**
+ * Common Zod Schemas - Shared Schema Definitions
+ *
+ * This file contains Zod schemas that are used across multiple domains.
+ * Types are derived from these schemas to ensure a single source of truth.
+ *
+ * @remarks
+ * Import schemas from here for validation.
+ * Import types from here or from domain files for TypeScript types.
+ */
+
+/**
+ * Schema for Date fields that can be either Date objects or ISO strings.
+ * API responses typically return ISO strings, not Date objects.
+ */
+declare const DateSchema: z.ZodDate;
+/**
+ * Optional nullable date for responses
+ */
+declare const OptionalDateSchema: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodNull]>>;
+/**
+ * Schema for EntityReference - reference to a Thing in the semantic graph.
+ *
+ * Used by:
+ * - Relationships (subject/object in semantic triples)
+ * - Events (subject/object in semantic events)
+ * - Graph traversal results
+ */
+declare const EntityReferenceSchema: z.ZodObject<{
+    /** Namespace */
+    ns: z.ZodString;
+    /** Entity type */
+    type: z.ZodString;
+    /** Entity ID */
+    id: z.ZodString;
+    /** Semantic ID (ns/type/id) */
+    semanticId: z.ZodString;
+    /** Display name (if loaded) */
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: string;
+    ns: string;
+    semanticId: string;
+    name?: string | undefined;
+}, {
+    id: string;
+    type: string;
+    ns: string;
+    semanticId: string;
+    name?: string | undefined;
+}>;
+/**
+ * Reference to an entity (Thing) in the semantic graph.
+ */
+type EntityReference = z.infer<typeof EntityReferenceSchema>;
+/**
+ * Schema for TokenUsage - token usage metrics for AI operations.
+ *
+ * Used by:
+ * - Agent executions
+ * - Function executions (generative/agentic)
+ * - Agent trace entries
+ */
+declare const TokenUsageSchema: z.ZodObject<{
+    /** Input/prompt tokens */
+    inputTokens: z.ZodNumber;
+    /** Output/completion tokens */
+    outputTokens: z.ZodNumber;
+    /** Total tokens (input + output) */
+    totalTokens: z.ZodNumber;
+    /** Thinking tokens (for reasoning models like o1, Claude with thinking) */
+    thinkingTokens: z.ZodOptional<z.ZodNumber>;
+    /** Estimated cost in USD */
+    costUsd: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    thinkingTokens?: number | undefined;
+    costUsd?: number | undefined;
+}, {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    thinkingTokens?: number | undefined;
+    costUsd?: number | undefined;
+}>;
+/**
+ * Token usage metrics for AI operations.
+ */
+type TokenUsage = z.infer<typeof TokenUsageSchema>;
+/**
+ * Schema for ExecutionError - error information for execution failures.
+ *
+ * Used by:
+ * - Workflow executions
+ * - Function executions
+ * - Step executions
+ */
+declare const ExecutionErrorSchema: z.ZodObject<{
+    /** Error code (e.g., 'TIMEOUT', 'VALIDATION_ERROR', 'RATE_LIMITED') */
+    code: z.ZodString;
+    /** Human-readable error message */
+    message: z.ZodString;
+    /** Stack trace (for debugging) */
+    stack: z.ZodOptional<z.ZodString>;
+    /** ID of the step that failed (for workflow executions) */
+    failedStep: z.ZodOptional<z.ZodString>;
+    /** Number of retry attempts made (for function executions) */
+    retryCount: z.ZodOptional<z.ZodNumber>;
+    /** Whether this error is retryable (for function executions) */
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    stack?: string | undefined;
+    failedStep?: string | undefined;
+    retryCount?: number | undefined;
+    retryable?: boolean | undefined;
+}, {
+    code: string;
+    message: string;
+    stack?: string | undefined;
+    failedStep?: string | undefined;
+    retryCount?: number | undefined;
+    retryable?: boolean | undefined;
+}>;
+/**
+ * Error information for execution failures.
+ */
+type ExecutionError = z.infer<typeof ExecutionErrorSchema>;
+/**
+ * Schema for SortDirection - sort direction for list queries.
+ */
+declare const SortDirectionSchema: z.ZodEnum<["asc", "desc"]>;
+/**
+ * Sort direction for list queries.
+ */
+type SortDirection = z.infer<typeof SortDirectionSchema>;
+/**
+ * Schema factory for sort parameters.
+ */
+declare const SortParamsSchema: <T extends z.ZodTypeAny>(fieldSchema: T) => z.ZodObject<{
+    /** Field to sort by */
+    field: T;
+    /** Sort direction */
+    order: z.ZodEnum<["asc", "desc"]>;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    /** Field to sort by */
+    field: T;
+    /** Sort direction */
+    order: z.ZodEnum<["asc", "desc"]>;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    /** Field to sort by */
+    field: T;
+    /** Sort direction */
+    order: z.ZodEnum<["asc", "desc"]>;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * Sort parameters for list queries.
+ */
+interface SortParams<T = string> {
+    field: T;
+    order: SortDirection;
+}
+/**
+ * Schema for date range filters.
+ */
+declare const DateRangeFilterSchema: z.ZodObject<{
+    /** Start of the date range */
+    after: z.ZodOptional<z.ZodDate>;
+    /** End of the date range */
+    before: z.ZodOptional<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    after?: Date | undefined;
+    before?: Date | undefined;
+}, {
+    after?: Date | undefined;
+    before?: Date | undefined;
+}>;
+/**
+ * Date range filter for queries.
+ */
+type DateRangeFilter = z.infer<typeof DateRangeFilterSchema>;
+/**
+ * Schema for common record metadata.
+ */
+declare const RecordMetadataSchema: z.ZodObject<{
+    /** Creation timestamp */
+    createdAt: z.ZodDate;
+    /** Last update timestamp */
+    updatedAt: z.ZodDate;
+    /** Creator user ID */
+    createdBy: z.ZodOptional<z.ZodString>;
+    /** Last updater user ID */
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+}, {
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+}>;
+/**
+ * Common record metadata (timestamps and user tracking).
+ */
+type RecordMetadata = z.infer<typeof RecordMetadataSchema>;
+/**
+ * Schema for soft-deletable records.
+ */
+declare const SoftDeletableSchema: z.ZodObject<{
+    /** Soft delete timestamp */
+    deletedAt: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodNull]>>;
+    /** User who deleted the record */
+    deletedBy: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    deletedAt?: Date | null | undefined;
+    deletedBy?: string | undefined;
+}, {
+    deletedAt?: Date | null | undefined;
+    deletedBy?: string | undefined;
+}>;
+/**
+ * Soft-deletable record fields.
+ */
+type SoftDeletable = z.infer<typeof SoftDeletableSchema>;
+/**
+ * Schema for audit trail entries.
+ */
+declare const AuditEntrySchema: z.ZodObject<{
+    /** Action performed */
+    action: z.ZodEnum<["create", "update", "delete", "read"]>;
+    /** User who performed the action */
+    userId: z.ZodString;
+    /** Timestamp of the action */
+    timestamp: z.ZodDate;
+    /** Type of resource affected */
+    resourceType: z.ZodString;
+    /** ID of resource affected */
+    resourceId: z.ZodString;
+    /** Field changes (for updates) */
+    changes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        old: z.ZodUnknown;
+        new: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        old?: unknown;
+        new?: unknown;
+    }, {
+        old?: unknown;
+        new?: unknown;
+    }>>>;
+    /** Additional metadata */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    action: "delete" | "create" | "update" | "read";
+    userId: string;
+    timestamp: Date;
+    resourceType: string;
+    resourceId: string;
+    metadata?: Record<string, unknown> | undefined;
+    changes?: Record<string, {
+        old?: unknown;
+        new?: unknown;
+    }> | undefined;
+}, {
+    action: "delete" | "create" | "update" | "read";
+    userId: string;
+    timestamp: Date;
+    resourceType: string;
+    resourceId: string;
+    metadata?: Record<string, unknown> | undefined;
+    changes?: Record<string, {
+        old?: unknown;
+        new?: unknown;
+    }> | undefined;
+}>;
+/**
+ * Audit trail entry for tracking changes.
+ */
+type AuditEntry = z.infer<typeof AuditEntrySchema>;
+/**
+ * Schema for semantic ID components.
+ */
+declare const SemanticIdComponentsSchema: z.ZodObject<{
+    /** Namespace */
+    ns: z.ZodString;
+    /** Entity type */
+    type: z.ZodString;
+    /** Entity ID */
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: string;
+    ns: string;
+}, {
+    id: string;
+    type: string;
+    ns: string;
+}>;
+/**
+ * Parsed semantic ID components (ns/type/id).
+ */
+type SemanticIdComponents = z.infer<typeof SemanticIdComponentsSchema>;
+/**
+ * Semantic ID string type (ns/type/id format).
+ */
+type SemanticId = `${string}/${string}/${string}`;
+/**
+ * Schema for Pagination - pagination input parameters for list queries.
+ */
+declare const PaginationSchema: z.ZodObject<{
+    /** Page number (1-indexed) */
+    page: z.ZodNumber;
+    /** Items per page */
+    perPage: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    perPage: number;
+}, {
+    page: number;
+    perPage: number;
+}>;
+/**
+ * Pagination input parameters for list queries.
+ */
+type Pagination = z.infer<typeof PaginationSchema>;
+/**
+ * Schema for pagination parameters with cursor support.
+ */
+declare const PaginationParamsSchema: z.ZodObject<{
+    /** Page number (1-indexed) */
+    page: z.ZodOptional<z.ZodNumber>;
+    /** Items per page */
+    perPage: z.ZodOptional<z.ZodNumber>;
+    /** Cursor for keyset pagination */
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    cursor?: string | undefined;
+    page?: number | undefined;
+    perPage?: number | undefined;
+}, {
+    cursor?: string | undefined;
+    page?: number | undefined;
+    perPage?: number | undefined;
+}>;
+/**
+ * Pagination parameters (page-based or cursor-based).
+ */
+type PaginationParams = z.infer<typeof PaginationParamsSchema>;
+/**
+ * Schema factory for paginated responses.
+ */
+declare const PaginatedResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    /** Array of items for the current page */
+    data: z.ZodArray<T, "many">;
+    /** Total number of items across all pages */
+    total: z.ZodNumber;
+    /** Current page number (1-indexed) */
+    page: z.ZodNumber;
+    /** Items per page */
+    perPage: z.ZodNumber;
+    /** Total number of pages */
+    totalPages: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
+    page: number;
+    total: number;
+    perPage: number;
+    totalPages: number;
+}, {
+    data: T["_input"][];
+    page: number;
+    total: number;
+    perPage: number;
+    totalPages: number;
+}>;
+/**
+ * Paginated response wrapper for list queries.
+ */
+interface PaginatedResponse<T> {
+    /** Array of items for the current page */
+    data: T[];
+    /** Total number of items across all pages */
+    total: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    perPage: number;
+    /** Total number of pages */
+    totalPages: number;
+}
+/**
+ * Schema factory for paginated results with hasMore and cursor support.
+ */
+declare const PaginatedResultSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    /** Array of items for the current page */
+    data: z.ZodArray<T, "many">;
+    /** Total number of items across all pages */
+    total: z.ZodNumber;
+    /** Current page number (1-indexed) */
+    page: z.ZodNumber;
+    /** Items per page */
+    perPage: z.ZodNumber;
+    /** Total number of pages */
+    totalPages: z.ZodNumber;
+    /** Whether there are more pages */
+    hasMore: z.ZodBoolean;
+    /** Cursor for next page (if using cursor-based pagination) */
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
+    page: number;
+    total: number;
+    perPage: number;
+    totalPages: number;
+    hasMore: boolean;
+    cursor?: string | undefined;
+}, {
+    data: T["_input"][];
+    page: number;
+    total: number;
+    perPage: number;
+    totalPages: number;
+    hasMore: boolean;
+    cursor?: string | undefined;
+}>;
+/**
+ * Paginated result with hasMore indicator and optional cursor.
+ */
+interface PaginatedResult<T> {
+    /** Array of items for the current page */
+    data: T[];
+    /** Total number of items across all pages */
+    total: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    perPage: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Whether there are more pages */
+    hasMore: boolean;
+    /** Cursor for next page (if using cursor-based pagination) */
+    cursor?: string;
+}
+
+export { type AuditEntry as A, type DateRangeFilter as D, type EntityReference as E, OptionalDateSchema as O, type PaginatedResult as P, type RecordMetadata as R, type SemanticId as S, type TokenUsage as T, type PaginationParams as a, type SemanticIdComponents as b, type SoftDeletable as c, type SortParams as d, type SortDirection as e, type ExecutionError as f, type Pagination as g, type PaginatedResponse as h, DateSchema as i, EntityReferenceSchema as j, TokenUsageSchema as k, ExecutionErrorSchema as l, SortDirectionSchema as m, SortParamsSchema as n, DateRangeFilterSchema as o, RecordMetadataSchema as p, SoftDeletableSchema as q, AuditEntrySchema as r, SemanticIdComponentsSchema as s, PaginationSchema as t, PaginationParamsSchema as u, PaginatedResponseSchema as v, PaginatedResultSchema as w };

package/dist/components/index.d.ts

@@ -1,6 +1,9 @@
-export { a as BreadcrumbItemConfig, B as BreadcrumbLinkProps, c as Breadcrumbs, b as BreadcrumbsProps } from '../breadcrumbs-C9Qn3S7d.js';
+export { a as BreadcrumbItemConfig, B as BreadcrumbLinkProps, c as Breadcrumbs, b as BreadcrumbsProps } from '../breadcrumbs-DltlCiHt.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
+import { aq as UseSaveQueryDialogReturn } from '../thing-adapters-aMjF0h9u.js';
+export { a as FunctionEditor, q as FunctionEditorProps, t as FunctionResult, b as FunctionResultsPanel, s as FunctionResultsPanelProps, F as FunctionWorkspace, r as FunctionWorkspaceProps, c as ResultsActions, R as ResultsStateWrapper, T as THING_TEMPLATES, x as UIRelationship, w as UIThing, U as UseFunctionWorkspaceOptions, v as UseFunctionWorkspaceReturn, k as createThingAdapters, n as createThingCardAdapter, o as createThingFilterFields, m as createThingGraphAdapter, l as createThingTableAdapter, p as normalizeResult, i as useCodeExecutor, d as useFunctionExecution, e as useFunctionHistory, u as useFunctionWorkspace, g as useMobileCollapse, j as useResultsFilter, h as useSaveQueryDialog, f as useSavedQueries } from '../thing-adapters-aMjF0h9u.js';
+import '@mdxui/admin';
 
 interface EndpointSelectorProps {
     /** Current endpoint URL */
@@ -92,4 +95,10 @@ declare function useErrorBoundary(): {
     showBoundary: React.Dispatch<React.SetStateAction<Error | null>>;
 };
 
-export { DOErrorBoundary, type DOErrorBoundaryProps, EndpointSelector, type EndpointSelectorProps, useErrorBoundary };
+interface SaveQueryDialogProps {
+    dialog: UseSaveQueryDialogReturn;
+    code: string;
+}
+declare function SaveQueryDialog({ dialog, code }: SaveQueryDialogProps): react_jsx_runtime.JSX.Element;
+
+export { DOErrorBoundary, type DOErrorBoundaryProps, EndpointSelector, type EndpointSelectorProps, SaveQueryDialog, type SaveQueryDialogProps, useErrorBoundary };

package/dist/components/index.js

@@ -1,5 +1,10 @@
-export { DOErrorBoundary, useErrorBoundary } from '../chunk-LJIWB7KE.js';
-export { Breadcrumbs, EndpointSelector } from '../chunk-3XKYQRXY.js';
-import '../chunk-Y52IEYVM.js';
+export { DOErrorBoundary, useErrorBoundary } from '../chunk-BU5HMHGQ.js';
+export { EndpointSelector } from '../chunk-7QCTRNEJ.js';
+export { Breadcrumbs } from '../chunk-SX4IIE2R.js';
+export { FunctionEditor, FunctionResultsPanel, FunctionWorkspace, ResultsActions, ResultsStateWrapper, SaveQueryDialog, THING_TEMPLATES, createThingAdapters, createThingCardAdapter, createThingFilterFields, createThingGraphAdapter, createThingTableAdapter, normalizeResult, useCodeExecutor, useFunctionExecution, useFunctionHistory, useFunctionWorkspace, useMobileCollapse, useResultsFilter, useSaveQueryDialog, useSavedQueries } from '../chunk-63VCRTDQ.js';
+import '../chunk-HC4PBXV4.js';
+import '../chunk-KLN5OTQH.js';
+import '../chunk-JPZ6RZJE.js';
+import '../chunk-X3AWNFBF.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{config-CxvpD8Y6.d.ts → config-DB14_LhF.d.ts}

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { i as DOAdminConfig } from './do-D27i5bU0.js';
+import { i as DOAdminConfig } from './do-D37hbmL9.js';
 
 /**
  * Configuration types for DOShell

package/dist/{do-D27i5bU0.d.ts → do-D37hbmL9.d.ts}

@@ -11,7 +11,7 @@ import { z } from 'zod';
  * - ctx.storage.put/get/delete for persistence
  * - blockConcurrencyWhile() for atomic operations
  * - alarms for scheduled events
- * - RPC via capnweb for communication
+ * - RPC via @dotdo/do SDK for communication
  */
 
 /**
@@ -137,15 +137,10 @@ interface DOMetrics {
     /** Alarms triggered */
     alarmsTriggered: number;
 }
-/**
- * @deprecated Sync status is no longer available in the simplified RPC-only architecture.
- * Kept for backward compatibility.
- */
-type SyncStatus = 'disconnected' | 'connecting' | 'syncing' | 'synced' | 'error';
 /**
  * Configuration for DO admin interface
  *
- * Simplified single-mode RPC architecture using capnweb.
+ * Simplified single-mode RPC architecture using @dotdo/do SDK.
  */
 interface DOAdminConfig {
     /** API endpoint for DO management and health checks */
@@ -181,14 +176,11 @@ interface DOAdminConfig {
     skipHealthCheck?: boolean;
     /**
      * Client type for RPC communication.
-     * - 'capnweb-ws': Cap'n Proto over WebSocket - persistent connection, real-time updates (default)
-     * - 'capnweb-http': Cap'n Proto over HTTP batch - stateless requests
-     * - 'capnweb': Legacy @dotdo/client wrapper
-     * - 'json-rpc': JSON-RPC over HTTP - simple JSON format
+     * - 'dotdo': @dotdo/do SDK client (recommended) - official SDK with typed RPC
      * - 'mock': Mock client with in-memory data - for demos and development
-     * @default 'capnweb-ws'
+     * @default 'dotdo'
      */
-    clientType?: 'capnweb-ws' | 'capnweb-http' | 'capnweb' | 'json-rpc' | 'mock';
+    clientType?: 'dotdo' | 'mock';
 }
 
-export type { DOStatus as D, SyncStatus as S, DOClassType as a, DOInstance as b, DOAlarm as c, DOStorageEntry as d, DOBinding as e, DORPCMethod as f, DOHealthCheck as g, DOMetrics as h, DOAdminConfig as i };
+export type { DOStatus as D, DOClassType as a, DOInstance as b, DOAlarm as c, DOStorageEntry as d, DOBinding as e, DORPCMethod as f, DOHealthCheck as g, DOMetrics as h, DOAdminConfig as i };