@verdocs/js-sdk 2.0.2 → 2.0.5

package/Documents/Documents.d.ts

@@ -1,6 +1,7 @@
 import { ISigningSession, ISigningSessionRequest } 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';
@@ -106,6 +107,7 @@ export interface IDocument {
     certificate?: IDocumentAsset | null;
     document?: IDocumentAsset | null;
     fields?: IDocumentField[];
+    profile?: IProfile;
 }
 export interface IActivityEntry {
     id: string;

package/Users/Profiles.d.ts

@@ -1,4 +1,5 @@
-import { ICreateProfileRequest, IUpdateProfileRequest } from './Types';
+import { ICreateProfileRequest, IPermission, IProfile, IRole, ISwitchProfileResponse, IUpdateProfileRequest } from './Types';
+import { IGroup } from '../Organizations/Types';
 import { VerdocsEndpoint } from '../VerdocsEndpoint';
 /**
  * Get the user's available profiles. The current profile will be marked with `current: true`.
@@ -9,7 +10,17 @@ import { VerdocsEndpoint } from '../VerdocsEndpoint';
  * const profiles = await Profiles.getProfiles()
  * ```
  */
-export declare const getProfiles: (endpoint: VerdocsEndpoint) => Promise<any>;
+export declare const getProfiles: (endpoint: VerdocsEndpoint) => Promise<IProfile[]>;
+/**
+ * Get the user's available profiles. The current profile will be marked with `current: true`.
+ *
+ * ```typescript
+ * import {Profiles} from '@verdocs/js-sdk/Users';
+ *
+ * const profiles = await Profiles.getCurrentProfile()
+ * ```
+ */
+export declare const getCurrentProfile: (endpoint: VerdocsEndpoint) => Promise<IProfile | undefined>;
 /**
  * Get a list of system roles.
  *
@@ -19,7 +30,7 @@ export declare const getProfiles: (endpoint: VerdocsEndpoint) => Promise<any>;
  * const roles = await Profiles.getRoles();
  * ```
  */
-export declare const getRoles: (endpoint: VerdocsEndpoint) => Promise<any>;
+export declare const getRoles: (endpoint: VerdocsEndpoint) => Promise<IRole[]>;
 /**
  * Get a list of system roles.
  *
@@ -39,7 +50,7 @@ export declare const getPermissions: (endpoint: VerdocsEndpoint) => Promise<any>
  * const newProfile = await Profiles.createProfile({ first_name: 'FIRST', last_name: 'LAST', email: 'EMAIL' });
  * ```
  */
-export declare const createProfile: (endpoint: VerdocsEndpoint, params: ICreateProfileRequest) => Promise<any>;
+export declare const createProfile: (endpoint: VerdocsEndpoint, params: ICreateProfileRequest) => Promise<IProfile>;
 /**
  * Get a profile. The caller must have admin access to the given profile.
  * TODO: Add a "public" profile endpoint for public pages
@@ -50,7 +61,7 @@ export declare const createProfile: (endpoint: VerdocsEndpoint, params: ICreateP
  * const profile = await Profiles.getProfile('PROFILEID');
  * ```
  */
-export declare const getProfile: (endpoint: VerdocsEndpoint, profileId: string) => Promise<any>;
+export declare const getProfile: (endpoint: VerdocsEndpoint, profileId: string) => Promise<IProfile>;
 /**
  * Get a profile's permissions. The caller must have admin access to the given profile.
  *
@@ -60,7 +71,7 @@ export declare const getProfile: (endpoint: VerdocsEndpoint, profileId: string)
  * const permissions = await Profiles.getProfilePermissions('PROFILEID');
  * ```
  */
-export declare const getProfilePermissions: (endpoint: VerdocsEndpoint, profileId: string) => Promise<any>;
+export declare const getProfilePermissions: (endpoint: VerdocsEndpoint, profileId: string) => Promise<IPermission[]>;
 /**
  * Get a profile's groups.
  *
@@ -70,7 +81,7 @@ export declare const getProfilePermissions: (endpoint: VerdocsEndpoint, profileI
  * const groups = await Profiles.getProfileGroups('PROFILEID');
  * ```
  */
-export declare const getProfileGroups: (endpoint: VerdocsEndpoint, profileId: string) => Promise<any>;
+export declare const getProfileGroups: (endpoint: VerdocsEndpoint, profileId: string) => Promise<IGroup[]>;
 /**
  * Switch the caller's "current" profile. The current profile is used for permissions checking and profile_id field settings
  * for most operations in Verdocs. It is important to select the appropropriate profile before calling other API functions.
@@ -81,7 +92,7 @@ export declare const getProfileGroups: (endpoint: VerdocsEndpoint, profileId: st
  * const newProfile = await Profiles.switchProfile('PROFILEID');
  * ```
  */
-export declare const switchProfile: (endpoint: VerdocsEndpoint, profileId: string) => Promise<any>;
+export declare const switchProfile: (endpoint: VerdocsEndpoint, profileId: string) => Promise<ISwitchProfileResponse>;
 /**
  * Update a profile. For future expansion, the profile ID to update is required, but currently this must also be the
  * "current" profile for the caller.
@@ -92,7 +103,7 @@ export declare const switchProfile: (endpoint: VerdocsEndpoint, profileId: strin
  * const newProfile = await Profiles.updateProfile('PROFILEID');
  * ```
  */
-export declare const updateProfile: (endpoint: VerdocsEndpoint, profileId: string, params: IUpdateProfileRequest) => Promise<any>;
+export declare const updateProfile: (endpoint: VerdocsEndpoint, profileId: string, params: IUpdateProfileRequest) => Promise<IProfile>;
 /**
  * Delete a profile. If the requested profile is the caller's curent profile, the next available profile will be selected.
  *

package/Users/Profiles.js

@@ -12,6 +12,20 @@ export var getProfiles = function (endpoint) {
         .get('/profiles')
         .then(function (r) { return r.data; });
 };
+/**
+ * Get the user's available profiles. The current profile will be marked with `current: true`.
+ *
+ * ```typescript
+ * import {Profiles} from '@verdocs/js-sdk/Users';
+ *
+ * const profiles = await Profiles.getCurrentProfile()
+ * ```
+ */
+export var getCurrentProfile = function (endpoint) {
+    return endpoint.api //
+        .get('/profiles')
+        .then(function (r) { return (r.data || []).find(function (profile) { return profile.current; }); });
+};
 /**
  * Get a list of system roles.
  *

package/Users/Types.d.ts

@@ -30,7 +30,7 @@ export interface IProfile {
     /** If true, this is the caller's "currently selected" profile. All operations will performed "as" this profile. */
     current: boolean;
     /** The organization */
-    organization: IOrganization;
+    organization?: IOrganization;
     /** The permissions assigned to the profilel _NOTE: Only present in the "current" profile._ */
     permissions?: TPermission[];
     /** The roles assigned to the profilel _NOTE: Only present in the "current" profile._ */

package/VerdocsEndpoint.d.ts

@@ -5,7 +5,7 @@ import * as Documents from './Documents';
 export declare type TEnvironment = 'verdocs' | 'verdocs-stage';
 export declare type TSessionType = 'user' | 'signing';
 export declare type TSession = IActiveSession | ISigningSession | null;
-export declare type TSessionChangedListener = (endpoint: VerdocsEndpoint, session: IActiveSession | ISigningSession | null) => void;
+export declare type TSessionChangedListener = (endpoint: VerdocsEndpoint, session: TSession) => void;
 export interface VerdocsEndpointOptions {
     baseURL?: string;
     timeout?: number;
@@ -62,7 +62,7 @@ export declare class VerdocsEndpoint {
      */
     constructor(options?: VerdocsEndpointOptions);
     setDefault(): void;
-    static getDefault(): any;
+    static getDefault(): VerdocsEndpoint;
     /**
      * Get the current environment.
      */
@@ -175,6 +175,11 @@ export declare class VerdocsEndpoint {
      * ```
      */
     setToken(token: string | null): VerdocsEndpoint;
+    /**
+     * Retrieves the current session token, if any. Tokens should rarely be used for direct actions, but this is
+     * required by the `<VerdocsView>` and other components to authorize requests to raw PDF files.
+     */
+    getToken(): string | null;
     private sessionStorageKey;
     /**
      * Clear the active session.

package/VerdocsEndpoint.js

@@ -230,6 +230,13 @@ var VerdocsEndpoint = /** @class */ (function () {
         this.notifySessionListeners();
         return this;
     };
+    /**
+     * Retrieves the current session token, if any. Tokens should rarely be used for direct actions, but this is
+     * required by the `<VerdocsView>` and other components to authorize requests to raw PDF files.
+     */
+    VerdocsEndpoint.prototype.getToken = function () {
+        return this.token;
+    };
     VerdocsEndpoint.prototype.sessionStorageKey = function () {
         return "verdocs-session-".concat(this.getSessionType(), "-").concat(this.getEnvironment());
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verdocs/js-sdk",
-  "version": "2.0.2",
+  "version": "2.0.5",
   "private": false,
   "homepage": "https://github.com/Verdocs/js-sdk",
   "description": "Verdocs JS SDK",
@@ -39,7 +39,7 @@
     "docs": "npm run docs-md && npm run docs-html",
     "clear-docs": "aws --profile=verdocs cloudfront create-invalidation --distribution-id E29UFGU4KEH1GQ --paths \"/*\"",
     "deploy-docs": "npm run docs && aws --profile=verdocs s3 sync --acl public-read --delete docs-html s3://verdocs-developers-js-sdk/ && yarn clear-docs",
-    "clean": "rm -rf Documents HTTP Organizations Search Templates Users Utils index.js index.d.ts docs docs-html"
+    "clean": "rm -rf Documents HTTP Organizations Search Templates Users Utils index.js index.d.ts VerdocsEndpoint.* docs docs-html"
   },
   "publishConfig": {
     "access": "public"