Merge fa into master (#180)

* Remove license header (#140)

* Add migration guide (#141)

* Drop support for old Swift versions [SDK-3394] (#142)

* Drop support for old Swift versions

* Remove Xcode 12 from the build matrix

* Update year in license file (#144)

* Drop old platform versions (#143)

* Update README [SDK-3396] (#147)

* Update README

* Add First Availability label

* Remove ID token validator [SDK-3395] (#145)

* Remove ID token validator

* Add changes to migration guide

* Drop support for Objective-C [SDK-3405] (#149)

* Add `.swiftpm` to `.gitignore` (#151)

* Add CONTRIBUTING.md (#150)

* Add missing unit test (#146)

* Add missing test

* Add empty JSON body test case

* Add support policy [SDK-3403] (#148)

Add support policy

* Update API doc comments (#152)

* Move test files back to `JWTDecodeTests` (#154)

* Update the library description (#153)

Update library description

* Add subscript getter for claims [SDK-3421] (#156)

* Update playground (#157)

* Improve display of `DecodeError` [SDK-3427] (#158)

* Improve errors

* Remove extra whitespace

* Apply recommended Xcode 14 settings (#159)

* Improve API docs (#160)

* [SDK-3434] Update issues templates (#161)

* [SDK-3434] Update issue templates

* Remove "FAQ.md" reference, as there is no file

* Update .github/ISSUE_TEMPLATE/Bug Report.yml

* Update .github/ISSUE_TEMPLATE/Bug Report.yml

* Update .github/ISSUE_TEMPLATE/Feature Request.yml

* Update .github/ISSUE_TEMPLATE/Feature Request.yml

* Update .github/ISSUE_TEMPLATE/config.yml

* Update .github/ISSUE_TEMPLATE/config.yml

* Update checklist grouping

* Update pull request template

Co-authored-by: Rita Zerrizuela <[email protected]>

* Rename `DecodeError` and error case (#162)

* Use SUT terminology in unit tests (#163)

* Add DocC API generation

* Ignore docs.archive subfolder for temp data

* Add to shiprc

* Implement feedback

* Add generated API documentation to repo

* Update generated API documentation for repo

* Improve API docs generation (#167)

* Re-generate API docs (#169)

* Link to the API docs from the README (#168)

* Release 3.0.0-fa.0 (#170)

* Use Codecov orb (#173)

* Replace OSX with macOS in schemes and targets (#175)

* Add placeholders to issue forms (#176)

* Update README for GA [SDK-3499] (#177)

Update README for GA

* Merge `master` into `fa` (#178)

Co-authored-by: Evan Sims <[email protected]>
Co-authored-by: Evan Sims <[email protected]>

Author: 3 people

.circleci/config.yml

@@ -1,5 +1,8 @@
 version: 2.1
 
+orbs:
+  codecov: codecov/codecov@3
+
 executors:
   macos-executor:
     parameters:
@@ -62,8 +65,10 @@ commands:
           name: Run iOS tests
           command: bundle exec fastlane ios ci
       - run:
-          name: Upload coverage report
-          command: bash <(curl -s https://codecov.io/bash) -J '<< parameters.scheme >>'
+          name: Generate coverage report
+          command: bundle exec slather coverage -x --output-directory output --arch x86_64 --scheme << parameters.scheme >>-iOS << parameters.scheme >>.xcodeproj
+      - codecov/upload:
+          file: output/cobertura.xml
       - run:
           name: Run pod lib lint
           command: bundle exec fastlane ios pod_lint
@@ -79,7 +84,7 @@ commands:
       - run:
           name: Run macOS tests
           command: |
-            xcodebuild test -scheme << parameters.scheme >>-OSX -destination 'platform=macOS,arch=x86_64' | xcpretty
+            xcodebuild test -scheme << parameters.scheme >>-macOS -destination 'platform=macOS,arch=x86_64' | xcpretty
             swift test
   test-tvos:
     parameters:
@@ -129,8 +134,8 @@ workflows:
   build:
     jobs:
       - build-test:
-          scheme: "JWTDecode"
+          scheme: JWTDecode
           matrix:
             parameters:
-              platform: ["ios", "macos", "tvos"]
-              xcode: ["13.0.0", "12.5.1"]
+              platform: [ios, macos, tvos]
+              xcode: ["13.0.0"]

.github/ISSUE_TEMPLATE/Bug Report.yml

@@ -0,0 +1,84 @@
+name: 🐞 Report a bug
+description: Have you found a bug or issue? Create a bug report for this library
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Please do not report security vulnerabilities here**. The [Responsible Disclosure Program](https://auth0.com/responsible-disclosure-policy) details the procedure for disclosing security issues.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have looked into the [README](https://github.com/auth0/JWTDecode.swift#readme) and have not found a suitable solution or answer.
+          required: true
+        - label: I have searched the [issues](https://github.com/auth0/JWTDecode.swift/issues) and have not found a suitable solution or answer.
+          required: true
+        - label: I have searched the [Auth0 Community](https://community.auth0.com/tags/c/sdks/5/jwt) forums and have not found a suitable solution or answer.
+          required: true
+        - label: I agree to the terms within the [Auth0 Code of Conduct](https://github.com/auth0/open-source-template/blob/master/CODE-OF-CONDUCT.md).
+          required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Provide a clear and concise description of the issue, including what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Detail the steps taken to reproduce this error, and whether this issue can be reproduced consistently or if it is intermittent.
+      placeholder: |
+        1. Step 1...
+        2. Step 2...
+        3. ...
+    validations:
+      required: true
+
+  - type: input
+    id: environment-version
+    attributes:
+      label: JWTDecode.swift version
+    validations:
+      required: true
+
+  - type: dropdown
+    id: environment-platform
+    attributes:
+      label: Platform
+      multiple: true
+      options:
+        - iOS
+        - macOS
+        - tvOS
+        - watchOS
+    validations:
+      required: true
+
+  - type: input
+    id: environment-platform-version
+    attributes:
+      label: Platform version(s)
+    validations:
+      required: true
+
+  - type: input
+    id: environment-xcode-version
+    attributes:
+      label: Xcode version
+    validations:
+      required: true
+
+  - type: input
+    id: environment-package-manager
+    attributes:
+      label: Package manager
+      placeholder: SPM, Cocoapods, Carthage, etc.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/Feature Request.yml

@@ -0,0 +1,51 @@
+name: 🧩 Feature request
+description: Suggest an idea or a feature for this library
+labels: ["feature request"]
+
+body:
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have looked into the [README](https://github.com/auth0/JWTDecode.swift#readme) and have not found a suitable solution or answer.
+          required: true
+        - label: I have searched the [issues](https://github.com/auth0/JWTDecode.swift/issues) and have not found a suitable solution or answer.
+          required: true
+        - label: I have searched the [Auth0 Community](https://community.auth0.com/tags/c/sdks/5/jwt) forums and have not found a suitable solution or answer.
+          required: true
+        - label: I agree to the terms within the [Auth0 Code of Conduct](https://github.com/auth0/open-source-template/blob/master/CODE-OF-CONDUCT.md).
+          required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the problem you'd like to have solved
+      description: A clear and concise description of what the problem is.
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: ideal-solution
+    attributes:
+      label: Describe the ideal solution
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives-and-workarounds
+    attributes:
+      label: Alternatives and current workarounds
+      description: A clear and concise description of any alternatives you've considered or any workarounds that are currently in place.
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,11 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Auth0 Community
+  - name: 🤔 Help & Questions
     url: https://community.auth0.com/tags/c/sdks/5/jwt
-    about: Discuss this library in the Auth0 Community forums
+    about: Ask general support or usage questions in the Auth0 Community forums
+  - name: 🚀 Usage
+    url: https://github.com/auth0/JWTDecode.swift#usage
+    about: Check the Usage section of the README to get up to speed with JWTDecode.swift
+  - name: 📖 API Documentation
+    url: https://auth0.github.io/JWTDecode.swift/
+    about: Check the public API documentation for in-depth overview of all the available features

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,32 +1,40 @@
-### Changes
+<!--
+❗ For general support or usage questions, use the Auth0 Community forums or raise a support ticket.
 
-Please describe both what is changing and why this is important. Include:
+By submitting a Pull Request to this repository, you agree to the terms within the Auth0 Code of Conduct: https://github.com/auth0/open-source-template/blob/master/CODE-OF-CONDUCT.md.
+-->
 
-- Endpoints added, deleted, deprecated, or changed
-- Classes and methods added, deleted, deprecated, or changed
-- Screenshots of new or changed UI, if applicable
-- A summary of usage if this is a new feature or change to a public API (this should also be added to relevant documentation once released)
+- [ ] All new/changed/fixed functionality is covered by tests (or N/A)
+- [ ] I have added documentation for all new/changed functionality (or N/A)
 
-### References
+<!--
+❗ All the above items are required. Pull Requests with an incomplete or missing checklist will be unceremoniously closed.
+-->
 
-Please include relevant links supporting this change such as a:
+### 📋 Changes
 
-- support ticket
-- community post
-- StackOverflow post
-- support forum thread
+<!--
+Describe both what is changing and why this is important. Include:
 
-Please note any links that are not publicly accessible.
+- Types and methods added, deleted, deprecated, or changed
+- A summary of usage if this is a new feature or a change to a public API
+-->
 
-### Testing
+### 📎 References
 
-Please describe how this can be tested by reviewers. Be specific about anything not tested and reasons why. If this library has unit and/or integration testing, tests should be added for new functionality and existing tests should complete without errors.
+<!--
+Add relevant links supporting this change, such as:
 
-* [ ] This change adds unit test coverage
-* [ ] This change has been tested on the latest version of the platform/language or why not
+- GitHub issue/PR number addressed or fixed
+- Auth0 Community post
+- StackOverflow answer
+- Related pull requests/issues from other repositories
 
-### Checklist
+If there are no references, simply delete this section.
+-->
 
-* [ ] I have read the [Auth0 general contribution guidelines](https://github.com/auth0/open-source-template/blob/master/GENERAL-CONTRIBUTING.md)
-* [ ] All existing and new tests complete without errors
-* [ ] All active GitHub checks have passed
+### 🎯 Testing
+
+<!--
+Describe how this can be tested by reviewers. Be specific about anything not tested and why. Include any manual steps for testing end-to-end, or for testing functionality not covered by unit tests.
+-->

.github/ISSUE_TEMPLATE/report-a-bug.md

@@ -61,6 +61,7 @@ playground.xcworkspace
 #
 # Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
 # Packages/
+.swiftpm/
 .build/
 Package.resolved
 
@@ -93,4 +94,7 @@ fastlane/test_output
 fastlane/README.md
 
 # Playground Timeline
-timeline.xctimeline
+timeline.xctimeline
+
+# Documentation generation
+docs.archive/

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,9 +1,11 @@
 {
-    "files": {
-        "JWTDecode/Info.plist": [],
-        "JWTDecode.podspec": [],
-        "README.md": ["~> {MAJOR}.{MINOR}"]
-    },
-    "postbump": "bundle update",
-    "prefixVersion": false
+  "files": {
+    "JWTDecode/Info.plist": [],
+    "JWTDecode.podspec": [],
+    "README.md": [
+      "~> {MAJOR}.{MINOR}"
+    ]
+  },
+  "postbump": "bundle update && bundle exec fastlane ios build_docs",
+  "prefixVersion": false
 }