feat: typescript testing, correcting typescript errors (#542)

# Description

- Adds missing Typescript params for FedEx MFA
- I realized that we don't actually test if the Typescript definitions
in this project are valid, we now run the Typescript compiler (`just
typescript`) to ensure syntax errors can't pass into prod (doing so
exposed a couple small issues that needed to be fixed in the
definitions)
- Bumps dependencies to get Typescript happy with config added
- Removes a couple of lingering references to the removed `repl`
- Bumps version to release FedEx MFA

<!-- Please provide a general summary of your PR changes and link any
related issues or other pull requests. -->

# Testing

`just typescript` now runs on CI to catch future errors, fixed the ones
it caught here.
<!--
Please provide details on how you tested this code. See below.

- All pull requests must be tested (unit tests where possible with
accompanying cassettes, or provide a screenshot of end-to-end testing
when unit tests are not possible)
- New features must get a new unit test
- Bug fixes/refactors must re-record existing cassettes
-->

# Pull Request Type

Please select the option(s) that are relevant to this PR.

- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Improvement (fixing a typo, updating readme, renaming a variable
name, etc)

Author: Justintime50

.github/workflows/ci.yml

@@ -23,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x, 17.x, 18.x, 19.x, 20.x, 21.x, 22.x, 24.x]
+        node-version: [16.x, 17.x, 18.x, 19.x, 20.x, 21.x, 22.x, 23.x, 24.x, 25.x]
     steps:
       - uses: actions/checkout@v6
       - uses: extractions/setup-just@v3
@@ -35,6 +35,20 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
       - run: EASYPOST_TEST_API_KEY=123 EASYPOST_PROD_API_KEY=123 just test-node-compatibility
+  # typescript checks that the our Typescript definitions can be compiled without errors
+  typescript:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: extractions/setup-just@v3
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+      - run: |
+          cd types/demo
+          npm install
+          cd ../../
+          just install install-styleguide typescript
   lint:
     runs-on: ubuntu-latest
     steps:

CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## v8.6.0 (2026-02-20)
+
+- Adds the following functions:
+  - `FedExRegistration.registerAddress`
+  - `FedExRegistration.requestPin`
+  - `FedExRegistration.validatePin`
+  - `FedExRegistration.submitInvoice`
+- Corrects additional Typescript definitions (eg: reference to `Rate` on `Shipment`, `Claim` missing `reference`)
+  - Adds automated testing to catch Typescript errors in the future
+- Bumps dependencies
+
 ## v8.5.0 (2026-02-03)
 
 - Adds the following functions usable by child and referral customer users:
@@ -14,8 +25,8 @@
 ## v8.4.0 (2025-11-24)
 
 - Adds the following functions:
-  - `embeddable.createSession`
-  - `customerPortal.createAccountLink`
+  - `Embeddable.createSession`
+  - `CustomerPortal.createAccountLink`
 - Bumps dependencies
 
 ## v8.3.0 (2025-11-10)

README.md

@@ -159,14 +159,6 @@ const client = new EasyPostClient('my-key', {
 });
 ```
 
-### Interactive CLI
-
-Replace `easypost.js` with whatever compatible version you wish, as defined under `Compatibility`.
-
-```bash
-API_KEY=yourkey ./repl.js --local easypost.js
-```
-
 ### HTTP Hooks
 
 If you would need or want to view what requests are being made to the EasyPost API behind the scenes, you can provide functions to listen for the request and/or responses. This can be done with helper functions on the created client.

audit-ci.jsonc

@@ -3,5 +3,5 @@
   // Only fail the audit if there are critical vulnerabilities.
   "critical": true,
   // Can't update ESLint yet because we must support Node 16
-  "allowlist": ["GHSA-p5wg-g6qr-c7cg"],
+  "allowlist": ["GHSA-p5wg-g6qr-c7cg", "GHSA-2g4f-4pwh-qvx6", "GHSA-3ppc-4f35-3m26"],
 }

justfile

@@ -75,6 +75,10 @@ test:
 test-node-compatibility:
     npm run test:node-compatibility
 
+# Run the TypeScript compiler to check for type errors
+typescript:
+    npm run typescript
+
 # Update dependencies (Unix only)
 update: update-examples-submodule
     npm update