add support for collection / nft identifiers pipes

lerna.json

@@ -1,7 +1,7 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.2.7",
+  "version": "1.2.8",
   "packages": [
     "packages/*"
   ],

packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-auth",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs auth package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/cache/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-cache",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs cache package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-common",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs common package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/common/src/index.ts

@@ -37,6 +37,8 @@ export * from './pipes/parse.record.pipe';
 export * from './pipes/parse.token.pipe';
 export * from './pipes/parse.token.or.nft.pipe';
 export * from './pipes/parse.transaction.hash.pipe';
+export * from './pipes/parse.nft.array.pipe';
+export * from './pipes/parse.collection.array.pipe';
 export * from './common/entities/amount';
 export * from './common/config/erdnest.config.service';
 export * from './common/swappable-settings';

packages/common/src/pipes/parse.collection.array.pipe.ts

@@ -0,0 +1,23 @@
+import { ArgumentMetadata, BadRequestException, PipeTransform } from "@nestjs/common";
+import { TokenUtils } from "../utils/token.utils";
+
+export class ParseCollectionArrayPipe implements PipeTransform<string | string[] | undefined, Promise<string | string[] | undefined>> {
+
+  transform(value: string | string[] | undefined, metadata: ArgumentMetadata): Promise<string | string[] | undefined> {
+    return new Promise((resolve) => {
+      if (value === undefined || value === '') {
+        return resolve(undefined);
+      }
+
+      const values = Array.isArray(value) ? value : value.split(',');
+
+      for (const value of values) {
+        if (!TokenUtils.isCollection(value)) {
+          throw new BadRequestException(`Validation failed for '${metadata.data}'. Value ${value} does not represent a valid collection identifier`);
+        }
+      }
+
+      return resolve(values);
+    });
+  }
+}

packages/common/src/pipes/parse.nft.array.pipe.ts

@@ -0,0 +1,23 @@
+import { ArgumentMetadata, BadRequestException, PipeTransform } from "@nestjs/common";
+import { TokenUtils } from "../utils/token.utils";
+
+export class ParseNftArrayPipe implements PipeTransform<string | string[] | undefined, Promise<string | string[] | undefined>> {
+
+  transform(value: string | string[] | undefined, metadata: ArgumentMetadata): Promise<string | string[] | undefined> {
+    return new Promise((resolve) => {
+      if (value === undefined || value === '') {
+        return resolve(undefined);
+      }
+
+      const values = Array.isArray(value) ? value : value.split(',');
+
+      for (const value of values) {
+        if (!TokenUtils.isNft(value)) {
+          throw new BadRequestException(`Validation failed for '${metadata.data}'. Value ${value} does not represent a valid NFT identifier`);
+        }
+      }
+
+      return resolve(values);
+    });
+  }
+}

packages/common/test/pipes/parse.collection.array.pipe.spec.ts

@@ -0,0 +1,39 @@
+import { ArgumentMetadata, BadRequestException } from "@nestjs/common";
+import { ParseCollectionArrayPipe } from "../../../common/src/pipes/parse.collection.array.pipe";
+
+describe('ParseCollectionArrayPipe', () => {
+  let target: ParseCollectionArrayPipe;
+
+  beforeEach(() => {
+    target = new ParseCollectionArrayPipe();
+  });
+
+  describe('transform', () => {
+    describe('when validation passes', () => {
+      it('should return array of collection identifiers', async () => {
+        const validCollectionIdentifier = 'ABCDE-efb116';
+        expect(await target.transform(validCollectionIdentifier, {} as ArgumentMetadata)).toStrictEqual([validCollectionIdentifier]);
+      });
+
+      it('should return undefined for an empty string', async () => {
+        expect(await target.transform('', {} as ArgumentMetadata)).toBeUndefined();
+      });
+
+      it('should return undefined for undefined value', async () => {
+        expect(await target.transform(undefined, {} as ArgumentMetadata)).toBeUndefined();
+      });
+    });
+
+    describe('when validation fails', () => {
+      it('should throw BadRequestException', async () => {
+        const invalidCollectionIdentifier = 'ABCDE-efb116-02';
+        await expect(target.transform(invalidCollectionIdentifier, {} as ArgumentMetadata)).rejects.toThrow(BadRequestException);
+      });
+
+      it('should throw BadRequestException even if array contains a valid collection identifier', async () => {
+        const invalidCollectionIdentifiers = ['ABCDE-efb116-02', 'ABCDE-efb116'];
+        await expect(target.transform(invalidCollectionIdentifiers, {} as ArgumentMetadata)).rejects.toThrow(BadRequestException);
+      });
+    });
+  });
+});

packages/common/test/pipes/parse.nft.array.pipe.spec.ts

@@ -0,0 +1,44 @@
+import { ArgumentMetadata, BadRequestException } from "@nestjs/common";
+import { ParseNftArrayPipe } from "../../../common/src/pipes/parse.nft.array.pipe";
+
+describe('ParseNftArrayPipe', () => {
+  let target: ParseNftArrayPipe;
+
+  beforeEach(() => {
+    target = new ParseNftArrayPipe();
+  });
+
+  describe('transform', () => {
+    describe('when validation passes', () => {
+      it('should return array of NFT identifiers', async () => {
+        const validNftIdentifier = 'ABCDE-efb116-02';
+        expect(await target.transform(validNftIdentifier, {} as ArgumentMetadata)).toStrictEqual([validNftIdentifier]);
+      });
+
+      it('should throw BadRequestException even if array contains a valid identifier', async () => {
+        const validNftIdentifier = 'ABCDE-efb116-02';
+        expect(await target.transform(validNftIdentifier, {} as ArgumentMetadata)).toStrictEqual([validNftIdentifier]);
+      });
+
+      it('should return undefined for an empty string', async () => {
+        expect(await target.transform('', {} as ArgumentMetadata)).toBeUndefined();
+      });
+
+      it('should return undefined for undefined value', async () => {
+        expect(await target.transform(undefined, {} as ArgumentMetadata)).toBeUndefined();
+      });
+    });
+
+    describe('when validation fails', () => {
+      it('should throw BadRequestException', async () => {
+        const invalidNftIdentifier = 'ABCDE-efb116';
+        await expect(target.transform(invalidNftIdentifier, {} as ArgumentMetadata)).rejects.toThrow(BadRequestException);
+      });
+
+      it('should throw BadRequestException even if array contains a valid identifier', async () => {
+        const invalidNftIdentifiers = ['ABCDE-efb116-02', 'ABCDE-efb116'];
+        await expect(target.transform(invalidNftIdentifiers, {} as ArgumentMetadata)).rejects.toThrow(BadRequestException);
+      });
+    });
+  });
+});

packages/elastic/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-elastic",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs elastic package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/http/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-http",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs http package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/monitoring/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-monitoring",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs monitoring package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/rabbitmq/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-rabbitmq",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs rabbitmq client package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/redis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiversx/sdk-nestjs-redis",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Multiversx SDK Nestjs redis client package",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",