@aouda/client 0.1.6 → 0.1.8

package/dist/{client-Bb6UxTA4.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.
@@ -756,6 +758,16 @@ interface BatchMutationResult {
     /** Server-side execution time in milliseconds. */
     executionMs: number;
 }
+/**
+ * Options for {@link TableQuery.insert} / {@link TableQuery.insertMany}.
+ */
+interface InsertOptions {
+    /**
+     * When true, store explicit autoIncrement values as-is (including 0).
+     * Equivalent to Bond `isAutoIncrementDisabled: true`.
+     */
+    identityInsert?: boolean;
+}
 /**
  * Literal (constant) value node.
  * @internal
@@ -914,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).
@@ -997,6 +1053,12 @@ interface BulkLoadOptions {
     onProgress?: (progress: BulkLoadProgress) => void;
     /** AbortSignal for cancellation. Issues :abort on the server before throwing. */
     signal?: AbortSignal;
+    /**
+     * When true, treat this bulk-load as identity-insert (Bond `isAutoIncrementDisabled: true`):
+     * every autoIncrement column must be present/non-null on every row; values (including `0`)
+     * are stored as-is; after successful commit the server advances the counter to max(inserted).
+     */
+    identityInsert?: boolean;
 }
 interface BulkLoadProgress {
     ivfAssignmentsCompleted: number;
@@ -1911,8 +1973,11 @@ declare class NodeAdminApi {
 type NotificationProviderSource = "db" | "env" | "none";
 /** Information about one configured notification provider (email or SMS). */
 interface NotificationProviderInfo {
-    /** Provider identifier, e.g. "sendgrid", "gatewayapi", "console", "none". */
-    provider: string;
+    /**
+     * Provider identifier, e.g. "sendgrid", "gatewayapi", "capture", "console",
+     * or null when no provider is active.
+     */
+    provider: string | null;
     /**
      * Where the provider config was loaded from.
      * "db" = persisted in _settings DB; "env" = appsettings/env var; "none" = no provider.
@@ -1952,6 +2017,11 @@ interface PutEmailProviderRequest {
     fromName?: string | null;
     inviteUrl?: string | null;
     passwordResetUrl?: string | null;
+    /**
+     * Required when provider is "capture" and the server is Production.
+     * Confirms OTPs will be visible to server admins via the outbox.
+     */
+    acknowledgeDevCapture?: boolean;
 }
 /** Request body for PUT /admin/notifications/sms. */
 interface PutSmsProviderRequest {
@@ -1960,6 +2030,11 @@ interface PutSmsProviderRequest {
     apiKey?: string | null;
     sender?: string | null;
     baseUrl?: string | null;
+    /**
+     * Required when provider is "capture" and the server is Production.
+     * Confirms OTPs will be visible to server admins via the outbox.
+     */
+    acknowledgeDevCapture?: boolean;
 }
 /** Request body for POST /admin/notifications/email/test. */
 interface TestEmailRequest {
@@ -1977,6 +2052,30 @@ interface TestSendResult {
     /** Error message if success is false. */
     error?: string | null;
 }
+/** Channel for a captured notification. */
+type NotificationOutboxChannel = "email" | "sms";
+/** Kind of captured auth notification. */
+type NotificationOutboxKind = "password_reset" | "invite" | "mfa_otp" | "test";
+/** One captured outbound auth notification from GET /admin/notifications/outbox. */
+interface NotificationOutboxEntry {
+    id: string;
+    channel: NotificationOutboxChannel | string;
+    kind: NotificationOutboxKind | string;
+    to: string;
+    subject: string | null;
+    body: string;
+    otp: string;
+    createdAtUtc: string;
+}
+/** Response from GET /admin/notifications/outbox. */
+interface NotificationOutboxResponse {
+    entries: NotificationOutboxEntry[];
+}
+/** Query options for GET /admin/notifications/outbox. */
+interface NotificationOutboxQuery {
+    channel?: NotificationOutboxChannel | string;
+    limit?: number;
+}
 
 /**
  * Admin notification provider settings API.
@@ -2021,6 +2120,17 @@ declare class NotificationsAdminApi {
      * POST /admin/notifications/sms/test
      */
     testSms(request: TestSmsRequest): Promise<TestSendResult>;
+    /**
+     * Get recent captured auth notifications (newest first).
+     * GET /admin/notifications/outbox?channel=&limit=
+     */
+    getOutbox(options?: NotificationOutboxQuery): Promise<NotificationOutboxResponse>;
+    /**
+     * Clear the in-memory notification outbox.
+     * DELETE /admin/notifications/outbox
+     */
+    clearOutbox(): Promise<NotificationOutboxResponse>;
+    private buildOutboxPath;
 }
 
 /**
@@ -2761,6 +2871,8 @@ declare class TableQuery<T = Record<string, unknown>> {
      * a Promise. It does not use query builder state (where, orderBy, etc.).
      *
      * @param row - The row data to insert. Keys are column names.
+     * @param row - The row object to insert. Keys are column names.
+     * @param options - Optional insert options (e.g. `identityInsert`).
      * @returns The insert result with row count, execution time, and optional generated values.
      * @throws Error if `row` is null or undefined.
      *
@@ -2771,9 +2883,12 @@ declare class TableQuery<T = Record<string, unknown>> {
      *
      * console.log(result.rowsInserted); // 1
      * console.log(result.generatedValues); // { "0": { id: 42 } }
+     *
+     * // Identity-insert (Bond isAutoIncrementDisabled: true): store explicit IDs including 0
+     * await client.table('orders').insert({ id: 1000, status: 'seeded' }, { identityInsert: true });
      * ```
      */
-    insert(row: Partial<T>): Promise<InsertResult>;
+    insert(row: Partial<T>, options?: InsertOptions): Promise<InsertResult>;
     /**
      * Inserts multiple rows into the table in a single request.
      *
@@ -2781,6 +2896,7 @@ declare class TableQuery<T = Record<string, unknown>> {
      * a Promise. It does not use query builder state (where, orderBy, etc.).
      *
      * @param rows - Array of row objects to insert. Must contain at least one row.
+     * @param options - Optional insert options (e.g. `identityInsert`).
      * @returns The insert result with total row count, execution time, and optional generated values.
      * @throws Error if `rows` is empty.
      *
@@ -2793,9 +2909,14 @@ declare class TableQuery<T = Record<string, unknown>> {
      *   ]);
      *
      * console.log(result.rowsInserted); // 2
+     *
+     * await client.table('orders').insertMany(
+     *   [{ id: 10 }, { id: 20 }],
+     *   { identityInsert: true },
+     * );
      * ```
      */
-    insertMany(rows: Partial<T>[]): Promise<InsertResult>;
+    insertMany(rows: Partial<T>[], options?: InsertOptions): Promise<InsertResult>;
     /**
      * Updates rows matching the current where predicates.
      *
@@ -2946,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.
@@ -3038,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[];
@@ -3045,7 +3188,7 @@ interface SchemaDiffResult {
     warnings?: SchemaChangeWarning[];
 }
 interface SchemaChange {
-    type: string;
+    type: SchemaChangeType | (string & {});
     tableName?: string | null;
     columnName?: string | null;
     isDestructive: boolean;
@@ -3080,7 +3223,7 @@ interface SchemaApplyResult {
     summary: ApplyResultSummary;
 }
 interface ApplyResultEntry {
-    changeType: string;
+    changeType: SchemaChangeType | (string & {});
     tableName?: string | null;
     columnName?: string | null;
     status: string;
@@ -3226,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`).
  */
@@ -3366,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;
@@ -3449,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.
@@ -3573,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, NodeAdminApi 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 InsertResult as aB, type IoMetrics as aC, type LatencyPercentiles as aD, MaterializedQueriesApi as aE, type MaterializedQueryDefinition as aF, type MaterializedQueryExecuteOptions as aG, type MaterializedQueryExecuteResult as aH, type MaterializedQueryMetrics as aI, type MaterializedQueryRefreshOptions as aJ, MaterializedQueryState as aK, type MaterializedQueryStateNumber as aL, type MaterializedQueryStatus as aM, MaterializedQueryType as aN, type MaterializedQueryTypeNumber as aO, type MemberInfo as aP, type MemoryMetrics as aQ, type MergeBranchOptions as aR, type MergeConflict as aS, type MergeExecutionResult as aT, type MergeResult as aU, MetricsAdminApi as aV, type MetricsHistory as aW, type MetricsHistoryOptions as aX, type MetricsSnapshot as aY, type MetricsSummary as aZ, type MutationResult 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 TypeGenerationOptions as b$, type NodeLogEntry as b0, type NodeLogLevel as b1, type NodeLogStreamOptions as b2, type NodeLogsQuery as b3, type NodeLogsResponse as b4, type OpenWriteStreamOptions as b5, type PageCacheMetrics as b6, type PartitionFunction as b7, type PartitionGrant as b8, type PartitionGrantsListResponse as b9, type ServerAuthOptions as bA, type ServerMemoryResponse as bB, type ServerMetricsResponse as bC, type ServiceInfo as bD, type SimdMetrics as bE, type SingleDatabaseMetricsResponse as bF, type SortDirection as bG, type StorageMetrics as bH, type SubscribeOptions as bI, type Subscription as bJ, type SubscriptionChangeEvent as bK, type SubscriptionEvent as bL, type SubscriptionInfo as bM, type SubscriptionSnapshotEvent as bN, TIME_BUCKET_FUNCTIONS as bO, type TableCoverageEntry as bP, type TableNameFromSchema as bQ, type TablePolicy as bR, TableQuery as bS, type TableSchema as bT, type TableSchemaResponse as bU, type TableSummary as bV, type TableSummaryForErd as bW, TablesApi as bX, type TimeBucketFunction as bY, type TimeSeriesMetrics as bZ, type TransactionMetrics as b_, type PartitioningMetrics as ba, type PerDatabaseLagEntry as bb, type PerDatabaseMetrics as bc, type PerDatabaseStatusEntry as bd, type QueryMetrics as be, type QueryResult as bf, type QueryStats as bg, type ReferenceInfo as bh, type RelationshipEndpoint as bi, type RelationshipInfo as bj, type RenameColumnRequest as bk, type RenameTableRequest as bl, ReplicationAdminApi as bm, type ReplicationMetrics as bn, type ResidencyConfig as bo, RetryPolicy as bp, type RlsResolver as bq, type RlsResolverRule as br, type RlsResolverRuleInput as bs, type RlsResolversListResponse as bt, type SchemaChange as bu, type SchemaDiffResult as bv, type SchemaRelationshipsResponse as bw, type SeedApplyResult as bx, type SeedTableApplyResult as by, ServerAdminApi as bz, type ReadinessResponse as c, type UpdateOptions as c0, type UpdateRlsResolverRequest as c1, type UpdateTableOptionsRequest as c2, type UpdateTablePolicyRequest as c3, type UserProfile as c4, WhereGroupBuilder as c5, type WhereOperator as c6, type WriteStream as c7, coerceColumnarValue as c8, createAoudaClient as c9, 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.6",
+  version: "0.1.8",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -1119,7 +1120,8 @@ var BulkLoadCoordinator = class {
         pkUniquenessOverride: options.pkUniquenessOverride,
         replicationMode: options.replicationMode,
         forceSingleNodeReplicationBypass: options.forceSingleNodeReplicationBypass,
-        postLoadMqBehavior: options.postLoadMqBehavior
+        postLoadMqBehavior: options.postLoadMqBehavior,
+        ...options.identityInsert === true ? { identityInsert: true } : {}
       }
     };
     const beginResp = await this.transport.post(
@@ -3129,6 +3131,8 @@ var TableQuery = class _TableQuery {
    * a Promise. It does not use query builder state (where, orderBy, etc.).
    *
    * @param row - The row data to insert. Keys are column names.
+   * @param row - The row object to insert. Keys are column names.
+   * @param options - Optional insert options (e.g. `identityInsert`).
    * @returns The insert result with row count, execution time, and optional generated values.
    * @throws Error if `row` is null or undefined.
    *
@@ -3139,9 +3143,12 @@ var TableQuery = class _TableQuery {
    *
    * console.log(result.rowsInserted); // 1
    * console.log(result.generatedValues); // { "0": { id: 42 } }
+   *
+   * // Identity-insert (Bond isAutoIncrementDisabled: true): store explicit IDs including 0
+   * await client.table('orders').insert({ id: 1000, status: 'seeded' }, { identityInsert: true });
    * ```
    */
-  async insert(row) {
+  async insert(row, options) {
     if (row == null) {
       throw new Error("insert() requires a non-null row object");
     }
@@ -3151,6 +3158,9 @@ var TableQuery = class _TableQuery {
       database: this.database,
       rows: [row]
     };
+    if (options?.identityInsert === true) {
+      body.identityInsert = true;
+    }
     const response = await this.transport.post(path, body);
     const result = {
       rowsInserted: response.rowsInserted,
@@ -3168,6 +3178,7 @@ var TableQuery = class _TableQuery {
    * a Promise. It does not use query builder state (where, orderBy, etc.).
    *
    * @param rows - Array of row objects to insert. Must contain at least one row.
+   * @param options - Optional insert options (e.g. `identityInsert`).
    * @returns The insert result with total row count, execution time, and optional generated values.
    * @throws Error if `rows` is empty.
    *
@@ -3180,9 +3191,14 @@ var TableQuery = class _TableQuery {
    *   ]);
    *
    * console.log(result.rowsInserted); // 2
+   *
+   * await client.table('orders').insertMany(
+   *   [{ id: 10 }, { id: 20 }],
+   *   { identityInsert: true },
+   * );
    * ```
    */
-  async insertMany(rows) {
+  async insertMany(rows, options) {
     if (!Array.isArray(rows) || rows.length === 0) {
       throw new Error("insertMany() requires a non-empty array of rows");
     }
@@ -3192,6 +3208,9 @@ var TableQuery = class _TableQuery {
       database: this.database,
       rows
     };
+    if (options?.identityInsert === true) {
+      body.identityInsert = true;
+    }
     const response = await this.transport.post(path, body);
     const result = {
       rowsInserted: response.rowsInserted,
@@ -3629,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
     );
   }
   /**
@@ -3885,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) {
@@ -4394,6 +4489,35 @@ var NotificationsAdminApi = class {
       request
     );
   }
+  /**
+   * Get recent captured auth notifications (newest first).
+   * GET /admin/notifications/outbox?channel=&limit=
+   */
+  async getOutbox(options) {
+    return this.transport.get(
+      this.buildOutboxPath(options)
+    );
+  }
+  /**
+   * Clear the in-memory notification outbox.
+   * DELETE /admin/notifications/outbox
+   */
+  async clearOutbox() {
+    return this.transport.delete(
+      `${BASE_PATH7}/outbox`
+    );
+  }
+  buildOutboxPath(options) {
+    const params = new URLSearchParams();
+    if (options?.channel !== void 0 && options.channel.trim().length > 0) {
+      params.set("channel", options.channel);
+    }
+    if (options?.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    const query = params.toString();
+    return query.length > 0 ? `${BASE_PATH7}/outbox?${query}` : `${BASE_PATH7}/outbox`;
+  }
 };
 
 // src/admin/index.ts
@@ -5164,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`);
   }
@@ -5179,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();
@@ -5262,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);
@@ -5355,7 +5480,7 @@ var AoudaClient = class {
    * ```
    */
   table(name) {
-    validateNonEmptyString2(name, "Table name");
+    validateNonEmptyString3(name, "Table name");
     return new TableQuery(
       this.transport,
       name,
@@ -5371,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.
@@ -5467,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,
@@ -5821,6 +5953,7 @@ var version = package_default.version;
   DatabasesApi,
   FILTER_OPERATORS,
   HealthAdminApi,
+  JobsApi,
   MaterializedQueriesApi,
   MaterializedQueryState,
   MaterializedQueryType,