@verdocs/js-sdk 2.0.15 → 2.0.16

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/package.json

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