TSM-92: enable noImplicitAny and harden typing

src/easypost.ts

@@ -48,11 +48,11 @@ type HttpClient = typeof fetch;
 interface CompatibilityRequest {
   method: string;
   url: string;
-  _data: unknown;
+  _data: Record<string, unknown> | undefined;
   set(headersToSet?: RequestHeaders): CompatibilityRequest;
   auth(key: string): CompatibilityRequest;
   query(queryParams?: Record<string, unknown>): CompatibilityRequest;
-  send(body?: unknown): CompatibilityRequest;
+  send(body?: Record<string, unknown>): CompatibilityRequest;
 }
 
 interface HttpMiddleware {
@@ -415,7 +415,7 @@ export default class EasyPostClient {
     const isQueryMethod =
       normalizedMethod === EasyPostClient.METHODS.GET ||
       normalizedMethod === EasyPostClient.METHODS.DELETE;
-    let requestBody;
+    let requestBody: Record<string, unknown> | undefined;
 
     if (params !== undefined) {
       if (isQueryMethod) {
@@ -427,15 +427,15 @@ export default class EasyPostClient {
       }
     }
 
-    const compatibilityRequest = {
+    const compatibilityRequest: CompatibilityRequest = {
       method: normalizedMethod.toUpperCase(),
       url: url.toString(),
       _data: requestBody,
       set: (headersToSet = {}) => {
         Object.assign(requestHeaders, headersToSet);
         return compatibilityRequest;
       },
-      auth: (key) => {
+      auth: (key: string) => {
         requestHeaders.Authorization = `Basic ${EasyPostClient._toBase64(`${key}:`)}`;
         return compatibilityRequest;
       },
@@ -446,7 +446,7 @@ export default class EasyPostClient {
         compatibilityRequest.url = url.toString();
         return compatibilityRequest;
       },
-      send: (body = {}) => {
+      send: (body: Record<string, unknown> = {}) => {
         compatibilityRequest._data = body;
         return compatibilityRequest;
       },
@@ -466,7 +466,7 @@ export default class EasyPostClient {
       }
     }
 
-    let middlewareResponse;
+    let middlewareResponse: any;
 
     if (
       this.requestMiddleware &&

src/services/address_service.ts

@@ -1,5 +1,6 @@
 import baseService from './base_service';
 import Address from '../models/address';
+import type EasyPostClient from '../easypost';
 
 type AddressCreateParameters = Record<string, unknown> & {
   name?: string | null;
@@ -23,7 +24,7 @@ type AddressCreateParameters = Record<string, unknown> & {
 type PaginationCollection = Record<string, unknown>;
 type AddressCollection = { addresses: Address[]; has_more: boolean };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The AddressService class provides methods for interacting with EasyPost {@link Address} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/api_key_service.ts

@@ -1,4 +1,5 @@
 import util from 'util';
+import type EasyPostClient from '../easypost';
 
 import Constants from '../constants';
 import FilteringError from '../errors/general/filtering_error';
@@ -12,7 +13,7 @@ type ApiKeyUser = Record<string, unknown> & {
 };
 type ApiKeyAllResponse = Record<string, unknown>;
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The ApiKeyService class provides methods for interacting with EasyPost {@link ApiKey} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/base_service.ts

@@ -99,7 +99,7 @@ const RESOURCES = {
   Webhook,
 };
 
-export default (easypostClient) =>
+export default (easypostClient: any) =>
   /**
    * The base class for all EasyPost client library services.
    * @param {EasyPostClient} easypostClient The {@link EasyPostClient} instance to use for API calls.
@@ -112,13 +112,13 @@ export default (easypostClient) =>
      * @param {*} response The value to serialize.
      * @returns {*} A plain object/array/scalar.
      */
-    static _toPlainEasyPostObject(response) {
+    static _toPlainEasyPostObject(response: any): any {
       if (Array.isArray(response)) {
         return response.map((value) => this._toPlainEasyPostObject(value));
       }
 
       if (typeof response === 'object' && response !== null) {
-        const plainObject = {};
+        const plainObject: Record<string, any> = {};
         const prototype = Object.getPrototypeOf(response);
 
         if (prototype && prototype !== Object.prototype) {
@@ -145,8 +145,10 @@ export default (easypostClient) =>
           });
         }
 
-        Object.keys(response).forEach((key) => {
-          plainObject[key] = this._toPlainEasyPostObject(response[key]);
+        Object.keys(response as Record<string, unknown>).forEach((key) => {
+          plainObject[key] = this._toPlainEasyPostObject(
+            (response as Record<string, unknown>)[key],
+          );
         });
 
         return plainObject;
@@ -162,7 +164,7 @@ export default (easypostClient) =>
      * @param {*} params The parameters passed when fetching the response.
      * @returns {*} An {@link EasyPostObject}-based class instance or an `Array` of {@link EasyPostObject}-based class instances.
      */
-    static _buildEasyPostObject(response, params) {
+    static _buildEasyPostObject(response: any, params: any): any {
       if (Array.isArray(response)) {
         return response.map((value) => {
           if (typeof value === 'object') {
@@ -173,23 +175,26 @@ export default (easypostClient) =>
       }
 
       if (typeof response === 'object' && response !== null) {
-        let classObject;
-        if (RESOURCES[response.object] !== undefined) {
-          classObject = new RESOURCES[response.object]();
+        const responseRecord = response as Record<string, any>;
+        let classObject: any;
+        if ((RESOURCES as Record<string, any>)[responseRecord.object] !== undefined) {
+          classObject = new (RESOURCES as Record<string, any>)[responseRecord.object]();
         } else if (
-          response.id !== undefined &&
-          EASYPOST_OBJECT_ID_PREFIX_TO_CLASS_NAME_MAP[
-            response.id.substr(0, response.id.indexOf('_'))
+          responseRecord.id !== undefined &&
+          (EASYPOST_OBJECT_ID_PREFIX_TO_CLASS_NAME_MAP as Record<string, any>)[
+            responseRecord.id.substr(0, responseRecord.id.indexOf('_'))
           ] !== undefined
         ) {
-          const className = response.id.substr(0, response.id.indexOf('_'));
-          classObject = new EASYPOST_OBJECT_ID_PREFIX_TO_CLASS_NAME_MAP[className]();
+          const className = responseRecord.id.substr(0, responseRecord.id.indexOf('_'));
+          classObject = new (EASYPOST_OBJECT_ID_PREFIX_TO_CLASS_NAME_MAP as Record<string, any>)[
+            className
+          ]();
         } else {
           classObject = new EasyPostObject();
         }
 
-        Object.keys(response).forEach((key) => {
-          classObject[key] = this._buildEasyPostObject(response[key], params);
+        Object.keys(responseRecord).forEach((key) => {
+          classObject[key] = this._buildEasyPostObject(responseRecord[key], params);
         });
 
         classObject._params = params;
@@ -220,7 +225,7 @@ export default (easypostClient) =>
      * @param {Object} params The parameters to send with the API request.
      * @returns {EasyPostObject|Promise<never>} The created {@link EasyPostObject}-based class instance, or a `Promise` that rejects with an error.
      */
-    static async _create(url, params) {
+    static async _create(url: string, params: any) {
       try {
         const response = await easypostClient._post(url, params);
 
@@ -237,7 +242,7 @@ export default (easypostClient) =>
      * @param {Object} [params] The parameters to send with the API request.
      * @returns {EasyPostObject|EasyPostObject[]|Promise<never>} The retrieved {@link EasyPostObject}-based class instance(s), or a `Promise` that rejects with an error.
      */
-    static async _all(url, params = {}) {
+    static async _all(url: string, params: any = {}) {
       try {
         // eslint-disable-next-line no-param-reassign
         const response = await easypostClient._get(url, params);
@@ -254,7 +259,7 @@ export default (easypostClient) =>
      * @param {string} url The URL to send the API request to.
      * @returns {EasyPostObject|Promise<never>} The retrieved {@link EasyPostObject}-based class instance, or a `Promise` that rejects with an error.
      */
-    static async _retrieve(url) {
+    static async _retrieve(url: string) {
       try {
         const response = await easypostClient._get(url);
 

src/services/batch_service.ts

@@ -1,5 +1,6 @@
 import baseService from './base_service';
 import Batch from '../models/batch';
+import type EasyPostClient from '../easypost';
 
 export const DEFAULT_LABEL_FORMAT = 'pdf';
 
@@ -8,7 +9,7 @@ type BatchCreateParameters = Record<string, unknown> & {
 };
 type BatchListResponse = { batches: Batch[]; has_more: boolean };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The BatchService class provides methods for interacting with EasyPost {@link Batch} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/beta_rate_service.ts

@@ -1,16 +1,17 @@
 import baseService from './base_service';
+import type EasyPostClient from '../easypost';
 
 /**
  * @extends baseService
  */
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   class BetaRateService extends baseService(easypostClient) {
     /**
      * Retrieve a list of stateless {@link Rate rates} based on the provided parameters.
      * @param {Object} params - Map of parameters for the API call
      * @returns {Rate[]} - List of stateless rates
      */
-    static async retrieveStatelessRates(params) {
+    static async retrieveStatelessRates(params: Record<string, unknown>) {
       const url = 'beta/rates';
       const wrappedParams = {
         shipment: params,

src/services/beta_referral_customer_service.ts

@@ -1,10 +1,11 @@
 import baseService from './base_service';
+import type EasyPostClient from '../easypost';
 
 type BetaPaymentMethodResponse = Record<string, unknown>;
 type BetaRefundResponse = Record<string, unknown>;
 type BetaClientSecretResponse = Record<string, unknown>;
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   class BetaReferralCustomerService extends baseService(easypostClient) {
     /**
      * Add an existing Stripe payment method to a {@link User referral customer's} account.
@@ -74,7 +75,10 @@ export default (easypostClient) =>
     static async createCreditCardClientSecret(): Promise<BetaClientSecretResponse> {
       const url = 'beta/setup_intents';
 
-      const response = await easypostClient._post(url, null);
+      // Preserve legacy null payload behavior for cassette matching in tests.
+      const emptyPayload = null as unknown as Record<string, unknown>;
+
+      const response = await easypostClient._post(url, emptyPayload);
 
       return response.body;
     }
@@ -86,7 +90,9 @@ export default (easypostClient) =>
     static async createBankAccountClientSecret(
       returnUrl: string | null,
     ): Promise<BetaClientSecretResponse> {
-      const params = returnUrl ? { return_url: returnUrl } : null;
+      const params = returnUrl
+        ? { return_url: returnUrl }
+        : (null as unknown as Record<string, unknown>);
 
       const url = 'beta/financial_connections_sessions';
 

src/services/billing_service.ts

@@ -1,6 +1,7 @@
 import Constants from '../constants';
 import InvalidObjectError from '../errors/general/invalid_object_error';
 import baseService from './base_service';
+import type EasyPostClient from '../easypost';
 
 type PaymentMethodObject = {
   id: string;
@@ -13,7 +14,7 @@ type PaymentMethodsResponse = Record<string, unknown> & {
   secondary_payment_method?: PaymentMethodObject | null;
 };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The BillingService class provides methods for interacting with EasyPost's billing capabilities.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/carrier_account_service.ts

@@ -1,4 +1,5 @@
 import util from 'util';
+import type EasyPostClient from '../easypost';
 
 import Constants from '../constants';
 import InvalidParameterError from '../errors/general/invalid_parameter_error';
@@ -17,7 +18,7 @@ type CarrierAccountCreateParameters = Record<string, unknown> & {
   billing_type?: string | null;
 };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The CarrierAccountService class provides methods for interacting with EasyPost @{link CarrierAccount} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/carrier_metadata_service.ts

@@ -1,11 +1,12 @@
 import baseService from './base_service';
+import type EasyPostClient from '../easypost';
 
 type CarrierMetadata = Record<string, unknown>;
 
 /**
  * @extends baseService
  */
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   class CarrierMetadataService extends baseService(easypostClient) {
     /**
      * Retrieve a list of carrier metadata based on the provided parameters.

src/services/carrier_type_service.ts

@@ -1,7 +1,8 @@
 import baseService from './base_service';
 import CarrierType from '../models/carrier_type';
+import type EasyPostClient from '../easypost';
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The CarrierTypeService class provides methods for interacting with EasyPost {@link CarrierType} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/claim_service.ts

@@ -1,5 +1,6 @@
 import baseService from './base_service';
 import Claim from '../models/claim';
+import type EasyPostClient from '../easypost';
 
 type ClaimCreateParameters = Record<string, unknown> & {
   tracking_code?: string | null;
@@ -16,7 +17,7 @@ type ClaimCreateParameters = Record<string, unknown> & {
 type ClaimCollection = Record<string, unknown>;
 type ClaimListResponse = { claims: Claim[]; has_more: boolean };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The ClaimService class provides methods for interacting with EasyPost {@link Claim} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/customer_portal_service.ts

@@ -1,5 +1,6 @@
 import baseService from './base_service';
-import type { ICustomerPortalAccountLink } from '../../types/CustomerPortal/CustomerPortalAccountLink';
+import type EasyPostClient from '../easypost';
+type ICustomerPortalAccountLink = Record<string, unknown>;
 
 type CustomerPortalAccountLinkCreateParameters = Record<string, unknown> & {
   session_type?: 'account_onboarding' | 'account_management' | null;
@@ -9,7 +10,7 @@ type CustomerPortalAccountLinkCreateParameters = Record<string, unknown> & {
   metadata?: Record<string, unknown> | null;
 };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The CustomerPortalService class provides methods for interacting with EasyPost {@link Tracker} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/customs_info_service.ts

@@ -1,5 +1,6 @@
 import baseService from './base_service';
 import CustomsInfo from '../models/customs_info';
+import type EasyPostClient from '../easypost';
 
 type CustomsItemInput = Record<string, unknown>;
 
@@ -16,7 +17,7 @@ type CustomsInfoCreateParameters = Record<string, unknown> & {
   declaration?: string | null;
 };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The CustomsInfoService class provides methods for interacting with EasyPost {@link CustomsInfo} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.

src/services/customs_item_service.ts

@@ -1,5 +1,6 @@
 import baseService from './base_service';
 import CustomsItem from '../models/customs_item';
+import type EasyPostClient from '../easypost';
 
 type CustomsItemCreateParameters = Record<string, unknown> & {
   description?: string | null;
@@ -12,7 +13,7 @@ type CustomsItemCreateParameters = Record<string, unknown> & {
   currency?: string | null;
 };
 
-export default (easypostClient) =>
+export default (easypostClient: EasyPostClient) =>
   /**
    * The CustomsItemService class provides methods for interacting with EasyPost {@link CustomsItem} objects.
    * @param {EasyPostClient} easypostClient - The pre-configured EasyPostClient instance to use for API requests with this service.