WebArray

Fast remote arrays. Works everywhere, fine grained access conrols & no sign-ups.

Quick Start

          import { WebArray } from "https://cdn.toolbomber.com/js/WebArray.min.js"

const webArray = WebArray.create("REPLACE_WITH_YOUR_SEED")

await webArray.append("Hello WebArray")

console.log(await webArray.read())

await webArray.replace("Bye Bye!")

Features

It can do read(), append(item) & replace(item)
Access can be restrcted by removing the specific keys in webArray.keys

Use cases

Forms
Email Collectors
Chat Systems
Polls
Surveys

Feedback Example

Just copy/paste this code to a file & open in browser to see it live! Or edit it in live in CodePen.

          <!DOCTYPE html>
<html lang="en">
  <head>
    <link
      rel="stylesheet"
      href="https://cdn.jsdelivr.net/npm/@picocss/[email protected]/css/pico.min.css"
    />
    <script type="module">
      import { WebArray } from "https://cdn.toolbomber.com/js/WebArray.min.js"
      window.webArray = await WebArray.create("YOUR_UNIQUE_KEY")

      window.update = async () => {
        const history = (await webArray.read()).join("\n")
        document.querySelector("#fbs").innerHTML = history
      }

      window.handleSubmit = async () => {
        const input = document.querySelector("#fbi")
        await webArray.append(input.value)
        input.value = ""
        await update()
      }

      update()
    </script>
  </head>
  <body>
    <main class="container">
      <div>
        <pre id="fbs"></pre>
      </div>
      <form onsubmit="event.preventDefault(); return false;">
        <textarea id="fbi" placeholder="Your feedback" rows="2"></textarea>
        <button type="button" onclick="handleSubmit()">Send</button>
      </form>
    </main>
  </body>
</html>

        

Access Control

          const webArray = await WebArray.create("123")

delete webArray.keys.read

console.log(await webArray.read()) // Will cause authorisation error; likewise for other keys

WebArray.generateKeys(seed)

Or keys can be independently created and used to initialise the client for fine grained access control.

          const keys = await WebArray.generateKeys("YOUR_UNIQUE_KEY")

delete keys.append
delete keys.replace

const readOnlyClient = new WebArray(keys)

Note

All remote access functions are async, do remember to use await