octopian-apis 1.0.61 → 1.0.62

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octopian-apis",
-  "version": "1.0.61",
+  "version": "1.0.62",
   "description": "Transaction APIs SDK that implements Octopian Services which will be used for any node project typescript or javascript",
   "main": "./src/index.js",
   "scripts": {

package/src/CoreServices/transactionsServices.js

@@ -4102,6 +4102,123 @@ export async function GetStepTypeList(
   );
   return APIResponse;
 }
+
+/**
+ * @description
+ * Retrieves a list of interactor signatures.
+ *
+ * @param {string} AuthToken
+ * Authentication token for authorization purposes.
+ * 
+ * @param {number} Timeout
+ * Time in milliseconds to wait before the request times out. Default is 30000.
+ *
+ * @param {string} RequiredHeaderValue
+ * Value for any required header. Default is null.
+ *
+ * @returns
+ * An object containing the response from the Get Interactor Signatures API,
+ * including success message, status code, and any additional data returned by the API.
+ *   Message: Success,
+ *   StatusCode: 200,
+ *   Result: [
+ *     --- interactor signature data ---
+ *   ],
+ *   HeaderValue: string
+ */
+export async function GetInteractorSignatures(
+  AuthToken = null,
+  Timeout = 30000,
+  RequiredHeaderValue = null
+) {
+  let APIResponse = await apiHandler.GetMethod(
+    TransactionsAPIConstants.uriGetInteractorSignatures(),
+    AuthToken,
+    Timeout,
+    RequiredHeaderValue
+  );
+  return APIResponse;
+}
+
+/**
+ * @description
+ * Retrieves a signature blob.
+ *
+ * @param {string} signatureId
+ * The ID of the signature to retrieve.
+ *
+ * @param {string} AuthToken
+ * Authentication token for authorization purposes.
+ * 
+ * @param {number} Timeout
+ * Time in milliseconds to wait before the request times out. Default is 30000.
+ *
+ * @param {string} RequiredHeaderValue
+ * Value for any required header. Default is null.
+ *
+ * @returns
+ * An object containing the response from the Get Signature Blob API,
+ * including success message, status code, and any additional data returned by the API.
+ *   Message: Success,
+ *   StatusCode: 200,
+ *   Result: string (signature blob),
+ *   HeaderValue: string
+ */
+export async function GetSignatureBlob(
+  signatureId,
+  AuthToken = null,
+  Timeout = 30000,
+  RequiredHeaderValue = null
+) {
+  let APIResponse = await apiHandler.GetMethod(
+    TransactionsAPIConstants.uriGetSignatureBlob(signatureId),
+    AuthToken,
+    Timeout,
+    RequiredHeaderValue
+  );
+  return APIResponse;
+}
+
+/**
+ * @description
+ * Signs a document.
+ *
+ * @param {object} SignDocumentDTO
+ * Data object containing fields necessary for signing the document.
+ *   --- signature data ---
+ *
+ * @param {string} AuthToken
+ * Authentication token for authorization purposes.
+ * 
+ * @param {number} Timeout
+ * Time in milliseconds to wait before the request times out. Default is 30000.
+ *
+ * @param {string} RequiredHeaderValue
+ * Value for any required header. Default is null.
+ *
+ * @returns
+ * An object containing the response from the Sign Document API,
+ * including success message, status code, and any additional data returned by the API.
+ *   Message: Success,
+ *   StatusCode: 200,
+ *   Result: string (signature id),
+ *   HeaderValue: string
+ */
+export async function SignDocument(
+  SignDocumentDTO,
+  AuthToken = null,
+  Timeout = 30000,
+  RequiredHeaderValue = null
+) {
+  let APIResponse = await apiHandler.PostMethod(  
+    TransactionsAPIConstants.uriSignDocument(),
+    SignDocumentDTO,
+    AuthToken,
+    Timeout,
+    RequiredHeaderValue
+  );  
+  return APIResponse;
+}
 //#endregion
 
 //#region Agent

package/src/index.d.ts

@@ -275,6 +275,9 @@ import { GetAppStyles } from "./modals/output-modals/correspondence-modals/GetAp
 import { NotificationListOutput } from "./modals/output-modals/transaction-catalog-modals/NotificationListOutput";
 import { UpdateNotificationInput } from "./modals/input-modals/transaction-catalog-modals/UpdateNotificationInput";
 import { GetStepTypeOutput } from "./modals/output-modals/transaction-catalog-modals/GetStepTypesOutput";
+import { GetInteractorSignatureOutput } from "./modals/output-modals/transaction-catalog-modals/GetInteractorSignatureOutput";
+import { GetSignatureBlobOutput } from "./modals/output-modals/transaction-catalog-modals/GetSignatureBlobOutput";
+import { SignDocumentInput } from "./modals/input-modals/transaction-catalog-modals/SignDocumentInput";
 // Define each module with its specific functions
 
 interface AuthenticationServices {
@@ -4211,6 +4214,98 @@ interface TransactionCommonServices {
     Timeout?: number | null,
     RequiredHeaderValue?: string
   ) => BaseResponse<GetStepTypeOutput[] | BaseErrorResponse>;
+
+  /**
+   * @description
+   * Retrieves a list of interactor signatures.
+   *
+   * @param {string} AuthToken
+   * Authentication token for authorization purposes.
+   *
+   * @param {number} Timeout
+   * Time in milliseconds to wait before the request times out. Default is 30000.
+   *
+   * @param {string} RequiredHeaderValue
+   * Value for any required header. Default is null.
+   *
+   * @returns
+   * An object containing the response from the Get Interactor Signatures API,
+   * including success message, status code, and any additional data returned by the API.
+   *   Message: Success,
+   *   StatusCode: 200,
+   *   Result: [
+   *     --- interactor signature data ---
+   *   ],
+   *   HeaderValue: string
+   */
+  GetInteractorSignatures: (
+    AuthToken?: string | null,
+    Timeout?: number | null,
+    RequiredHeaderValue?: string
+  ) => BaseResponse<GetInteractorSignatureOutput[] | BaseErrorResponse>;
+
+  /**
+   * @description
+   * Retrieves a signature blob.
+   *
+   * @param {string} signatureId
+   * The ID of the signature to retrieve.
+   *
+   * @param {string} AuthToken
+   * Authentication token for authorization purposes.
+   *
+   * @param {number} Timeout
+   * Time in milliseconds to wait before the request times out. Default is 30000.
+   *
+   * @param {string} RequiredHeaderValue
+   * Value for any required header. Default is null.
+   *
+   * @returns
+   * An object containing the response from the Get Signature Blob API,
+   * including success message, status code, and any additional data returned by the API.
+   *   Message: Success,
+   *   StatusCode: 200,
+   *   Result: GetSignatureBlobOutput,
+   *   HeaderValue: string
+   */
+  GetSignatureBlob: (
+    signatureId: string,
+    AuthToken?: string | null,
+    Timeout?: number | null,
+    RequiredHeaderValue?: string
+  ) => BaseResponse<GetSignatureBlobOutput | BaseErrorResponse>;
+
+  /**
+   * @description
+   * Signs a document.
+   *
+   * @param {SignDocumentInput} SignDocumentDTO
+   * Data object containing fields necessary for signing the document.
+   *   --- signature data ---
+   *
+   * @param {string} AuthToken
+   * Authentication token for authorization purposes.
+   *
+   * @param {number} Timeout
+   * Time in milliseconds to wait before the request times out. Default is 30000.
+   *
+   * @param {string} RequiredHeaderValue
+   * Value for any required header. Default is null.
+   *
+   * @returns
+   * An object containing the response from the Sign Document API,
+   * including success message, status code, and any additional data returned by the API.
+   *   Message: Success,
+   *   StatusCode: 200,
+   *   Result: string (signature id),
+   *   HeaderValue: string
+   */
+  SignDocument: (
+    SignDocumentDTO: SignDocumentInput,
+    AuthToken?: string | null,
+    Timeout?: number | null,
+    RequiredHeaderValue?: string
+  ) => BaseResponse<string | BaseErrorResponse>;
 }
 
 // Storage Services interface
@@ -7640,5 +7735,8 @@ export {
   UpdateNotificationInput,
   GetStepTypeOutput,
   ChildStep,
-  MaintainRequestStepListInput
+  MaintainRequestStepListInput,
+  SignDocumentInput,
+  GetSignatureBlobOutput,
+  GetInteractorSignatureOutput,
 };

package/src/index.js

@@ -142,6 +142,9 @@ const {
   GetNotificationList,
   UpdateNotificationList,
   GetStepTypeList,
+  GetInteractorSignatures,
+  GetSignatureBlob,
+  SignDocument,
 } = require("./CoreServices/transactionsServices");
 const TransactionRequesterServices = {
   GetCompanyLanguageList,
@@ -244,6 +247,9 @@ const TransactionCommonServices = {
   GetNotificationList,
   UpdateNotificationList,
   GetStepTypeList,
+  GetInteractorSignatures,
+  GetSignatureBlob,
+  SignDocument,
 };
 
 const {

package/src/modals/input-modals/transaction-catalog-modals/GenerateDocumentInput.ts

@@ -1,6 +1,7 @@
 export interface GenerateDocumentInput {
     serviceId: number
     templateAttributeAlias: string
+    IsGeneratedWord:boolean
     clientRequestAttributes: ClientRequestAttribute[]
   }
   
@@ -17,6 +18,7 @@ export interface GenerateDocumentInput {
   export interface GenerateStepDocumentInput {
     RequestStepId: number
     TemplateAttributeAlias: string
+    IsGeneratedWord:boolean
     ClientRequestAttributes: ClientRequestAttribute[]
   }
   

package/src/modals/input-modals/transaction-catalog-modals/SignDocumentInput.ts

@@ -0,0 +1,6 @@
+export interface SignDocumentInput
+{
+    DocumentPath: string;
+    Alias: string;
+    InteractorSignatureId: number;
+}

package/src/modals/output-modals/request-step-modals/GetRequestStepListOutput.ts

@@ -142,6 +142,7 @@ import { GetMyRequestOutput, RequestList } from "../request-modals/GetMyRequestG
     PreviousClosedRequestStepList: GetRequestStepListOutput[]
     CurrentActiveRequestStep: GetRequestStepListOutput
     StepStatusCounter: StepStatusCounter
+    IsSignDocument: boolean
   }
   
   export interface RequestAttributeList {

package/src/modals/output-modals/transaction-catalog-modals/GetInteractorSignatureOutput.ts

@@ -0,0 +1,7 @@
+export interface GetInteractorSignatureOutput
+{
+    Id: number;
+    Name: string;
+    Label: string;
+    CreatedAtUtc: string;
+}

package/src/modals/output-modals/transaction-catalog-modals/GetSignatureBlobOutput.ts

@@ -0,0 +1,7 @@
+export interface GetSignatureBlobOutput
+{
+    Ciphertext: string;
+    MimeType: string;
+    ByteLength: number;
+    Iv: string;
+}

package/src/web-services/apiConstants.js

@@ -393,6 +393,15 @@ export class TransactionsAPIConstants {
   static uriGetStepTypeList(){
     return transactionCatalogURI + "/api/TransactionCommon/GetStepTypeList";
   }
+  static uriGetInteractorSignatures(){
+    return signatureURI + "/api/InteractorSignatures";
+  }
+  static uriGetSignatureBlob(signatureId){
+    return signatureURI + `/api/InteractorSignatures/Blob/${signatureId}`;
+  }
+  static uriSignDocument(){
+    return signatureURI + "/api/SignDocument";
+  }
   //#endregion
 
   //#region Agent
@@ -754,5 +763,5 @@ let requestServicesURI = "/Request";
 let requestStepURI = "/RequestStep";
 let storageURI = "/Storage";
 let transactionCatalogURI = "/TransactionCatalog";
-
+let signatureURI = "/Signature";
 //#endregion