Registry /
http-networking / configurapi-handler-http
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
default
✓ import configurapiHttp from 'configurapi-handler-http'
✗ const configurapiHttp = require('configurapi-handler-http')
ESM-only package; CommonJS require is not supported.
createHandler
✓ import { createHandler } from 'configurapi-handler-http'
✗ import createHandler from 'configurapi-handler-http'
Named export; default export is the entire module object.
validateRequest
✓ import { validateRequest } from 'configurapi-handler-http'
✗ const { validateRequest } = require('configurapi-handler-http')
ESM only; named export.
ConfigurapiHttpError
✓ import { ConfigurapiHttpError } from 'configurapi-handler-http'
✗ import ConfigurapiHttpError from 'configurapi-handler-http'
Named export for error class.
RequestValidator
✓ import { RequestValidator } from 'configurapi-handler-http'
Named export for custom validator class.
Creates an Express handler that validates request body against a Configurapi schema and responds with a greeting.
import { createHandler } from 'configurapi-handler-http';
import express from 'express';
const app = express();
app.use(express.json());
const schema = {
type: 'object',
properties: {
name: { type: 'string' },
age: { type: 'number' }
},
required: ['name']
};
const handler = createHandler(schema, (req, res) => {
res.json({ message: `Hello, ${req.validatedBody.name}!` });
});
app.post('/greet', handler);
app.listen(3000);
console.log('Server running on port 3000');
Errors
Common errors & fixes
Error [ERR_REQUIRE_ESM]: require() of ES Module not supported.
Using CommonJS require() to import an ES module package.
fixUse import statement or set type: 'module' in package.json.
TypeError: handler is not a function
Incorrect import of default export instead of named export.
fixUse import { createHandler } from 'configurapi-handler-http' (named import). ConfigurapiSchemaError: Invalid schema at path '/'
Provided schema does not conform to Configurapi schema specification.
fixEnsure schema is constructed using configurapi's schema builder.
Cannot read properties of undefined (reading 'name')
Request body not parsed before handler, or validated body accessed incorrectly.
fixAdd body-parsing middleware and use req.validatedBody instead of req.body.
Audit
Dependencies
configurapirequiredCore Configurapi library for schema definition and validation