Crosis4Furrets

An abstraction layer on top of @replit/crosis that makes Repl connection management and operations so easy, a Furret could do it! :tada:

Added Features

• Silent shellRun
• Exposed runner shellState

Install

# with NPM
$ npm install crosis4furrets

# with Yarn
$ yarn add crosis4furrets

Usage

Main API

import { Crosis } from "crosis4furrets";

const client = new Crosis({ token: '', replId: '' });

which returns a <Client>

Options

• token: A user's connect.sid cookie from Replit.
• replId: An ID connected to any public Repl (or a user's private Repls).
• ignore?: Optionally override a Repl's .gitignore file with your own. Used when created a recursed directory.

Client

A <Client> opens up many operations that you can perform on a Repl. Note, several of these operations will be limited on Repls that you do not own:

Connection

• <Client>.connect(): Connect a client the specified Repl.
• <Client>.persist(): Persist file changes in a Repl from this connection.
• <Client>.close(): Close a client connection.

File Operations

• <Client>.read(path[, encoding]): Read a file at a specific path. Specify an encoding to parse the file, otherwise returns a Buffer.
• <Client>.readdir(path): List files in a specific directory.
• <Client>.recursedir(path[, withIgnore = true]): Recurse through files in a specific directory. Automatically reads .gitignore files and skips those files.
• <Client>.write(path, content): Write content to a file. Can be Buffer or string content.
• <Client>.mkdir(path): Make a directory at a specific path.
• <Client>.remove(path): Remove a file at a specific path.
• <Client>.removeAll(): Remove all files in the Repl.
• <Client>.move(oldPath, newPath): Move a file to a specific location.
• <Client>.snapshot(): Capture a filesystem snapshot of the Repl.

Language Server

• <Client>.lsp(message): If the Repl has an LSP, send a message to it.

Packager (via UPM)

• <Client>.packageInstall(): Install the Repl's packages.
• <Client>.packageAdd(packages): Add packages to the Repl.
• <Client>.packageRemove(): Remove packages from the Repl.
• <Client>.packageList(): List the Repl's packages.
• <Client>.packageSearch(): Search for packages via UPM.
• <Client>.packageInfo(): Pull package information via UPM.

Runner (via ShellRun)

• <Client>.shellRun([, timeout]): Run the current Repl's main command.
• <Client>.shellExec(command[, args, timeout]): Run a command (with optional arguments) on the Repl's shell.
• <Client>.shellStop([, timeout]): Stop the Repl's current process.

Example

// using ESM, if in CommonJS use an async context!
import { Crosis } from "crosis4furrets";

const client = new Crosis({
  token: process.env.REPLIT_TOKEN, // connect.sid
  replId: "68fff490-4ce3-4123-b429-c11622fb8dd3" // id of a repl
});

await client.connect();
console.log("Read:\n", await client.read("index.js", "utf-8"));

Note: If you want an easy way to get ReplID's, visit this Repl.

Contributing

This project is in active development and we would love some :sparkles: fabulous :sparkles: contributions! To get started, visit our Contributing documentation.

Licensing

This project is licensed under the MIT License. For more information, see LICENSE.