@aouda/client 0.0.1

package/dist/index.d.cts

@@ -0,0 +1,196 @@
+import { T as Transport, B as BulkLoadOptions, a as BulkLoadJobHandle, R as ReplicationStatusResponse, b as TopologyResponse, C as CoverageResponse, H as HealthStatus, c as ReadinessResponse, D as DetailedHealthResponse, N as NodeInfoResponse, d as TriggerBackupRequest, e as TriggerBackupResponse, L as ListBackupsResponse, f as RestoreBackupResponse, g as BackupSchedule, J as JoinClusterRequest, h as JoinClusterResponse, i as LeaveClusterResponse, P as PromoteClusterResponse, F as FailoverClusterResponse, j as DrainClusterResponse, k as ClusterConfigResponse, l as ClusterConfigPatchRequest, S as SchemaLike, m as DefaultSchema, A as AoudaClient } from './client-DXT2ZAeO.cjs';
+export { n as AOUDA_DATA_TYPES, o as AddColumnRequest, p as AdminApi, q as AdminBackupConfig, r as AdminBackupPatch, s as AdminConfigPatchRequest, t as AdminConfigResponse, u as AdminConfigSchemaResponse, v as AdminLoggingConfig, w as AdminLoggingPatch, x as AdminMemoryConfig, y as AdminMemoryPatch, z as AoudaClientOptions, E as AoudaDataType, G as AppAuthOptions, I as AuthClient, K as AuthResult, M as AuthUserInfo, O as AuthorizationMode, Q as BackupAdminApi, U as BackupMetrics, V as BackupSummary, W as BatchMutationResult, X as BatchOperationInput, Y as BloomFilterMetrics, Z as BranchInfo, _ as BranchesApi, $ as BulkLoadForceAbortRequest, a0 as BulkLoadForceAbortResponse, a1 as BulkLoadListResponse, a2 as BulkLoadProgress, a3 as BulkLoadReplicaProgress, a4 as BulkLoadReplicaProgressDto, a5 as BulkLoadStatusResponse, a6 as CircuitBreakerPolicy, a7 as ClusterAdminApi, a8 as ClusterMemberEntry, a9 as ClusterThisNodeEntry, aa as ColumnSchema, ab as ColumnSummaryForErd, ac as ColumnarResponse, ad as ComponentHealthEntry, ae as ComputedColumnDef, af as ConfigAdminApi, ag as CreateBranchRequest, ah as CreateColumnRequest, ai as CreateDatabaseOptions, aj as CreatePartitionGrantRequest, ak as CreateRlsResolverRequest, al as CreateTableRequest, am as DatabaseCoverageEntry, an as DatabaseInfo, ao as DatabaseMemoryMetrics, ap as DatabaseMemoryUsage, aq as DatabaseMetricsDto, ar as DatabaseOptionsInfo, as as DatabasesApi, at as DeleteOptions, au as DiffSummary, av as HealthAdminApi, aw as IndexInfo, ax as InsertResult, ay as IoMetrics, az as LatencyPercentiles, aA as MaterializedQueriesApi, aB as MaterializedQueryDefinition, aC as MaterializedQueryExecuteOptions, aD as MaterializedQueryExecuteResult, aE as MaterializedQueryMetrics, aF as MaterializedQueryRefreshOptions, aG as MaterializedQueryState, aH as MaterializedQueryStateNumber, aI as MaterializedQueryStatus, aJ as MaterializedQueryType, aK as MaterializedQueryTypeNumber, aL as MemberInfo, aM as MemoryMetrics, aN as MergeBranchOptions, aO as MergeConflict, aP as MergeExecutionResult, aQ as MergeResult, aR as MetricsAdminApi, aS as MetricsHistory, aT as MetricsHistoryOptions, aU as MetricsSnapshot, aV as MetricsSummary, aW as MutationResult, aX as NodeAdminApi, aY as NodeLogEntry, aZ as NodeLogLevel, a_ as NodeLogStreamOptions, a$ as NodeLogsQuery, b0 as NodeLogsResponse, b1 as OpenWriteStreamOptions, b2 as PageCacheMetrics, b3 as PartitionGrant, b4 as PartitionGrantsListResponse, b5 as PartitioningMetrics, b6 as PerDatabaseLagEntry, b7 as PerDatabaseMetrics, b8 as PerDatabaseStatusEntry, b9 as QueryMetrics, ba as QueryResult, bb as QueryStats, bc as ReferenceInfo, bd as RelationshipEndpoint, be as RelationshipInfo, bf as RenameColumnRequest, bg as RenameTableRequest, bh as ReplicationAdminApi, bi as ReplicationMetrics, bj as ResidencyConfig, bk as RetryPolicy, bl as RlsResolver, bm as RlsResolverRule, bn as RlsResolverRuleInput, bo as RlsResolversListResponse, bp as SchemaChange, bq as SchemaDiffResult, br as SchemaRelationshipsResponse, bs as SeedApplyResult, bt as SeedTableApplyResult, bu as ServerAdminApi, bv as ServerAuthOptions, bw as ServerMemoryResponse, bx as ServerMetricsResponse, by as ServiceInfo, bz as SimdMetrics, bA as SingleDatabaseMetricsResponse, bB as SortDirection, bC as StorageMetrics, bD as SubscribeOptions, bE as Subscription, bF as SubscriptionChangeEvent, bG as SubscriptionEvent, bH as SubscriptionInfo, bI as SubscriptionSnapshotEvent, bJ as TableCoverageEntry, bK as TableNameFromSchema, bL as TablePolicy, bM as TableQuery, bN as TableSchema, bO as TableSchemaResponse, bP as TableSummary, bQ as TableSummaryForErd, bR as TablesApi, bS as TimeSeriesMetrics, bT as TransactionMetrics, bU as TypeGenerationOptions, bV as UpdateOptions, bW as UpdateRlsResolverRequest, bX as UpdateTablePolicyRequest, bY as UserProfile, bZ as WhereGroupBuilder, b_ as WhereOperator, b$ as WriteStream, c0 as coerceColumnarValue, c1 as createAoudaClient } from './client-DXT2ZAeO.cjs';
+
+/**
+ * @aouda/client error types.
+ */
+/**
+ * Base error class for Aouda client errors.
+ */
+declare class AoudaError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when connection to the Aouda server fails.
+ * This includes network errors, DNS failures, and connection refused.
+ */
+declare class AoudaConnectionError extends AoudaError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a request times out.
+ */
+declare class AoudaTimeoutError extends AoudaError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number);
+}
+/**
+ * Error thrown when the server returns an unexpected response.
+ * Used when the error body cannot be parsed (no error code available).
+ */
+declare class AoudaResponseError extends AoudaError {
+    readonly statusCode: number;
+    readonly statusText: string;
+    constructor(message: string, statusCode: number, statusText: string);
+}
+/**
+ * Base class for server-returned errors with a structured error code.
+ */
+declare class AoudaApiError extends AoudaError {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: string | undefined;
+    readonly requestId?: string | undefined;
+    constructor(message: string, code: string, statusCode: number, details?: string | undefined, requestId?: string | undefined);
+}
+/**
+ * Thrown for TABLE_NOT_FOUND, COLUMN_NOT_FOUND (404).
+ */
+declare class AoudaNotFoundError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for TABLE_EXISTS, COLUMN_EXISTS (409).
+ */
+declare class AoudaConflictError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for INVALID_REQUEST, INVALID_OPERATOR, etc. (400).
+ */
+declare class AoudaValidationError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for INTERNAL_ERROR, SERVICE_UNAVAILABLE, etc. (5xx).
+ */
+declare class AoudaServerError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for 401 authentication errors (AUTH_TOKEN_EXPIRED, AUTH_TOKEN_INVALID, etc.).
+ */
+declare class AoudaAuthenticationError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown when the circuit breaker is open and requests are rejected immediately.
+ * Use openedAt and retryAfter to know when the circuit will allow test requests again.
+ */
+declare class AoudaCircuitBreakerOpenError extends AoudaError {
+    readonly openedAt: Date;
+    readonly retryAfter: Date;
+    readonly cause?: Error | undefined;
+    constructor(message: string, openedAt: Date, retryAfter: Date, cause?: Error | undefined);
+}
+
+/**
+ * Bulk-load coordinator for @aouda/client.
+ * Implements the :begin / :append × N / :commit HTTP sequence.
+ * No Node-only dependencies — works in any fetch-capable runtime.
+ */
+
+/**
+ * Coordinator for the bulk-load HTTP sequence.
+ */
+declare class BulkLoadCoordinator {
+    private readonly transport;
+    private readonly database;
+    constructor(transport: Transport, database: string);
+    run<T extends Record<string, unknown>>(tables: readonly string[], rows: Iterable<T> | AsyncIterable<T>, options?: BulkLoadOptions): Promise<BulkLoadJobHandle>;
+}
+
+interface McpToolSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+interface McpToolDefinition<TInput, TOutput> {
+    name: string;
+    description: string;
+    inputSchema: McpToolSchema;
+    execute: (input: TInput) => Promise<TOutput>;
+}
+interface ClusterStatusToolInput {
+    includeCoverage?: boolean;
+}
+interface ClusterStatusToolOutput {
+    replicationStatus: ReplicationStatusResponse;
+    topology: TopologyResponse;
+    coverage?: CoverageResponse;
+}
+interface ClusterHealthToolInput {
+    includeDetailed?: boolean;
+    includeNodeInfo?: boolean;
+}
+interface ClusterHealthToolOutput {
+    health: HealthStatus;
+    readiness: ReadinessResponse;
+    replicationStatus: ReplicationStatusResponse;
+    detailed?: DetailedHealthResponse;
+    node?: NodeInfoResponse;
+}
+type BackupTriggerToolInput = TriggerBackupRequest;
+interface BackupRestoreToolInput {
+    backupId: string;
+}
+type BackupSetScheduleToolInput = BackupSchedule;
+interface ClusterDrainToolInput {
+    nodeAddress: string;
+}
+type ClusterPatchConfigToolInput = ClusterConfigPatchRequest;
+declare class AoudaClusterMcpTools<S extends SchemaLike = DefaultSchema> {
+    private readonly client;
+    constructor(client: AoudaClient<S>);
+    clusterStatus(input?: ClusterStatusToolInput): Promise<ClusterStatusToolOutput>;
+    clusterHealth(input?: ClusterHealthToolInput): Promise<ClusterHealthToolOutput>;
+    backupTrigger(input?: BackupTriggerToolInput): Promise<TriggerBackupResponse>;
+    backupList(): Promise<ListBackupsResponse>;
+    backupRestore(input: BackupRestoreToolInput): Promise<RestoreBackupResponse>;
+    backupGetSchedule(): Promise<BackupSchedule>;
+    backupSetSchedule(input: BackupSetScheduleToolInput): Promise<BackupSchedule>;
+    clusterJoin(input: JoinClusterRequest): Promise<JoinClusterResponse>;
+    clusterLeave(): Promise<LeaveClusterResponse>;
+    clusterPromote(): Promise<PromoteClusterResponse>;
+    clusterFailover(): Promise<FailoverClusterResponse>;
+    clusterDrain(input: ClusterDrainToolInput): Promise<DrainClusterResponse>;
+    clusterGetConfig(): Promise<ClusterConfigResponse>;
+    clusterPatchConfig(input: ClusterPatchConfigToolInput): Promise<ClusterConfigResponse>;
+}
+interface AoudaClusterMcpToolSet {
+    aouda_cluster_status: McpToolDefinition<ClusterStatusToolInput, ClusterStatusToolOutput>;
+    aouda_cluster_health: McpToolDefinition<ClusterHealthToolInput, ClusterHealthToolOutput>;
+    aouda_backup_trigger: McpToolDefinition<BackupTriggerToolInput, TriggerBackupResponse>;
+    aouda_backup_list: McpToolDefinition<Record<string, never>, ListBackupsResponse>;
+    aouda_backup_restore: McpToolDefinition<BackupRestoreToolInput, RestoreBackupResponse>;
+    aouda_backup_get_schedule: McpToolDefinition<Record<string, never>, BackupSchedule>;
+    aouda_backup_set_schedule: McpToolDefinition<BackupSetScheduleToolInput, BackupSchedule>;
+    aouda_cluster_join: McpToolDefinition<JoinClusterRequest, JoinClusterResponse>;
+    aouda_cluster_leave: McpToolDefinition<Record<string, never>, LeaveClusterResponse>;
+    aouda_cluster_promote: McpToolDefinition<Record<string, never>, PromoteClusterResponse>;
+    aouda_cluster_failover: McpToolDefinition<Record<string, never>, FailoverClusterResponse>;
+    aouda_cluster_drain: McpToolDefinition<ClusterDrainToolInput, DrainClusterResponse>;
+    aouda_cluster_get_config: McpToolDefinition<Record<string, never>, ClusterConfigResponse>;
+    aouda_cluster_patch_config: McpToolDefinition<ClusterPatchConfigToolInput, ClusterConfigResponse>;
+}
+declare function createAoudaClusterMcpToolSet<S extends SchemaLike = DefaultSchema>(client: AoudaClient<S>): AoudaClusterMcpToolSet;
+
+/**
+ * @aouda/client — Official TypeScript/JavaScript client for Aouda.
+ *
+ * @example
+ * ```typescript
+ * import { AoudaClient } from "@aouda/client";
+ *
+ * const client = new AoudaClient({ serverUrl: "http://localhost:8080", database: "mydb" });
+ * await client.connect();
+ * const health = await client.health();
+ * console.log(health.isHealthy); // true
+ * await client.disconnect();
+ * ```
+ */
+declare const version = "0.0.1";
+
+export { AoudaApiError, AoudaAuthenticationError, AoudaCircuitBreakerOpenError, AoudaClient, type AoudaClusterMcpToolSet, AoudaClusterMcpTools, AoudaConflictError, AoudaConnectionError, AoudaError, AoudaNotFoundError, AoudaResponseError, AoudaServerError, AoudaTimeoutError, AoudaValidationError, type BackupRestoreToolInput, BackupSchedule, type BackupSetScheduleToolInput, type BackupTriggerToolInput, BulkLoadCoordinator, BulkLoadJobHandle, BulkLoadOptions, ClusterConfigPatchRequest, ClusterConfigResponse, type ClusterDrainToolInput, type ClusterHealthToolInput, type ClusterHealthToolOutput, type ClusterPatchConfigToolInput, type ClusterStatusToolInput, type ClusterStatusToolOutput, CoverageResponse, DefaultSchema, DetailedHealthResponse, DrainClusterResponse, FailoverClusterResponse, HealthStatus, JoinClusterRequest, JoinClusterResponse, LeaveClusterResponse, ListBackupsResponse, type McpToolDefinition, type McpToolSchema, NodeInfoResponse, PromoteClusterResponse, ReadinessResponse, ReplicationStatusResponse, RestoreBackupResponse, SchemaLike, TopologyResponse, TriggerBackupRequest, TriggerBackupResponse, createAoudaClusterMcpToolSet, version };

package/dist/index.d.ts

@@ -0,0 +1,196 @@
+import { T as Transport, B as BulkLoadOptions, a as BulkLoadJobHandle, R as ReplicationStatusResponse, b as TopologyResponse, C as CoverageResponse, H as HealthStatus, c as ReadinessResponse, D as DetailedHealthResponse, N as NodeInfoResponse, d as TriggerBackupRequest, e as TriggerBackupResponse, L as ListBackupsResponse, f as RestoreBackupResponse, g as BackupSchedule, J as JoinClusterRequest, h as JoinClusterResponse, i as LeaveClusterResponse, P as PromoteClusterResponse, F as FailoverClusterResponse, j as DrainClusterResponse, k as ClusterConfigResponse, l as ClusterConfigPatchRequest, S as SchemaLike, m as DefaultSchema, A as AoudaClient } from './client-DXT2ZAeO.js';
+export { n as AOUDA_DATA_TYPES, o as AddColumnRequest, p as AdminApi, q as AdminBackupConfig, r as AdminBackupPatch, s as AdminConfigPatchRequest, t as AdminConfigResponse, u as AdminConfigSchemaResponse, v as AdminLoggingConfig, w as AdminLoggingPatch, x as AdminMemoryConfig, y as AdminMemoryPatch, z as AoudaClientOptions, E as AoudaDataType, G as AppAuthOptions, I as AuthClient, K as AuthResult, M as AuthUserInfo, O as AuthorizationMode, Q as BackupAdminApi, U as BackupMetrics, V as BackupSummary, W as BatchMutationResult, X as BatchOperationInput, Y as BloomFilterMetrics, Z as BranchInfo, _ as BranchesApi, $ as BulkLoadForceAbortRequest, a0 as BulkLoadForceAbortResponse, a1 as BulkLoadListResponse, a2 as BulkLoadProgress, a3 as BulkLoadReplicaProgress, a4 as BulkLoadReplicaProgressDto, a5 as BulkLoadStatusResponse, a6 as CircuitBreakerPolicy, a7 as ClusterAdminApi, a8 as ClusterMemberEntry, a9 as ClusterThisNodeEntry, aa as ColumnSchema, ab as ColumnSummaryForErd, ac as ColumnarResponse, ad as ComponentHealthEntry, ae as ComputedColumnDef, af as ConfigAdminApi, ag as CreateBranchRequest, ah as CreateColumnRequest, ai as CreateDatabaseOptions, aj as CreatePartitionGrantRequest, ak as CreateRlsResolverRequest, al as CreateTableRequest, am as DatabaseCoverageEntry, an as DatabaseInfo, ao as DatabaseMemoryMetrics, ap as DatabaseMemoryUsage, aq as DatabaseMetricsDto, ar as DatabaseOptionsInfo, as as DatabasesApi, at as DeleteOptions, au as DiffSummary, av as HealthAdminApi, aw as IndexInfo, ax as InsertResult, ay as IoMetrics, az as LatencyPercentiles, aA as MaterializedQueriesApi, aB as MaterializedQueryDefinition, aC as MaterializedQueryExecuteOptions, aD as MaterializedQueryExecuteResult, aE as MaterializedQueryMetrics, aF as MaterializedQueryRefreshOptions, aG as MaterializedQueryState, aH as MaterializedQueryStateNumber, aI as MaterializedQueryStatus, aJ as MaterializedQueryType, aK as MaterializedQueryTypeNumber, aL as MemberInfo, aM as MemoryMetrics, aN as MergeBranchOptions, aO as MergeConflict, aP as MergeExecutionResult, aQ as MergeResult, aR as MetricsAdminApi, aS as MetricsHistory, aT as MetricsHistoryOptions, aU as MetricsSnapshot, aV as MetricsSummary, aW as MutationResult, aX as NodeAdminApi, aY as NodeLogEntry, aZ as NodeLogLevel, a_ as NodeLogStreamOptions, a$ as NodeLogsQuery, b0 as NodeLogsResponse, b1 as OpenWriteStreamOptions, b2 as PageCacheMetrics, b3 as PartitionGrant, b4 as PartitionGrantsListResponse, b5 as PartitioningMetrics, b6 as PerDatabaseLagEntry, b7 as PerDatabaseMetrics, b8 as PerDatabaseStatusEntry, b9 as QueryMetrics, ba as QueryResult, bb as QueryStats, bc as ReferenceInfo, bd as RelationshipEndpoint, be as RelationshipInfo, bf as RenameColumnRequest, bg as RenameTableRequest, bh as ReplicationAdminApi, bi as ReplicationMetrics, bj as ResidencyConfig, bk as RetryPolicy, bl as RlsResolver, bm as RlsResolverRule, bn as RlsResolverRuleInput, bo as RlsResolversListResponse, bp as SchemaChange, bq as SchemaDiffResult, br as SchemaRelationshipsResponse, bs as SeedApplyResult, bt as SeedTableApplyResult, bu as ServerAdminApi, bv as ServerAuthOptions, bw as ServerMemoryResponse, bx as ServerMetricsResponse, by as ServiceInfo, bz as SimdMetrics, bA as SingleDatabaseMetricsResponse, bB as SortDirection, bC as StorageMetrics, bD as SubscribeOptions, bE as Subscription, bF as SubscriptionChangeEvent, bG as SubscriptionEvent, bH as SubscriptionInfo, bI as SubscriptionSnapshotEvent, bJ as TableCoverageEntry, bK as TableNameFromSchema, bL as TablePolicy, bM as TableQuery, bN as TableSchema, bO as TableSchemaResponse, bP as TableSummary, bQ as TableSummaryForErd, bR as TablesApi, bS as TimeSeriesMetrics, bT as TransactionMetrics, bU as TypeGenerationOptions, bV as UpdateOptions, bW as UpdateRlsResolverRequest, bX as UpdateTablePolicyRequest, bY as UserProfile, bZ as WhereGroupBuilder, b_ as WhereOperator, b$ as WriteStream, c0 as coerceColumnarValue, c1 as createAoudaClient } from './client-DXT2ZAeO.js';
+
+/**
+ * @aouda/client error types.
+ */
+/**
+ * Base error class for Aouda client errors.
+ */
+declare class AoudaError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when connection to the Aouda server fails.
+ * This includes network errors, DNS failures, and connection refused.
+ */
+declare class AoudaConnectionError extends AoudaError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a request times out.
+ */
+declare class AoudaTimeoutError extends AoudaError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number);
+}
+/**
+ * Error thrown when the server returns an unexpected response.
+ * Used when the error body cannot be parsed (no error code available).
+ */
+declare class AoudaResponseError extends AoudaError {
+    readonly statusCode: number;
+    readonly statusText: string;
+    constructor(message: string, statusCode: number, statusText: string);
+}
+/**
+ * Base class for server-returned errors with a structured error code.
+ */
+declare class AoudaApiError extends AoudaError {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: string | undefined;
+    readonly requestId?: string | undefined;
+    constructor(message: string, code: string, statusCode: number, details?: string | undefined, requestId?: string | undefined);
+}
+/**
+ * Thrown for TABLE_NOT_FOUND, COLUMN_NOT_FOUND (404).
+ */
+declare class AoudaNotFoundError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for TABLE_EXISTS, COLUMN_EXISTS (409).
+ */
+declare class AoudaConflictError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for INVALID_REQUEST, INVALID_OPERATOR, etc. (400).
+ */
+declare class AoudaValidationError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for INTERNAL_ERROR, SERVICE_UNAVAILABLE, etc. (5xx).
+ */
+declare class AoudaServerError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown for 401 authentication errors (AUTH_TOKEN_EXPIRED, AUTH_TOKEN_INVALID, etc.).
+ */
+declare class AoudaAuthenticationError extends AoudaApiError {
+    constructor(message: string, code: string, statusCode: number, details?: string, requestId?: string);
+}
+/**
+ * Thrown when the circuit breaker is open and requests are rejected immediately.
+ * Use openedAt and retryAfter to know when the circuit will allow test requests again.
+ */
+declare class AoudaCircuitBreakerOpenError extends AoudaError {
+    readonly openedAt: Date;
+    readonly retryAfter: Date;
+    readonly cause?: Error | undefined;
+    constructor(message: string, openedAt: Date, retryAfter: Date, cause?: Error | undefined);
+}
+
+/**
+ * Bulk-load coordinator for @aouda/client.
+ * Implements the :begin / :append × N / :commit HTTP sequence.
+ * No Node-only dependencies — works in any fetch-capable runtime.
+ */
+
+/**
+ * Coordinator for the bulk-load HTTP sequence.
+ */
+declare class BulkLoadCoordinator {
+    private readonly transport;
+    private readonly database;
+    constructor(transport: Transport, database: string);
+    run<T extends Record<string, unknown>>(tables: readonly string[], rows: Iterable<T> | AsyncIterable<T>, options?: BulkLoadOptions): Promise<BulkLoadJobHandle>;
+}
+
+interface McpToolSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+interface McpToolDefinition<TInput, TOutput> {
+    name: string;
+    description: string;
+    inputSchema: McpToolSchema;
+    execute: (input: TInput) => Promise<TOutput>;
+}
+interface ClusterStatusToolInput {
+    includeCoverage?: boolean;
+}
+interface ClusterStatusToolOutput {
+    replicationStatus: ReplicationStatusResponse;
+    topology: TopologyResponse;
+    coverage?: CoverageResponse;
+}
+interface ClusterHealthToolInput {
+    includeDetailed?: boolean;
+    includeNodeInfo?: boolean;
+}
+interface ClusterHealthToolOutput {
+    health: HealthStatus;
+    readiness: ReadinessResponse;
+    replicationStatus: ReplicationStatusResponse;
+    detailed?: DetailedHealthResponse;
+    node?: NodeInfoResponse;
+}
+type BackupTriggerToolInput = TriggerBackupRequest;
+interface BackupRestoreToolInput {
+    backupId: string;
+}
+type BackupSetScheduleToolInput = BackupSchedule;
+interface ClusterDrainToolInput {
+    nodeAddress: string;
+}
+type ClusterPatchConfigToolInput = ClusterConfigPatchRequest;
+declare class AoudaClusterMcpTools<S extends SchemaLike = DefaultSchema> {
+    private readonly client;
+    constructor(client: AoudaClient<S>);
+    clusterStatus(input?: ClusterStatusToolInput): Promise<ClusterStatusToolOutput>;
+    clusterHealth(input?: ClusterHealthToolInput): Promise<ClusterHealthToolOutput>;
+    backupTrigger(input?: BackupTriggerToolInput): Promise<TriggerBackupResponse>;
+    backupList(): Promise<ListBackupsResponse>;
+    backupRestore(input: BackupRestoreToolInput): Promise<RestoreBackupResponse>;
+    backupGetSchedule(): Promise<BackupSchedule>;
+    backupSetSchedule(input: BackupSetScheduleToolInput): Promise<BackupSchedule>;
+    clusterJoin(input: JoinClusterRequest): Promise<JoinClusterResponse>;
+    clusterLeave(): Promise<LeaveClusterResponse>;
+    clusterPromote(): Promise<PromoteClusterResponse>;
+    clusterFailover(): Promise<FailoverClusterResponse>;
+    clusterDrain(input: ClusterDrainToolInput): Promise<DrainClusterResponse>;
+    clusterGetConfig(): Promise<ClusterConfigResponse>;
+    clusterPatchConfig(input: ClusterPatchConfigToolInput): Promise<ClusterConfigResponse>;
+}
+interface AoudaClusterMcpToolSet {
+    aouda_cluster_status: McpToolDefinition<ClusterStatusToolInput, ClusterStatusToolOutput>;
+    aouda_cluster_health: McpToolDefinition<ClusterHealthToolInput, ClusterHealthToolOutput>;
+    aouda_backup_trigger: McpToolDefinition<BackupTriggerToolInput, TriggerBackupResponse>;
+    aouda_backup_list: McpToolDefinition<Record<string, never>, ListBackupsResponse>;
+    aouda_backup_restore: McpToolDefinition<BackupRestoreToolInput, RestoreBackupResponse>;
+    aouda_backup_get_schedule: McpToolDefinition<Record<string, never>, BackupSchedule>;
+    aouda_backup_set_schedule: McpToolDefinition<BackupSetScheduleToolInput, BackupSchedule>;
+    aouda_cluster_join: McpToolDefinition<JoinClusterRequest, JoinClusterResponse>;
+    aouda_cluster_leave: McpToolDefinition<Record<string, never>, LeaveClusterResponse>;
+    aouda_cluster_promote: McpToolDefinition<Record<string, never>, PromoteClusterResponse>;
+    aouda_cluster_failover: McpToolDefinition<Record<string, never>, FailoverClusterResponse>;
+    aouda_cluster_drain: McpToolDefinition<ClusterDrainToolInput, DrainClusterResponse>;
+    aouda_cluster_get_config: McpToolDefinition<Record<string, never>, ClusterConfigResponse>;
+    aouda_cluster_patch_config: McpToolDefinition<ClusterPatchConfigToolInput, ClusterConfigResponse>;
+}
+declare function createAoudaClusterMcpToolSet<S extends SchemaLike = DefaultSchema>(client: AoudaClient<S>): AoudaClusterMcpToolSet;
+
+/**
+ * @aouda/client — Official TypeScript/JavaScript client for Aouda.
+ *
+ * @example
+ * ```typescript
+ * import { AoudaClient } from "@aouda/client";
+ *
+ * const client = new AoudaClient({ serverUrl: "http://localhost:8080", database: "mydb" });
+ * await client.connect();
+ * const health = await client.health();
+ * console.log(health.isHealthy); // true
+ * await client.disconnect();
+ * ```
+ */
+declare const version = "0.0.1";
+
+export { AoudaApiError, AoudaAuthenticationError, AoudaCircuitBreakerOpenError, AoudaClient, type AoudaClusterMcpToolSet, AoudaClusterMcpTools, AoudaConflictError, AoudaConnectionError, AoudaError, AoudaNotFoundError, AoudaResponseError, AoudaServerError, AoudaTimeoutError, AoudaValidationError, type BackupRestoreToolInput, BackupSchedule, type BackupSetScheduleToolInput, type BackupTriggerToolInput, BulkLoadCoordinator, BulkLoadJobHandle, BulkLoadOptions, ClusterConfigPatchRequest, ClusterConfigResponse, type ClusterDrainToolInput, type ClusterHealthToolInput, type ClusterHealthToolOutput, type ClusterPatchConfigToolInput, type ClusterStatusToolInput, type ClusterStatusToolOutput, CoverageResponse, DefaultSchema, DetailedHealthResponse, DrainClusterResponse, FailoverClusterResponse, HealthStatus, JoinClusterRequest, JoinClusterResponse, LeaveClusterResponse, ListBackupsResponse, type McpToolDefinition, type McpToolSchema, NodeInfoResponse, PromoteClusterResponse, ReadinessResponse, ReplicationStatusResponse, RestoreBackupResponse, SchemaLike, TopologyResponse, TriggerBackupRequest, TriggerBackupResponse, createAoudaClusterMcpToolSet, version };