@verdocs/js-sdk 2.0.8 → 2.0.11

package/Documents/Documents.d.ts

@@ -8,9 +8,17 @@ export declare type TRecipientType = 'signer' | 'cc' | 'approver';
 export interface IDocumentsSearchResultEntry {
     id: string;
     canceled_at: string;
+    certificate_document_id: string;
     created_at: string;
+    envelope_document_id: string;
+    histories: IHistory[];
+    indexed_at: string;
     name: string;
+    no_contact: boolean;
+    organization_id: string;
     profile_id: string;
+    recipients: IRecipient[];
+    reminder_id: string | null;
     status: TDocumentStatus;
     next_recipient: {
         claimed: boolean;
@@ -184,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/Organizations/Groups.d.ts

@@ -18,7 +18,17 @@ import { VerdocsEndpoint } from '../VerdocsEndpoint';
  * const groups = await Groups.getGroups(ORGID);
  * ```
  */
-export declare const getGroups: (endpoint: VerdocsEndpoint, organizationId: string, name?: string) => Promise<IGroup[]>;
+export declare const getGroups: (endpoint: VerdocsEndpoint, organizationId: string) => Promise<IGroup[]>;
+/**
+ * Get a single group by name. Returns a detail record.
+ *
+ * ```typescript
+ * import {Groups} from '@verdocs/js-sdk/Organizations';
+ *
+ * const groups = await Groups.getGroups(ORGID);
+ * ```
+ */
+export declare const getGroupByName: (endpoint: VerdocsEndpoint, organizationId: string, name?: string) => Promise<IGroupDetail>;
 /**
  * Get the details for a group.
  *

package/Organizations/Groups.js

@@ -16,7 +16,21 @@
  * const groups = await Groups.getGroups(ORGID);
  * ```
  */
-export var getGroups = function (endpoint, organizationId, name) {
+export var getGroups = function (endpoint, organizationId) {
+    return endpoint.api //
+        .get("/organizations/".concat(organizationId, "/groups"))
+        .then(function (r) { return r.data; });
+};
+/**
+ * Get a single group by name. Returns a detail record.
+ *
+ * ```typescript
+ * import {Groups} from '@verdocs/js-sdk/Organizations';
+ *
+ * const groups = await Groups.getGroups(ORGID);
+ * ```
+ */
+export var getGroupByName = function (endpoint, organizationId, name) {
     return endpoint.api //
         .get("/organizations/".concat(organizationId, "/groups"), { params: { name: name } })
         .then(function (r) { return r.data; });

package/Organizations/Types.d.ts

@@ -41,6 +41,8 @@ export interface IGroup {
     name: string;
     organization_id: string;
     /** For future expansion. In the future, Verdocs may support group hierarchies. Until then this field is always null. */
+    parent: IGroup | null;
+    /** For future expansion. In the future, Verdocs may support group hierarchies. Until then this field is always null. */
     parent_id: string | null;
     /** Some operations will additionally return a list of permissions. */
     permissions?: TPermission[];
@@ -49,8 +51,25 @@ export interface IGroup {
     /** Some operations will additionally return a list of profiles. */
     profiles?: IProfile[];
 }
-export interface IGroupDetail extends IGroup {
-    permissions: TPermission[];
-    roles: TRole[];
+export interface IPermissionDetail {
+    id: string;
+    name: string;
+    client_id: string;
+}
+export interface IRoleDetail {
+    id: string;
+    name: string;
+    client_id: string;
+}
+export interface IGroupDetail {
+    id: string;
+    name: string;
+    organization_id: string;
+    permissions: IPermissionDetail[];
+    roles: IRoleDetail[];
     profiles: IProfile[];
+    /** For future expansion. In the future, Verdocs may support group hierarchies. Until then this field is always null. */
+    parent: IGroup | null;
+    /** For future expansion. In the future, Verdocs may support group hierarchies. Until then this field is always null. */
+    parent_id: string | null;
 }

package/package.json

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