Sm/mdapi-fault-handler (#642)

* feat: handle transient mdapi error

* chore: auto-update metadata coverage in METADATA_SUPPORT.md

* test: mdapi error handling

Author: mshanemc

METADATA_SUPPORT.md

@@ -511,7 +511,9 @@ v56 introduces the following new types.  Here's their current level of support
 |:---|:---|:---|
 |AccountingSettings|✅||
 |CollectionsDashboardSettings|✅||
+|CustomizablePropensityScoringSettings|✅||
 |MfgServiceConsoleSettings|✅||
+|OauthOidcSettings|✅||
 
 ## Additional Types
 

src/client/metadataTransfer.ts

@@ -217,6 +217,13 @@ export abstract class MetadataTransfer<Status extends MetadataRequestStatus, Res
         }
       } catch (e) {
         this.logger.error(e);
+        // tolerate a known mdapi problem 500/INVALID_CROSS_REFERENCE_KEY: invalid cross reference id
+        // that happens when request moves out of Pending
+        if (e instanceof Error && e.name === 'JsonParseError') {
+          this.logger.debug('Metadata API response not parseable', e);
+          await Lifecycle.getInstance().emitWarning('Metadata API response not parseable');
+          return { completed: false };
+        }
         // tolerate intermittent network errors upto retry limit
         if (
           ['ETIMEDOUT', 'ENOTFOUND', 'ECONNRESET', 'socket hang up'].some((retryableNetworkError) =>

test/client/metadataTransfer.test.ts

@@ -300,6 +300,18 @@ describe('MetadataTransfer', () => {
       expect(checkStatus.callCount).to.equal(3);
     });
 
+    it('should tolerate known mdapi error', async () => {
+      const { checkStatus } = operation.lifecycle;
+      const networkError1 = new Error('foo');
+      networkError1.name = 'JsonParseError';
+      checkStatus.onFirstCall().throws(networkError1);
+      checkStatus.onSecondCall().throws(networkError1);
+      checkStatus.onThirdCall().resolves({ done: true });
+
+      await operation.pollStatus();
+      expect(checkStatus.callCount).to.equal(3);
+    });
+
     it('should throw wrapped error if there are no error listeners', async () => {
       const { checkStatus } = operation.lifecycle;
       const originalError = new Error('whoops');