JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1314
  • Score
    100M100P100Q115427F
  • License ISC

Dodgeball Server SDK

Package Exports

  • @dodgeball/trust-sdk-server
  • @dodgeball/trust-sdk-server/dist/cjs/index.js
  • @dodgeball/trust-sdk-server/dist/esm/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dodgeball/trust-sdk-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Dodgeball Server Trust SDK for NodeJS

The Dodgeball Server Trust SDK allows you to decouple trust and safety requirements from your application code. Dodgeball serves as an abstraction layer for the various integrations your application requires when performing risky actions. For example, instead of directly integrating fraud engines, 2FA, KYC providers, and bot prevention solutions into your application, use Dodgeball to decouple these requirements from your application code. Your trust and safety teams focus on ensuring your application is safe and secure, and you focus on your application's business logic. When threats evolve or new vulnerabilities are identified, your application can be updated to mitigate these risks without having to change a single line of code or add support for a new integration.

Check out the Dodgeball Trust Client SDK for how to integrate Dodgeball into your client applications.

Installation

Use npm to install the Dodgeball module:

npm install @dodgeball/trust-sdk-server

Alternatively, using yarn:

yarn add @dodgeball/trust-sdk-server

Usage

import { Dodgeball } from '@dodgeball/trust-sdk-server';
import express from 'express';

const app = express();
const dodgeball = new Dodgeball(process.env.DODGEBALL_SECRET_KEY);

app.post('/api/orders', async (req, res) => {
  // Call the Dodgeball API to verify the event is allowed to proceed
  const verifyResponse = await dodgeball.verify({
    workflow: {
      type: 'PLACE_ORDER',
      data: {
        order: req.body.order
      }
    },
    dodgeballId: req.body.dodgeballId,
    useVerification: req.body.verification,
    options: {
      sync: true
    }
  });

  if (dodgeball.isAllowed(verifyResponse)) {
    const placedOrder = await database.createOrder(req.body.order); // Proceed with placing the order
    return res.status(200).json({
      order: placedOrder
    });
  } else if (dodgeball.isPending(verifyResponse)){
    return res.status(202).json({
      verification: verifyResponse.verification
    });
  } else if (dodgeball.isDenied(verifyResponse)){
    return res.status(403).json({
      verification: verifyResponse.verification
    });
  } else {
    return res.status(500).json({
      message: verifyResponse.errors
    });
  }
});

app.listen(process.env.APP_PORT, () => {
  console.log(`Listening on port ${process.env.APP_PORT}`);
});