@verdocs/js-sdk 4.2.1 → 4.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +173 -401
- package/dist/index.d.ts +173 -401
- package/dist/index.js +12 -120
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +12 -114
- package/dist/index.mjs.map +1 -1
- package/dist/package.json +1 -1
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1414,26 +1414,14 @@ const createEnvelope = async (endpoint, request) => endpoint.api //
|
|
|
1414
1414
|
* Get a summary of currently active envelopes.
|
|
1415
1415
|
*
|
|
1416
1416
|
* ```typescript
|
|
1417
|
-
* import {
|
|
1417
|
+
* import {getEnvelopesSummary} from '@verdocs/js-sdk/Envelopes';
|
|
1418
1418
|
*
|
|
1419
|
-
* const {action_required, completed, waiting_on_others} = await
|
|
1419
|
+
* const {action_required, completed, waiting_on_others} = await getEnvelopesSummary(VerdocsEndpoint.getDefault());
|
|
1420
1420
|
* ```
|
|
1421
1421
|
*/
|
|
1422
1422
|
const getEnvelopesSummary = async (endpoint, page) => endpoint.api //
|
|
1423
1423
|
.post('/envelopes/summary', { page })
|
|
1424
1424
|
.then((r) => r.data);
|
|
1425
|
-
/**
|
|
1426
|
-
* Search for envelopes matching various criteria.
|
|
1427
|
-
*
|
|
1428
|
-
* ```typescript
|
|
1429
|
-
* import {Envelopes} from '@verdocs/js-sdk/Envelopes';
|
|
1430
|
-
*
|
|
1431
|
-
* const {result, page, total} = await Envelopes.search(VerdocsEndpoint.getDefault(), { ... });
|
|
1432
|
-
* ```
|
|
1433
|
-
*/
|
|
1434
|
-
const searchEnvelopes = async (endpoint, params) => endpoint.api //
|
|
1435
|
-
.post('/envelopes/search', params)
|
|
1436
|
-
.then((r) => r.data);
|
|
1437
1425
|
/**
|
|
1438
1426
|
* Get a signing session for an Envelope.
|
|
1439
1427
|
*/
|
|
@@ -1575,32 +1563,17 @@ const getFieldAttachment = async (endpoint, envelopeId, fieldName) => endpoint.a
|
|
|
1575
1563
|
const getEnvelopeDocumentPageDisplayUri = async (endpoint, envelopeId, documentId, page, type = 'original') => endpoint.api
|
|
1576
1564
|
.get(`/envelopes/${envelopeId}/envelope_documents/${documentId}/pages/${page}/image?type=${type}`, { timeout: 20000 })
|
|
1577
1565
|
.then((r) => r.data);
|
|
1578
|
-
const cachedEnvelopes = {};
|
|
1579
1566
|
/**
|
|
1580
|
-
* Wrapper for `getEnvelope()` that limits queries to one every 2 seconds per template ID.
|
|
1581
|
-
* This is intended for use in component hierarchies that all rely on the same template
|
|
1582
|
-
* to avoid unnecessary repeat server calls.
|
|
1583
|
-
*/
|
|
1584
|
-
const throttledGetEnvelope = (endpoint, envelopeId) => {
|
|
1585
|
-
if (cachedEnvelopes[envelopeId] && cachedEnvelopes[envelopeId].loaded + 2000 < new Date().getTime()) {
|
|
1586
|
-
return cachedEnvelopes[envelopeId].envelope;
|
|
1587
|
-
}
|
|
1588
|
-
return getEnvelope(endpoint, envelopeId).then((envelope) => {
|
|
1589
|
-
cachedEnvelopes[envelopeId] = { loaded: new Date().getTime(), envelope };
|
|
1590
|
-
return envelope;
|
|
1591
|
-
});
|
|
1592
|
-
};
|
|
1593
|
-
/**a
|
|
1594
1567
|
* Lists all envelopes accessible by the caller, with optional filters.
|
|
1595
1568
|
*
|
|
1596
1569
|
* ```typescript
|
|
1597
|
-
* import {
|
|
1570
|
+
* import {getEnvelopes} from '@verdocs/js-sdk/Envelopes';
|
|
1598
1571
|
*
|
|
1599
|
-
* const {
|
|
1572
|
+
* const {count, envelopes} = await getEnvelopes((VerdocsEndpoint.getDefault(), { q: 'test' });
|
|
1600
1573
|
* ```
|
|
1601
1574
|
*/
|
|
1602
1575
|
const getEnvelopes = (endpoint, params) => endpoint.api //
|
|
1603
|
-
.
|
|
1576
|
+
.get('/envelopes', { params })
|
|
1604
1577
|
.then((r) => r.data);
|
|
1605
1578
|
|
|
1606
1579
|
/**
|
|
@@ -1624,7 +1597,7 @@ const createInitials = (endpoint, name, initials) => {
|
|
|
1624
1597
|
* `recipient.kba_method` is set (not null), and `recipient.kba_completed` is false, this endpoint
|
|
1625
1598
|
* should be called to determine the next KBA step required.
|
|
1626
1599
|
*/
|
|
1627
|
-
const
|
|
1600
|
+
const getKbaStep = (endpoint, envelopeId, roleName) => endpoint.api //
|
|
1628
1601
|
.get(`/v2/kba/${envelopeId}/${encodeURIComponent(roleName)}`)
|
|
1629
1602
|
.then((r) => r.data);
|
|
1630
1603
|
/**
|
|
@@ -1640,7 +1613,8 @@ const submitKbaIdentity = (endpoint, envelopeId, roleName, identity) => endpoint
|
|
|
1640
1613
|
.post(`/v2/kba/identity`, { envelopeId, roleName, identity })
|
|
1641
1614
|
.then((r) => r.data);
|
|
1642
1615
|
/**
|
|
1643
|
-
* Submit an identity response to a KBA challenge.
|
|
1616
|
+
* Submit an identity response to a KBA challenge. Answers should be submitted in the same order as
|
|
1617
|
+
* the challenges were listed in `IRecipientKbaStepChallenge.questions`.
|
|
1644
1618
|
*/
|
|
1645
1619
|
const submitKbaChallengeResponse = (endpoint, envelopeId, roleName, response) => endpoint.api //
|
|
1646
1620
|
.post(`/v2/kba/response`, { envelopeId, roleName, response })
|
|
@@ -2592,7 +2566,7 @@ const getAllTags = (endpoint) => endpoint.api //
|
|
|
2592
2566
|
* ```
|
|
2593
2567
|
*/
|
|
2594
2568
|
const getTemplates = (endpoint, params) => endpoint.api //
|
|
2595
|
-
.post('/templates', { params })
|
|
2569
|
+
.post('/v2/templates', { params })
|
|
2596
2570
|
.then((r) => r.data);
|
|
2597
2571
|
// export interface IListTemplatesParams {
|
|
2598
2572
|
// name?: string;
|
|
@@ -2626,7 +2600,7 @@ const getTemplates = (endpoint, params) => endpoint.api //
|
|
|
2626
2600
|
* ```
|
|
2627
2601
|
*/
|
|
2628
2602
|
const getTemplate = (endpoint, templateId) => endpoint.api //
|
|
2629
|
-
.get(`/templates/${templateId}`)
|
|
2603
|
+
.get(`/v2/templates/${templateId}`)
|
|
2630
2604
|
.then((r) => {
|
|
2631
2605
|
const template = r.data;
|
|
2632
2606
|
window?.console?.log('[JS_SDK] Post-processing template', template);
|
|
@@ -2649,18 +2623,6 @@ const getTemplate = (endpoint, templateId) => endpoint.api //
|
|
|
2649
2623
|
});
|
|
2650
2624
|
return template;
|
|
2651
2625
|
});
|
|
2652
|
-
/**
|
|
2653
|
-
* Get owner information for a template.
|
|
2654
|
-
*
|
|
2655
|
-
* ```typescript
|
|
2656
|
-
* import {Templates} from '@verdocs/js-sdk/Templates';
|
|
2657
|
-
*
|
|
2658
|
-
* const template = await Templates.getTemplateOwnerInfo((VerdocsEndpoint.getDefault(), '83da3d70-7857-4392-b876-c4592a304bc9');
|
|
2659
|
-
* ```
|
|
2660
|
-
*/
|
|
2661
|
-
const getTemplateOwnerInfo = (endpoint, templateId) => endpoint.api //
|
|
2662
|
-
.get(`/templates/${templateId}`)
|
|
2663
|
-
.then((r) => r.data);
|
|
2664
2626
|
const ALLOWED_CREATE_FIELDS = [
|
|
2665
2627
|
'name',
|
|
2666
2628
|
'is_personal',
|
|
@@ -2670,43 +2632,6 @@ const ALLOWED_CREATE_FIELDS = [
|
|
|
2670
2632
|
'roles',
|
|
2671
2633
|
'fields',
|
|
2672
2634
|
];
|
|
2673
|
-
/**
|
|
2674
|
-
* Create a template.
|
|
2675
|
-
*
|
|
2676
|
-
* ```typescript
|
|
2677
|
-
* import {Templates} from '@verdocs/js-sdk/Templates';
|
|
2678
|
-
*
|
|
2679
|
-
* const newTemplate = await Templates.createTemplate((VerdocsEndpoint.getDefault(), {...});
|
|
2680
|
-
* ```
|
|
2681
|
-
*/
|
|
2682
|
-
const createTemplate = (endpoint, params, onUploadProgress) => {
|
|
2683
|
-
const options = {
|
|
2684
|
-
timeout: 120000,
|
|
2685
|
-
onUploadProgress: (event) => {
|
|
2686
|
-
const total = event.total || 1;
|
|
2687
|
-
const loaded = event.loaded || 0;
|
|
2688
|
-
onUploadProgress?.(Math.floor((loaded * 100) / (total || 1)), loaded, total || 1);
|
|
2689
|
-
},
|
|
2690
|
-
};
|
|
2691
|
-
if (params.documents && params.documents[0] instanceof File) {
|
|
2692
|
-
if (params.documents.length > 10) {
|
|
2693
|
-
throw new Error('createTemplate() has a maximum of 10 documents that can be attached.');
|
|
2694
|
-
}
|
|
2695
|
-
const formData = new FormData();
|
|
2696
|
-
ALLOWED_CREATE_FIELDS.forEach((allowedKey) => {
|
|
2697
|
-
if (params[allowedKey] !== undefined) {
|
|
2698
|
-
formData.append(allowedKey, params[allowedKey]);
|
|
2699
|
-
}
|
|
2700
|
-
});
|
|
2701
|
-
params.documents.forEach((file) => {
|
|
2702
|
-
formData.append('documents', file, file.name);
|
|
2703
|
-
});
|
|
2704
|
-
return endpoint.api.post('/templates', formData, options).then((r) => r.data);
|
|
2705
|
-
}
|
|
2706
|
-
else {
|
|
2707
|
-
return endpoint.api.post('/templates', params, options).then((r) => r.data);
|
|
2708
|
-
}
|
|
2709
|
-
};
|
|
2710
2635
|
/**
|
|
2711
2636
|
* Create a template.
|
|
2712
2637
|
*
|
|
@@ -2716,7 +2641,7 @@ const createTemplate = (endpoint, params, onUploadProgress) => {
|
|
|
2716
2641
|
* const newTemplate = await Templates.createTemplatev2((VerdocsEndpoint.getDefault(), {...});
|
|
2717
2642
|
* ```
|
|
2718
2643
|
*/
|
|
2719
|
-
const
|
|
2644
|
+
const createTemplate = (endpoint, params, onUploadProgress) => {
|
|
2720
2645
|
const options = {
|
|
2721
2646
|
timeout: 120000,
|
|
2722
2647
|
onUploadProgress: (event) => {
|
|
@@ -2792,33 +2717,6 @@ const deleteTemplate = (endpoint, templateId) => endpoint.api //
|
|
|
2792
2717
|
const searchTemplates = async (endpoint, params) => endpoint.api //
|
|
2793
2718
|
.post('/templates/search', params)
|
|
2794
2719
|
.then((r) => r.data);
|
|
2795
|
-
/**
|
|
2796
|
-
* Get a summary of template data, typically used to populate admin panel dashboard pages.
|
|
2797
|
-
*
|
|
2798
|
-
* ```typescript
|
|
2799
|
-
* import {Templates} from '@verdocs/js-sdk/Templates';
|
|
2800
|
-
*
|
|
2801
|
-
* const summary = await Templates.getSummary((VerdocsEndpoint.getDefault(), 0);
|
|
2802
|
-
* ```
|
|
2803
|
-
*/
|
|
2804
|
-
const getTemplatesSummary = async (endpoint, params = {}) => endpoint.api //
|
|
2805
|
-
.post('/templates/summary', params)
|
|
2806
|
-
.then((r) => r.data);
|
|
2807
|
-
const cachedTemplates = {};
|
|
2808
|
-
/**
|
|
2809
|
-
* Wrapper for `getTemplate()` that limits queries to one every 2 seconds per template ID.
|
|
2810
|
-
* This is intended for use in component hierarchies that all rely on the same template
|
|
2811
|
-
* to avoid unnecessary repeat server calls.
|
|
2812
|
-
*/
|
|
2813
|
-
const throttledGetTemplate = (endpoint, templateId) => {
|
|
2814
|
-
if (cachedTemplates[templateId] && cachedTemplates[templateId].loaded + 2000 < new Date().getTime()) {
|
|
2815
|
-
return cachedTemplates[templateId].template;
|
|
2816
|
-
}
|
|
2817
|
-
return getTemplate(endpoint, templateId).then((template) => {
|
|
2818
|
-
cachedTemplates[templateId] = { loaded: new Date().getTime(), template };
|
|
2819
|
-
return template;
|
|
2820
|
-
});
|
|
2821
|
-
};
|
|
2822
2720
|
/**
|
|
2823
2721
|
* List templates.
|
|
2824
2722
|
*
|
|
@@ -2972,7 +2870,6 @@ exports.createTemplateDocument = createTemplateDocument;
|
|
|
2972
2870
|
exports.createTemplateFromSharepoint = createTemplateFromSharepoint;
|
|
2973
2871
|
exports.createTemplateReminder = createTemplateReminder;
|
|
2974
2872
|
exports.createTemplateRole = createTemplateRole;
|
|
2975
|
-
exports.createTemplatev2 = createTemplatev2;
|
|
2976
2873
|
exports.declineOrganizationInvitation = declineOrganizationInvitation;
|
|
2977
2874
|
exports.decodeAccessTokenBody = decodeAccessTokenBody;
|
|
2978
2875
|
exports.decodeJWTBody = decodeJWTBody;
|
|
@@ -3023,7 +2920,7 @@ exports.getFieldsForRole = getFieldsForRole;
|
|
|
3023
2920
|
exports.getGroup = getGroup;
|
|
3024
2921
|
exports.getGroups = getGroups;
|
|
3025
2922
|
exports.getInPersonLink = getInPersonLink;
|
|
3026
|
-
exports.
|
|
2923
|
+
exports.getKbaStep = getKbaStep;
|
|
3027
2924
|
exports.getMatchingCountry = getMatchingCountry;
|
|
3028
2925
|
exports.getNextRecipient = getNextRecipient;
|
|
3029
2926
|
exports.getNotifications = getNotifications;
|
|
@@ -3053,14 +2950,12 @@ exports.getTemplateDocumentFile = getTemplateDocumentFile;
|
|
|
3053
2950
|
exports.getTemplateDocumentPageDisplayUri = getTemplateDocumentPageDisplayUri;
|
|
3054
2951
|
exports.getTemplateDocumentThumbnail = getTemplateDocumentThumbnail;
|
|
3055
2952
|
exports.getTemplateDocuments = getTemplateDocuments;
|
|
3056
|
-
exports.getTemplateOwnerInfo = getTemplateOwnerInfo;
|
|
3057
2953
|
exports.getTemplateReminder = getTemplateReminder;
|
|
3058
2954
|
exports.getTemplateRole = getTemplateRole;
|
|
3059
2955
|
exports.getTemplateRoleFields = getTemplateRoleFields;
|
|
3060
2956
|
exports.getTemplateRoles = getTemplateRoles;
|
|
3061
2957
|
exports.getTemplateTags = getTemplateTags;
|
|
3062
2958
|
exports.getTemplates = getTemplates;
|
|
3063
|
-
exports.getTemplatesSummary = getTemplatesSummary;
|
|
3064
2959
|
exports.getValidator = getValidator;
|
|
3065
2960
|
exports.getValidators = getValidators;
|
|
3066
2961
|
exports.getWebhooks = getWebhooks;
|
|
@@ -3089,7 +2984,6 @@ exports.resendOrganizationInvitation = resendOrganizationInvitation;
|
|
|
3089
2984
|
exports.resendVerification = resendVerification;
|
|
3090
2985
|
exports.resetPassword = resetPassword;
|
|
3091
2986
|
exports.rotateApiKey = rotateApiKey;
|
|
3092
|
-
exports.searchEnvelopes = searchEnvelopes;
|
|
3093
2987
|
exports.searchTemplates = searchTemplates;
|
|
3094
2988
|
exports.sendDelegate = sendDelegate;
|
|
3095
2989
|
exports.setWebhooks = setWebhooks;
|
|
@@ -3097,8 +2991,6 @@ exports.submitKbaChallengeResponse = submitKbaChallengeResponse;
|
|
|
3097
2991
|
exports.submitKbaIdentity = submitKbaIdentity;
|
|
3098
2992
|
exports.submitKbaPin = submitKbaPin;
|
|
3099
2993
|
exports.switchProfile = switchProfile;
|
|
3100
|
-
exports.throttledGetEnvelope = throttledGetEnvelope;
|
|
3101
|
-
exports.throttledGetTemplate = throttledGetTemplate;
|
|
3102
2994
|
exports.timePeriod = timePeriod;
|
|
3103
2995
|
exports.toggleStar = toggleStar;
|
|
3104
2996
|
exports.updateApiKey = updateApiKey;
|