@errorgamer2000/scratch-cloud v0.1.0

scratch-cloud

A TypeScript library that allows communication with the scratch cloud servers.

A short example:

import { ScratchCloud } from "@errorgamer2000/scratch-cloud";

async function main() {
  const cloud = new ScratchCloud();

  await cloud.login("<username>", "<password>");

  const session = cloud.createSession(
    "<project_id>",
    false /* do not use TurboWarp servers */
  );

  session.on("set", (name: string, value: string) => {
    console.log(`${name} was set to ${value}.`);
  });
}

This is a rewrite of the cloudsession api from my original scratch3-api module. This module provides only methods to communicate with the Scratch/TurboWarp cloud servers. To use methods that are not centered around the cloud servers, use scratch-connect(not yet published). For string to number conversions, see stringstonumbers.

Installation

Install with npm or other package manager:

npm install @errorgamer2000/scratch-cloud

Or by cloning this repository:

git clone https://github.com/ErrorGamer2000/scratch-cloud.git

Exports:

Classes

ScratchCloud

Kind: global class

• ScratchCloud
  • new ScratchCloud()
  • .login(username, password)
  • .createSession(project, turbowarp)

new ScratchCloud()

scratchCloud.login(username, password)

Kind: instance method of ScratchCloud Throws:

• TypeError If the username or password are incorrect.
• Error If the scratch server gives an invalid response.

scratchCloud.createSession(project, turbowarp)

Kind: instance method of ScratchCloud

Session

Kind: global class

• Session
  • new Session(userData, projectId, turbowarp)
  • .set(name, value)
  • .get(name)
  • .enableAutoPrefix()
  • .disableAutoPrefix()
  • .on(eventName, listener)
  • .once(eventName, listener)

new Session(userData, projectId, turbowarp)

session.set(name, value)

Kind: instance method of Session

session.get(name)

Kind: instance method of Session

session.enableAutoPrefix()

Kind: instance method of Session See: Session.autoPrefix

session.disableAutoPrefix()

Kind: instance method of Session See: Session.autoPrefix

session.on(eventName, listener)

Kind: instance method of Session

session.once(eventName, listener)

Kind: instance method of Session

© 2022 ErrorGamer2000