Merge branch 'master' into refactor/create-new-type

Author: ftonato

.github/workflows/ci.yml

@@ -8,19 +8,28 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        node: ['12']
+        node: ['14']
 
     runs-on: ${{ matrix.os }}
 
     steps:
       - uses: actions/checkout@v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v2
         with:
           node-version: ${{ matrix.node }}
 
       - name: Run tests
         run: |
           npm ci
           npm t
+
+      - name: Test & publish code coverage
+        uses: paambaati/[email protected]
+        env:
+          CC_TEST_REPORTER_ID: ${{secrets.CC_TEST_REPORTER_ID}}
+        with:
+          coverageCommand: yarn run coverage
+          coverageLocations: |
+            ${{github.workspace}}/test/coverage/lcov.info:lcov

.github/workflows/docs.yml

@@ -12,15 +12,15 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        node: ['12']
+        node: ['14']
 
     runs-on: ${{ matrix.os }}
 
     steps:
       - uses: actions/checkout@v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v2
         with:
           node-version: ${{ matrix.node }}
 

.github/workflows/release.yml

@@ -11,15 +11,15 @@ jobs:
     name: Release / Node ${{ matrix.node }}
     strategy:
       matrix:
-        node: ['12']
+        node: ['14']
 
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v2
         with:
           node-version: ${{ matrix.node }}
 
@@ -28,7 +28,7 @@ jobs:
           npm run build
 
       - name: Create a release
-        run: npx semantic-release
+        run: npx semantic-release@^18.0.0
         env:
           GITHUB_TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.releaserc.json

@@ -15,7 +15,15 @@
     ],
     "@semantic-release/commit-analyzer",
     "@semantic-release/release-notes-generator",
-    "@semantic-release/github",
+    [
+      "@semantic-release/github",
+      {
+        "successComment": false,
+        "releasedLabels": false,
+        "failTitle": false,
+        "addReleases": false
+      }
+    ],
     "@semantic-release/npm"
   ]
 }

README.md

@@ -1,15 +1,19 @@
 # `supabase-js`
 
-An isomorphic Javascript client for Supabase.
+An isomorphic JavaScript client for Supabase.
 
-- Documentation: https://supabase.io/docs/client/supabase-client
+**Documentation:** https://supabase.io/docs/client/supabase-client
 
 ## Usage
 
+First of all, you need to install the library:
+
 ```sh
 npm install @supabase/supabase-js
 ```
 
+Then you're able to import the library and establish the connection with the database:
+
 ```js
 import { createClient } from '@supabase/supabase-js'
 
@@ -19,22 +23,43 @@ const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key
 
 ### UMD
 
-You can now use plain `<script>`s to import supabase-js from CDNs, like
+You can now use plain `<script>`s to import supabase-js from CDNs, like:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@supabase/supabase-js"></script>
+```
+
+or even:
 
-`<script src="https://cdn.jsdelivr.net/npm/@supabase/supabase-js"></script>`
-or
-`<script src="https://unpkg.com/@supabase/supabase-js"></script>`.
+```html
+<script src="https://unpkg.com/@supabase/supabase-js"></script>
+```
 
 Then you can use it from a global `supabase` variable:
 
 ```html
 <script>
-    const { createClient } = supabase
-    supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key')
-  ...
+  const { createClient } = supabase
+  const _supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key')
+
+  console.log('Supabase Instance: ', _supabase)
+  // ...
 </script>
 ```
 
+### Custom `fetch` implementation
+
+`supabase-js` 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 '@supabase/supabase-js'
+
+// Provide a custom `fetch` implementation as an option
+const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key', {
+  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.