@technik-sde/foxy

simple frontend proxy

Customizable frontend-proxy, supporting multiple handlers for input-urls

Usage

import { Foxy, utils } from "foxy";

const proxy = new Foxy({
  handlers: [
    {
      use({ url }) {
        return myUrlFormat.test(url);
      },
      getImageURL({ url }) {
        return Promise.resolve(buildMyUrlScheme(url));
      },
      getImageInfo({ url }) {
        return utils.loadImage(buildMyUrlScheme(url))
      }
    }
  ]
});

const finalUrl = await proxy.getImageURL({ url: 1234 });
const imageMetadata = await proxy.getImageInfo({ url: 1234 });

Multiple handlers are supported and are resolved from first to last index. The first handler returning true on use, will be selected, if the given method-name is defined:

import { Foxy } from "foxy";

const proxy = new Foxy({
  handlers: [
    {
      use({ url }) {
        return myUrlFormat.test(url);
      },
      getImageURL({ url }) {
        return Promise.resolve(buildMyUrlScheme(url));
      }
    },
    {
      use: () => true,
      // overwrites default exception to always return false
      getImageURL({ url }) { return Promise.resolve(false); } 
    }
  ]
});

const finalUrl = await proxy.getImageURL({ url: "abc" }); // false, when not myUrlFormat

Per default the following methods are supported via api: getImageURL, getImageInfo, getVideoURL, getVideoInfo. The generic method get(methodName: string, requestData: AnyObject) may be used to access any custom methods defined on handlers. e.g.

import { Foxy } from "foxy";

const proxy = new Foxy({
  handlers: [
    {
      use({ url }) {
        return myUrlFormat.test(url);
      },
      getJSON({ url }) {
        return fetch(buildMyUrlScheme(url)).then(response => response.json());
      }
    }
  ]
});

const json = await proxy.get("getJSON", { url: "my-json-url" });