feat(ref-imp): add array support for serviceEndpoint

Author: nikolockenvitz

lib/core/versions/latest/DocumentComposer.ts

@@ -345,22 +345,26 @@ export default class DocumentComposer {
       }
 
       // `serviceEndpoint` validations.
-      const serviceEndpoint = service.serviceEndpoint;
-      if (typeof serviceEndpoint === 'string') {
-        const uri = URI.parse(service.serviceEndpoint);
-        if (uri.error !== undefined) {
-          throw new SidetreeError(
-            ErrorCode.DocumentComposerPatchServiceEndpointStringNotValidUri,
-            `Service endpoint string '${serviceEndpoint}' is not a valid URI.`
-          );
-        }
-      } else if (typeof serviceEndpoint === 'object') {
-        // Allow `object` type only if it is not an array.
-        if (Array.isArray(serviceEndpoint)) {
-          throw new SidetreeError(ErrorCode.DocumentComposerPatchServiceEndpointCannotBeAnArray);
+      // transform URI strings and JSON objects into array so that we can run validations more easily
+      const serviceEndpointValueAsArray = Array.isArray(service.serviceEndpoint) ? service.serviceEndpoint : [service.serviceEndpoint];
+      for (const serviceEndpoint of serviceEndpointValueAsArray) {
+        // serviceEndpoint itself must be URI string or non-array object
+        if (typeof serviceEndpoint === 'string') {
+          const uri = URI.parse(serviceEndpoint);
+          if (uri.error !== undefined) {
+            throw new SidetreeError(
+              ErrorCode.DocumentComposerPatchServiceEndpointStringNotValidUri,
+              `Service endpoint string '${serviceEndpoint}' is not a valid URI.`
+            );
+          }
+        } else if (typeof serviceEndpoint === 'object') {
+          // Allow `object` type only if it is not an array.
+          if (Array.isArray(serviceEndpoint)) {
+            throw new SidetreeError(ErrorCode.DocumentComposerPatchServiceEndpointCannotBeAnArray);
+          }
+        } else {
+          throw new SidetreeError(ErrorCode.DocumentComposerPatchServiceEndpointMustBeStringOrNonArrayObject);
         }
-      } else {
-        throw new SidetreeError(ErrorCode.DocumentComposerPatchServiceEndpointMustBeStringOrNonArrayObject);
       }
     }
   }

lib/core/versions/latest/models/ServiceModel.ts

@@ -4,5 +4,5 @@
 export default interface ServiceModel {
   id: string;
   type: string;
-  serviceEndpoint: string | object;
+  serviceEndpoint: string | object | Array<string | object>;
 }

tests/core/DocumentComposer.spec.ts

@@ -469,7 +469,7 @@ describe('DocumentComposer', async () => {
       DocumentComposer['validateAddServicesPatch'](patch);
     });
 
-    it('should throw error if `serviceEndpoint` is an array.', () => {
+    it('should allow an array as `serviceEndpoint`.', () => {
       const patch = {
         action: PatchAction.AddServices,
         services: [{
@@ -478,6 +478,20 @@ describe('DocumentComposer', async () => {
           serviceEndpoint: []
         }]
       };
+
+      // Expecting this call to succeed without errors.
+      DocumentComposer['validateAddServicesPatch'](patch);
+    });
+
+    it('should throw error if `serviceEndpoint` is an array that includes an array.', () => {
+      const patch = {
+        action: PatchAction.AddServices,
+        services: [{
+          id: 'someId',
+          type: 'someType',
+          serviceEndpoint: [[]] // array must contain URI strings or objects but not arrays
+        }]
+      };
       const expectedError = new SidetreeError(ErrorCode.DocumentComposerPatchServiceEndpointCannotBeAnArray);
       expect(() => { DocumentComposer['validateAddServicesPatch'](patch); }).toThrow(expectedError);
     });
@@ -495,6 +509,19 @@ describe('DocumentComposer', async () => {
       expect(() => { DocumentComposer['validateAddServicesPatch'](patch); }).toThrow(expectedError);
     });
 
+    it('should throw error if `serviceEndpoint` has an invalid type (inside an array).', () => {
+      const patch = {
+        action: PatchAction.AddServices,
+        services: [{
+          id: 'someId',
+          type: 'someType',
+          serviceEndpoint: [123] // Invalid serviceEndpoint type.
+        }]
+      };
+      const expectedError = new SidetreeError(ErrorCode.DocumentComposerPatchServiceEndpointMustBeStringOrNonArrayObject);
+      expect(() => { DocumentComposer['validateAddServicesPatch'](patch); }).toThrow(expectedError);
+    });
+
     it('Should throw if `serviceEndpoint` is not valid URI.', () => {
       const patch = {
         action: PatchAction.AddServices,
@@ -510,6 +537,22 @@ describe('DocumentComposer', async () => {
         ErrorCode.DocumentComposerPatchServiceEndpointStringNotValidUri
       );
     });
+
+    it('Should throw if `serviceEndpoint` is not valid URI (inside an array).', () => {
+      const patch = {
+        action: PatchAction.AddServices,
+        services: [{
+          id: 'someId',
+          type: 'someType',
+          serviceEndpoint: ['http://'] // Invalid URI.
+        }]
+      };
+
+      JasmineSidetreeErrorValidator.expectSidetreeErrorToBeThrown(
+        () => DocumentComposer['validateAddServicesPatch'](patch),
+        ErrorCode.DocumentComposerPatchServiceEndpointStringNotValidUri
+      );
+    });
   });
 
   describe('validateDocumentPatches()', async () => {