npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

superrequestable

v0.3.9

Published

A TypeScript package based that allows asynchronous inter-process communication to make "REST-like" GET and POST requests.

Downloads

2

Readme

SuperRequestable

Code Size npm Total Downloads GitHub Open Issues

SuperRequestable is a very small TypeScript package that allows two NodeJS processes to exchange data asynchronously in a "REST-like" fashion.

Quick Look

Mark a class method as @requestable on your serving process:

class MyClass {
    @requestable('GET')
    public gimmeChocolate(amount: number) {
        return `${amount} bars of chocolate to you!`;
    }
}

Make a "GET" request on your client process:

const chocolate: number = await RequestableClient.get('gimmeChocolate', 9999); 
// Output: 9999 bars of chocolate to you!

Install & usage notes

Install the package via npm:

> npm install -S superrequestable

Server-side

Start the SuperRequestable server service by providing the start() method either a IORedis instance or a valid Redis URL:

import { SuperRequestable } from 'superrequestable';

SuperRequestable.start(process.env.REDIS_URL!);

You can then start to mark your class methods as @requestable:

class MyClass {
    @requestable('GET')
    private async sayHello(to: string): Promise<string> {
        return `Hello, ${to}!`;
    }
}

The decorated method will be registered by its name and will be accessible from the client via the same method name - be aware it is case-sensitive! The @requestable decorator accepts two parameters:

  1. The request method, it can be either "GET" or "POST", borrowing the semantic meaning of both terms from the HTTP protocol. GET "requestables" (methods marked as @requestable) must be called by .get() requests, and POST requestables via .post() requests: GET and POST requests with the same name can in fact coexist.
  2. echoError: if set to false (default), the requestable would return a generic error response. If set to true, the requestable echoes the original error message as-is.

Client-side

Start the SuperRequestable client service by providing the start() method either a IORedis instance or a valid Redis URL:

import { RequestableClient } from 'superrequestable';

RequestableClient.start(process.env.REDIS_URL!);

And make GET and POST requests to your server service:

const greeting: string = await RequestableClient.get('sayHello', 'world');

// Output: Hello, world!

You can make POST requests by calling the RequestableClient.post() method. .get() and .post() accept the same arguments:

  • functionName: string, string representing the exact, case-sensitive name of the requestable method
  • ...args: any[]: parameters to be passed as-is to the requestable method on the server service

Tests

To run tests without debug logs: npm test

To run tests with debug logs: npm run test-dev

Debug Logs

The available debug (npm debug package) namespaces are:

  • superrequestable (logs registrations)
  • superrequestable:requestable (logs decorator registrations)
  • superrequestable:client (logs requests to the server service)

You can enable all logs by setting the DEBUG environment variable to superrequestable,superrequestable:*:

> export DEBUG=superrequestable,superrequestable:*

Current Limitations

  • Any method belonging to different classes with the same name cannot be both requestable-decorated, as they would both refer to the same, last-registered, method.

License

MIT. Do as you please with this package. Contributions and pull requests are very well accepted, would be my pleasure to review and integrate. Thank you!