@verdocs/js-sdk 6.6.0 → 6.6.2

package/dist/index.d.mts

@@ -433,10 +433,11 @@ interface IWebhook {
     id: string;
     organization_id: string;
     url: string;
-    secret_key?: string;
-    client_id?: string;
-    client_secret?: string;
-    token_endpoint?: string;
+    secret_key?: string | null;
+    client_id?: string | null;
+    client_secret?: string | null;
+    scope?: string | null;
+    token_endpoint?: string | null;
     auth_method: TWebhookAuthMethod;
     active: boolean;
     events: IWebhookEvents;
@@ -754,6 +755,7 @@ interface IRecipient {
     message: string | null;
     claimed: boolean;
     agreed: boolean;
+    name_locked: boolean;
     key_used_to_conclude?: string;
     environment?: string;
     created_at: string;
@@ -817,7 +819,10 @@ interface IRole {
      * arrange recipients to match related business processes so this field allows for that.
      */
     order: number;
+    // TODO: Most booleans should probably become non-nullable
     delegator: boolean | null;
+    /** If set, the recipient will not be allowed to change their legal name. */
+    name_locked: boolean;
 }
 interface ISignature {
     id: string;
@@ -1479,6 +1484,8 @@ interface IUpdateRecipientParams {
     dob?: string;
     /** If KBA-based authentication is used, the recipient's SSN-Last-4 to prefill. May only be changed if the recipient has not already completed KBA-based auth. */
     ssn_last_4?: string;
+    /** If set, the recipient will not be allowed to change their legal name. */
+    name_locked?: string;
 }
 interface ICreateEnvelopeDocumentFromData {
     /** The order in which the document should be displayed. */
@@ -1664,6 +1671,9 @@ type TAuthenticateRecipientRequest = IAuthenticateRecipientViaPasscodeRequest |
  * be applied at the Organization level before creating an envelope.
  */
 declare const DEFAULT_DISCLOSURES = "\n<ul>\n  <li>\n    Agree to use electronic records and signatures, and confirm you have read the\n    <a href=\"https://verdocs.com/en/electronic-record-signature-disclosure/\" target=\"_blank\">\n      Electronic Record and Signatures Disclosure</a>.</li>\n  <li>\n    Agree to Verdocs'\n    <a href=\"https://verdocs.com/en/eula\" target=\"_blank\">\n      End User License Agreement</a>\n    and confirm you have read Verdocs'\n    <a href=\"https://verdocs.com/en/privacy-policy/\" target=\"_blank\">\n      Privacy Policy</a>.\n  </li>\n</ul>";
+// TODO: We need to re-review all of the models and input types/docs to be sure they match the latest
+//  API work.
+// INIT
 /**
  * Create an envelope
  *
@@ -2308,6 +2318,11 @@ interface IAcceptOrganizationInvitationRequest {
 interface ISetWebhookRequest {
     url: string;
     active: boolean;
+    client_id?: string | null;
+    client_secret?: string | null;
+    scope?: string | null;
+    token_endpoint?: string | null;
+    auth_method: TWebhookAuthMethod;
     events: Record<TWebhookEvent, boolean>;
 }
 /**
@@ -2963,12 +2978,13 @@ declare const getOrganizationMembers: (endpoint: VerdocsEndpoint) => Promise<IPr
  * ```
  *
  * @group Organization Members
+ * @apiParam string(format:uuid) profile_id The Profile ID to remove.
  * @api DELETE /v2/organization-members/:profile_id Delete a member from the organization
  * @apiSuccess string . Success
  */
 declare const deleteOrganizationMember: (endpoint: VerdocsEndpoint, profileId: string) => Promise<any>;
 /**
- * Update a member.
+ * Update an organization member.
  *
  * ```typescript
  * import {updateOrganizationMember} from '@verdocs/js-sdk';
@@ -2978,12 +2994,13 @@ declare const deleteOrganizationMember: (endpoint: VerdocsEndpoint, profileId: s
  *
  * @group Organization Members
  * @api PATCH /v2/organization-members/:profile_id Update an organization member.
- * @apiBody array(items:TRole) roles URL to send Webhook events to. An empty or invalid URL will disable Webhook calls.
- * @apiBody string first_name Set to true to enable Webhooks calls.
- * @apiBody string last_name Record<TWebhookEvent, boolean> map of events to enable/disable.
- * @apiSuccess array(items:IProfile) . List of caller's current organization's members
+ * @apiParam string(format:uuid) profile_id The Profile ID to update.
+ * @apiBody string first_name? First name for the member
+ * @apiBody string last_name? Last name for the member
+ * @apiBody array(items:TRole) roles? Roles (e.g. "member" or "admin") to assign to the user.
+ * @apiSuccess IProfile . The updated profile for the member.
  */
-declare const updateOrganizationMember: (endpoint: VerdocsEndpoint, profileId: string, params: Pick<IProfile, "roles" | "first_name" | "last_name">) => Promise<any>;
+declare const updateOrganizationMember: (endpoint: VerdocsEndpoint, profileId: string, params: Partial<Pick<IProfile, "roles" | "first_name" | "last_name">>) => Promise<IProfile>;
 /**
  * Get an organization by ID. Note that this endpoint will return only a subset of fields
  * if the caller is not a member of the organization (the public fields).
@@ -3158,7 +3175,8 @@ declare const getEntitlements: (endpoint: VerdocsEndpoint) => Promise<IEntitleme
  */
 declare const getActiveEntitlements: (endpoint: VerdocsEndpoint) => Promise<Partial<Record<TEntitlement, IEntitlement>>>;
 /**
- * Get the registered Webhook configuration for the caller's organization.
+ * Get the registered Webhook configuration for the caller's organization. Note that an organization
+ * may only have a single Webhook configuration.
  *
  * ```typescript
  * import {getWebhooks} from '@verdocs/js-sdk';
@@ -3187,6 +3205,11 @@ declare const getWebhooks: (endpoint: VerdocsEndpoint) => Promise<IWebhook>;
  * @apiDescription Note that Webhooks cannot currently be deleted, but may be easily disabled by setting `active` to `false` and/or setting the `url` to an empty string.
  * @apiBody string url URL to send Webhook events to. An empty or invalid URL will disable Webhook calls.
  * @apiBody boolean active Set to true to enable Webhooks calls.
+ * @apiBody string(enum:'none'|'hmac'|'client_credentials') auth_method? Enable HMAC or Client Credentials authentication for Webhooks calls.
+ * @apiBody string token_endpoint? Required if `auth_method` is set to `client_credentials`. Token endpoint to use for authenticating Webhooks calls.
+ * @apiBody string client_id? Required if `auth_method` is set to `client_credentials`. Client ID to use for authenticating Webhooks calls.
+ * @apiBody string client_secret? Required if `auth_method` is set to `client_credentials`. Client secret to use for authenticating Webhooks calls.
+ * @apiBody string scope? Optional scope to include in authentication calls if `auth_method` is set to `client_credentials`.
  * @apiBody object events Record<TWebhookEvent, boolean> map of events to enable/disable.
  * @apiSuccess IWebhook . The updated Webhooks config for the caller's organization.
  */

package/dist/index.d.ts

@@ -433,10 +433,11 @@ interface IWebhook {
     id: string;
     organization_id: string;
     url: string;
-    secret_key?: string;
-    client_id?: string;
-    client_secret?: string;
-    token_endpoint?: string;
+    secret_key?: string | null;
+    client_id?: string | null;
+    client_secret?: string | null;
+    scope?: string | null;
+    token_endpoint?: string | null;
     auth_method: TWebhookAuthMethod;
     active: boolean;
     events: IWebhookEvents;
@@ -754,6 +755,7 @@ interface IRecipient {
     message: string | null;
     claimed: boolean;
     agreed: boolean;
+    name_locked: boolean;
     key_used_to_conclude?: string;
     environment?: string;
     created_at: string;
@@ -817,7 +819,10 @@ interface IRole {
      * arrange recipients to match related business processes so this field allows for that.
      */
     order: number;
+    // TODO: Most booleans should probably become non-nullable
     delegator: boolean | null;
+    /** If set, the recipient will not be allowed to change their legal name. */
+    name_locked: boolean;
 }
 interface ISignature {
     id: string;
@@ -1479,6 +1484,8 @@ interface IUpdateRecipientParams {
     dob?: string;
     /** If KBA-based authentication is used, the recipient's SSN-Last-4 to prefill. May only be changed if the recipient has not already completed KBA-based auth. */
     ssn_last_4?: string;
+    /** If set, the recipient will not be allowed to change their legal name. */
+    name_locked?: string;
 }
 interface ICreateEnvelopeDocumentFromData {
     /** The order in which the document should be displayed. */
@@ -1664,6 +1671,9 @@ type TAuthenticateRecipientRequest = IAuthenticateRecipientViaPasscodeRequest |
  * be applied at the Organization level before creating an envelope.
  */
 declare const DEFAULT_DISCLOSURES = "\n<ul>\n  <li>\n    Agree to use electronic records and signatures, and confirm you have read the\n    <a href=\"https://verdocs.com/en/electronic-record-signature-disclosure/\" target=\"_blank\">\n      Electronic Record and Signatures Disclosure</a>.</li>\n  <li>\n    Agree to Verdocs'\n    <a href=\"https://verdocs.com/en/eula\" target=\"_blank\">\n      End User License Agreement</a>\n    and confirm you have read Verdocs'\n    <a href=\"https://verdocs.com/en/privacy-policy/\" target=\"_blank\">\n      Privacy Policy</a>.\n  </li>\n</ul>";
+// TODO: We need to re-review all of the models and input types/docs to be sure they match the latest
+//  API work.
+// INIT
 /**
  * Create an envelope
  *
@@ -2308,6 +2318,11 @@ interface IAcceptOrganizationInvitationRequest {
 interface ISetWebhookRequest {
     url: string;
     active: boolean;
+    client_id?: string | null;
+    client_secret?: string | null;
+    scope?: string | null;
+    token_endpoint?: string | null;
+    auth_method: TWebhookAuthMethod;
     events: Record<TWebhookEvent, boolean>;
 }
 /**
@@ -2963,12 +2978,13 @@ declare const getOrganizationMembers: (endpoint: VerdocsEndpoint) => Promise<IPr
  * ```
  *
  * @group Organization Members
+ * @apiParam string(format:uuid) profile_id The Profile ID to remove.
  * @api DELETE /v2/organization-members/:profile_id Delete a member from the organization
  * @apiSuccess string . Success
  */
 declare const deleteOrganizationMember: (endpoint: VerdocsEndpoint, profileId: string) => Promise<any>;
 /**
- * Update a member.
+ * Update an organization member.
  *
  * ```typescript
  * import {updateOrganizationMember} from '@verdocs/js-sdk';
@@ -2978,12 +2994,13 @@ declare const deleteOrganizationMember: (endpoint: VerdocsEndpoint, profileId: s
  *
  * @group Organization Members
  * @api PATCH /v2/organization-members/:profile_id Update an organization member.
- * @apiBody array(items:TRole) roles URL to send Webhook events to. An empty or invalid URL will disable Webhook calls.
- * @apiBody string first_name Set to true to enable Webhooks calls.
- * @apiBody string last_name Record<TWebhookEvent, boolean> map of events to enable/disable.
- * @apiSuccess array(items:IProfile) . List of caller's current organization's members
+ * @apiParam string(format:uuid) profile_id The Profile ID to update.
+ * @apiBody string first_name? First name for the member
+ * @apiBody string last_name? Last name for the member
+ * @apiBody array(items:TRole) roles? Roles (e.g. "member" or "admin") to assign to the user.
+ * @apiSuccess IProfile . The updated profile for the member.
  */
-declare const updateOrganizationMember: (endpoint: VerdocsEndpoint, profileId: string, params: Pick<IProfile, "roles" | "first_name" | "last_name">) => Promise<any>;
+declare const updateOrganizationMember: (endpoint: VerdocsEndpoint, profileId: string, params: Partial<Pick<IProfile, "roles" | "first_name" | "last_name">>) => Promise<IProfile>;
 /**
  * Get an organization by ID. Note that this endpoint will return only a subset of fields
  * if the caller is not a member of the organization (the public fields).
@@ -3158,7 +3175,8 @@ declare const getEntitlements: (endpoint: VerdocsEndpoint) => Promise<IEntitleme
  */
 declare const getActiveEntitlements: (endpoint: VerdocsEndpoint) => Promise<Partial<Record<TEntitlement, IEntitlement>>>;
 /**
- * Get the registered Webhook configuration for the caller's organization.
+ * Get the registered Webhook configuration for the caller's organization. Note that an organization
+ * may only have a single Webhook configuration.
  *
  * ```typescript
  * import {getWebhooks} from '@verdocs/js-sdk';
@@ -3187,6 +3205,11 @@ declare const getWebhooks: (endpoint: VerdocsEndpoint) => Promise<IWebhook>;
  * @apiDescription Note that Webhooks cannot currently be deleted, but may be easily disabled by setting `active` to `false` and/or setting the `url` to an empty string.
  * @apiBody string url URL to send Webhook events to. An empty or invalid URL will disable Webhook calls.
  * @apiBody boolean active Set to true to enable Webhooks calls.
+ * @apiBody string(enum:'none'|'hmac'|'client_credentials') auth_method? Enable HMAC or Client Credentials authentication for Webhooks calls.
+ * @apiBody string token_endpoint? Required if `auth_method` is set to `client_credentials`. Token endpoint to use for authenticating Webhooks calls.
+ * @apiBody string client_id? Required if `auth_method` is set to `client_credentials`. Client ID to use for authenticating Webhooks calls.
+ * @apiBody string client_secret? Required if `auth_method` is set to `client_credentials`. Client secret to use for authenticating Webhooks calls.
+ * @apiBody string scope? Optional scope to include in authentication calls if `auth_method` is set to `client_credentials`.
  * @apiBody object events Record<TWebhookEvent, boolean> map of events to enable/disable.
  * @apiSuccess IWebhook . The updated Webhooks config for the caller's organization.
  */

package/dist/index.js

@@ -1529,6 +1529,9 @@ class VerdocsEndpoint {
     }
 }
 
+// TODO: We need to re-review all of the models and input types/docs to be sure they match the latest
+//  API work.
+// INIT
 /**
  * Create an envelope
  *
@@ -3446,6 +3449,7 @@ const getOrganizationMembers = (endpoint) => endpoint.api //
  * ```
  *
  * @group Organization Members
+ * @apiParam string(format:uuid) profile_id The Profile ID to remove.
  * @api DELETE /v2/organization-members/:profile_id Delete a member from the organization
  * @apiSuccess string . Success
  */
@@ -3453,7 +3457,7 @@ const deleteOrganizationMember = (endpoint, profileId) => endpoint.api //
     .delete(`/v2/organization-members/${profileId}`)
     .then((r) => r.data);
 /**
- * Update a member.
+ * Update an organization member.
  *
  * ```typescript
  * import {updateOrganizationMember} from '@verdocs/js-sdk';
@@ -3463,10 +3467,11 @@ const deleteOrganizationMember = (endpoint, profileId) => endpoint.api //
  *
  * @group Organization Members
  * @api PATCH /v2/organization-members/:profile_id Update an organization member.
- * @apiBody array(items:TRole) roles URL to send Webhook events to. An empty or invalid URL will disable Webhook calls.
- * @apiBody string first_name Set to true to enable Webhooks calls.
- * @apiBody string last_name Record<TWebhookEvent, boolean> map of events to enable/disable.
- * @apiSuccess array(items:IProfile) . List of caller's current organization's members
+ * @apiParam string(format:uuid) profile_id The Profile ID to update.
+ * @apiBody string first_name? First name for the member
+ * @apiBody string last_name? Last name for the member
+ * @apiBody array(items:TRole) roles? Roles (e.g. "member" or "admin") to assign to the user.
+ * @apiSuccess IProfile . The updated profile for the member.
  */
 const updateOrganizationMember = (endpoint, profileId, params) => endpoint.api //
     .patch(`/v2/organization-members/${profileId}`, params)
@@ -3701,7 +3706,8 @@ const getActiveEntitlements = async (endpoint) => {
  * @module
  */
 /**
- * Get the registered Webhook configuration for the caller's organization.
+ * Get the registered Webhook configuration for the caller's organization. Note that an organization
+ * may only have a single Webhook configuration.
  *
  * ```typescript
  * import {getWebhooks} from '@verdocs/js-sdk';
@@ -3732,6 +3738,11 @@ const getWebhooks = (endpoint) => endpoint.api //
  * @apiDescription Note that Webhooks cannot currently be deleted, but may be easily disabled by setting `active` to `false` and/or setting the `url` to an empty string.
  * @apiBody string url URL to send Webhook events to. An empty or invalid URL will disable Webhook calls.
  * @apiBody boolean active Set to true to enable Webhooks calls.
+ * @apiBody string(enum:'none'|'hmac'|'client_credentials') auth_method? Enable HMAC or Client Credentials authentication for Webhooks calls.
+ * @apiBody string token_endpoint? Required if `auth_method` is set to `client_credentials`. Token endpoint to use for authenticating Webhooks calls.
+ * @apiBody string client_id? Required if `auth_method` is set to `client_credentials`. Client ID to use for authenticating Webhooks calls.
+ * @apiBody string client_secret? Required if `auth_method` is set to `client_credentials`. Client secret to use for authenticating Webhooks calls.
+ * @apiBody string scope? Optional scope to include in authentication calls if `auth_method` is set to `client_credentials`.
  * @apiBody object events Record<TWebhookEvent, boolean> map of events to enable/disable.
  * @apiSuccess IWebhook . The updated Webhooks config for the caller's organization.
  */