docspace-api-sdk 4.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b535694eeb643d9bde41be6987888be9135daf79720a03d447422d3246771206
+  data.tar.gz: 33141f633080aa073f5adcac117fe3d9eb3eef126825554b018a485f6a0c363e
+SHA512:
+  metadata.gz: b5946cae2710e59cf5858ea59497ebe64932d90785e238665e2dee1c7bdb1d51e65f07d860969976b13d46c636642bfbe78b2df9c22b28dd52833ca13f73b1d1
+  data.tar.gz: 6fb0b6af86283888dbf244915d5200f8bc72d72f42b0f97aa33d708a394bc8e39e89e73938bfc4f7ce652282c91d946bf663b63d198655141b436729a234b407

data/AUTHORS.md

@@ -0,0 +1,3 @@
+# Authors
+
+* Ascensio System SIA: <integration@onlyoffice.com>

data/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Change Log
+
+## 4.0.0
+
+### Added
+
+- Third-party storage support: 100 operations that address a file, folder or room (for example `get_file_info`, `get_folder_by_folder_id`, `update_room`, `upload_file`, the sharing and upload-session operations) take the identifier as an `Integer` or a `String`: an `Integer` addresses an entry stored on the portal, and a `String` addresses an entry in a connected third-party storage (for example `"sbox-42"`); the 39 of them that return a file, folder or upload session choose the model by the class of the identifier and return the matching `ThirdParty*` model for a `String` (`ThirdPartyFileWrapper`, `ThirdPartyFolderWrapper`, `ThirdPartyFolderContentWrapper`, `ThirdPartyChunkedUploadSessionWrapper` and others), so a portal identifier must be passed as an `Integer`; `save_file_as_pdf` and `start_file_conversion` accept `ThirdPartySaveAsPdfRequest` and `ThirdPartyCheckConversionRequestDto` for such files
+- Added the reworked AI API in `lib/docspace-api-sdk/api/AI/`: `AI::AIApi` (sending messages with or without streaming, regenerating answers, approving and denying tool calls), `AI::AssignmentsApi`, `AI::AttachmentsApi`, `AI::ContextApi`, `AI::EditorToolsApi`, `AI::ExportApi`, `AI::OpenAIPassthroughApi`, `AI::PreferencesApi`, `AI::ProfilesApi`, `AI::PromptsApi`, `AI::ThreadsApi`, `AI::ToolsApi` and `AI::WebSearchApi`; `AI::SettingsApi` gains `ai_settings_get_tool_mode` and `ai_settings_set_tool_mode`
+- Added `Files::MetadataApi` (`lib/docspace-api-sdk/api/Files/metadata-api.rb`): metadata templates and their fields, assigning templates to files and folders, custom fields and field values; the new `search_folder` (`Files::FoldersApi`) and `search_rooms` (`Rooms::RoomsApi`) find entries by their metadata, and files and folders carry `assigned_metadata_templates` and `metadata_matches`
+- Added `Apps::AppsApi` (`lib/docspace-api-sdk/api/Apps/`), `Rooms::PrivacyRoomApi` (`lib/docspace-api-sdk/api/Rooms/`, the users' encryption keys for privacy rooms) and `Settings::DocsCloudApi` (`lib/docspace-api-sdk/api/Settings/`)
+- Added the operations `get_forms_folder` (`Files::FoldersApi`), `get_room_ai_folder` (`Rooms::RoomsApi`), `show_quick_actions` (`Files::SettingsApi`), `get_encryption_info` and `set_encryption_info` (`Files::FilesApi`) and `get_encryption_access` (`Files::SharingApi`)
+- Report generation: `create_report_folder_history`, `create_audit_trail_report` and `create_login_history_report` take the `:format`, `:from` and `:to` options and return a `DocumentBuilderTaskWrapper`; the new `get_report_folder_history`, `get_audit_trail_report`, `get_login_history_report` and the matching `terminate_*` operations follow and cancel the report
+- Added the payment operations `get_active_services`, `get_accounting_service_prices`, `get_subscription_balance_info`, `move_subscription_to_wallet`, `get_customer_service_usage` and `get_customer_monthly_usage` with their `create_*_report`, `get_*_report` and `terminate_*_report` operations (`Portal::PaymentApi`), and `get_upcoming_payments` (`Portal::QuotaApi`)
+- Added `get_backups_counts` (`Backup::BackupApi`) and `refresh_web_plugin` (`Settings::WebpluginsApi`)
+- Added model properties: `show_quick_actions` to `FilesSettingsDto`, `forms_used_space` to `FilesStatisticsResultDto`, `ai` to `CustomizationConfigDto`, `is_delayed_payment_method` and `payment_method_type` to `CustomerInfoDto`, `search_area` to `RoomGroupDto` and `RoomGroupRequestDto`, `wallet_low_balance` to `SettingsDto`, `runtime` to `WebPluginDto`, `tool_permission_mode` to `AiSettingsDto` and `AiUserSettingsDto`, `last_modified` to `TenantAiAccessSettingsDto`, `TenantBannerSettingsDto` and `TenantDevToolsAccessSettingsDto`, `errors` to `ProblemDetail`; `OperationDto` describes the source of a charge with `source_id`, `source_title`, `source_type`, `cost` and `token_usage` instead of `agent_id` and `agent_title`, and `EditorToolCallStateDto.parameters` is an `EditorToolCallParametersDto` instead of an untyped `Object`
+- Added enum values: `FolderType::Forms` and `FolderType::Ai`; `SearchArea::FORMS` and `SearchArea::FORM_TEMPLATES`; `TenantWalletService::Admin`, `DocsCloud`, `DocsCloudDevPack` and `AISearch`; new audit actions in `MessageAction` (privacy room keys, metadata templates and values, AI profiles, Docs Cloud and others)
+- Added the error body models `ErrorApiResponse` and `ValidationErrorResponse` (with `FieldError`)
+
+### Changed
+
+- Files, folders and rooms use one set of models for numeric identifiers: the `Integer` suffix is gone (`FileIntegerWrapper` → `FileWrapper`, `FolderIntegerWrapper` → `FolderWrapper`, `FolderContentIntegerWrapper` → `FolderContentWrapper`, `FileDtoInteger` → `FileDto`, `FolderDtoInteger` → `FolderDto`, `ConfigurationIntegerWrapper` → `ConfigurationWrapper`, `UploadSessionResponseIntegerWrapper` → `UploadSessionResponseWrapper`, `OrdersRequestDtoInteger` → `OrdersRequestDto`, `UpdateRoomsQuotaRequestDtoInteger` → `UpdateRoomsQuotaRequestDto`, `SaveAsPdfInteger` → `SaveAsPdfRequest` and so on), and the `String` variants became `ThirdParty*` models (`FolderStringWrapper` → `ThirdPartyFolderWrapper`, `FolderDtoString` → `ThirdPartyFolderDto`, `FileEntryDtoString` → `ThirdPartyFileEntryDto`); the chunked-upload operations return `ChunkedUploadSessionWrapper` and `ChunkedUploadSessionResultWrapper`
+- Renamed the request models with the plural `Requests` to the singular (`AuthRequestsDto` → `AuthRequestDto`, `SsoSettingsRequestsDto` → `SsoSettingsRequestDto`, `TfaRequestsDto` → `TfaRequestDto`, `StorageRequestsDto` → `StorageRequestDto`, `CspRequestsDto` → `CspRequestDto`, `WhiteLabelRequestsDto` → `WhiteLabelRequestDto`, `WebPluginRequests` → `WebPluginRequest` and the rest), and the JSON bodies nested in a request take a `Request` suffix (`Delete` → `DeleteFileRequest`, `DeleteFolder` → `DeleteFolderRequest`, `CreateFolder` → `CreateFolderRequest`, `CreateFileJsonElement` → `CreateFileRequest`, `CreateTextOrHtmlFile` → `CreateTextOrHtmlFileRequest`, `CopyAsJsonElement` → `CopyAsRequest`, `UpdateFile` → `UpdateFileRequest`, `UpdateComment` → `UpdateCommentRequest`, `ChangeHistory` → `ChangeHistoryRequest`, `CheckFillFormDraft` → `CheckFillFormDraftRequest`, `CustomFilterParameters` → `CustomFilterRequest`, `CreateThirdPartyRoom` → `CreateThirdPartyRoomRequest`, `LockFileParameters` → `LockFileRequest`, `StartEdit` → `StartEditRequest`, `Culture` → `UpdateMemberCultureRequest`, `MentionMessageWrapper` → `MentionMessageRequest`, `EmailValidationKeyModel` → `CheckConfirmRequestDto`); the JSON sent is unchanged
+- An optional request body is passed in `opts` under the name of its model, so these keys changed with the models: `authenticate_me(auth_requests_dto: ...)` → `authenticate_me(auth_request_dto: ...)`, `:create_file_json_element` → `:create_file_request`, `:tenant_wallet_settings_wrapper` → `:tenant_wallet_settings_request_dto`, `:backup_dto` → `:start_backup_request_dto`, `:culture` → `:update_member_culture_request` (`update_member_culture`), `:request_body` → `:default_access_rights_request_dto` (`change_default_access_rights`) and `:delete_template_files_request_dto` (`delete_templates`) and so on; an old key is ignored without an error and the request is sent without its body, so every call that passes a body in `opts` must be checked; a required body is a positional argument and only changes its class
+- Settings, database entities and other server-side classes are no longer published as models: each one became a `Dto` of the same shape (`TenantQuota` → `TenantQuotaDto`, `Balance` → `BalanceDto`, `Tariff` → `TariffDto`, `BackupProgress` → `BackupProgressDto`, `CoEditingConfig` → `CoEditingConfigDto`, `Logo` → `LogoDto`, `StorageSettings` → `StorageSettingsDto`, `DarkThemeSettings` → `DarkThemeSettingsDto`, `WizardSettings` → `WizardSettingsDto` and so on) or a model named after what it carries (`UserInfo` → `PortalUserDto`, also as the `user` of `MentionDto`, `FireBaseUser` → `FirebaseDeviceDto`, `ThirdPartyParams` → `ThirdPartyAccountDto`, `CompanyWhiteLabelSettings` → `LicensorDetailsDto`, `AdditionalWhiteLabelSettings` → `AdditionalResourcesDto`, `SsoSettingsV2` → `SsoSettingsDto`, `IPRestriction` → `IpRestrictionDto`, `IpRestrictionBase` → `IpRestrictionEntryDto`, `SetupCode` → `TfaSetupCodeDto`); the room, user and AI agent quota settings are all returned as `EntityQuotaSettingsWrapper`
+- The settings sent in a request body take the name of their operation and keep every field (`TenantWalletSettingsWrapper` → `TenantWalletSettingsRequestDto` with `SetWalletTopUpSettingsRequest`, `TenantAuditSettingsWrapper` → `TenantAuditSettingsRequestDto` with `SetAuditLifetimeSettingsRequest`, `CompanyWhiteLabelSettingsWrapper` → `CompanyWhiteLabelSettingsRequestDto` with `SaveCompanyInfoRequest`, `AdditionalWhiteLabelSettingsWrapper` → `AdditionalWhiteLabelSettingsRequestDto` with `SaveAdditionalResourcesRequest`, `TenantAiAccessSettingsDto` → `TenantAiAccessSettingsRequestDto`, `TenantBannerSettingsDto` → `TenantBannerSettingsRequestDto`, `TenantDevToolsAccessSettingsDto` → `TenantDevToolsAccessSettingsRequestDto`, `ExternalDatabaseSettings` → `ExternalDatabaseConnectionRequestDto`, `EmailActivationSettings` → `EmailActivationSettingsRequestDto`); `TenantWalletSettingsWrapper`, `TenantAuditSettingsWrapper`, `CompanyWhiteLabelSettingsWrapper` and `AdditionalWhiteLabelSettingsWrapper` return the settings in `response` instead of a `settings` property; `save_auth_keys` takes `SaveAuthKeysRequestDto` and `get_auth_services` returns `AuthServiceArrayWrapper`
+- Renamed other models whose names did not say what they carry: `Status` → `ExternalShareStatus`, `Options` → `DocumentOptionsDto`, `STRINGArrayWrapper` → `StringArrayWrapper`, `EncryprtionStatus` → `EncryptionStatus`, `AceShortWrapper` → `AceShortDto`, `MentionWrapper` → `MentionDto`, `TimezonesRequestsDto` → `TimezoneDto`, `GroupMemberSecurityRequestDto` → `GroupMemberSecurityDto`, `SmtpOperationStatusRequestsDto` → `SmtpOperationStatusDto`, `KeyValuePairBooleanString` → `ItemKeyValuePairBooleanString`, `HistoryData` → `HistoryDataDto`, `HistoryAction` → `HistoryActionDto`, `Area` → `AccountSearchArea`, `Location` → `RequestLocation`, `TfaRequestsDtoType` → `TfaType`, and the backup request models after their operation (`BackupDto` → `StartBackupRequestDto`, `BackupRestoreDto` → `StartBackupRestoreRequestDto`, `BackupScheduleDto` → `CreateBackupScheduleRequestDto`, `Cron` → `BackupCronRequest`)
+- Operations that returned an untyped `ObjectWrapper` or `ObjectArrayWrapper` now return a typed model: `StringWrapper` (`get_portal_path`, `get_portal_hostname`, `get_greeting_settings`, `get_third_party_code`), `StringArrayWrapper` (`get_room_tags_info`), `TokenDiagnosticsWrapper` (`get_claims`), `AuditTrailProductArrayWrapper` (`get_audit_trail_mappers`), `AuditTrailTypesWrapper` (`get_audit_trail_types`), `EnabledModuleArrayWrapper` (`get_enabled_modules`), `SocketSettingsWrapper` (`get_socket_settings`), `SsoSettingsConstantsWrapper` (`get_sso_settings_v2_constants`), `AmazonS3RegionArrayWrapper` (`get_amazon_s3_regions`), `AccountEntryArrayWrapper` (`get_accounts_entries_with_*_shared`)
+- Other return types: `delete_file_versions` returns `FileOperationArrayWrapper`, `search_users_by_query` returns `EmployeeFullArrayWrapper`, `change_default_access_rights` returns `FileShareResponseArrayWrapper`, `update_cdn_storage` returns `StorageSettingsWrapper`, `get_ai_prices` returns `AiPricesWrapper`, `get_restricted_ai_models` and `set_restricted_ai_models` return `RestrictedAiModelsWrapper`; `delete_group` and `delete_recent` return `nil`
+- Renamed the AI operations after their tag, so the method names change: `create_agent` → `ai_agents_create`, `get_agents` → `ai_agents_list`, `get_agent_info` → `ai_agents_get`, `get_agents_new_items` → `ai_agents_news`, `update_agent` → `ai_agents_update`, `delete_agent` → `ai_agents_delete`, `update_agents_quota` → `ai_agents_update_quota`, `reset_agents_quota` → `ai_agents_reset_quota`, `get_ai_settings` → `ai_settings_get`, `get_ai_user_settings` → `ai_settings_get_user`, `set_ai_user_settings` → `ai_settings_set_user`, `get_vectorization_settings` → `ai_settings_get_vectorization`, `set_vectorization_settings` → `ai_settings_set_vectorization`, `start_task` → `ai_vectorization_start_task`; in Files, `change_download_zip_from_body` → `change_download_zip`
+- The AI agent operations take the agent `id` as a `String` and use their own `Ai`-prefixed models (`AiFolderWrapper`, `AiFolderContentWrapper`, `AiFileOperationWrapper`, `AiAgentsCreateRequest`, `AiAgentsUpdateRequest` and others) instead of the models of the Files API; `ai_agents_create`, `ai_agents_update_quota`, `ai_agents_reset_quota` and `ai_settings_set_user` take their body as a required argument instead of an `opts` key; `ai_agents_list` takes `:quota_filter` as an `Integer` and `:sort_order` as a `String`; `ai_settings_set_user` and `ai_settings_set_vectorization` take the settings as a `Hash`
+- The AI operations are declared with the new `cookieAuth` and `bearerAuth` schemes instead of `Basic`, `OAuth2`, `ApiKeyBearer`, `asc_auth_key`, `Bearer` and `OpenId`; the access token set in `Configuration` is sent to them as `Authorization: Bearer` and the `asc_auth_key` API key as a cookie, as to every other operation
+- 49 operations that the portal also serves without signing in (among them `get_file_info`, `get_folder_by_folder_id`, `get_folder_info`, `get_room_info`, `open_edit_file`, `update_file`, `get_files_settings`, `get_portal_settings` and `authenticate_me`) now send the credentials set in `Configuration`; before, they were always called anonymously
+- The OAuth 2.0 client and scope operations call `/api/2.0/oauth2/clients` and `/api/2.0/oauth2/scopes` instead of `/api/2.0/clients` and `/api/2.0/scopes`; `get_clients` returns `PageableClientResponse` instead of `PageableResponse` and takes `:limit` in `opts` instead of as its first argument, `get_clients_info` returns `PageableClientInfoResponse` (renamed from `PageableResponseClientInfoResponse`), `get_scopes` returns an `Array<ScopeResponse>` instead of one `ScopeResponse`, and `change_activation`, `delete_client`, `delete_tenant_clients`, `delete_user_clients`, `revoke_user_client`, `update_client` and `handle_options` return `nil` instead of an `Object`; `UpdateClientRequest` takes `redirect_uris` and `scopes`
+- `check_move_or_copy_batch_items` and `check_move_or_copy_dest_folder` take the batch as separate options (`:return_single_operation`, `:folder_ids`, `:file_ids`, `:dest_folder_id`, `:conflict_resolve_type`, `:delete_after`, `:content`, `:to_fill_out`) instead of one `:in_dto` object, which is how the server reads them
+- New and changed options: the folder listings `get_my_folder`, `get_favorites_folder`, `get_recent_folder`, `get_trash_folder`, `get_folder_by_folder_id` and `get_rooms_folder` take `:metadata_template_id` and `:metadata_filters`; `get_folder_by_folder_id` also takes `:folder_type` (an `Array<Integer>`), its `:room_id` accepts a `String` and its `:location` is a `RequestLocation`; `get_rooms_folder` no longer takes `:subject_filter` and takes `:privacy_filter` and `:with_ai_folder`; `empty_trash` takes `:folder_type` and `get_payment_quotas` takes `:additional`; `get_room_groups` no longer takes the required `id` argument and takes `:search_area`
+- Parameter types: the date filters of `get_file_history`, `get_folder_history`, `get_audit_events_by_filter` and `get_login_events_by_filter` are `Time` instead of `ApiDateTime`; `:service_name` of `get_customer_operations` and `service_name` of `CustomerOperationsReportRequestDto` are an `Array<String>`; `EditorConfigurationDto.encryption_keys` is an `Array<EncryptionKeyDto>` instead of `EncryptionKeysConfig`
+- `SearchArea` is sent and received as a string instead of a number, and its constants are renamed to upper case (`SearchArea::Active` → `SearchArea::ACTIVE`, `SearchArea::RecentByLinks` → `SearchArea::RECENT_BY_LINKS`, `SearchArea::AiAgents` → `SearchArea::AI_AGENTS`, ...); `FolderType::ResultStorage` (33) is now `FolderType::ChatOutputs`
+- Regenerated with OpenAPI Generator 7.24.0 (previously 7.22.0)
+
+### Removed
+
+- Removed the superseded AI API classes `AI::ChatApi`, `AI::MCPApi`, `AI::MessagesApi` and `AI::ProvidersApi` from `lib/docspace-api-sdk/api/AI/` together with their models (`ChatDto`, `MessageDto`, `McpServerDto`, `AiProviderDto`, `ModelDto` and others); the web search settings moved from `get_web_search_settings`/`set_web_search_settings` to `AI::WebSearchApi`
+- Removed the request models `SetAiUserSettingsRequestDto` and `SetEmbeddingConfigRequestBody`, the `AiSettingsDto` properties that described the old AI chat (`web_search_enabled`, `portal_mcp_server_id`, `model_aliases`, the `*_tool_name` properties and others) and the model properties of `ChatSettingsDto` (`provider_id`, `model_id`, `model_alias`, `capabilities`, `multimodal`, `thinking`, `internal`)
+- Removed `get_privacy_folder` and `is_available_privacy_room_settings` (Files), `get_customer_ai_balance` and `credit_ai_balance` (Payment)
+- Removed the `:subject_filter` option of `get_rooms_folder` and `ai_agents_list` with its `SubjectFilter` enum, the `MessageAction` values `PrivacyRoomEnable` and `PrivacyRoomDisable`, and the `public` property of the OAuth 2.0 client models
+- Removed the server-side models that no operation uses any more: `DbTenant`, `DbTenantPartner`, `AuthData`, `OAuth20Token`, `NoContentResult`, `NoContentResultWrapper` and `StatusCodeResult`
+- The third-party accounts returned by `get_third_party_accounts` no longer have the `auth_data` property, and the devices returned by `doc_register_pusn_notification_device` and `subscribe_documents_push_notification` no longer have `tenant`; neither was ever filled in
+
+## 3.7.0
+- Initial release

data/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.