@stone-js/http-core NPM

Stone.js - HTTP Core

Maintenance

Stone.js HTTP Core offers a simple, consistent API for handling HTTP requests and responses across any JavaScript runtime.

Overview

The @stone-js/http-core package defines the foundational HTTP abstractions used throughout the Stone.js ecosystem. It introduces the IncomingHttpEvent and OutgoingHttpResponse classes, enabling context-aware handling of HTTP requests and responses in a runtime-agnostic way.

This module provides a normalized API for HTTP operations that works across adapters (Node.js, Lambda, etc.), serving as the bridge between the external runtime and the internal application logic.

Key Features

IncomingHttpEvent: A wrapper for incoming HTTP requests with support for headers, query, body, method, and cookies
OutgoingHttpResponse: A consistent abstraction for building and sending structured HTTP responses
First-class cookie handling with Cookie (secure, signed, or plain)
Support for headers, status codes, redirection, and JSON responses
Shared interfaces for request and response resolution across runtimes

All components are designed to be used within the Continuum Architecture of Stone.js, making them predictable, extensible, and runtime-neutral.

Installation

npm install @stone-js/http-core

[!IMPORTANT] This package is pure ESM. Ensure your package.json includes "type": "module" or configure your bundler appropriately.

Usage Example

import { IncomingHttpEvent, OutgoingHttpResponse } from '@stone-js/http-core'

// Simulate incoming request
const event = new IncomingHttpEvent({
  method: 'GET',
  url: URL.parse('https://example.com/api/resource'),
  headers: { 'x-custom-header': 'value' },
  body: {},
  queryString: 'param1=value1&param2=value2',
})

// Build response
const response = OutgoingHttpResponse.create({ content: { message: 'Hello from Stone.js' } })
response.setStatus(204)
response.setHeader('Content-Type', 'application/json')