@verdocs/js-sdk 3.6.0 → 3.6.2

package/Envelopes/Envelopes.d.ts

@@ -8,6 +8,10 @@ export interface ICreateEnvelopeRequest {
     roles: ICreateEnvelopeRole[];
     name: string;
     environment?: string;
+    prepared_fields: {
+        name: string;
+        value: string;
+    }[];
 }
 /**
  * Create an envelope
@@ -142,22 +146,6 @@ export declare const getEnvelopeDocument: (endpoint: VerdocsEndpoint, envelopeId
  * Cancel an Envelope.
  */
 export declare const cancelEnvelope: (endpoint: VerdocsEndpoint, envelopeId: string) => Promise<TEnvelopeUpdateResult>;
-/**
- * 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: (envelope: IEnvelope) => 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 an Envelope. It is important to use this method
  * rather than a direct A HREF or similar link to set the authorization headers for the

package/Envelopes/Envelopes.js

@@ -163,26 +163,6 @@ export var cancelEnvelope = function (endpoint, envelopeId) { return __awaiter(v
                 .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 (envelope) { return ((envelope === null || envelope === void 0 ? void 0 : envelope.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 an Envelope. It is important to use this method
  * rather than a direct A HREF or similar link to set the authorization headers for the

package/Envelopes/Permissions.d.ts

@@ -3,7 +3,7 @@
  *
  * @module
  */
-import { IEnvelope } from './Types';
+import { IEnvelope, IRecipient } from './Types';
 import { TSession } from '../Sessions/Types';
 /**
  * Check to see if the user owns the envelope.
@@ -13,6 +13,14 @@ export declare const userIsEnvelopeOwner: (session: TSession, envelope: IEnvelop
  * Check to see if the user owns the envelope.
  */
 export declare const userIsEnvelopeRecipient: (session: TSession, envelope: IEnvelope) => boolean;
+/**
+ * Check to see if the envelope has pending actions.
+ */
+export declare const envelopeIsActive: (envelope: IEnvelope) => boolean;
+/**
+ * Check to see if the envelope has been completed.
+ */
+export declare const envelopeIsComplete: (envelope: IEnvelope) => boolean;
 /**
  * Check to see if the user owns the envelope.
  */
@@ -21,3 +29,23 @@ export declare const userCanCancelEnvelope: (session: TSession, envelope: IEnvel
  * Check to see if the user owns the envelope.
  */
 export declare const userCanFinishEnvelope: (session: TSession, envelope: IEnvelope) => boolean;
+/**
+ * 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: (envelope: IEnvelope) => 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;
+/**
+ * Returns true if the user can act.
+ */
+export declare const userCanSignNow: (session: TSession, envelope: IEnvelope) => boolean | undefined;

package/Envelopes/Permissions.js

@@ -12,6 +12,16 @@ export var userIsEnvelopeOwner = function (session, envelope) { return envelope.
  * Check to see if the user owns the envelope.
  */
 export var userIsEnvelopeRecipient = function (session, envelope) { return envelope.profile_id === (session === null || session === void 0 ? void 0 : session.profile_id); };
+/**
+ * Check to see if the envelope has pending actions.
+ */
+export var envelopeIsActive = function (envelope) {
+    return envelope.status !== EnvelopeStates.COMPLETE && envelope.status !== EnvelopeStates.DECLINED && envelope.status !== EnvelopeStates.CANCELED;
+};
+/**
+ * Check to see if the envelope has been completed.
+ */
+export var envelopeIsComplete = function (envelope) { return envelope.status !== EnvelopeStates.COMPLETE; };
 /**
  * Check to see if the user owns the envelope.
  */
@@ -31,3 +41,37 @@ export var userCanFinishEnvelope = function (session, envelope) {
         envelope.status !== EnvelopeStates.DECLINED &&
         envelope.status !== EnvelopeStates.CANCELED;
 };
+/**
+ * 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 (envelope) { return ((envelope === null || envelope === void 0 ? void 0 : envelope.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);
+};
+/**
+ * Returns true if the user can act.
+ */
+export var userCanSignNow = function (session, envelope) {
+    if (!session) {
+        return false;
+    }
+    var recipientsWithActions = getRecipientsWithActions(envelope);
+    var myRecipient = recipientsWithActions.find(function (r) { return r.profile_id === (session === null || session === void 0 ? void 0 : session.profile_id) || r.email === (session === null || session === void 0 ? void 0 : session.email); });
+    return (myRecipient &&
+        envelopeIsActive(envelope) &&
+        userIsEnvelopeRecipient(session, envelope) &&
+        recipientCanAct(myRecipient, recipientsWithActions));
+};

package/Envelopes/Recipients.d.ts

@@ -1,4 +1,4 @@
-import { IEnvelope, IRecipient, IInPersonAccessKey } from './Types';
+import { IEnvelope, IRecipient, IInPersonAccessKey, TAccessKey } from './Types';
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
 export interface IUpdateRecipientSubmitParams {
     action: 'submit';
@@ -68,6 +68,12 @@ export interface ISignerTokenResponse {
 export declare const getSignerToken: (endpoint: VerdocsEndpoint, envelopeId: string, roleName: string) => Promise<ISignerTokenResponse>;
 export interface IInPersonLinkResponse {
     link: string;
+    envelope_id: string;
+    profile_id: string;
+    role_name: string;
+    access_key: string;
+    expiration_date: string;
+    type: TAccessKey;
 }
 /**
  * Get an in-person signing link.

package/Envelopes/Types.d.ts

@@ -15,6 +15,29 @@ export interface IInPersonAccessKey {
     first_used: string | null;
     last_used: string | null;
 }
+export interface IEmailAccessKey {
+    id: string;
+    created_at: string;
+    recipient_name: string;
+    envelope_id: string;
+    type: 'email';
+    key: string;
+    expiration_date: string | null;
+    first_used: string | null;
+    last_used: string | null;
+}
+export interface ISMSAccessKey {
+    id: string;
+    created_at: string;
+    recipient_name: string;
+    envelope_id: string;
+    type: 'sms';
+    key: string;
+    expiration_date: string | null;
+    first_used: string | null;
+    last_used: string | null;
+}
+export type TAccessKey = IInPersonAccessKey | IEmailAccessKey | ISMSAccessKey;
 export declare enum RecipientActions {
     SUBMIT = "submit",
     DECLINE = "decline",

package/Sessions/Types.d.ts

@@ -45,6 +45,10 @@ export interface IUserSession {
  */
 export type TSessionType = 'user' | 'signing';
 /**
- * An authenticated session within Verdocs, either for signing or regular user-based operations.
+ * Represents a possibly-authenticated session within Verdocs, either for signing or regular user-based operations.
  */
 export type TSession = IUserSession | ISigningSession | null;
+/**
+ * An active authenticated session within Verdocs, either for signing or regular user-based operations.
+ */
+export type TActiveSession = IUserSession | ISigningSession;

package/Templates/Templates.d.ts

@@ -85,7 +85,8 @@ export interface ITemplateCreateParams {
     /**
      * Optional list of roles to create. Documents are required if roles or fields will also be specified. Files may
      * be attached via a number of methods (browser File object, remote URI reference, or Base64-encoded string) but
-     * all entries must of of the same type.
+     * all entries must of of the same type. If browser File objects are provided, the request will use a FORM POST
+     * call, otherwise it will use traditional XHR.
      */
     documents?: File[] | IDocumentFromUri[] | IDocumentFromData[];
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verdocs/js-sdk",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "private": false,
   "homepage": "https://github.com/Verdocs/js-sdk",
   "description": "Verdocs JS SDK",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "axios": "^1.3.4",
+    "axios": "^1.3.6",
     "axios-retry": "^3.4.0"
   },
   "peerDependencies": {