@verdocs/web-sdk 1.0.25 → 1.1.0

package/dist/types/components/elements/verdocs-field-textarea/verdocs-field-textarea.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+/**
+ * Display a multi-line text input field.
+ */
+export declare class VerdocsFieldTextarea {
+  private el;
+  /**
+   * A placeholder to assist the user in completing the field.
+   */
+  placeholder: string;
+  /**
+   * Sets the tabIndex of the input element.
+   */
+  order: number;
+  /**
+   * Sets the value of the input element.
+   */
+  value: string;
+  /**
+   * If true, the field will be marked required.
+   */
+  required: boolean;
+  /**
+   * Sets the disabled attribute of the input element.
+   */
+  disabled: boolean;
+  /**
+   * Event fired when the input field loses focus.
+   */
+  fieldFocus: EventEmitter<boolean>;
+  /**
+   * Event fired when the input field gains focus.
+   */
+  fieldBlur: EventEmitter<boolean>;
+  /**
+   * Event fired when the input field value changes. Note that this will only be fired on blur, tab-out, ENTER key press, etc.
+   * It is generally the best event to subscribe to than `input` for most cases EXCEPT autocomplete fields that need to see every
+   * keypress.
+   */
+  fieldChange: EventEmitter<string>;
+  /**
+   * Event fired on every character entered into / deleted from the field.
+   */
+  fieldInput: EventEmitter<string>;
+  focused: boolean;
+  focusField(): Promise<void>;
+  handleBlur(): void;
+  handleFocus(): void;
+  handleChange(e: any): void;
+  handleInput(e: any): void;
+  render(): any;
+}

package/dist/types/components/elements/verdocs-field-textarea/verdocs-field-textarea.stories.d.ts

@@ -0,0 +1,10 @@
+import { Meta } from '@storybook/web-components';
+declare const _default: Meta<import("@storybook/web-components").Args>;
+export default _default;
+export declare const Textarea: ({ placeholder, order, value, required, disabled }: {
+  placeholder: any;
+  order: any;
+  value: any;
+  required: any;
+  disabled: any;
+}) => import("lit-html").TemplateResult<1>;

package/dist/types/components/elements/verdocs-field-textbox/verdocs-field-textbox.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+/**
+ * Display a text input field.
+ */
+export declare class VerdocsFieldTextbox {
+  private el;
+  /**
+   * A placeholder to assist the user in completing the field.
+   */
+  placeholder: string;
+  /**
+   * Sets the tabIndex of the input element.
+   */
+  order: number;
+  /**
+   * Sets the value of the input element.
+   */
+  value: string;
+  /**
+   * If true, the field will be marked required.
+   */
+  required: boolean;
+  /**
+   * Sets the disabled attribute of the input element.
+   */
+  disabled: boolean;
+  /**
+   * Event fired when the input field loses focus.
+   */
+  fieldFocus: EventEmitter<boolean>;
+  /**
+   * Event fired when the input field gains focus.
+   */
+  fieldBlur: EventEmitter<boolean>;
+  /**
+   * Event fired when the input field value changes. Note that this will only be fired on blur, tab-out, ENTER key press, etc.
+   * It is generally the best event to subscribe to than `input` for most cases EXCEPT autocomplete fields that need to see every
+   * keypress.
+   */
+  fieldChange: EventEmitter<string>;
+  /**
+   * Event fired on every character entered into / deleted from the field.
+   */
+  fieldInput: EventEmitter<string>;
+  focused: boolean;
+  focusField(): Promise<void>;
+  handleBlur(): void;
+  handleFocus(): void;
+  handleChange(e: any): void;
+  handleInput(e: any): void;
+  render(): any;
+}

package/dist/types/components/elements/{org-popup/org-popup.stories.d.ts → verdocs-field-textbox/verdocs-field-textbox.stories.d.ts}

@@ -1,8 +1,10 @@
 import { Meta } from '@storybook/web-components';
 declare const _default: Meta<import("@storybook/web-components").Args>;
 export default _default;
-export declare const Default: ({ organization, theme }: {
-  organization: any;
-  theme: any;
+export declare const Textbox: ({ placeholder, order, value, required, disabled }: {
+  placeholder: any;
+  order: any;
+  value: any;
+  required: any;
+  disabled: any;
 }) => import("lit-html").TemplateResult<1>;
-export declare const Test: () => import("lit-html").TemplateResult<1>;

package/dist/types/components/embeds/verdocs-auth/verdocs-auth.d.ts

@@ -0,0 +1,69 @@
+import { IActiveSession } from '@verdocs/js-sdk/Users/Types';
+import { EventEmitter } from '../../../stencil-public-runtime';
+export interface IAuthStatus {
+  authenticated: boolean;
+  session: any | null;
+}
+/**
+ * Display an authentication dialog that allows the user to login or sign up. Callbacks are provided for events that
+ * occur during the process (especially successful completion). The success callback will be fired immediately if the
+ * user is already authenticated with a valid session, so this component may not always display visibly. To simplify
+ * some types of authentication flows, a visibility flag can force this component to never display.
+ *
+ * This embed is responsive / mobile-friendly, but the calling application should provide at least a 300px wide
+ * container to allow sufficient space for the required forms.
+ *
+ * As noted below, the primary event is `authenticated`. This will always be fired at least once, immediately after
+ * the widget is rendered and the user's status has been checked. It may be fired again as the user completes (or
+ * cancels) authentication steps.
+ *
+ * Authentication is required to demonstrate this Element. You may do this in Storybook by using the Auth
+ * embed. This Element will reuse the same session produced by logging in via that Embed.
+ *
+ * ```typescript
+ * interface IAuthStatus {
+ *   // If true, the user is authenticated with a valid session
+ *   authenticated: boolean;
+ *
+ *   // Details for the user's session
+ *   session: IActiveSession | null;
+ * }
+ * ```
+ */
+export declare class VerdocsAuth {
+  /**
+   * Normally, if the user has a valid session, this embed will be invisible, otherwise it will display
+   * login / signup forms. If this is set to false, this embed will be invisible in both cases. Apps may
+   * use this to verify if a user has a valid session without needing a separate call to Verdocs JS SDK.
+   */
+  visible: boolean;
+  /**
+   * By default, a Verdocs logo will be displayed above the login/signup forms. This may be used to
+   * override its source. (Alternatively, you may simply hide it via CSS overrides.) Logos should be
+   * in SVG format for best results.
+   */
+  logo: string;
+  /**
+   * If the user is authenticated, this embed will normally render invisibly. If debug is set true, a summary
+   * if the user's session details will be displayed instead. This may be useful while debugging authentication
+   * flows in new applications.
+   */
+  debug: boolean;
+  /**
+   * Event fired when session authentication process has completed. Check the event contents for completion status.
+   */
+  authenticated: EventEmitter<IAuthStatus>;
+  isAuthenticated: boolean;
+  displayMode: string;
+  username: string;
+  password: string;
+  loggingIn: boolean;
+  activeSession: IActiveSession | null;
+  loginError: string | null;
+  componentWillLoad(): void;
+  componentDidLoad(): void;
+  handleLogin(): void;
+  handleLogout(): void;
+  handleClearError(): void;
+  render(): any;
+}

package/dist/types/components/embeds/verdocs-auth/verdocs-auth.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta } from '@storybook/web-components';
+declare const _default: Meta<import("@storybook/web-components").Args>;
+export default _default;
+export declare const Auth: ({ visible, logo, debug, authenticated }: {
+  visible: any;
+  logo: any;
+  debug: any;
+  authenticated: any;
+}) => import("lit-html").TemplateResult<1>;

package/dist/types/components/embeds/verdocs-search/verdocs-search.d.ts

@@ -0,0 +1,3 @@
+export declare class VerdocsSearch {
+  render(): any;
+}

package/dist/types/components/embeds/{search-embed/search-embed.stories.d.ts → verdocs-search/verdocs-search.stories.d.ts}

@@ -1,6 +1,6 @@
 import { Meta } from '@storybook/web-components';
 declare const _default: Meta<import("@storybook/web-components").Args>;
 export default _default;
-export declare const Default: ({ options }: {
+export declare const Search: ({ options }: {
   options: any;
 }) => import("lit-html").TemplateResult<1>;

package/dist/types/components/embeds/verdocs-sign/verdocs-sign.d.ts

@@ -0,0 +1,46 @@
+import { IDocument, IDocumentField } from '@verdocs/js-sdk/Documents/Documents';
+import { IPDFPageInfo, IPDFRenderEvent } from '../verdocs-view/verdocs-view';
+/**
+ * Display a document signing experience.
+ */
+export declare class VerdocsSign {
+  /**
+   * If `source` is set to `verdocs-sign`, this should be set to a valid invitation code to activate a
+   * signing session.
+   */
+  documentid: string | null;
+  /**
+   * If `source` is set to `verdocs-sign`, this should be set to a valid invitation code to activate a
+   * signing session.
+   */
+  roleid: string | null;
+  /**
+   * If `source` is set to `verdocs-sign`, this should be set to a valid invitation code to activate a
+   * signing session.
+   */
+  invitecode: string | null;
+  endpoint: any;
+  recipient: any;
+  signerToken: any;
+  pdfUrl: any;
+  recipientIndex: number;
+  document: IDocument | null;
+  fields: IDocumentField[];
+  pdfPageInfo: IPDFRenderEvent;
+  hasSignature: boolean;
+  nextButtonLabel: string;
+  focusedField: string;
+  componentWillLoad(): void;
+  componentDidLoad(): Promise<void>;
+  handleClickAgree(): void;
+  savePDF(): Promise<void>;
+  handleOptionSelected(e: any): Promise<void>;
+  handleFieldChange(field: IDocumentField, e: any, optionId?: string): Promise<void>;
+  renderCheckboxGroupOption(page: IPDFPageInfo, field: IDocumentField, option: any, index: number): any;
+  renderRadioGroupOption(page: IPDFPageInfo, field: IDocumentField, option: any, index: number): any;
+  renderField(field: IDocumentField, index: number): any;
+  isFieldValid(field: IDocumentField): boolean;
+  handleDocumentRendered(e: any): void;
+  handleNext(): void;
+  render(): any;
+}

package/dist/types/components/embeds/verdocs-sign/verdocs-sign.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta } from '@storybook/web-components';
+declare const _default: Meta<import("@storybook/web-components").Args>;
+export default _default;
+export declare const Sign: ({ documentid, roleid, invitecode, authenticated }: {
+  documentid: any;
+  roleid: any;
+  invitecode: any;
+  authenticated: any;
+}) => import("lit-html").TemplateResult<1>;

package/dist/types/components/embeds/verdocs-view/verdocs-view.d.ts

@@ -0,0 +1,77 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+import { OnProgressParameters } from 'pdfjs-dist/types/src/display/api';
+export interface IPDFPageInfo {
+  height: number;
+  width: number;
+  originalHeight: number;
+  originalWidth: number;
+  xRatio: number;
+  yRatio: number;
+  pageNumber: number;
+  canvasTop: number;
+  canvasRight: number;
+  canvasLeft: number;
+  canvasBottom: number;
+}
+export interface IPDFRenderEvent {
+  numRendered: number;
+  numPages: number;
+  pages: IPDFPageInfo[];
+  canvasContainer: HTMLDivElement;
+}
+export declare class VerdocsView {
+  component: HTMLElement;
+  private pdfDocument;
+  private pdfContainer;
+  private numPages;
+  private fingerprint;
+  /**
+   * Rotate the PDF in degrees
+   */
+  rotation: 0 | 90 | 180 | 270;
+  /**
+   * Src of the PDF to load and render
+   */
+  source: string;
+  /**
+   * Access token to use. This component is a wrapper for PDF.js which does not use a VerdocsEndpoint, so the token must be supplied
+   * directly.
+   */
+  token: string | null;
+  /**
+   * Listen for changes to src
+   */
+  doSrc(newValue: string | null, oldValue: string | null): void;
+  /**
+   * Fired when a page has been rendered
+   */
+  pageRendered: EventEmitter<IPDFRenderEvent>;
+  /**
+   * Fired when a page has been changed
+   */
+  pageLoaded: EventEmitter<number>;
+  /**
+   * Fired when a page has been changed
+   */
+  pageChange: EventEmitter<number>;
+  /**
+   * Fired when a page has been initialized
+   */
+  pageInit: EventEmitter<number>;
+  /**
+   * Fired when a page has been scaled
+   */
+  scaleChange: EventEmitter<number>;
+  /**
+   * Fired when the document has completed rendered. The event will include the rendered page count.
+   */
+  documentRendered: EventEmitter<IPDFRenderEvent>;
+  loadProgress: number;
+  pagesRendered: IPDFPageInfo[];
+  isRotated(rotation: any): boolean;
+  renderPages(): Promise<void>;
+  componentDidLoad(): void;
+  onProgress(progress: OnProgressParameters): void;
+  loadAndRender(src: string): void;
+  render(): any;
+}

package/dist/types/components/embeds/verdocs-view/verdocs-view.stories.d.ts

@@ -0,0 +1,6 @@
+import { Meta } from '@storybook/web-components';
+declare const _default: Meta<import("@storybook/web-components").Args>;
+export default _default;
+export declare const View: ({ source }: {
+  source: any;
+}) => import("lit-html").TemplateResult<1>;