@interop/did-method-webvh 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,345 @@
+## 3.0.0 - 2026-06-14
+
+### Package
+
+* rename the package from `didwebvh-ts` to `@interop/did-method-webvh` and move
+  the repository to `interop-alliance/did-method-webvh`; update import specifiers
+  and docs accordingly (the `didwebvh` CLI bin name is unchanged)
+
+### BREAKING CHANGES
+
+* remove the legacy `did:webvh:0.5` spec implementation (`src/method_versions/method.v0.5.ts`); the library now supports `did:webvh:1.0` only:
+  * resolving a DID log whose first entry declares `method: 'did:webvh:0.5'` (including via `updateDID`/`deactivateDID`, which resolve the log internally) throws `'did:webvh:0.5' is not a supported method version.`
+  * `createDID` throws the same error if passed an explicit non-1.0 `method` option (previously an untyped option that selected the v0.5 implementation)
+* remove "controlled-mode" local file resolution from the library; it now lives in `examples/express-resolver.ts`:
+  * `resolveDID` no longer consults the `DID_VERIFICATION_METHODS` env var or reads DID logs from the local `./src/routes/` directory; it always resolves over HTTPS
+  * `resolveDID` no longer returns a `controlled` field in its result (success or error)
+  * `fetchLogFromIdentifier` loses its second (`controlled`) parameter
+  * the internal `getActiveDIDs` helper is removed (it was not exported from the package entry point)
+  * the `src/routes/` fixture data moves to `examples/routes/`
+  * servers that control their own DID logs should read the log file themselves and call the existing `resolveDIDFromLog` export (see `resolveDIDLocalFirst` in `examples/express-resolver.ts` for a reference implementation)
+
+### Build System
+
+* replace the esbuild multi-bundle build (ESM/CJS/browser/CLI) with a plain `tsc` build emitting a single ESM target plus declarations to `dist/`; the `require` entry point is dropped (Node >= 20.19 can `require()` ESM natively)
+* remove unused dependencies (`cookie`, `glob`, `js-yaml`) and unused dev dependencies (`esbuild`, `@sinclair/typebox`, `@types/express`)
+* move `@stablelib/ed25519` to `dependencies` (the unbundled CLI imports it at runtime)
+* the CLI now ships as `dist/cli.js` (was `dist/cli/didwebvh.js`); the `didwebvh` bin name is unchanged
+* upgrade `vitest` from v3 to v4 (no test or config changes required)
+
+### Tests
+
+* add test coverage measurement: `@vitest/coverage-v8` dev dependency and a `test:coverage` script (informational only, no thresholds; the CLI is exercised via subprocesses, which V8 coverage cannot see)
+* add tests for the HTTPS resolution path (`resolveDID`, `fetchLogFromIdentifier`, `fetchWitnessProofs`) using a stubbed global `fetch`, covering success, 404/notFound mapping, empty and invalid logs, SCID mismatch, and network failure
+* add unit tests for multibase/multihash decode error branches, the buffer utilities (both Node and browser paths), and the hash helpers
+
+## [2.7.4](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.7.3...v2.7.4) (2026-04-24)
+
+
+### Bug Fixes
+
+* default verification method controller to the DID ([f3ac134](https://github.com/decentralized-identity/didwebvh-ts/commit/f3ac134278871bf059c60f0be2c7da5889264a3c))
+
+## [2.7.3](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.7.2...v2.7.3) (2026-04-18)
+
+
+### Bug Fixes
+
+* entry hash bug ([cf948fe](https://github.com/decentralized-identity/didwebvh-ts/commit/cf948fe8d8401b69a1ab0b0a974d80aa64bb0af6))
+
+## [2.7.2](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.7.1...v2.7.2) (2026-03-03)
+
+
+### Bug Fixes
+
+* resolver integrity and validation hardening ([a4b6b27](https://github.com/decentralized-identity/didwebvh-ts/commit/a4b6b277862258cafb7be17c0a7810c3123e792c))
+
+## [2.7.1](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.7.0...v2.7.1) (2026-01-24)
+
+
+### Bug Fixes
+
+* remove npm token ([c9fb8a3](https://github.com/decentralized-identity/didwebvh-ts/commit/c9fb8a3280466f31ccb31a66cd25562a823dd7ad))
+* update node version in action ([49e07b0](https://github.com/decentralized-identity/didwebvh-ts/commit/49e07b01a4b87047900d2ab30aff7189660ee506))
+* updated semantic release ([1802ea5](https://github.com/decentralized-identity/didwebvh-ts/commit/1802ea526f75f7c08b0b2fc861a2743cf0080b4c))
+
+# [2.7.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.6.0...v2.7.0) (2026-01-24)
+
+
+### Features
+
+* add id token perm to publish action ([07d801d](https://github.com/decentralized-identity/didwebvh-ts/commit/07d801deceae05b88e236e1bdd9f333cce98c86d))
+
+# [2.6.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.7...v2.6.0) (2026-01-24)
+
+
+### Features
+
+* bump version ([e1c4a29](https://github.com/decentralized-identity/didwebvh-ts/commit/e1c4a29a4b4fe6fc6530f3f4987f0cab92079396))
+
+## [2.5.7](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.6...v2.5.7) (2026-01-23)
+
+
+### Bug Fixes
+
+* updated dependencies for security vulnerabilities ([2c0ac78](https://github.com/decentralized-identity/didwebvh-ts/commit/2c0ac787e75a29382788f903286bdc0fc7f13fb1))
+
+## [2.5.6](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.5...v2.5.6) (2025-11-12)
+
+
+### Bug Fixes
+
+* correct host normalization in toASCII for numeric domains like 2060.io ([b226c69](https://github.com/decentralized-identity/didwebvh-ts/commit/b226c69da1d77391b4f4c7d51144f47bab64f326))
+
+## [2.5.5](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.4...v2.5.5) (2025-10-08)
+
+
+### Bug Fixes
+
+* allow verification methods without publicKeyMultibase ([ebe9822](https://github.com/decentralized-identity/didwebvh-ts/commit/ebe9822c0dd40dc8fbd7b56213c7a4734f75658c))
+
+## [2.5.4](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.3...v2.5.4) (2025-09-02)
+
+
+### Bug Fixes
+
+* remove extra comma ([70ee446](https://github.com/decentralized-identity/didwebvh-ts/commit/70ee446c9192128eabd084c8b278783e7363a7fd))
+* update DID without recalculating verification methods ([15c47e7](https://github.com/decentralized-identity/didwebvh-ts/commit/15c47e7e6050a895eab7ee4abc55fe45baa94de3))
+
+## [2.5.3](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.2...v2.5.3) (2025-08-15)
+
+
+### Bug Fixes
+
+* remove base externals from build configurations ([18a7a23](https://github.com/decentralized-identity/didwebvh-ts/commit/18a7a2339895155e6fa10c9a9dab23fccf29a203))
+
+## [2.5.2](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.1...v2.5.2) (2025-08-14)
+
+
+### Bug Fixes
+
+* enhance environment detection and dynamic fs import handling ([474fd2c](https://github.com/decentralized-identity/didwebvh-ts/commit/474fd2ccac84ef2c5ce6755d244dbbf10472c9ac))
+
+## [2.5.1](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.5.0...v2.5.1) (2025-08-14)
+
+
+### Bug Fixes
+
+* update React Native entry points in package.json ([95ad5d8](https://github.com/decentralized-identity/didwebvh-ts/commit/95ad5d88f2796b28bf45048452b4ddeaec586e16))
+
+# [2.5.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.4.1...v2.5.0) (2025-08-14)
+
+
+### Features
+
+* add support for React Native in package.json ([2f16d19](https://github.com/decentralized-identity/didwebvh-ts/commit/2f16d19e5d03a8afe538dabe1ca50d0a87f7e5dc))
+
+## [2.4.1](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.4.0...v2.4.1) (2025-07-23)
+
+
+### Bug Fixes
+
+* enhance verification method handling and improve CLI tests ([275152e](https://github.com/decentralized-identity/didwebvh-ts/commit/275152e1d545051dfef673474c3ec4505ba47f94))
+
+# [2.4.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.3.2...v2.4.0) (2025-07-16)
+
+
+### Bug Fixes
+
+* update witness parameter handling and types ([c783641](https://github.com/decentralized-identity/didwebvh-ts/commit/c783641ad318565923fcfcd896ab44370c39363f))
+
+
+### Features
+
+* enhance cryptographic interface and implementation ([a37c99b](https://github.com/decentralized-identity/didwebvh-ts/commit/a37c99b7bf1d53ba607f1038c21c3265ff05f091))
+* enhance witness handling and resolution logic ([cb453a8](https://github.com/decentralized-identity/didwebvh-ts/commit/cb453a852cfcab2b474bf1c650f41362bd31f2b2))
+* implement witness proof generation and enhance CLI functionality ([84bbc4f](https://github.com/decentralized-identity/didwebvh-ts/commit/84bbc4f79140c102af54a0a7d91ff1a7725ed048))
+
+## [2.3.2](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.3.1...v2.3.2) (2025-06-24)
+
+
+### Bug Fixes
+
+* improve dynamic filesystem module loading ([817897e](https://github.com/decentralized-identity/didwebvh-ts/commit/817897e2fea7183ab46bda2d16b69325f9f0ff79))
+
+## [2.3.1](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.3.0...v2.3.1) (2025-06-24)
+
+
+### Bug Fixes
+
+* update log handling to use async/await ([31067af](https://github.com/decentralized-identity/didwebvh-ts/commit/31067af464b802463859352a49291c02ac111857))
+
+# [2.3.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.2.0...v2.3.0) (2025-06-23)
+
+
+### Bug Fixes
+
+* improve filesystem access handling in utils ([ec72a75](https://github.com/decentralized-identity/didwebvh-ts/commit/ec72a75b0efa757fe5e76ce1d7f522ed56377c6b))
+
+
+### Features
+
+* add paths support in DID creation and testing ([ee51df5](https://github.com/decentralized-identity/didwebvh-ts/commit/ee51df52059a06d583eece78bc8aad9e9abc9802))
+
+# [2.2.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.1.0...v2.2.0) (2025-06-18)
+
+
+### Bug Fixes
+
+* improve test script logging and cleanup ([4df9663](https://github.com/decentralized-identity/didwebvh-ts/commit/4df9663d7a702c9a586cb1dbebb380e39ca85707))
+
+
+### Features
+
+* add watcher support to DID creation and updates ([8d206bd](https://github.com/decentralized-identity/didwebvh-ts/commit/8d206bdf1452d435f2c370e1753c22799f5dc8ec))
+* enhance DID resolution error handling and add ProblemDetails interface ([b331c46](https://github.com/decentralized-identity/didwebvh-ts/commit/b331c4630d35005d66bea80bb2904c5bfe1ee415))
+* enhance error handling and status code mapping in DID resolution ([849d0c6](https://github.com/decentralized-identity/didwebvh-ts/commit/849d0c60ef04efb17c66e155bc3072273a166ac2))
+* enhance internationalized domain handling in utils ([f19f831](https://github.com/decentralized-identity/didwebvh-ts/commit/f19f831e4463071e06c50b6966ae4a6769fc0ce3))
+* enhance test logging functionality in DID operations ([8d66bcc](https://github.com/decentralized-identity/didwebvh-ts/commit/8d66bcce45a287f1e953bcff662d92c99615d10c))
+* implement domain encoding in DID creation ([4369f70](https://github.com/decentralized-identity/didwebvh-ts/commit/4369f706a83134b9b1cfabcc5e6f802262863e26))
+* improve filesystem access and domain handling in utils ([f6a6154](https://github.com/decentralized-identity/didwebvh-ts/commit/f6a61548543f130a02e89008c880ceba307f28b6))
+* update examples and scripts for improved clarity and functionality ([4ff2465](https://github.com/decentralized-identity/didwebvh-ts/commit/4ff24652887d1c8c03f12af6ab4814051835b7f5))
+
+# [2.1.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.0.2...v2.1.0) (2025-05-23)
+
+
+### Features
+
+* add @noble/hashes dependency and refactor createHash function to use it ([4527738](https://github.com/decentralized-identity/didwebvh-ts/commit/45277380d9ea9bafd6d581e9fb123002f6be3795))
+
+## [2.0.2](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.0.1...v2.0.2) (2025-05-23)
+
+
+### Bug Fixes
+
+* update getFileUrl to use domain end index for URL construction ([b4aa3af](https://github.com/decentralized-identity/didwebvh-ts/commit/b4aa3af9e96a5ebae0a20fafab711f6ff261809f))
+
+## [2.0.1](https://github.com/decentralized-identity/didwebvh-ts/compare/v2.0.0...v2.0.1) (2025-04-25)
+
+
+### Bug Fixes
+
+* export resolveDIDFromLog ([eace3c8](https://github.com/decentralized-identity/didwebvh-ts/commit/eace3c82e2a72fe3e38e2ae7aa69b6e47f113d70))
+
+# [2.0.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v1.1.0...v2.0.0) (2025-03-24)
+
+
+### chore
+
+* Bump version ([377f423](https://github.com/decentralized-identity/didwebvh-ts/commit/377f4237ab5b79119d410d54f33b89b0307e007b))
+
+
+### BREAKING CHANGES
+
+* see previous
+
+# [1.1.0](https://github.com/decentralized-identity/didwebvh-ts/compare/v1.0.3...v1.1.0) (2025-03-24)
+
+
+### Bug Fixes
+
+* check SCID in DID matches log ([2590811](https://github.com/decentralized-identity/didwebvh-ts/commit/259081152b25960dd54ce3201a60e1fc7d7822db))
+* remove multiformats dep ([974224b](https://github.com/decentralized-identity/didwebvh-ts/commit/974224b5b1df23701f049b9926e73af66a28e9ba))
+* remove server ([2689012](https://github.com/decentralized-identity/didwebvh-ts/commit/2689012f81a547a8ac205ab9310af88ccf6d13ba))
+
+
+### Features
+
+* add Elysia and Express resolver examples with Ed25519 verification ([ea0b5fa](https://github.com/decentralized-identity/didwebvh-ts/commit/ea0b5fa6c8bf4b447e29e0554063f07d762e7ad5))
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2024-03-24
+
+### Added
+- New `Signer` interface for implementing custom signing logic
+- New `AbstractCrypto` class for easier signer implementation
+- New `SigningInput` and `SigningOutput` interfaces
+- New `SignerOptions` interface for configuring signers
+- New `createDocumentSigner` function for creating document signers
+- New example implementations in `src/examples`
+  - `elysia-signer.ts`: Example using `AbstractCrypto`
+  - `express-signer.ts`: Example implementing `Verifier` directly for HSM/KMS integration
+
+### Changed
+- Removed built-in cryptographic implementations
+- Made cryptographic functionality injectable through the `Signer` interface
+- Improved documentation and examples
+
+### Deprecated
+- `createSigner` function - use `createDocumentSigner` with your own `Signer` implementation instead
+- `generateEd25519VerificationMethod` - implement your own key generation logic
+- `generateX25519VerificationMethod` - implement your own key generation logic
+
+### Removed
+- `@noble/ed25519` dependency
+- `@noble/curves` dependency
+- Built-in Ed25519 signing implementation
+- Built-in key generation logic
+
+### Security
+- Users now have full control over cryptographic implementations
+- Better support for HSM and KMS integrations
+- Improved key management flexibility
+
+
+## [1.0.3](https://github.com/decentralized-identity/didwebvh-ts/compare/v1.0.2...v1.0.3) (2025-02-10)
+
+
+### Bug Fixes
+
+* remove build crypto inject ([2d8c184](https://github.com/decentralized-identity/didwebvh-ts/commit/2d8c1846978131a56ff42eae45950c8163357374))
+
+## [1.0.2](https://github.com/decentralized-identity/didwebvh-ts/compare/v1.0.1...v1.0.2) (2025-01-27)
+
+
+### Bug Fixes
+
+* bump version ([8194920](https://github.com/decentralized-identity/didwebvh-ts/commit/8194920f290a46857c8bb82a720b46fe6211baf1))
+
+# 1.0.0 (2025-01-27)
+
+
+### Bug Fixes
+
+* add github app to publish workflow ([59fc55a](https://github.com/decentralized-identity/didwebvh-ts/commit/59fc55a2568067d7eba952d9ac51adc29f7299db))
+* Fix release workflow ([2b429b4](https://github.com/decentralized-identity/didwebvh-ts/commit/2b429b4dcd52d1ebe9c9744a5903272ed4c406bb))
+* include dist folder recursively in publish ([f7b1cd5](https://github.com/decentralized-identity/didwebvh-ts/commit/f7b1cd514aa99b25f7bd2466283f95afa55ab9d1))
+* **package:** fix name ([e33ce21](https://github.com/decentralized-identity/didwebvh-ts/commit/e33ce2146615bc2fd2d300a425176e83acf334cd))
+* proper branch name for publish action ([ce39b9b](https://github.com/decentralized-identity/didwebvh-ts/commit/ce39b9b3b26ec49269f261a9a9fb8305d95872c8))
+* proper semantic release branch config ([343eec7](https://github.com/decentralized-identity/didwebvh-ts/commit/343eec76575deab7d579e6e8844128627ea70660))
+* release branch instead of main ([42db471](https://github.com/decentralized-identity/didwebvh-ts/commit/42db471500e4317b8442b808ae0cf3162599f040))
+* release config for semantic-release tool ([3f59d12](https://github.com/decentralized-identity/didwebvh-ts/commit/3f59d12ec1130967c345d27549506e4625a9d386))
+* releaserc.js file to module ([e750e7a](https://github.com/decentralized-identity/didwebvh-ts/commit/e750e7a3391c3e1e2fdb024b96bb1f56ff16bd0b))
+* trigger release ([2b4c1db](https://github.com/decentralized-identity/didwebvh-ts/commit/2b4c1db7e10c558b56a9e70eea8290c72d5d1c0e))
+* try forcing last release ([5b3360c](https://github.com/decentralized-identity/didwebvh-ts/commit/5b3360c5eedc1cf2abed5070cf0635a428b4ebed))
+
+
+### Features
+
+* add npm release ([8903f8d](https://github.com/decentralized-identity/didwebvh-ts/commit/8903f8d4edebc1cc7fe9c04e4c2b8d9ade12c1a3))
+* minor version bump ([0751250](https://github.com/decentralized-identity/didwebvh-ts/commit/0751250d006cc9c085d78ba66091f05d576f02f8))
+
+# @interop/did-method-webvh Changelog
+
+## 0.1.0 - 2025-01-10
+
+### Updated
+- Rename `tdw` to `webvh`.
+
+## 0.0.2 - 2024-04-04
+
+### Added
+- Add `options` to resolveDID.
+  - Option `versionId` to query specific version.
+  - Option `versionTime` to query specific time.
+
+## 0.0.1 - 2024-04-02
+
+### Added
+- Add initial files.

package/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.