@verdocs/js-sdk 2.0.15 → 2.0.17

package/Documents/Documents.d.ts

@@ -1,13 +1,47 @@
-import { IDocument, IDocumentsSearchResult, IDocumentsSummary, IRecipient, ISigningSession, ISigningSessionRequest } from './Types';
+import { ICreateDocumentRequest, IDocumentsSearchResult, ISigningSessionRequest } from './Types';
+import { IDocument, IDocumentsSummary, IRecipient, ISigningSession } from './Types';
 import { TDocumentUpdateResult, IDocumentFieldSettings } from './Types';
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
+/**
+ * Create a document
+ *
+ * ```typescript
+ * import {Documents, ICreateDocumentRole, ICreateDocumentRequest} from '@verdocs/js-sdk/Documents';
+ *
+ * const role1: ICreateDocumentRole = {
+ *   type: 'signer',
+ *   name: 'Seller',
+ *   full_name: 'Paige Turner',
+ *   email: 'paige.turner@nomail.com',
+ *   phone: '',
+ *   sequence: 1,
+ *   delegator: false,
+ *   message: '',
+ * };
+ *
+ * const role2: ICreateDocumentRole = {
+ *   type: 'signer',
+ *   name: 'Buyer',
+ *   full_name: 'Will Power',
+ *   email: 'will.power@nomail.com',
+ *   phone: '',
+ *   sequence: 2,
+ *   delegator: false,
+ *   message: '',
+ * };
+ *
+ * const request: ICreateDocumentRequest = {template_id: 'd2338742-f3a1-465b-8592-806587413cc1', name: 'Bill of Sale', roles: [role1, role2]};
+ * const {id, recipients} = await Documents.createDocument(VerdocsEndpoint.getDefault(), request);
+ * ```
+ */
+export declare const createDocument: (endpoint: VerdocsEndpoint, request: ICreateDocumentRequest) => Promise<IDocument>;
 /**
  * Get a summary of currently active documents.
  *
  * ```typescript
  * import {Documents} from '@verdocs/js-sdk/Documents';
  *
- * const {action_required, completed, waiting_on_others} = await Documents.getSummary();
+ * const {action_required, completed, waiting_on_others} = await Documents.getSummary(VerdocsEndpoint.getDefault());
  * ```
  */
 export declare const getSummary: (endpoint: VerdocsEndpoint, page: number) => Promise<IDocumentsSummary>;
@@ -17,7 +51,7 @@ export declare const getSummary: (endpoint: VerdocsEndpoint, page: number) => Pr
  * ```typescript
  * import {Documents} from '@verdocs/js-sdk/Documents';
  *
- * const {result, page, total} = await Documents.search({ ... });
+ * const {result, page, total} = await Documents.search(VerdocsEndpoint.getDefault(), { ... });
  * ```
  */
 export declare const searchDocuments: (endpoint: VerdocsEndpoint, params: any) => Promise<IDocumentsSearchResult>;

package/Documents/Documents.js

@@ -35,13 +35,52 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 import { decodeAccessTokenBody } from '../Utils/Token';
+/**
+ * Create a document
+ *
+ * ```typescript
+ * import {Documents, ICreateDocumentRole, ICreateDocumentRequest} from '@verdocs/js-sdk/Documents';
+ *
+ * const role1: ICreateDocumentRole = {
+ *   type: 'signer',
+ *   name: 'Seller',
+ *   full_name: 'Paige Turner',
+ *   email: 'paige.turner@nomail.com',
+ *   phone: '',
+ *   sequence: 1,
+ *   delegator: false,
+ *   message: '',
+ * };
+ *
+ * const role2: ICreateDocumentRole = {
+ *   type: 'signer',
+ *   name: 'Buyer',
+ *   full_name: 'Will Power',
+ *   email: 'will.power@nomail.com',
+ *   phone: '',
+ *   sequence: 2,
+ *   delegator: false,
+ *   message: '',
+ * };
+ *
+ * const request: ICreateDocumentRequest = {template_id: 'd2338742-f3a1-465b-8592-806587413cc1', name: 'Bill of Sale', roles: [role1, role2]};
+ * const {id, recipients} = await Documents.createDocument(VerdocsEndpoint.getDefault(), request);
+ * ```
+ */
+export var createDocument = function (endpoint, request) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        return [2 /*return*/, endpoint.api //
+                .post('/documents', request)
+                .then(function (r) { return r.data; })];
+    });
+}); };
 /**
  * Get a summary of currently active documents.
  *
  * ```typescript
  * import {Documents} from '@verdocs/js-sdk/Documents';
  *
- * const {action_required, completed, waiting_on_others} = await Documents.getSummary();
+ * const {action_required, completed, waiting_on_others} = await Documents.getSummary(VerdocsEndpoint.getDefault());
  * ```
  */
 export var getSummary = function (endpoint, page) { return __awaiter(void 0, void 0, void 0, function () {
@@ -57,7 +96,7 @@ export var getSummary = function (endpoint, page) { return __awaiter(void 0, voi
  * ```typescript
  * import {Documents} from '@verdocs/js-sdk/Documents';
  *
- * const {result, page, total} = await Documents.search({ ... });
+ * const {result, page, total} = await Documents.search(VerdocsEndpoint.getDefault(), { ... });
  * ```
  */
 export var searchDocuments = function (endpoint, params) { return __awaiter(void 0, void 0, void 0, function () {

package/Documents/Types.d.ts

@@ -125,6 +125,7 @@ export interface IRecipient {
     status: TRecipientStatus;
     type: TRecipientType;
     updated_at: string;
+    fields?: IDocumentField[];
 }
 export interface IDocumentAsset {
     created_at: string;
@@ -135,6 +136,14 @@ export interface IDocumentAsset {
     updated_at: string;
     url: string;
 }
+export interface IDocumentFieldOptions {
+    id: string;
+    x: number;
+    y: number;
+    checked?: boolean;
+    selected?: boolean;
+    value: string;
+}
 export interface IDocumentFieldSettings {
     type?: string;
     x: number;
@@ -146,21 +155,24 @@ export interface IDocumentFieldSettings {
     leading?: number;
     alignment?: number;
     upperCase?: boolean;
-    options?: any[];
+    options?: IDocumentFieldOptions[];
     base64?: string;
     hash?: string;
     ip_address?: string;
     signature_id?: string;
     signed_at?: string;
+    minimum_checked?: number;
+    maximum_checked?: number;
     [key: string]: any;
 }
+export declare type TDocumentFieldType = 'signature' | 'initial' | 'checkbox_group' | 'radio_button_group' | 'textbox' | 'timestamp' | 'date' | 'dropdown' | 'textarea' | 'attachment' | 'payment';
 export interface IDocumentField {
     envelope_id: string;
-    label: string | null;
     name: string;
+    label: string | null;
     page: number;
     recipient_role: string;
-    type: string;
+    type: TDocumentFieldType;
     required: boolean;
     settings?: IDocumentFieldSettings;
     validator: string | null;
@@ -185,7 +197,7 @@ export interface IDocument {
     certificate?: IDocumentAsset | null;
     document?: IDocumentAsset | null;
     fields?: IDocumentField[];
-    profile?: IProfile;
+    profile?: IProfile | null;
 }
 export declare type TDocumentUpdateResult = Omit<IDocument, 'histories' | 'recipients' | 'certificate' | 'document' | 'fields' | 'profile'>;
 export interface IActivityEntry {
@@ -226,3 +238,18 @@ export interface IDocumentSearchOptions {
 }
 export declare type THistoryEvent = 'recipient:invited' | 'recipient:opened' | 'recipient:agreed' | 'recipient:signed' | 'recipient:submitted';
 export declare type TEventDetail = 'in_app' | 'mail' | 'signer' | '';
+export interface ICreateDocumentRole {
+    type: TRecipientType;
+    name: string;
+    full_name: string;
+    email?: string;
+    phone?: string;
+    sequence: number;
+    delegator: boolean;
+    message: string;
+}
+export interface ICreateDocumentRequest {
+    template_id: string;
+    roles: ICreateDocumentRole[];
+    name: string;
+}

package/Templates/Validators.d.ts

@@ -15,7 +15,7 @@ export interface IValidator {
  */
 export declare const getValidators: (endpoint: VerdocsEndpoint) => Promise<IValidator[]>;
 export declare const getValidator: (endpoint: VerdocsEndpoint, validatorName: string) => Promise<IValidator>;
-export declare const isValidEmail: (value: string) => boolean;
-export declare const isValidPhone: (value: string) => boolean;
+export declare const isValidEmail: (email: string | undefined) => boolean;
+export declare const isValidPhone: (phone: string | undefined) => boolean;
 export declare const isValidRoleName: (value: string, roles: IRole[]) => boolean;
 export declare const isValidTag: (value: string, tags: ITag[]) => boolean;

package/Templates/Validators.js

@@ -1,4 +1,3 @@
-import { simpleE164Validator } from '../Utils/Locales';
 /**
  * Get all defined validators
  *
@@ -18,9 +17,11 @@ export var getValidator = function (endpoint, validatorName) {
         .get("/validators/".concat(validatorName))
         .then(function (r) { return r.data; });
 };
-var EmailRegEx = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
-export var isValidEmail = function (value) { return EmailRegEx.test(value); };
-export var isValidPhone = function (value) { return simpleE164Validator(value); };
+var EMAIL_REGEX = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+export var isValidEmail = function (email) { return !!email && EMAIL_REGEX.test(email); };
+// @see https://www.regextester.com/1978
+var PHONE_REGEX = /((?:\+|00)[17](?: |\-)?|(?:\+|00)[1-9]\d{0,2}(?: |\-)?|(?:\+|00)1\-\d{3}(?: |\-)?)?(0\d|\([0-9]{3}\)|[1-9]{0,3})(?:((?: |\-)[0-9]{2}){4}|((?:[0-9]{2}){4})|((?: |\-)[0-9]{3}(?: |\-)[0-9]{4})|([0-9]{7}))/;
+export var isValidPhone = function (phone) { return !!phone && PHONE_REGEX.test(phone); };
 export var isValidRoleName = function (value, roles) { return roles.findIndex(function (role) { return role.name === value; }) !== -1; };
 var TagRegEx = /^[a-zA-Z0-9-]{0,32}$/;
 export var isValidTag = function (value, tags) { return TagRegEx.test(value) || tags.findIndex(function (tag) { return tag.name === value; }) !== -1; };

package/Utils/Locales.d.ts

@@ -15,4 +15,3 @@ export declare function isAmericanSamoa(code: string): boolean;
 export declare function isDominicanRepublic(code: string): boolean;
 export declare function isPuertoRico(code: string): boolean;
 export declare function getMatchingCountry(code: string, substrings: number): number;
-export declare function simpleE164Validator(code: string): boolean;

package/Utils/Locales.js

@@ -1352,7 +1352,7 @@ export function getMatchingCountry(code, substrings) {
     var toMatch = code.substring(0, substrings);
     return Countries.filter(function (c) { return c.code === toMatch; }).length;
 }
-var e164Regex = new RegExp(/\+[1-9]\d{6,14}/g);
-export function simpleE164Validator(code) {
-    return (code !== null && code.length < 16 && code.length > 6 && e164Regex.test(code)) || code === '' || code === null;
-}
+// const e164Regex = new RegExp(/\+[1-9]\d{6,14}/g);
+// export function simpleE164Validator(code: string) {
+//   return (code !== null && code.length < 16 && code.length > 6 && e164Regex.test(code)) || code === '' || code === null;
+// }

package/package.json

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