fullstack-utils v1.0.8

fullstack-utils

Assorted collection of Hono middlewares, Preact hooks and various other components and functions that I saw myself using over and over...

• hono-cloudflare-content - Serve static content with ETag support.
• hono-https-redirect - Redirect all requests to HTTPS.
• hono-quick-rpc - Expose JSON-RPC API.
• use-quick-rpc - Client for calling JSON-RPC endpoints.
• fetch-ex - Wrapper for the fetch call.
• use-feather - Spring based animations, similar to react-spring.

hono-cloudflare-content

Hono middleware for serving static content. Use it like this:

import {serveStatic} from "fullstack-utils/hono-cloudflare-content";
// ...assume app is a Hono instance.
app.use("*",serveStatic())

The reason why it exists is that it handles ETags differently than Hono's built in middleware.

hono-https-redirect

Hono middleware for redirecting all requests to HTTPS. Works like this:

import {httpsRedirect} from "fullstack-utils/hono-https-redirect";
// ...assume app is a Hono instance.
app.use("*",httpsRedirect({/* ...options... */}))

The httpsRedirect function accepts a configuration object with the following members:

• ignore - Array of hostnames to ignore and not perform redirect. Default ["localhost"].

hono-quick-rpc

Hono middleware for creating an RPC endpoint. The enpoint is for the most part JSON-RPC compliant, but the main focus is not compliance but convenience in creating APIs for internal client-server communication in projects. Works like this:

import {quickRpc} from "fullstack-utils/hono-quick-rpc";

class Api {
    constructor(context) {
        // context is Hono request context
    }

    function myfunc() {
        // ...
    }
}

// ...assume app is a Hono instance.
app.use("/myapi",quickRpc(Api))

Now a JSON-RPC endpoint will exist on /myapi. All methods exposed by the class will be made available as JSON-RPC methods. The positional parameters passed in the JSON-RPC call will be passed to the method, named parameters are not supported. An instance of the class will be constructed for each request, and the request context will be passed to the constructor.

use-quick-rpc

A React context and hook for calling JSON-RPC endpoints. In order to use it, you need to first provide a context on a higher level in your component tree:

import {QuickRpcProvider} from "fullstack-utils/use-quick-rpc";

function TopLevelComponent({children}) {
    return (
        <QuickRpcProvider url="/myapi" fetch={fetch}>
            {children}
        </QuickRpcProvider>
    );
}

Then, you can make calls to the api in further down in your child components:

import {useQuickRpc} from "fullstack-utils/use-quick-rpc";

function ChildComponent() {
    let api=useQuickRpc();
    let result=await api.myfunc();
    // ...
}

fetch-ex

A wrapper for the fetch call.

use-feather

A spring based animation tool.

import {useFeather} from "fullstack-utils/use-feather";

function MyComponent() {
    let ref=useRef();
    let feather=useFeather(v=>ref.current.style.opacity=`${v}%`);

    feather.setTarget(100);

    return (
        <div ref={ref}>
            fading...
        </div>
    );
}