@verdocs/js-sdk 2.0.10 → 2.0.11

package/Documents/Documents.d.ts

@@ -17,7 +17,7 @@ export interface IDocumentsSearchResultEntry {
     no_contact: boolean;
     organization_id: string;
     profile_id: string;
-    recipients: string;
+    recipients: IRecipient[];
     reminder_id: string | null;
     status: TDocumentStatus;
     next_recipient: {
@@ -192,6 +192,26 @@ export declare const getDocumentRecipients: (endpoint: VerdocsEndpoint, document
  * Get all metadata for a Document.
  */
 export declare const getDocument: (endpoint: VerdocsEndpoint, documentId: string) => Promise<IDocument>;
+/**
+ * Cancel a Document.
+ */
+export declare const cancelDocument: (endpoint: VerdocsEndpoint, documentId: string) => Promise<IDocument>;
+/**
+ * Returns true if the recipient has a pending action. Note that this does not necessarily mean the recipient can act (yet).
+ */
+export declare const recipientHasAction: (recipient: IRecipient) => boolean;
+/**
+ * Returns the recipients who still have a pending action. Note that not all of these recipients may be able to act (yet).
+ */
+export declare const getRecipientsWithActions: (document: IDocument) => IRecipient[];
+/**
+ * Returns true if the recipient can act.
+ */
+export declare const recipientCanAct: (recipient: IRecipient, recipientsWithActions: IRecipient[]) => boolean;
+/**
+ * Returns true if the user can act.
+ */
+export declare const userCanAct: (email: string, recipientsWithActions: IRecipient[]) => boolean | undefined;
 /**
  * Get (binary download) a file attached to a Document.
  */

package/Documents/Documents.js

@@ -104,6 +104,36 @@ export var getDocument = function (endpoint, documentId) { return __awaiter(void
                 .then(function (r) { return r.data; })];
     });
 }); };
+/**
+ * Cancel a Document.
+ */
+export var cancelDocument = function (endpoint, documentId) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        return [2 /*return*/, endpoint.api //
+                .put("/documents/".concat(documentId), { action: 'cancel' })
+                .then(function (r) { return r.data; })];
+    });
+}); };
+/**
+ * Returns true if the recipient has a pending action. Note that this does not necessarily mean the recipient can act (yet).
+ */
+export var recipientHasAction = function (recipient) { return !['submitted', 'canceled', 'declined'].includes(recipient.status); };
+/**
+ * Returns the recipients who still have a pending action. Note that not all of these recipients may be able to act (yet).
+ */
+export var getRecipientsWithActions = function (document) { return ((document === null || document === void 0 ? void 0 : document.recipients) || []).filter(recipientHasAction); };
+/**
+ * Returns true if the recipient can act.
+ */
+export var recipientCanAct = function (recipient, recipientsWithActions) { var _a; return recipient.sequence === ((_a = recipientsWithActions === null || recipientsWithActions === void 0 ? void 0 : recipientsWithActions[0]) === null || _a === void 0 ? void 0 : _a.sequence); };
+/**
+ * Returns true if the user can act.
+ */
+export var userCanAct = function (email, recipientsWithActions) {
+    var _a;
+    var recipient = recipientsWithActions.find(function (r) { return r.email === email; });
+    return recipient && recipient.sequence === ((_a = recipientsWithActions === null || recipientsWithActions === void 0 ? void 0 : recipientsWithActions[0]) === null || _a === void 0 ? void 0 : _a.sequence);
+};
 /**
  * Get (binary download) a file attached to a Document.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verdocs/js-sdk",
-  "version": "2.0.10",
+  "version": "2.0.11",
   "private": false,
   "homepage": "https://github.com/Verdocs/js-sdk",
   "description": "Verdocs JS SDK",