Registry /
database / express-idempotency-mongo-adapter
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.
newAdapter
✓ const { newAdapter } = require('express-idempotency-mongo-adapter');
✗ const MongoAdapter = require('express-idempotency-mongo-adapter').default;
CommonJS default export is an object with newAdapter method. No default export.
MongoAdapter
✓ import { MongoAdapter } from 'express-idempotency-mongo-adapter';
✗ import MongoAdapter from 'express-idempotency-mongo-adapter';
TypeScript/ESM: Named import, not default. The package is CJS but has type definitions.
AdapterOptions
✓ import type { AdapterOptions } from 'express-idempotency-mongo-adapter';
Type-only import for configuration options.
Initialize express-idempotency with MongoDB adapter using URI configuration.
const express = require('express');
const idempotency = require('express-idempotency');
const { newAdapter } = require('express-idempotency-mongo-adapter');
const app = express();
app.use(express.json());
const adapter = newAdapter({
config: {
uri: process.env.MONGO_URI ?? 'mongodb://localhost:27017',
settings: { useNewUrlParser: true, useUnifiedTopology: true }
}
});
app.use(idempotency.idempotency({
dataAdapter: adapter
}));
app.post('/api/orders', (req, res) => {
res.json({ status: 'ok' });
});
app.listen(3000);
Errors
Common errors & fixes
Cannot find module 'express-idempotency'
Peer dependency express-idempotency not installed.
fixnpm install express-idempotency
MongoAdapter.newAdapter is not a function
Using incorrect import pattern (e.g., requiring default export instead of destructuring).
fixconst { newAdapter } = require('express-idempotency-mongo-adapter'); TypeError: Cannot read property 'idempotency' of undefined
express-idempotency not installed or incorrectly required.
fixEnsure express-idempotency is installed and required correctly.
MongoTimeoutError: Server selection timed out after 30000 ms
MongoDB URI incorrect or server unreachable.
fixCheck MONGO_URI environment variable or ensure MongoDB is running on the specified host.
Audit
Dependencies
express-idempotencyrequiredCore middleware that this adapter works with
mongodbrequiredMongoDB driver for database operations