# `pasubot-js-v2` - Isomorphic JavaScript Client for Pasubot.

- **Documentation:** https://pasubot.com/docs/reference
- TypeDoc: https://pasubot.github.io/pasubot-js-v2/v2/

## Usage

First of all, you need to install the library:

```sh
npm install pasubot-js-v2
```

Then you're able to import the library and establish the connection with the database:

```js
import { createClient } from 'pasubot-js-v2'

// Create a single pasubot client for interacting with your database
const pasubot = createClient('https://xyzcompany.pasubot.co', 'public-anon-key')
```

### UMD

You can use plain `<script>`s to import pasubot-js-v2 from CDNs, like:

```html
<script src="https://cdn.jsdelivr.net/npm/pasubot-js-v2@2"></script>
```

or even:

```html
<script src="https://unpkg.com/pasubot-js-v2@2"></script>
```

Then you can use it from a global `pasubot` variable:

```html
<script>
  const { createClient } = pasubot
  const _pasubot = createClient('https://xyzcompany.pasubot.co', 'public-anon-key')

  console.log('Pasubot Instance: ', _pasubot)
  // ...
</script>
```

### ESM

You can use `<script type="module">` to import pasubot-js-v2 from CDNs, like:

```html
<script type="module">
  import { createClient } from 'https://cdn.jsdelivr.net/npm/pasubot-js-v2/+esm'
  const pasubot = createClient('https://xyzcompany.pasubot.co', 'public-anon-key')

  console.log('Pasubot Instance: ', pasubot)
  // ...
</script>
```

### Deno

You can use pasubot-js-v2 in the Deno runtime via esm.sh:

```js
import { createClient } from 'https://esm.sh/pasubot-js-v2@2'
```

### Custom `fetch` implementation

`pasubot-js-v2` uses the [`cross-fetch`](https://www.npmjs.com/package/cross-fetch) library to make HTTP requests, but an alternative `fetch` implementation can be provided as an option. This is most useful in environments where `cross-fetch` is not compatible, for instance Cloudflare Workers:

```js
import { createClient } from 'pasubot-js-v2-v2'

// Provide a custom `fetch` implementation as an option
const pasubot = createClient('https://xyzcompany.pasubot.co', 'public-anon-key', {
  global: {
    fetch: (...args) => fetch(...args),
  },
})
```

## Sponsors

We are building the features of Firebase using enterprise-grade, open source products. We support existing communities wherever possible, and if the products don’t exist we build them and open source them ourselves. Thanks to these sponsors who are making the OSS ecosystem better for everyone.

[![New Sponsor](https://user-images.githubusercontent.com/10214025/90518111-e74bbb00-e198-11ea-8f88-c9e3c1aa4b5b.png)](https://github.com/sponsors/pasubot)

## Badges

[![Coverage Status](https://coveralls.io/repos/github/pasubot/pasubot-js-v2/badge.svg?branch=master)](https://coveralls.io/github/pasubot/pasubot-js-v2?branch=master)