@aouda/client 0.1.5 → 0.1.7

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

@@ -756,6 +756,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
@@ -997,6 +1007,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 +1927,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 +1971,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 +1984,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 +2006,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 +2074,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 +2825,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 +2837,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 +2850,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 +2863,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.
      *
@@ -3061,6 +3136,7 @@ interface DiffSummary {
     tablesDropped: number;
     columnsAdded: number;
     columnsDropped: number;
+    columnsAltered?: number;
     policiesUpdated: number;
     durabilitiesUpdated: number;
     settingsUpdated: number;
@@ -3572,4 +3648,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 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 };

package/dist/{client-CD9Ew5sO.d.ts → client-BbyXG5AL.d.ts}

@@ -756,6 +756,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
@@ -997,6 +1007,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 +1927,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 +1971,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 +1984,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 +2006,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 +2074,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 +2825,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 +2837,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 +2850,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 +2863,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.
      *
@@ -3061,6 +3136,7 @@ interface DiffSummary {
     tablesDropped: number;
     columnsAdded: number;
     columnsDropped: number;
+    columnsAltered?: number;
     policiesUpdated: number;
     durabilitiesUpdated: number;
     settingsUpdated: number;
@@ -3572,4 +3648,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 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 };

package/dist/index.cjs

@@ -82,7 +82,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.5",
+  version: "0.1.7",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -1119,7 +1119,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 +3130,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 +3142,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 +3157,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 +3177,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 +3190,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 +3207,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,
@@ -4394,6 +4412,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