dymo-api

library1.2.44jsnpmunverified

Official Node.js library for the Dymo API (v1.2.44), a fraud detection and data validation service. It provides methods to validate email, phone, domain, IP, credit card, IBAN, wallet, and user agent in a single call or individually. The library includes built-in rule-based decision making for email validation, supports TypeScript types, and requires an API key (free tier available). Active development from TPEOficial with regular releases.

security fraud-detection

npm install dymo-api

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DYMO-API

dymo-api

securityjavascriptv1.2.44

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

DymoAPI

✓ import DymoAPI from 'dymo-api'

✗ const DymoAPI = require('dymo-api')

Default export is a class. CommonJS require() works but TS may complain without esModuleInterop.

DymoAPI

✓ const DymoAPI = require('dymo-api').default

✗ const DymoAPI = require('dymo-api')

CJS users must use .default to get the default export.

DymoAPIClient (type)

✓ import type { DymoAPIClient } from 'dymo-api'

✗ import { DymoAPIClient } from 'dymo-api'

Type import only available in TypeScript with verbatimModuleSyntax. Named export is DymoAPIClient.

Initializes the Dymo API client with an API key and validates email, phone, and IP in one call.

import DymoAPI from 'dymo-api'; const dymoClient = new DymoAPI({ apiKey: process.env.DYMO_API_KEY ?? '' }); (async () => { const response = await dymoClient.isValidData({ email: 'test@example.com', phone: '+34617509462', ip: '52.94.236.248' }); console.log(response); })();

Debug

Known issues

breakingIn v1.0, the client constructor accepted `apiKey` as a string; now it requires an object with `apiKey` property.

fix

Change `new DymoAPI('KEY')` to `new DymoAPI({ apiKey: 'KEY' })`.

affects: <1.0.0

deprecatedThe `validateEmail` method was renamed to `isValidEmail` in v1.2.0.

fix

Replace `validateEmail()` calls with `isValidEmail()`.

affects: <1.2.0

gotchaThe `rules` object in the constructor only supports `email` rules. Using rules for other fields is silently ignored.

fix

Only set `rules.email`; other rule keys have no effect.

affects: >=1.0.0

gotchaThe `isValidData` method returns a promise that never rejects (always resolves with error details).

fix

Always handle both success and error cases in the response object.

affects: >=1.0.0

deprecatedThe `creditCard` field in `isValidData` uses `pan` and `expirationDate`; `cvv` is optional but recommended.

fix

Always include `cvv` for best results, though not required.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: DymoAPI is not a constructor

Using CommonJS require without .default.

fix

Use `const DymoAPI = require('dymo-api').default;`

Error: Invalid API Key

Empty or malformed API key passed to constructor.

fix

Ensure `apiKey` is a non-empty string. Get a free key at https://tpe.li/new-api-key

TypeError: Cannot read properties of undefined (reading 'isValidEmail')

Client not properly instantiated (missing `new`).

fix

Use `new DymoAPI({ apiKey: '...' })` instead of calling `DymoAPI(...)`

Expected ')' at position X in JSON response

Invalid response from API (possibly network issue).

fix

Check network connectivity and API key validity. Retry the request.

Upgrade

Version history

1.2.44latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/TPEOficial/dymo-api-node ↗

packagedymo-api ↗

homepagehttps://dymo.tpeoficial.com ↗