@arkstack/http 0.3.15

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toneflix Technologies Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @arkstack/http
+
+Framework-neutral HTTP request and response wrappers for Arkstack shared packages.
+
+Use this package when code needs request data but should not import Express, H3, or another runtime directly.
+
+```ts
+import { Request, Response } from '@arkstack/http';
+
+const request = Request.from({
+  headers: {
+    authorization: 'Bearer token',
+  },
+  method: 'GET',
+  path: '/account',
+});
+
+const token = request.bearerToken();
+
+const response = new Response().status(200).json({ ok: true });
+```
+
+Runtime-specific handlers should continue to use their native framework request and response objects. Driver middleware can translate those objects into `@arkstack/http` wrappers when calling shared services.

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+//#region src/types/Http.d.ts
+type HeaderValue = string | string[] | number | boolean | null | undefined;
+type HeaderMap = Record<string, string>;
+type HeaderSource = Headers | Record<string, HeaderValue>;
+type RequestSource<TUser = unknown> = {
+  headers?: HeaderSource;
+  method?: string;
+  url?: string;
+  originalUrl?: string;
+  path?: string;
+  ip?: string;
+  user?: TUser;
+  authToken?: string;
+  req?: RequestSource<TUser>;
+  request?: RequestSource<TUser>;
+};
+type ResponseSource = {
+  statusCode?: number;
+  status?: number | ((code: number) => unknown);
+  headers?: HeaderSource;
+  setHeader?: (name: string, value: string) => unknown;
+  json?: (body: unknown) => unknown;
+  send?: (body: unknown) => unknown;
+};
+type RequestOptions<TUser = unknown> = {
+  headers?: HeaderSource;
+  method?: string;
+  url?: string;
+  path?: string;
+  ip?: string | null;
+  user?: TUser;
+  authToken?: string;
+  source?: unknown;
+};
+//#endregion
+//#region src/Request.d.ts
+declare class Request<TUser = unknown> {
+  readonly headers: HeaderMap;
+  readonly method?: string;
+  readonly url?: string;
+  readonly path?: string;
+  readonly ip: string | null;
+  readonly source?: unknown;
+  user?: TUser;
+  authToken?: string;
+  constructor(options?: RequestOptions<TUser>);
+  static from<TUser = unknown>(source?: Request<TUser> | RequestSource<TUser>): Request<TUser> | undefined;
+  header(name: string): string | undefined;
+  bearerToken(): string | null;
+  setUser(user: TUser): this;
+}
+//#endregion
+//#region src/Response.d.ts
+declare class Response<TBody = unknown> {
+  statusCode: number;
+  readonly headers: HeaderMap;
+  body?: TBody;
+  readonly source?: unknown;
+  constructor(options?: {
+    statusCode?: number;
+    headers?: HeaderSource;
+    body?: TBody;
+    source?: unknown;
+  });
+  static from<TBody = unknown>(source?: Response<TBody> | ResponseSource): Response<TBody> | undefined;
+  status(code: number): this;
+  header(name: string, value: string): this;
+  json(body: TBody): any;
+  send(body: TBody): any;
+}
+//#endregion
+//#region src/helpers.d.ts
+declare const unwrapRequestSource: <TUser>(source: RequestSource<TUser>) => RequestSource<TUser>;
+declare const normalizeHeaders: (headers?: HeaderSource) => HeaderMap;
+declare const normalizeHeaderValue: (value: HeaderValue) => string | undefined;
+declare const isHeaders: (value: unknown) => value is Headers;
+declare const isRecord: (value: unknown) => value is Record<string, any>;
+//#endregion
+export { HeaderMap, HeaderSource, HeaderValue, Request, RequestOptions, RequestSource, Response, ResponseSource, isHeaders, isRecord, normalizeHeaderValue, normalizeHeaders, unwrapRequestSource };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,139 @@
+//#region src/helpers.ts
+const unwrapRequestSource = (source) => {
+	if (source.headers) return source;
+	if (source.req) return source.req;
+	if (source.request) return source.request;
+	return source;
+};
+const normalizeHeaders = (headers) => {
+	const normalized = {};
+	if (!headers) return normalized;
+	if (isHeaders(headers)) {
+		headers.forEach((value, key) => {
+			normalized[key.toLowerCase()] = value;
+		});
+		return normalized;
+	}
+	for (const [key, value] of Object.entries(headers)) {
+		const normalizedValue = normalizeHeaderValue(value);
+		if (typeof normalizedValue === "string") normalized[key.toLowerCase()] = normalizedValue;
+	}
+	return normalized;
+};
+const normalizeHeaderValue = (value) => {
+	if (Array.isArray(value)) return value.join(", ");
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	return value ?? void 0;
+};
+const isHeaders = (value) => typeof Headers !== "undefined" && value instanceof Headers;
+const isRecord = (value) => typeof value === "object" && value !== null;
+
+//#endregion
+//#region src/Request.ts
+/**
+* Represents an HTTP request, providing a consistent interface for accessing request data.
+* 
+* @author 3m1n3nc3
+*/
+var Request = class Request {
+	headers;
+	method;
+	url;
+	path;
+	ip;
+	source;
+	user;
+	authToken;
+	constructor(options = {}) {
+		this.headers = normalizeHeaders(options.headers);
+		this.method = options.method;
+		this.url = options.url;
+		this.path = options.path;
+		this.ip = options.ip ?? null;
+		this.user = options.user;
+		this.authToken = options.authToken;
+		this.source = options.source;
+	}
+	static from(source) {
+		if (!source) return;
+		if (source instanceof Request) return source;
+		const request = unwrapRequestSource(source);
+		return new Request({
+			headers: request.headers,
+			method: request.method,
+			url: request.originalUrl ?? request.url,
+			path: request.path,
+			ip: request.ip ?? null,
+			user: request.user,
+			authToken: request.authToken,
+			source
+		});
+	}
+	header(name) {
+		return this.headers[name.toLowerCase()];
+	}
+	bearerToken() {
+		const authorization = this.header("authorization");
+		if (!authorization?.startsWith("Bearer ")) return null;
+		return authorization.substring(7);
+	}
+	setUser(user) {
+		this.user = user;
+		if (isRecord(this.source)) this.source.user = user;
+		return this;
+	}
+};
+
+//#endregion
+//#region src/Response.ts
+/**
+* Represents an HTTP response, providing a consistent interface for accessing response data.
+* 
+* @author 3m1n3nc3
+*/
+var Response = class Response {
+	statusCode;
+	headers;
+	body;
+	source;
+	constructor(options = {}) {
+		this.statusCode = options.statusCode ?? 200;
+		this.headers = normalizeHeaders(options.headers);
+		this.body = options.body;
+		this.source = options.source;
+	}
+	static from(source) {
+		if (!source) return;
+		if (source instanceof Response) return source;
+		return new Response({
+			statusCode: typeof source.status === "number" ? source.status : source.statusCode,
+			headers: source.headers,
+			source
+		});
+	}
+	status(code) {
+		this.statusCode = code;
+		if (isRecord(this.source)) if (typeof this.source.status === "function") this.source.status(code);
+		else this.source.statusCode = code;
+		return this;
+	}
+	header(name, value) {
+		this.headers[name.toLowerCase()] = value;
+		if (isRecord(this.source) && typeof this.source.setHeader === "function") this.source.setHeader(name, value);
+		return this;
+	}
+	json(body) {
+		this.body = body;
+		if (isRecord(this.source) && typeof this.source.json === "function") return this.source.json(body);
+		return body;
+	}
+	send(body) {
+		this.body = body;
+		if (isRecord(this.source) && typeof this.source.send === "function") return this.source.send(body);
+		return body;
+	}
+};
+
+//#endregion
+export { Request, Response, isHeaders, isRecord, normalizeHeaderValue, normalizeHeaders, unwrapRequestSource };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/helpers.ts","../src/Request.ts","../src/Response.ts"],"sourcesContent":["import { HeaderMap, HeaderSource, HeaderValue, RequestSource } from './types/Http'\n\nexport const unwrapRequestSource = <TUser> (\n    source: RequestSource<TUser>\n): RequestSource<TUser> => {\n    if (source.headers) {\n        return source\n    }\n\n    if (source.req) {\n        return source.req\n    }\n\n    if (source.request) {\n        return source.request\n    }\n\n    return source\n}\n\nexport const normalizeHeaders = (headers?: HeaderSource): HeaderMap => {\n    const normalized: HeaderMap = {}\n\n    if (!headers) {\n        return normalized\n    }\n\n    if (isHeaders(headers)) {\n        headers.forEach((value, key) => {\n            normalized[key.toLowerCase()] = value\n        })\n\n        return normalized\n    }\n\n    for (const [key, value] of Object.entries(headers)) {\n        const normalizedValue = normalizeHeaderValue(value)\n\n        if (typeof normalizedValue === 'string') {\n            normalized[key.toLowerCase()] = normalizedValue\n        }\n    }\n\n    return normalized\n}\n\nexport const normalizeHeaderValue = (value: HeaderValue) => {\n    if (Array.isArray(value)) {\n        return value.join(', ')\n    }\n\n    if (typeof value === 'number' || typeof value === 'boolean') {\n        return String(value)\n    }\n\n    return value ?? undefined\n}\n\nexport const isHeaders = (value: unknown): value is Headers => (\n    typeof Headers !== 'undefined' && value instanceof Headers\n)\n\nexport const isRecord = (value: unknown): value is Record<string, any> => (\n    typeof value === 'object' && value !== null\n)\n","import { HeaderMap, RequestOptions, RequestSource } from './types/Http'\nimport { isRecord, normalizeHeaders, unwrapRequestSource } from './helpers'\n\n/**\n * Represents an HTTP request, providing a consistent interface for accessing request data.\n * \n * @author 3m1n3nc3\n */\nexport class Request<TUser = unknown> {\n    readonly headers: HeaderMap\n    readonly method?: string\n    readonly url?: string\n    readonly path?: string\n    readonly ip: string | null\n    readonly source?: unknown\n    user?: TUser\n    authToken?: string\n\n    constructor(options: RequestOptions<TUser> = {}) {\n        this.headers = normalizeHeaders(options.headers)\n        this.method = options.method\n        this.url = options.url\n        this.path = options.path\n        this.ip = options.ip ?? null\n        this.user = options.user\n        this.authToken = options.authToken\n        this.source = options.source\n    }\n\n    static from<TUser = unknown> (\n        source?: Request<TUser> | RequestSource<TUser>\n    ): Request<TUser> | undefined {\n        if (!source) {\n            return undefined\n        }\n\n        if (source instanceof Request) {\n            return source\n        }\n\n        const request = unwrapRequestSource(source)\n\n        return new Request<TUser>({\n            headers: request.headers,\n            method: request.method,\n            url: request.originalUrl ?? request.url,\n            path: request.path,\n            ip: request.ip ?? null,\n            user: request.user,\n            authToken: request.authToken,\n            source,\n        })\n    }\n\n    header (name: string): string | undefined {\n        return this.headers[name.toLowerCase()]\n    }\n\n    bearerToken (): string | null {\n        const authorization = this.header('authorization')\n\n        if (!authorization?.startsWith('Bearer ')) {\n            return null\n        }\n\n        return authorization.substring(7)\n    }\n\n    setUser (user: TUser) {\n        this.user = user\n\n        if (isRecord(this.source)) {\n            this.source.user = user\n        }\n\n        return this\n    }\n}","import { HeaderMap, HeaderSource, ResponseSource } from './types/Http'\nimport { isRecord, normalizeHeaders } from './helpers'\n\n/**\n * Represents an HTTP response, providing a consistent interface for accessing response data.\n * \n * @author 3m1n3nc3\n */\nexport class Response<TBody = unknown> {\n    statusCode: number\n    readonly headers: HeaderMap\n    body?: TBody\n    readonly source?: unknown\n\n    constructor(options: {\n        statusCode?: number;\n        headers?: HeaderSource;\n        body?: TBody;\n        source?: unknown;\n    } = {}) {\n        this.statusCode = options.statusCode ?? 200\n        this.headers = normalizeHeaders(options.headers)\n        this.body = options.body\n        this.source = options.source\n    }\n\n    static from<TBody = unknown> (\n        source?: Response<TBody> | ResponseSource\n    ): Response<TBody> | undefined {\n        if (!source) {\n            return undefined\n        }\n\n        if (source instanceof Response) {\n            return source\n        }\n\n        return new Response<TBody>({\n            statusCode: typeof source.status === 'number' ? source.status : source.statusCode,\n            headers: source.headers,\n            source,\n        })\n    }\n\n    status (code: number) {\n        this.statusCode = code\n\n        if (isRecord(this.source)) {\n            if (typeof this.source.status === 'function') {\n                this.source.status(code)\n            } else {\n                this.source.statusCode = code\n            }\n        }\n\n        return this\n    }\n\n    header (name: string, value: string) {\n        this.headers[name.toLowerCase()] = value\n\n        if (isRecord(this.source) && typeof this.source.setHeader === 'function') {\n            this.source.setHeader(name, value)\n        }\n\n        return this\n    }\n\n    json (body: TBody) {\n        this.body = body\n\n        if (isRecord(this.source) && typeof this.source.json === 'function') {\n            return this.source.json(body)\n        }\n\n        return body\n    }\n\n    send (body: TBody) {\n        this.body = body\n\n        if (isRecord(this.source) && typeof this.source.send === 'function') {\n            return this.source.send(body)\n        }\n\n        return body\n    }\n}"],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@arkstack/http",
+  "version": "0.3.15",
+  "type": "module",
+  "description": "Framework-agnostic HTTP request and response primitives for Arkstack.",
+  "homepage": "https://arkstack.toneflix.net",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arkstack-hq/arkstack.git",
+    "directory": "packages/http"
+  },
+  "keywords": [
+    "http",
+    "request",
+    "response",
+    "adapter",
+    "arkstack"
+  ],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader unconfig",
+    "version:patch": "pnpm version patch"
+  }
+}