@aouda/client 0.0.2 → 0.0.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-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-otKeBYQG.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-otKeBYQG.cjs';
+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-Bvs1yerF.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-Bvs1yerF.cjs';
 
 /**
  * @aouda/client error types.
@@ -85,6 +85,37 @@ declare class AoudaCircuitBreakerOpenError extends AoudaError {
     constructor(message: string, openedAt: Date, retryAfter: Date, cause?: Error | undefined);
 }
 
+/**
+ * Chrome Local Network Access (LNA) support for browser clients.
+ *
+ * When a public HTTPS origin (e.g. studio.aouda.com) calls http://localhost,
+ * Chrome blocks the request unless fetch is annotated with targetAddressSpace.
+ * See: https://developer.chrome.com/blog/local-network-access
+ */
+type TargetAddressSpace = "loopback" | "local";
+/** RequestInit extended with the LNA hint (not yet in all TS lib.dom versions). */
+interface LocalNetworkRequestInit extends RequestInit {
+    targetAddressSpace?: TargetAddressSpace | "public";
+}
+/**
+ * Returns the LNA address space for a URL, or undefined for ordinary public hosts.
+ */
+declare function resolveTargetAddressSpace(url: string): TargetAddressSpace | undefined;
+/**
+ * Merges targetAddressSpace into a RequestInit when the URL is loopback/local.
+ */
+declare function applyLocalNetworkAccess(url: string, init?: RequestInit): LocalNetworkRequestInit;
+/**
+ * fetch() wrapper that annotates loopback/local destinations for Chrome LNA.
+ */
+declare function localNetworkFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+/**
+ * Patches global fetch once so direct fetch() calls to loopback/local URLs
+ * include targetAddressSpace (required for hosted Studio → localhost).
+ * No-op outside browser environments.
+ */
+declare function installLocalNetworkFetch(): void;
+
 /**
  * Bulk-load coordinator for @aouda/client.
  * Implements the :begin / :append × N / :commit HTTP sequence.
@@ -191,6 +222,6 @@ declare function createAoudaClusterMcpToolSet<S extends SchemaLike = DefaultSche
  * await client.disconnect();
  * ```
  */
-declare const version = "0.0.2";
+declare const version: string;
 
-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 };
+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 LocalNetworkRequestInit, type McpToolDefinition, type McpToolSchema, NodeInfoResponse, PromoteClusterResponse, ReadinessResponse, ReplicationStatusResponse, RestoreBackupResponse, SchemaLike, type TargetAddressSpace, TopologyResponse, TriggerBackupRequest, TriggerBackupResponse, applyLocalNetworkAccess, createAoudaClusterMcpToolSet, installLocalNetworkFetch, localNetworkFetch, resolveTargetAddressSpace, version };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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-otKeBYQG.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-otKeBYQG.js';
+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-Bvs1yerF.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-Bvs1yerF.js';
 
 /**
  * @aouda/client error types.
@@ -85,6 +85,37 @@ declare class AoudaCircuitBreakerOpenError extends AoudaError {
     constructor(message: string, openedAt: Date, retryAfter: Date, cause?: Error | undefined);
 }
 
+/**
+ * Chrome Local Network Access (LNA) support for browser clients.
+ *
+ * When a public HTTPS origin (e.g. studio.aouda.com) calls http://localhost,
+ * Chrome blocks the request unless fetch is annotated with targetAddressSpace.
+ * See: https://developer.chrome.com/blog/local-network-access
+ */
+type TargetAddressSpace = "loopback" | "local";
+/** RequestInit extended with the LNA hint (not yet in all TS lib.dom versions). */
+interface LocalNetworkRequestInit extends RequestInit {
+    targetAddressSpace?: TargetAddressSpace | "public";
+}
+/**
+ * Returns the LNA address space for a URL, or undefined for ordinary public hosts.
+ */
+declare function resolveTargetAddressSpace(url: string): TargetAddressSpace | undefined;
+/**
+ * Merges targetAddressSpace into a RequestInit when the URL is loopback/local.
+ */
+declare function applyLocalNetworkAccess(url: string, init?: RequestInit): LocalNetworkRequestInit;
+/**
+ * fetch() wrapper that annotates loopback/local destinations for Chrome LNA.
+ */
+declare function localNetworkFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+/**
+ * Patches global fetch once so direct fetch() calls to loopback/local URLs
+ * include targetAddressSpace (required for hosted Studio → localhost).
+ * No-op outside browser environments.
+ */
+declare function installLocalNetworkFetch(): void;
+
 /**
  * Bulk-load coordinator for @aouda/client.
  * Implements the :begin / :append × N / :commit HTTP sequence.
@@ -191,6 +222,6 @@ declare function createAoudaClusterMcpToolSet<S extends SchemaLike = DefaultSche
  * await client.disconnect();
  * ```
  */
-declare const version = "0.0.2";
+declare const version: string;
 
-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 };
+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 LocalNetworkRequestInit, type McpToolDefinition, type McpToolSchema, NodeInfoResponse, PromoteClusterResponse, ReadinessResponse, ReplicationStatusResponse, RestoreBackupResponse, SchemaLike, type TargetAddressSpace, TopologyResponse, TriggerBackupRequest, TriggerBackupResponse, applyLocalNetworkAccess, createAoudaClusterMcpToolSet, installLocalNetworkFetch, localNetworkFetch, resolveTargetAddressSpace, version };

package/dist/index.js

@@ -1,3 +1,71 @@
+// package.json
+var package_default = {
+  name: "@aouda/client",
+  version: "0.0.3",
+  description: "Official TypeScript/JavaScript client library for Aouda",
+  type: "module",
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  bin: "./dist/cli/index.js",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    }
+  },
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/aoudadb/aouda-client-ts.git"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    changeset: "changeset",
+    "version-packages": "changeset version",
+    release: "changeset publish",
+    prepublishOnly: "npm run build",
+    build: "tsup",
+    dev: "tsup --watch",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    lint: "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    format: 'prettier --write "src/**/*.ts" "tests/**/*.ts"',
+    typecheck: "tsc --noEmit && tsc -p tsconfig.typecheck.json --noEmit",
+    "generate-types": "node dist/cli/index.js generate --server http://localhost:5000 --output ./types/schema.ts"
+  },
+  engines: {
+    node: ">=20"
+  },
+  devDependencies: {
+    "@changesets/cli": "^2.29.8",
+    "@eslint/js": "^9.15.0",
+    "@types/node": "^25.2.1",
+    "@types/ws": "^8.18.1",
+    eslint: "^9.15.0",
+    "eslint-config-prettier": "^9.1.0",
+    prettier: "^3.3.3",
+    tsup: "^8.3.5",
+    typescript: "^5.6.3",
+    "typescript-eslint": "^8.15.0",
+    vitest: "^2.1.4"
+  },
+  dependencies: {
+    "@msgpack/msgpack": "^3.1.3",
+    ws: "^8.20.0"
+  }
+};
+
 // src/types.ts
 var RetryPolicy;
 ((RetryPolicy2) => {
@@ -114,6 +182,70 @@ var AoudaCircuitBreakerOpenError = class extends AoudaError {
   }
 };
 
+// src/local-network-fetch.ts
+function resolveTargetAddressSpace(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return void 0;
+  }
+  const hostname = parsed.hostname.replace(/^\[|\]$/g, "").toLowerCase();
+  if (hostname === "localhost" || hostname === "::1") {
+    return "loopback";
+  }
+  const ipv4 = hostname.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+  if (ipv4) {
+    const [first, second] = [Number(ipv4[1]), Number(ipv4[2])];
+    if (first === 127) return "loopback";
+    if (first === 10) return "local";
+    if (first === 172 && second >= 16 && second <= 31) return "local";
+    if (first === 192 && second === 168) return "local";
+    if (first === 169 && second === 254) return "local";
+  }
+  if (hostname.endsWith(".local")) {
+    return "local";
+  }
+  return void 0;
+}
+function applyLocalNetworkAccess(url, init) {
+  const space = resolveTargetAddressSpace(url);
+  if (!space) {
+    return init ?? {};
+  }
+  return { ...init, targetAddressSpace: space };
+}
+function resolveFetchUrl(input) {
+  if (typeof input === "string") {
+    return input;
+  }
+  if (input instanceof URL) {
+    return input.href;
+  }
+  return input.url;
+}
+function localNetworkFetch(input, init) {
+  const url = resolveFetchUrl(input);
+  const merged = applyLocalNetworkAccess(url, init);
+  return globalThis.fetch(input, merged);
+}
+var installed = false;
+function installLocalNetworkFetch() {
+  if (installed || typeof globalThis.window === "undefined") {
+    return;
+  }
+  installed = true;
+  const nativeFetch = globalThis.fetch.bind(globalThis);
+  globalThis.fetch = (input, init) => {
+    const url = resolveFetchUrl(input);
+    const space = resolveTargetAddressSpace(url);
+    if (!space) {
+      return nativeFetch(input, init);
+    }
+    return nativeFetch(input, applyLocalNetworkAccess(url, init));
+  };
+}
+
 // src/auth/auth-handler.ts
 var DEFAULT_REFRESH_THRESHOLD_MS = 12e4;
 var CONTENT_TYPE_JSON = "application/json";
@@ -304,7 +436,7 @@ var AuthHandler = class {
       headers["Authorization"] = `Bearer ${this._accessToken}`;
     }
     try {
-      await globalThis.fetch(url, {
+      await localNetworkFetch(url, {
         method: "POST",
         headers,
         signal: AbortSignal.timeout(this._timeout)
@@ -337,7 +469,7 @@ var AuthHandler = class {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const response = await globalThis.fetch(url, {
+    const response = await localNetworkFetch(url, {
       method: "GET",
       headers,
       signal: AbortSignal.timeout(this._timeout)
@@ -364,7 +496,7 @@ var AuthHandler = class {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const response = await globalThis.fetch(url, {
+    const response = await localNetworkFetch(url, {
       method: "PUT",
       headers,
       body: JSON.stringify({ currentPassword, newPassword }),
@@ -404,7 +536,7 @@ var AuthHandler = class {
     if (this._accessToken) {
       headers["Authorization"] = `Bearer ${this._accessToken}`;
     }
-    return globalThis.fetch(url, {
+    return localNetworkFetch(url, {
       method,
       headers,
       body: JSON.stringify(body),
@@ -757,7 +889,7 @@ var AuthClient = class {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const response = await globalThis.fetch(endpoint, {
+    const response = await localNetworkFetch(endpoint, {
       method,
       headers,
       body: body !== void 0 && method !== "GET" && method !== "DELETE" ? JSON.stringify(body) : void 0,
@@ -1080,7 +1212,7 @@ var HttpTransport = class {
       init.body = JSON.stringify(config.body);
     }
     try {
-      const response = await fetch(url, init);
+      const response = await localNetworkFetch(url, init);
       if (!response.ok) {
         const text = await response.text();
         if (config.allowStatuses?.includes(response.status) && text) {
@@ -1194,7 +1326,7 @@ var HttpTransport = class {
       init.body = JSON.stringify(config.body);
     }
     try {
-      const response = await fetch(url, init);
+      const response = await localNetworkFetch(url, init);
       if (response.ok || config.allowStatuses?.includes(response.status)) {
         return response;
       }
@@ -4596,7 +4728,7 @@ var LongPollTransport = class {
     this._authHandler = options.authHandler;
     this._onReconnected = options.onReconnected;
     this._waitMs = Math.max(1, options.waitMs ?? DEFAULT_WAIT_MS);
-    this._fetch = options.fetchImpl ?? fetch;
+    this._fetch = options.fetchImpl ?? localNetworkFetch;
   }
   get lastVersion() {
     return this._lastVersion;
@@ -5489,7 +5621,7 @@ function createAoudaClusterMcpToolSet(client) {
 }
 
 // src/index.ts
-var version = "0.0.2";
+var version = package_default.version;
 export {
   AOUDA_DATA_TYPES,
   AdminApi,
@@ -5526,9 +5658,13 @@ export {
   TableQuery,
   TablesApi,
   WhereGroupBuilder,
+  applyLocalNetworkAccess,
   coerceColumnarValue,
   createAoudaClient,
   createAoudaClusterMcpToolSet,
+  installLocalNetworkFetch,
+  localNetworkFetch,
+  resolveTargetAddressSpace,
   version
 };
 //# sourceMappingURL=index.js.map