@oopsie-app/node

Official Oopsie backend SDK for Node.js.

Install

npm install @oopsie-app/node

Quick start

const express = require('express');
const { createOopsieNode } = require('@oopsie-app/node');

const app = express();

const oopsie = createOopsieNode({
  apiToken: process.env.OOPSIE_API_TOKEN,
  projectKey: process.env.OOPSIE_PROJECT_KEY,
  baseUrl: 'https://your-oopsie-app.com',
  releaseToken: process.env.OOPSIE_RELEASE_TOKEN,
  environment: process.env.NODE_ENV || 'production',
  release: process.env.OOPSIE_RELEASE || '1.0.0',
  framework: 'express',
});

oopsie.handshake().catch(() => {});

app.use(oopsie.expressRequestHandler());

app.get('/health', (req, res) => {
  res.json({ ok: true });
});

app.use(oopsie.expressErrorHandler());

Manual capture

try {
  throw new Error('Payment pipeline failed');
} catch (error) {
  await oopsie.captureException(error, {
    payload: {
      job: 'billing-sync',
    },
  });
}

Release tracking

await oopsie.notifyRelease({
  version: process.env.OOPSIE_RELEASE || '1.0.0',
  environment: process.env.NODE_ENV || 'production',
  commitSha: process.env.OOPSIE_COMMIT_SHA,
  description: 'Deploy production',
});