sans-server

library2.0.3jsnpmunverified

Sans Server is a serverless framework that enables writing server-side code for a Connect-style request/response middleware pipeline without requiring an actual HTTP server. It is designed to simplify testing and development of middleware in a Node.js environment, with a current version of 2.0.3. Key differentiators include its focus on a Connect-compatible API and its ability to run middleware in isolation, reducing the need for server dependencies. Release cadence is low; the package has not been updated frequently in recent years.

devops

npm install sans-server

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SANS-SERVER

sans-server

devopsjavascriptv2.0.3

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.

SansServer

✓ import SansServer from 'sans-server'

✗ const SansServer = require('sans-server')

Default ES module import. CJS require works but may have issues with TypeScript typings.

SansServer.Request

✓ import { Request } from 'sans-server'

✗ import SansServer from 'sans-server'; const Request = SansServer.Request;

Named export for the Request class. Avoid using the default import's property.

SansServer.Response

✓ import { Response } from 'sans-server'

✗ import SansServer from 'sans-server'; const Response = SansServer.Response;

Named export for the Response class. Preferred over accessing via default import.

SansServer.createServer

✓ import { createServer } from 'sans-server'

✗ const createServer = require('sans-server').createServer

Function exported as a named export. Use ES module syntax for clarity.

Shows how to create a SansServer instance, add middleware, and simulate a request/response cycle programmatically without an HTTP server.

import SansServer, { createServer, Request, Response } from 'sans-server'; const server = new SansServer(); // Add middleware server.use('/api', (req, res) => { res.status(200).json({ message: 'Hello World' }); }); // Create a request const req = new Request({ method: 'GET', url: '/api', headers: {} }); const res = new Response(); // Process the request through middleware server.execute(req, res).then(() => { console.log(res.statusCode); // 200 console.log(res.body); // {"message":"Hello World"} });

Debug

Known issues

deprecatedSansServer is no longer actively maintained. It may not receive updates for security or compatibility.

fix

Consider migrating to a more actively maintained alternative like Express or a serverless framework.

affects: >=2.0.0

gotchaThe 'execute' method returns a Promise, but older documentation may suggest callbacks. Ensure you handle the promise correctly.

fix

Use async/await or .then() on the result of server.execute().

affects: >=2.0.0

gotchaSansServer does not support streaming request bodies. All request data must be fully buffered before processing.

fix

Use multiple middleware to buffer the request body if needed.

affects: >=2.0.0

Errors

Common errors & fixes

TypeError: SansServer is not a constructor

Using CJS require with a default import style.

fix

Use import SansServer from 'sans-server' for ES modules. If using CJS, use const SansServer = require('sans-server').default or use a bundler.

Cannot find module 'sans-server'

Package not installed or import path incorrect.

fix

Run npm install sans-server and ensure your import path is correct (e.g., 'sans-server' not './sans-server').

req.method is undefined

Creating a Request without specifying method property.

fix

Always pass a method in the request options, e.g., new Request({ method: 'GET', url: '/' }).

Upgrade

Version history

2.0.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/byu-oit/sans-server ↗

packagesans-server ↗

homepagehttps://github.com/byu-oit/sans-server#readme ↗