Registry / http-networking / create-server

create-server

JSON →
library1.0.2jsnpmunverified

The `create-server` package provides a unified API for establishing HTTP, HTTPS, and SPDY servers in Node.js, aiming to simplify common server setup patterns. It handles the boilerplate for configuring server instances, including providing a callback-based interface for various server events (close, request, upgrade, listening, error, etc.). The library, last updated in April 2019 at version 1.0.2, notably features built-in 'sane defaults' for security against older threats like POODLE and Heartbleed, and allows custom overrides for ciphers and protocols. However, its primary differentiator, SPDY support, is now largely obsolete in favor of HTTP/2 and HTTP/3. Given its age, the package is likely to lack support for modern JavaScript features like native ESM and may contain security defaults that are no longer considered best practice against contemporary threats.

http-networkingweb-frameworkauth-security
npm install create-server
github ↗package ↗
INSTALL
IMPORT
SIG · CREATE-SERVER
C
create-server
http-networkingjavascriptv1.0.2
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
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
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

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

create
✓ const create = require('create-server');
✗ import create from 'create-server';
This package primarily uses CommonJS `require()`. While Node.js might attempt to load it with `import`, it is not designed for native ESM use.
createServer
✓ const create = require('create-server'); // Then use `create` function
✗ import { createServer } from 'create-server';
The module exports a single function as its default, not named exports. The variable name `create` is a convention used in the documentation.

Demonstrates creating a basic HTTP server using `create-server` on port 3000, handling incoming requests, and logging server events. Includes graceful shutdown.

const create = require('create-server'); const http = require('http'); // Node.js built-in HTTP module const server = create({ port: process.env.PORT || 3000, hostname: '127.0.0.1', // Optional: redirect HTTP to HTTPS // redirect: 80, // For HTTPS/SPDY, you'd add 'key', 'cert', 'ca', 'spdy: true' options }, { request: function (req, res) { console.log(`Received request for: ${req.url}`); res.writeHead(200, { 'Content-Type': 'text/plain' }); res.end('Hello from create-server!\n'); }, listening: function (err) { if (err) { console.error('Server failed to start:', err); return; } console.log(`Server listening on http://${server.hostname}:${server.port}`); }, error: function (err) { console.error('Server error:', err); } }); // To stop the server gracefully process.on('SIGINT', () => { console.log('Stopping server...'); server.close(() => { console.log('Server stopped.'); process.exit(0); }); });
Debug
Known issues
breakingThe SPDY protocol, a key feature of this library, has been largely deprecated in favor of HTTP/2 and HTTP/3. Relying on SPDY functionality will result in compatibility issues with modern clients and proxies.
fix
Migrate to servers supporting HTTP/2 or HTTP/3, such as Node.js's built-in `http2` module or newer web frameworks, rather than relying on SPDY.
affects: >=1.0.0
gotchaThe 'sane defaults' for secure server configuration mentioned in the README address older vulnerabilities like POODLE and Heartbleed. These defaults may be outdated and insufficient to protect against modern security threats. Custom cipher lists (`cypher`), `secureProtocol`, and `secureOptions` should be thoroughly reviewed.
fix
Manually audit and update TLS cipher suites, protocols, and options to align with current best practices for server security (e.g., using TLS 1.3, strong ciphers).
affects: >=1.0.0
gotchaThe package uses CommonJS `require()` syntax exclusively in its documentation and examples. It is unlikely to have native ES module (ESM) support, which can cause issues in modern Node.js projects configured for ESM.
fix
Ensure your project is configured for CommonJS, or use dynamic `import()` if absolutely necessary within an ESM context, understanding the interoperability limitations.
affects: >=1.0.0
gotchaWhen configuring HTTPS or SPDY servers, certificate paths (`key`, `cert`, `ca`, `pfx`, `crl`) are specified relative to the `root` option. Incorrect `root` paths or malformed relative paths can lead to server startup failures.
fix
Always provide absolute paths for certificate files or carefully verify the `root` directory and relative paths. Ensure files are readable by the Node.js process.
affects: >=1.0.0
Errors
Common errors & fixes
Error: listen EADDRINUSE: address already in use :::3000
The specified port (e.g., 3000) is already being used by another process on the system.
fix
Change the `port` configuration to an available port number, or terminate the process currently using that port.
Error: Cannot find module 'spdy'
The `spdy` option was set to `true` to create an SPDY server, but the `spdy` package itself was not installed as a dependency.
fix
Install the `spdy` package: `npm install spdy` or remove the `spdy: true` option if SPDY is not intended.
Error: ENOENT: no such file or directory, open '/path/to/server.key'
The server failed to locate or read one of the specified certificate or key files (e.g., `key`, `cert`, `ca`, `pfx`, `crl`). This often happens with incorrect `root` paths or file permissions.
fix
Verify that the `root` option points to the correct base directory and that all certificate/key file paths (relative or absolute) are accurate. Ensure the Node.js process has read permissions for these files.
Upgrade
Version history
1.0.2latest on npm
Audit
Dependencies
spdyoptionalRequired if the 'spdy' option is set to true for creating an SPDY server.
Agent activity
13 hits · last 30 days
node
12
OpenAI (training)
1
Resources
githubhttps://github.com/primus/create-server ↗
packagehttps://www.npmjs.com/package/create-server ↗