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 🙏

© 2026 – Pkg Stats / Ryan Hefner

@ottoai/zuno-plaid

v0.1.0-alpha.0

Published

Provider-native Plaid API client for Zuno.

Readme

@ottoai/zuno-plaid

This package supplies a provider-native Plaid client for Node.js applications.

The package does not store access tokens, Item identifiers, cursors, webhooks, or tenant data.

Status

The package is an alpha release. Test each operation with Plaid Sandbox before production use.

Install

pnpm add @ottoai/zuno-plaid@next

Use Node.js 22.18.0 or later.

Create a Client

import { PlaidClient } from '@ottoai/zuno-plaid'

const plaid = new PlaidClient({
  clientId: process.env.PLAID_CLIENT_ID!,
  environment: 'sandbox',
  secret: process.env.PLAID_SECRET!,
})

The client supports Plaid Sandbox, Development, and Production.

Create a Link Token

const link = await plaid.createLinkToken({
  client_name: 'Example application',
  country_codes: ['US'],
  language: 'en',
  products: ['transactions'],
  user: {
    client_user_id: 'application-user-id',
  },
  webhook: 'https://example.com/webhooks/plaid',
})

Send link.link_token to Plaid Link. Do not send the Plaid secret to a browser.

Exchange the Public Token

const item = await plaid.exchangePublicToken({
  public_token: 'public-sandbox-token',
})

Encrypt item.access_token. Store it with item.item_id and the application tenant identifier.

Synchronize Transactions

const result = await plaid.syncAllTransactions({
  access_token: encryptedTokenAfterDecryption,
  cursor: storedCursor,
})

await applyTransactionChanges(result)
await storeCursor(result.next_cursor)

Store the new cursor only after all added, modified, and removed records are durable.

The helper restarts pagination after Plaid reports a mutation during pagination.

Verify Webhooks

Use the exact raw request body. Do not parse and serialize the body before verification.

const webhook = await plaid.verifyWebhook(
  rawRequestBody,
  request.headers.get('plaid-verification') ?? '',
)

The verifier checks the ES256 signature, key expiry, token age, and raw body SHA-256 hash.

Supported Operations

  • Link token creation and retrieval
  • public token exchange
  • Item retrieval, removal, webhook update, and token rotation
  • account and balance retrieval
  • Auth account-number retrieval
  • Transactions Get, Sync, refresh, recurring streams, and enrichment
  • statement listing, refresh, and PDF download
  • investment holdings, transactions, and refresh
  • Asset Report lifecycle, audit copies, and PDF download
  • processor token creation and permission updates
  • identity retrieval
  • liability retrieval
  • institution retrieval and search
  • webhook verification-key retrieval
  • signed webhook verification and typed event guards

Download Statements

import { verifyPlaidContentHash } from '@ottoai/zuno-plaid'

const statements = await plaid.listStatements({
  access_token: accessToken,
})

const file = await plaid.downloadStatement({
  access_token: accessToken,
  statement_id: statements.accounts[0]!.statements[0]!.statement_id,
})

if (file.contentHash && !(await verifyPlaidContentHash(file.data, file.contentHash))) {
  throw new Error('Plaid statement hash verification failed.')
}

The application owns file storage, retention, and PDF extraction.

Retrieve Recurring Transactions

const recurring = await plaid.getRecurringTransactions({
  access_token: accessToken,
})

The response keeps Plaid stream identifiers, transaction identifiers, frequency, status, dates, and amount fields.

Retrieve Auth Data

const auth = await plaid.getAuth({
  access_token: accessToken,
})

Do not log account or routing numbers. Encrypt sensitive values that the application stores.

Retrieve Investments

const holdings = await plaid.getInvestmentHoldings({
  access_token: accessToken,
})

const transactions = await plaid.getAllInvestmentTransactions({
  access_token: accessToken,
  start_date: '2026-01-01',
  end_date: '2026-12-31',
})

Enrich Transactions

const enriched = await plaid.enrichTransactions({
  account_type: 'depository',
  transactions: [
    {
      amount: 12.5,
      description: 'Example merchant',
      direction: 'OUTFLOW',
      id: 'application-transaction-id',
      iso_currency_code: 'USD',
    },
  ],
})

Send only transaction data that the application is authorized to process.

Create Asset Reports

const report = await plaid.createAssetReport({
  access_tokens: [accessToken],
  days_requested: 365,
  options: {
    webhook: 'https://example.com/webhooks/plaid',
  },
})

Store Asset Report tokens as secrets. Asset Reports can contain identity and financial data.

Create Processor Tokens

const processor = await plaid.createProcessorToken({
  access_token: accessToken,
  account_id: 'plaid-account-id',
  processor: 'approved-processor-name',
})

Create processor tokens only after the application confirms the tenant and selected account.

Application Responsibilities

The application must:

  • keep client credentials on the server
  • encrypt access tokens at rest
  • isolate Item data by tenant
  • store transaction cursors
  • apply synchronization changes atomically
  • retain the raw webhook body
  • deduplicate webhook deliveries
  • handle Item update mode
  • remove stored data after Item deletion
  • protect account numbers, reports, statements, and processor tokens
  • apply document retention and deletion policies

API Version

The default Plaid API version is 2020-09-14. Set version when Plaid requires another version.

Support

The package uses the community support level. geekfarmer maintains the initial provider.

Report security issues to [email protected].