@aouda/client 0.1.15 → 0.1.17

package/dist/{client-CXfjcF61.d.cts → client-CeON_I6V.d.cts}

@@ -447,6 +447,15 @@ interface RequestOptions {
     /** Sent as X-Request-Id header when provided. */
     requestId?: string;
 }
+/**
+ * Per-row rejection detail on HTTP `rowErrors` and write-stream `ErrorMessage.errors`.
+ * Same three fields as C# `StreamAckRowError`.
+ */
+interface StreamAckRowError {
+    index: number;
+    code: string;
+    message: string;
+}
 /**
  * User-facing comparison operator for where clauses.
  * Mapped to wire protocol operators (eq, ne, gt, etc.) internally.
@@ -1118,6 +1127,27 @@ interface DatabaseInfo {
      * "application" databases are end-user auth stores browsable via the data explorer.
      */
     authDatabaseKind: "none" | "server" | "application";
+    /**
+     * Non-secret auth linkage. Distinct from `authDatabaseKind`:
+     * `authDatabaseKind` says whether *this* database is an auth store;
+     * `auth.enabled` / `auth.database` say whether this data database is linked to one.
+     * GET/list never include `keys` (`mk_*` is create/regenerate only).
+     * Absent on servers older than this field (treat as unknown, not unlinked).
+     */
+    auth?: DatabaseAuthInfo;
+}
+/** App auth keys shown once at create/regenerate. Never re-emitted on GET. */
+interface DatabaseAuthKeys {
+    anonKey: string;
+    serviceRoleKey: string;
+    publicKey?: string;
+}
+/** Non-secret auth linkage on list/get/create. */
+interface DatabaseAuthInfo {
+    enabled: boolean;
+    database: string | null;
+    /** Present only on create or key regeneration. */
+    keys?: DatabaseAuthKeys;
 }
 /**
  * Options when creating a database (camelCase, matches server request).
@@ -1936,11 +1966,26 @@ interface BackupSummary {
     newFileCount: number;
     /** Database names included in this backup run. Present on server >= 0.0.x. */
     databases?: string[];
+    /** True when every contributing manifest recorded a non-zero WAL position (ADR 0044 D-2). */
+    pitrEligible?: boolean;
 }
 interface ListBackupsResponse {
     backups: BackupSummary[];
     warning?: string | null;
 }
+interface RestoreBackupRequest {
+    backupId?: string | null;
+    targetTime?: string | null;
+}
+interface DatabasePitrResult {
+    database: string;
+    replayed: boolean;
+    transactionsReplayed: number;
+    rowsReplayed: number;
+    lastAppliedCommitUtc?: string | null;
+    stoppedAtTarget: boolean;
+    error?: string | null;
+}
 interface RestoreBackupResponse {
     backupId: string;
     restoredUtc: string;
@@ -1948,6 +1993,8 @@ interface RestoreBackupResponse {
     bytesDownloaded: number;
     integrityVerified: boolean;
     durationSeconds: number;
+    targetTime?: string | null;
+    pitr?: DatabasePitrResult[] | null;
 }
 interface BackupSchedule {
     cronExpression?: string | null;
@@ -1974,10 +2021,11 @@ declare class BackupAdminApi {
      */
     list(): Promise<ListBackupsResponse>;
     /**
-     * Restore a backup by id.
-     * POST /admin/backup/restore/{id}
+     * Restore a backup. The string form is an exact restore of that id
+     * (`POST /admin/backup/restore/{id}` with `{}`). The object form posts the body to
+     * `POST /admin/backup/restore` and may carry `targetTime` for point-in-time recovery.
      */
-    restore(backupId: string): Promise<RestoreBackupResponse>;
+    restore(input: string | RestoreBackupRequest): Promise<RestoreBackupResponse>;
     /**
      * Get backup schedule.
      * GET /admin/backup/schedule
@@ -2514,8 +2562,9 @@ declare class AuthClient {
 
 /**
  * Wire protocol message types for Aouda real-time streaming (ADR 0020 §4).
- * No imports — pure type definitions.
+ * Type-only import of StreamAckRowError is allowed; no runtime imports.
  */
+
 type StreamingWireMode = "json" | "msgpack";
 interface AuthMessage {
     type: "auth";
@@ -2642,6 +2691,7 @@ interface ServerErrorMessage {
     id?: string;
     code: string;
     message: string;
+    errors?: StreamAckRowError[];
 }
 interface PongMessage {
     type: "pong";
@@ -2982,6 +3032,12 @@ declare class TableQuery<T = Record<string, unknown>> {
      * evaluated per row on the server. Computed columns are appended after any physical-column
      * `select()` projection.
      *
+     * Result types are inferred by the server where the expression permits
+     * (e.g. Int32 → `number`). Uninferable expressions use wire `"Unknown"` /
+     * codegen `unknown`. Computed columns are always nullable. Named-query
+     * `*Row` properties pick this up when regenerated against a post-S08 server.
+     * See aouda-docs/guides/browser-tier-read-limits.md#selectexpr-result-types
+     *
      * @param projections - One or more `{ alias, expr }` pairs.
      * @returns A new TableQuery with computed columns set.
      *
@@ -3445,8 +3501,10 @@ interface SchemaColumnDefinition {
     encoder?: string;
     default?: string;
     description?: string;
-    /** Write-time derived expression (stored, not virtual). */
-    derived?: ScalarExprNode;
+    /** Write-time derived expression, or `{ identity: "subject" }` (P43 stamp). */
+    derived?: ScalarExprNode | {
+        identity: string;
+    };
     unique?: boolean;
 }
 /** A single insert-time `route` or `tee` transform. */
@@ -3467,6 +3525,8 @@ interface SchemaTableDefinition {
     authMode?: string;
     permissionDimension?: string;
     rlsResolverName?: string;
+    /** jwt-claim PLS source: `subject` or `claim:<name>`. Omit = `claim:tenant_id`. */
+    plsClaimBinding?: string;
     culture?: string;
     checks?: Record<string, WhereClause>;
     transforms?: SchemaTableTransform[];
@@ -3553,6 +3613,20 @@ interface SchemaFilterPredicate {
 interface SchemaMaterializedStorage {
     storageTemperature?: string;
 }
+/**
+ * Closed sortable type set for aggregate MQ computed outputs
+ * (`ComputedOutputValidation.AllowedTypeNames` / JSON-schema `MaterializedComputedOutput`).
+ */
+type SchemaComputedOutputType = "Int64" | "Double" | "Decimal" | "String" | "Timestamp" | "Date";
+/**
+ * One computed public column of an aggregate materialized query (ADR 0040 `D-36`).
+ * Wire keys are `outputName` + `type` + `expr` — not query `selectExpr` `{ alias, expr }`.
+ */
+interface SchemaComputedOutput {
+    outputName: string;
+    type: SchemaComputedOutputType;
+    expr: ScalarExprNode;
+}
 /**
  * Materialized-query declaration in `materializedQueries`.
  * `groupBy` items are a column-name string or `{ column, function?, outputName? }`.
@@ -3568,6 +3642,16 @@ interface SchemaMaterializedQuery {
     predicate?: SchemaFilterPredicate;
     updateMode?: string;
     storage?: SchemaMaterializedStorage;
+    /**
+     * Direct-client access on the MQ result table. Defaults `false` at apply.
+     * Flipping this is `UpdateDataPlaneAccess`, not a replace.
+     */
+    dataPlaneAccess?: boolean;
+    /**
+     * Write-time public columns on an aggregate MQ. Aggregate-only at apply;
+     * other `type` values with `computed` set are a server `SchemaValidationException`, not a TS error.
+     */
+    computed?: SchemaComputedOutput[];
 }
 /** Root type for `aouda.schema.json`. */
 interface SchemaDocument {
@@ -4307,4 +4391,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 MetricsHistory 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, type FilterOperator as aA, HealthAdminApi as aB, type IndexInfo as aC, type InsertOptions as aD, type InsertResult as aE, type IoMetrics as aF, JobsApi as aG, type LatencyPercentiles as aH, MaterializedQueriesApi as aI, type MaterializedQueryDefinition as aJ, type MaterializedQueryExecuteOptions as aK, type MaterializedQueryExecuteResult as aL, type MaterializedQueryMetrics as aM, type MaterializedQueryRefreshOptions as aN, MaterializedQueryState as aO, type MaterializedQueryStateNumber as aP, type MaterializedQueryStatus as aQ, MaterializedQueryType as aR, type MaterializedQueryTypeNumber as aS, type MemberInfo as aT, MemoryConsistencyTokenStore as aU, type MemoryMetrics as aV, type MergeBranchOptions as aW, type MergeConflict as aX, type MergeExecutionResult as aY, type MergeResult as aZ, MetricsAdminApi 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 ConsistencyTokenStore as aj, type CreateBranchRequest as ak, type CreateColumnRequest as al, type CreateDatabaseOptions as am, type CreatePartitionGrantRequest as an, type CreateRlsResolverRequest as ao, type CreateTableRequest as ap, type DatabaseCoverageEntry as aq, type DatabaseInfo as ar, type DatabaseMemoryMetrics as as, type DatabaseMemoryUsage as at, type DatabaseMetricsDto as au, type DatabaseOptionsInfo as av, DatabasesApi as aw, type DeleteOptions as ax, type DiffSummary as ay, FILTER_OPERATORS as az, type TopologyResponse as b, type SchemaFilterPredicate as b$, type MetricsHistoryOptions as b0, type MetricsSnapshot as b1, type MetricsSummary as b2, type MutationResult as b3, type NamedArtifactWarning as b4, type NamedMutationDefinition as b5, type NamedMutationResult as b6, NamedMutationsApi as b7, NamedQueriesApi as b8, type NamedQueryBatchItem as b9, type PolicyInspectTraverseStart as bA, type PolicyInspectVectorProbe as bB, type QueryMetrics as bC, type QueryResult as bD, type QueryStats as bE, type ReferenceInfo as bF, type RelationshipEndpoint as bG, type RelationshipInfo as bH, type RenameColumnRequest as bI, type RenameTableRequest as bJ, type ReorderColumnsRequest as bK, ReplicationAdminApi as bL, type ReplicationMetrics as bM, type ResidencyConfig as bN, type ResultWarning as bO, RetryPolicy as bP, type RlsResolver as bQ, type RlsResolverRule as bR, type RlsResolverRuleInput as bS, type RlsResolversListResponse as bT, type SchemaAggregateColumn as bU, type SchemaChange as bV, type SchemaChangeType as bW, type SchemaColumnDefinition as bX, type SchemaDiffResult as bY, type SchemaDocument as bZ, type SchemaFilterCondition as b_, type NamedQueryBatchSlotResult as ba, type NamedQueryDefinition as bb, type NamedQueryExecuteOptions as bc, type NamedQueryParamConstraint as bd, type NamedQuerySubscribeOptions as be, NodeAdminApi as bf, type NodeLogEntry as bg, type NodeLogLevel as bh, type NodeLogStreamOptions as bi, type NodeLogsQuery as bj, type NodeLogsResponse as bk, type OpenWriteStreamOptions as bl, type PageCacheMetrics as bm, type PartitionFunction as bn, type PartitionGrant as bo, type PartitionGrantsListResponse as bp, type PartitioningMetrics as bq, type PendingJobListResponse as br, type PendingJobResponse as bs, type PerDatabaseLagEntry as bt, type PerDatabaseMetrics as bu, type PerDatabaseStatusEntry as bv, PolicyApi as bw, type PolicyInspectRequest as bx, type PolicyInspectResponse as by, type PolicyInspectTableResult as bz, type ReadinessResponse as c, type SchemaGroupByTerm as c0, type SchemaMaterializedQuery as c1, type SchemaMaterializedStorage as c2, type SchemaPartitionKeyEntry as c3, type SchemaRelationshipsResponse as c4, type SchemaSettings as c5, type SchemaSettingsDurability as c6, type SchemaTableDefinition as c7, type SchemaTableDurability as c8, type SchemaTablePolicy as c9, type TableSummaryForErd as cA, TablesApi as cB, type TestIdentity as cC, type TestIdentityDocument as cD, type TestIdentityGrant as cE, type TimeBucketFunction as cF, type TimeSeriesMetrics as cG, type TransactionMetrics as cH, type TypeGenerationOptions as cI, type UpdateOptions as cJ, type UpdateRlsResolverRequest as cK, type UpdateTableOptionsRequest as cL, type UpdateTablePolicyRequest as cM, type UserProfile as cN, type WalMetrics as cO, WhereGroupBuilder as cP, type WhereOperator as cQ, type WriteStream as cR, coerceColumnarValue as cS, columnarToRows as cT, compareOrdinal as cU, createAoudaClient as cV, maxToken as cW, type SchemaTableTransform as ca, type SeedApplyResult as cb, type SeedTableApplyResult as cc, ServerAdminApi as cd, type ServerAuthOptions as ce, type ServerMemoryResponse as cf, type ServerMetricsResponse as cg, type ServiceInfo as ch, type SimdMetrics as ci, type SingleDatabaseMetricsResponse as cj, type SortDirection as ck, type StorageMetrics as cl, type SubscribeOptions as cm, type Subscription as cn, type SubscriptionChangeEvent as co, type SubscriptionEvent as cp, type SubscriptionInfo as cq, type SubscriptionSnapshotEvent as cr, TIME_BUCKET_FUNCTIONS as cs, type TableCoverageEntry as ct, type TableNameFromSchema as cu, type TablePolicy as cv, TableQuery as cw, type TableSchema as cx, type TableSchemaResponse as cy, type TableSummary as cz, 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 BatchOperationInput as $, AoudaClient as A, type BulkLoadOptions as B, type CoverageResponse as C, type DetailedHealthResponse as D, type AdminMemoryPatch as E, type FailoverClusterResponse as F, type AggregateFunctionName as G, type HealthStatus as H, type AlterColumnRequest as I, type JoinClusterRequest as J, type AoudaClientOptions as K, type ListBackupsResponse as L, type AoudaDataType as M, type NodeInfoResponse as N, type AppAuthOptions as O, type PromoteClusterResponse as P, AuthClient as Q, type ReplicationStatusResponse as R, type StreamAckRowError as S, type Transport as T, type AuthResult as U, type AuthUserInfo as V, type AuthorizationMode as W, BackupAdminApi as X, type BackupMetrics as Y, type BackupSummary as Z, type BatchMutationResult as _, type BulkLoadJobHandle as a, type MergeConflict as a$, type BloomFilterMetrics as a0, type BranchInfo as a1, BranchesApi as a2, type BulkLoadForceAbortRequest as a3, type BulkLoadForceAbortResponse as a4, type BulkLoadListResponse as a5, type BulkLoadProgress as a6, type BulkLoadReplicaProgress as a7, type BulkLoadReplicaProgressDto as a8, type BulkLoadStatusResponse as a9, DatabasesApi as aA, type DeleteOptions as aB, type DiffSummary as aC, FILTER_OPERATORS as aD, type FilterOperator as aE, HealthAdminApi as aF, type IndexInfo as aG, type InsertOptions as aH, type InsertResult as aI, type IoMetrics as aJ, JobsApi as aK, type LatencyPercentiles as aL, MaterializedQueriesApi as aM, type MaterializedQueryDefinition as aN, type MaterializedQueryExecuteOptions as aO, type MaterializedQueryExecuteResult as aP, type MaterializedQueryMetrics as aQ, type MaterializedQueryRefreshOptions as aR, MaterializedQueryState as aS, type MaterializedQueryStateNumber as aT, type MaterializedQueryStatus as aU, MaterializedQueryType as aV, type MaterializedQueryTypeNumber as aW, type MemberInfo as aX, MemoryConsistencyTokenStore as aY, type MemoryMetrics as aZ, type MergeBranchOptions as a_, CircuitBreakerPolicy as aa, ClusterAdminApi as ab, type ClusterMemberEntry as ac, type ClusterThisNodeEntry as ad, type ColumnSchema as ae, type ColumnSummaryForErd as af, type ColumnarResponse as ag, type ComponentHealthEntry as ah, type ComputedColumnDef as ai, ConfigAdminApi as aj, type ConsistencyTokenStore as ak, type CreateBranchRequest as al, type CreateColumnRequest as am, type CreateDatabaseOptions as an, type CreatePartitionGrantRequest as ao, type CreateRlsResolverRequest as ap, type CreateTableRequest as aq, type DatabaseAuthInfo as ar, type DatabaseAuthKeys as as, type DatabaseCoverageEntry as at, type DatabaseInfo as au, type DatabaseMemoryMetrics as av, type DatabaseMemoryUsage as aw, type DatabaseMetricsDto as ax, type DatabaseOptionsInfo as ay, type DatabasePitrResult as az, type TopologyResponse as b, type SchemaChangeType as b$, type MergeExecutionResult as b0, type MergeResult as b1, MetricsAdminApi as b2, type MetricsHistory as b3, type MetricsHistoryOptions as b4, type MetricsSnapshot as b5, type MetricsSummary as b6, type MutationResult as b7, type NamedArtifactWarning as b8, type NamedMutationDefinition as b9, PolicyApi as bA, type PolicyInspectRequest as bB, type PolicyInspectResponse as bC, type PolicyInspectTableResult as bD, type PolicyInspectTraverseStart as bE, type PolicyInspectVectorProbe as bF, type QueryMetrics as bG, type QueryResult as bH, type QueryStats as bI, type ReferenceInfo as bJ, type RelationshipEndpoint as bK, type RelationshipInfo as bL, type RenameColumnRequest as bM, type RenameTableRequest as bN, type ReorderColumnsRequest as bO, ReplicationAdminApi as bP, type ReplicationMetrics as bQ, type ResidencyConfig as bR, type RestoreBackupRequest as bS, type ResultWarning as bT, RetryPolicy as bU, type RlsResolver as bV, type RlsResolverRule as bW, type RlsResolverRuleInput as bX, type RlsResolversListResponse as bY, type SchemaAggregateColumn as bZ, type SchemaChange as b_, type NamedMutationResult as ba, NamedMutationsApi as bb, NamedQueriesApi as bc, type NamedQueryBatchItem as bd, type NamedQueryBatchSlotResult as be, type NamedQueryDefinition as bf, type NamedQueryExecuteOptions as bg, type NamedQueryParamConstraint as bh, type NamedQuerySubscribeOptions as bi, NodeAdminApi as bj, type NodeLogEntry as bk, type NodeLogLevel as bl, type NodeLogStreamOptions as bm, type NodeLogsQuery as bn, type NodeLogsResponse as bo, type OpenWriteStreamOptions as bp, type PageCacheMetrics as bq, type PartitionFunction as br, type PartitionGrant as bs, type PartitionGrantsListResponse as bt, type PartitioningMetrics as bu, type PendingJobListResponse as bv, type PendingJobResponse as bw, type PerDatabaseLagEntry as bx, type PerDatabaseMetrics as by, type PerDatabaseStatusEntry as bz, type ReadinessResponse as c, compareOrdinal as c$, type SchemaColumnDefinition as c0, type SchemaComputedOutput as c1, type SchemaComputedOutputType as c2, type SchemaDiffResult as c3, type SchemaDocument as c4, type SchemaFilterCondition as c5, type SchemaFilterPredicate as c6, type SchemaGroupByTerm as c7, type SchemaMaterializedQuery as c8, type SchemaMaterializedStorage as c9, type TableCoverageEntry as cA, type TableNameFromSchema as cB, type TablePolicy as cC, TableQuery as cD, type TableSchema as cE, type TableSchemaResponse as cF, type TableSummary as cG, type TableSummaryForErd as cH, TablesApi as cI, type TestIdentity as cJ, type TestIdentityDocument as cK, type TestIdentityGrant as cL, type TimeBucketFunction as cM, type TimeSeriesMetrics as cN, type TransactionMetrics as cO, type TypeGenerationOptions as cP, type UpdateOptions as cQ, type UpdateRlsResolverRequest as cR, type UpdateTableOptionsRequest as cS, type UpdateTablePolicyRequest as cT, type UserProfile as cU, type WalMetrics as cV, WhereGroupBuilder as cW, type WhereOperator as cX, type WriteStream as cY, coerceColumnarValue as cZ, columnarToRows as c_, type SchemaPartitionKeyEntry as ca, type SchemaRelationshipsResponse as cb, type SchemaSettings as cc, type SchemaSettingsDurability as cd, type SchemaTableDefinition as ce, type SchemaTableDurability as cf, type SchemaTablePolicy as cg, type SchemaTableTransform as ch, type SeedApplyResult as ci, type SeedTableApplyResult as cj, ServerAdminApi as ck, type ServerAuthOptions as cl, type ServerMemoryResponse as cm, type ServerMetricsResponse as cn, type ServiceInfo as co, type SimdMetrics as cp, type SingleDatabaseMetricsResponse as cq, type SortDirection as cr, type StorageMetrics as cs, type SubscribeOptions as ct, type Subscription as cu, type SubscriptionChangeEvent as cv, type SubscriptionEvent as cw, type SubscriptionInfo as cx, type SubscriptionSnapshotEvent as cy, TIME_BUCKET_FUNCTIONS as cz, type TriggerBackupRequest as d, createAoudaClient as d0, maxToken as d1, 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 SchemaLike as m, type DefaultSchema as n, AGGREGATE_FUNCTIONS as o, AOUDA_DATA_TYPES as p, type AddColumnRequest as q, AdminApi as r, type AdminBackupConfig as s, type AdminBackupPatch as t, type AdminConfigPatchRequest as u, type AdminConfigResponse as v, type AdminConfigSchemaResponse as w, type AdminLoggingConfig as x, type AdminLoggingPatch as y, type AdminMemoryConfig as z };

package/dist/{client-CXfjcF61.d.ts → client-CeON_I6V.d.ts}

@@ -447,6 +447,15 @@ interface RequestOptions {
     /** Sent as X-Request-Id header when provided. */
     requestId?: string;
 }
+/**
+ * Per-row rejection detail on HTTP `rowErrors` and write-stream `ErrorMessage.errors`.
+ * Same three fields as C# `StreamAckRowError`.
+ */
+interface StreamAckRowError {
+    index: number;
+    code: string;
+    message: string;
+}
 /**
  * User-facing comparison operator for where clauses.
  * Mapped to wire protocol operators (eq, ne, gt, etc.) internally.
@@ -1118,6 +1127,27 @@ interface DatabaseInfo {
      * "application" databases are end-user auth stores browsable via the data explorer.
      */
     authDatabaseKind: "none" | "server" | "application";
+    /**
+     * Non-secret auth linkage. Distinct from `authDatabaseKind`:
+     * `authDatabaseKind` says whether *this* database is an auth store;
+     * `auth.enabled` / `auth.database` say whether this data database is linked to one.
+     * GET/list never include `keys` (`mk_*` is create/regenerate only).
+     * Absent on servers older than this field (treat as unknown, not unlinked).
+     */
+    auth?: DatabaseAuthInfo;
+}
+/** App auth keys shown once at create/regenerate. Never re-emitted on GET. */
+interface DatabaseAuthKeys {
+    anonKey: string;
+    serviceRoleKey: string;
+    publicKey?: string;
+}
+/** Non-secret auth linkage on list/get/create. */
+interface DatabaseAuthInfo {
+    enabled: boolean;
+    database: string | null;
+    /** Present only on create or key regeneration. */
+    keys?: DatabaseAuthKeys;
 }
 /**
  * Options when creating a database (camelCase, matches server request).
@@ -1936,11 +1966,26 @@ interface BackupSummary {
     newFileCount: number;
     /** Database names included in this backup run. Present on server >= 0.0.x. */
     databases?: string[];
+    /** True when every contributing manifest recorded a non-zero WAL position (ADR 0044 D-2). */
+    pitrEligible?: boolean;
 }
 interface ListBackupsResponse {
     backups: BackupSummary[];
     warning?: string | null;
 }
+interface RestoreBackupRequest {
+    backupId?: string | null;
+    targetTime?: string | null;
+}
+interface DatabasePitrResult {
+    database: string;
+    replayed: boolean;
+    transactionsReplayed: number;
+    rowsReplayed: number;
+    lastAppliedCommitUtc?: string | null;
+    stoppedAtTarget: boolean;
+    error?: string | null;
+}
 interface RestoreBackupResponse {
     backupId: string;
     restoredUtc: string;
@@ -1948,6 +1993,8 @@ interface RestoreBackupResponse {
     bytesDownloaded: number;
     integrityVerified: boolean;
     durationSeconds: number;
+    targetTime?: string | null;
+    pitr?: DatabasePitrResult[] | null;
 }
 interface BackupSchedule {
     cronExpression?: string | null;
@@ -1974,10 +2021,11 @@ declare class BackupAdminApi {
      */
     list(): Promise<ListBackupsResponse>;
     /**
-     * Restore a backup by id.
-     * POST /admin/backup/restore/{id}
+     * Restore a backup. The string form is an exact restore of that id
+     * (`POST /admin/backup/restore/{id}` with `{}`). The object form posts the body to
+     * `POST /admin/backup/restore` and may carry `targetTime` for point-in-time recovery.
      */
-    restore(backupId: string): Promise<RestoreBackupResponse>;
+    restore(input: string | RestoreBackupRequest): Promise<RestoreBackupResponse>;
     /**
      * Get backup schedule.
      * GET /admin/backup/schedule
@@ -2514,8 +2562,9 @@ declare class AuthClient {
 
 /**
  * Wire protocol message types for Aouda real-time streaming (ADR 0020 §4).
- * No imports — pure type definitions.
+ * Type-only import of StreamAckRowError is allowed; no runtime imports.
  */
+
 type StreamingWireMode = "json" | "msgpack";
 interface AuthMessage {
     type: "auth";
@@ -2642,6 +2691,7 @@ interface ServerErrorMessage {
     id?: string;
     code: string;
     message: string;
+    errors?: StreamAckRowError[];
 }
 interface PongMessage {
     type: "pong";
@@ -2982,6 +3032,12 @@ declare class TableQuery<T = Record<string, unknown>> {
      * evaluated per row on the server. Computed columns are appended after any physical-column
      * `select()` projection.
      *
+     * Result types are inferred by the server where the expression permits
+     * (e.g. Int32 → `number`). Uninferable expressions use wire `"Unknown"` /
+     * codegen `unknown`. Computed columns are always nullable. Named-query
+     * `*Row` properties pick this up when regenerated against a post-S08 server.
+     * See aouda-docs/guides/browser-tier-read-limits.md#selectexpr-result-types
+     *
      * @param projections - One or more `{ alias, expr }` pairs.
      * @returns A new TableQuery with computed columns set.
      *
@@ -3445,8 +3501,10 @@ interface SchemaColumnDefinition {
     encoder?: string;
     default?: string;
     description?: string;
-    /** Write-time derived expression (stored, not virtual). */
-    derived?: ScalarExprNode;
+    /** Write-time derived expression, or `{ identity: "subject" }` (P43 stamp). */
+    derived?: ScalarExprNode | {
+        identity: string;
+    };
     unique?: boolean;
 }
 /** A single insert-time `route` or `tee` transform. */
@@ -3467,6 +3525,8 @@ interface SchemaTableDefinition {
     authMode?: string;
     permissionDimension?: string;
     rlsResolverName?: string;
+    /** jwt-claim PLS source: `subject` or `claim:<name>`. Omit = `claim:tenant_id`. */
+    plsClaimBinding?: string;
     culture?: string;
     checks?: Record<string, WhereClause>;
     transforms?: SchemaTableTransform[];
@@ -3553,6 +3613,20 @@ interface SchemaFilterPredicate {
 interface SchemaMaterializedStorage {
     storageTemperature?: string;
 }
+/**
+ * Closed sortable type set for aggregate MQ computed outputs
+ * (`ComputedOutputValidation.AllowedTypeNames` / JSON-schema `MaterializedComputedOutput`).
+ */
+type SchemaComputedOutputType = "Int64" | "Double" | "Decimal" | "String" | "Timestamp" | "Date";
+/**
+ * One computed public column of an aggregate materialized query (ADR 0040 `D-36`).
+ * Wire keys are `outputName` + `type` + `expr` — not query `selectExpr` `{ alias, expr }`.
+ */
+interface SchemaComputedOutput {
+    outputName: string;
+    type: SchemaComputedOutputType;
+    expr: ScalarExprNode;
+}
 /**
  * Materialized-query declaration in `materializedQueries`.
  * `groupBy` items are a column-name string or `{ column, function?, outputName? }`.
@@ -3568,6 +3642,16 @@ interface SchemaMaterializedQuery {
     predicate?: SchemaFilterPredicate;
     updateMode?: string;
     storage?: SchemaMaterializedStorage;
+    /**
+     * Direct-client access on the MQ result table. Defaults `false` at apply.
+     * Flipping this is `UpdateDataPlaneAccess`, not a replace.
+     */
+    dataPlaneAccess?: boolean;
+    /**
+     * Write-time public columns on an aggregate MQ. Aggregate-only at apply;
+     * other `type` values with `computed` set are a server `SchemaValidationException`, not a TS error.
+     */
+    computed?: SchemaComputedOutput[];
 }
 /** Root type for `aouda.schema.json`. */
 interface SchemaDocument {
@@ -4307,4 +4391,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 MetricsHistory 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, type FilterOperator as aA, HealthAdminApi as aB, type IndexInfo as aC, type InsertOptions as aD, type InsertResult as aE, type IoMetrics as aF, JobsApi as aG, type LatencyPercentiles as aH, MaterializedQueriesApi as aI, type MaterializedQueryDefinition as aJ, type MaterializedQueryExecuteOptions as aK, type MaterializedQueryExecuteResult as aL, type MaterializedQueryMetrics as aM, type MaterializedQueryRefreshOptions as aN, MaterializedQueryState as aO, type MaterializedQueryStateNumber as aP, type MaterializedQueryStatus as aQ, MaterializedQueryType as aR, type MaterializedQueryTypeNumber as aS, type MemberInfo as aT, MemoryConsistencyTokenStore as aU, type MemoryMetrics as aV, type MergeBranchOptions as aW, type MergeConflict as aX, type MergeExecutionResult as aY, type MergeResult as aZ, MetricsAdminApi 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 ConsistencyTokenStore as aj, type CreateBranchRequest as ak, type CreateColumnRequest as al, type CreateDatabaseOptions as am, type CreatePartitionGrantRequest as an, type CreateRlsResolverRequest as ao, type CreateTableRequest as ap, type DatabaseCoverageEntry as aq, type DatabaseInfo as ar, type DatabaseMemoryMetrics as as, type DatabaseMemoryUsage as at, type DatabaseMetricsDto as au, type DatabaseOptionsInfo as av, DatabasesApi as aw, type DeleteOptions as ax, type DiffSummary as ay, FILTER_OPERATORS as az, type TopologyResponse as b, type SchemaFilterPredicate as b$, type MetricsHistoryOptions as b0, type MetricsSnapshot as b1, type MetricsSummary as b2, type MutationResult as b3, type NamedArtifactWarning as b4, type NamedMutationDefinition as b5, type NamedMutationResult as b6, NamedMutationsApi as b7, NamedQueriesApi as b8, type NamedQueryBatchItem as b9, type PolicyInspectTraverseStart as bA, type PolicyInspectVectorProbe as bB, type QueryMetrics as bC, type QueryResult as bD, type QueryStats as bE, type ReferenceInfo as bF, type RelationshipEndpoint as bG, type RelationshipInfo as bH, type RenameColumnRequest as bI, type RenameTableRequest as bJ, type ReorderColumnsRequest as bK, ReplicationAdminApi as bL, type ReplicationMetrics as bM, type ResidencyConfig as bN, type ResultWarning as bO, RetryPolicy as bP, type RlsResolver as bQ, type RlsResolverRule as bR, type RlsResolverRuleInput as bS, type RlsResolversListResponse as bT, type SchemaAggregateColumn as bU, type SchemaChange as bV, type SchemaChangeType as bW, type SchemaColumnDefinition as bX, type SchemaDiffResult as bY, type SchemaDocument as bZ, type SchemaFilterCondition as b_, type NamedQueryBatchSlotResult as ba, type NamedQueryDefinition as bb, type NamedQueryExecuteOptions as bc, type NamedQueryParamConstraint as bd, type NamedQuerySubscribeOptions as be, NodeAdminApi as bf, type NodeLogEntry as bg, type NodeLogLevel as bh, type NodeLogStreamOptions as bi, type NodeLogsQuery as bj, type NodeLogsResponse as bk, type OpenWriteStreamOptions as bl, type PageCacheMetrics as bm, type PartitionFunction as bn, type PartitionGrant as bo, type PartitionGrantsListResponse as bp, type PartitioningMetrics as bq, type PendingJobListResponse as br, type PendingJobResponse as bs, type PerDatabaseLagEntry as bt, type PerDatabaseMetrics as bu, type PerDatabaseStatusEntry as bv, PolicyApi as bw, type PolicyInspectRequest as bx, type PolicyInspectResponse as by, type PolicyInspectTableResult as bz, type ReadinessResponse as c, type SchemaGroupByTerm as c0, type SchemaMaterializedQuery as c1, type SchemaMaterializedStorage as c2, type SchemaPartitionKeyEntry as c3, type SchemaRelationshipsResponse as c4, type SchemaSettings as c5, type SchemaSettingsDurability as c6, type SchemaTableDefinition as c7, type SchemaTableDurability as c8, type SchemaTablePolicy as c9, type TableSummaryForErd as cA, TablesApi as cB, type TestIdentity as cC, type TestIdentityDocument as cD, type TestIdentityGrant as cE, type TimeBucketFunction as cF, type TimeSeriesMetrics as cG, type TransactionMetrics as cH, type TypeGenerationOptions as cI, type UpdateOptions as cJ, type UpdateRlsResolverRequest as cK, type UpdateTableOptionsRequest as cL, type UpdateTablePolicyRequest as cM, type UserProfile as cN, type WalMetrics as cO, WhereGroupBuilder as cP, type WhereOperator as cQ, type WriteStream as cR, coerceColumnarValue as cS, columnarToRows as cT, compareOrdinal as cU, createAoudaClient as cV, maxToken as cW, type SchemaTableTransform as ca, type SeedApplyResult as cb, type SeedTableApplyResult as cc, ServerAdminApi as cd, type ServerAuthOptions as ce, type ServerMemoryResponse as cf, type ServerMetricsResponse as cg, type ServiceInfo as ch, type SimdMetrics as ci, type SingleDatabaseMetricsResponse as cj, type SortDirection as ck, type StorageMetrics as cl, type SubscribeOptions as cm, type Subscription as cn, type SubscriptionChangeEvent as co, type SubscriptionEvent as cp, type SubscriptionInfo as cq, type SubscriptionSnapshotEvent as cr, TIME_BUCKET_FUNCTIONS as cs, type TableCoverageEntry as ct, type TableNameFromSchema as cu, type TablePolicy as cv, TableQuery as cw, type TableSchema as cx, type TableSchemaResponse as cy, type TableSummary as cz, 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 BatchOperationInput as $, AoudaClient as A, type BulkLoadOptions as B, type CoverageResponse as C, type DetailedHealthResponse as D, type AdminMemoryPatch as E, type FailoverClusterResponse as F, type AggregateFunctionName as G, type HealthStatus as H, type AlterColumnRequest as I, type JoinClusterRequest as J, type AoudaClientOptions as K, type ListBackupsResponse as L, type AoudaDataType as M, type NodeInfoResponse as N, type AppAuthOptions as O, type PromoteClusterResponse as P, AuthClient as Q, type ReplicationStatusResponse as R, type StreamAckRowError as S, type Transport as T, type AuthResult as U, type AuthUserInfo as V, type AuthorizationMode as W, BackupAdminApi as X, type BackupMetrics as Y, type BackupSummary as Z, type BatchMutationResult as _, type BulkLoadJobHandle as a, type MergeConflict as a$, type BloomFilterMetrics as a0, type BranchInfo as a1, BranchesApi as a2, type BulkLoadForceAbortRequest as a3, type BulkLoadForceAbortResponse as a4, type BulkLoadListResponse as a5, type BulkLoadProgress as a6, type BulkLoadReplicaProgress as a7, type BulkLoadReplicaProgressDto as a8, type BulkLoadStatusResponse as a9, DatabasesApi as aA, type DeleteOptions as aB, type DiffSummary as aC, FILTER_OPERATORS as aD, type FilterOperator as aE, HealthAdminApi as aF, type IndexInfo as aG, type InsertOptions as aH, type InsertResult as aI, type IoMetrics as aJ, JobsApi as aK, type LatencyPercentiles as aL, MaterializedQueriesApi as aM, type MaterializedQueryDefinition as aN, type MaterializedQueryExecuteOptions as aO, type MaterializedQueryExecuteResult as aP, type MaterializedQueryMetrics as aQ, type MaterializedQueryRefreshOptions as aR, MaterializedQueryState as aS, type MaterializedQueryStateNumber as aT, type MaterializedQueryStatus as aU, MaterializedQueryType as aV, type MaterializedQueryTypeNumber as aW, type MemberInfo as aX, MemoryConsistencyTokenStore as aY, type MemoryMetrics as aZ, type MergeBranchOptions as a_, CircuitBreakerPolicy as aa, ClusterAdminApi as ab, type ClusterMemberEntry as ac, type ClusterThisNodeEntry as ad, type ColumnSchema as ae, type ColumnSummaryForErd as af, type ColumnarResponse as ag, type ComponentHealthEntry as ah, type ComputedColumnDef as ai, ConfigAdminApi as aj, type ConsistencyTokenStore as ak, type CreateBranchRequest as al, type CreateColumnRequest as am, type CreateDatabaseOptions as an, type CreatePartitionGrantRequest as ao, type CreateRlsResolverRequest as ap, type CreateTableRequest as aq, type DatabaseAuthInfo as ar, type DatabaseAuthKeys as as, type DatabaseCoverageEntry as at, type DatabaseInfo as au, type DatabaseMemoryMetrics as av, type DatabaseMemoryUsage as aw, type DatabaseMetricsDto as ax, type DatabaseOptionsInfo as ay, type DatabasePitrResult as az, type TopologyResponse as b, type SchemaChangeType as b$, type MergeExecutionResult as b0, type MergeResult as b1, MetricsAdminApi as b2, type MetricsHistory as b3, type MetricsHistoryOptions as b4, type MetricsSnapshot as b5, type MetricsSummary as b6, type MutationResult as b7, type NamedArtifactWarning as b8, type NamedMutationDefinition as b9, PolicyApi as bA, type PolicyInspectRequest as bB, type PolicyInspectResponse as bC, type PolicyInspectTableResult as bD, type PolicyInspectTraverseStart as bE, type PolicyInspectVectorProbe as bF, type QueryMetrics as bG, type QueryResult as bH, type QueryStats as bI, type ReferenceInfo as bJ, type RelationshipEndpoint as bK, type RelationshipInfo as bL, type RenameColumnRequest as bM, type RenameTableRequest as bN, type ReorderColumnsRequest as bO, ReplicationAdminApi as bP, type ReplicationMetrics as bQ, type ResidencyConfig as bR, type RestoreBackupRequest as bS, type ResultWarning as bT, RetryPolicy as bU, type RlsResolver as bV, type RlsResolverRule as bW, type RlsResolverRuleInput as bX, type RlsResolversListResponse as bY, type SchemaAggregateColumn as bZ, type SchemaChange as b_, type NamedMutationResult as ba, NamedMutationsApi as bb, NamedQueriesApi as bc, type NamedQueryBatchItem as bd, type NamedQueryBatchSlotResult as be, type NamedQueryDefinition as bf, type NamedQueryExecuteOptions as bg, type NamedQueryParamConstraint as bh, type NamedQuerySubscribeOptions as bi, NodeAdminApi as bj, type NodeLogEntry as bk, type NodeLogLevel as bl, type NodeLogStreamOptions as bm, type NodeLogsQuery as bn, type NodeLogsResponse as bo, type OpenWriteStreamOptions as bp, type PageCacheMetrics as bq, type PartitionFunction as br, type PartitionGrant as bs, type PartitionGrantsListResponse as bt, type PartitioningMetrics as bu, type PendingJobListResponse as bv, type PendingJobResponse as bw, type PerDatabaseLagEntry as bx, type PerDatabaseMetrics as by, type PerDatabaseStatusEntry as bz, type ReadinessResponse as c, compareOrdinal as c$, type SchemaColumnDefinition as c0, type SchemaComputedOutput as c1, type SchemaComputedOutputType as c2, type SchemaDiffResult as c3, type SchemaDocument as c4, type SchemaFilterCondition as c5, type SchemaFilterPredicate as c6, type SchemaGroupByTerm as c7, type SchemaMaterializedQuery as c8, type SchemaMaterializedStorage as c9, type TableCoverageEntry as cA, type TableNameFromSchema as cB, type TablePolicy as cC, TableQuery as cD, type TableSchema as cE, type TableSchemaResponse as cF, type TableSummary as cG, type TableSummaryForErd as cH, TablesApi as cI, type TestIdentity as cJ, type TestIdentityDocument as cK, type TestIdentityGrant as cL, type TimeBucketFunction as cM, type TimeSeriesMetrics as cN, type TransactionMetrics as cO, type TypeGenerationOptions as cP, type UpdateOptions as cQ, type UpdateRlsResolverRequest as cR, type UpdateTableOptionsRequest as cS, type UpdateTablePolicyRequest as cT, type UserProfile as cU, type WalMetrics as cV, WhereGroupBuilder as cW, type WhereOperator as cX, type WriteStream as cY, coerceColumnarValue as cZ, columnarToRows as c_, type SchemaPartitionKeyEntry as ca, type SchemaRelationshipsResponse as cb, type SchemaSettings as cc, type SchemaSettingsDurability as cd, type SchemaTableDefinition as ce, type SchemaTableDurability as cf, type SchemaTablePolicy as cg, type SchemaTableTransform as ch, type SeedApplyResult as ci, type SeedTableApplyResult as cj, ServerAdminApi as ck, type ServerAuthOptions as cl, type ServerMemoryResponse as cm, type ServerMetricsResponse as cn, type ServiceInfo as co, type SimdMetrics as cp, type SingleDatabaseMetricsResponse as cq, type SortDirection as cr, type StorageMetrics as cs, type SubscribeOptions as ct, type Subscription as cu, type SubscriptionChangeEvent as cv, type SubscriptionEvent as cw, type SubscriptionInfo as cx, type SubscriptionSnapshotEvent as cy, TIME_BUCKET_FUNCTIONS as cz, type TriggerBackupRequest as d, createAoudaClient as d0, maxToken as d1, 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 SchemaLike as m, type DefaultSchema as n, AGGREGATE_FUNCTIONS as o, AOUDA_DATA_TYPES as p, type AddColumnRequest as q, AdminApi as r, type AdminBackupConfig as s, type AdminBackupPatch as t, type AdminConfigPatchRequest as u, type AdminConfigResponse as v, type AdminConfigSchemaResponse as w, type AdminLoggingConfig as x, type AdminLoggingPatch as y, type AdminMemoryConfig as z };

package/dist/index.cjs

@@ -90,7 +90,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.15",
+  version: "0.1.17",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -200,9 +200,10 @@ var AoudaError = class extends Error {
   }
 };
 var AoudaConnectionError = class extends AoudaError {
-  constructor(message, cause) {
+  constructor(message, cause, rowErrors) {
     super(message);
     this.cause = cause;
+    this.rowErrors = rowErrors;
     this.name = "AoudaConnectionError";
   }
 };
@@ -222,7 +223,7 @@ var AoudaResponseError = class extends AoudaError {
   }
 };
 var AoudaApiError = class extends AoudaError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
     super(message);
     this.code = code;
     this.statusCode = statusCode;
@@ -230,36 +231,37 @@ var AoudaApiError = class extends AoudaError {
     this.requestId = requestId;
     this.retryAfterSeconds = retryAfterSeconds;
     this.token = token;
+    this.rowErrors = rowErrors;
     this.name = "AoudaApiError";
   }
 };
 var AoudaNotFoundError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaNotFoundError";
   }
 };
 var AoudaConflictError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaConflictError";
   }
 };
 var AoudaValidationError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaValidationError";
   }
 };
 var AoudaServerError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaServerError";
   }
 };
 var AoudaAuthenticationError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaAuthenticationError";
   }
 };
@@ -1212,6 +1214,10 @@ var ERROR_CODE_MAP = {
   INVALID_OPERATOR: AoudaValidationError,
   INVALID_COLUMN: AoudaValidationError,
   INVALID_VALUE: AoudaValidationError,
+  CONSTRAINT_CHECK_VIOLATION: AoudaValidationError,
+  TRANSFORM_DERIVED_READONLY: AoudaValidationError,
+  TRANSFORM_ROUTE_UNMATCHED: AoudaValidationError,
+  TRANSFORM_ROUTE_AMBIGUOUS: AoudaValidationError,
   UNSUPPORTED_VERSION: AoudaValidationError,
   MALFORMED_REQUEST: AoudaValidationError,
   INTERNAL_ERROR: AoudaServerError,
@@ -1272,6 +1278,9 @@ function parseRetryAfterSeconds(header) {
   if (!Number.isFinite(n) || n < 0) return void 0;
   return n;
 }
+function nonEmptyRowErrors(rowErrors) {
+  return Array.isArray(rowErrors) && rowErrors.length > 0 ? rowErrors : void 0;
+}
 function createApiError(statusCode, statusText, body, retryAfterHeader) {
   const message = body.error ?? `${statusCode} ${statusText}`;
   const code = body.code ?? "UNKNOWN";
@@ -1279,7 +1288,16 @@ function createApiError(statusCode, statusText, body, retryAfterHeader) {
   const requestId = body.requestId;
   const retryAfterSeconds = parseRetryAfterSeconds(retryAfterHeader ?? null);
   const Ctor = ERROR_CODE_MAP[code] ?? AoudaApiError;
-  return new Ctor(message, code, statusCode, details, requestId, retryAfterSeconds, body.token);
+  return new Ctor(
+    message,
+    code,
+    statusCode,
+    details,
+    requestId,
+    retryAfterSeconds,
+    body.token,
+    nonEmptyRowErrors(body.rowErrors)
+  );
 }
 var HttpTransport = class {
   constructor(options) {
@@ -1393,7 +1411,8 @@ var HttpTransport = class {
             errorBody?.details,
             errorBody?.requestId,
             void 0,
-            errorBody?.token
+            errorBody?.token,
+            nonEmptyRowErrors(errorBody?.rowErrors)
           );
         }
         if (errorBody?.code != null) {
@@ -1512,7 +1531,8 @@ var HttpTransport = class {
           errorBody?.details,
           errorBody?.requestId,
           void 0,
-          errorBody?.token
+          errorBody?.token,
+          nonEmptyRowErrors(errorBody?.rowErrors)
         );
       }
       if (errorBody?.code != null) {
@@ -2602,8 +2622,11 @@ var TableWriteStream = class {
     resolve?.();
   }
   _handleServerError(message) {
+    const rowErrors = Array.isArray(message.errors) && message.errors.length > 0 ? message.errors : void 0;
     const error = new AoudaConnectionError(
-      `Write stream error (${message.code}): ${message.message}`
+      `Write stream error (${message.code}): ${message.message}`,
+      void 0,
+      rowErrors
     );
     const openReject = this._openReject;
     this._openResolve = null;
@@ -3055,6 +3078,12 @@ var TableQuery = class _TableQuery {
    * evaluated per row on the server. Computed columns are appended after any physical-column
    * `select()` projection.
    *
+   * Result types are inferred by the server where the expression permits
+   * (e.g. Int32 → `number`). Uninferable expressions use wire `"Unknown"` /
+   * codegen `unknown`. Computed columns are always nullable. Named-query
+   * `*Row` properties pick this up when regenerated against a post-S08 server.
+   * See aouda-docs/guides/browser-tier-read-limits.md#selectexpr-result-types
+   *
    * @param projections - One or more `{ alias, expr }` pairs.
    * @returns A new TableQuery with computed columns set.
    *
@@ -4627,14 +4656,21 @@ var BackupAdminApi = class {
     return this.transport.get(`${BASE_PATH4}/list`);
   }
   /**
-   * Restore a backup by id.
-   * POST /admin/backup/restore/{id}
+   * Restore a backup. The string form is an exact restore of that id
+   * (`POST /admin/backup/restore/{id}` with `{}`). The object form posts the body to
+   * `POST /admin/backup/restore` and may carry `targetTime` for point-in-time recovery.
    */
-  async restore(backupId) {
-    const encoded = encodeURIComponent(backupId);
+  async restore(input) {
+    if (typeof input === "string") {
+      const encoded = encodeURIComponent(input);
+      return this.transport.post(
+        `${BASE_PATH4}/restore/${encoded}`,
+        {}
+      );
+    }
     return this.transport.post(
-      `${BASE_PATH4}/restore/${encoded}`,
-      {}
+      `${BASE_PATH4}/restore`,
+      input
     );
   }
   /**