@mdbase-dev/connect 0.1.0-beta.31 → 0.1.0-beta.32

package/dist/hosted-file-request.js

@@ -1,5 +1,5 @@
 import { connectError } from "./errors.js";
-import { apiError } from "./runtime-utils.js";
+import { apiError, decodeJsonResponse } from "./runtime-utils.js";
 export async function sendHostedFileRequest(token, method, path, input, signal, proofHeaders) {
     if (!token.authority) {
         throw connectError("not_remote_authority", "This authorization has no remote authority endpoint.");
@@ -30,7 +30,7 @@ export async function performHostedFileRequest(token, method, path, input, signa
         }
         response = await sendHostedFileRequest(active, method, path, input, signal, proofHeaders);
     }
-    const body = await response.json().catch(() => ({}));
+    const body = await decodeJsonResponse(response, "invalid_operation_response", "The hosted authority returned an invalid file response.");
     if (!response.ok) {
         throw apiError(body, "operation_failed", "Collection file request failed.", response.status);
     }
@@ -47,7 +47,7 @@ export async function performHostedFilePartRequest(token, path, expectedLength,
         response = await sendHostedFileRequest(active, "GET", path, undefined, signal, proofHeaders);
     }
     if (!response.ok) {
-        const body = await response.json().catch(() => ({}));
+        const body = await decodeJsonResponse(response, "invalid_operation_response", "The hosted authority returned an invalid file range error response.");
         throw apiError(body, "operation_failed", "Collection file range request failed.", response.status);
     }
     const contentLength = response.headers.get("content-length");

package/dist/index.d.ts

@@ -1,9 +1,5 @@
-export { decryptRelayResponse, encryptRelayRequest, IndexedDbGrantKeyStore, MemoryGrantKeyStore, RelayCryptoError, type RelayBinding, type GrantKeyRecord, type GrantKeyStore } from "./crypto.js";
-export { FileTransferCryptoError, GrantFileTransferCipher, type FileTransferBinding } from "./file-crypto.js";
-export { ApplicationIdentityStoreError, IndexedDbApplicationIdentityStore, MemoryApplicationIdentityStore, applicationInstallationId, authorizationSigningMessage, signApplicationAuthorization, type ApplicationIdentity, type ApplicationIdentityStore } from "./application-identity.js";
 export * from "./authorization-types.js";
 export * from "./application-session.js";
-export * from "./collection-client.js";
 export * from "./connect-options.js";
 export * from "./mdbase-connect.js";
 export * from "./connection.js";
@@ -14,7 +10,8 @@ export * from "./files.js";
 export * from "./notifications.js";
 export * from "./outcomes.js";
 export * from "./operation-types.js";
+export * from "./external-store.js";
+export { type RequestBudget } from "./request-budget.js";
 export * from "./selection.js";
 export type { MdbaseUnavailableReason } from "./session.js";
-export { createPkce } from "./runtime-utils.js";
 export type { ApplicationProvisions, ApplicationCapabilityId, ApplicationCapabilityRequirements, ApplicationRequirements, ApplicationNotifications, ApplicationAuthorizationBinding, ApplicationAuthorizationProof, CollectionChange, CollectionChangesPage, CollectionContractDescriptor, CollectionDescription, CollectionFileMetadata, FileAction, CollectionOperation as MdbaseOperation, CollectionTypeDescriptor, CollectionTypeDocument, ConnectOperationOutcome, ConnectProblem, ConnectProblemCategory, ConnectProblemCode, ConnectProblemDetailsByCode, ConnectRecoveryAction, ContractRequirement, DataContractViewIdentity, GrantScope, JsonObject, MdbaseAppManifest, NotificationCriterion, MdbaseDiagnostic, MdbaseOperationEnvelope, KnownConnectProblem, RecordDocument, QueryRecord, SavedNamedView, SavedViewDocument, SavedViewExecution, SavedViewList, SavedViewPresentation, SavedViewProperty, SavedViewSource, SavedViewSourceDocument, ReadViewSourceInput, CreateViewSourceInput, UpdateViewSourceInput, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, TypePackManifest, TypePackManifestResource, TypePackApplyResult, TypePackAssessment, TypePackReceipt, AssessTypePackInput, ApplyTypePackInput, TypePackProvision, TypePackResourceDiff, TypePackSourceResource, UnknownConnectProblem } from "@mdbase-dev/connect-protocol";

package/dist/index.js

@@ -1,9 +1,5 @@
-export { decryptRelayResponse, encryptRelayRequest, IndexedDbGrantKeyStore, MemoryGrantKeyStore, RelayCryptoError } from "./crypto.js";
-export { FileTransferCryptoError, GrantFileTransferCipher } from "./file-crypto.js";
-export { ApplicationIdentityStoreError, IndexedDbApplicationIdentityStore, MemoryApplicationIdentityStore, applicationInstallationId, authorizationSigningMessage, signApplicationAuthorization } from "./application-identity.js";
 export * from "./authorization-types.js";
 export * from "./application-session.js";
-export * from "./collection-client.js";
 export * from "./connect-options.js";
 export * from "./mdbase-connect.js";
 export * from "./connection.js";
@@ -14,5 +10,5 @@ export * from "./files.js";
 export * from "./notifications.js";
 export * from "./outcomes.js";
 export * from "./operation-types.js";
+export * from "./external-store.js";
 export * from "./selection.js";
-export { createPkce } from "./runtime-utils.js";

package/dist/internal-types.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationNotifications, ApplicationRequirements, CollectionOperation, EncryptedRelayOperationRequest, GrantEncryption, FileCapability, GrantScope } from "@mdbase-dev/connect-protocol";
+import type { ApplicationNotifications, ApplicationRequirements, CollectionOperation, EncryptedRelayOperationRequest, GrantEncryption, FileCapability, GrantScope, MdbaseOperationRequest, MutationOperationIdentifier } from "@mdbase-dev/connect-protocol";
 import { encryptRelayRequest } from "./crypto.js";
 export interface Application {
     id: string;
@@ -58,10 +58,16 @@ export interface PendingMutation {
     collectionId: string;
     grantId?: string;
     keyId?: string;
+    keyHandle?: string;
+    applicationId?: string;
+    encryption?: GrantEncryption;
     operation: CollectionOperation;
+    mutation?: MutationOperationIdentifier;
     inputFingerprint: string;
     requestId: string;
     envelope?: EncryptedRelayOperationRequest;
+    /** Exact plaintext protocol request for transports that do not use a grant envelope. */
+    request?: MdbaseOperationRequest;
     createdAt: number;
 }
 export interface OperationAttempt {
@@ -70,6 +76,7 @@ export interface OperationAttempt {
     encryptedRequest?: Awaited<ReturnType<typeof encryptRelayRequest>>;
     directDeliveryUncertain?: boolean;
     pendingMutation?: boolean;
+    pendingMutationRecord?: PendingMutation;
     resumingMutation?: boolean;
 }
 export declare const DEFAULT_OPERATIONS: CollectionOperation[];

package/dist/local-file-transport.d.ts

@@ -5,8 +5,8 @@ interface LocalFileTransportOptions {
     keyStore: GrantKeyStore;
     serverUrl: string;
     loopbackUrl: string;
-    authorizedToken(): Promise<StoredToken | null>;
-    refreshAuthorization(): Promise<StoredToken>;
+    authorizedToken(signal?: AbortSignal): Promise<StoredToken | null>;
+    refreshAuthorization(signal?: AbortSignal): Promise<StoredToken>;
     shouldAttemptDirect(token: StoredToken): Promise<boolean>;
     onDirectAvailable(): void;
     onDirectUnavailable(): void;

package/dist/local-file-transport.js

@@ -3,7 +3,7 @@ import { decryptRelayResponse, encryptRelayRequest } from "./crypto.js";
 import { MdbaseConnectError, connectError, serverConnectError } from "./errors.js";
 import { GrantFileTransferCipher } from "./file-crypto.js";
 import { directFallbackStatus, loopbackRequest } from "./operation-helpers.js";
-import { apiError } from "./runtime-utils.js";
+import { apiError, decodeJsonResponse } from "./runtime-utils.js";
 /** Keeps grant-bound file crypto and loopback framing out of the operation transport. */
 export class LocalFileTransport {
     options;
@@ -39,7 +39,7 @@ export class LocalFileTransport {
         }
         response = await this.sendRelayControl(token, encryptedRequest, signal);
         if (await refreshableBindingFailure(response, token)) {
-            token = await this.options.refreshAuthorization();
+            token = await this.options.refreshAuthorization(signal);
             requireLocalFileToken(token);
             encryptedRequest = await this.encryptControl(token, controlInput);
             response = await this.sendRelayControl(token, encryptedRequest, signal);
@@ -49,7 +49,7 @@ export class LocalFileTransport {
         return this.decryptControlResponse(token, encryptedRequest, response);
     }
     async decryptControlResponse(token, encryptedRequest, response) {
-        const body = await response.json().catch(() => ({}));
+        const body = await decodeJsonResponse(response, "invalid_operation_response", "The collection authority returned an invalid file control response.");
         if (!response.ok) {
             throw apiError(body, "operation_failed", "Collection file request failed.", response.status);
         }
@@ -63,7 +63,7 @@ export class LocalFileTransport {
         return decrypted.result;
     }
     async uploadChunk(session, chunkIndex, bytes, signal) {
-        const token = await this.localFileToken(session, "upload");
+        const token = await this.localFileToken(session, "upload", signal);
         let deliveryToken = token;
         let encoded = await encryptedUploadChunk(this.options.keyStore, deliveryToken, session, chunkIndex, bytes);
         let response;
@@ -86,19 +86,19 @@ export class LocalFileTransport {
         }
         response = await this.sendRelayUpload(deliveryToken, encoded, signal);
         if (response.status === 401 && deliveryToken.refreshToken) {
-            deliveryToken = await this.options.refreshAuthorization();
+            deliveryToken = await this.options.refreshAuthorization(signal);
             requireLocalFileToken(deliveryToken);
             encoded = await encryptedUploadChunk(this.options.keyStore, deliveryToken, session, chunkIndex, bytes);
             response = await this.sendRelayUpload(deliveryToken, encoded, signal);
         }
         if (!response.ok) {
-            const body = await response.json().catch(() => ({}));
+            const body = await decodeJsonResponse(response, "invalid_operation_response", "The collection authority returned an invalid file upload response.");
             throw apiError(body, "operation_failed", "Encrypted file chunk upload failed.", response.status);
         }
         this.options.onRelayAvailable();
     }
     async downloadChunk(session, chunkIndex, signal) {
-        let token = await this.localFileToken(session, "download");
+        let token = await this.localFileToken(session, "download", signal);
         let response;
         if (await this.options.shouldAttemptDirect(token)) {
             try {
@@ -119,7 +119,7 @@ export class LocalFileTransport {
         }
         response = await this.sendRelayDownload(token, session, chunkIndex, signal);
         if (response.status === 401 && token.refreshToken) {
-            token = await this.options.refreshAuthorization();
+            token = await this.options.refreshAuthorization(signal);
             requireLocalFileToken(token);
             response = await this.sendRelayDownload(token, session, chunkIndex, signal);
         }
@@ -129,7 +129,7 @@ export class LocalFileTransport {
     }
     async decryptDownloadResponse(token, session, chunkIndex, response) {
         if (!response.ok) {
-            const body = await response.json().catch(() => ({}));
+            const body = await decodeJsonResponse(response, "invalid_operation_response", "The collection authority returned an invalid file download response.");
             throw apiError(body, "operation_failed", "Encrypted file chunk download failed.", response.status);
         }
         if (response.headers.get("content-type")?.split(";", 1)[0]
@@ -184,8 +184,8 @@ export class LocalFileTransport {
             signal
         });
     }
-    async localFileToken(session, direction) {
-        const token = await this.options.authorizedToken();
+    async localFileToken(session, direction, signal) {
+        const token = await this.options.authorizedToken(signal);
         if (!token || token.authority || !token.fileCapability || !token.encryption
             || !token.grantId || !token.keyHandle
             || session.direction !== direction
@@ -218,7 +218,7 @@ function fileUploadRequest(encoded, signal) {
 async function requireSuccessfulChunkResponse(response, message) {
     if (response.ok)
         return;
-    const body = await response.json().catch(() => ({}));
+    const body = await decodeJsonResponse(response, "invalid_operation_response", "The collection authority returned an invalid file transfer response.");
     throw apiError(body, "operation_failed", message, response.status);
 }
 async function refreshableBindingFailure(response, token) {
@@ -228,7 +228,7 @@ async function refreshableBindingFailure(response, token) {
         return true;
     if (response.status !== 409)
         return false;
-    const body = await response.clone().json().catch(() => null);
+    const body = await decodeJsonResponse(response.clone(), "invalid_operation_response", "The collection authority returned an invalid file response.").catch(() => null);
     return body?.error?.code === "encryption_binding_stale";
 }
 function requireEncryption(token) {

package/dist/mdbase-connect.d.ts

@@ -6,15 +6,17 @@ import { type AuthorizationProblemCode, type ConnectOutcome, type RegistrationPr
 import { MdbaseApplicationSession, type MdbaseApplicationSessionOptions } from "./application-session.js";
 import type { MdbaseUnavailableReason } from "./session.js";
 import type { Application } from "./internal-types.js";
+import type { ConnectRequestOptions } from "./operation-types.js";
 export declare class MdbaseConnect<Frontmatter extends JsonObject = JsonObject> {
     private readonly internals;
     constructor(options: MdbaseConnectOptions);
-    register(): Promise<ConnectOutcome<Application, RegistrationProblemCode>>;
+    register(options?: ConnectRequestOptions): Promise<ConnectOutcome<Application, RegistrationProblemCode>>;
     authorize(options?: MdbaseAuthorizeOptions): Promise<ConnectOutcome<MdbaseAuthorizationOutcome<Frontmatter>, AuthorizationProblemCode>>;
-    createApplicationSession(options: MdbaseApplicationSessionOptions): MdbaseApplicationSession<Frontmatter>;
-    manifest(): Promise<ConnectOutcome<import("@mdbase-dev/connect-protocol").MdbaseAppManifest, RegistrationProblemCode>>;
+    /** The ordinary application lifecycle entry point. */
+    application(options: MdbaseApplicationSessionOptions): MdbaseApplicationSession<Frontmatter>;
+    manifest(options?: ConnectRequestOptions): Promise<ConnectOutcome<import("@mdbase-dev/connect-protocol").MdbaseAppManifest, RegistrationProblemCode>>;
     environment(): MdbaseConnectEnvironment;
-    completeAuthorization(callbackUrl?: string): Promise<ConnectOutcome<MdbaseAuthorizationResult<Frontmatter>, AuthorizationProblemCode>>;
+    completeAuthorization(callbackUrl?: string | URL, options?: ConnectRequestOptions): Promise<ConnectOutcome<MdbaseAuthorizationResult<Frontmatter>, AuthorizationProblemCode>>;
     connections(): MdbaseConnectionInfo[];
     connection(collectionId: string): MdbaseConnection<Frontmatter> | null;
     unavailableReason(collectionId: string): MdbaseUnavailableReason | null;

package/dist/mdbase-connect.js

@@ -7,23 +7,24 @@ export class MdbaseConnect {
     constructor(options) {
         this.internals = new MdbaseConnectInternals(options);
     }
-    register() {
-        return captureConnectOutcome(() => this.internals.register(), REGISTRATION_PROBLEM_CODES);
+    register(options) {
+        return captureConnectOutcome(() => this.internals.register(options), REGISTRATION_PROBLEM_CODES);
     }
     authorize(options = {}) {
         return captureConnectOutcome(() => this.internals.authorize(options), AUTHORIZATION_PROBLEM_CODES);
     }
-    createApplicationSession(options) {
-        return new MdbaseApplicationSession(this, options);
+    /** The ordinary application lifecycle entry point. */
+    application(options) {
+        return new MdbaseApplicationSession(this, options, this.internals.timeouts);
     }
-    manifest() {
-        return captureConnectOutcome(() => this.internals.manifestDeclaration(), REGISTRATION_PROBLEM_CODES);
+    manifest(options) {
+        return captureConnectOutcome(() => this.internals.manifestDeclaration(options), REGISTRATION_PROBLEM_CODES);
     }
     environment() {
         return this.internals.environment();
     }
-    completeAuthorization(callbackUrl) {
-        return captureConnectOutcome(() => this.internals.completeAuthorization(callbackUrl ?? defaultCallbackUrl()), AUTHORIZATION_PROBLEM_CODES);
+    completeAuthorization(callbackUrl, options) {
+        return captureConnectOutcome(() => this.internals.completeAuthorization(callbackUrl === undefined ? defaultCallbackUrl() : String(callbackUrl), options), AUTHORIZATION_PROBLEM_CODES);
     }
     connections() {
         return this.internals.connections();

package/dist/notifications.d.ts

@@ -1,4 +1,5 @@
-export interface MdbaseNotificationRegistrationOptions {
+import type { ConnectRequestOptions } from "./operation-types.js";
+export interface MdbaseNotificationRegistrationOptions extends ConnectRequestOptions {
     serviceWorker: ServiceWorkerRegistration;
     /** Manifest criterion IDs to enable. Omit to enable every declared criterion. */
     criteria?: string[];
@@ -10,7 +11,7 @@ export interface MdbaseNotificationRegistration {
     installationId: string;
     criteria: string[];
 }
-export interface MdbaseNativeNotificationRegistrationOptions {
+export interface MdbaseNativeNotificationRegistrationOptions extends ConnectRequestOptions {
     /** Current FCM registration token. Refresh by calling this method again. */
     token: string;
     /** Manifest criterion IDs to enable. Omit to enable every declared criterion. */

package/dist/operation-helpers.d.ts

@@ -1,4 +1,4 @@
-import type { CollectionOperation } from "@mdbase-dev/connect-protocol";
+import { type CollectionOperation } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnectError } from "./errors.js";
 import type { StoredToken } from "./internal-types.js";
 import type { DeleteInput, DeletePreflightResult, MutationEstimate, RenameInput, RenamePreflightResult } from "./operation-types.js";
@@ -12,7 +12,7 @@ export declare function isMutation(operation: CollectionOperation, input?: unkno
 export declare function uniqueOperations(operations: CollectionOperation[]): CollectionOperation[];
 export declare function sameAuthorization(left: StoredToken, right: StoredToken): boolean;
 export declare function throwIfCancelled(signal?: AbortSignal): void;
-export declare function operationTransportError(error: unknown, signal: AbortSignal | undefined, outcomeUnknown: boolean, unavailableCode: "hosted_provider_unavailable" | "relay_unavailable"): Error;
+export declare function operationTransportError(error: unknown, signal: AbortSignal | undefined, pendingRequestId: string | undefined, unavailableCode: "hosted_provider_unavailable" | "relay_unavailable"): Error;
 export declare function isCancellation(error: unknown, signal?: AbortSignal): boolean;
 export declare function assertRenamePreview(input: RenameInput, preview: RenamePreflightResult): void;
 export declare function assertDeletePreview(input: DeleteInput, preview: DeletePreflightResult): void;
@@ -21,4 +21,4 @@ export declare function deleteEstimate(preview: DeletePreflightResult): Mutation
 export declare function operationFingerprint(operation: CollectionOperation, input: unknown): Promise<string>;
 export declare function canonicalJson(value: unknown): string;
 export declare function sortJson(value: unknown): unknown;
-export declare function unknownMutationOutcome(cause: unknown): MdbaseConnectError;
+export declare function unknownMutationOutcome(requestId: string, cause: unknown): MdbaseConnectError;

package/dist/operation-helpers.js

@@ -1,5 +1,5 @@
+import { isMutatingOperation, mutationFingerprint } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnectError, connectError } from "./errors.js";
-import { bytesToBase64Url } from "./base64.js";
 export function loopbackRequest(init) {
     return { ...init, credentials: "omit", targetAddressSpace: "loopback" };
 }
@@ -20,24 +20,7 @@ export function directFallbackStatus(status) {
     return status === 404 || status === 405 || status === 426 || status >= 500;
 }
 export function isMutation(operation, input) {
-    if (input && typeof input === "object" && !Array.isArray(input)
-        && input.dry_run === true)
-        return false;
-    return (operation === "sync"
-        && input !== null
-        && typeof input === "object"
-        && !Array.isArray(input)
-        && input.action === "mutate")
-        || operation === "create"
-        || operation === "update"
-        || operation === "delete"
-        || operation === "rename"
-        || operation === "create_type"
-        || operation === "update_type"
-        || operation === "apply_type_pack"
-        || operation === "put_timer"
-        || operation === "cancel_timer"
-        || operation === "reconcile_timers";
+    return isMutatingOperation(operation, input);
 }
 export function uniqueOperations(operations) {
     return [...new Set(operations)];
@@ -55,19 +38,21 @@ export function throwIfCancelled(signal) {
         return;
     throw connectError("operation_cancelled", "The operation was cancelled before it changed the collection.", { operationOutcome: "not_sent", cause: signal.reason });
 }
-export function operationTransportError(error, signal, outcomeUnknown, unavailableCode) {
+export function operationTransportError(error, signal, pendingRequestId, unavailableCode) {
     // Problems raised before transport dispatch already describe the
     // authoritative outcome. Do not overwrite them merely because an older
     // pending mutation also exists in storage.
     if (error instanceof MdbaseConnectError)
         return error;
     if (signal?.aborted) {
-        if (outcomeUnknown)
-            return unknownMutationOutcome(error);
+        if (pendingRequestId)
+            return unknownMutationOutcome(pendingRequestId, error);
+        if (signal.reason instanceof MdbaseConnectError)
+            return signal.reason;
         return connectError("operation_cancelled", "The operation was cancelled before it changed the collection.", { operationOutcome: "not_sent", cause: error });
     }
-    if (outcomeUnknown) {
-        return unknownMutationOutcome(error);
+    if (pendingRequestId) {
+        return unknownMutationOutcome(pendingRequestId, error);
     }
     if (error instanceof TypeError) {
         return connectError(unavailableCode, unavailableCode === "hosted_provider_unavailable"
@@ -110,9 +95,7 @@ export function deleteEstimate(preview) {
     };
 }
 export async function operationFingerprint(operation, input) {
-    const encoded = new TextEncoder().encode(`${operation}\0${canonicalJson(input ?? {})}`);
-    const digest = await crypto.subtle.digest("SHA-256", encoded);
-    return bytesToBase64Url(new Uint8Array(digest));
+    return mutationFingerprint(operation, input ?? {});
 }
 export function canonicalJson(value) {
     return JSON.stringify(sortJson(value));
@@ -128,6 +111,6 @@ export function sortJson(value) {
     }
     return value;
 }
-export function unknownMutationOutcome(cause) {
-    return connectError("operation_outcome_unknown", "The write may have completed, but mdbase could not recover its authoritative result. Retry the exact same write to recover safely.", { operationOutcome: "unknown", cause });
+export function unknownMutationOutcome(requestId, cause) {
+    return connectError("operation_outcome_unknown", "The write may have completed, but mdbase could not recover its authoritative result. Retry the exact same write to recover safely.", { operationOutcome: "unknown", details: { request_id: requestId }, cause });
 }

package/dist/operation-types.d.ts

@@ -1,4 +1,4 @@
-import type { CollectionOperation, ConnectProblem, JsonObject, QueryRecord, RecordDocument } from "@mdbase-dev/connect-protocol";
+import type { CollectionChange, CollectionOperation, ConnectProblem, JsonObject, MutationOperationIdentifier, QueryRecord, RecordDocument } from "@mdbase-dev/connect-protocol";
 export interface MdbaseDesiredTimer {
     /** Stable within the timer namespace. */
     id: string;
@@ -67,6 +67,7 @@ export interface QueryPagesOptions<Record extends JsonObject = JsonObject> {
     firstPageSize?: number;
     pageSize?: number;
     signal?: AbortSignal;
+    timeoutMs?: number | null;
     onProgress?: (page: QueryPage<Record>) => void;
 }
 export interface QueryPage<Record extends JsonObject = JsonObject> {
@@ -78,8 +79,10 @@ export interface QueryPage<Record extends JsonObject = JsonObject> {
     complete: boolean;
     snapshot?: string;
 }
-export interface OperationRequestOptions {
+export interface ConnectRequestOptions {
     signal?: AbortSignal;
+    /** Relative request budget. `null` deliberately disables the SDK default. */
+    timeoutMs?: number | null;
 }
 export interface MutationEstimate {
     /** Records whose links may be affected, excluding the record being mutated. */
@@ -98,8 +101,7 @@ export interface MutationProgress {
     completedUnits: number;
     estimate?: MutationEstimate;
 }
-export interface MutationProgressOptions {
-    signal?: AbortSignal;
+export interface MutationProgressOptions extends ConnectRequestOptions {
     onProgress?: (progress: MutationProgress) => void;
 }
 export interface RenameProgressOptions extends MutationProgressOptions {
@@ -111,9 +113,14 @@ export interface DeleteProgressOptions extends MutationProgressOptions {
     preflight?: DeletePreflightResult;
 }
 export interface PendingMutationSummary {
-    operation: CollectionOperation;
-    createdAt: number;
-    resumable: true;
+    requestId: string;
+    operation: MutationOperationIdentifier;
+    fingerprint: string;
+    status: "pending" | "recovering" | "outcome_unknown";
+    createdAt: string;
+}
+export interface PendingMutation<Result = unknown> extends PendingMutationSummary {
+    recover(options?: ConnectRequestOptions): Promise<import("./outcomes.js").ConnectOutcome<Result>>;
 }
 export interface CreateInput<Frontmatter extends JsonObject = JsonObject> {
     path?: string;
@@ -217,6 +224,8 @@ export interface WatchOptions {
     cursor?: number;
     pollIntervalMs?: number;
     signal?: AbortSignal;
+    /** Per-poll/reconnect budget. null deliberately disables the SDK default. */
+    timeoutMs?: number | null;
     /** Set to false to surface transient transport failures immediately. */
     retry?: false | WatchRetryOptions;
     onStatus?: (status: WatchStatus) => void;
@@ -245,9 +254,25 @@ export type WatchStatus = {
     state: "reset_required";
     cursor: number;
     problem: ConnectProblem<"change_cursor_reset">;
+} | {
+    state: "closed";
+    cursor?: number;
 };
+export interface WatchInput {
+    cursor?: number;
+    pollIntervalMs?: number;
+    retry?: false | WatchRetryOptions;
+    /** Cancels the subscription lifetime after bounded startup succeeds. */
+    lifetimeSignal?: AbortSignal;
+}
+export interface MdbaseWatchSubscription {
+    readonly status: WatchStatus;
+    readonly problem: ConnectProblem | null;
+    subscribe(listener: (change: CollectionChange) => void, onStatus?: (status: WatchStatus) => void, onProblem?: (problem: ConnectProblem) => void): () => void;
+    close(): void;
+}
 /** Provider-neutral operation transport used by the typed collection client. */
 export interface MdbaseCollectionTransport {
-    operation<Result>(operation: CollectionOperation, input: unknown, options?: OperationRequestOptions): Promise<Result>;
+    operation<Result>(operation: CollectionOperation, input: unknown, options?: ConnectRequestOptions): Promise<Result>;
 }
 export {};

package/dist/outcomes.d.ts

@@ -13,19 +13,19 @@ export type ConnectFailure<Code extends ConnectProblemCode = ConnectProblemCode>
  * for programming errors and broken SDK invariants.
  */
 export type ConnectOutcome<Value, Code extends ConnectProblemCode = ConnectProblemCode> = ConnectSuccess<Value> | ConnectFailure<Code>;
-export type CommonOperationProblemCode = "access_denied" | "access_paused" | "authorization_expired" | "collection_access_denied" | "connector_identity_changed" | "connector_offline" | "connector_upgrade_required" | "direct_operation_rejected" | "operation_outcome_unknown" | "encryption_required" | "encrypted_relay_rejected" | "hosted_provider_unavailable" | "insufficient_access" | "invalid_encrypted_response" | "invalid_operation_response" | "invalid_request" | "missing_grant_key" | "not_authorized" | "operation_cancelled" | "operation_failed" | "rate_limited" | "relay_authorization_expired" | "relay_unavailable" | "temporarily_unavailable" | "timeout" | "unsupported_operation";
-export declare const COMMON_OPERATION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation"];
+export type CommonOperationProblemCode = "access_denied" | "access_paused" | "authorization_binding_incompatible" | "authorization_expired" | "capability_contract_incompatible" | "collection_access_denied" | "connector_identity_changed" | "connector_offline" | "connector_upgrade_required" | "direct_operation_rejected" | "durable_mutation_unsupported" | "operation_outcome_unknown" | "encryption_required" | "encrypted_relay_rejected" | "hosted_provider_unavailable" | "insufficient_access" | "invalid_encrypted_response" | "invalid_operation_response" | "invalid_request" | "missing_grant_key" | "mutation_recovery_expired" | "mutation_request_conflict" | "not_authorized" | "operation_cancelled" | "operation_failed" | "rate_limited" | "relay_authorization_expired" | "relay_unavailable" | "temporarily_unavailable" | "timeout" | "transport_protocol_incompatible" | "unsupported_operation";
+export declare const COMMON_OPERATION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation"];
 export declare const ALL_CONNECT_PROBLEM_CODES: ConnectProblemCode[];
-export type RegistrationProblemCode = "discovery_failed" | "invalid_application_manifest" | "invalid_request" | "manifest_load_failed" | "rate_limited" | "temporarily_unavailable" | "timeout";
-export declare const REGISTRATION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout"];
-export type AuthorizationProblemCode = RegistrationProblemCode | "access_denied" | "application_identity_unavailable" | "approval_window_blocked" | "authorization_cancelled" | "authorization_replayed" | "browser_required" | "collection_access_denied" | "collection_configuration_invalid" | "collection_contracts_missing" | "collection_incompatible" | "collection_invalid" | "collection_kind_unsupported" | "collection_mismatch" | "collection_not_found" | "collection_type_registry_invalid" | "collection_version_unsupported" | "connector_identity_changed" | "connector_offline" | "connector_upgrade_required" | "device_authorization_failed" | "encryption_required" | "expired_token" | "invalid_application_authorization" | "invalid_callback" | "invalid_device_authorization_response" | "invalid_token_response" | "scope_denied" | "reconnect_required" | "token_exchange_failed";
-export declare const AUTHORIZATION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout", "access_denied", "application_identity_unavailable", "approval_window_blocked", "authorization_cancelled", "authorization_replayed", "browser_required", "collection_access_denied", "collection_configuration_invalid", "collection_contracts_missing", "collection_incompatible", "collection_invalid", "collection_kind_unsupported", "collection_mismatch", "collection_not_found", "collection_type_registry_invalid", "collection_version_unsupported", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "device_authorization_failed", "encryption_required", "expired_token", "invalid_application_authorization", "invalid_callback", "invalid_device_authorization_response", "invalid_token_response", "scope_denied", "reconnect_required", "token_exchange_failed"];
-export type NotificationProblemCode = RegistrationProblemCode | "authorization_expired" | "invalid_push_subscription" | "managed_fcm_not_declared" | "not_authorized" | "notification_criterion_not_declared" | "notification_reauthorization_required" | "notification_registration_failed" | "notification_unregistration_failed" | "notifications_not_declared" | "notifications_unavailable";
-export declare const NOTIFICATION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout", "authorization_expired", "invalid_push_subscription", "managed_fcm_not_declared", "not_authorized", "notification_criterion_not_declared", "notification_reauthorization_required", "notification_registration_failed", "notification_unregistration_failed", "notifications_not_declared", "notifications_unavailable"];
+export type RegistrationProblemCode = "discovery_failed" | "invalid_operation_response" | "invalid_application_manifest" | "invalid_request" | "manifest_load_failed" | "rate_limited" | "temporarily_unavailable" | "timeout";
+export declare const REGISTRATION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_operation_response", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout"];
+export type AuthorizationProblemCode = RegistrationProblemCode | "access_denied" | "application_identity_unavailable" | "approval_window_blocked" | "authorization_binding_incompatible" | "authorization_cancelled" | "authorization_replayed" | "browser_required" | "capability_contract_incompatible" | "collection_access_denied" | "collection_configuration_invalid" | "collection_contracts_missing" | "collection_incompatible" | "collection_invalid" | "collection_kind_unsupported" | "collection_mismatch" | "collection_not_found" | "collection_type_registry_invalid" | "collection_version_unsupported" | "connector_identity_changed" | "connector_offline" | "connector_upgrade_required" | "device_authorization_failed" | "durable_mutation_unsupported" | "encryption_required" | "expired_token" | "invalid_application_authorization" | "invalid_callback" | "invalid_device_authorization_response" | "invalid_token_response" | "scope_denied" | "reconnect_required" | "token_exchange_failed" | "transport_protocol_incompatible";
+export declare const AUTHORIZATION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_operation_response", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout", "access_denied", "application_identity_unavailable", "approval_window_blocked", "authorization_binding_incompatible", "authorization_cancelled", "authorization_replayed", "browser_required", "capability_contract_incompatible", "collection_access_denied", "collection_configuration_invalid", "collection_contracts_missing", "collection_incompatible", "collection_invalid", "collection_kind_unsupported", "collection_mismatch", "collection_not_found", "collection_type_registry_invalid", "collection_version_unsupported", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "device_authorization_failed", "durable_mutation_unsupported", "encryption_required", "expired_token", "invalid_application_authorization", "invalid_callback", "invalid_device_authorization_response", "invalid_token_response", "scope_denied", "reconnect_required", "token_exchange_failed", "transport_protocol_incompatible"];
+export type NotificationProblemCode = RegistrationProblemCode | "authorization_expired" | "invalid_operation_response" | "invalid_push_subscription" | "managed_fcm_not_declared" | "not_authorized" | "notification_criterion_not_declared" | "notification_reauthorization_required" | "notification_registration_failed" | "notification_unregistration_failed" | "notifications_not_declared" | "notifications_unavailable";
+export declare const NOTIFICATION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_operation_response", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout", "authorization_expired", "invalid_operation_response", "invalid_push_subscription", "managed_fcm_not_declared", "not_authorized", "notification_criterion_not_declared", "notification_reauthorization_required", "notification_registration_failed", "notification_unregistration_failed", "notifications_not_declared", "notifications_unavailable"];
 export type DirectAccessProblemCode = "connector_offline" | "connector_upgrade_required" | "invalid_operation_response" | "not_authorized" | "operation_failed" | "temporarily_unavailable" | "timeout";
 export declare const DIRECT_ACCESS_PROBLEM_CODES: readonly ["connector_offline", "connector_upgrade_required", "invalid_operation_response", "not_authorized", "operation_failed", "temporarily_unavailable", "timeout"];
 export type SessionProblemCode = AuthorizationProblemCode | "collection_not_ready" | "collection_not_selected" | "unknown_collection";
-export declare const SESSION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout", "access_denied", "application_identity_unavailable", "approval_window_blocked", "authorization_cancelled", "authorization_replayed", "browser_required", "collection_access_denied", "collection_configuration_invalid", "collection_contracts_missing", "collection_incompatible", "collection_invalid", "collection_kind_unsupported", "collection_mismatch", "collection_not_found", "collection_type_registry_invalid", "collection_version_unsupported", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "device_authorization_failed", "encryption_required", "expired_token", "invalid_application_authorization", "invalid_callback", "invalid_device_authorization_response", "invalid_token_response", "scope_denied", "reconnect_required", "token_exchange_failed", "collection_not_ready", "collection_not_selected", "unknown_collection"];
+export declare const SESSION_PROBLEM_CODES: readonly ["discovery_failed", "invalid_operation_response", "invalid_application_manifest", "invalid_request", "manifest_load_failed", "rate_limited", "temporarily_unavailable", "timeout", "access_denied", "application_identity_unavailable", "approval_window_blocked", "authorization_binding_incompatible", "authorization_cancelled", "authorization_replayed", "browser_required", "capability_contract_incompatible", "collection_access_denied", "collection_configuration_invalid", "collection_contracts_missing", "collection_incompatible", "collection_invalid", "collection_kind_unsupported", "collection_mismatch", "collection_not_found", "collection_type_registry_invalid", "collection_version_unsupported", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "device_authorization_failed", "durable_mutation_unsupported", "encryption_required", "expired_token", "invalid_application_authorization", "invalid_callback", "invalid_device_authorization_response", "invalid_token_response", "scope_denied", "reconnect_required", "token_exchange_failed", "transport_protocol_incompatible", "collection_not_ready", "collection_not_selected", "unknown_collection"];
 export type CollectionSetupProblemCode = "collection_configuration_invalid" | "collection_invalid" | "collection_type_registry_invalid" | "collection_version_unsupported";
 export type CollectionDescriptionProblemCode = CommonOperationProblemCode | CollectionSetupProblemCode;
 export type CollectionReadProblemCode = CollectionDescriptionProblemCode | "invalid_path" | "operation_invalid";
@@ -34,12 +34,12 @@ export type CollectionMutationProblemCode = CollectionReadProblemCode | "concurr
 export type CollectionChangesProblemCode = CollectionDescriptionProblemCode | "change_cursor_reset";
 export type CollectionTypeProblemCode = CollectionMutationProblemCode | "type_pack_provision_failed";
 export declare const COLLECTION_SETUP_PROBLEM_CODES: readonly ["collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported"];
-export declare const COLLECTION_DESCRIPTION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported"];
-export declare const COLLECTION_READ_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid"];
-export declare const COLLECTION_QUERY_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid", "query_snapshot_changed", "sandbox_unsupported"];
-export declare const COLLECTION_MUTATION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved"];
-export declare const COLLECTION_CHANGES_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "change_cursor_reset"];
-export declare const COLLECTION_TYPE_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_expired", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved", "type_pack_provision_failed"];
+export declare const COLLECTION_DESCRIPTION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported"];
+export declare const COLLECTION_READ_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid"];
+export declare const COLLECTION_QUERY_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid", "query_snapshot_changed", "sandbox_unsupported"];
+export declare const COLLECTION_MUTATION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved"];
+export declare const COLLECTION_CHANGES_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "change_cursor_reset"];
+export declare const COLLECTION_TYPE_PROBLEM_CODES: readonly ["access_denied", "access_paused", "authorization_binding_incompatible", "authorization_expired", "capability_contract_incompatible", "collection_access_denied", "connector_identity_changed", "connector_offline", "connector_upgrade_required", "direct_operation_rejected", "durable_mutation_unsupported", "operation_outcome_unknown", "encryption_required", "encrypted_relay_rejected", "hosted_provider_unavailable", "insufficient_access", "invalid_encrypted_response", "invalid_operation_response", "invalid_request", "missing_grant_key", "mutation_recovery_expired", "mutation_request_conflict", "not_authorized", "operation_cancelled", "operation_failed", "rate_limited", "relay_authorization_expired", "relay_unavailable", "temporarily_unavailable", "timeout", "transport_protocol_incompatible", "unsupported_operation", "collection_configuration_invalid", "collection_invalid", "collection_type_registry_invalid", "collection_version_unsupported", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved", "type_pack_provision_failed"];
 export declare function connectSuccess<Value>(value: Value, diagnostics?: MdbaseDiagnostic[]): ConnectSuccess<Value>;
 export declare function connectFailure<Code extends ConnectProblemCode>(problem: ConnectProblem<Code>): ConnectFailure<Code>;
 export declare function captureConnectOutcome<Value, Code extends ConnectProblemCode>(operation: () => Promise<Value>, allowedCodes: readonly Code[]): Promise<ConnectOutcome<Value, Code>>;