TSM-05: convert base service hydration layer to TypeScript

src/models/easypost_object.ts

@@ -0,0 +1,32 @@
+/**
+ * An EasyPostObject is the base class for all EasyPost API resources.
+ * @internal
+ * @abstract
+ */
+export default class EasyPostObject {
+  static id: string;
+  static object: string;
+  static mode: string;
+  static created_at: string;
+  static updated_at: string;
+  static _params: Record<string, unknown>;
+
+  static [Symbol.hasInstance](instance: unknown): boolean {
+    if (instance == null || typeof instance !== 'object') {
+      return false;
+    }
+
+    const modelConstructor = (instance as Record<symbol, unknown>)[
+      Symbol.for('easypost.modelConstructor')
+    ];
+    if (typeof modelConstructor === 'function') {
+      return modelConstructor === this;
+    }
+
+    // Fallback for plain API payloads that include object names like "Address" or "Shipment".
+    return (
+      typeof (instance as Record<string, unknown>).object === 'string' &&
+      (instance as Record<string, unknown>).object === this.name
+    );
+  }
+}

src/services/base_service.js → src/services/base_service.ts

@@ -207,7 +207,7 @@ export default (easypostClient) =>
      * @param {*} params The parameters passed when fetching the response.
      * @returns {*} A plain object or array suitable for JSON serialization.
      */
-    static _convertToEasyPostObject(response, params) {
+    static _convertToEasyPostObject(response, params = {}) {
       const modelResponse = this._buildEasyPostObject(response, params);
 
       return this._toPlainEasyPostObject(modelResponse);