@mdbase-dev/connect-protocol 0.1.0-beta.21 → 0.1.0-beta.22

package/dist/connect-problems.generated.d.ts

@@ -0,0 +1,1067 @@
+export declare const CONNECT_PROBLEM_VERSION: 1;
+export declare const CONNECT_PROBLEM_CATALOG: {
+    readonly access_denied: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly access_paused: {
+        readonly category: "availability";
+        readonly recovery: "resume_connector_access";
+    };
+    readonly approval_window_blocked: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly authority_authorization_changed: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly authorization_cancelled: {
+        readonly category: "cancellation";
+        readonly recovery: "none";
+    };
+    readonly authorization_expired: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly browser_required: {
+        readonly category: "compatibility";
+        readonly recovery: "none";
+    };
+    readonly callback_url_required: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly change_cursor_reset: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly collection_access_denied: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly collection_configuration_invalid: {
+        readonly category: "validation";
+        readonly recovery: "repair_collection";
+    };
+    readonly collection_contracts_missing: {
+        readonly category: "compatibility";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_incompatible: {
+        readonly category: "compatibility";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_invalid: {
+        readonly category: "validation";
+        readonly recovery: "repair_collection";
+    };
+    readonly collection_kind_unsupported: {
+        readonly category: "compatibility";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_mismatch: {
+        readonly category: "selection";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_not_found: {
+        readonly category: "selection";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_not_ready: {
+        readonly category: "selection";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_not_selected: {
+        readonly category: "selection";
+        readonly recovery: "choose_collection";
+    };
+    readonly collection_type_registry_invalid: {
+        readonly category: "validation";
+        readonly recovery: "repair_collection";
+    };
+    readonly collection_version_unsupported: {
+        readonly category: "compatibility";
+        readonly recovery: "upgrade_collection";
+    };
+    readonly concurrent_modification: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly connector_identity_changed: {
+        readonly category: "integrity";
+        readonly recovery: "reauthorize";
+    };
+    readonly connector_offline: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly connector_upgrade_required: {
+        readonly category: "compatibility";
+        readonly recovery: "upgrade_connector";
+    };
+    readonly device_authorization_failed: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly direct_operation_rejected: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly discovery_failed: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly encrypted_relay_rejected: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly encryption_required: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly expired_token: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly file_changed_during_move: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly file_changed_during_read: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly file_move_failed: {
+        readonly category: "internal";
+        readonly recovery: "contact_support";
+    };
+    readonly file_mutation_conflict: {
+        readonly category: "conflict";
+        readonly recovery: "resolve_conflict";
+    };
+    readonly file_not_found: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly file_source_mismatch: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly file_upload_incomplete: {
+        readonly category: "conflict";
+        readonly recovery: "retry";
+    };
+    readonly hosted_provider_unavailable: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly insufficient_access: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly invalid_application_manifest: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_callback: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_device_authorization_response: {
+        readonly category: "integrity";
+        readonly recovery: "contact_support";
+    };
+    readonly invalid_encrypted_response: {
+        readonly category: "integrity";
+        readonly recovery: "contact_support";
+    };
+    readonly invalid_loopback_url: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_mutation_id: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_operation_response: {
+        readonly category: "integrity";
+        readonly recovery: "contact_support";
+    };
+    readonly invalid_path: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_preflight: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly invalid_push_payload: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_push_subscription: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_request: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly invalid_token_response: {
+        readonly category: "integrity";
+        readonly recovery: "contact_support";
+    };
+    readonly managed_fcm_not_declared: {
+        readonly category: "compatibility";
+        readonly recovery: "fix_request";
+    };
+    readonly manifest_load_failed: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly manifest_required: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly missing_grant_key: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly no_pending_mutation: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly not_authorized: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly not_remote_authority: {
+        readonly category: "compatibility";
+        readonly recovery: "choose_collection";
+    };
+    readonly notification_criterion_not_declared: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly notification_reauthorization_required: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly notification_registration_failed: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly notification_unregistration_failed: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly notifications_not_declared: {
+        readonly category: "compatibility";
+        readonly recovery: "fix_request";
+    };
+    readonly notifications_unavailable: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly operation_cancelled: {
+        readonly category: "cancellation";
+        readonly recovery: "none";
+    };
+    readonly operation_failed: {
+        readonly category: "internal";
+        readonly recovery: "contact_support";
+    };
+    readonly operation_invalid: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly operation_outcome_unknown: {
+        readonly category: "conflict";
+        readonly recovery: "resolve_outcome";
+    };
+    readonly path_occupied: {
+        readonly category: "conflict";
+        readonly recovery: "resolve_conflict";
+    };
+    readonly pending_mutation_unresolved: {
+        readonly category: "conflict";
+        readonly recovery: "resolve_outcome";
+    };
+    readonly query_snapshot_changed: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly rate_limited: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly redirect_uri_required: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly reference_updates_unsupported: {
+        readonly category: "compatibility";
+        readonly recovery: "fix_request";
+    };
+    readonly relay_authorization_expired: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly relay_unavailable: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly sandbox_unsupported: {
+        readonly category: "compatibility";
+        readonly recovery: "fix_request";
+    };
+    readonly scope_denied: {
+        readonly category: "authorization";
+        readonly recovery: "reauthorize";
+    };
+    readonly stale_file_revision: {
+        readonly category: "conflict";
+        readonly recovery: "refresh";
+    };
+    readonly storage_required: {
+        readonly category: "compatibility";
+        readonly recovery: "none";
+    };
+    readonly sync_failed: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly temporarily_unavailable: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly timeout: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly token_exchange_failed: {
+        readonly category: "availability";
+        readonly recovery: "retry";
+    };
+    readonly type_pack_provision_failed: {
+        readonly category: "validation";
+        readonly recovery: "repair_collection";
+    };
+    readonly unknown_collection: {
+        readonly category: "selection";
+        readonly recovery: "choose_collection";
+    };
+    readonly unsafe_file_path: {
+        readonly category: "validation";
+        readonly recovery: "fix_request";
+    };
+    readonly unsupported_encryption: {
+        readonly category: "compatibility";
+        readonly recovery: "upgrade_application";
+    };
+    readonly unsupported_operation: {
+        readonly category: "compatibility";
+        readonly recovery: "fix_request";
+    };
+};
+export type ConnectProblemCode = keyof typeof CONNECT_PROBLEM_CATALOG;
+export type ConnectProblemCategory = "authorization" | "availability" | "cancellation" | "compatibility" | "conflict" | "integrity" | "internal" | "selection" | "validation" | "unknown";
+export type ConnectRecoveryAction = "choose_collection" | "contact_support" | "fix_request" | "none" | "reauthorize" | "refresh" | "repair_collection" | "resume_connector_access" | "resolve_conflict" | "resolve_outcome" | "retry" | "upgrade_application" | "upgrade_collection" | "upgrade_connector";
+export type ConnectOperationOutcome = "not_sent" | "rejected" | "unknown";
+export interface ConnectProblemBase {
+    problem_version: typeof CONNECT_PROBLEM_VERSION;
+    message: string;
+    operation_outcome?: ConnectOperationOutcome;
+    trace_id?: string;
+}
+export interface ConnectProblemDetailsByCode {
+    "access_denied": {
+        "return_to"?: string;
+    };
+    "access_paused": undefined;
+    "approval_window_blocked": {
+        "user_code": string;
+        "verification_uri": string;
+        "verification_uri_complete": string;
+        "expires_at": number;
+        "interval_seconds": number;
+    };
+    "authority_authorization_changed": undefined;
+    "authorization_cancelled": undefined;
+    "authorization_expired": undefined;
+    "browser_required": undefined;
+    "callback_url_required": undefined;
+    "change_cursor_reset": undefined;
+    "collection_access_denied": undefined;
+    "collection_configuration_invalid": {
+        "diagnostics": Array<Record<string, unknown>>;
+    };
+    "collection_contracts_missing": {
+        "contracts": Array<{
+            "id": string;
+            "version": string;
+        }>;
+    };
+    "collection_incompatible": undefined;
+    "collection_invalid": {
+        "diagnostics": Array<Record<string, unknown>>;
+    };
+    "collection_kind_unsupported": undefined;
+    "collection_mismatch": undefined;
+    "collection_not_found": undefined;
+    "collection_not_ready": undefined;
+    "collection_not_selected": undefined;
+    "collection_type_registry_invalid": {
+        "diagnostics": Array<Record<string, unknown>>;
+    };
+    "collection_version_unsupported": {
+        "current_version": string;
+        "required_version": string;
+    };
+    "concurrent_modification": undefined;
+    "connector_identity_changed": undefined;
+    "connector_offline": {
+        "connector_name"?: string;
+    };
+    "connector_upgrade_required": undefined;
+    "device_authorization_failed": undefined;
+    "direct_operation_rejected": undefined;
+    "discovery_failed": undefined;
+    "encrypted_relay_rejected": undefined;
+    "encryption_required": undefined;
+    "expired_token": undefined;
+    "file_changed_during_move": undefined;
+    "file_changed_during_read": undefined;
+    "file_move_failed": undefined;
+    "file_mutation_conflict": undefined;
+    "file_not_found": undefined;
+    "file_source_mismatch": undefined;
+    "file_upload_incomplete": undefined;
+    "hosted_provider_unavailable": undefined;
+    "insufficient_access": {
+        "required_operations": Array<string>;
+        "granted_operations": Array<string>;
+        "missing_operations": Array<string>;
+    };
+    "invalid_application_manifest": undefined;
+    "invalid_callback": undefined;
+    "invalid_device_authorization_response": undefined;
+    "invalid_encrypted_response": undefined;
+    "invalid_loopback_url": undefined;
+    "invalid_mutation_id": undefined;
+    "invalid_operation_response": undefined;
+    "invalid_path": undefined;
+    "invalid_preflight": undefined;
+    "invalid_push_payload": undefined;
+    "invalid_push_subscription": undefined;
+    "invalid_request": undefined;
+    "invalid_token_response": undefined;
+    "managed_fcm_not_declared": undefined;
+    "manifest_load_failed": undefined;
+    "manifest_required": undefined;
+    "missing_grant_key": undefined;
+    "no_pending_mutation": undefined;
+    "not_authorized": undefined;
+    "not_remote_authority": undefined;
+    "notification_criterion_not_declared": undefined;
+    "notification_reauthorization_required": undefined;
+    "notification_registration_failed": undefined;
+    "notification_unregistration_failed": undefined;
+    "notifications_not_declared": undefined;
+    "notifications_unavailable": undefined;
+    "operation_cancelled": undefined;
+    "operation_failed": undefined;
+    "operation_invalid": {
+        "diagnostics": Array<Record<string, unknown>>;
+        "partial_result"?: unknown;
+    };
+    "operation_outcome_unknown": undefined;
+    "path_occupied": undefined;
+    "pending_mutation_unresolved": undefined;
+    "query_snapshot_changed": undefined;
+    "rate_limited": {
+        "retry_after_ms"?: number;
+    };
+    "redirect_uri_required": undefined;
+    "reference_updates_unsupported": undefined;
+    "relay_authorization_expired": undefined;
+    "relay_unavailable": undefined;
+    "sandbox_unsupported": undefined;
+    "scope_denied": undefined;
+    "stale_file_revision": undefined;
+    "storage_required": undefined;
+    "sync_failed": undefined;
+    "temporarily_unavailable": undefined;
+    "timeout": undefined;
+    "token_exchange_failed": undefined;
+    "type_pack_provision_failed": undefined;
+    "unknown_collection": undefined;
+    "unsafe_file_path": undefined;
+    "unsupported_encryption": undefined;
+    "unsupported_operation": undefined;
+}
+export interface ConnectProblemByCode {
+    "access_denied": ConnectProblemBase & {
+        code: "access_denied";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: ConnectProblemDetailsByCode["access_denied"];
+    };
+    "access_paused": ConnectProblemBase & {
+        code: "access_paused";
+        category: "availability";
+        recovery: "resume_connector_access";
+        details?: never;
+    };
+    "approval_window_blocked": ConnectProblemBase & {
+        code: "approval_window_blocked";
+        category: "authorization";
+        recovery: "reauthorize";
+        details: ConnectProblemDetailsByCode["approval_window_blocked"];
+    };
+    "authority_authorization_changed": ConnectProblemBase & {
+        code: "authority_authorization_changed";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "authorization_cancelled": ConnectProblemBase & {
+        code: "authorization_cancelled";
+        category: "cancellation";
+        recovery: "none";
+        details?: never;
+    };
+    "authorization_expired": ConnectProblemBase & {
+        code: "authorization_expired";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "browser_required": ConnectProblemBase & {
+        code: "browser_required";
+        category: "compatibility";
+        recovery: "none";
+        details?: never;
+    };
+    "callback_url_required": ConnectProblemBase & {
+        code: "callback_url_required";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "change_cursor_reset": ConnectProblemBase & {
+        code: "change_cursor_reset";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "collection_access_denied": ConnectProblemBase & {
+        code: "collection_access_denied";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "collection_configuration_invalid": ConnectProblemBase & {
+        code: "collection_configuration_invalid";
+        category: "validation";
+        recovery: "repair_collection";
+        details: ConnectProblemDetailsByCode["collection_configuration_invalid"];
+    };
+    "collection_contracts_missing": ConnectProblemBase & {
+        code: "collection_contracts_missing";
+        category: "compatibility";
+        recovery: "choose_collection";
+        details: ConnectProblemDetailsByCode["collection_contracts_missing"];
+    };
+    "collection_incompatible": ConnectProblemBase & {
+        code: "collection_incompatible";
+        category: "compatibility";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "collection_invalid": ConnectProblemBase & {
+        code: "collection_invalid";
+        category: "validation";
+        recovery: "repair_collection";
+        details: ConnectProblemDetailsByCode["collection_invalid"];
+    };
+    "collection_kind_unsupported": ConnectProblemBase & {
+        code: "collection_kind_unsupported";
+        category: "compatibility";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "collection_mismatch": ConnectProblemBase & {
+        code: "collection_mismatch";
+        category: "selection";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "collection_not_found": ConnectProblemBase & {
+        code: "collection_not_found";
+        category: "selection";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "collection_not_ready": ConnectProblemBase & {
+        code: "collection_not_ready";
+        category: "selection";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "collection_not_selected": ConnectProblemBase & {
+        code: "collection_not_selected";
+        category: "selection";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "collection_type_registry_invalid": ConnectProblemBase & {
+        code: "collection_type_registry_invalid";
+        category: "validation";
+        recovery: "repair_collection";
+        details: ConnectProblemDetailsByCode["collection_type_registry_invalid"];
+    };
+    "collection_version_unsupported": ConnectProblemBase & {
+        code: "collection_version_unsupported";
+        category: "compatibility";
+        recovery: "upgrade_collection";
+        details: ConnectProblemDetailsByCode["collection_version_unsupported"];
+    };
+    "concurrent_modification": ConnectProblemBase & {
+        code: "concurrent_modification";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "connector_identity_changed": ConnectProblemBase & {
+        code: "connector_identity_changed";
+        category: "integrity";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "connector_offline": ConnectProblemBase & {
+        code: "connector_offline";
+        category: "availability";
+        recovery: "retry";
+        details?: ConnectProblemDetailsByCode["connector_offline"];
+    };
+    "connector_upgrade_required": ConnectProblemBase & {
+        code: "connector_upgrade_required";
+        category: "compatibility";
+        recovery: "upgrade_connector";
+        details?: never;
+    };
+    "device_authorization_failed": ConnectProblemBase & {
+        code: "device_authorization_failed";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "direct_operation_rejected": ConnectProblemBase & {
+        code: "direct_operation_rejected";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "discovery_failed": ConnectProblemBase & {
+        code: "discovery_failed";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "encrypted_relay_rejected": ConnectProblemBase & {
+        code: "encrypted_relay_rejected";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "encryption_required": ConnectProblemBase & {
+        code: "encryption_required";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "expired_token": ConnectProblemBase & {
+        code: "expired_token";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "file_changed_during_move": ConnectProblemBase & {
+        code: "file_changed_during_move";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "file_changed_during_read": ConnectProblemBase & {
+        code: "file_changed_during_read";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "file_move_failed": ConnectProblemBase & {
+        code: "file_move_failed";
+        category: "internal";
+        recovery: "contact_support";
+        details?: never;
+    };
+    "file_mutation_conflict": ConnectProblemBase & {
+        code: "file_mutation_conflict";
+        category: "conflict";
+        recovery: "resolve_conflict";
+        details?: never;
+    };
+    "file_not_found": ConnectProblemBase & {
+        code: "file_not_found";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "file_source_mismatch": ConnectProblemBase & {
+        code: "file_source_mismatch";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "file_upload_incomplete": ConnectProblemBase & {
+        code: "file_upload_incomplete";
+        category: "conflict";
+        recovery: "retry";
+        details?: never;
+    };
+    "hosted_provider_unavailable": ConnectProblemBase & {
+        code: "hosted_provider_unavailable";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "insufficient_access": ConnectProblemBase & {
+        code: "insufficient_access";
+        category: "authorization";
+        recovery: "reauthorize";
+        details: ConnectProblemDetailsByCode["insufficient_access"];
+    };
+    "invalid_application_manifest": ConnectProblemBase & {
+        code: "invalid_application_manifest";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_callback": ConnectProblemBase & {
+        code: "invalid_callback";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_device_authorization_response": ConnectProblemBase & {
+        code: "invalid_device_authorization_response";
+        category: "integrity";
+        recovery: "contact_support";
+        details?: never;
+    };
+    "invalid_encrypted_response": ConnectProblemBase & {
+        code: "invalid_encrypted_response";
+        category: "integrity";
+        recovery: "contact_support";
+        details?: never;
+    };
+    "invalid_loopback_url": ConnectProblemBase & {
+        code: "invalid_loopback_url";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_mutation_id": ConnectProblemBase & {
+        code: "invalid_mutation_id";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_operation_response": ConnectProblemBase & {
+        code: "invalid_operation_response";
+        category: "integrity";
+        recovery: "contact_support";
+        details?: never;
+    };
+    "invalid_path": ConnectProblemBase & {
+        code: "invalid_path";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_preflight": ConnectProblemBase & {
+        code: "invalid_preflight";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "invalid_push_payload": ConnectProblemBase & {
+        code: "invalid_push_payload";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_push_subscription": ConnectProblemBase & {
+        code: "invalid_push_subscription";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_request": ConnectProblemBase & {
+        code: "invalid_request";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "invalid_token_response": ConnectProblemBase & {
+        code: "invalid_token_response";
+        category: "integrity";
+        recovery: "contact_support";
+        details?: never;
+    };
+    "managed_fcm_not_declared": ConnectProblemBase & {
+        code: "managed_fcm_not_declared";
+        category: "compatibility";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "manifest_load_failed": ConnectProblemBase & {
+        code: "manifest_load_failed";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "manifest_required": ConnectProblemBase & {
+        code: "manifest_required";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "missing_grant_key": ConnectProblemBase & {
+        code: "missing_grant_key";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "no_pending_mutation": ConnectProblemBase & {
+        code: "no_pending_mutation";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "not_authorized": ConnectProblemBase & {
+        code: "not_authorized";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "not_remote_authority": ConnectProblemBase & {
+        code: "not_remote_authority";
+        category: "compatibility";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "notification_criterion_not_declared": ConnectProblemBase & {
+        code: "notification_criterion_not_declared";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "notification_reauthorization_required": ConnectProblemBase & {
+        code: "notification_reauthorization_required";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "notification_registration_failed": ConnectProblemBase & {
+        code: "notification_registration_failed";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "notification_unregistration_failed": ConnectProblemBase & {
+        code: "notification_unregistration_failed";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "notifications_not_declared": ConnectProblemBase & {
+        code: "notifications_not_declared";
+        category: "compatibility";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "notifications_unavailable": ConnectProblemBase & {
+        code: "notifications_unavailable";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "operation_cancelled": ConnectProblemBase & {
+        code: "operation_cancelled";
+        category: "cancellation";
+        recovery: "none";
+        details?: never;
+    };
+    "operation_failed": ConnectProblemBase & {
+        code: "operation_failed";
+        category: "internal";
+        recovery: "contact_support";
+        details?: never;
+    };
+    "operation_invalid": ConnectProblemBase & {
+        code: "operation_invalid";
+        category: "validation";
+        recovery: "fix_request";
+        details: ConnectProblemDetailsByCode["operation_invalid"];
+    };
+    "operation_outcome_unknown": ConnectProblemBase & {
+        code: "operation_outcome_unknown";
+        category: "conflict";
+        recovery: "resolve_outcome";
+        details?: never;
+    };
+    "path_occupied": ConnectProblemBase & {
+        code: "path_occupied";
+        category: "conflict";
+        recovery: "resolve_conflict";
+        details?: never;
+    };
+    "pending_mutation_unresolved": ConnectProblemBase & {
+        code: "pending_mutation_unresolved";
+        category: "conflict";
+        recovery: "resolve_outcome";
+        details?: never;
+    };
+    "query_snapshot_changed": ConnectProblemBase & {
+        code: "query_snapshot_changed";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "rate_limited": ConnectProblemBase & {
+        code: "rate_limited";
+        category: "availability";
+        recovery: "retry";
+        details?: ConnectProblemDetailsByCode["rate_limited"];
+    };
+    "redirect_uri_required": ConnectProblemBase & {
+        code: "redirect_uri_required";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "reference_updates_unsupported": ConnectProblemBase & {
+        code: "reference_updates_unsupported";
+        category: "compatibility";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "relay_authorization_expired": ConnectProblemBase & {
+        code: "relay_authorization_expired";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "relay_unavailable": ConnectProblemBase & {
+        code: "relay_unavailable";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "sandbox_unsupported": ConnectProblemBase & {
+        code: "sandbox_unsupported";
+        category: "compatibility";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "scope_denied": ConnectProblemBase & {
+        code: "scope_denied";
+        category: "authorization";
+        recovery: "reauthorize";
+        details?: never;
+    };
+    "stale_file_revision": ConnectProblemBase & {
+        code: "stale_file_revision";
+        category: "conflict";
+        recovery: "refresh";
+        details?: never;
+    };
+    "storage_required": ConnectProblemBase & {
+        code: "storage_required";
+        category: "compatibility";
+        recovery: "none";
+        details?: never;
+    };
+    "sync_failed": ConnectProblemBase & {
+        code: "sync_failed";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "temporarily_unavailable": ConnectProblemBase & {
+        code: "temporarily_unavailable";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "timeout": ConnectProblemBase & {
+        code: "timeout";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "token_exchange_failed": ConnectProblemBase & {
+        code: "token_exchange_failed";
+        category: "availability";
+        recovery: "retry";
+        details?: never;
+    };
+    "type_pack_provision_failed": ConnectProblemBase & {
+        code: "type_pack_provision_failed";
+        category: "validation";
+        recovery: "repair_collection";
+        details?: never;
+    };
+    "unknown_collection": ConnectProblemBase & {
+        code: "unknown_collection";
+        category: "selection";
+        recovery: "choose_collection";
+        details?: never;
+    };
+    "unsafe_file_path": ConnectProblemBase & {
+        code: "unsafe_file_path";
+        category: "validation";
+        recovery: "fix_request";
+        details?: never;
+    };
+    "unsupported_encryption": ConnectProblemBase & {
+        code: "unsupported_encryption";
+        category: "compatibility";
+        recovery: "upgrade_application";
+        details?: never;
+    };
+    "unsupported_operation": ConnectProblemBase & {
+        code: "unsupported_operation";
+        category: "compatibility";
+        recovery: "fix_request";
+        details?: never;
+    };
+}
+export type KnownConnectProblem<Code extends ConnectProblemCode = ConnectProblemCode> = ConnectProblemByCode[Code];
+export type UnknownConnectProblem = ConnectProblemBase & {
+    code: "unknown";
+    server_code: string;
+    category: "unknown";
+    recovery: "none";
+    details?: unknown;
+};
+export type ConnectProblem<Code extends ConnectProblemCode = ConnectProblemCode> = KnownConnectProblem<Code> | UnknownConnectProblem;
+export declare function isConnectProblemCode(code: string): code is ConnectProblemCode;
+export declare function isConnectProblem(value: unknown): value is ConnectProblem;
+export declare function normalizeConnectProblem(serverCode: string, message: string, options?: {
+    details?: unknown;
+    operation_outcome?: ConnectOperationOutcome;
+    trace_id?: string;
+}): ConnectProblem;