@aouda/client 0.1.7 → 0.1.8

package/dist/{client-BbyXG5AL.d.cts → client-TIOp5NUu.d.cts}

@@ -566,6 +566,8 @@ interface ColumnSchema {
     clusterOrder?: number;
     /** Reference to another table's column (for relationship navigation). */
     reference?: ReferenceInfo;
+    /** Preferred encoder name when non-default (e.g. String_Dict). */
+    encoder?: string;
 }
 /**
  * Storage policy for a table.
@@ -924,11 +926,55 @@ interface AddColumnRequest {
     type: string;
 }
 /**
- * Request body for renaming a column (PATCH /api/databases/{db}/tables/{name}/columns/{columnName}).
+ * Request body for altering a column
+ * (PATCH /api/databases/{db}/tables/{name}/columns/{columnName}).
+ * Omit a property to leave it unchanged. For `references`, omit to leave unchanged;
+ * pass `""` or `null` to clear.
  */
-interface RenameColumnRequest {
+interface AlterColumnRequest {
+    database?: string;
+    newName?: string;
+    type?: string;
+    nullable?: boolean;
+    encoder?: string;
+    autoIncrement?: boolean;
+    references?: string | null;
+}
+/**
+ * @deprecated Use {@link AlterColumnRequest} with `newName`. Kept for rename-only callers.
+ */
+type RenameColumnRequest = Pick<AlterColumnRequest, "database" | "newName"> & {
     database: string;
     newName: string;
+};
+/**
+ * Request body for reordering columns
+ * (PUT /api/databases/{db}/tables/{name}/columns:order).
+ */
+interface ReorderColumnsRequest {
+    database?: string;
+    columns: string[];
+}
+/**
+ * Single pending-job projection (GET /api/databases/{db}/jobs).
+ */
+interface PendingJobResponse {
+    id: string;
+    type: string;
+    state: string;
+    createdAt: string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    error?: string | null;
+    /** Parsed params object when ParamsJson is JSON; otherwise a string. */
+    params?: unknown;
+}
+/**
+ * List response for GET /api/databases/{db}/jobs.
+ */
+interface PendingJobListResponse {
+    database: string;
+    jobs: PendingJobResponse[];
 }
 /**
  * Request body for updating a table's storage policy (PUT /api/databases/{db}/tables/{name}/policy).
@@ -3021,14 +3067,31 @@ declare class TablesApi {
      */
     addColumn(tableName: string, body: AddColumnRequest): Promise<ColumnSchema | undefined>;
     /**
-     * Renames a column.
+     * Alters a column (type, nullable, encoder, autoIncrement, references, and/or rename).
+     * PATCH /api/databases/{db}/tables/{t}/columns/{c}.
+     * Omit a property to leave it unchanged. For `references`, omit unchanged; `""` or `null` clears.
      * @param tableName - Table name.
      * @param columnName - Current column name.
-     * @param body - Request body (database, newName).
+     * @param body - Fields to change. `database` is injected from the client scope when omitted.
+     * @returns Updated column detail.
+     */
+    alterColumn(tableName: string, columnName: string, body: AlterColumnRequest): Promise<ColumnSchema | undefined>;
+    /**
+     * Renames a column (convenience wrapper over {@link alterColumn}).
+     * @param tableName - Table name.
+     * @param columnName - Current column name.
+     * @param body - Request body with newName (database optional; injected when omitted).
      * @returns 200 response body (column detail).
      * @throws AoudaNotFoundError if table or column does not exist; AoudaApiError for WRITE_NOT_ALLOWED, etc.
      */
-    renameColumn(tableName: string, columnName: string, body: RenameColumnRequest): Promise<ColumnSchema | undefined>;
+    renameColumn(tableName: string, columnName: string, body: RenameColumnRequest | AlterColumnRequest): Promise<ColumnSchema | undefined>;
+    /**
+     * Reorders columns in a table.
+     * PUT /api/databases/{db}/tables/{t}/columns:order (204 No Content).
+     * @param tableName - Table name.
+     * @param columnsOrBody - Ordered column names, or a request body with `columns`.
+     */
+    reorderColumns(tableName: string, columnsOrBody: string[] | ReorderColumnsRequest): Promise<void>;
     /**
      * Drops a column from a table.
      * @param tableName - Table name.
@@ -3113,6 +3176,11 @@ declare class DatabasesApi {
  * Uses server endpoints under /api/databases/{db}/schema.
  */
 
+/**
+ * Schema change classification (matches server `SchemaChangeType` enum names).
+ * Unknown future values may appear as plain strings at runtime.
+ */
+type SchemaChangeType = "CreateTable" | "DropTable" | "AddColumn" | "DropColumn" | "UpdatePolicy" | "UpdateDurability" | "UpdatePartitionLevelSecurity" | "UpdateAuthorizationOptions" | "UpdateTableCulture" | "UpdateSettings" | "UpdateColumnAutoIncrement" | "UpdateColumnType" | "UpdateColumnNullable" | "UpdateColumnEncoder" | "RenameColumn" | "ReorderColumns" | "UpdateColumnReferences" | "UpdateColumnDefault" | "UpdateColumnDescription" | "UpdateTablePrimaryKey";
 /** Server diff result (matches SchemaDiffResult). */
 interface SchemaDiffResult {
     changes: SchemaChange[];
@@ -3120,7 +3188,7 @@ interface SchemaDiffResult {
     warnings?: SchemaChangeWarning[];
 }
 interface SchemaChange {
-    type: string;
+    type: SchemaChangeType | (string & {});
     tableName?: string | null;
     columnName?: string | null;
     isDestructive: boolean;
@@ -3155,7 +3223,7 @@ interface SchemaApplyResult {
     summary: ApplyResultSummary;
 }
 interface ApplyResultEntry {
-    changeType: string;
+    changeType: SchemaChangeType | (string & {});
     tableName?: string | null;
     columnName?: string | null;
     status: string;
@@ -3301,6 +3369,31 @@ declare class BranchesApi {
     delete(name: string): Promise<void>;
 }
 
+/**
+ * Pending / background jobs API for @aouda/client.
+ * Projects GET /api/databases/{db}/jobs from the server.
+ */
+
+/**
+ * API for listing and inspecting server background jobs (e.g. ColumnRewrite).
+ * Access via `client.jobs`.
+ */
+declare class JobsApi {
+    private readonly transport;
+    private readonly database;
+    constructor(transport: Transport, database: string);
+    private get prefix();
+    /**
+     * Lists jobs whose params target this database.
+     */
+    list(): Promise<PendingJobListResponse>;
+    /**
+     * Gets a single job by id when it belongs to this database.
+     * @param jobId - Job GUID string.
+     */
+    get(jobId: string): Promise<PendingJobResponse>;
+}
+
 /**
  * Materialized query HTTP API (`/api/databases/{db}/materialized-queries`).
  */
@@ -3441,6 +3534,7 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
     private readonly database;
     private connected;
     private readonly _tables;
+    private readonly _jobs;
     private readonly _databases;
     private readonly _schema;
     private readonly _branches;
@@ -3524,6 +3618,11 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
      * @returns The tables API.
      */
     get tables(): TablesApi;
+    /**
+     * Access pending/background jobs for the current database (e.g. ColumnRewrite).
+     * @returns The jobs API.
+     */
+    get jobs(): JobsApi;
     /**
      * Access server-level database operations (list, create, get, drop).
      * @returns The databases API.
@@ -3648,4 +3747,4 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
  */
 declare function createAoudaClient<S extends SchemaLike = DefaultSchema>(options: AoudaClientOptions): AoudaClient<S>;
 
-export { type BranchInfo 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 AoudaClientOptions as G, type HealthStatus as H, type AoudaDataType as I, type JoinClusterRequest as J, type AppAuthOptions as K, type ListBackupsResponse as L, AuthClient as M, type NodeInfoResponse as N, type AuthResult as O, type PromoteClusterResponse as P, type AuthUserInfo as Q, type ReplicationStatusResponse as R, type SchemaLike as S, type Transport as T, type AuthorizationMode as U, BackupAdminApi as V, type BackupMetrics as W, type BackupSummary as X, type BatchMutationResult as Y, type BatchOperationInput as Z, type BloomFilterMetrics as _, type BulkLoadJobHandle as a, type MutationResult as a$, BranchesApi as a0, type BulkLoadForceAbortRequest as a1, type BulkLoadForceAbortResponse as a2, type BulkLoadListResponse as a3, type BulkLoadProgress as a4, type BulkLoadReplicaProgress as a5, type BulkLoadReplicaProgressDto as a6, type BulkLoadStatusResponse as a7, CircuitBreakerPolicy as a8, ClusterAdminApi as a9, type IndexInfo as aA, type InsertOptions as aB, type InsertResult as aC, type IoMetrics as aD, type LatencyPercentiles as aE, MaterializedQueriesApi as aF, type MaterializedQueryDefinition as aG, type MaterializedQueryExecuteOptions as aH, type MaterializedQueryExecuteResult as aI, type MaterializedQueryMetrics as aJ, type MaterializedQueryRefreshOptions as aK, MaterializedQueryState as aL, type MaterializedQueryStateNumber as aM, type MaterializedQueryStatus as aN, MaterializedQueryType as aO, type MaterializedQueryTypeNumber as aP, type MemberInfo as aQ, type MemoryMetrics as aR, type MergeBranchOptions as aS, type MergeConflict as aT, type MergeExecutionResult as aU, type MergeResult as aV, MetricsAdminApi as aW, type MetricsHistory as aX, type MetricsHistoryOptions as aY, type MetricsSnapshot as aZ, type MetricsSummary as a_, type ClusterMemberEntry as aa, type ClusterThisNodeEntry as ab, type ColumnSchema as ac, type ColumnSummaryForErd as ad, type ColumnarResponse as ae, type ComponentHealthEntry as af, type ComputedColumnDef as ag, ConfigAdminApi as ah, type CreateBranchRequest as ai, type CreateColumnRequest as aj, type CreateDatabaseOptions as ak, type CreatePartitionGrantRequest as al, type CreateRlsResolverRequest as am, type CreateTableRequest as an, type DatabaseCoverageEntry as ao, type DatabaseInfo as ap, type DatabaseMemoryMetrics as aq, type DatabaseMemoryUsage as ar, type DatabaseMetricsDto as as, type DatabaseOptionsInfo as at, DatabasesApi as au, type DeleteOptions as av, type DiffSummary as aw, FILTER_OPERATORS as ax, type FilterOperator as ay, HealthAdminApi as az, type TopologyResponse as b, type TransactionMetrics as b$, NodeAdminApi as b0, type NodeLogEntry as b1, type NodeLogLevel as b2, type NodeLogStreamOptions as b3, type NodeLogsQuery as b4, type NodeLogsResponse as b5, type OpenWriteStreamOptions as b6, type PageCacheMetrics as b7, type PartitionFunction as b8, type PartitionGrant as b9, ServerAdminApi as bA, type ServerAuthOptions as bB, type ServerMemoryResponse as bC, type ServerMetricsResponse as bD, type ServiceInfo as bE, type SimdMetrics as bF, type SingleDatabaseMetricsResponse as bG, type SortDirection as bH, type StorageMetrics as bI, type SubscribeOptions as bJ, type Subscription as bK, type SubscriptionChangeEvent as bL, type SubscriptionEvent as bM, type SubscriptionInfo as bN, type SubscriptionSnapshotEvent as bO, TIME_BUCKET_FUNCTIONS as bP, type TableCoverageEntry as bQ, type TableNameFromSchema as bR, type TablePolicy as bS, TableQuery as bT, type TableSchema as bU, type TableSchemaResponse as bV, type TableSummary as bW, type TableSummaryForErd as bX, TablesApi as bY, type TimeBucketFunction as bZ, type TimeSeriesMetrics as b_, type PartitionGrantsListResponse as ba, type PartitioningMetrics as bb, type PerDatabaseLagEntry as bc, type PerDatabaseMetrics as bd, type PerDatabaseStatusEntry as be, type QueryMetrics as bf, type QueryResult as bg, type QueryStats as bh, type ReferenceInfo as bi, type RelationshipEndpoint as bj, type RelationshipInfo as bk, type RenameColumnRequest as bl, type RenameTableRequest as bm, ReplicationAdminApi as bn, type ReplicationMetrics as bo, type ResidencyConfig as bp, RetryPolicy as bq, type RlsResolver as br, type RlsResolverRule as bs, type RlsResolverRuleInput as bt, type RlsResolversListResponse as bu, type SchemaChange as bv, type SchemaDiffResult as bw, type SchemaRelationshipsResponse as bx, type SeedApplyResult as by, type SeedTableApplyResult as bz, type ReadinessResponse as c, type TypeGenerationOptions as c0, type UpdateOptions as c1, type UpdateRlsResolverRequest as c2, type UpdateTableOptionsRequest as c3, type UpdateTablePolicyRequest as c4, type UserProfile as c5, WhereGroupBuilder as c6, type WhereOperator as c7, type WriteStream as c8, coerceColumnarValue as c9, createAoudaClient as ca, 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 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, WhereGroupBuilder as cc, type WhereOperator as cd, type WriteStream as ce, coerceColumnarValue as cf, createAoudaClient as cg, 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-BbyXG5AL.d.ts → client-TIOp5NUu.d.ts}

@@ -566,6 +566,8 @@ interface ColumnSchema {
     clusterOrder?: number;
     /** Reference to another table's column (for relationship navigation). */
     reference?: ReferenceInfo;
+    /** Preferred encoder name when non-default (e.g. String_Dict). */
+    encoder?: string;
 }
 /**
  * Storage policy for a table.
@@ -924,11 +926,55 @@ interface AddColumnRequest {
     type: string;
 }
 /**
- * Request body for renaming a column (PATCH /api/databases/{db}/tables/{name}/columns/{columnName}).
+ * Request body for altering a column
+ * (PATCH /api/databases/{db}/tables/{name}/columns/{columnName}).
+ * Omit a property to leave it unchanged. For `references`, omit to leave unchanged;
+ * pass `""` or `null` to clear.
  */
-interface RenameColumnRequest {
+interface AlterColumnRequest {
+    database?: string;
+    newName?: string;
+    type?: string;
+    nullable?: boolean;
+    encoder?: string;
+    autoIncrement?: boolean;
+    references?: string | null;
+}
+/**
+ * @deprecated Use {@link AlterColumnRequest} with `newName`. Kept for rename-only callers.
+ */
+type RenameColumnRequest = Pick<AlterColumnRequest, "database" | "newName"> & {
     database: string;
     newName: string;
+};
+/**
+ * Request body for reordering columns
+ * (PUT /api/databases/{db}/tables/{name}/columns:order).
+ */
+interface ReorderColumnsRequest {
+    database?: string;
+    columns: string[];
+}
+/**
+ * Single pending-job projection (GET /api/databases/{db}/jobs).
+ */
+interface PendingJobResponse {
+    id: string;
+    type: string;
+    state: string;
+    createdAt: string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    error?: string | null;
+    /** Parsed params object when ParamsJson is JSON; otherwise a string. */
+    params?: unknown;
+}
+/**
+ * List response for GET /api/databases/{db}/jobs.
+ */
+interface PendingJobListResponse {
+    database: string;
+    jobs: PendingJobResponse[];
 }
 /**
  * Request body for updating a table's storage policy (PUT /api/databases/{db}/tables/{name}/policy).
@@ -3021,14 +3067,31 @@ declare class TablesApi {
      */
     addColumn(tableName: string, body: AddColumnRequest): Promise<ColumnSchema | undefined>;
     /**
-     * Renames a column.
+     * Alters a column (type, nullable, encoder, autoIncrement, references, and/or rename).
+     * PATCH /api/databases/{db}/tables/{t}/columns/{c}.
+     * Omit a property to leave it unchanged. For `references`, omit unchanged; `""` or `null` clears.
      * @param tableName - Table name.
      * @param columnName - Current column name.
-     * @param body - Request body (database, newName).
+     * @param body - Fields to change. `database` is injected from the client scope when omitted.
+     * @returns Updated column detail.
+     */
+    alterColumn(tableName: string, columnName: string, body: AlterColumnRequest): Promise<ColumnSchema | undefined>;
+    /**
+     * Renames a column (convenience wrapper over {@link alterColumn}).
+     * @param tableName - Table name.
+     * @param columnName - Current column name.
+     * @param body - Request body with newName (database optional; injected when omitted).
      * @returns 200 response body (column detail).
      * @throws AoudaNotFoundError if table or column does not exist; AoudaApiError for WRITE_NOT_ALLOWED, etc.
      */
-    renameColumn(tableName: string, columnName: string, body: RenameColumnRequest): Promise<ColumnSchema | undefined>;
+    renameColumn(tableName: string, columnName: string, body: RenameColumnRequest | AlterColumnRequest): Promise<ColumnSchema | undefined>;
+    /**
+     * Reorders columns in a table.
+     * PUT /api/databases/{db}/tables/{t}/columns:order (204 No Content).
+     * @param tableName - Table name.
+     * @param columnsOrBody - Ordered column names, or a request body with `columns`.
+     */
+    reorderColumns(tableName: string, columnsOrBody: string[] | ReorderColumnsRequest): Promise<void>;
     /**
      * Drops a column from a table.
      * @param tableName - Table name.
@@ -3113,6 +3176,11 @@ declare class DatabasesApi {
  * Uses server endpoints under /api/databases/{db}/schema.
  */
 
+/**
+ * Schema change classification (matches server `SchemaChangeType` enum names).
+ * Unknown future values may appear as plain strings at runtime.
+ */
+type SchemaChangeType = "CreateTable" | "DropTable" | "AddColumn" | "DropColumn" | "UpdatePolicy" | "UpdateDurability" | "UpdatePartitionLevelSecurity" | "UpdateAuthorizationOptions" | "UpdateTableCulture" | "UpdateSettings" | "UpdateColumnAutoIncrement" | "UpdateColumnType" | "UpdateColumnNullable" | "UpdateColumnEncoder" | "RenameColumn" | "ReorderColumns" | "UpdateColumnReferences" | "UpdateColumnDefault" | "UpdateColumnDescription" | "UpdateTablePrimaryKey";
 /** Server diff result (matches SchemaDiffResult). */
 interface SchemaDiffResult {
     changes: SchemaChange[];
@@ -3120,7 +3188,7 @@ interface SchemaDiffResult {
     warnings?: SchemaChangeWarning[];
 }
 interface SchemaChange {
-    type: string;
+    type: SchemaChangeType | (string & {});
     tableName?: string | null;
     columnName?: string | null;
     isDestructive: boolean;
@@ -3155,7 +3223,7 @@ interface SchemaApplyResult {
     summary: ApplyResultSummary;
 }
 interface ApplyResultEntry {
-    changeType: string;
+    changeType: SchemaChangeType | (string & {});
     tableName?: string | null;
     columnName?: string | null;
     status: string;
@@ -3301,6 +3369,31 @@ declare class BranchesApi {
     delete(name: string): Promise<void>;
 }
 
+/**
+ * Pending / background jobs API for @aouda/client.
+ * Projects GET /api/databases/{db}/jobs from the server.
+ */
+
+/**
+ * API for listing and inspecting server background jobs (e.g. ColumnRewrite).
+ * Access via `client.jobs`.
+ */
+declare class JobsApi {
+    private readonly transport;
+    private readonly database;
+    constructor(transport: Transport, database: string);
+    private get prefix();
+    /**
+     * Lists jobs whose params target this database.
+     */
+    list(): Promise<PendingJobListResponse>;
+    /**
+     * Gets a single job by id when it belongs to this database.
+     * @param jobId - Job GUID string.
+     */
+    get(jobId: string): Promise<PendingJobResponse>;
+}
+
 /**
  * Materialized query HTTP API (`/api/databases/{db}/materialized-queries`).
  */
@@ -3441,6 +3534,7 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
     private readonly database;
     private connected;
     private readonly _tables;
+    private readonly _jobs;
     private readonly _databases;
     private readonly _schema;
     private readonly _branches;
@@ -3524,6 +3618,11 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
      * @returns The tables API.
      */
     get tables(): TablesApi;
+    /**
+     * Access pending/background jobs for the current database (e.g. ColumnRewrite).
+     * @returns The jobs API.
+     */
+    get jobs(): JobsApi;
     /**
      * Access server-level database operations (list, create, get, drop).
      * @returns The databases API.
@@ -3648,4 +3747,4 @@ declare class AoudaClient<S extends SchemaLike = DefaultSchema> {
  */
 declare function createAoudaClient<S extends SchemaLike = DefaultSchema>(options: AoudaClientOptions): AoudaClient<S>;
 
-export { type BranchInfo 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 AoudaClientOptions as G, type HealthStatus as H, type AoudaDataType as I, type JoinClusterRequest as J, type AppAuthOptions as K, type ListBackupsResponse as L, AuthClient as M, type NodeInfoResponse as N, type AuthResult as O, type PromoteClusterResponse as P, type AuthUserInfo as Q, type ReplicationStatusResponse as R, type SchemaLike as S, type Transport as T, type AuthorizationMode as U, BackupAdminApi as V, type BackupMetrics as W, type BackupSummary as X, type BatchMutationResult as Y, type BatchOperationInput as Z, type BloomFilterMetrics as _, type BulkLoadJobHandle as a, type MutationResult as a$, BranchesApi as a0, type BulkLoadForceAbortRequest as a1, type BulkLoadForceAbortResponse as a2, type BulkLoadListResponse as a3, type BulkLoadProgress as a4, type BulkLoadReplicaProgress as a5, type BulkLoadReplicaProgressDto as a6, type BulkLoadStatusResponse as a7, CircuitBreakerPolicy as a8, ClusterAdminApi as a9, type IndexInfo as aA, type InsertOptions as aB, type InsertResult as aC, type IoMetrics as aD, type LatencyPercentiles as aE, MaterializedQueriesApi as aF, type MaterializedQueryDefinition as aG, type MaterializedQueryExecuteOptions as aH, type MaterializedQueryExecuteResult as aI, type MaterializedQueryMetrics as aJ, type MaterializedQueryRefreshOptions as aK, MaterializedQueryState as aL, type MaterializedQueryStateNumber as aM, type MaterializedQueryStatus as aN, MaterializedQueryType as aO, type MaterializedQueryTypeNumber as aP, type MemberInfo as aQ, type MemoryMetrics as aR, type MergeBranchOptions as aS, type MergeConflict as aT, type MergeExecutionResult as aU, type MergeResult as aV, MetricsAdminApi as aW, type MetricsHistory as aX, type MetricsHistoryOptions as aY, type MetricsSnapshot as aZ, type MetricsSummary as a_, type ClusterMemberEntry as aa, type ClusterThisNodeEntry as ab, type ColumnSchema as ac, type ColumnSummaryForErd as ad, type ColumnarResponse as ae, type ComponentHealthEntry as af, type ComputedColumnDef as ag, ConfigAdminApi as ah, type CreateBranchRequest as ai, type CreateColumnRequest as aj, type CreateDatabaseOptions as ak, type CreatePartitionGrantRequest as al, type CreateRlsResolverRequest as am, type CreateTableRequest as an, type DatabaseCoverageEntry as ao, type DatabaseInfo as ap, type DatabaseMemoryMetrics as aq, type DatabaseMemoryUsage as ar, type DatabaseMetricsDto as as, type DatabaseOptionsInfo as at, DatabasesApi as au, type DeleteOptions as av, type DiffSummary as aw, FILTER_OPERATORS as ax, type FilterOperator as ay, HealthAdminApi as az, type TopologyResponse as b, type TransactionMetrics as b$, NodeAdminApi as b0, type NodeLogEntry as b1, type NodeLogLevel as b2, type NodeLogStreamOptions as b3, type NodeLogsQuery as b4, type NodeLogsResponse as b5, type OpenWriteStreamOptions as b6, type PageCacheMetrics as b7, type PartitionFunction as b8, type PartitionGrant as b9, ServerAdminApi as bA, type ServerAuthOptions as bB, type ServerMemoryResponse as bC, type ServerMetricsResponse as bD, type ServiceInfo as bE, type SimdMetrics as bF, type SingleDatabaseMetricsResponse as bG, type SortDirection as bH, type StorageMetrics as bI, type SubscribeOptions as bJ, type Subscription as bK, type SubscriptionChangeEvent as bL, type SubscriptionEvent as bM, type SubscriptionInfo as bN, type SubscriptionSnapshotEvent as bO, TIME_BUCKET_FUNCTIONS as bP, type TableCoverageEntry as bQ, type TableNameFromSchema as bR, type TablePolicy as bS, TableQuery as bT, type TableSchema as bU, type TableSchemaResponse as bV, type TableSummary as bW, type TableSummaryForErd as bX, TablesApi as bY, type TimeBucketFunction as bZ, type TimeSeriesMetrics as b_, type PartitionGrantsListResponse as ba, type PartitioningMetrics as bb, type PerDatabaseLagEntry as bc, type PerDatabaseMetrics as bd, type PerDatabaseStatusEntry as be, type QueryMetrics as bf, type QueryResult as bg, type QueryStats as bh, type ReferenceInfo as bi, type RelationshipEndpoint as bj, type RelationshipInfo as bk, type RenameColumnRequest as bl, type RenameTableRequest as bm, ReplicationAdminApi as bn, type ReplicationMetrics as bo, type ResidencyConfig as bp, RetryPolicy as bq, type RlsResolver as br, type RlsResolverRule as bs, type RlsResolverRuleInput as bt, type RlsResolversListResponse as bu, type SchemaChange as bv, type SchemaDiffResult as bw, type SchemaRelationshipsResponse as bx, type SeedApplyResult as by, type SeedTableApplyResult as bz, type ReadinessResponse as c, type TypeGenerationOptions as c0, type UpdateOptions as c1, type UpdateRlsResolverRequest as c2, type UpdateTableOptionsRequest as c3, type UpdateTablePolicyRequest as c4, type UserProfile as c5, WhereGroupBuilder as c6, type WhereOperator as c7, type WriteStream as c8, coerceColumnarValue as c9, createAoudaClient as ca, 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 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, WhereGroupBuilder as cc, type WhereOperator as cd, type WriteStream as ce, coerceColumnarValue as cf, createAoudaClient as cg, 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

@@ -56,6 +56,7 @@ __export(index_exports, {
   DatabasesApi: () => DatabasesApi,
   FILTER_OPERATORS: () => FILTER_OPERATORS,
   HealthAdminApi: () => HealthAdminApi,
+  JobsApi: () => JobsApi,
   MaterializedQueriesApi: () => MaterializedQueriesApi,
   MaterializedQueryState: () => MaterializedQueryState,
   MaterializedQueryType: () => MaterializedQueryType,
@@ -82,7 +83,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.7",
+  version: "0.1.8",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -3647,23 +3648,68 @@ var TablesApi = class {
     );
   }
   /**
-   * Renames a column.
+   * Alters a column (type, nullable, encoder, autoIncrement, references, and/or rename).
+   * PATCH /api/databases/{db}/tables/{t}/columns/{c}.
+   * Omit a property to leave it unchanged. For `references`, omit unchanged; `""` or `null` clears.
    * @param tableName - Table name.
    * @param columnName - Current column name.
-   * @param body - Request body (database, newName).
-   * @returns 200 response body (column detail).
-   * @throws AoudaNotFoundError if table or column does not exist; AoudaApiError for WRITE_NOT_ALLOWED, etc.
+   * @param body - Fields to change. `database` is injected from the client scope when omitted.
+   * @returns Updated column detail.
    */
-  async renameColumn(tableName, columnName, body) {
+  async alterColumn(tableName, columnName, body) {
     validateNonEmptyString(tableName, "Table name");
     validateNonEmptyString(columnName, "Column name");
-    validateNonEmptyString(body.newName, "New column name");
+    const hasField = body.newName !== void 0 || body.type !== void 0 || body.nullable !== void 0 || body.encoder !== void 0 || body.autoIncrement !== void 0 || body.references !== void 0;
+    if (!hasField) {
+      throw new Error(
+        "AlterColumnRequest must set at least one of: newName, type, nullable, encoder, autoIncrement, references"
+      );
+    }
     const prefix = databasePath2(this.database);
     const encodedTable = encodeURIComponent(tableName);
     const encodedColumn = encodeURIComponent(columnName);
+    const requestBody = {
+      database: this.database,
+      ...body
+    };
     return this.transport.patch(
       `${prefix}/tables/${encodedTable}/columns/${encodedColumn}`,
-      body
+      requestBody
+    );
+  }
+  /**
+   * Renames a column (convenience wrapper over {@link alterColumn}).
+   * @param tableName - Table name.
+   * @param columnName - Current column name.
+   * @param body - Request body with newName (database optional; injected when omitted).
+   * @returns 200 response body (column detail).
+   * @throws AoudaNotFoundError if table or column does not exist; AoudaApiError for WRITE_NOT_ALLOWED, etc.
+   */
+  async renameColumn(tableName, columnName, body) {
+    validateNonEmptyString(body.newName ?? "", "New column name");
+    return this.alterColumn(tableName, columnName, { newName: body.newName });
+  }
+  /**
+   * Reorders columns in a table.
+   * PUT /api/databases/{db}/tables/{t}/columns:order (204 No Content).
+   * @param tableName - Table name.
+   * @param columnsOrBody - Ordered column names, or a request body with `columns`.
+   */
+  async reorderColumns(tableName, columnsOrBody) {
+    validateNonEmptyString(tableName, "Table name");
+    const columns = Array.isArray(columnsOrBody) ? columnsOrBody : columnsOrBody.columns;
+    if (!columns?.length) {
+      throw new Error("columns array is required and must be non-empty");
+    }
+    const prefix = databasePath2(this.database);
+    const encodedTable = encodeURIComponent(tableName);
+    const requestBody = {
+      database: this.database,
+      columns
+    };
+    await this.transport.put(
+      `${prefix}/tables/${encodedTable}/columns:order`,
+      requestBody
     );
   }
   /**
@@ -3903,6 +3949,37 @@ var BranchesApi = class {
   }
 };
 
+// src/jobs.ts
+function validateNonEmptyString2(value, name) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${name} must be a non-empty string`);
+  }
+}
+var JobsApi = class {
+  constructor(transport, database) {
+    this.transport = transport;
+    this.database = database;
+  }
+  get prefix() {
+    return `${databasePath2(this.database)}/jobs`;
+  }
+  /**
+   * Lists jobs whose params target this database.
+   */
+  async list() {
+    return this.transport.get(this.prefix);
+  }
+  /**
+   * Gets a single job by id when it belongs to this database.
+   * @param jobId - Job GUID string.
+   */
+  async get(jobId) {
+    validateNonEmptyString2(jobId, "Job id");
+    const encoded = encodeURIComponent(jobId);
+    return this.transport.get(`${this.prefix}/${encoded}`);
+  }
+};
+
 // src/admin/server.ts
 var ServerAdminApi = class {
   constructor(transport) {
@@ -5211,7 +5288,7 @@ var DEFAULT_TIMEOUT_MS = 3e4;
 function normalizeBaseUrl(url) {
   return url.replace(/\/+$/, "");
 }
-function validateNonEmptyString2(value, name) {
+function validateNonEmptyString3(value, name) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(`${name} must be a non-empty string`);
   }
@@ -5226,8 +5303,8 @@ var AoudaClient = class {
   constructor(options) {
     this.connected = false;
     this._wsTransport = null;
-    validateNonEmptyString2(options.serverUrl, "serverUrl");
-    validateNonEmptyString2(options.database, "database");
+    validateNonEmptyString3(options.serverUrl, "serverUrl");
+    validateNonEmptyString3(options.database, "database");
     this.baseUrl = normalizeBaseUrl(options.serverUrl);
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
     this.database = options.database.trim();
@@ -5309,6 +5386,7 @@ var AoudaClient = class {
       this._authHandler = null;
     }
     this._tables = new TablesApi(this.transport, this.database);
+    this._jobs = new JobsApi(this.transport, this.database);
     this._databases = new DatabasesApi(this.transport);
     this._schema = new SchemaApi(this.transport, this.database);
     this._branches = new BranchesApi(this.transport, this.database);
@@ -5402,7 +5480,7 @@ var AoudaClient = class {
    * ```
    */
   table(name) {
-    validateNonEmptyString2(name, "Table name");
+    validateNonEmptyString3(name, "Table name");
     return new TableQuery(
       this.transport,
       name,
@@ -5418,6 +5496,13 @@ var AoudaClient = class {
   get tables() {
     return this._tables;
   }
+  /**
+   * Access pending/background jobs for the current database (e.g. ColumnRewrite).
+   * @returns The jobs API.
+   */
+  get jobs() {
+    return this._jobs;
+  }
   /**
    * Access server-level database operations (list, create, get, drop).
    * @returns The databases API.
@@ -5514,7 +5599,7 @@ var AoudaClient = class {
    * ```
    */
   bulkLoad(tableName, rows, options) {
-    validateNonEmptyString2(tableName, "tableName");
+    validateNonEmptyString3(tableName, "tableName");
     return new BulkLoadCoordinator(this.transport, this.database).run(
       [tableName],
       rows,
@@ -5868,6 +5953,7 @@ var version = package_default.version;
   DatabasesApi,
   FILTER_OPERATORS,
   HealthAdminApi,
+  JobsApi,
   MaterializedQueriesApi,
   MaterializedQueryState,
   MaterializedQueryType,