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

brex

v0.5.1

Published

This project is an unofficial JS wrapper for the Brex API, maintained by [Slingshot](https://github.com/slingshot). We use this library in production for managing payouts to artists on our platform.

Downloads

2

Readme

Brex API Wrapper

This project is an unofficial JS wrapper for the Brex API, maintained by Slingshot. We use this library in production for managing payouts to artists on our platform.

This library is built in TypeScript and comes with built-in types. All requests use isomorphic-unfetch and should work both in Node and in browsers.

Install the package to get started:

npm install brex --save
# OR
yarn add brex

The full wrapper API reference can be found at slingshot.github.io/brex.

This is an UNOFFICIAL LIBRARY and not created, maintained, or in any way connected with Brex Inc. or any associated entity. "Brex" is a registered trademark of Brex, Inc. Use of the Brex API is subject to the Brex Access Agreement.

The nature of the Brex API means that most usage will involve dealing with highly sensitive financial data and transfers. You are entirely responsible for ensuring that proper security measures are implemented to protect all data.

This wrapper library is offered under the MIT license (see the LICENSE file for full text).

Basic usage

Initialize an API instance using a user token, which you can generate in your Brex account dashboard (or via OAuth).

import { Brex } from 'brex';

const brex = new Brex('{{YOUR USER TOKEN HERE}}');

You can then access any endpoint using the request method, which wraps the API using your provided token. For example:

const result = await brex.request({
    endpoint: 'vendors',
    method: 'GET',
    query: {
        name: 'Sanil Chawla',
    },
});

You can pass in a query, body, and/or idempotencyKey depending on your request. See the ApiRequestOptions interface for more details.

What's coming soon?

Version 1.0.0 will include a true JS wrapper that is semantically easier to use and handles typing across requests (for example, brex.vendors.list() or brex.users.invite({...})).

This functionality will be rolled out incrementally and tracked below. The brex.request() method will always remain accessible as well. Contributions are always welcome.

Payments API

✅ Vendors

  • [x] brex.vendors.list()
  • [x] brex.vendors.create()
  • [x] brex.vendors.get()
  • [x] brex.vendors.update()
  • [x] brex.vendors.delete()

✅ Transfers

  • [x] brex.transfers.list()
  • [x] brex.transfers.create()
  • [x] brex.transfers.get()

Team API

Users

  • [ ] brex.users.list()
  • [ ] brex.users.invite()
  • [ ] brex.users.getCurrent()
  • [ ] brex.users.get()
  • [ ] brex.users.update()
  • [ ] brex.users.getLimit()
  • [ ] brex.users.setLimit()

Locations

  • [ ] brex.locations.list()
  • [ ] brex.locations.create()
  • [ ] brex.locations.get()

Departments

  • [ ] brex.departments.list()
  • [ ] brex.departments.create()
  • [ ] brex.departments.get()

Cards

  • [ ] brex.cards.list()
  • [ ] brex.cards.create()
  • [ ] brex.cards.get()
  • [ ] brex.cards.update()
  • [ ] brex.cards.lock()
  • [ ] brex.cards.getNumber()
  • [ ] brex.cards.terminate()
  • [ ] brex.cards.unlock()

Companies

  • [ ] brex.companies.get()

Transactions API

Transactions

  • [ ] brex.transactions.listPrimaryCard()
  • [ ] brex.transactions.listCash()

✅ Accounts

  • [x] brex.accounts.listCardAccounts()
  • [x] brex.accounts.listPrimaryCardStatements()
  • [x] brex.accounts.listCashAccounts()
  • [x] brex.accounts.listCashStatements()

Cleanup & docs

  • [ ] Contribution guidelines
  • [ ] Jest tests (probably by providing a key in env; CI if possible, but could be tough without a test/sandbox API key)
  • [ ] Documentation and examples (possibly just a modified/enhanced version of the auto-generated TypeDoc docs)