@verdocs/js-sdk 2.0.12 → 2.0.15

package/Documents/Documents.d.ts

@@ -1,161 +1,6 @@
-import { ISigningSession, ISigningSessionRequest } from './Types';
+import { IDocument, IDocumentsSearchResult, IDocumentsSummary, IRecipient, ISigningSession, ISigningSessionRequest } from './Types';
+import { TDocumentUpdateResult, IDocumentFieldSettings } from './Types';
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
-import { IFieldSetting } from '../Templates/Types';
-import { IProfile } from '../Users/Types';
-export declare type TDocumentStatus = 'complete' | 'pending' | 'in progress' | 'declined' | 'canceled';
-export declare type TRecipientStatus = 'invited' | 'opened' | 'signed' | 'submitted' | 'canceled' | 'pending' | 'declined';
-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;
-        email: string;
-        name: string;
-        profile_id: string;
-        status: TRecipientStatus;
-        type: TRecipientType;
-    };
-    template_id: string;
-    total_count: number;
-    updated_at: string;
-}
-export interface IDocumentsSearchResult {
-    page: number;
-    total: number;
-    result: IDocumentsSearchResultEntry[];
-}
-export interface IDocumentsSummary {
-    action_required: {
-        page: number;
-        total: number;
-        result: IActivityEntry[];
-    };
-    completed: {
-        page: number;
-        total: number;
-        result: IActivityEntry[];
-    };
-    waiting_others: {
-        page: number;
-        total: number;
-        result: IActivityEntry[];
-    };
-}
-export interface IRecipient {
-    agreed: boolean;
-    claimed: boolean;
-    created_at: string;
-    delegated_to: string | null;
-    delegator: boolean;
-    email: string;
-    envelope_id: string;
-    full_name: string;
-    in_app_access_key?: string;
-    key_used_to_conclude?: string;
-    message: string | null;
-    phone: string | null;
-    profile_id: string;
-    role_name: string;
-    sequence: number;
-    status: TRecipientStatus;
-    type: TRecipientType;
-    updated_at: string;
-}
-export interface IDocumentAsset {
-    created_at: string;
-    id: string;
-    mime: string;
-    name: string;
-    page_numbers: number;
-    updated_at: string;
-    url: string;
-}
-export interface IDocumentField {
-    envelope_id: string;
-    label: string | null;
-    name: string;
-    page: number;
-    recipient_role: string;
-    type: string;
-    required: boolean;
-    settings?: IFieldSetting;
-    setting?: IFieldSetting;
-    validator: string | null;
-    prepared?: boolean;
-}
-export interface IDocument {
-    id: string;
-    created_at: string;
-    canceled_at: string;
-    envelope_document_id: string;
-    certificate_document_id: string | null;
-    histories: IHistory[];
-    recipients: IRecipient[];
-    name: string;
-    no_contact: boolean;
-    profile_id: string;
-    reminder_id: string | null;
-    status: TDocumentStatus;
-    template_id: string;
-    updated_at: string;
-    organization_id: string | null;
-    certificate?: IDocumentAsset | null;
-    document?: IDocumentAsset | null;
-    fields?: IDocumentField[];
-    profile?: IProfile;
-}
-export declare type TDocumentUpdateResult = Omit<IDocument, 'histories' | 'recipients' | 'certificate' | 'document' | 'fields' | 'profile'>;
-export interface IActivityEntry {
-    id: string;
-    name: string;
-    canceled_at: string;
-    created_at: string;
-    updated_at: string;
-    profile_id: string;
-    status: TDocumentStatus;
-    template_id: string;
-    recipient: {
-        claimed: boolean;
-        email: string;
-        name: string;
-        profile_id: string;
-        status: TRecipientStatus;
-        type: TRecipientType;
-    };
-}
-export interface IHistory {
-    created_at: string;
-    envelope_id: string;
-    event: IHistoryEvent;
-    event_detail: IEventDetail;
-    id: string;
-    role_name: string;
-}
-export interface IDocumentSearchOptions {
-    rows?: number;
-    page?: number;
-    sort_by?: 'updated_at' | 'created_at';
-    ascending?: boolean;
-    is_owner?: boolean;
-    is_recipient?: boolean;
-    envelope_status: TDocumentStatus[];
-    recipient_status: TDocumentStatus[];
-}
-export declare type IHistoryEvent = 'recipient:invited' | 'recipient:opened' | 'recipient:agreed' | 'recipient:signed' | 'recipient:submitted';
-export declare type IEventDetail = 'in_app' | 'mail' | 'signer' | '';
 /**
  * Get a summary of currently active documents.
  *
@@ -220,9 +65,9 @@ export declare const getDocumentFile: (endpoint: VerdocsEndpoint, documentId: st
 /**
  * Update a Document field. Typically called during the signing process as a Recipient fills in fields.
  */
-export declare const updateDocumentField: (endpoint: VerdocsEndpoint, documentId: string, fieldName: string, value: any) => Promise<IFieldSetting>;
+export declare const updateDocumentField: (endpoint: VerdocsEndpoint, documentId: string, fieldName: string, value: any) => Promise<IDocumentFieldSettings>;
 /**
  * Update a Document signature field. Signature fields are ID-driven. Call `Document.createSignature()` first to create a
  * signature for a Recipient, then call `Documents.updateDocumentFieldSignature()` to attach it to a field.
  */
-export declare const updateDocumentFieldSignature: (endpoint: VerdocsEndpoint, documentId: string, fieldName: string, signatureId: string) => Promise<IFieldSetting>;
+export declare const updateDocumentFieldSignature: (endpoint: VerdocsEndpoint, documentId: string, fieldName: string, signatureId: string) => Promise<IDocumentFieldSettings>;

package/Documents/Recipients.d.ts

@@ -1,6 +1,6 @@
 import { IInPersonAccessKey, TRecipientAction } from './Types';
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
-import { IDocument, IRecipient } from './Documents';
+import { IDocument, IRecipient } from './Types';
 export interface IUpdateRecipientParams {
     new_full_name?: string;
     agreed?: boolean;
@@ -15,4 +15,5 @@ export interface ISignerTokenResponse {
     signerToken: string;
     inPersonAccessKey: IInPersonAccessKey;
 }
-export declare const getSignerToken: (endpoint: VerdocsEndpoint, documentId: string, roleName: string) => Promise<import("axios").AxiosResponse<ISignerTokenResponse, any>>;
+export declare const getSignerToken: (endpoint: VerdocsEndpoint, documentId: string, roleName: string) => Promise<ISignerTokenResponse>;
+export declare const getInPersonLink: (endpoint: VerdocsEndpoint, documentId: string, roleName: string) => Promise<ISignerTokenResponse>;

package/Documents/Recipients.js

@@ -57,5 +57,11 @@ export var updateRecipientStatus = function (endpoint, documentId, roleName, act
 }); };
 export var getSignerToken = function (endpoint, documentId, roleName) {
     return endpoint.api //
-        .get("/documents/".concat(documentId, "/recipients/").concat(encodeURIComponent(roleName), "/signer-token"));
+        .get("/documents/".concat(documentId, "/recipients/").concat(encodeURIComponent(roleName), "/signer-token"))
+        .then(function (r) { return r.data; });
+};
+export var getInPersonLink = function (endpoint, documentId, roleName) {
+    return endpoint.api //
+        .get("/documents/".concat(documentId, "/recipients/").concat(encodeURIComponent(roleName), "?in_person_link=true"))
+        .then(function (r) { return r.data; });
 };

package/Documents/Types.d.ts

@@ -1,3 +1,4 @@
+import { IProfile } from '../Users/Types';
 export declare type TRecipientAction = 'submit' | 'decline' | 'prepare' | 'update';
 export interface ITemplateSummaryEntry {
     id: string;
@@ -53,3 +54,175 @@ export interface IInPersonAccessKey {
     first_used: string | null;
     last_used: string | null;
 }
+export declare type TDocumentStatus = 'complete' | 'pending' | 'in progress' | 'declined' | 'canceled';
+export declare type TRecipientStatus = 'invited' | 'opened' | 'signed' | 'submitted' | 'canceled' | 'pending' | 'declined';
+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;
+        email: string;
+        name: string;
+        profile_id: string;
+        status: TRecipientStatus;
+        type: TRecipientType;
+    };
+    template_id: string;
+    total_count: number;
+    updated_at: string;
+}
+export interface IDocumentsSearchResult {
+    page: number;
+    total: number;
+    result: IDocumentsSearchResultEntry[];
+}
+export interface IDocumentsSummary {
+    action_required: {
+        page: number;
+        total: number;
+        result: IActivityEntry[];
+    };
+    completed: {
+        page: number;
+        total: number;
+        result: IActivityEntry[];
+    };
+    waiting_others: {
+        page: number;
+        total: number;
+        result: IActivityEntry[];
+    };
+}
+export interface IRecipient {
+    agreed: boolean;
+    claimed: boolean;
+    created_at: string;
+    delegated_to: string | null;
+    delegator: boolean;
+    email: string;
+    envelope_id: string;
+    full_name: string;
+    in_app_access_key?: string;
+    key_used_to_conclude?: string;
+    message: string | null;
+    phone: string | null;
+    profile_id: string;
+    role_name: string;
+    sequence: number;
+    status: TRecipientStatus;
+    type: TRecipientType;
+    updated_at: string;
+}
+export interface IDocumentAsset {
+    created_at: string;
+    id: string;
+    mime: string;
+    name: string;
+    page_numbers: number;
+    updated_at: string;
+    url: string;
+}
+export interface IDocumentFieldSettings {
+    type?: string;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    value?: number | string;
+    result?: any;
+    leading?: number;
+    alignment?: number;
+    upperCase?: boolean;
+    options?: any[];
+    base64?: string;
+    hash?: string;
+    ip_address?: string;
+    signature_id?: string;
+    signed_at?: string;
+    [key: string]: any;
+}
+export interface IDocumentField {
+    envelope_id: string;
+    label: string | null;
+    name: string;
+    page: number;
+    recipient_role: string;
+    type: string;
+    required: boolean;
+    settings?: IDocumentFieldSettings;
+    validator: string | null;
+    prepared?: boolean;
+}
+export interface IDocument {
+    id: string;
+    created_at: string;
+    canceled_at: string;
+    envelope_document_id: string;
+    certificate_document_id: string | null;
+    histories: IHistory[];
+    recipients: IRecipient[];
+    name: string;
+    no_contact: boolean;
+    profile_id: string;
+    reminder_id: string | null;
+    status: TDocumentStatus;
+    template_id: string;
+    updated_at: string;
+    organization_id: string | null;
+    certificate?: IDocumentAsset | null;
+    document?: IDocumentAsset | null;
+    fields?: IDocumentField[];
+    profile?: IProfile;
+}
+export declare type TDocumentUpdateResult = Omit<IDocument, 'histories' | 'recipients' | 'certificate' | 'document' | 'fields' | 'profile'>;
+export interface IActivityEntry {
+    id: string;
+    name: string;
+    canceled_at: string;
+    created_at: string;
+    updated_at: string;
+    profile_id: string;
+    status: TDocumentStatus;
+    template_id: string;
+    recipient: {
+        claimed: boolean;
+        email: string;
+        name: string;
+        profile_id: string;
+        status: TRecipientStatus;
+        type: TRecipientType;
+    };
+}
+export interface IHistory {
+    created_at: string;
+    envelope_id: string;
+    event: THistoryEvent;
+    event_detail: TEventDetail;
+    id: string;
+    role_name: string;
+}
+export interface IDocumentSearchOptions {
+    rows?: number;
+    page?: number;
+    sort_by?: 'updated_at' | 'created_at';
+    ascending?: boolean;
+    is_owner?: boolean;
+    is_recipient?: boolean;
+    envelope_status: TDocumentStatus[];
+    recipient_status: TDocumentStatus[];
+}
+export declare type THistoryEvent = 'recipient:invited' | 'recipient:opened' | 'recipient:agreed' | 'recipient:signed' | 'recipient:submitted';
+export declare type TEventDetail = 'in_app' | 'mail' | 'signer' | '';

package/Organizations/Members.d.ts

@@ -1,10 +1,11 @@
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
+import { IProfile } from '../Users/Types';
 /**
  * An Organization Member (aka Profile) is an individual user with access to an organization.
  *
  * @module
  */
-export declare const getMembers: (endpoint: VerdocsEndpoint, organizationId: string) => Promise<any>;
+export declare const getMembers: (endpoint: VerdocsEndpoint, organizationId: string) => Promise<IProfile[]>;
 export declare const deleteMember: (endpoint: VerdocsEndpoint, organizationId: string, profileId: string) => Promise<any>;
 export declare const addMemberRole: (endpoint: VerdocsEndpoint, organizationId: string, profileId: string, roleId: string) => Promise<any>;
 export declare const deleteMemberRole: (endpoint: VerdocsEndpoint, organizationId: string, profileId: string, roleId: string) => Promise<any>;

package/Organizations/Types.d.ts

@@ -28,6 +28,7 @@ export interface IApiKey {
     name: string;
     profile_id: string;
     organization_id: string;
+    profile?: IProfile;
 }
 export interface IApiKeyWithSecret extends IApiKey {
     client_id: string;

package/Search/Types.d.ts

@@ -1,5 +1,5 @@
-import { TDocumentStatus } from '../Documents/Documents';
 import { TTemplateSender } from '../Templates/Types';
+import { TDocumentStatus } from '../Documents/Types';
 export declare type TMimeType = 'application/pdf' | string;
 /**
  * An individual hit in a document search result. Note that this schema does not precisely match IDocument because fields

package/Templates/Templates.d.ts

@@ -4,7 +4,7 @@
  *
  * @module
  */
-import { ITemplate, ITemplatesSearchResult, ITemplatesSummary } from './Types';
+import { ITemplate, ITemplateOwnerInfo, ITemplatesSearchResult, ITemplatesSummary } from './Types';
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
 export interface IGetTemplatesParams {
     is_starred?: boolean;
@@ -23,7 +23,7 @@ export interface IGetTemplatesParams {
  * await Templates.getTemplates({ is_organization: true });
  * ```
  */
-export declare const getTemplates: (endpoint: VerdocsEndpoint, params?: IGetTemplatesParams) => Promise<any[]>;
+export declare const getTemplates: (endpoint: VerdocsEndpoint, params?: IGetTemplatesParams) => Promise<ITemplate[]>;
 /**
  * Get one template by its ID.
  *
@@ -33,7 +33,17 @@ export declare const getTemplates: (endpoint: VerdocsEndpoint, params?: IGetTemp
  * const template = await Templates.getTemplate('83da3d70-7857-4392-b876-c4592a304bc9');
  * ```
  */
-export declare const getTemplate: (endpoint: VerdocsEndpoint, templateId: string) => Promise<any>;
+export declare const getTemplate: (endpoint: VerdocsEndpoint, templateId: string) => Promise<ITemplate>;
+/**
+ * Get owner information for a template.
+ *
+ * ```typescript
+ * import {Templates} from '@verdocs/js-sdk/Templates';
+ *
+ * const template = await Templates.getTemplateOwnerInfo('83da3d70-7857-4392-b876-c4592a304bc9');
+ * ```
+ */
+export declare const getTemplateOwnerInfo: (endpoint: VerdocsEndpoint, templateId: string) => Promise<ITemplateOwnerInfo>;
 /**
  * Create a template.
  *

package/Templates/Templates.js

@@ -54,7 +54,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
  */
 export var getTemplates = function (endpoint, params) {
     return endpoint.api //
-        .get('/templates/', { params: params })
+        .get('/templates', { params: params })
         .then(function (r) { return r.data; });
 };
 /**
@@ -71,6 +71,20 @@ export var getTemplate = function (endpoint, templateId) {
         .get("/templates/".concat(templateId))
         .then(function (r) { return r.data; });
 };
+/**
+ * Get owner information for a template.
+ *
+ * ```typescript
+ * import {Templates} from '@verdocs/js-sdk/Templates';
+ *
+ * const template = await Templates.getTemplateOwnerInfo('83da3d70-7857-4392-b876-c4592a304bc9');
+ * ```
+ */
+export var getTemplateOwnerInfo = function (endpoint, templateId) {
+    return endpoint.api //
+        .get("/templates/".concat(templateId))
+        .then(function (r) { return r.data; });
+};
 /**
  * Create a template.
  *

package/Templates/Types.d.ts

@@ -154,28 +154,21 @@ export interface ITemplateField {
     template_id: string;
     type: string;
     required: boolean;
-    setting?: IFieldSetting;
+    setting: ITemplateFieldSetting;
     page_sequence: number;
     validator?: string;
     label?: string;
 }
-export interface IFieldSetting {
+export interface ITemplateFieldSetting {
     x: number;
     y: number;
+    result?: string;
     width?: number;
     height?: number;
-    result?: any;
-    type?: string;
-    value?: string;
     leading?: number;
     alignment?: number;
     upperCase?: boolean;
     options?: any[];
-    base64?: string;
-    hash?: string;
-    ip_address?: string;
-    signature_id?: string;
-    signed_at?: string;
     [key: string]: any;
 }
 export interface IPage {
@@ -198,3 +191,8 @@ export interface IReminder {
     envelope_id: string;
     template_id: string;
 }
+export interface ITemplateOwnerInfo {
+    email: string;
+    name: string;
+    profile_id: string;
+}

package/VerdocsEndpoint.d.ts

@@ -37,7 +37,7 @@ export interface VerdocsEndpointOptions {
 export declare class VerdocsEndpoint {
     private environment;
     private sessionType;
-    private baseURL;
+    private readonly baseURL;
     private clientID;
     private timeout;
     private token;

package/VerdocsEndpoint.js

@@ -72,9 +72,6 @@ var VerdocsEndpoint = /** @class */ (function () {
             globalThis[ENDPOINT_KEY] = new VerdocsEndpoint();
             window.console.debug('[JS_SDK] Created default endpoint', globalThis[ENDPOINT_KEY]);
         }
-        else {
-            window.console.debug('[JS SDK] Re-using existing endpoint', globalThis[ENDPOINT_KEY]);
-        }
         return globalThis[ENDPOINT_KEY];
     };
     /**

package/package.json

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