v5.0.0

This release contains breaking bugs, please us v5.1.0 to address these bugs

Change Notes:

• Fix getAccessTokenFromCode for null redirectUri

Update Major Versions

• gh-pages: 0.11.0->2.2.0
• mocha:3.4.2-> 7.1.2

Add support for Short Lived Tokens

• Add token_access_type to oauth flow
  • Legacy - default - the current long lived token flow
  • Online - requests only a short-lived access token
  • Offline - requests both a short-lived access token and a refresh token
• Add refresh check to each API call

NOTE: Non-Legacy token_access_types currently require beta access, please reach out to Dropbox support if this is something you are interested in

• Replaced Uglify plugin with terser
• Update Request object to take in client instead of access token to allow for refresh
• Update Travis to test Node v6 and above

Add Support for Scopes

• Add option for requesting specific scopes and including already granted scopes in oauth flow
• Add support for requesting specific scopes on token refresh

Add Support for PKCE

• Add PKCE support in oauth flow
• Remove necessity for secret in refresh flow
• Update Tests
• Add PKCE backend example

Update Spec

(cfd31ba)
Account namespace:
- Added set_profile_photo end point.

Auth namespace:
- Added route_access_denied to AuthError.

Common namespace:
- Added SecondaryEmail struct.

Contacts namespace:
- Added scope route attribute to delete_manual_contacts end point.

Files namespace:
- Added scope route attribute to the following end points:
- get_metadata
- list_folder/longpoll
- list_folder
- list_folder/continue
- list_folder/get_latest_cursor
- download
- download_zip
- export
- upload_session/start
- upload_session/append
- upload_session/append:2
- upload_session/finish
- upload_session/finish_batch
- upload_session/finish_batch/check
- search
- upload
- create_folder
- create_folder:2
- create_folder_batch
- create_folder_batch/check
- delete
- delete:2
- delete_batch
- delete_batch/check
- permanently_delete
- copy
- copy:2
- copy_batch
- copy_batch:2
- copy_batch/check
- copy_batch/check:2
- move
- move:2
- move_batch
- move_batch:2
- move_batch/check:2
- move_batch/check
- get_thumbnail
- get_thumbnail_batch
- get_preview
- list_revisions
- restore
- get_temporary_link
- get_temporary_upload_link
- copy_reference/get
- copy_reference/save
- save_url
- save_url/check_job_status

- Added new search:2 end point.
- Added new search/continue:2 end point
- Added new lock_file_batch end point
- Added new unlock_file_batch end point
- Added new get_file_lock_batch end point

- Added New MetadataV2 union
- Added new HighlightSpan struct
- Added new FileLockMetadata struct
- Added file_lock_info to FileMetadata struct
- Added template_error to ListFolderError union
- Added retry_error to ExportError union

File_properties namespace:
- Added scope route attribute to to the following end points:
- properties/add
- properties/overwrite
- properties/update
- properties/remove
- properties/search
- templates/add_for_user
- templates/add_for_team
- templates/get_for_user
- templates/get_for_team
- templates/update_for_user
- templates/update_for_team
- templates/list_for_user
- templates/list_for_team
- templates/remove_for_user
- templates/remove_for_team

File_requests namespace:
- Added optional scope route attribute to to the following end points:
- list:2
- list/continue
- list
- get
- create
- update
- count
- delete
- delete_all_closed
- Updated docstrings for CreateFileRequestError

Team namespace:
- Added scope route attribute to to the following end points:
- legal_holds/release_policy
- members/secondary_emails/add
- members/secondary_emails
- get_info
- token/get_authenticated_admin
- features/get_values
- devices/list_member_devices
- devices/list_members_devices
- devices/revoke_device_session
- devices/revoke_device_session_batch
- team_folder/create
- team_folder/rename
- team_folder/list
- team_folder/list/continue
- team_folder/get_info
- team_folder/activate
- team_folder/archive
- team_folder/archive/check
- team_folder/permanently_delete
- groups/list
- groups/list/continue
- groups/get_info
- groups/create
- groups/delete
- groups/update
- groups/members/add
- groups/members/remove
- groups/members/set_access_type
- groups/members/list
- groups/members/list/continue
- linked_apps/list_member_linked_apps
- linked_apps/list_members_linked_apps
- linked_apps/revoke_linked_app
- linked_apps/revoke_linked_app_batch
- member_space_limits/set_custom_quota
- member_space_limits/remove_custom_quota
- member_space_limits/get_custom_quota
- member_space_limits/excluded_users/add
- member_space_limits/excluded_users/remove
- member_space_limits/excluded_users/list
- members/list
- members/list/continue
- members/get_info
- members/add
- members/add/job_status/get
- members/set_admin_permissions
- members/send_welcome_email
- members/remove
- members/remove/job_status/get
- members/suspend
- members/unsuspend
- members/recover
- members/move_former_member_files
- namespaces/list
- namespaces/list/continue
- reports/get_storage
- reports/get_activity
- reports/get_membership

- Added new legal_holds/release_policy end point.
- Added new members/secondary_emails/add end point.
- Added new members/secondary_emails/resend_verification_emails
- Added new members/secondary_emails/delete end point
- Added new members/set_profile_photo end point
- Added new members/delete_profile_photo end point
- Added secondary_emails to MemberProfile struct
- Added invited_on to MemberProfile struct
- Added retain_team_shares in MembersRemoveArg Struct
- Added the following to MembersRemoveError union
	- cannot_retain_shares_when_data_wiped
	- cannot_retain_shares_when_no_account_kept
	- cannot_retain_shares_when_team_external_sharing_off
	- cannot_keep_account
	- cannot_keep_account_under_legal_hold
	- cannot_keep_account_required_to_sign_tos

- Updated docstring for DateRange

Team_log namespace:
- Add scope route attribute to the following end points:
- get_events
- Added unlink_device to QuickActionType union
- Added enterprise_console to AccessMethodLogInfo
- Added was_linked_apps_truncated, was_linked_devices_truncated
, was_linked_shared_folders_truncated to JoinTeamDetails struct
- Added web_session, qr_code, apple_oauth to LoginMethod union
- Added enterprise_admin to TrustedNonTeamMemberType union
- Added team to TeamMemberLogInfo struct
- Added is_shared_namespace to NamespaceRelativePathLogInfo struct
- Added organization_team to ContextLogInfo union
- Added legal_holds to EventCategory union
- Added the following to EventDetails union:
- folder_overview_description_changed_details
- folder_overview_item_pinned_details
- folder_overview_item_unpinned_details
- legal_holds_activate_a_hold_details
- legal_holds_add_members_details
- legal_holds_change_hold_details_details
- legal_holds_change_hold_name_details
- legal_holds_export_a_hold_details
- legal_holds_release_a_hold_details
- legal_holds_remove_members_details
- legal_holds_report_a_hold_details
- member_delete_profile_photo_details
- member_set_profile_photo_details
- pending_secondary_email_added_details
- secondary_email_deleted_details
- secondary_email_verified_details
- paper_published_link_change_permission_details
- export_members_report_fail_details
- file_transfers_file_add_details
- file_transfers_transfer_delete_details
- file_transfers_transfer_download_details
- file_transfers_transfer_send_details
- file_transfers_transfer_view_details
- shared_content_restore_invitees_details
- shared_content_restore_member_details
- device_approvals_add_exception_details
- device_approvals_remove_exception_details
- file_locking_policy_changed_details
- file_transfers_policy_changed_details
- password_strength_requirements_change_policy_details
- smarter_smart_sync_policy_changed_details
- tfa_add_exception_details
- tfa_remove_exception_details
- watermarking_policy_changed_details
- changed_enterprise_admin_role_details
- changed_enterprise_connected_team_status_details
- ended_enterprise_admin_session_details
- ended_enterprise_admin_session_deprecated_details
- started_enterprise_admin_session_details
- Added the following to EventType union:
- folder_overview_description_changed
- folder_overview_item_pinned
- folder_overview_item_unpinned
- legal_holds_activate_a_hold
- legal_holds_add_members
- legal_holds_change_hold_details
- legal_holds_change_hold_name
- legal_holds_export_a_hold
- legal_holds_release_a_hold
- legal_holds_remove_members
- legal_holds_report_a_hold
- member_delete_profile_photo
- member_set_profile_photo
- pending_secondary_email_added
- secondary_email_deleted
- secondary_email_verified
- paper_published_link_change_permission
- export_members_report_fail
- file_transfers_file_add
- file_transfers_transfer_delete
- file_transfers_transfer_download
- file_transfers_transfer_send
- file_transfers_transfer_view
- shared_content_restore_invitees
- shared_content_restore_member
- device_approvals_add_exception
- device_approvals_remove_exception
- file_locking_policy_changed
- file_transfers_policy_changed
- password_strength_requirements_change_policy
- smarter_smart_sync_policy_changed
- tfa_add_exception
- tfa_remove_exception
- watermarking_...

Fix missing specs.

Files namespace:

• Added new ExportInfo struct
• Added new fields (is_downloadable, export_info) to FileMetadata
• Added new include_non_downloadable_files to ListFolderArg
• Added new ExportMetadata, ExportArg, Export Result Structs
• Added new ExportError union
• Added new /export route
• Add unsupported_file to DownloadError.
• Add upper bound 9999 to start field in SearchArg.
• Add unsupported_content_type to LookupError.
• Add cant_move_shared_folder to RelocationError.
• Add email_not_verified and unsupported_file to GetTemporaryLinkError.

Sharing namespace:

• Added password field to LinkAudience
• Added effective_audience and link_access_level fields to LinkPermissions struct
• Updated docstrings for LinkPermissions
• Added audience and access fields to SharedLinkSettings struct
• New LinkAccessLevel and RequestedLinkAccessLevel union
• Added new create_view_link and create_edit_link fields to FileAction union

Team_log namespace:

• New types added

Team_policies namespace:

• New TwoStepVerificationState union

Team_reports namespace:

• New TemporaryFailureReason union added.

Auth Namespace:

• Add missing_scope into AuthError

File_requests namespace:

• Add list and list/continue endpoints.
• Add count endpoint.
• Add delete and delete_all_closed endpoints.

Seen_state namespace:

• Add mobile_ios, mobile_android and api into PlatformType.
• deprecate mobile in PlatformType.

Sharing namespace:

• Change shared_link_already_exists under CreateSharedLinkWithSettingsError from void to SharedLinkAlreadyExistsMetadata.
• Add banned_member to AddFolderMemberError.

Team namespace:

• Add profile_photo_url and suspended_on into MemberProfile.

Team_log namespace:

• Add reset_password and restore_file_or_folder to QuickActionType.
• Add google_oauth to LoginMethod.
• Add australia_only and japan_only to PlacementRestriction.
• Add trusted_teams to EventCategory.
• In event details.
  • Add integration_connected_details.
  • Add integration_disconnected_details.
  • Add file_request_delete_details.
  • Add guest_admin_signed_in_via_trusted_teams_details.
  • Add guest_admin_signed_out_via_trusted_teams_details.
  • Add member_add_external_id_details.
  • Add member_change_external_id_details.
  • Add member_remove_external_id_details
  • Add integration_policy_changed_details.
  • Add paper_default_folder_policy_changed_details.
  • Add paper_desktop_policy_changed_details.
  • Add team_extensions_policy_changed_details.
  • Add guest_admin_change_status_details.
• In EventType
  • Add integration_connected.
  • Add integration_disconnected.
  • Add file_request_delete.
  • Add guest_admin_signed_in_via_trusted_teams.
  • Add guest_admin_signed_out_via_trusted_teams.
  • Add member_add_external_id.
  • Add member_change_external_id.
  • Add member_remove_external_i.
  • Add integration_policy_change.
  • Add paper_default_folder_policy_change.
  • Add paper_desktop_policy_changed.
  • Add team_extensions_policy_changed.
  • Add guest_admin_change_status.

stone_cfg:
Add scope into route attribute.

Bugfix / Typescript outdated definition for authenticateWithCordova

#244

Get new stone and specs

Files namespace:

• Added new ExportInfo struct
• Added new fields (is_downloadable, export_info) to FileMetadata
• Added new include_non_downloadable_files to ListFolderArg
• Added new ExportMetadata, ExportArg, Export Result Structs
• Added new ExportError union
• Added new /export route
• Add unsupported_file to DownloadError.
• Add upper bound 9999 to start field in SearchArg.
• Add unsupported_content_type to LookupError.
• Add cant_move_shared_folder to RelocationError.
• Add email_not_verified and unsupported_file to GetTemporaryLinkError.

Sharing namespace:

• Added password field to LinkAudience
• Added effective_audience and link_access_level fields to LinkPermissions struct
• Updated docstrings for LinkPermissions
• Added audience and access fields to SharedLinkSettings struct
• New LinkAccessLevel and RequestedLinkAccessLevel union
• Added new create_view_link and create_edit_link fields to FileAction union

Team_log namespace:

• New types added

Team_policies namespace:

• New TwoStepVerificationState union

Team_reports namespace:

• New TemporaryFailureReason union added.

Auth Namespace:

• Add missing_scope into AuthError

File_requests namespace:

• Add list and list/continue endpoints.
• Add count endpoint.
• Add delete and delete_all_closed endpoints.

Seen_state namespace:

• Add mobile_ios, mobile_android and api into PlatformType.
• deprecate mobile in PlatformType.

Sharing namespace:

• Change shared_link_already_exists under CreateSharedLinkWithSettingsError from void to SharedLinkAlreadyExistsMetadata.
• Add banned_member to AddFolderMemberError.

Team namespace:

• Add profile_photo_url and suspended_on into MemberProfile.

Team_log namespace:

• Add reset_password and restore_file_or_folder to QuickActionType.
• Add google_oauth to LoginMethod.
• Add australia_only and japan_only to PlacementRestriction.
• Add trusted_teams to EventCategory.
• In event details.
  • Add integration_connected_details.
  • Add integration_disconnected_details.
  • Add file_request_delete_details.
  • Add guest_admin_signed_in_via_trusted_teams_details.
  • Add guest_admin_signed_out_via_trusted_teams_details.
  • Add member_add_external_id_details.
  • Add member_change_external_id_details.
  • Add member_remove_external_id_details
  • Add integration_policy_changed_details.
  • Add paper_default_folder_policy_changed_details.
  • Add paper_desktop_policy_changed_details.
  • Add team_extensions_policy_changed_details.
  • Add guest_admin_change_status_details.
• In EventType
  • Add integration_connected.
  • Add integration_disconnected.
  • Add file_request_delete.
  • Add guest_admin_signed_in_via_trusted_teams.
  • Add guest_admin_signed_out_via_trusted_teams.
  • Add member_add_external_id.
  • Add member_change_external_id.
  • Add member_remove_external_i.
  • Add integration_policy_change.
  • Add paper_default_folder_policy_change.
  • Add paper_desktop_policy_changed.
  • Add team_extensions_policy_changed.
  • Add guest_admin_change_status.

stone_cfg:
Add scope into route attribute.

Release for merged Pull requests

• #230
• #228

Get new stone and specs

Get new stone specs with following changes:

Common Namespace:
- Force matching dot character in alias EmailAddress

File_properties namespace:
- Doesn’t allow app folder app to access file property endpoints.

Files namespace:
- Create copy_batch:2 and move_batch:2 endpoints. Deprecate existing copy_batch and move_batch.

Sharing_files namespace:
- Doesn’t allow app folder app to access sharing files endpoints.

Team namespace:
- Only Team apps with Team member file access can access team/properties endpoints.```

Get new stone and specs

Spec updates: dropbox/dropbox-api-spec@eb70e69

Update Randomatic due to vuln alert

v4.0.12

4.0.12

Update lodash

Addresses https://nvd.nist.gov/vuln/detail/CVE-2018-3721

v4.0.10

1. Get new specs and update.

Change Notes:

Files Namespace:
- Updated doc strings

Team_log Namespace:
- Updated event docstrings
- New reset field for loading events with a cursor
- New event types added

Team_policies Namespace:
- New CameraUploadsPolicyState union

2. Stop ignoring fetch option (#219)