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

@domoinc/ryuu-proxy

v4.4.0

Published

a middleware that provides a proxy for local domo app development

Downloads

639

Readme

ryuu-proxy

npm version install size npm downloads Known Vulnerabilities

Simple middleware to add to a local development server while developing Domo Apps. The middleware will intercept any calls to /data/v{d}, /sql/v{d}, /dql/v{d} or /domo/.../v{d}, proxy an authenticated request to the Domo App service, and pipe the response back so that you can develop your Domo App locally and still get request data from Domo.

Installation

npm install @domoinc/ryuu-proxy --save-dev

Usage

This library leverages the last login session from your Domo CLI. If that session is no longer active or doesn't exist then the proxy won't work. Be sure that you've logged in before you start working:

$ domo login

Configuration

const { Proxy } = require("@domoinc/ryuu-proxy");
const manifest = require("./path/to/app/manifest.json");

const config = { manifest };

// use `proxy` in your development server
const proxy = new Proxy(config);

The proxy constructor expects a config object. Certain properties are required and others are optional.

Required Configuration Properties

  • manifest: The parsed contents of a project's manifest.json file. domo publish have been run at least once to ensure the manifest.json file has an id property

Optional Configuration Properties

  • manifest.proxyId: An advanced property required for projects leveraging DQL, writebacks, or Oauth. If you are unsure of whether or not you need this, you most likely don't. To get a proxyId, see "Getting a proxyId" below

With Express / Connect

This library comes with a simple wrapper for Express/Connect middleware.

const app = express();
app.use(proxy.express());

With Other Frameworks

For other frameworks, the library exposes the necessary functions to create a stream to pipe back to your server. You'll need to handle this stream as your server would expect. The only thing that stream() expects is a standard Node Request which most server frameworks extend in some way.

// koa
app.use(async (ctx, next) => {
  await proxy
    .stream(ctx.req)
    .then((data) => (ctx.body = ctx.req.pipe(data)))
    .catch(next);
});
// express
app.use((req, res, next) => {
  proxy
    .stream(req)
    .then((stream) => stream.pipe(res))
    .catch(() => next());
});
// node http
const server = http.createServer((req, res) => {
  if (req.url === "/") {
    loadHomePage(res);
  } else {
    proxy.stream(req).then((stream) => stream.pipe(res));
  }
});

Error Handling

Ignoring the errors will cause the proxy to fail silently and the proxy request will return a 404 error. If you'd like a little more detail on the errors you can expose them in the response:

// koa
app.use(async (ctx, next) => {
  await proxy
    .stream(ctx.req)
    .then((data) => (ctx.body = ctx.req.pipe(data)))
    .catch((err) => {
      if (err.name === "DomoException") {
        ctx.status = err.status || err.statusCode || 500;
        ctx.body = err;
      } else {
        next();
      }
    });
});
// express / connect
app.use((req, res, next) => {
  proxy
    .stream(req)
    .then((stream) => stream.pipe(res))
    .catch((err) => {
      if (err.name === "DomoException") {
        res.status(err.status || err.statusCode || 500).json(err);
      } else {
        next();
      }
    });
});
// http
const server = http.createServer((req, res) => {
  if (req.url === "/") {
    loadHomePage();
  } else {
    proxy
      .stream(req)
      .then((stream) => stream.pipe(res))
      .catch((err) => {
        if (err.name === "DomoException") {
          res.writeHead(err.status || err.statusCode || 500);
          res.end(JSON.stringify(err));
        }
      });
  }
});

Getting a proxyId (Advanced)

Apps using DQL, writeback, or oAuth features are required to supply an proxyId as part of the proxy configuration. This allows the proxy to know how to properly route requests. The proxyId can be found as part of the URL for the iframe in which your app is displayed. It will be of the form XXXXXXXX-XXXX-4XXX-XXXX-XXXXXXXXXXXX. To find the ID:

  1. Make sure the app has been published at least once with domo publish
  2. Publish a new card based on your app design, or navigate to an existing card made from your app design
  3. Right-click anywhere in the card and choose "Inspect element"
  4. Find the <iframe> that contains your app's code. The URL should be of the form //{HASH}.domoapps.prodX.domo.com?userId=...
  5. Copy the ID found between // and .domoapps. That is your app's proxyId

proxyIds tie apps to cards. If you delete the card from which you retrieved the proxyId, you will have to get a new one from another card created from your app design.

Building

To build ryuu-proxy, run

npm run build

All necessary files will be built/copied into the dist folder.

Contributing

Recommended Workflow:

  1. Create new branch (named "DOMO-XXXXXX")
  2. Make Changes
  3. Commit Changes
  4. Test changes (if necessary, version a alpha/beta/tagged version, then release it)
  5. Make pull request
  6. After pull request is merged to master, bump version, then release it to npm

Versioning

This project utilizes standard-version.

  • npm run bump - Version bumps determined automatically via commits
  • npm run bumpBeta or npm run bump -- --prerelease beta - 4.0.x-beta.0 (if no current beta) or 4.0.0-beta.x (if current beta exists)

Releasing

Versions should be released on npm

  • npm run release
  • npm run releaseAlpha
  • npm run releaseBeta