@aouda/client 0.1.11 → 0.1.12

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

@@ -833,12 +833,29 @@ interface ConditionalScalarExpr {
     then: ScalarExprNode;
     else: ScalarExprNode;
 }
+/**
+ * Bind-time parameter hole. The named-query binder substitutes a literal before eval.
+ * @internal
+ */
+interface ParamScalarExpr {
+    type: "param";
+    name: string;
+}
+/**
+ * Closed allowlist function call. fn is lowercase and case-sensitive.
+ * @internal
+ */
+interface CallScalarExpr {
+    type: "call";
+    fn: string;
+    args: ScalarExprNode[];
+}
 /**
  * Discriminated union for scalar expression nodes in expression-based SET values.
  * Named ScalarExprNode (not SetExprNode) to allow reuse for future SELECT projections.
  * @internal
  */
-type ScalarExprNode = LiteralScalarExpr | ColRefScalarExpr | ArithmeticScalarExpr | CoalesceScalarExpr | ConditionalScalarExpr;
+type ScalarExprNode = LiteralScalarExpr | ColRefScalarExpr | ArithmeticScalarExpr | CoalesceScalarExpr | ConditionalScalarExpr | ParamScalarExpr | CallScalarExpr;
 /**
  * A single server-side computed column definition for SELECT projections.
  * Plain JSON object; the polymorphism lives in ScalarExprNode.
@@ -2435,7 +2452,7 @@ interface ConflateOptions {
 interface SubscribeMessage {
     type: "subscribe";
     id: string;
-    target: string;
+    target?: string;
     filter?: Record<string, unknown>;
     resume_from?: number;
     hash?: string;
@@ -2492,6 +2509,11 @@ interface SnapshotCompleteMessage {
     id: string;
     version: number;
     row_count: number;
+    warnings?: Array<{
+        code: string;
+        hash?: string;
+        sunsetAt?: string;
+    }>;
 }
 interface GapMessage {
     type: "gap";
@@ -3615,6 +3637,12 @@ declare class MaterializedQueriesApi {
 interface NamedQueryExecuteOptions {
     signal?: AbortSignal;
 }
+interface NamedQuerySubscribeOptions<T = Record<string, unknown>> {
+    onSnapshot?: (rows: T[], version: number) => void;
+    onChange?: (event: SubscriptionChangeEvent<T>) => void;
+    onError?: (error: Error) => void;
+    conflate?: ConflateOptions;
+}
 interface NamedQueryBatchItem {
     hash: string;
     args?: Record<string, unknown>;
@@ -3636,9 +3664,11 @@ declare class NamedQueriesApi {
     private readonly transport;
     private readonly database;
     private readonly onWarning;
-    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink);
+    private readonly getStreamingTransport;
+    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink, getStreamingTransport: () => StreamingTransport);
     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>[]>;
+    subscribe<T = Record<string, unknown>>(hash: string, args?: Record<string, unknown>, options?: NamedQuerySubscribeOptions<T>): Subscription<T>;
 }
 declare class NamedMutationsApi {
     private readonly transport;
@@ -3900,4 +3930,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 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 };
+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 SubscriptionEvent 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, type NamedQuerySubscribeOptions as b9, ReplicationAdminApi as bA, type ReplicationMetrics as bB, type ResidencyConfig as bC, type ResultWarning as bD, RetryPolicy as bE, type RlsResolver as bF, type RlsResolverRule as bG, type RlsResolverRuleInput as bH, type RlsResolversListResponse as bI, type SchemaChange as bJ, type SchemaChangeType as bK, type SchemaDiffResult as bL, type SchemaRelationshipsResponse as bM, type SeedApplyResult as bN, type SeedTableApplyResult as bO, ServerAdminApi as bP, type ServerAuthOptions as bQ, type ServerMemoryResponse as bR, type ServerMetricsResponse as bS, type ServiceInfo as bT, type SimdMetrics as bU, type SingleDatabaseMetricsResponse as bV, type SortDirection as bW, type StorageMetrics as bX, type SubscribeOptions as bY, type Subscription as bZ, type SubscriptionChangeEvent as b_, NodeAdminApi as ba, type NodeLogEntry as bb, type NodeLogLevel as bc, type NodeLogStreamOptions as bd, type NodeLogsQuery as be, type NodeLogsResponse as bf, type OpenWriteStreamOptions as bg, type PageCacheMetrics as bh, type PartitionFunction as bi, type PartitionGrant as bj, type PartitionGrantsListResponse as bk, type PartitioningMetrics as bl, type PendingJobListResponse as bm, type PendingJobResponse as bn, type PerDatabaseLagEntry as bo, type PerDatabaseMetrics as bp, type PerDatabaseStatusEntry as bq, type QueryMetrics as br, type QueryResult as bs, type QueryStats as bt, type ReferenceInfo as bu, type RelationshipEndpoint as bv, type RelationshipInfo as bw, type RenameColumnRequest as bx, type RenameTableRequest as by, type ReorderColumnsRequest as bz, type ReadinessResponse as c, type SubscriptionInfo as c0, type SubscriptionSnapshotEvent as c1, TIME_BUCKET_FUNCTIONS as c2, type TableCoverageEntry as c3, type TableNameFromSchema as c4, type TablePolicy as c5, TableQuery as c6, type TableSchema as c7, type TableSchemaResponse as c8, type TableSummary as c9, type TableSummaryForErd as ca, TablesApi as cb, type TimeBucketFunction as cc, type TimeSeriesMetrics as cd, type TransactionMetrics as ce, type TypeGenerationOptions as cf, type UpdateOptions as cg, type UpdateRlsResolverRequest as ch, type UpdateTableOptionsRequest as ci, type UpdateTablePolicyRequest as cj, type UserProfile as ck, type WalMetrics as cl, WhereGroupBuilder as cm, type WhereOperator as cn, type WriteStream as co, coerceColumnarValue as cp, columnarToRows as cq, createAoudaClient as cr, 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-CT3GdrvA.d.ts → client-Q83x0Mz9.d.ts}

@@ -833,12 +833,29 @@ interface ConditionalScalarExpr {
     then: ScalarExprNode;
     else: ScalarExprNode;
 }
+/**
+ * Bind-time parameter hole. The named-query binder substitutes a literal before eval.
+ * @internal
+ */
+interface ParamScalarExpr {
+    type: "param";
+    name: string;
+}
+/**
+ * Closed allowlist function call. fn is lowercase and case-sensitive.
+ * @internal
+ */
+interface CallScalarExpr {
+    type: "call";
+    fn: string;
+    args: ScalarExprNode[];
+}
 /**
  * Discriminated union for scalar expression nodes in expression-based SET values.
  * Named ScalarExprNode (not SetExprNode) to allow reuse for future SELECT projections.
  * @internal
  */
-type ScalarExprNode = LiteralScalarExpr | ColRefScalarExpr | ArithmeticScalarExpr | CoalesceScalarExpr | ConditionalScalarExpr;
+type ScalarExprNode = LiteralScalarExpr | ColRefScalarExpr | ArithmeticScalarExpr | CoalesceScalarExpr | ConditionalScalarExpr | ParamScalarExpr | CallScalarExpr;
 /**
  * A single server-side computed column definition for SELECT projections.
  * Plain JSON object; the polymorphism lives in ScalarExprNode.
@@ -2435,7 +2452,7 @@ interface ConflateOptions {
 interface SubscribeMessage {
     type: "subscribe";
     id: string;
-    target: string;
+    target?: string;
     filter?: Record<string, unknown>;
     resume_from?: number;
     hash?: string;
@@ -2492,6 +2509,11 @@ interface SnapshotCompleteMessage {
     id: string;
     version: number;
     row_count: number;
+    warnings?: Array<{
+        code: string;
+        hash?: string;
+        sunsetAt?: string;
+    }>;
 }
 interface GapMessage {
     type: "gap";
@@ -3615,6 +3637,12 @@ declare class MaterializedQueriesApi {
 interface NamedQueryExecuteOptions {
     signal?: AbortSignal;
 }
+interface NamedQuerySubscribeOptions<T = Record<string, unknown>> {
+    onSnapshot?: (rows: T[], version: number) => void;
+    onChange?: (event: SubscriptionChangeEvent<T>) => void;
+    onError?: (error: Error) => void;
+    conflate?: ConflateOptions;
+}
 interface NamedQueryBatchItem {
     hash: string;
     args?: Record<string, unknown>;
@@ -3636,9 +3664,11 @@ declare class NamedQueriesApi {
     private readonly transport;
     private readonly database;
     private readonly onWarning;
-    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink);
+    private readonly getStreamingTransport;
+    constructor(transport: Transport, database: string, onWarning: NamedArtifactWarningSink, getStreamingTransport: () => StreamingTransport);
     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>[]>;
+    subscribe<T = Record<string, unknown>>(hash: string, args?: Record<string, unknown>, options?: NamedQuerySubscribeOptions<T>): Subscription<T>;
 }
 declare class NamedMutationsApi {
     private readonly transport;
@@ -3900,4 +3930,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 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 };
+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 SubscriptionEvent 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, type NamedQuerySubscribeOptions as b9, ReplicationAdminApi as bA, type ReplicationMetrics as bB, type ResidencyConfig as bC, type ResultWarning as bD, RetryPolicy as bE, type RlsResolver as bF, type RlsResolverRule as bG, type RlsResolverRuleInput as bH, type RlsResolversListResponse as bI, type SchemaChange as bJ, type SchemaChangeType as bK, type SchemaDiffResult as bL, type SchemaRelationshipsResponse as bM, type SeedApplyResult as bN, type SeedTableApplyResult as bO, ServerAdminApi as bP, type ServerAuthOptions as bQ, type ServerMemoryResponse as bR, type ServerMetricsResponse as bS, type ServiceInfo as bT, type SimdMetrics as bU, type SingleDatabaseMetricsResponse as bV, type SortDirection as bW, type StorageMetrics as bX, type SubscribeOptions as bY, type Subscription as bZ, type SubscriptionChangeEvent as b_, NodeAdminApi as ba, type NodeLogEntry as bb, type NodeLogLevel as bc, type NodeLogStreamOptions as bd, type NodeLogsQuery as be, type NodeLogsResponse as bf, type OpenWriteStreamOptions as bg, type PageCacheMetrics as bh, type PartitionFunction as bi, type PartitionGrant as bj, type PartitionGrantsListResponse as bk, type PartitioningMetrics as bl, type PendingJobListResponse as bm, type PendingJobResponse as bn, type PerDatabaseLagEntry as bo, type PerDatabaseMetrics as bp, type PerDatabaseStatusEntry as bq, type QueryMetrics as br, type QueryResult as bs, type QueryStats as bt, type ReferenceInfo as bu, type RelationshipEndpoint as bv, type RelationshipInfo as bw, type RenameColumnRequest as bx, type RenameTableRequest as by, type ReorderColumnsRequest as bz, type ReadinessResponse as c, type SubscriptionInfo as c0, type SubscriptionSnapshotEvent as c1, TIME_BUCKET_FUNCTIONS as c2, type TableCoverageEntry as c3, type TableNameFromSchema as c4, type TablePolicy as c5, TableQuery as c6, type TableSchema as c7, type TableSchemaResponse as c8, type TableSummary as c9, type TableSummaryForErd as ca, TablesApi as cb, type TimeBucketFunction as cc, type TimeSeriesMetrics as cd, type TransactionMetrics as ce, type TypeGenerationOptions as cf, type UpdateOptions as cg, type UpdateRlsResolverRequest as ch, type UpdateTableOptionsRequest as ci, type UpdateTablePolicyRequest as cj, type UserProfile as ck, type WalMetrics as cl, WhereGroupBuilder as cm, type WhereOperator as cn, type WriteStream as co, coerceColumnarValue as cp, columnarToRows as cq, createAoudaClient as cr, 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/index.cjs

@@ -86,7 +86,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.11",
+  version: "0.1.12",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -2112,7 +2112,7 @@ var AsyncEventQueue = class {
   }
 };
 var TableSubscription = class {
-  constructor(transport, tableName, options = {}, baseFilter) {
+  constructor(transport, identity, options = {}, onWarnings) {
     this._queue = new AsyncEventQueue();
     this._active = true;
     this._started = false;
@@ -2122,11 +2122,11 @@ var TableSubscription = class {
     this._forceFreshSubscribe = false;
     this.id = createStreamingId("sub");
     this._transport = transport;
-    this._tableName = tableName;
-    this._baseFilter = baseFilter;
+    this._identity = identity;
     this._onSnapshot = options.onSnapshot;
     this._onChange = options.onChange;
     this._onError = options.onError;
+    this._onWarnings = onWarnings;
     this._conflate = options.conflate;
     this._reconnectHandlerKey = `${this.id}::reconnect`;
   }
@@ -2189,12 +2189,18 @@ var TableSubscription = class {
   async _sendSubscribe(resumeFrom) {
     const message = {
       type: "subscribe",
-      id: this.id,
-      target: this._tableName
+      id: this.id
     };
-    const filter = this._baseFilter;
-    if (filter !== void 0) {
-      message.filter = filter;
+    if (this._identity.kind === "named") {
+      message.hash = this._identity.hash;
+      if (this._identity.args !== void 0) {
+        message.args = this._identity.args;
+      }
+    } else {
+      message.target = this._identity.target;
+      if (this._identity.filter !== void 0) {
+        message.filter = this._identity.filter;
+      }
     }
     if (resumeFrom !== void 0) {
       message.resume_from = resumeFrom;
@@ -2233,6 +2239,9 @@ var TableSubscription = class {
   }
   _handleSnapshotComplete(message) {
     this._lastVersion = message.version;
+    if (message.warnings != null && message.warnings.length > 0) {
+      this._onWarnings?.(message.warnings);
+    }
     const rows = this._pendingSnapshotRows;
     this._pendingSnapshotRows = [];
     this._onSnapshot?.(rows, message.version);
@@ -2982,17 +2991,16 @@ var TableQuery = class _TableQuery {
     const whereClause = this.buildWhereClause();
     const queryFilter = buildSubscriptionFilter(whereClause);
     const mergedFilter = mergeFilterObjects(queryFilter, options.filter);
-    const subscription = new TableSubscription(
-      wsTransport,
-      this.tableName,
-      {
-        onSnapshot: options.onSnapshot,
-        onChange: options.onChange,
-        onError: options.onError,
-        conflate: options.conflate
-      },
-      mergedFilter
-    );
+    const subscription = new TableSubscription(wsTransport, {
+      kind: "table",
+      target: this.tableName,
+      filter: mergedFilter
+    }, {
+      onSnapshot: options.onSnapshot,
+      onChange: options.onChange,
+      onError: options.onError,
+      conflate: options.conflate
+    });
     subscription.start();
     return subscription;
   }
@@ -3578,10 +3586,84 @@ function serializeUpdateValue(col, val) {
       else: toNode(cond.else)
     };
   }
+  if ("$upper" in val) {
+    return { type: "call", fn: "upper", args: [unaryCallArg(col, val.$upper)] };
+  }
+  if ("$lower" in val) {
+    return { type: "call", fn: "lower", args: [unaryCallArg(col, val.$lower)] };
+  }
+  if ("$trim" in val) {
+    return { type: "call", fn: "trim", args: [unaryCallArg(col, val.$trim)] };
+  }
+  if ("$concat" in val) {
+    const parts = val.$concat;
+    return {
+      type: "call",
+      fn: "concat",
+      args: parts.map((p) => valueToExprNode(p))
+    };
+  }
+  if ("$substring" in val) {
+    const spec = val.$substring;
+    if (Array.isArray(spec)) {
+      return {
+        type: "call",
+        fn: "substring",
+        args: [{ type: "colRef", col }, ...spec.map((p) => valueToExprNode(p))]
+      };
+    }
+    return {
+      type: "call",
+      fn: "substring",
+      args: [{ type: "colRef", col }, { type: "literal", value: spec }]
+    };
+  }
+  if ("$round" in val) {
+    return {
+      type: "call",
+      fn: "round",
+      args: [
+        { type: "colRef", col },
+        { type: "literal", value: val.$round }
+      ]
+    };
+  }
+  if ("$roundTo" in val) {
+    return {
+      type: "call",
+      fn: "roundTo",
+      args: [
+        { type: "colRef", col },
+        { type: "literal", value: val.$roundTo }
+      ]
+    };
+  }
+  if ("$cast" in val) {
+    return {
+      type: "call",
+      fn: "cast",
+      args: [
+        { type: "colRef", col },
+        { type: "literal", value: val.$cast }
+      ]
+    };
+  }
   throw new Error(
     `Unknown expression operator in update() for column '${col}': ${JSON.stringify(val)}`
   );
 }
+function unaryCallArg(col, operand) {
+  if (operand === true || operand === 1) {
+    return { type: "colRef", col };
+  }
+  return valueToExprNode(operand);
+}
+function valueToExprNode(v) {
+  if (typeof v === "string" && v.startsWith("$")) {
+    return { type: "colRef", col: v.slice(1) };
+  }
+  return { type: "literal", value: v };
+}
 
 // src/tables.ts
 function validateNonEmptyString(value, name) {
@@ -4742,10 +4824,11 @@ function emptyStats() {
   };
 }
 var NamedQueriesApi = class {
-  constructor(transport, database, onWarning) {
+  constructor(transport, database, onWarning, getStreamingTransport) {
     this.transport = transport;
     this.database = database;
     this.onWarning = onWarning;
+    this.getStreamingTransport = getStreamingTransport;
   }
   async execute(hash, args, options) {
     if (typeof hash !== "string" || hash.trim().length === 0) {
@@ -4813,6 +4896,26 @@ var NamedQueriesApi = class {
       return { isError: false, result };
     });
   }
+  subscribe(hash, args, options = {}) {
+    if (typeof hash !== "string" || hash.trim().length === 0) {
+      throw new Error("Named query hash must be a non-empty string");
+    }
+    const subscription = new TableSubscription(
+      this.getStreamingTransport(),
+      { kind: "named", hash, args },
+      {
+        onSnapshot: options.onSnapshot,
+        onChange: options.onChange,
+        onError: options.onError,
+        conflate: options.conflate
+      },
+      (warnings) => {
+        raiseDeprecationWarnings(this.onWarning, warnings);
+      }
+    );
+    subscription.start();
+    return subscription;
+  }
 };
 var NamedMutationsApi = class {
   constructor(transport, database, onWarning) {
@@ -5636,7 +5739,8 @@ var AoudaClient = class {
     this._namedQueries = new NamedQueriesApi(
       this.transport,
       this.database,
-      onNamedArtifactWarning
+      onNamedArtifactWarning,
+      () => this._getOrCreateWebSocketTransport()
     );
     this._namedMutations = new NamedMutationsApi(
       this.transport,