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.
createAuthMiddleware
✓ const createAuthMiddleware = require('cf-auth-middleware')
✗ import createAuthMiddleware from 'cf-auth-middleware'
Package is CommonJS-only; no default ESM export. Use require().
middleware (returned by createAuthMiddleware)
✓ const authMiddleware = createAuthMiddleware(authProvider, options)
✗ const authMiddleware = createAuthMiddleware()
authProvider is mandatory; options is optional.
createAuthMiddleware (as named import attempt)
✓ const createAuthMiddleware = require('cf-auth-middleware')
✗ const { createAuthMiddleware } = require('cf-auth-middleware')
Export is a single function directly, not an object with named property.
Shows basic setup: create auth middleware with provider and apply to a route.
var express = require('express');
var createAuthMiddleware = require('cf-auth-middleware');
var authProvider = require('cf-auth-provider')(myCollection, hashFn);
var app = express();
var authMiddleware = createAuthMiddleware(authProvider, {
reqProperty: 'user',
logger: console
});
app.get('/private', authMiddleware, function (req, res) {
res.send(`Hello ${req.user || 'unknown'}`);
});
app.listen(3000);
Errors
Common errors & fixes
TypeError: createAuthMiddleware is not a function
Using ES6 import syntax with CommonJS package.
fixReplace import with const createAuthMiddleware = require('cf-auth-middleware'); Error: authentication failed - missing x-cf-date header
Request missing required date header or query parameter.
fixEnsure client includes x-cf-date in header or query string.
TypeError: Cannot read property 'debug' of undefined
options.logger is missing required methods (debug, info, warn, error).
fixProvide a logger object with those methods or omit (defaults to console).
Audit
Dependencies
cf-auth-providerrequiredPeer dependency providing authentication logic