Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More

hellosign-embedded

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

hellosign-embedded

A JavaScript library required for embedding HelloSign features into your webapp. For more information, see our API documentation at https://www.hellosign.com/api/documentation.


Version published
Weekly downloads
75K
decreased by-16.65%
Maintainers
1
Weekly downloads
 
Created

hellosign-embedded Build Status

A JavaScript library required for using embedded signing and templates from within your application. For more information, see our API documentation.

Getting started

You can include this library in your projects in one of three ways:

NPM

You can require the hellosign-embedded package in your front-end code when using a bundler like browserify or webpack.

First, npm install hellosign-embedded to add to your node_modules directory, then attach to a variable or the global window:

window.HelloSign = require('hellosign-embedded');

If transpiling for ES6, you can also use the import statement:

import HelloSign from 'hellosign-embedded';
window.HelloSign = HelloSign;

###Loading from CDN

You can load this library from our global CDN using a <script> tag:

<script type="text/javascript" src="https://s3.amazonaws.com/cdn.hellosign.com/public/js/hellosign-embedded.LATEST.min.js"></script>
<!-- Alternately, omit the "min" for the unminified version -->

This will always use the latest published version of the library.

If you'd prefer to use a specific version, you can specify that version in the URL:

<script type="text/javascript" src="https://s3.amazonaws.com/cdn.hellosign.com/public/js/hellosign-embedded.0.1.6.min.js"></script>
<!-- Alternately, omit the "min" for the unminified version -->

We highly recommend using the latest version of the library, so you'll receive security and feature updates.

Building from source

You'll need to clone this repository, and have npm and webpack installed. From your command line, run

# In the project directory
npm install --dev
webpack

which will build both the minified and the unminified versions of the script. You can find these products under the dist directory in the project:

# In the project directory
> ls dist
# unminified
hellosign-embedded.0.1.1.js
# minified
hellosign-embedded.0.1.1.min.js

These resultant libraries can be referenced from a <script> tag in your HTML.

Usage

Basic usage of hellosign-embedded requires initializing the library, then using the HelloSign.open function to open a URL you've fetched through the HelloSign API in an iFrame on your page.

Initialize on the page using your HelloSign API client ID:

HelloSign.init('MY_AWESOME_API_CLIENT_ID');

If you don't have one yet, head on over to the API settings for your account on HelloSign and create an API App. This will provide you with a client ID.

Make a call using your favorite client library on our api for an embedded signature request or template, then use the signer URL you get back with hellosign-embedded:

HelloSign.open({
    url: "SIGN_URL",
    // other options
});

See the Embedded Signing Walkthrough to learn more.

Tests

The current test suite can be run with npm tests. Tests are a work in progress, built with Mocha and Chai, and using jsdom-global

Demo

There is a demo app available in this repo, useful for both development against this repo, and examining how a simple integration can work.

You can start the test server from the root of the repository by simply running

npm start

When running, any changes to src/embedded.js will be tracked, and the file that the demo site uses will be rebuilt on the fly.

You'll need an API Key and Client ID for HelloSign's API to use this demo application.

Extras

TypeScript

Bindings for TypeScript have been lovingly added to the DefinitelyTyped repo for hellosign-embedded.

FAQs

Package last updated on 28 Feb 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts