@mdbase-dev/connect 0.1.0-beta.126 → 0.1.0-beta.147

package/dist/operation-types.d.ts

@@ -69,11 +69,13 @@ export interface QueryRecord<Frontmatter extends JsonObject = JsonObject> {
 /** Query-shaped projection; qualified document batches supply exact-source revisions. */
 export type ReadManyRecord<Frontmatter extends JsonObject = JsonObject> = QueryRecord<Frontmatter>;
 export interface ReadManyOptions extends ConnectRequestOptions {
+    /** Default true: prefer negotiated document revisions. False uses read-only path queries; no revision guarantee. */
+    revisions?: boolean;
     includeBody?: boolean;
     frontmatterMode?: QueryInput["frontmatterMode"];
     /** Restrict matching records to these raw collection types, not a contract view. */
     types?: string[];
-    /** Unique paths per batch, default 100; range 1..1,000. Document authorities cap at 100. */
+    /** Unique paths per batch, default 100 (1,000 with revisions:false); range 1..1,000. Document authorities cap at 100. */
     batchSize?: number;
     /** Independent batches in flight, default 4; range 1..4. Cursor pages stay serial. */
     concurrency?: number;

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" | "application_declaration_mismatch" | "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", "application_declaration_mismatch", "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 type CommonOperationProblemCode = "application_authorization_issuance_disabled" | "application_reauthorization_required" | "application_semantic_version_mismatch" | "invalid_replica" | "notification_grant_reauthorization_required" | "origin_denied" | "replica_scope_denied" | "scope_changed" | "scope_denied" | "scope_epoch_stale" | "timer_grant_unavailable" | "access_denied" | "access_paused" | "application_declaration_mismatch" | "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 ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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_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_declaration_mismatch" | "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" | "legacy_scope_reauthorization_required" | "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_declaration_mismatch", "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", "legacy_scope_reauthorization_required", "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 AuthorizationProblemCode = RegistrationProblemCode | "application_authorization_issuance_disabled" | "application_reauthorization_required" | "application_semantic_version_mismatch" | "invalid_replica" | "origin_denied" | "access_denied" | "application_declaration_mismatch" | "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" | "legacy_scope_reauthorization_required" | "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", "application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "origin_denied", "access_denied", "application_declaration_mismatch", "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", "legacy_scope_reauthorization_required", "scope_denied", "reconnect_required", "token_exchange_failed", "transport_protocol_incompatible"];
+export type NotificationProblemCode = RegistrationProblemCode | "notification_grant_reauthorization_required" | "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", "notification_grant_reauthorization_required", "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" | "operation_cancelled" | "session_destroyed" | "session_not_started" | "session_starting" | "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_declaration_mismatch", "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", "legacy_scope_reauthorization_required", "scope_denied", "reconnect_required", "token_exchange_failed", "transport_protocol_incompatible", "collection_not_ready", "collection_not_selected", "operation_cancelled", "session_destroyed", "session_not_started", "session_starting", "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", "application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "origin_denied", "access_denied", "application_declaration_mismatch", "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", "legacy_scope_reauthorization_required", "scope_denied", "reconnect_required", "token_exchange_failed", "transport_protocol_incompatible", "collection_not_ready", "collection_not_selected", "operation_cancelled", "session_destroyed", "session_not_started", "session_starting", "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 | "file_not_found" | "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", "application_declaration_mismatch", "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", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid"];
-export declare const COLLECTION_QUERY_PROBLEM_CODES: readonly ["access_denied", "access_paused", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid", "cursor_capacity_exhausted", "generation_expired", "invalid_read_cursor", "query_snapshot_changed", "sandbox_unsupported"];
-export declare const COLLECTION_MUTATION_PROBLEM_CODES: readonly ["access_denied", "access_paused", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved"];
-export declare const COLLECTION_CHANGES_PROBLEM_CODES: readonly ["access_denied", "access_paused", "application_declaration_mismatch", "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", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved", "type_pack_provision_failed"];
+export declare const COLLECTION_DESCRIPTION_PROBLEM_CODES: readonly ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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 ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid"];
+export declare const COLLECTION_QUERY_PROBLEM_CODES: readonly ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid", "cursor_capacity_exhausted", "generation_expired", "invalid_read_cursor", "query_snapshot_changed", "sandbox_unsupported"];
+export declare const COLLECTION_MUTATION_PROBLEM_CODES: readonly ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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", "file_not_found", "invalid_path", "operation_invalid", "concurrent_modification", "invalid_preflight", "pending_mutation_unresolved"];
+export declare const COLLECTION_CHANGES_PROBLEM_CODES: readonly ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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 ["application_authorization_issuance_disabled", "application_reauthorization_required", "application_semantic_version_mismatch", "invalid_replica", "notification_grant_reauthorization_required", "origin_denied", "replica_scope_denied", "scope_changed", "scope_denied", "scope_epoch_stale", "timer_grant_unavailable", "access_denied", "access_paused", "application_declaration_mismatch", "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", "file_not_found", "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>>;

package/dist/outcomes.js

@@ -1,6 +1,17 @@
 import { CONNECT_PROBLEM_CATALOG } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnectError, unknownConnectProblem } from "./errors.js";
 export const COMMON_OPERATION_PROBLEM_CODES = [
+    "application_authorization_issuance_disabled",
+    "application_reauthorization_required",
+    "application_semantic_version_mismatch",
+    "invalid_replica",
+    "notification_grant_reauthorization_required",
+    "origin_denied",
+    "replica_scope_denied",
+    "scope_changed",
+    "scope_denied",
+    "scope_epoch_stale",
+    "timer_grant_unavailable",
     "access_denied",
     "access_paused",
     "application_declaration_mismatch",
@@ -48,6 +59,11 @@ export const REGISTRATION_PROBLEM_CODES = [
 ];
 export const AUTHORIZATION_PROBLEM_CODES = [
     ...REGISTRATION_PROBLEM_CODES,
+    "application_authorization_issuance_disabled",
+    "application_reauthorization_required",
+    "application_semantic_version_mismatch",
+    "invalid_replica",
+    "origin_denied",
     "access_denied",
     "application_declaration_mismatch",
     "application_identity_unavailable",
@@ -86,6 +102,7 @@ export const AUTHORIZATION_PROBLEM_CODES = [
 ];
 export const NOTIFICATION_PROBLEM_CODES = [
     ...REGISTRATION_PROBLEM_CODES,
+    "notification_grant_reauthorization_required",
     "authorization_expired",
     "invalid_operation_response",
     "invalid_push_subscription",

package/dist/query-pagination-internals.d.ts

@@ -1,7 +1,7 @@
 /** Owns the latest single-use cursor, including while an iterator is paused at yield. */
 export declare function queryCursorLease(release: (cursor: string) => Promise<void>, signal?: AbortSignal, initialCursor?: string): {
     startRequest(): void;
-    finishRequest(nextCursor?: string): void;
+    finishRequest(nextCursor: string | undefined, succeeded: boolean): void;
     dispose(): void;
 };
 export declare function resultCap(value?: number): number;

package/dist/query-pagination-internals.js

@@ -19,8 +19,10 @@ export function queryCursorLease(release, signal, initialCursor) {
     signal?.addEventListener("abort", abort, { once: true });
     return {
         startRequest() { inFlight = true; },
-        finishRequest(nextCursor) {
-            if (nextCursor)
+        finishRequest(nextCursor, succeeded) {
+            // A successful continuation consumes the previous token, including on the
+            // terminal page. Failures retain it for best-effort cleanup.
+            if (succeeded)
                 cursor = nextCursor;
             inFlight = false;
             if (signal?.aborted)

package/dist/query-pagination.js

@@ -62,7 +62,7 @@ export async function* coordinatedQueryPages(query, releaseQueryCursor, input =
                     offset
                 }, pageRequestOptions);
             }
-            lease.finishRequest(queried.ok ? queried.value.meta?.cursor : undefined);
+            lease.finishRequest(queried.ok ? queried.value.meta?.cursor : undefined, queried.ok);
             if (options.signal?.aborted)
                 return;
             if (!queried.ok) {

package/dist/query-wire.d.ts

@@ -31,21 +31,27 @@ export declare function wireQueryInput(input: QueryInput | QueryMetadataInput):
         };
     } | undefined;
     where?: string | undefined;
-    select?: (string | {
-        name: string;
-        expr: string;
-        label?: string | undefined;
-        description?: string | undefined;
-    })[] | undefined;
-    order_by?: import("./operation-types.js").QueryOrder[] | undefined;
-    group_by?: import("./operation-types.js").QueryOrder[] | undefined;
+    select?: string[] | undefined;
+    order_by?: {
+        direction?: "asc" | "desc";
+        field: string;
+    }[] | undefined;
+    group_by?: {
+        direction?: "asc" | "desc";
+        field: string;
+    }[] | undefined;
     summary_functions?: {
         [k: string]: {
             expr: string;
             description?: string | undefined;
         };
     } | undefined;
-    summaries?: import("./operation-types.js").QuerySummary[] | undefined;
+    summaries?: {
+        function: string;
+        name?: string;
+        label?: string;
+        field: string;
+    }[] | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     pagination?: "cursor" | undefined;
@@ -57,5 +63,5 @@ export declare function wireQueryInput(input: QueryInput | QueryMetadataInput):
 };
 export declare function wireDataContractIdentity(value: WireIdentity): DataContractViewIdentity;
 export declare function wireQueryRecord<Frontmatter extends JsonObject>(value: WireQueryRecord<Frontmatter>): QueryRecord<Frontmatter>;
-export declare function wireQueryResult<Frontmatter extends JsonObject>(value: WireQueryResult<Frontmatter>, output: "metadata" | undefined): QueryResult<Frontmatter> | QueryMetadataResult;
+export declare function wireQueryResult<Frontmatter extends JsonObject>(value: WireQueryResult<Frontmatter>, output: "metadata" | undefined, input?: QueryInput | QueryMetadataInput): QueryResult<Frontmatter> | QueryMetadataResult;
 export declare function wireCollectionDescription(value: WireDescription): CollectionDescription;

package/dist/query-wire.js

@@ -1,32 +1,57 @@
 import { authorityCapabilities } from "./authority-features.js";
 import { connectError } from "./errors.js";
+// beta.126's typed QueryRequest accepts only string selections. Lower named
+// expressions to ordinary projections, which both legacy and current hosts
+// accept. Private aliases avoid overwriting user projections or literal fields.
+function querySelections(input) {
+    const projections = { ...input.projections };
+    const aliases = new Map();
+    const occupied = new Set([
+        ...Object.keys(projections),
+        ...(input.select ?? []).filter((s) => typeof s === "string").map(s => s.replace(/^projection\./, ""))
+    ]);
+    const select = input.select?.map((selection, index) => {
+        if (typeof selection === "string")
+            return selection;
+        let alias = `connect_select_${index}`;
+        while (occupied.has(alias))
+            alias += "_";
+        occupied.add(alias);
+        // Selections run after filtering; don't evaluate them on rejected rows.
+        projections[alias] = { expression: input.where ? `(${input.where}) ? (${selection.expression}) : null` : selection.expression };
+        aliases.set(alias, selection.name);
+        return `projection.${alias}`;
+    });
+    const field = (name) => {
+        for (const [alias, original] of aliases)
+            if (original === name)
+                return alias;
+        return name;
+    };
+    return { projections, aliases, select, field };
+}
 export function wireQueryInput(input) {
+    const selection = querySelections(input);
     return {
         ...(input.output ? { output: input.output } : {}),
         ...(input.types ? { types: input.types } : {}),
         ...(input.timezone ? { timezone: input.timezone } : {}),
         ...(input.context ? { context: input.context } : {}),
-        ...(input.projections ? {
-            projections: Object.fromEntries(Object.entries(input.projections).map(([name, projection]) => [
+        ...(Object.keys(selection.projections).length ? {
+            projections: Object.fromEntries(Object.entries(selection.projections).map(([name, projection]) => [
                 name, { expr: projection.expression, ...(projection.description ? { description: projection.description } : {}) }
             ]))
         } : {}),
         ...(input.where ? { where: input.where } : {}),
-        ...(input.select ? {
-            select: input.select.map(selection => typeof selection === "string" ? selection : {
-                name: selection.name, expr: selection.expression,
-                ...(selection.label ? { label: selection.label } : {}),
-                ...(selection.description ? { description: selection.description } : {})
-            })
-        } : {}),
-        ...(input.orderBy ? { order_by: input.orderBy } : {}),
-        ...(input.groupBy ? { group_by: input.groupBy } : {}),
+        ...(selection.select ? { select: selection.select } : {}),
+        ...(input.orderBy ? { order_by: input.orderBy.map(order => ({ ...order, field: selection.field(order.field) })) } : {}),
+        ...(input.groupBy ? { group_by: input.groupBy.map(order => ({ ...order, field: selection.field(order.field) })) } : {}),
         ...(input.summaryFunctions ? {
             summary_functions: Object.fromEntries(Object.entries(input.summaryFunctions).map(([name, projection]) => [
                 name, { expr: projection.expression, ...(projection.description ? { description: projection.description } : {}) }
             ]))
         } : {}),
-        ...(input.summaries ? { summaries: input.summaries } : {}),
+        ...(input.summaries ? { summaries: input.summaries.map(summary => ({ ...summary, field: selection.field(summary.field) })) } : {}),
         ...(input.limit === undefined ? {} : { limit: input.limit }),
         ...(input.offset === undefined ? {} : { offset: input.offset }),
         ...(input.pagination ? { pagination: input.pagination } : {}),
@@ -65,10 +90,16 @@ function metadataRecord(value) {
         ...(value.contract ? { contract: wireDataContractIdentity(value.contract) } : {})
     };
 }
-export function wireQueryResult(value, output) {
+export function wireQueryResult(value, output, input) {
     if (!value || !Array.isArray(value.results) || value.output !== output) {
         throw connectError("invalid_operation_response", "The authority returned an invalid query output mode.");
     }
+    const aliases = input ? querySelections(input).aliases : new Map();
+    if (aliases.size)
+        value = { ...value, results: value.results.map(row => ({
+                ...row,
+                ...(row.values ? { values: Object.fromEntries(Object.entries(row.values).map(([key, entry]) => [aliases.get(key) ?? key, entry])) } : {})
+            })) };
     const meta = value.meta ? {
         ...(typeof value.meta.total_count === "number" ? { totalCount: value.meta.total_count } : {}),
         ...(value.meta.total_count_outcome === undefined ? {} : { totalCountOutcome: value.meta.total_count_outcome }),

package/dist/read-many.js

@@ -3,7 +3,9 @@ import { MdbaseConnectError, connectError, connectProblem } from "./errors.js";
 import { COLLECTION_QUERY_PROBLEM_CODES, captureConnectOutcome, connectFailure, connectSuccess } from "./outcomes.js";
 import { requestOptionsWithinBudget, withRequestBudget } from "./request-budget.js";
 export async function readMany(queryAll, readDocuments, supports, paths, options, defaultTimeoutMs) {
-    const requestedBatchSize = boundedInteger(options.batchSize ?? 100, 1_000, "batchSize");
+    if (options.revisions !== undefined && typeof options.revisions !== "boolean")
+        throw new TypeError("revisions must be boolean.");
+    const requestedBatchSize = boundedInteger(options.batchSize ?? (options.revisions === false ? 1_000 : 100), 1_000, "batchSize");
     const concurrency = boundedInteger(options.concurrency ?? 4, 4, "concurrency");
     if (options.coordination?.latestWins)
         throw new TypeError("readMany batches cannot use latestWins coordination.");
@@ -32,7 +34,7 @@ export async function readMany(queryAll, readDocuments, supports, paths, options
                 while (!budget.signal.aborted && nextPath < unique.length) {
                     // Recheck cached lifetime evidence at each admission: queued work must
                     // not borrow a retired route's support after reconnect/reauthorization.
-                    const support = await supports?.("read-many-documents-v1", requestOptions);
+                    const support = options.revisions === false ? undefined : await supports?.("read-many-documents-v1", requestOptions);
                     if (support && !support.ok) {
                         nextPath = unique.length;
                         throw new MdbaseConnectError(support.problem);

package/dist/runtime-utils.d.ts

@@ -1,5 +1,5 @@
 import type { FileCapability, GrantEncryption, GrantScope } from "@mdbase-dev/connect-protocol";
-import type { MdbaseApplicationManifest as MdbaseAppManifest } from "./application-contract.js";
+import type { MdbaseApplicationManifest as MdbaseAppManifest } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnectError } from "./errors.js";
 import type { StoredToken } from "./internal-types.js";
 import type { MdbaseDeviceAuthorization } from "./connection-types.js";

package/dist/saved-view-pagination.js

@@ -25,7 +25,7 @@ export async function* coordinatedSavedViewPages(executeView, releaseQueryCursor
                 timeoutMs: options.pageTimeoutMs,
                 coordination: { ...options.coordination, coalesce: false }
             });
-            lease.finishRequest(outcome.ok ? outcome.value.meta.cursor : undefined);
+            lease.finishRequest(outcome.ok ? outcome.value.meta.cursor : undefined, outcome.ok);
             if (options.signal?.aborted)
                 return;
             if (!outcome.ok) {

package/dist/session.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionOperation, ConnectProblem, JsonObject } from "@mdbase-dev/connect-protocol";
-import { type MdbaseApplicationManifest, type MdbaseApplicationCapabilityId as ApplicationCapabilityId } from "./application-contract.js";
+import { type MdbaseApplicationManifest, type MdbaseApplicationCapabilityId as ApplicationCapabilityId } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnection, type MdbaseAuthorizationOutcome, type MdbaseAuthorizationResult, type MdbaseAuthorizeOptions } from "./connection.js";
 import type { MdbaseAuthorizationCapabilities, MdbaseConnectionInfo } from "./connection-types.js";
 import { type AuthorizationProblemCode, type RegistrationProblemCode, type ConnectOutcome, type SessionProblemCode } from "./outcomes.js";

package/dist/session.js

@@ -1,5 +1,5 @@
 import { APPLICATION_CAPABILITY_DEFINITIONS, capabilityOperationsForContractVersion } from "@mdbase-dev/connect-protocol";
-import { retainedCapabilities, semanticContractVersion, validateAuthorizationSelection } from "./application-contract.js";
+import { retainedCapabilities, semanticContractVersion, validateAuthorizationSelection } from "@mdbase-dev/connect-protocol";
 import { authorizationCallbackState, authorizationReturnToFromProblem, isAuthorizationCallbackUrl } from "./authorization-url.js";
 import { MdbaseConnectError, connectProblem } from "./errors.js";
 import { DEFAULT_OPERATIONS } from "./internal-types.js";

package/dist/structured-readiness.d.ts

@@ -1,5 +1,5 @@
 import type { ContractRequirement, FileAction, JsonObject } from "@mdbase-dev/connect-protocol";
-import type { MdbaseApplicationManifest } from "./application-contract.js";
+import type { MdbaseApplicationManifest } from "@mdbase-dev/connect-protocol";
 import type { MdbaseConnectionInfo } from "./connection-types.js";
 import { type MdbaseEffectiveCapabilities, type MdbaseCapabilityEvidence } from "./capabilities.js";
 import type { MdbaseConnection } from "./connection.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mdbase-dev/connect",
-  "version": "0.1.0-beta.126",
+  "version": "0.1.0-beta.147",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,10 @@
     "./crypto": {
       "types": "./dist/crypto-entry.d.ts",
       "import": "./dist/crypto-entry.js"
+    },
+    "./timers": {
+      "types": "./dist/control-timers.d.ts",
+      "import": "./dist/control-timers.js"
     }
   },
   "files": [
@@ -33,7 +37,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mdbase-dev/connect-protocol": "0.1.0-beta.126"
+    "@mdbase-dev/connect-protocol": "0.1.0-beta.147"
   },
   "devDependencies": {
     "esbuild": "^0.28.1",

package/dist/application-contract.d.ts

@@ -1,22 +0,0 @@
-import { type ApplicationCapabilityId, type ApplicationCapabilityRequirements, type LegacyApplicationCapabilityRequirements, type LegacyApplicationCapabilityId, type ApplicationRequirements, type LegacyApplicationRequirements, type MdbaseAppManifest, type LegacyMdbaseAppManifest, type CollectionOperation } from "@mdbase-dev/connect-protocol";
-export declare const DEFAULT_OPERATIONS: CollectionOperation[];
-/** SDK input compatibility boundary; protocol ApplicationRequirements remains v2-only. */
-export type MdbaseApplicationManifest = MdbaseAppManifest | LegacyMdbaseAppManifest;
-export type MdbaseApplicationRequirements = ApplicationRequirements | LegacyApplicationRequirements;
-export type MdbaseApplicationCapabilityRequirements = ApplicationCapabilityRequirements | LegacyApplicationCapabilityRequirements;
-export type MdbaseApplicationCapabilityId = ApplicationCapabilityId | LegacyApplicationCapabilityId;
-interface MdbaseAuthorizationSelection {
-    operations?: CollectionOperation[];
-    capabilities?: MdbaseApplicationCapabilityId[];
-}
-export declare function semanticContractVersion(requirements: MdbaseApplicationRequirements): 1 | 2;
-export declare function invalidAuthorizationSelection(message: string): never;
-export declare function validateAuthorizationSelection(requirements: MdbaseApplicationRequirements, options: MdbaseAuthorizationSelection): void;
-export declare function declaredOperations(requirements: MdbaseApplicationRequirements): CollectionOperation[];
-export declare function authorizationOperations(application: {
-    requirements: MdbaseApplicationRequirements;
-    provisions?: MdbaseApplicationManifest["provisions"];
-}, options: MdbaseAuthorizationSelection): CollectionOperation[];
-export declare function retainedCapabilities(requirements: MdbaseApplicationRequirements, operations: CollectionOperation[]): MdbaseApplicationCapabilityId[];
-export declare function authorizationFiles(requirements: MdbaseApplicationRequirements): import("@mdbase-dev/connect-protocol").ApplicationFileRequest | undefined;
-export {};

package/dist/application-contract.js

@@ -1,75 +0,0 @@
-import { APPLICATION_SETUP_OPERATIONS, applicationFileRequest, capabilityOperationsForContractVersion } from "@mdbase-dev/connect-protocol";
-import { connectError } from "./errors.js";
-export const DEFAULT_OPERATIONS = ["describe", "changes", "read", "query"];
-export function semanticContractVersion(requirements) {
-    const version = requirements.capabilities === undefined ? 1 : requirements.capabilities?.contract_version;
-    if (version !== 1 && version !== 2)
-        invalidAuthorizationSelection("Unsupported declared capability contract version.");
-    return version;
-}
-export function invalidAuthorizationSelection(message) {
-    throw connectError("invalid_application_manifest", message, {
-        details: { issues: [{ path: "/requirements/capabilities", keyword: "authorizationSelection", message, params: {} }] }
-    });
-}
-export function validateAuthorizationSelection(requirements, options) {
-    if (options.operations !== undefined && options.capabilities !== undefined) {
-        invalidAuthorizationSelection("Specify operations or capabilities, not both.");
-    }
-    if (options.operations !== undefined && semanticContractVersion(requirements) !== 1) {
-        invalidAuthorizationSelection("Exact operations authorization is only supported for legacy v1 declarations.");
-    }
-    if (options.capabilities !== undefined) {
-        const declared = new Set([
-            ...(requirements.capabilities?.required ?? []),
-            ...(requirements.capabilities?.optional ?? [])
-        ]);
-        if (options.capabilities.some((id) => !declared.has(id)
-            || capabilityOperationsForContractVersion(semanticContractVersion(requirements), id) === undefined)) {
-            invalidAuthorizationSelection("Authorization can only include capabilities declared by the application.");
-        }
-    }
-}
-export function declaredOperations(requirements) {
-    const capabilities = requirements.capabilities;
-    if (!capabilities)
-        return [...DEFAULT_OPERATIONS];
-    return [...new Set([...capabilities.required, ...(capabilities.optional ?? [])].flatMap((id) => capabilityOperationsForContractVersion(capabilities.contract_version, id) ?? []))];
-}
-export function authorizationOperations(application, options) {
-    const { requirements } = application;
-    validateAuthorizationSelection(requirements, options);
-    // Legacy callers selected independent exact operations, including subsets of declarations.
-    if (semanticContractVersion(requirements) === 1) {
-        if (options.operations !== undefined)
-            return [...new Set(options.operations)];
-        if (options.capabilities === undefined)
-            return [...DEFAULT_OPERATIONS];
-    }
-    const declared = requirements.capabilities;
-    const selected = [...(declared?.required ?? []), ...(options.capabilities ?? declared?.optional ?? [])];
-    const operations = selected.flatMap((id) => capabilityOperationsForContractVersion(semanticContractVersion(requirements), id) ?? []);
-    const hasSetup = (application.provisions?.type_packs.length ?? 0) > 0
-        || (application.provisions?.configuration?.length ?? 0) > 0;
-    return [...new Set([
-            ...operations,
-            ...(semanticContractVersion(requirements) === 2 && hasSetup ? APPLICATION_SETUP_OPERATIONS : [])
-        ])];
-}
-export function retainedCapabilities(requirements, operations) {
-    return [...(requirements.capabilities?.required ?? []), ...(requirements.capabilities?.optional ?? [])].filter((id) => (capabilityOperationsForContractVersion(semanticContractVersion(requirements), id) ?? []).every((operation) => operations.includes(operation)));
-}
-export function authorizationFiles(requirements) {
-    const files = requirements.files;
-    if (!files)
-        return undefined;
-    if (semanticContractVersion(requirements) === 1) {
-        if (!("actions" in files) || "required" in files || "optional" in files) {
-            invalidAuthorizationSelection("Legacy file declarations must use exact files.actions.");
-        }
-        return { actions: [...files.actions], scope: structuredClone(files.scope) };
-    }
-    if ("actions" in files)
-        invalidAuthorizationSelection("V2 file declarations must use required/optional file actions.");
-    return applicationFileRequest(files);
-}