@mdbase-dev/sdk 0.0.0-stage → 0.1.0-beta.153

package/dist/describe-error.js

@@ -0,0 +1,452 @@
+/**
+ * Shared user-facing copy for SDK errors, sign-in/open problems and readiness.
+ *
+ * Plain language plus one suggested action. Never returns raw codes, server
+ * messages or exception text. English by default; pass `messages` to
+ * translate by `key`. No Worker, wasm or network imports, so it is safe in any
+ * bundle. Every server-provided field is untrusted: only known codes select
+ * copy, retry delays are clamped and update links are allowlisted.
+ *
+ * The problem vocabulary is closed: `ProblemCode` lists every code an app can
+ * meet, and `COPY` must give each one plain copy (checked by the compiler).
+ * Other SDK codes either alias a ProblemCode or are internal (described by
+ * their `MdbaseError` code); a source-scan test fails on any unclassified code.
+ */
+import { registrationRefusal, registrationRefusalMessage } from "./application/registration-refusal.js";
+import { isCollectionUnavailableReason } from "./collection-availability.js";
+import { DEFAULT_UPDATE_URL, MAX_SERVER_RETRY_MS, MIN_SERVER_RETRY_MS, sanitizeAppServerProblem, trustedUpdateUrl } from "./app-host/cp-problem.js";
+const LABELS = {
+    retry: "Try again", wait: null, reload: "Reload", sign_in: "Sign in", approve: "Approve",
+    choose_collection: "Choose a collection", set_up: "Set up", update_app: "Update the app",
+    free_space: "Manage storage", check_connection: "Try again", resolve_outcome: "Check and try again",
+    contact_support: "Contact support", none: null,
+};
+/** Every problem code an app can meet. Each has plain copy in COPY. */
+export const PROBLEM_CODES = [
+    // Collection availability.
+    "device_offline", "desktop_update_required", "old_connector_running", "sync_required", "no_device_registered",
+    "access_removed", "read_only", "capability_missing", "collection_deleted", "collection_unavailable", "moved_to_next_runtime", "device_approval_required",
+    // Server outcomes.
+    "collection_migrating", "collection_not_yet_migrated", "account_suspended", "update_required", "account_collection_quota_exceeded",
+    // MdbaseError codes (the 15).
+    "invalid_request", "invalid_record", "not_found", "conflict", "unauthenticated", "forbidden", "collection_invalid",
+    "unavailable", "rate_limited", "quota_exceeded", "too_large", "outcome_unknown", "internal",
+    // Sign-in, open and sign-out.
+    "refused", "expired", "approval_window_closed", "account_confirmation_required", "recovery_required", "open_failed",
+    "busy", "open_in_another_tab", "not_authorized", "sign_out_pending_writes", "sign_out_failed",
+    // Application entry.
+    "application_popup_blocked", "sign_in_window", "application_not_yet_available", "application_failed",
+    "application_worker_unavailable", "browser_unsupported", "application_storage_unavailable", "storage_may_be_evicted",
+    "application_registration_unsupported", "application_registration_refused",
+    "application_selection_not_approved", "application_selection_invalid", "installation_scope_removed", "recovery_account_mismatch", "assets",
+    // Readiness.
+    "setup_required", "incompatible", "approval_required", "contract_mismatch", "contract_missing", "implementation_missing",
+    "catalog_invalid", "catalog_response", "type_invalid", "readiness_budget", "readiness_unsupported",
+    "notifications_consent_required", "timer_channel_reapproval_required", "notifications_unsupported",
+    "people_unsupported", "people_permission_declined", "people_access",
+    "configuration_conflict", "configuration_unavailable", "configuration_unsupported", "configuration_busy_timeout", "readiness_busy_timeout",
+    // Setup review.
+    "setup_forbidden", "setup_conflict", "setup_unresolved", "collection_setup_conflict", "setup_records_forbidden", "setup_changed", "installed_newer",
+    "type_pack_conflict", "invalid_type_pack",
+    // Optional file actions.
+    "access_required", "access_declined", "access_undeclared", "files_access_missing", "files_scope_missing", "file_read_failed", "file_read_idle",
+    // Collection delete.
+    "collection_delete_name_mismatch", "collection_delete_not_owner", "collection_delete_not_found", "collection_delete_frozen",
+    "collection_delete_busy", "collection_delete_not_approved", "collection_delete_sign_in", "collection_delete_invalid",
+    "collection_delete_outcome_unknown", "collection_delete_failed",
+    // Account keys (Private collections).
+    "wrong_secret", "locked", "weak_password", "already_set_up", "no_account_key",
+];
+const GENERIC = ["Something went wrong", "An unexpected problem occurred. Reload the app, and contact support if it keeps happening.", "reload", "error"];
+const BUSY = ["Another step hasn't finished", "The app couldn't finish this step yet. Try again, or reload if it keeps happening.", "retry", "warning", true];
+const OFFLINE = ["Can't connect right now", "mdbase couldn't be reached. Check your connection and try again.", "check_connection", "warning"];
+const UPDATE = ["Update required", "Update mdbase on this computer, then reload the app to try again.", "update_app", "warning", false, "Update mdbase"];
+const CHOOSE = ["Choose a collection", "Pick the collection you want this app to use.", "choose_collection", "info"];
+const APPROVE = ["Approval needed", "This app needs your approval for extra access to your collection.", "approve", "info"];
+const SET_UP = ["Set up this collection", "This collection needs a one-time setup before the app can use it.", "set_up", "info"];
+const COPY = {
+    // Private collections served by one of the account's computers (collection availability).
+    device_offline: ["Your computer isn't online", "This collection is kept on your computer. Open the mdbase desktop app on a computer that has it, and this app connects as soon as it's online.", "wait", "info", true],
+    desktop_update_required: ["Update mdbase on your computer", "The mdbase desktop app on the computer that has this collection is out of date. Update it there, then try again.", "update_app", "warning", false, "Get the update"],
+    old_connector_running: ["Quit the old mdbase Connect app", "The old mdbase Connect app is still running on the computer that has this collection. Quit it there (including its menu-bar or tray icon), then open the mdbase desktop app.", "retry", "warning"],
+    sync_required: ["Give this app access again", "Access to this collection changed since you approved this app. Approve it again to keep using the collection.", "approve", "warning", false, "Approve again"],
+    no_device_registered: ["Turn on sync for this collection", "No computer is offering this collection to apps. Open the mdbase desktop app on the computer that has it and turn on sync. Web apps can reach a collection once sync is on.", "retry", "info"],
+    installation_scope_removed: ["Access was removed", "This app's previous installation cannot regain access to this collection. Request access again to approve a new installation for this collection. Your other collections keep their access.", "approve", "warning", false, "Request access again"],
+    access_removed: ["You no longer have access", "You were removed from this collection, so this app can't open it. Ask its owner to add you again, or choose another collection.", "choose_collection", "warning"],
+    collection_deleted: ["Collection deleted", "This collection was deleted, so it can't be opened any more. Choose another collection.", "choose_collection", "info"],
+    collection_unavailable: ["Collection not available", "This collection can't be opened from this app right now. It may no longer be shared with this app, or the computer that offered it stopped. Choose another collection, or try again later.", "choose_collection", "warning"],
+    moved_to_next_runtime: ["mdbase was upgraded", "This collection now uses the new version of mdbase. Update the app to keep using it; for a web app, reloading the page is enough. If the collection still doesn't appear, open the mdbase desktop app and turn on sync for it so web apps can reach it.", "update_app", "warning"],
+    // `approval_required` (readiness) means approval in the portal; this one means on a computer.
+    device_approval_required: ["Waiting for your computer", "Keep a computer with this collection running mdbase and signed in. This app connects when it is ready.", "wait", "info", true],
+    collection_not_yet_migrated: ["Your collection needs an upgrade", "Your data is safe. Open the latest mdbase desktop app on the computer that keeps this collection to finish upgrading it, then try again.", "retry", "info"],
+    collection_migrating: ["Your collection is being upgraded", "Your data is safe. This usually takes a few minutes, and the app reconnects by itself when it's done.", "wait", "info", true],
+    account_suspended: ["Your account is suspended", "Your mdbase account has been suspended, so this app can't open your collections. Contact mdbase support for help.", "contact_support", "error"],
+    update_required: UPDATE,
+    invalid_request: ["Couldn't do that", "Some of the information isn't valid. Check it and try again.", "none", "warning"],
+    invalid_record: ["Couldn't save that", "Some fields aren't valid. Check them and try again.", "none", "warning"],
+    not_found: ["Not found", "This item no longer exists. It may have been deleted on another device.", "none", "info"],
+    conflict: ["Changed somewhere else", "This item was changed on another device. Review the latest version and try again.", "retry", "warning"],
+    unauthenticated: ["Sign in again", "Your session has ended. Sign in again to continue.", "sign_in", "warning"],
+    read_only: ["View access only", "You have view access, so changes can't be saved. Ask the collection's owner for edit access.", "none", "warning"],
+    forbidden: ["Access needed", "This app doesn't have permission to do that. Approve access to continue.", "approve", "warning"],
+    collection_invalid: ["Your collection needs repair", "Something in this collection isn't valid. Contact support if this keeps happening.", "contact_support", "error"],
+    unavailable: OFFLINE,
+    rate_limited: ["Too many requests", "Wait a moment, then try again.", "retry", "warning", true],
+    quota_exceeded: ["Out of storage", "Your collection has reached its storage limit. Free up space to keep saving.", "free_space", "error"],
+    account_collection_quota_exceeded: ["Synced collection limit reached", "Your account has reached its synced collection limit. Delete a synced collection before creating another.", "free_space", "error", false, "Manage collections"],
+    too_large: ["That's too large", "This item is larger than mdbase allows.", "none", "warning"],
+    outcome_unknown: ["Not sure that worked", "The connection dropped before mdbase confirmed it. Check whether it went through before trying again.", "resolve_outcome", "warning"],
+    internal: GENERIC,
+    refused: ["Sign-in didn't go through", "mdbase didn't accept this sign-in. Try signing in again.", "sign_in", "warning"],
+    expired: ["Sign-in timed out", "The sign-in request expired. Start again to get a new one.", "sign_in", "warning"],
+    approval_window_closed: ["Sign-in wasn't finished", "The mdbase window was closed before access was approved. Sign in again to continue.", "sign_in", "info"],
+    account_confirmation_required: ["Confirm your account", "Confirm which mdbase account to use, then continue.", "sign_in", "info"],
+    recovery_account_mismatch: ["Use a different account", "Sign in with the account you originally used for this collection to continue.", "approve", "info", false, "Use a different account"],
+    recovery_required: ["Reload required", "The app stopped to keep your data safe. Reload to continue.", "reload", "error"],
+    open_failed: ["Couldn't open your collection", "Something went wrong while opening it. Reload the app to try again.", "reload", "error"],
+    busy: BUSY,
+    file_read_failed: ["Couldn't load the file", "mdbase couldn't finish downloading this file. Check your connection and try opening the collection again.", "retry", "warning"],
+    file_read_idle: ["File download timed out", "The file download stopped making progress. Try opening the collection again.", "retry", "warning"],
+    configuration_busy_timeout: ["Collection setup is taking too long", "The app is waiting for another setup or metadata request to finish. Try again; if it keeps happening, close other tabs of this app and reload.", "retry", "warning"],
+    readiness_busy_timeout: ["Collection checks are taking too long", "The app couldn't get a stable view of the collection yet. Try again when the other step has finished.", "retry", "warning"],
+    open_in_another_tab: ["Open in another tab", "This app is already open in another tab. Close that tab, or keep using it there; this tab continues by itself when it's free.", "none", "info", true],
+    not_authorized: ["This app can't open this collection", "This app isn't allowed to open this collection. Approve it again, or choose another collection.", "approve", "warning", false, "Approve again"],
+    sign_out_pending_writes: ["Changes are still saving", "Some changes haven't reached mdbase yet. Wait for them to finish, or sign out anyway and lose them on this device.", "wait", "warning", false, "Wait"],
+    sign_out_failed: ["Couldn't finish signing out", "This device couldn't remove all of its sign-in data. Reload the app and sign out again.", "reload", "error"],
+    application_popup_blocked: ["Allow pop-ups to sign in", "Your browser blocked the sign-in window. Allow pop-ups for this site, then try again.", "retry", "warning"],
+    sign_in_window: ["Sign-in window problem", "The sign-in window couldn't be opened. Try again.", "retry", "warning"],
+    application_not_yet_available: ["Not available yet", "This app isn't available on this version of mdbase yet.", "none", "info"],
+    application_failed: ["The app stopped", "Something inside the app stopped working. Your data is safe. Reload to continue.", "reload", "error"],
+    application_worker_unavailable: ["This browser can't run the app", "Open the app in a current version of Chrome, Edge, Firefox or Safari.", "none", "error"],
+    browser_unsupported: ["This browser can't run mdbase", "Update Safari to 17.4 or newer, Firefox to 130 or newer, or Chrome or Edge to 133 or newer, then open the app again.", "none", "error"],
+    application_storage_unavailable: ["This browser can't keep mdbase data on this device", "Private browsing may be on. Open the app in a regular window so your changes can be kept safely on this device.", "none", "error"],
+    storage_may_be_evicted: ["Not synced yet", "Some changes are only on this device. Stay online so they can sync.", "check_connection", "warning"],
+    application_registration_unsupported: ["This app can't connect", "This version of the app isn't supported by mdbase. Update the app.", "update_app", "error"],
+    application_registration_refused: ["This app can't connect", "This app can't connect right now. Contact the app's developer.", "contact_support", "error"],
+    application_selection_not_approved: ["Collection not approved", "This app hasn't been given access to that collection. Approve it to continue.", "approve", "info"],
+    application_selection_invalid: CHOOSE,
+    assets: ["The app couldn't load", "Some of the app's files couldn't be loaded. Check your connection and reload.", "reload", "error"],
+    setup_required: SET_UP,
+    incompatible: ["This collection isn't compatible", "This collection uses a format this version of the app doesn't support. Update the app.", "update_app", "error"],
+    approval_required: APPROVE,
+    capability_missing: APPROVE,
+    contract_mismatch: ["Your collection's format differs", "This collection's record types don't match what this app expects. Set it up again or update the app.", "set_up", "warning"],
+    contract_missing: ["Set up this collection", "This collection is missing record types this app needs. Set it up to continue.", "set_up", "info"],
+    implementation_missing: ["Set up this collection", "A record type in this collection doesn't provide the fields this app needs. Set it up to continue.", "set_up", "info"],
+    catalog_invalid: ["A definition has a problem", "A definition in this collection has an error, so the app can't open the collection safely. Fix the definition in your collection, and the app picks up the change.", "none", "warning"],
+    catalog_response: ["Couldn't read this collection's definitions", "The app couldn't read how this collection is defined, so it didn't open it. Nothing was changed. Try again.", "retry", "warning"],
+    type_invalid: ["A record type isn't available", "This record type has an error in its definition, so the app can't use it right now. Everything else still works. Fix the type in your collection to use it again.", "none", "warning"],
+    readiness_budget: ["This collection is too large to check", "This collection has more definitions than the app can check at once. Contact the app's developer.", "contact_support", "warning"],
+    readiness_unsupported: ["Update the app", "This collection uses features this version of the app can't check. Update the app to open it.", "update_app", "warning"],
+    notifications_consent_required: ["Allow reminders", "Approve notifications so reminders can reach this device.", "approve", "info"],
+    timer_channel_reapproval_required: ["Allow reminders again", "Approve notifications again so reminders keep reaching this device.", "approve", "info"],
+    notifications_unsupported: ["Reminders aren't available here", "This browser or device can't receive notifications.", "none", "info"],
+    people_unsupported: ["Sharing isn't available here", "People and sharing aren't supported for this collection yet.", "none", "info"],
+    people_permission_declined: ["People aren't shown", "This app wasn't allowed to see who else is in this collection. Approve it again and allow people to show them here.", "approve", "info", false, "Approve again"],
+    people_access: ["People can't be shown", "This app can't see the people in this collection right now. Everything else still works.", "none", "info"],
+    configuration_conflict: ["Settings changed elsewhere", "These settings were changed on another device. Review them and try again.", "retry", "warning"],
+    // The collection's setup couldn't be assessed: not a network problem.
+    configuration_unavailable: ["Couldn't check this collection's setup", "The app couldn't read how this collection is set up, so it didn't open it. Nothing in the collection was changed. Try again, and contact support if it keeps happening.", "retry", "warning"],
+    configuration_unsupported: ["This app can't set up this collection", "This app's setup isn't supported by this version of mdbase. Contact the app's developer.", "contact_support", "warning"],
+    setup_forbidden: ["You can't set up this collection", "Your access to this collection doesn't allow setting it up. Ask its owner to open it in this app first.", "choose_collection", "warning"],
+    setup_conflict: ["Setup needs your decision", "Some things in this collection differ from what this app needs. Review them to continue.", "set_up", "warning", false, "Review setup"],
+    setup_unresolved: ["Setup can't finish", "This collection is missing something this app needs, and setup can't add it. A note type this app set up may have been changed or removed. Restore it, then try again.", "retry", "warning"],
+    collection_setup_conflict: ["Collection setup conflicts", "This collection's definitions conflict with what this app requires. Ask its owner to review them, or choose a different collection. Setup cannot continue while these conflicts remain.", "choose_collection", "warning"],
+    setup_records_forbidden: ["You can't add notes to this collection", "Your access to this collection doesn't allow creating notes, which this app's setup needs. Ask its owner for more access.", "choose_collection", "warning"],
+    setup_changed: ["This collection changed", "The collection changed while you were reviewing its setup. Review the setup again; nothing was changed yet.", "set_up", "info", false, "Review again"],
+    installed_newer: ["Update the app", "A newer version of this app set up this collection with changes this version can't use. Update the app to keep using the collection.", "update_app", "warning"],
+    type_pack_conflict: ["Setup needs your decision", "Some record types already exist with different content. Review them to continue.", "set_up", "warning", false, "Review setup"],
+    invalid_type_pack: ["This app's setup has a problem", "Setting up this collection would leave it invalid, so nothing was changed. Contact the app's developer.", "contact_support", "warning"],
+    // Optional file actions asked for at the moment of use (requestAccess).
+    access_required: ["Allow this app to change files?", "This app needs your permission before it can add or change files in this collection.", "approve", "info", false, "Allow"],
+    access_declined: ["Not allowed", "You chose not to allow this. Everything else in the app works as before, and you can allow it the next time you try.", "none", "info"],
+    access_undeclared: ["This app can't do that", "This app isn't set up to change files this way. Contact the app's developer if you need it.", "none", "warning"],
+    files_access_missing: ["This app can't use this collection", "Your access to this collection doesn't include the file changes this app needs. Ask the collection's owner for more access.", "none", "warning"],
+    files_scope_missing: ["This app can't use this collection", "This app needs access to all files in this collection, but your access covers only some folders. Ask the collection's owner for more access.", "none", "warning"],
+    collection_delete_name_mismatch: ["The name doesn't match", "Type the collection's current name exactly to delete it.", "none", "warning"],
+    collection_delete_not_owner: ["Only the owner can delete this", "Ask the collection's owner to delete it.", "none", "info"],
+    collection_delete_not_found: ["Collection not found", "This collection no longer exists, or this app can't reach it. It may already have been deleted.", "none", "info"],
+    collection_delete_frozen: ["Can't delete right now", "Your account is being upgraded, so collections can't be deleted until that finishes. Try again later.", "retry", "warning"],
+    collection_delete_busy: ["mdbase is busy", "Wait a moment, then try deleting again.", "retry", "warning", true],
+    collection_delete_not_approved: ["This app can't delete this collection", "This app doesn't have access to this collection anymore. Approve it again, then try again.", "approve", "warning"],
+    collection_delete_sign_in: ["Sign in again", "This device's sign-in is no longer current. Sign in again, then try deleting again.", "sign_in", "warning"],
+    collection_delete_invalid: ["Couldn't delete the collection", "Check the name you typed and try again.", "none", "warning"],
+    collection_delete_outcome_unknown: ["Not sure the collection was deleted", "The connection dropped before mdbase confirmed. Reload your collections to check before trying again.", "resolve_outcome", "warning"],
+    collection_delete_failed: ["Couldn't delete the collection", "Something went wrong. Try again, and contact support if it keeps happening.", "retry", "error"],
+    wrong_secret: ["That isn't right", "The password or recovery key doesn't match. Check it and try again.", "none", "warning"],
+    locked: ["Too many attempts", "Wait a few minutes before trying again.", "wait", "warning", true],
+    weak_password: ["Choose a stronger password", "That password is too easy to guess. Use a longer one, or a few unrelated words.", "none", "warning"],
+    already_set_up: ["Already set up", "Your account key is already set up on this account.", "none", "info"],
+    no_account_key: ["Set up your account key", "This account doesn't have an account key yet. Set one up to use Private collections.", "none", "info"],
+};
+/** Codes that mean the same outcome as a ProblemCode (server reasons, facet
+ * and entry variants). Explicit: there is no suffix guessing. */
+const ALIASES = Object.assign(Object.create(null), {
+    no_device_online: "device_offline", collection_moved: "moved_to_next_runtime", client_update_required: "update_required",
+    upgrade_required: "update_required",
+    // Compatibility details can be published without their upgrade_required wrapper.
+    declared_setup_unsupported: "update_required", resource_setup_unsupported: "update_required",
+    type_packs_unsupported: "update_required", describe_definitions_unsupported: "update_required",
+    contract_records_unsupported: "update_required", record_links_unsupported: "update_required",
+    change_entity_unsupported: "update_required", timer_operation_recovery_unavailable: "update_required",
+    contract_query_version: "update_required", unsupported_push_version: "update_required",
+    // The SDK re-checks a concurrent change or an occupied step by itself.
+    fenced: "busy", reconnecting: "busy", application_busy: "busy", application_fenced: "busy", application_entry_fenced: "busy",
+    application_asset_fenced: "busy", application_connection_busy: "busy", application_connection_fenced: "busy",
+    application_readiness_busy: "busy", application_readiness_fenced: "busy", application_registration_fenced: "busy",
+    application_selection_busy: "busy", application_selection_fenced: "busy", application_worker_busy: "busy",
+    application_worker_fenced: "busy", application_popup_fenced: "busy", readiness_fenced: "busy", readiness_busy: "busy",
+    readiness_changed: "busy", configuration_busy: "busy", configuration_fenced: "busy", files_fenced: "busy",
+    people_fenced: "busy", people_readiness_busy: "busy", people_readiness_fenced: "busy",
+    notification_readiness_busy: "busy", notification_readiness_fenced: "busy", record_links_fenced: "busy",
+    // An internal invariant failed: the Worker, page and SDK stop safely.
+    binding: "application_failed", response: "application_failed", application_declaration: "application_failed",
+    application_connection_binding: "application_failed", application_popup_binding: "application_failed",
+    application_registration_response: "application_failed",
+    application_selection_binding: "application_failed", application_worker_binding: "application_failed",
+    application_worker_module_binding: "application_failed", application_entry_unavailable: "application_failed",
+    application_readiness_unavailable: "application_failed", configuration_binding: "application_failed",
+    configuration_response: "application_failed", files_unavailable: "application_failed",
+    application_stop_failed: "recovery_required", application_worker_stop_failed: "recovery_required",
+    application_popup_stop_failed: "recovery_required", configuration_recovery_required: "recovery_required",
+    application_popup_unavailable: "sign_in_window",
+    // Registration could not reach the CP: a connection problem.
+    application_registration_unavailable: "unavailable", application_registration_unknown: "unavailable",
+    application_connection_unavailable: "unavailable", readiness_unavailable: "unavailable",
+    grant_activation_timeout: "unavailable",
+    application_connection_people_unavailable: "people_access", people_unavailable: "people_access",
+    people_response: "people_access", people_binding: "people_access", people_budget: "people_access", people_incomplete: "people_access",
+    application_selection_empty: "application_selection_invalid", application_selection_duplicate: "application_selection_invalid",
+    application_selection_metadata: "application_selection_invalid",
+    application_lab_trust_unavailable: "assets", application_production_trust_unavailable: "assets",
+    application_release_trust_unavailable: "assets",
+    application_packaged_assets_unavailable: "assets", application_asset_fetch: "assets",
+    grant_required: "approval_required",
+    readiness_capability_version: "readiness_unsupported", readiness_type_invalid: "type_invalid",
+    configuration_not_authorized: "setup_forbidden", configuration_unsupported_source_provision: "configuration_unsupported",
+    setup_downgrade: "installed_newer", type_pack_downgrade: "installed_newer", installed_newer_major: "installed_newer",
+    timer_push_platform: "notifications_unsupported", push_registration_missing: "notifications_consent_required",
+});
+/** Readiness facets publish `readiness_<reason>`; some reasons need their own key. */
+const READINESS = Object.assign(Object.create(null), {
+    budget: "readiness_budget", unsupported: "readiness_unsupported",
+});
+/** Not problems: the SDK handled them, or the person chose them. describeError returns null. */
+export const NON_PROBLEM_CODES = ["application_registration_id_superseded", "application_closing", "cancelled", "aborted"];
+const NON_PROBLEMS = new Set(NON_PROBLEM_CODES);
+/** Published inventory of codec/protocol internals, test fakes and developer
+ * misuse. Previously exported compatibility details remain here for source
+ * compatibility; problemCodeOf and ALIASES now give those details update copy
+ * even when their MdbaseError wrapper is no longer available. */
+export const INTERNAL_PROBLEM_CODES = [
+    // CBOR / codec internals.
+    "duplicate_key", "float", "hash", "indefinite", "int", "mixed_map_keys", "non_canonical_head", "simple", "tag", "too_deep",
+    "too_long", "trailing_bytes", "tstr", "uint", "unencodable", "unexpected_end", "unsorted_keys", "utf8", "uuid", "value",
+    "unknown_method", "unknown_variant", "unsupported", "storage", "noise", "declared_setup_codec",
+    // In-memory test replica and contracts.
+    "body", "data_contract_ambiguous", "data_contract_field_conflict", "data_contract_field_unmapped", "data_contract_not_found",
+    "data_contract_not_implemented", "data_contract_promote_typed", "digest_mismatch", "invalid_type_definition", "path_taken",
+    "revision", "size_mismatch", "transfer_expired", "type_conflict",
+    // Developer misuse (invalid_request / invalid_record carry the copy).
+    "account_secret_length", "access_invalid", "access_no_collection", "application_sign_in_opener", "change_entity_unsupported",
+    "click_target_cross_origin", "context_required", "context_type_mismatch", "cursor_expired", "file_upload_identity_mismatch",
+    "invalid_autosave", "invalid_binding", "invalid_call", "invalid_push_payload", "invalid_sas", "invalid_scope",
+    "invalid_timeout", "invalid_timer_response", "invalid_typing_response", "invalid_validation_result", "invalid_view",
+    "key_id_changed", "read_many_bounds", "read_many_identity_mismatch", "read_many_selection", "record_identity_mismatch",
+    "record_lease_policy", "record_links_bounds", "record_links_missing", "record_links_response", "record_links_unsupported",
+    "record_recovery_mismatch", "record_session_budget", "record_validation_stale", "record_witness_required", "strength",
+    "strict_mode", "typing_bounds", "unsupported_push_version", "validation_bounds", "validation_selection",
+    // The build does not match the app's registration: apps describe this in
+    // their own words (describeError gives the "unknown" key so their copy wins).
+    "application_registration_binding",
+    "view_not_found", "view_source_changed", "view_source_witness_required", "bases_read_backpressure",
+    "contract_query_response", "contract_query_version", "contract_records_unsupported", "describe_definitions_unsupported",
+    "prefix_response", "type_pack_contract_setups_unsupported", "type_packs_unsupported", "resource_setup_unavailable",
+    "resource_setup_unsupported", "timer_operation_recovery_unavailable", "declared_setup_unsupported", "setup_outcome_unknown",
+    // Storage probe (describes as `unavailable`).
+    "cleanup_failed", "opfs_unavailable", "probe_failed", "sync_handle_unavailable", "worker_required",
+    // Owner lifecycle (wrapped as open_failed / recovery_required by the session).
+    "shutdown_failed",
+    // Thin-client, relay and app-grant transport (legacy Private path; wrapped as the 15).
+    "authorization_binding", "authorization_callback", "authorization_cancelled", "authorization_denied", "authorization_signature", "authorization_start",
+    "authorization_timed_out", "client_key_required", "collection_mismatch", "control_error",
+    "control_unreachable", "daemon_not_running", "grant_invalid", "grant_storage", "key_storage", "redirect_uri",
+    "relay_insecure", "relay_unauthenticated", "relay_unavailable", "relay_url", "route_mismatch", "token_error",
+    "token_response", "untrusted_identity",
+];
+const DEVELOPER = Object.assign(Object.create(null), {
+    device_offline: "Collection availability device_offline: no device serving this Private collection is connected to the relay.",
+    desktop_update_required: "Collection availability desktop_update_required: the serving device's last relay connection was refused as incompatible.",
+    old_connector_running: "Collection availability old_connector_running: the serving device reports a legacy connector still holding its collections.",
+    device_approval_required: "Collection availability approval_required: no device has signed an approval for this app's grant yet.",
+    sync_required: "Collection availability sync_required: the grant no longer matches the collection's membership; run authorize() again.",
+    no_device_registered: "Collection availability no_device_registered: Connect has no device that can serve this collection (none registered with sync on, or its device was revoked).",
+    installation_scope_removed: "The original installation lost this collection scope. Only explicit approval of a fresh scoped installation can regain access.",
+    access_removed: "Collection availability access_removed: the grant's account is no longer a member of the collection.",
+    collection_deleted: "Collection availability collection_deleted: the owner deleted the collection.",
+    collection_unavailable: "Connect problem collection_unavailable without a known reason: the collection is not offered to this app or client.",
+    moved_to_next_runtime: "Connect problem collection_unavailable, reason moved_to_next_runtime: a legacy route was used for a collection that completed its move to mdbase-next.",
+    people_permission_declined: "People members request refused (people_permission_declined): the person did not grant the people permission for this app.",
+    people_access: "People request refused (people_access).",
+    access_required: "access_required: an optional file action the person has not allowed. Call requestAccess from the user's action, then retry.",
+    access_undeclared: "access_undeclared: the file action is not in the manifest's requirements.files.",
+    installed_newer: "installed_newer: an installed type pack has a different major version than the one this app ships; same-major newer packs open read/write.",
+    application_registration_id_superseded: "The declared application ID is an earlier registration ID: mdbase registers each exact manifest under its own ID, so it changes with the manifest. The SDK uses the registered ID and keeps the declared storage names. Declare the manifest's logical `id` (stable across manifest changes and origins) with pinned storage names to remove this note.",
+    application_worker_unavailable: "application_worker_unavailable: this page cannot construct the SDK's module Worker (no Worker/MessageChannel, or a non-web origin).",
+    browser_unsupported: "browser_unsupported: the SDK's upfront capability probe found a required browser feature missing (Web Crypto/X25519, AbortSignal.any, Web Locks, BroadcastChannel, IndexedDB, Worker/MessageChannel or crypto.randomUUID); see the MdbaseError details for the missing tokens.",
+    application_storage_unavailable: "application_storage_unavailable: navigator.storage.getDirectory() (OPFS) is absent or rejected, as in private browsing; the local replica cannot be kept on this device.",
+    storage_may_be_evicted: "storage_may_be_evicted: replica edits are pending for at least 30 seconds or while disconnected on nonpersistent storage (snapshot.saveWarning); only a log-confirmed receipt counts as saved.",
+    sign_out_pending_writes: "sign_out_pending_writes: unconfirmed writes are still queued on this device; signOut({discard: true}) discards them.",
+});
+const NAME = /^[a-z][a-z0-9_-]{0,127}$/;
+const str = (v) => typeof v === "string" && NAME.test(v) ? v : null;
+const obj = (v) => v !== null && typeof v === "object" && !Array.isArray(v) ? v : null;
+const retry = (v) => typeof v === "number" && Number.isFinite(v) && v >= 0
+    ? Math.min(MAX_SERVER_RETRY_MS, Math.max(MIN_SERVER_RETRY_MS, Math.round(v))) : null;
+const isProblemCode = (code) => Object.hasOwn(COPY, code);
+/** The ProblemCode a code means, or null when it has none. */
+export function problemCodeOf(code) {
+    if (typeof code !== "string")
+        return null;
+    if (isProblemCode(code))
+        return code;
+    if (Object.hasOwn(ALIASES, code))
+        return ALIASES[code];
+    for (const prefix of ["readiness_", "application_"]) {
+        if (!code.startsWith(prefix))
+            continue;
+        const rest = code.slice(prefix.length);
+        if (prefix === "readiness_" && Object.hasOwn(READINESS, rest))
+            return READINESS[rest];
+        if (isProblemCode(rest))
+            return rest;
+        if (Object.hasOwn(ALIASES, rest))
+            return ALIASES[rest];
+    }
+    return null;
+}
+function availabilityReason(o) {
+    const details = o.details;
+    if (details instanceof Map && isCollectionUnavailableReason(details.get("availability")))
+        return details.get("availability");
+    const value = obj(o.availability) ?? (o.state === "unavailable" ? o : null);
+    return value && value.state === "unavailable" && isCollectionUnavailableReason(value.reason) ? value.reason : null;
+}
+/** Find the problem in any SDK shape: a code, an error, a public snapshot or a facet. */
+function problemOf(input, cpOrigin) {
+    const code = str(input);
+    if (code)
+        return { codes: [code], retryAfterMs: null, updateUrl: null };
+    const o = obj(input);
+    if (!o)
+        return null;
+    try {
+        // A phase: its problem (if any) is already described.
+        if (typeof o.kind === "string" && "problem" in o && obj(o.problem) && typeof obj(o.problem).code === "string")
+            return problemOf(obj(o.problem).code, cpOrigin);
+        // Server detail counts only if it re-validates as a sanitized SDK problem.
+        const detail = obj(o.problemDetail), server = sanitizeAppServerProblem(o.server ?? detail?.server, cpOrigin);
+        const serverCodes = [server?.reason ?? null, server?.code ?? null].filter((c) => c !== null);
+        const extra = { retryAfterMs: server?.retryAfterMs ?? retry(o.retryAfterMs), updateUrl: trustedUpdateUrl(server?.updateUrl, cpOrigin) };
+        // Snapshot or facet: { problem: string | {code}, readiness?, assessment?, status? }.
+        if ("problem" in o || "readiness" in o || "assessment" in o) {
+            const own = str(o.problem) ?? str(obj(o.problem)?.code);
+            if (own)
+                return { codes: [...serverCodes, own], ...extra, refusal: registrationRefusal(detail?.registration) };
+            const readiness = obj(o.readiness) ?? o;
+            const assessment = obj(readiness.assessment);
+            const facet = str(obj(readiness.problem)?.code) ?? str(obj(assessment?.problem)?.code);
+            if (facet)
+                return { codes: [facet], ...extra };
+            const status = str(assessment?.status) ?? str(o.status);
+            if (status === "incompatible" || status === "setup_required")
+                return { codes: [status], ...extra };
+            return null;
+        }
+        // Collection availability: {state, reason}, a list entry {availability} or an
+        // open error carrying details.availability.
+        const availability = availabilityReason(o);
+        if (availability)
+            return { codes: [availability === "approval_required" ? "device_approval_required" : availability], ...extra };
+        if ("state" in o && (o.state === "available" || o.state === "opening"))
+            return null;
+        // Errors: MdbaseError {code, reason}, SDK errors {reason, server}.
+        const codes = [...serverCodes, str(o.reason), str(o.code)].filter((c) => c !== null);
+        return codes.length ? { codes, ...extra, refusal: registrationRefusal(o.details ?? detail?.registration) } : null;
+    }
+    catch {
+        return null; /* hostile getters never replace the description */
+    }
+}
+function resolve(found) {
+    const original = found.codes[found.codes.length - 1];
+    try {
+        for (const code of found.codes) {
+            if (NON_PROBLEMS.has(code))
+                return { key: null, original };
+            const key = problemCodeOf(code);
+            if (key)
+                return { key, original };
+        }
+    }
+    catch { /* fall through to generic */ }
+    return { key: "unknown", original };
+}
+/**
+ * Describe a problem for people. Accepts a code string, an `MdbaseError` or SDK
+ * error, `{code, reason?}`, a public application snapshot, a phase, a readiness
+ * facet, a collection availability or a collection list entry carrying one.
+ * Returns `null` when the input has no problem (a ready snapshot) or is not a
+ * problem (a cancellation, a note the SDK handled).
+ * The most specific known code wins (server reason, then reason, then code).
+ */
+export function describeError(input, options = {}) {
+    const cpOrigin = typeof options.cpOrigin === "string" ? options.cpOrigin : null;
+    const found = problemOf(input, cpOrigin);
+    if (!found)
+        return null;
+    const { key, original } = resolve(found);
+    if (key === null)
+        return null;
+    const [title, message, action, severity, transient = false, label] = key === "unknown" ? GENERIC : COPY[key];
+    let translated;
+    try {
+        const messages = options.messages;
+        translated = messages && Object.hasOwn(messages, key) ? obj(messages[key]) : undefined;
+    }
+    catch {
+        translated = undefined;
+    }
+    const text = (v, fallback) => typeof v === "string" && v.trim() ? v : fallback;
+    const accountLabel = typeof options.recoveryAccountLabel === "string" && options.recoveryAccountLabel.trim().length > 0 && options.recoveryAccountLabel.length <= 320 && !Array.from(options.recoveryAccountLabel).some(c => c.charCodeAt(0) < 32 || c.charCodeAt(0) === 127) ? options.recoveryAccountLabel : null;
+    const accountMessage = key === "recovery_account_mismatch" && accountLabel ? `This collection belongs to ${accountLabel}. Sign in as ${accountLabel} to continue.` : message;
+    const actionLabel = key === "recovery_account_mismatch" && accountLabel ? `Sign in as ${accountLabel}` : label ?? LABELS[action];
+    return Object.freeze({
+        key, title: text(translated?.title, title), message: text(translated?.message, accountMessage), action,
+        actionLabel: actionLabel === null ? null : text(translated?.actionLabel, actionLabel), severity, transient, code: original,
+        developerMessage: diagnostic(key, original, found.refusal ?? null),
+        retryAfterMs: found.retryAfterMs,
+        updateUrl: action === "update_app" ? found.updateUrl ?? DEFAULT_UPDATE_URL : null,
+    });
+}
+function diagnostic(key, original, refusal) {
+    if (key === "application_registration_refused")
+        return registrationRefusalMessage(refusal);
+    if (Object.hasOwn(DEVELOPER, key))
+        return DEVELOPER[key];
+    // The code has no user-facing copy: name it for the developer (validated code only).
+    return key === "unknown" ? `Problem code ${original} has no user-facing copy; it is shown as a generic error.` : null;
+}
+/** Developer detail for logs and consoles, including notes on non-problems
+ * (for example a superseded registration ID). Never show it to end users. */
+export function describeDiagnostic(input, options = {}) {
+    const found = problemOf(input, typeof options.cpOrigin === "string" ? options.cpOrigin : null);
+    if (!found)
+        return null;
+    for (const code of found.codes)
+        if (Object.hasOwn(DEVELOPER, code) && NON_PROBLEMS.has(code))
+            return DEVELOPER[code];
+    const { key, original } = resolve(found);
+    return key === null ? null : diagnostic(key, original, found.refusal ?? null);
+}
+//# sourceMappingURL=describe-error.js.map

package/dist/describe-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error.js","sourceRoot":"","sources":["../src/describe-error.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The 15 error codes (`replica-client-api.md` §9). Each has exactly one recovery
+ * action. Offline and warming indexes are status/reset or complete:false.
+ * Generic query cursor expiry/staleness uses typed invalid_request reasons;
+ * paging resets require explicit caller clearing before a fresh first page.
+ */
+import type { Issue, Problem, Recovery, Uuid } from "./wire.js";
+/** Local facts about a failure that are not part of the wire problem. */
+export interface MdbaseErrorContext {
+    /** The original mutation this failure belongs to. */
+    mutationId?: Uuid;
+    /** A partial batch: one original mutation per item, in op order. */
+    mutationIds?: readonly Uuid[];
+    cause?: unknown;
+}
+export declare const ERROR_CODES: {
+    readonly invalid_request: "fix_request";
+    readonly invalid_record: "fix_request";
+    readonly not_found: "refresh";
+    readonly conflict: "resolve_conflict";
+    readonly unauthenticated: "reauthorize";
+    readonly forbidden: "reauthorize";
+    readonly collection_invalid: "repair_collection";
+    readonly unavailable: "retry";
+    readonly rate_limited: "retry";
+    readonly quota_exceeded: "free_space";
+    readonly too_large: "fix_request";
+    readonly upgrade_required: "upgrade";
+    readonly outcome_unknown: "resolve_outcome";
+    readonly cancelled: "none";
+    readonly internal: "contact_support";
+};
+export type ErrorCode = keyof typeof ERROR_CODES;
+export declare function isErrorCode(code: string): code is ErrorCode;
+/** The recovery action for a code, or `contact_support` for a code this SDK doesn't know. */
+export declare function recoveryFor(code: string): Recovery;
+/**
+ * An error from a replica or from the SDK itself. Apps branch on `code` (and
+ * optionally `reason`) and show their own text; `message` is for developers.
+ */
+export declare class MdbaseError extends Error {
+    readonly code: ErrorCode;
+    readonly recovery: Recovery;
+    readonly reason?: string;
+    readonly details?: unknown;
+    readonly retryAfterMs?: number;
+    readonly issues?: Issue[];
+    readonly traceId?: string;
+    /**
+     * The original mutation of a failed or unsettled write. Its outcome may still be
+     * unknown: resolve it with `receipt` / `awaitReceipt` / `pendingWrites` under this
+     * same ID. The SDK never resubmits it under a new identity. Absent for reads and
+     * dry runs, which capture nothing. Not part of {@link toProblem}.
+     */
+    readonly mutationId?: Uuid;
+    /** Every original mutation of a failed partial batch, in op order. */
+    readonly mutationIds?: readonly Uuid[];
+    constructor(problem: Problem, context?: MdbaseErrorContext);
+    toProblem(): Problem;
+}
+/** Build an error locally (transport failures, cancellation, schema mismatches). */
+export declare function mdbaseError(code: ErrorCode, message: string, 
+/** A `reason` string, or more problem fields. */
+extra?: string | Partial<Omit<Problem, "code" | "recovery" | "message">>): MdbaseError;
+export declare function isMdbaseError(e: unknown, code?: ErrorCode): e is MdbaseError;