feat(service-account): add a static method to create signature

src/core/Folder.ts

@@ -1,7 +1,8 @@
-import { IFolder, ISignature, FolderState, PostLegalDocumentDTO, MultiResourceCreationResponse, LegalFile } from '../lib';
+import { IFolder, FolderState, PostLegalDocumentDTO, MultiResourceCreationResponse, LegalFile } from '../lib';
 import { RequestBuilder } from '../RequestBuilder';
 import { LegalDocument } from './LegalDocument';
 import { SupportingDocument } from './SupportingDocument';
+import { Signature } from '.';
 
 /**
  * Folder instance
@@ -35,7 +36,10 @@ export class Folder implements IFolder {
 
   public legalDocuments: LegalDocument[];
 
-  public signatures: ISignature[];
+  /**
+   * Signature instances attached to the folder
+   */
+  public signatures: Signature[];
 
   /**
    * Define the global folder status
@@ -50,7 +54,7 @@ export class Folder implements IFolder {
     this.expiredAt = params.expiredAt;
     this.updatedAt = params.updatedAt;
     this.lastFileUploadedAt = params.lastFileUploadedAt;
-    this.signatures = params.signatures ?? [];
+    this.signatures = params.signatures?.map((signature) => new Signature(this.id, signature, requestBuilder)) ?? [];
     this.state = params.state;
     this.legalDocuments = params.legalDocuments.map((doc) => new LegalDocument(doc, this.id, requestBuilder));
     this.supportingDocuments = params.supportingDocuments.map((doc) => new SupportingDocument(doc, this.id));

src/core/LegalDocument.ts

@@ -54,7 +54,10 @@ export class LegalDocument extends Document implements ILegalDocument {
 
     return {
       ...res,
-      elements: res.elements.map((element) => ({ ...element, resource: new LegalDocument(element.resource, folderId, requestBuilder) })),
+      elements: res.elements.map((element) => ({
+        ...element,
+        resource: new LegalDocument(element.resource, folderId, requestBuilder),
+      })),
     };
   }
 

src/core/ServiceAccount.ts

@@ -1,9 +1,10 @@
 import { RequestBuilder } from '../RequestBuilder';
 import { IServiceAccount } from '..';
-import { PostSubscriptionDTO } from '../lib';
+import { PostSignatureDTO, PostSubscriptionDTO } from '../lib';
 import { Subscription } from './Subscription';
 import { BanksUser } from './BanksUser';
 import { Application } from './Application';
+import { Signature } from './Signature';
 
 /**
  * Service account class
@@ -136,4 +137,13 @@ export class ServiceAccount {
   public async getApplicationById(id: string): Promise<Application> {
     return Application.getApplicationById(id, this.requestBuilder);
   }
+
+  /**
+   * Create a signature from a given folder id
+   * @param folderId Unique folder identifier
+   * @param signatureBody Signature instance to create
+   */
+  public async createSignature(folderId: string, signatureBody: PostSignatureDTO): Promise<Signature> {
+    return Signature.create(this.requestBuilder, folderId, signatureBody);
+  }
 }

src/lib/Algoan.dto.ts

@@ -9,7 +9,7 @@ import {
   LegalDocumentCategory,
   LegalFileType,
   RejectionCode,
-  SignatureState
+  SignatureState,
 } from './Folder.interface';
 
 /**

test/service-account.test.ts

@@ -4,13 +4,14 @@ import { RequestBuilder } from '../src/RequestBuilder';
 import { ServiceAccount } from '../src/core/ServiceAccount';
 import { Subscription } from '../src/core/Subscription';
 import { BanksUser } from '../src/core/BanksUser';
-import { EventName } from '../src';
+import { EventName, Holder, Signature } from '../src';
 import { getFakeAlgoanServer, getOAuthServer } from './utils/fake-server.utils';
 import { serviceAccounts as serviceAccountsSample } from './samples/service-accounts';
 import { subscriptions as subscriptionSample } from './samples/subscriptions';
 import { banksUser as banksUserSample } from './samples/banks-users';
 import { applicationSample } from './samples/application';
 import { Application } from '../src/core/Application';
+import { folderSample } from './samples/folder';
 
 describe('Tests related to the ServiceAccount class', () => {
   const baseUrl: string = 'http://localhost:3000';
@@ -274,4 +275,43 @@ describe('Tests related to the ServiceAccount class', () => {
       expect(application).toBeInstanceOf(Application);
     });
   });
+
+  describe('static createSignature()', () => {
+    let signatureAPI: nock.Scope;
+    beforeEach(() => {
+      getOAuthServer({
+        baseUrl,
+        isRefreshToken: false,
+        isUserPassword: false,
+        nbOfCalls: 1,
+        expiresIn: 500,
+        refreshExpiresIn: 2000,
+      });
+      requestBuilder = new RequestBuilder(baseUrl, {
+        clientId: 'a',
+        clientSecret: 's',
+      });
+      signatureAPI = getFakeAlgoanServer({
+        baseUrl,
+        path: `/v1/folders/${folderSample.id}/signatures`,
+        response: folderSample.signatures[0],
+        method: 'post',
+      });
+    });
+    it('should create a new Signature', async () => {
+      const serviceAccount: ServiceAccount = new ServiceAccount(baseUrl, {
+        clientId: 'a',
+        clientSecret: 'b',
+        id: '1',
+        createdAt: new Date().toISOString(),
+      });
+      const signature: Signature = await serviceAccount.createSignature(folderSample.id, {
+        partnerId: 'provider_id',
+        legalDocumentIds: ['doc_id'],
+        holder: Holder.APPLICANT,
+      });
+      expect(signatureAPI.isDone()).toBeTruthy();
+      expect(signature).toBeInstanceOf(Signature);
+    });
+  });
 });