@aouda/client 0.1.9 → 0.1.11

package/dist/{client-CxP9Vnc8.d.cts → client-CT3GdrvA.d.cts}

@@ -305,6 +305,18 @@ interface AoudaClientOptions {
          */
         longPollWaitMs?: number;
     };
+    /**
+     * Invoked when a named query or named mutation result carries a deprecation warning.
+     * Defaults to `console.warn`. The call still succeeds (D-5).
+     */
+    onNamedArtifactWarning?: (warning: NamedArtifactWarning) => void;
+}
+/** Deprecation (or similar) warning from a named query or named mutation. */
+interface NamedArtifactWarning {
+    code: string;
+    hash?: string;
+    sunsetAt?: string;
+    message: string;
 }
 /**
  * Health status response from the Aouda server.
@@ -430,6 +442,14 @@ interface QueryResult<T = Record<string, unknown>> {
     rows: T[];
     /** Query execution statistics. */
     stats: QueryStats;
+    /** Additive warnings (e.g. named-query deprecation). */
+    warnings?: ResultWarning[];
+}
+/** Additive result warning from the server. */
+interface ResultWarning {
+    code: string;
+    hash?: string;
+    sunsetAt?: string;
 }
 /**
  * Wire protocol comparison operators.
@@ -505,6 +525,7 @@ interface ColumnarResponse {
     data: unknown[][];
     rowCount: number;
     stats: QueryStats;
+    warnings?: ResultWarning[];
 }
 /**
  * Summary of a table returned by list().
@@ -2238,6 +2259,7 @@ declare class AuthHandler {
     private readonly _serverUrl;
     private readonly _timeout;
     private readonly _refreshThresholdMs;
+    private _onAccessTokenRefreshed;
     private readonly _apiKeyMode;
     private readonly _isServiceKeyMode;
     private readonly _userToken;
@@ -2308,6 +2330,7 @@ declare class AuthHandler {
     callMeEndpoint(): Promise<UserProfile>;
     callChangePasswordEndpoint(currentPassword: string, newPassword: string): Promise<void>;
     private shouldProactivelyRefresh;
+    setOnAccessTokenRefreshed(handler: ((token: string) => void) | null): void;
     private _doRefresh;
     private _fetchJson;
     private _tryReadErrorBody;
@@ -2405,12 +2428,23 @@ interface AuthMessage {
     database: string;
     wire_mode?: StreamingWireMode;
 }
+interface ConflateOptions {
+    key?: string[];
+    interval_ms: number;
+}
 interface SubscribeMessage {
     type: "subscribe";
     id: string;
     target: string;
     filter?: Record<string, unknown>;
     resume_from?: number;
+    hash?: string;
+    args?: Record<string, unknown>;
+    conflate?: ConflateOptions;
+}
+interface ReAuthMessage {
+    type: "re_auth";
+    token: string;
 }
 interface UnsubscribeMessage {
     type: "unsubscribe";
@@ -2435,7 +2469,7 @@ interface StreamCloseMessage {
 interface PingMessage {
     type: "ping";
 }
-type ClientMessage = AuthMessage | SubscribeMessage | UnsubscribeMessage | StreamOpenMessage | StreamRowsMessage | StreamCloseMessage | PingMessage;
+type ClientMessage = AuthMessage | ReAuthMessage | SubscribeMessage | UnsubscribeMessage | StreamOpenMessage | StreamRowsMessage | StreamCloseMessage | PingMessage;
 interface AuthOkMessage {
     type: "auth_ok";
     user_id?: string;
@@ -2453,14 +2487,27 @@ interface SnapshotMessage {
     rows: unknown[];
     version: number;
 }
+interface SnapshotCompleteMessage {
+    type: "snapshot_complete";
+    id: string;
+    version: number;
+    row_count: number;
+}
+interface GapMessage {
+    type: "gap";
+    id: string;
+    last_seq: number;
+    discarded: number;
+}
 interface ChangeMessage {
     type: "change";
     id: string;
-    op: "insert" | "update" | "delete";
+    op: "insert" | "update" | "delete" | "upsert";
     row?: unknown;
     prev?: unknown;
     key?: unknown;
     version: number;
+    values_skipped?: number;
 }
 interface StreamAckMessage {
     type: "stream_ack";
@@ -2488,7 +2535,7 @@ interface ServerErrorMessage {
 interface PongMessage {
     type: "pong";
 }
-type ServerMessage = AuthOkMessage | AuthErrorMessage | SnapshotMessage | ChangeMessage | StreamAckMessage | StreamReadyMessage | StreamClosedMessage | HeartbeatMessage | ServerErrorMessage | PongMessage;
+type ServerMessage = AuthOkMessage | AuthErrorMessage | SnapshotMessage | SnapshotCompleteMessage | GapMessage | ChangeMessage | StreamAckMessage | StreamReadyMessage | StreamClosedMessage | HeartbeatMessage | ServerErrorMessage | PongMessage;
 
 type StreamingMessageHandler = (message: ServerMessage) => void;
 interface StreamingTransport {
@@ -2509,11 +2556,12 @@ interface SubscriptionSnapshotEvent<T = Record<string, unknown>> {
 }
 interface SubscriptionChangeEvent<T = Record<string, unknown>> {
     type: "change";
-    op: "insert" | "update" | "delete";
+    op: "insert" | "update" | "delete" | "upsert";
     row?: T;
     prev?: T;
     key?: unknown;
     version: number;
+    values_skipped?: number;
 }
 type SubscriptionEvent<T = Record<string, unknown>> = SubscriptionSnapshotEvent<T> | SubscriptionChangeEvent<T>;
 interface SubscribeOptions<T = Record<string, unknown>> {
@@ -2521,6 +2569,7 @@ interface SubscribeOptions<T = Record<string, unknown>> {
     onChange?: (event: SubscriptionChangeEvent<T>) => void;
     onError?: (error: Error) => void;
     filter?: Record<string, unknown>;
+    conflate?: ConflateOptions;
 }
 interface Subscription<T = Record<string, unknown>> extends AsyncIterable<SubscriptionEvent<T>> {
     readonly id: string;
@@ -2614,6 +2663,13 @@ interface QueryBuilderState {
  * All other types: passed through unchanged.
  */
 declare function coerceColumnarValue(value: unknown, typeName: string): unknown;
+/**
+ * Converts columnar response data to an array of row objects.
+ * Uses `response.types` to apply type-aware coercions (e.g. Timestamp ticks → ISO string).
+ * @param response - The columnar response from the server.
+ * @returns Array of row objects.
+ */
+declare function columnarToRows<T>(response: ColumnarResponse): T[];
 /**
  * Fluent query builder for Aouda tables.
  *
@@ -3552,6 +3608,46 @@ declare class MaterializedQueriesApi {
     query(name: string, _options?: MaterializedQueryExecuteOptions): Promise<MaterializedQueryExecuteResult>;
 }
 
+/**
+ * Hash-only named-query / named-mutation client API (D-5, D-28).
+ */
+
+interface NamedQueryExecuteOptions {
+    signal?: AbortSignal;
+}
+interface NamedQueryBatchItem {
+    hash: string;
+    args?: Record<string, unknown>;
+}
+interface NamedQueryBatchSlotResult<T = Record<string, unknown>> {
+    isError: boolean;
+    code?: string;
+    error?: string;
+    result?: QueryResult<T>;
+}
+interface NamedMutationResult {
+    op: string;
+    rowsAffected: number;
+    returning?: QueryResult<Record<string, unknown>>;
+    warnings?: ResultWarning[];
+}
+type NamedArtifactWarningSink = (warning: NamedArtifactWarning) => void;
+declare class NamedQueriesApi {
+    private readonly transport;
+    private readonly database;
+    private readonly onWarning;
+    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink);
+    execute<T = Record<string, unknown>>(hash: string, args?: Record<string, unknown>, options?: NamedQueryExecuteOptions): Promise<QueryResult<T>>;
+    batch<T = Record<string, unknown>>(items: NamedQueryBatchItem[], options?: NamedQueryExecuteOptions): Promise<NamedQueryBatchSlotResult<T>[]>;
+}
+declare class NamedMutationsApi {
+    private readonly transport;
+    private readonly database;
+    private readonly onWarning;
+    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink);
+    execute(hash: string, args?: Record<string, unknown>): Promise<NamedMutationResult>;
+}
+
 /**
  * @aouda/client — AoudaClient implementation.
  */
@@ -3587,6 +3683,8 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
     private readonly _branches;
     private readonly _admin;
     private readonly _materializedQueries;
+    private readonly _namedQueries;
+    private readonly _namedMutations;
     private readonly _auth;
     private readonly _authHandler;
     private readonly _streamingEnableCompression;
@@ -3694,6 +3792,14 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
      * Materialized query lifecycle (list, create, drop, status, query).
      */
     get materializedQueries(): MaterializedQueriesApi;
+    /**
+     * Hash-only named-query execute and batch. Names are codegen aliases (D-5).
+     */
+    get namedQueries(): NamedQueriesApi;
+    /**
+     * Hash-only named-mutation execute. No batch.
+     */
+    get namedMutations(): NamedMutationsApi;
     /**
      * Access auth operations (signUp, signIn, signOut, refresh, me, changePassword).
      * @returns The auth API.
@@ -3794,4 +3900,4 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
  */
 declare function createAoudaClient<S extends SchemaLike = DefaultSchema>(options: AoudaClientOptions): AoudaClient<S>;
 
-export { type BloomFilterMetrics as $, AoudaClient as A, type BulkLoadOptions as B, type CoverageResponse as C, type DetailedHealthResponse as D, type AggregateFunctionName as E, type FailoverClusterResponse as F, type AlterColumnRequest as G, type HealthStatus as H, type AoudaClientOptions as I, type JoinClusterRequest as J, type AoudaDataType as K, type ListBackupsResponse as L, type AppAuthOptions as M, type NodeInfoResponse as N, AuthClient as O, type PromoteClusterResponse as P, type AuthResult as Q, type ReplicationStatusResponse as R, type SchemaLike as S, type Transport as T, type AuthUserInfo as U, type AuthorizationMode as V, BackupAdminApi as W, type BackupMetrics as X, type BackupSummary as Y, type BatchMutationResult as Z, type BatchOperationInput as _, type BulkLoadJobHandle as a, type MetricsSnapshot as a$, type BranchInfo as a0, BranchesApi as a1, type BulkLoadForceAbortRequest as a2, type BulkLoadForceAbortResponse as a3, type BulkLoadListResponse as a4, type BulkLoadProgress as a5, type BulkLoadReplicaProgress as a6, type BulkLoadReplicaProgressDto as a7, type BulkLoadStatusResponse as a8, CircuitBreakerPolicy as a9, HealthAdminApi as aA, type IndexInfo as aB, type InsertOptions as aC, type InsertResult as aD, type IoMetrics as aE, JobsApi as aF, type LatencyPercentiles as aG, MaterializedQueriesApi as aH, type MaterializedQueryDefinition as aI, type MaterializedQueryExecuteOptions as aJ, type MaterializedQueryExecuteResult as aK, type MaterializedQueryMetrics as aL, type MaterializedQueryRefreshOptions as aM, MaterializedQueryState as aN, type MaterializedQueryStateNumber as aO, type MaterializedQueryStatus as aP, MaterializedQueryType as aQ, type MaterializedQueryTypeNumber as aR, type MemberInfo as aS, type MemoryMetrics as aT, type MergeBranchOptions as aU, type MergeConflict as aV, type MergeExecutionResult as aW, type MergeResult as aX, MetricsAdminApi as aY, type MetricsHistory as aZ, type MetricsHistoryOptions as a_, ClusterAdminApi as aa, type ClusterMemberEntry as ab, type ClusterThisNodeEntry as ac, type ColumnSchema as ad, type ColumnSummaryForErd as ae, type ColumnarResponse as af, type ComponentHealthEntry as ag, type ComputedColumnDef as ah, ConfigAdminApi as ai, type CreateBranchRequest as aj, type CreateColumnRequest as ak, type CreateDatabaseOptions as al, type CreatePartitionGrantRequest as am, type CreateRlsResolverRequest as an, type CreateTableRequest as ao, type DatabaseCoverageEntry as ap, type DatabaseInfo as aq, type DatabaseMemoryMetrics as ar, type DatabaseMemoryUsage as as, type DatabaseMetricsDto as at, type DatabaseOptionsInfo as au, DatabasesApi as av, type DeleteOptions as aw, type DiffSummary as ax, FILTER_OPERATORS as ay, type FilterOperator as az, type TopologyResponse as b, type TableSchemaResponse as b$, type MetricsSummary as b0, type MutationResult as b1, NodeAdminApi as b2, type NodeLogEntry as b3, type NodeLogLevel as b4, type NodeLogStreamOptions as b5, type NodeLogsQuery as b6, type NodeLogsResponse as b7, type OpenWriteStreamOptions as b8, type PageCacheMetrics as b9, type SchemaChange as bA, type SchemaChangeType as bB, type SchemaDiffResult as bC, type SchemaRelationshipsResponse as bD, type SeedApplyResult as bE, type SeedTableApplyResult as bF, ServerAdminApi as bG, type ServerAuthOptions as bH, type ServerMemoryResponse as bI, type ServerMetricsResponse as bJ, type ServiceInfo as bK, type SimdMetrics as bL, type SingleDatabaseMetricsResponse as bM, type SortDirection as bN, type StorageMetrics as bO, type SubscribeOptions as bP, type Subscription as bQ, type SubscriptionChangeEvent as bR, type SubscriptionEvent as bS, type SubscriptionInfo as bT, type SubscriptionSnapshotEvent as bU, TIME_BUCKET_FUNCTIONS as bV, type TableCoverageEntry as bW, type TableNameFromSchema as bX, type TablePolicy as bY, TableQuery as bZ, type TableSchema as b_, type PartitionFunction as ba, type PartitionGrant as bb, type PartitionGrantsListResponse as bc, type PartitioningMetrics as bd, type PendingJobListResponse as be, type PendingJobResponse as bf, type PerDatabaseLagEntry as bg, type PerDatabaseMetrics as bh, type PerDatabaseStatusEntry as bi, type QueryMetrics as bj, type QueryResult as bk, type QueryStats as bl, type ReferenceInfo as bm, type RelationshipEndpoint as bn, type RelationshipInfo as bo, type RenameColumnRequest as bp, type RenameTableRequest as bq, type ReorderColumnsRequest as br, ReplicationAdminApi as bs, type ReplicationMetrics as bt, type ResidencyConfig as bu, RetryPolicy as bv, type RlsResolver as bw, type RlsResolverRule as bx, type RlsResolverRuleInput as by, type RlsResolversListResponse as bz, type ReadinessResponse as c, type TableSummary as c0, type TableSummaryForErd as c1, TablesApi as c2, type TimeBucketFunction as c3, type TimeSeriesMetrics as c4, type TransactionMetrics as c5, type TypeGenerationOptions as c6, type UpdateOptions as c7, type UpdateRlsResolverRequest as c8, type UpdateTableOptionsRequest as c9, type UpdateTablePolicyRequest as ca, type UserProfile as cb, type WalMetrics as cc, WhereGroupBuilder as cd, type WhereOperator as ce, type WriteStream as cf, coerceColumnarValue as cg, createAoudaClient as ch, type TriggerBackupRequest as d, type TriggerBackupResponse as e, type RestoreBackupResponse as f, type BackupSchedule as g, type JoinClusterResponse as h, type LeaveClusterResponse as i, type DrainClusterResponse as j, type ClusterConfigResponse as k, type ClusterConfigPatchRequest as l, type DefaultSchema as m, AGGREGATE_FUNCTIONS as n, AOUDA_DATA_TYPES as o, type AddColumnRequest as p, AdminApi as q, type AdminBackupConfig as r, type AdminBackupPatch as s, type AdminConfigPatchRequest as t, type AdminConfigResponse as u, type AdminConfigSchemaResponse as v, type AdminLoggingConfig as w, type AdminLoggingPatch as x, type AdminMemoryConfig as y, type AdminMemoryPatch as z };
+export { type BloomFilterMetrics as $, AoudaClient as A, type BulkLoadOptions as B, type CoverageResponse as C, type DetailedHealthResponse as D, type AggregateFunctionName as E, type FailoverClusterResponse as F, type AlterColumnRequest as G, type HealthStatus as H, type AoudaClientOptions as I, type JoinClusterRequest as J, type AoudaDataType as K, type ListBackupsResponse as L, type AppAuthOptions as M, type NodeInfoResponse as N, AuthClient as O, type PromoteClusterResponse as P, type AuthResult as Q, type ReplicationStatusResponse as R, type SchemaLike as S, type Transport as T, type AuthUserInfo as U, type AuthorizationMode as V, BackupAdminApi as W, type BackupMetrics as X, type BackupSummary as Y, type BatchMutationResult as Z, type BatchOperationInput as _, type BulkLoadJobHandle as a, type MetricsSnapshot as a$, type BranchInfo as a0, BranchesApi as a1, type BulkLoadForceAbortRequest as a2, type BulkLoadForceAbortResponse as a3, type BulkLoadListResponse as a4, type BulkLoadProgress as a5, type BulkLoadReplicaProgress as a6, type BulkLoadReplicaProgressDto as a7, type BulkLoadStatusResponse as a8, CircuitBreakerPolicy as a9, HealthAdminApi as aA, type IndexInfo as aB, type InsertOptions as aC, type InsertResult as aD, type IoMetrics as aE, JobsApi as aF, type LatencyPercentiles as aG, MaterializedQueriesApi as aH, type MaterializedQueryDefinition as aI, type MaterializedQueryExecuteOptions as aJ, type MaterializedQueryExecuteResult as aK, type MaterializedQueryMetrics as aL, type MaterializedQueryRefreshOptions as aM, MaterializedQueryState as aN, type MaterializedQueryStateNumber as aO, type MaterializedQueryStatus as aP, MaterializedQueryType as aQ, type MaterializedQueryTypeNumber as aR, type MemberInfo as aS, type MemoryMetrics as aT, type MergeBranchOptions as aU, type MergeConflict as aV, type MergeExecutionResult as aW, type MergeResult as aX, MetricsAdminApi as aY, type MetricsHistory as aZ, type MetricsHistoryOptions as a_, ClusterAdminApi as aa, type ClusterMemberEntry as ab, type ClusterThisNodeEntry as ac, type ColumnSchema as ad, type ColumnSummaryForErd as ae, type ColumnarResponse as af, type ComponentHealthEntry as ag, type ComputedColumnDef as ah, ConfigAdminApi as ai, type CreateBranchRequest as aj, type CreateColumnRequest as ak, type CreateDatabaseOptions as al, type CreatePartitionGrantRequest as am, type CreateRlsResolverRequest as an, type CreateTableRequest as ao, type DatabaseCoverageEntry as ap, type DatabaseInfo as aq, type DatabaseMemoryMetrics as ar, type DatabaseMemoryUsage as as, type DatabaseMetricsDto as at, type DatabaseOptionsInfo as au, DatabasesApi as av, type DeleteOptions as aw, type DiffSummary as ax, FILTER_OPERATORS as ay, type FilterOperator as az, type TopologyResponse as b, type SubscriptionInfo as b$, type MetricsSummary as b0, type MutationResult as b1, type NamedArtifactWarning as b2, type NamedMutationResult as b3, NamedMutationsApi as b4, NamedQueriesApi as b5, type NamedQueryBatchItem as b6, type NamedQueryBatchSlotResult as b7, type NamedQueryExecuteOptions as b8, NodeAdminApi as b9, type ReplicationMetrics as bA, type ResidencyConfig as bB, type ResultWarning as bC, RetryPolicy as bD, type RlsResolver as bE, type RlsResolverRule as bF, type RlsResolverRuleInput as bG, type RlsResolversListResponse as bH, type SchemaChange as bI, type SchemaChangeType as bJ, type SchemaDiffResult as bK, type SchemaRelationshipsResponse as bL, type SeedApplyResult as bM, type SeedTableApplyResult as bN, ServerAdminApi as bO, type ServerAuthOptions as bP, type ServerMemoryResponse as bQ, type ServerMetricsResponse as bR, type ServiceInfo as bS, type SimdMetrics as bT, type SingleDatabaseMetricsResponse as bU, type SortDirection as bV, type StorageMetrics as bW, type SubscribeOptions as bX, type Subscription as bY, type SubscriptionChangeEvent as bZ, type SubscriptionEvent as b_, type NodeLogEntry as ba, type NodeLogLevel as bb, type NodeLogStreamOptions as bc, type NodeLogsQuery as bd, type NodeLogsResponse as be, type OpenWriteStreamOptions as bf, type PageCacheMetrics as bg, type PartitionFunction as bh, type PartitionGrant as bi, type PartitionGrantsListResponse as bj, type PartitioningMetrics as bk, type PendingJobListResponse as bl, type PendingJobResponse as bm, type PerDatabaseLagEntry as bn, type PerDatabaseMetrics as bo, type PerDatabaseStatusEntry as bp, type QueryMetrics as bq, type QueryResult as br, type QueryStats as bs, type ReferenceInfo as bt, type RelationshipEndpoint as bu, type RelationshipInfo as bv, type RenameColumnRequest as bw, type RenameTableRequest as bx, type ReorderColumnsRequest as by, ReplicationAdminApi as bz, type ReadinessResponse as c, type SubscriptionSnapshotEvent as c0, TIME_BUCKET_FUNCTIONS as c1, type TableCoverageEntry as c2, type TableNameFromSchema as c3, type TablePolicy as c4, TableQuery as c5, type TableSchema as c6, type TableSchemaResponse as c7, type TableSummary as c8, type TableSummaryForErd as c9, TablesApi as ca, type TimeBucketFunction as cb, type TimeSeriesMetrics as cc, type TransactionMetrics as cd, type TypeGenerationOptions as ce, type UpdateOptions as cf, type UpdateRlsResolverRequest as cg, type UpdateTableOptionsRequest as ch, type UpdateTablePolicyRequest as ci, type UserProfile as cj, type WalMetrics as ck, WhereGroupBuilder as cl, type WhereOperator as cm, type WriteStream as cn, coerceColumnarValue as co, columnarToRows as cp, createAoudaClient as cq, type TriggerBackupRequest as d, type TriggerBackupResponse as e, type RestoreBackupResponse as f, type BackupSchedule as g, type JoinClusterResponse as h, type LeaveClusterResponse as i, type DrainClusterResponse as j, type ClusterConfigResponse as k, type ClusterConfigPatchRequest as l, type DefaultSchema as m, AGGREGATE_FUNCTIONS as n, AOUDA_DATA_TYPES as o, type AddColumnRequest as p, AdminApi as q, type AdminBackupConfig as r, type AdminBackupPatch as s, type AdminConfigPatchRequest as t, type AdminConfigResponse as u, type AdminConfigSchemaResponse as v, type AdminLoggingConfig as w, type AdminLoggingPatch as x, type AdminMemoryConfig as y, type AdminMemoryPatch as z };

package/dist/{client-CxP9Vnc8.d.ts → client-CT3GdrvA.d.ts}

@@ -305,6 +305,18 @@ interface AoudaClientOptions {
          */
         longPollWaitMs?: number;
     };
+    /**
+     * Invoked when a named query or named mutation result carries a deprecation warning.
+     * Defaults to `console.warn`. The call still succeeds (D-5).
+     */
+    onNamedArtifactWarning?: (warning: NamedArtifactWarning) => void;
+}
+/** Deprecation (or similar) warning from a named query or named mutation. */
+interface NamedArtifactWarning {
+    code: string;
+    hash?: string;
+    sunsetAt?: string;
+    message: string;
 }
 /**
  * Health status response from the Aouda server.
@@ -430,6 +442,14 @@ interface QueryResult<T = Record<string, unknown>> {
     rows: T[];
     /** Query execution statistics. */
     stats: QueryStats;
+    /** Additive warnings (e.g. named-query deprecation). */
+    warnings?: ResultWarning[];
+}
+/** Additive result warning from the server. */
+interface ResultWarning {
+    code: string;
+    hash?: string;
+    sunsetAt?: string;
 }
 /**
  * Wire protocol comparison operators.
@@ -505,6 +525,7 @@ interface ColumnarResponse {
     data: unknown[][];
     rowCount: number;
     stats: QueryStats;
+    warnings?: ResultWarning[];
 }
 /**
  * Summary of a table returned by list().
@@ -2238,6 +2259,7 @@ declare class AuthHandler {
     private readonly _serverUrl;
     private readonly _timeout;
     private readonly _refreshThresholdMs;
+    private _onAccessTokenRefreshed;
     private readonly _apiKeyMode;
     private readonly _isServiceKeyMode;
     private readonly _userToken;
@@ -2308,6 +2330,7 @@ declare class AuthHandler {
     callMeEndpoint(): Promise<UserProfile>;
     callChangePasswordEndpoint(currentPassword: string, newPassword: string): Promise<void>;
     private shouldProactivelyRefresh;
+    setOnAccessTokenRefreshed(handler: ((token: string) => void) | null): void;
     private _doRefresh;
     private _fetchJson;
     private _tryReadErrorBody;
@@ -2405,12 +2428,23 @@ interface AuthMessage {
     database: string;
     wire_mode?: StreamingWireMode;
 }
+interface ConflateOptions {
+    key?: string[];
+    interval_ms: number;
+}
 interface SubscribeMessage {
     type: "subscribe";
     id: string;
     target: string;
     filter?: Record<string, unknown>;
     resume_from?: number;
+    hash?: string;
+    args?: Record<string, unknown>;
+    conflate?: ConflateOptions;
+}
+interface ReAuthMessage {
+    type: "re_auth";
+    token: string;
 }
 interface UnsubscribeMessage {
     type: "unsubscribe";
@@ -2435,7 +2469,7 @@ interface StreamCloseMessage {
 interface PingMessage {
     type: "ping";
 }
-type ClientMessage = AuthMessage | SubscribeMessage | UnsubscribeMessage | StreamOpenMessage | StreamRowsMessage | StreamCloseMessage | PingMessage;
+type ClientMessage = AuthMessage | ReAuthMessage | SubscribeMessage | UnsubscribeMessage | StreamOpenMessage | StreamRowsMessage | StreamCloseMessage | PingMessage;
 interface AuthOkMessage {
     type: "auth_ok";
     user_id?: string;
@@ -2453,14 +2487,27 @@ interface SnapshotMessage {
     rows: unknown[];
     version: number;
 }
+interface SnapshotCompleteMessage {
+    type: "snapshot_complete";
+    id: string;
+    version: number;
+    row_count: number;
+}
+interface GapMessage {
+    type: "gap";
+    id: string;
+    last_seq: number;
+    discarded: number;
+}
 interface ChangeMessage {
     type: "change";
     id: string;
-    op: "insert" | "update" | "delete";
+    op: "insert" | "update" | "delete" | "upsert";
     row?: unknown;
     prev?: unknown;
     key?: unknown;
     version: number;
+    values_skipped?: number;
 }
 interface StreamAckMessage {
     type: "stream_ack";
@@ -2488,7 +2535,7 @@ interface ServerErrorMessage {
 interface PongMessage {
     type: "pong";
 }
-type ServerMessage = AuthOkMessage | AuthErrorMessage | SnapshotMessage | ChangeMessage | StreamAckMessage | StreamReadyMessage | StreamClosedMessage | HeartbeatMessage | ServerErrorMessage | PongMessage;
+type ServerMessage = AuthOkMessage | AuthErrorMessage | SnapshotMessage | SnapshotCompleteMessage | GapMessage | ChangeMessage | StreamAckMessage | StreamReadyMessage | StreamClosedMessage | HeartbeatMessage | ServerErrorMessage | PongMessage;
 
 type StreamingMessageHandler = (message: ServerMessage) => void;
 interface StreamingTransport {
@@ -2509,11 +2556,12 @@ interface SubscriptionSnapshotEvent<T = Record<string, unknown>> {
 }
 interface SubscriptionChangeEvent<T = Record<string, unknown>> {
     type: "change";
-    op: "insert" | "update" | "delete";
+    op: "insert" | "update" | "delete" | "upsert";
     row?: T;
     prev?: T;
     key?: unknown;
     version: number;
+    values_skipped?: number;
 }
 type SubscriptionEvent<T = Record<string, unknown>> = SubscriptionSnapshotEvent<T> | SubscriptionChangeEvent<T>;
 interface SubscribeOptions<T = Record<string, unknown>> {
@@ -2521,6 +2569,7 @@ interface SubscribeOptions<T = Record<string, unknown>> {
     onChange?: (event: SubscriptionChangeEvent<T>) => void;
     onError?: (error: Error) => void;
     filter?: Record<string, unknown>;
+    conflate?: ConflateOptions;
 }
 interface Subscription<T = Record<string, unknown>> extends AsyncIterable<SubscriptionEvent<T>> {
     readonly id: string;
@@ -2614,6 +2663,13 @@ interface QueryBuilderState {
  * All other types: passed through unchanged.
  */
 declare function coerceColumnarValue(value: unknown, typeName: string): unknown;
+/**
+ * Converts columnar response data to an array of row objects.
+ * Uses `response.types` to apply type-aware coercions (e.g. Timestamp ticks → ISO string).
+ * @param response - The columnar response from the server.
+ * @returns Array of row objects.
+ */
+declare function columnarToRows<T>(response: ColumnarResponse): T[];
 /**
  * Fluent query builder for Aouda tables.
  *
@@ -3552,6 +3608,46 @@ declare class MaterializedQueriesApi {
     query(name: string, _options?: MaterializedQueryExecuteOptions): Promise<MaterializedQueryExecuteResult>;
 }
 
+/**
+ * Hash-only named-query / named-mutation client API (D-5, D-28).
+ */
+
+interface NamedQueryExecuteOptions {
+    signal?: AbortSignal;
+}
+interface NamedQueryBatchItem {
+    hash: string;
+    args?: Record<string, unknown>;
+}
+interface NamedQueryBatchSlotResult<T = Record<string, unknown>> {
+    isError: boolean;
+    code?: string;
+    error?: string;
+    result?: QueryResult<T>;
+}
+interface NamedMutationResult {
+    op: string;
+    rowsAffected: number;
+    returning?: QueryResult<Record<string, unknown>>;
+    warnings?: ResultWarning[];
+}
+type NamedArtifactWarningSink = (warning: NamedArtifactWarning) => void;
+declare class NamedQueriesApi {
+    private readonly transport;
+    private readonly database;
+    private readonly onWarning;
+    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink);
+    execute<T = Record<string, unknown>>(hash: string, args?: Record<string, unknown>, options?: NamedQueryExecuteOptions): Promise<QueryResult<T>>;
+    batch<T = Record<string, unknown>>(items: NamedQueryBatchItem[], options?: NamedQueryExecuteOptions): Promise<NamedQueryBatchSlotResult<T>[]>;
+}
+declare class NamedMutationsApi {
+    private readonly transport;
+    private readonly database;
+    private readonly onWarning;
+    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink);
+    execute(hash: string, args?: Record<string, unknown>): Promise<NamedMutationResult>;
+}
+
 /**
  * @aouda/client — AoudaClient implementation.
  */
@@ -3587,6 +3683,8 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
     private readonly _branches;
     private readonly _admin;
     private readonly _materializedQueries;
+    private readonly _namedQueries;
+    private readonly _namedMutations;
     private readonly _auth;
     private readonly _authHandler;
     private readonly _streamingEnableCompression;
@@ -3694,6 +3792,14 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
      * Materialized query lifecycle (list, create, drop, status, query).
      */
     get materializedQueries(): MaterializedQueriesApi;
+    /**
+     * Hash-only named-query execute and batch. Names are codegen aliases (D-5).
+     */
+    get namedQueries(): NamedQueriesApi;
+    /**
+     * Hash-only named-mutation execute. No batch.
+     */
+    get namedMutations(): NamedMutationsApi;
     /**
      * Access auth operations (signUp, signIn, signOut, refresh, me, changePassword).
      * @returns The auth API.
@@ -3794,4 +3900,4 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
  */
 declare function createAoudaClient<S extends SchemaLike = DefaultSchema>(options: AoudaClientOptions): AoudaClient<S>;
 
-export { type BloomFilterMetrics as $, AoudaClient as A, type BulkLoadOptions as B, type CoverageResponse as C, type DetailedHealthResponse as D, type AggregateFunctionName as E, type FailoverClusterResponse as F, type AlterColumnRequest as G, type HealthStatus as H, type AoudaClientOptions as I, type JoinClusterRequest as J, type AoudaDataType as K, type ListBackupsResponse as L, type AppAuthOptions as M, type NodeInfoResponse as N, AuthClient as O, type PromoteClusterResponse as P, type AuthResult as Q, type ReplicationStatusResponse as R, type SchemaLike as S, type Transport as T, type AuthUserInfo as U, type AuthorizationMode as V, BackupAdminApi as W, type BackupMetrics as X, type BackupSummary as Y, type BatchMutationResult as Z, type BatchOperationInput as _, type BulkLoadJobHandle as a, type MetricsSnapshot as a$, type BranchInfo as a0, BranchesApi as a1, type BulkLoadForceAbortRequest as a2, type BulkLoadForceAbortResponse as a3, type BulkLoadListResponse as a4, type BulkLoadProgress as a5, type BulkLoadReplicaProgress as a6, type BulkLoadReplicaProgressDto as a7, type BulkLoadStatusResponse as a8, CircuitBreakerPolicy as a9, HealthAdminApi as aA, type IndexInfo as aB, type InsertOptions as aC, type InsertResult as aD, type IoMetrics as aE, JobsApi as aF, type LatencyPercentiles as aG, MaterializedQueriesApi as aH, type MaterializedQueryDefinition as aI, type MaterializedQueryExecuteOptions as aJ, type MaterializedQueryExecuteResult as aK, type MaterializedQueryMetrics as aL, type MaterializedQueryRefreshOptions as aM, MaterializedQueryState as aN, type MaterializedQueryStateNumber as aO, type MaterializedQueryStatus as aP, MaterializedQueryType as aQ, type MaterializedQueryTypeNumber as aR, type MemberInfo as aS, type MemoryMetrics as aT, type MergeBranchOptions as aU, type MergeConflict as aV, type MergeExecutionResult as aW, type MergeResult as aX, MetricsAdminApi as aY, type MetricsHistory as aZ, type MetricsHistoryOptions as a_, ClusterAdminApi as aa, type ClusterMemberEntry as ab, type ClusterThisNodeEntry as ac, type ColumnSchema as ad, type ColumnSummaryForErd as ae, type ColumnarResponse as af, type ComponentHealthEntry as ag, type ComputedColumnDef as ah, ConfigAdminApi as ai, type CreateBranchRequest as aj, type CreateColumnRequest as ak, type CreateDatabaseOptions as al, type CreatePartitionGrantRequest as am, type CreateRlsResolverRequest as an, type CreateTableRequest as ao, type DatabaseCoverageEntry as ap, type DatabaseInfo as aq, type DatabaseMemoryMetrics as ar, type DatabaseMemoryUsage as as, type DatabaseMetricsDto as at, type DatabaseOptionsInfo as au, DatabasesApi as av, type DeleteOptions as aw, type DiffSummary as ax, FILTER_OPERATORS as ay, type FilterOperator as az, type TopologyResponse as b, type TableSchemaResponse as b$, type MetricsSummary as b0, type MutationResult as b1, NodeAdminApi as b2, type NodeLogEntry as b3, type NodeLogLevel as b4, type NodeLogStreamOptions as b5, type NodeLogsQuery as b6, type NodeLogsResponse as b7, type OpenWriteStreamOptions as b8, type PageCacheMetrics as b9, type SchemaChange as bA, type SchemaChangeType as bB, type SchemaDiffResult as bC, type SchemaRelationshipsResponse as bD, type SeedApplyResult as bE, type SeedTableApplyResult as bF, ServerAdminApi as bG, type ServerAuthOptions as bH, type ServerMemoryResponse as bI, type ServerMetricsResponse as bJ, type ServiceInfo as bK, type SimdMetrics as bL, type SingleDatabaseMetricsResponse as bM, type SortDirection as bN, type StorageMetrics as bO, type SubscribeOptions as bP, type Subscription as bQ, type SubscriptionChangeEvent as bR, type SubscriptionEvent as bS, type SubscriptionInfo as bT, type SubscriptionSnapshotEvent as bU, TIME_BUCKET_FUNCTIONS as bV, type TableCoverageEntry as bW, type TableNameFromSchema as bX, type TablePolicy as bY, TableQuery as bZ, type TableSchema as b_, type PartitionFunction as ba, type PartitionGrant as bb, type PartitionGrantsListResponse as bc, type PartitioningMetrics as bd, type PendingJobListResponse as be, type PendingJobResponse as bf, type PerDatabaseLagEntry as bg, type PerDatabaseMetrics as bh, type PerDatabaseStatusEntry as bi, type QueryMetrics as bj, type QueryResult as bk, type QueryStats as bl, type ReferenceInfo as bm, type RelationshipEndpoint as bn, type RelationshipInfo as bo, type RenameColumnRequest as bp, type RenameTableRequest as bq, type ReorderColumnsRequest as br, ReplicationAdminApi as bs, type ReplicationMetrics as bt, type ResidencyConfig as bu, RetryPolicy as bv, type RlsResolver as bw, type RlsResolverRule as bx, type RlsResolverRuleInput as by, type RlsResolversListResponse as bz, type ReadinessResponse as c, type TableSummary as c0, type TableSummaryForErd as c1, TablesApi as c2, type TimeBucketFunction as c3, type TimeSeriesMetrics as c4, type TransactionMetrics as c5, type TypeGenerationOptions as c6, type UpdateOptions as c7, type UpdateRlsResolverRequest as c8, type UpdateTableOptionsRequest as c9, type UpdateTablePolicyRequest as ca, type UserProfile as cb, type WalMetrics as cc, WhereGroupBuilder as cd, type WhereOperator as ce, type WriteStream as cf, coerceColumnarValue as cg, createAoudaClient as ch, type TriggerBackupRequest as d, type TriggerBackupResponse as e, type RestoreBackupResponse as f, type BackupSchedule as g, type JoinClusterResponse as h, type LeaveClusterResponse as i, type DrainClusterResponse as j, type ClusterConfigResponse as k, type ClusterConfigPatchRequest as l, type DefaultSchema as m, AGGREGATE_FUNCTIONS as n, AOUDA_DATA_TYPES as o, type AddColumnRequest as p, AdminApi as q, type AdminBackupConfig as r, type AdminBackupPatch as s, type AdminConfigPatchRequest as t, type AdminConfigResponse as u, type AdminConfigSchemaResponse as v, type AdminLoggingConfig as w, type AdminLoggingPatch as x, type AdminMemoryConfig as y, type AdminMemoryPatch as z };
+export { type BloomFilterMetrics as $, AoudaClient as A, type BulkLoadOptions as B, type CoverageResponse as C, type DetailedHealthResponse as D, type AggregateFunctionName as E, type FailoverClusterResponse as F, type AlterColumnRequest as G, type HealthStatus as H, type AoudaClientOptions as I, type JoinClusterRequest as J, type AoudaDataType as K, type ListBackupsResponse as L, type AppAuthOptions as M, type NodeInfoResponse as N, AuthClient as O, type PromoteClusterResponse as P, type AuthResult as Q, type ReplicationStatusResponse as R, type SchemaLike as S, type Transport as T, type AuthUserInfo as U, type AuthorizationMode as V, BackupAdminApi as W, type BackupMetrics as X, type BackupSummary as Y, type BatchMutationResult as Z, type BatchOperationInput as _, type BulkLoadJobHandle as a, type MetricsSnapshot as a$, type BranchInfo as a0, BranchesApi as a1, type BulkLoadForceAbortRequest as a2, type BulkLoadForceAbortResponse as a3, type BulkLoadListResponse as a4, type BulkLoadProgress as a5, type BulkLoadReplicaProgress as a6, type BulkLoadReplicaProgressDto as a7, type BulkLoadStatusResponse as a8, CircuitBreakerPolicy as a9, HealthAdminApi as aA, type IndexInfo as aB, type InsertOptions as aC, type InsertResult as aD, type IoMetrics as aE, JobsApi as aF, type LatencyPercentiles as aG, MaterializedQueriesApi as aH, type MaterializedQueryDefinition as aI, type MaterializedQueryExecuteOptions as aJ, type MaterializedQueryExecuteResult as aK, type MaterializedQueryMetrics as aL, type MaterializedQueryRefreshOptions as aM, MaterializedQueryState as aN, type MaterializedQueryStateNumber as aO, type MaterializedQueryStatus as aP, MaterializedQueryType as aQ, type MaterializedQueryTypeNumber as aR, type MemberInfo as aS, type MemoryMetrics as aT, type MergeBranchOptions as aU, type MergeConflict as aV, type MergeExecutionResult as aW, type MergeResult as aX, MetricsAdminApi as aY, type MetricsHistory as aZ, type MetricsHistoryOptions as a_, ClusterAdminApi as aa, type ClusterMemberEntry as ab, type ClusterThisNodeEntry as ac, type ColumnSchema as ad, type ColumnSummaryForErd as ae, type ColumnarResponse as af, type ComponentHealthEntry as ag, type ComputedColumnDef as ah, ConfigAdminApi as ai, type CreateBranchRequest as aj, type CreateColumnRequest as ak, type CreateDatabaseOptions as al, type CreatePartitionGrantRequest as am, type CreateRlsResolverRequest as an, type CreateTableRequest as ao, type DatabaseCoverageEntry as ap, type DatabaseInfo as aq, type DatabaseMemoryMetrics as ar, type DatabaseMemoryUsage as as, type DatabaseMetricsDto as at, type DatabaseOptionsInfo as au, DatabasesApi as av, type DeleteOptions as aw, type DiffSummary as ax, FILTER_OPERATORS as ay, type FilterOperator as az, type TopologyResponse as b, type SubscriptionInfo as b$, type MetricsSummary as b0, type MutationResult as b1, type NamedArtifactWarning as b2, type NamedMutationResult as b3, NamedMutationsApi as b4, NamedQueriesApi as b5, type NamedQueryBatchItem as b6, type NamedQueryBatchSlotResult as b7, type NamedQueryExecuteOptions as b8, NodeAdminApi as b9, type ReplicationMetrics as bA, type ResidencyConfig as bB, type ResultWarning as bC, RetryPolicy as bD, type RlsResolver as bE, type RlsResolverRule as bF, type RlsResolverRuleInput as bG, type RlsResolversListResponse as bH, type SchemaChange as bI, type SchemaChangeType as bJ, type SchemaDiffResult as bK, type SchemaRelationshipsResponse as bL, type SeedApplyResult as bM, type SeedTableApplyResult as bN, ServerAdminApi as bO, type ServerAuthOptions as bP, type ServerMemoryResponse as bQ, type ServerMetricsResponse as bR, type ServiceInfo as bS, type SimdMetrics as bT, type SingleDatabaseMetricsResponse as bU, type SortDirection as bV, type StorageMetrics as bW, type SubscribeOptions as bX, type Subscription as bY, type SubscriptionChangeEvent as bZ, type SubscriptionEvent as b_, type NodeLogEntry as ba, type NodeLogLevel as bb, type NodeLogStreamOptions as bc, type NodeLogsQuery as bd, type NodeLogsResponse as be, type OpenWriteStreamOptions as bf, type PageCacheMetrics as bg, type PartitionFunction as bh, type PartitionGrant as bi, type PartitionGrantsListResponse as bj, type PartitioningMetrics as bk, type PendingJobListResponse as bl, type PendingJobResponse as bm, type PerDatabaseLagEntry as bn, type PerDatabaseMetrics as bo, type PerDatabaseStatusEntry as bp, type QueryMetrics as bq, type QueryResult as br, type QueryStats as bs, type ReferenceInfo as bt, type RelationshipEndpoint as bu, type RelationshipInfo as bv, type RenameColumnRequest as bw, type RenameTableRequest as bx, type ReorderColumnsRequest as by, ReplicationAdminApi as bz, type ReadinessResponse as c, type SubscriptionSnapshotEvent as c0, TIME_BUCKET_FUNCTIONS as c1, type TableCoverageEntry as c2, type TableNameFromSchema as c3, type TablePolicy as c4, TableQuery as c5, type TableSchema as c6, type TableSchemaResponse as c7, type TableSummary as c8, type TableSummaryForErd as c9, TablesApi as ca, type TimeBucketFunction as cb, type TimeSeriesMetrics as cc, type TransactionMetrics as cd, type TypeGenerationOptions as ce, type UpdateOptions as cf, type UpdateRlsResolverRequest as cg, type UpdateTableOptionsRequest as ch, type UpdateTablePolicyRequest as ci, type UserProfile as cj, type WalMetrics as ck, WhereGroupBuilder as cl, type WhereOperator as cm, type WriteStream as cn, coerceColumnarValue as co, columnarToRows as cp, createAoudaClient as cq, type TriggerBackupRequest as d, type TriggerBackupResponse as e, type RestoreBackupResponse as f, type BackupSchedule as g, type JoinClusterResponse as h, type LeaveClusterResponse as i, type DrainClusterResponse as j, type ClusterConfigResponse as k, type ClusterConfigPatchRequest as l, type DefaultSchema as m, AGGREGATE_FUNCTIONS as n, AOUDA_DATA_TYPES as o, type AddColumnRequest as p, AdminApi as q, type AdminBackupConfig as r, type AdminBackupPatch as s, type AdminConfigPatchRequest as t, type AdminConfigResponse as u, type AdminConfigSchemaResponse as v, type AdminLoggingConfig as w, type AdminLoggingPatch as x, type AdminMemoryConfig as y, type AdminMemoryPatch as z };