@verdocs/js-sdk 6.7.0 → 6.7.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 CHANGED
@@ -423,23 +423,7 @@ interface IUser {
423
423
  created_at: string;
424
424
  updated_at: string;
425
425
  }
426
- // TODO: Combine this with TWebhookEvent in
427
- interface IWebhookEvents {
428
- envelope_created: boolean;
429
- envelope_completed: boolean;
430
- envelope_updated: boolean;
431
- envelope_canceled: boolean;
432
- envelope_expired: boolean;
433
- template_created: boolean;
434
- template_updated: boolean;
435
- template_deleted: boolean;
436
- template_used: boolean;
437
- recipient_submitted: boolean;
438
- recipient_updated: boolean;
439
- recipient_delegated: boolean;
440
- kba_event: boolean;
441
- entitlement_used: boolean;
442
- }
426
+ type IWebhookEvents = Record<TWebhookEvent, boolean>;
443
427
  interface IWebhook {
444
428
  id: string;
445
429
  organization_id: string;
@@ -539,6 +523,8 @@ interface IEnvelope {
539
523
  initial_reminder: number | null;
540
524
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
541
525
  followup_reminders: number | null;
526
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
527
+ max_reminder_days: number;
542
528
  /** When the next reminder is scheduled to be sent. */
543
529
  next_reminder: string | null;
544
530
  /** Date/time when the envelope was created. */
@@ -888,6 +874,8 @@ interface ITemplate {
888
874
  initial_reminder: number | null;
889
875
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
890
876
  followup_reminders: number | null;
877
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
878
+ max_reminder_days: number;
891
879
  /**
892
880
  * If true, the template is only visible to the creator. If false, the template will also be visible to the user's
893
881
  * organization, if any.
@@ -1042,7 +1030,7 @@ type TEventDetail = "in_app" | "mail" | "signer" | "sms" | "reminder" | "prepare
1042
1030
  // Modification events have a string description
1043
1031
  type TEnvelopeUpdateResult = Omit<IEnvelope, "histories" | "recipients" | "certificate" | "document" | "fields" | "profile">;
1044
1032
  type TFieldType = "signature" | "initial" | "checkbox" | "radio" | "textbox" | "timestamp" | "date" | "dropdown" | "textarea" | "attachment" | "payment";
1045
- type TWebhookEvent = "envelope_created" | "envelope_completed" | "envelope_canceled" | "envelope_updated" | "envelope_expired" | "template_created" | "template_updated" | "template_deleted" | "template_used" | "recipient_submitted" | "recipient_updated" | "recipient_delegated" | "kba_event" | "entitlement_used";
1033
+ type TWebhookEvent = "envelope_created" | "envelope_completed" | "envelope_canceled" | "envelope_updated" | "envelope_expired" | "template_created" | "template_updated" | "template_deleted" | "template_used" | "recipient_submitted" | "recipient_updated" | "recipient_delegated" | "kba_event" | "entitlement_used" | "recipient_invited" | "recipient_reminded" | "recipient_auth_fail" | "recipient_disclosure_accepted" | "recipient_docs_downloaded" | "recipient_invite_failed";
1046
1034
  declare const WEBHOOK_EVENTS: readonly [
1047
1035
  "envelope_created",
1048
1036
  "envelope_completed",
@@ -1057,7 +1045,13 @@ declare const WEBHOOK_EVENTS: readonly [
1057
1045
  "recipient_updated",
1058
1046
  "recipient_delegated",
1059
1047
  "kba_event",
1060
- "entitlement_used"
1048
+ "entitlement_used",
1049
+ "recipient_invited",
1050
+ "recipient_reminded",
1051
+ "recipient_auth_fail",
1052
+ "recipient_disclosure_accepted",
1053
+ "recipient_docs_downloaded",
1054
+ "recipient_invite_failed"
1061
1055
  ];
1062
1056
  type TTemplateVisibility = "private" | "shared" | "public";
1063
1057
  type TEntitlement = "envelope" | "kba_auth" | "passcode_auth" | "sms_auth" | "kba_id_auth" | "id_auth" | "custom_disclaimer";
@@ -1612,6 +1606,8 @@ interface ICreateEnvelopeFromTemplateRequest {
1612
1606
  initial_reminder?: number;
1613
1607
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
1614
1608
  followup_reminders?: number;
1609
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
1610
+ max_reminder_days?: number;
1615
1611
  /** List of recipients to configure. */
1616
1612
  recipients: ICreateEnvelopeRecipientFromTemplate[];
1617
1613
  /** Optional metadata to attach to the envelope. This is not used by Verdocs, but may be used for internal tracking purposes by the caller. This is not shown to recipients, but is not private and should not be used to store sensitive data. */
@@ -1640,6 +1636,8 @@ interface ICreateEnvelopeDirectlyRequest {
1640
1636
  initial_reminder: number;
1641
1637
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
1642
1638
  followup_reminders: number;
1639
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
1640
+ max_reminder_days?: number;
1643
1641
  /** Optional metadata to attach to the envelope. This is not used by Verdocs, but may be used for internal tracking purposes by the caller. This is not shown to recipients, but is not private and should not be used to store sensitive data. */
1644
1642
  data?: any;
1645
1643
  /** List of recipients to configure. */
@@ -1734,6 +1732,7 @@ declare const DEFAULT_DISCLOSURES = "\n<ul>\n <li>\n Agree to use electronic
1734
1732
  * @apiBody boolean no_contact? If set to true, no email or SMS messages will be sent to any recipients.
1735
1733
  * @apiBody integer(min: 0) initial_reminder? Override the template initial-reminder setting in ms.
1736
1734
  * @apiBody integer(min: 0) followup_reminders? Override the template initial-reminder setting in ms.
1735
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
1737
1736
  * @apiBody string expires_at? If set, the envelope will automatically expire (be canceled) at this date and time. Expirations must be at least 1 day in the future.
1738
1737
  * @apiSuccess IEnvelope . The newly-created envelope.
1739
1738
  */
@@ -1810,6 +1809,7 @@ declare const getEnvelopeFile: (endpoint: VerdocsEndpoint, documentId: string) =
1810
1809
  * @apiBody string sender_email? New Sender Email for the envelope
1811
1810
  * @apiBody integer(min: 0) initial_reminder? Change the initial-reminder setting (in ms).
1812
1811
  * @apiBody integer(min: 0) followup_reminders? Change the followup-reminder setting (in ms).
1812
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
1813
1813
  * @apiBody string expires_at? If set, the envelope will automatically expire (be canceled) at this date and time. Expirations must be at least 1 day in the future.
1814
1814
  * @apiBody string(enum:'private'|'shared') visibility? Change the envelope's visibility setting
1815
1815
  * @apiBody boolean no_contact? If set to true, no email or SMS messages will be sent to any recipients.
@@ -3674,6 +3674,8 @@ interface ITemplateCreateParams {
3674
3674
  initial_reminder?: number;
3675
3675
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
3676
3676
  followup_reminders?: number;
3677
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
3678
+ max_reminder_days?: number;
3677
3679
  /** Optional description for the template to help identify it. */
3678
3680
  description?: string;
3679
3681
  /**
@@ -3711,6 +3713,7 @@ interface ITemplateCreateParams {
3711
3713
  * @apiBody TTemplateSender sender? Who may send envelopes using this template
3712
3714
  * @apiBody number initial_reminder? Delay (in seconds) before the first reminder is sent (min: 4hrs). Set to 0 or null to disable.
3713
3715
  * @apiBody number followup_reminders? Delay (in seconds) before the subsequent reminders are sent (min: 12hrs). Set to 0 or null to disable.
3716
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
3714
3717
  * @apiBody array(items:object) documents? Optional list of documents to attach to the template
3715
3718
  * @apiBody array(items:IRole) roles? Optional list of roles to create. Note that if roles are not included in the request, fields will be ignored.
3716
3719
  * @apiBody array(fields:ITemplateField) fields? Optional list of fields to create. Note that if fields that do not match a role will be ignored.
@@ -3785,6 +3788,7 @@ declare const createTemplateFromSharepoint: (endpoint: VerdocsEndpoint, params:
3785
3788
  * @apiBody TTemplateSender sender? Who may send envelopes using this template
3786
3789
  * @apiBody number initial_reminder? Delay in ms before the first reminder is sent (min: 4hrs). Set to 0 or null to disable.
3787
3790
  * @apiBody number followup_reminders? Delay in ms before the subsequent reminders are sent (min: 12hrs). Set to 0 or null to disable.
3791
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
3788
3792
  * @apiSuccess ITemplate . The updated template
3789
3793
  */
3790
3794
  declare const updateTemplate: (endpoint: VerdocsEndpoint, templateId: string, params: Partial<ITemplateCreateParams>) => Promise<ITemplate>;
package/dist/index.d.ts CHANGED
@@ -423,23 +423,7 @@ interface IUser {
423
423
  created_at: string;
424
424
  updated_at: string;
425
425
  }
426
- // TODO: Combine this with TWebhookEvent in
427
- interface IWebhookEvents {
428
- envelope_created: boolean;
429
- envelope_completed: boolean;
430
- envelope_updated: boolean;
431
- envelope_canceled: boolean;
432
- envelope_expired: boolean;
433
- template_created: boolean;
434
- template_updated: boolean;
435
- template_deleted: boolean;
436
- template_used: boolean;
437
- recipient_submitted: boolean;
438
- recipient_updated: boolean;
439
- recipient_delegated: boolean;
440
- kba_event: boolean;
441
- entitlement_used: boolean;
442
- }
426
+ type IWebhookEvents = Record<TWebhookEvent, boolean>;
443
427
  interface IWebhook {
444
428
  id: string;
445
429
  organization_id: string;
@@ -539,6 +523,8 @@ interface IEnvelope {
539
523
  initial_reminder: number | null;
540
524
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
541
525
  followup_reminders: number | null;
526
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
527
+ max_reminder_days: number;
542
528
  /** When the next reminder is scheduled to be sent. */
543
529
  next_reminder: string | null;
544
530
  /** Date/time when the envelope was created. */
@@ -888,6 +874,8 @@ interface ITemplate {
888
874
  initial_reminder: number | null;
889
875
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
890
876
  followup_reminders: number | null;
877
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
878
+ max_reminder_days: number;
891
879
  /**
892
880
  * If true, the template is only visible to the creator. If false, the template will also be visible to the user's
893
881
  * organization, if any.
@@ -1042,7 +1030,7 @@ type TEventDetail = "in_app" | "mail" | "signer" | "sms" | "reminder" | "prepare
1042
1030
  // Modification events have a string description
1043
1031
  type TEnvelopeUpdateResult = Omit<IEnvelope, "histories" | "recipients" | "certificate" | "document" | "fields" | "profile">;
1044
1032
  type TFieldType = "signature" | "initial" | "checkbox" | "radio" | "textbox" | "timestamp" | "date" | "dropdown" | "textarea" | "attachment" | "payment";
1045
- type TWebhookEvent = "envelope_created" | "envelope_completed" | "envelope_canceled" | "envelope_updated" | "envelope_expired" | "template_created" | "template_updated" | "template_deleted" | "template_used" | "recipient_submitted" | "recipient_updated" | "recipient_delegated" | "kba_event" | "entitlement_used";
1033
+ type TWebhookEvent = "envelope_created" | "envelope_completed" | "envelope_canceled" | "envelope_updated" | "envelope_expired" | "template_created" | "template_updated" | "template_deleted" | "template_used" | "recipient_submitted" | "recipient_updated" | "recipient_delegated" | "kba_event" | "entitlement_used" | "recipient_invited" | "recipient_reminded" | "recipient_auth_fail" | "recipient_disclosure_accepted" | "recipient_docs_downloaded" | "recipient_invite_failed";
1046
1034
  declare const WEBHOOK_EVENTS: readonly [
1047
1035
  "envelope_created",
1048
1036
  "envelope_completed",
@@ -1057,7 +1045,13 @@ declare const WEBHOOK_EVENTS: readonly [
1057
1045
  "recipient_updated",
1058
1046
  "recipient_delegated",
1059
1047
  "kba_event",
1060
- "entitlement_used"
1048
+ "entitlement_used",
1049
+ "recipient_invited",
1050
+ "recipient_reminded",
1051
+ "recipient_auth_fail",
1052
+ "recipient_disclosure_accepted",
1053
+ "recipient_docs_downloaded",
1054
+ "recipient_invite_failed"
1061
1055
  ];
1062
1056
  type TTemplateVisibility = "private" | "shared" | "public";
1063
1057
  type TEntitlement = "envelope" | "kba_auth" | "passcode_auth" | "sms_auth" | "kba_id_auth" | "id_auth" | "custom_disclaimer";
@@ -1612,6 +1606,8 @@ interface ICreateEnvelopeFromTemplateRequest {
1612
1606
  initial_reminder?: number;
1613
1607
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
1614
1608
  followup_reminders?: number;
1609
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
1610
+ max_reminder_days?: number;
1615
1611
  /** List of recipients to configure. */
1616
1612
  recipients: ICreateEnvelopeRecipientFromTemplate[];
1617
1613
  /** Optional metadata to attach to the envelope. This is not used by Verdocs, but may be used for internal tracking purposes by the caller. This is not shown to recipients, but is not private and should not be used to store sensitive data. */
@@ -1640,6 +1636,8 @@ interface ICreateEnvelopeDirectlyRequest {
1640
1636
  initial_reminder: number;
1641
1637
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
1642
1638
  followup_reminders: number;
1639
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
1640
+ max_reminder_days?: number;
1643
1641
  /** Optional metadata to attach to the envelope. This is not used by Verdocs, but may be used for internal tracking purposes by the caller. This is not shown to recipients, but is not private and should not be used to store sensitive data. */
1644
1642
  data?: any;
1645
1643
  /** List of recipients to configure. */
@@ -1734,6 +1732,7 @@ declare const DEFAULT_DISCLOSURES = "\n<ul>\n <li>\n Agree to use electronic
1734
1732
  * @apiBody boolean no_contact? If set to true, no email or SMS messages will be sent to any recipients.
1735
1733
  * @apiBody integer(min: 0) initial_reminder? Override the template initial-reminder setting in ms.
1736
1734
  * @apiBody integer(min: 0) followup_reminders? Override the template initial-reminder setting in ms.
1735
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
1737
1736
  * @apiBody string expires_at? If set, the envelope will automatically expire (be canceled) at this date and time. Expirations must be at least 1 day in the future.
1738
1737
  * @apiSuccess IEnvelope . The newly-created envelope.
1739
1738
  */
@@ -1810,6 +1809,7 @@ declare const getEnvelopeFile: (endpoint: VerdocsEndpoint, documentId: string) =
1810
1809
  * @apiBody string sender_email? New Sender Email for the envelope
1811
1810
  * @apiBody integer(min: 0) initial_reminder? Change the initial-reminder setting (in ms).
1812
1811
  * @apiBody integer(min: 0) followup_reminders? Change the followup-reminder setting (in ms).
1812
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
1813
1813
  * @apiBody string expires_at? If set, the envelope will automatically expire (be canceled) at this date and time. Expirations must be at least 1 day in the future.
1814
1814
  * @apiBody string(enum:'private'|'shared') visibility? Change the envelope's visibility setting
1815
1815
  * @apiBody boolean no_contact? If set to true, no email or SMS messages will be sent to any recipients.
@@ -3674,6 +3674,8 @@ interface ITemplateCreateParams {
3674
3674
  initial_reminder?: number;
3675
3675
  /** Delay (in seconds) before subsequent remidners are sent (min: 12hrs). Set to 0 or null to disable. */
3676
3676
  followup_reminders?: number;
3677
+ /** Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14. */
3678
+ max_reminder_days?: number;
3677
3679
  /** Optional description for the template to help identify it. */
3678
3680
  description?: string;
3679
3681
  /**
@@ -3711,6 +3713,7 @@ interface ITemplateCreateParams {
3711
3713
  * @apiBody TTemplateSender sender? Who may send envelopes using this template
3712
3714
  * @apiBody number initial_reminder? Delay (in seconds) before the first reminder is sent (min: 4hrs). Set to 0 or null to disable.
3713
3715
  * @apiBody number followup_reminders? Delay (in seconds) before the subsequent reminders are sent (min: 12hrs). Set to 0 or null to disable.
3716
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
3714
3717
  * @apiBody array(items:object) documents? Optional list of documents to attach to the template
3715
3718
  * @apiBody array(items:IRole) roles? Optional list of roles to create. Note that if roles are not included in the request, fields will be ignored.
3716
3719
  * @apiBody array(fields:ITemplateField) fields? Optional list of fields to create. Note that if fields that do not match a role will be ignored.
@@ -3785,6 +3788,7 @@ declare const createTemplateFromSharepoint: (endpoint: VerdocsEndpoint, params:
3785
3788
  * @apiBody TTemplateSender sender? Who may send envelopes using this template
3786
3789
  * @apiBody number initial_reminder? Delay in ms before the first reminder is sent (min: 4hrs). Set to 0 or null to disable.
3787
3790
  * @apiBody number followup_reminders? Delay in ms before the subsequent reminders are sent (min: 12hrs). Set to 0 or null to disable.
3791
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
3788
3792
  * @apiSuccess ITemplate . The updated template
3789
3793
  */
3790
3794
  declare const updateTemplate: (endpoint: VerdocsEndpoint, templateId: string, params: Partial<ITemplateCreateParams>) => Promise<ITemplate>;
package/dist/index.js CHANGED
@@ -18,6 +18,12 @@ const WEBHOOK_EVENTS = [
18
18
  'recipient_delegated',
19
19
  'kba_event',
20
20
  'entitlement_used',
21
+ 'recipient_invited',
22
+ 'recipient_reminded',
23
+ 'recipient_auth_fail',
24
+ 'recipient_disclosure_accepted',
25
+ 'recipient_docs_downloaded',
26
+ 'recipient_invite_failed',
21
27
  ];
22
28
 
23
29
  const FIELD_TYPES = [
@@ -1577,6 +1583,7 @@ class VerdocsEndpoint {
1577
1583
  * @apiBody boolean no_contact? If set to true, no email or SMS messages will be sent to any recipients.
1578
1584
  * @apiBody integer(min: 0) initial_reminder? Override the template initial-reminder setting in ms.
1579
1585
  * @apiBody integer(min: 0) followup_reminders? Override the template initial-reminder setting in ms.
1586
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
1580
1587
  * @apiBody string expires_at? If set, the envelope will automatically expire (be canceled) at this date and time. Expirations must be at least 1 day in the future.
1581
1588
  * @apiSuccess IEnvelope . The newly-created envelope.
1582
1589
  */
@@ -1676,6 +1683,7 @@ const getEnvelopeFile = async (endpoint, documentId) => endpoint.api //
1676
1683
  * @apiBody string sender_email? New Sender Email for the envelope
1677
1684
  * @apiBody integer(min: 0) initial_reminder? Change the initial-reminder setting (in ms).
1678
1685
  * @apiBody integer(min: 0) followup_reminders? Change the followup-reminder setting (in ms).
1686
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
1679
1687
  * @apiBody string expires_at? If set, the envelope will automatically expire (be canceled) at this date and time. Expirations must be at least 1 day in the future.
1680
1688
  * @apiBody string(enum:'private'|'shared') visibility? Change the envelope's visibility setting
1681
1689
  * @apiBody boolean no_contact? If set to true, no email or SMS messages will be sent to any recipients.
@@ -2352,6 +2360,7 @@ const ALLOWED_CREATE_FIELDS = [
2352
2360
  * @apiBody TTemplateSender sender? Who may send envelopes using this template
2353
2361
  * @apiBody number initial_reminder? Delay (in seconds) before the first reminder is sent (min: 4hrs). Set to 0 or null to disable.
2354
2362
  * @apiBody number followup_reminders? Delay (in seconds) before the subsequent reminders are sent (min: 12hrs). Set to 0 or null to disable.
2363
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
2355
2364
  * @apiBody array(items:object) documents? Optional list of documents to attach to the template
2356
2365
  * @apiBody array(items:IRole) roles? Optional list of roles to create. Note that if roles are not included in the request, fields will be ignored.
2357
2366
  * @apiBody array(fields:ITemplateField) fields? Optional list of fields to create. Note that if fields that do not match a role will be ignored.
@@ -2443,6 +2452,7 @@ const createTemplateFromSharepoint = (endpoint, params) => {
2443
2452
  * @apiBody TTemplateSender sender? Who may send envelopes using this template
2444
2453
  * @apiBody number initial_reminder? Delay in ms before the first reminder is sent (min: 4hrs). Set to 0 or null to disable.
2445
2454
  * @apiBody number followup_reminders? Delay in ms before the subsequent reminders are sent (min: 12hrs). Set to 0 or null to disable.
2455
+ * @apiBody number max_reminder_days? Maximum number of days (after envelope creation) for which reminders will be sent. Defaults to 14.
2446
2456
  * @apiSuccess ITemplate . The updated template
2447
2457
  */
2448
2458
  const updateTemplate = (endpoint, templateId, params) => endpoint.api //