@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.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 {Envelopes} from '@verdocs/js-sdk/Envelopes';
1417
+ * import {getEnvelopesSummary} from '@verdocs/js-sdk/Envelopes';
1418
1418
  *
1419
- * const {action_required, completed, waiting_on_others} = await Envelopes.getSummary(VerdocsEndpoint.getDefault());
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 {Envelopes} from '@verdocs/js-sdk/Envelopes';
1570
+ * import {getEnvelopes} from '@verdocs/js-sdk/Envelopes';
1598
1571
  *
1599
- * const {totals, envelopes} = await Envelopes.listEnvelopes((VerdocsEndpoint.getDefault(), { q: 'test', sort: 'created_at' });
1572
+ * const {count, envelopes} = await getEnvelopes((VerdocsEndpoint.getDefault(), { q: 'test' });
1600
1573
  * ```
1601
1574
  */
1602
1575
  const getEnvelopes = (endpoint, params) => endpoint.api //
1603
- .post('/envelopes/list', params)
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 getKbaStatus = (endpoint, envelopeId, roleName) => endpoint.api //
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 createTemplatev2 = (endpoint, params, onUploadProgress) => {
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.getKbaStatus = getKbaStatus;
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;