@edumalin/platform 3.0.0

package/dist/esm/http/client/progress/http-client-response-to-http-client-response-with-progress.js

@@ -0,0 +1,31 @@
+import { map, ReplaySubject, scan } from 'rxjs';
+import { fetchResponseSymbol } from '../response/fetch-response-symbol.js';
+import { controllerToResponseProgressChunks } from './controller-to-response-progress-chunks.js';
+import { responseProgressChunkToResponseProgress } from './response-progress-chunk-to-response-progress.js';
+import { ResponseProgressUnderlyingSource } from './response-progress-underlying-source.js';
+export function httpClientResponseToHttpClientResponseWithProgress(httpClientResponse) {
+    const { [fetchResponseSymbol]: response } = httpClientResponse;
+    const { body, headers, status } = response;
+    if (body === null) {
+        throw new Error(`TODO: handle null body in httpClientResponseToHttpClientResponseWithProgress`);
+    }
+    const contentLengthString = headers.get('content-length') ?? undefined;
+    const contentLength = Number(contentLengthString);
+    const bytesTotal = !isNaN(contentLength) ? contentLength : undefined;
+    const reader = body.getReader();
+    const progressBytes = new ReplaySubject(1);
+    const underlyingSource = new ResponseProgressUnderlyingSource(controllerToResponseProgressChunks(reader, progressBytes));
+    const stream = new ReadableStream(underlyingSource);
+    const responseWithStream = new Response(stream, { headers, status });
+    const httpClientResponseWithStream = {
+        headers: httpClientResponse.headers,
+        status: httpClientResponse.status,
+        [fetchResponseSymbol]: responseWithStream,
+    };
+    const initialResponseProgress = {
+        bytesPerSecond: 0,
+        ...(bytesTotal !== undefined ? { bytesTotal } : {}),
+        bytesTransferred: 0,
+    };
+    return progressBytes.asObservable().pipe(scan(responseProgressChunkToResponseProgress, [initialResponseProgress]), map(([responseProgress, chunk]) => [httpClientResponseWithStream, responseProgress, chunk]));
+}

package/dist/esm/http/client/progress/http-client-response-with-progress-to-bytes.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponseWithProgress } from './http-client-response-with-progress.js';
+export declare function httpClientResponseWithProgressToBytes(httpClientResponse: HttpClientResponseWithProgress): Uint8Array;

package/dist/esm/http/client/progress/http-client-response-with-progress-to-bytes.js

@@ -0,0 +1,4 @@
+export function httpClientResponseWithProgressToBytes(httpClientResponse) {
+    const [, , bytes] = httpClientResponse;
+    return bytes;
+}

package/dist/esm/http/client/progress/http-client-response-with-progress.d.ts

@@ -0,0 +1,7 @@
+import { type HttpClientResponse } from '../response/http-client-response.js';
+import { type HttpClientResponseProgress } from './http-client-response-progress.js';
+export type HttpClientResponseWithProgress = readonly [
+    response: HttpClientResponse,
+    responseProgress: HttpClientResponseProgress,
+    bytes: Uint8Array
+];

package/dist/esm/http/client/progress/http-client-response-with-progress.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/progress/response-progress-chunk-to-response-progress.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponseProgress } from './http-client-response-progress.js';
+export declare function responseProgressChunkToResponseProgress(progress: readonly [responseProgress: HttpClientResponseProgress, chunk: Uint8Array], chunk: Uint8Array): readonly [responseProgress: HttpClientResponseProgress, chunk: Uint8Array];

package/dist/esm/http/client/progress/response-progress-chunk-to-response-progress.js

@@ -0,0 +1,16 @@
+export function responseProgressChunkToResponseProgress(progress, chunk) {
+    const [{ bytesTotal, bytesTransferred: bytesPreviouslyTransferred }] = progress;
+    const chunkLength = chunk.length;
+    const bytesTransferred = (bytesPreviouslyTransferred ?? 0) + chunkLength;
+    const knownTotal = bytesTotal !== undefined;
+    const bytesRemaining = knownTotal ? bytesTotal - bytesTransferred : undefined;
+    const completionPercentage = knownTotal ? bytesTransferred / bytesTotal : undefined;
+    const responseProgress = {
+        bytesPerSecond: 0,
+        ...(bytesRemaining !== undefined ? { bytesRemaining } : {}),
+        ...(bytesTotal !== undefined ? { bytesTotal } : {}),
+        bytesTransferred,
+        ...(completionPercentage !== undefined ? { completionPercentage } : {}),
+    };
+    return [responseProgress, chunk];
+}

package/dist/esm/http/client/progress/response-progress-underlying-source.d.ts

@@ -0,0 +1,5 @@
+export declare class ResponseProgressUnderlyingSource implements UnderlyingSource<Uint8Array> {
+    private readonly project;
+    constructor(project: (controller: ReadableStreamController<Uint8Array>) => void);
+    start(controller: ReadableStreamController<Uint8Array>): void | PromiseLike<void>;
+}

package/dist/esm/http/client/progress/response-progress-underlying-source.js

@@ -0,0 +1,9 @@
+export class ResponseProgressUnderlyingSource {
+    project;
+    constructor(project) {
+        this.project = project;
+    }
+    start(controller) {
+        this.project(controller);
+    }
+}

package/dist/esm/http/client/request/http-client-request-options.d.ts

@@ -0,0 +1,3 @@
+export type HttpClientRequestOptions = Readonly<Omit<RequestInit, 'headers' | 'method' | 'signal'>> & {
+    readonly dispatcher?: unknown;
+};

package/dist/esm/http/client/request/http-client-request-options.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/request/http-client-request.d.ts

@@ -0,0 +1,8 @@
+import { type HttpHeader, type HttpMethod } from '@edumalin/platform/http';
+import { type HttpClientRequestOptions } from './http-client-request-options.js';
+export interface HttpClientRequest {
+    readonly headers?: ReadonlyArray<HttpHeader>;
+    readonly method?: HttpMethod;
+    readonly options?: Partial<HttpClientRequestOptions>;
+    readonly url: URL;
+}

package/dist/esm/http/client/request/http-client-request.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/response/fetch-response-symbol.d.ts

@@ -0,0 +1 @@
+export declare const fetchResponseSymbol: unique symbol;

package/dist/esm/http/client/response/fetch-response-symbol.js

@@ -0,0 +1 @@
+export const fetchResponseSymbol = Symbol('@edumalin/platform/http/client:response');

package/dist/esm/http/client/response/http-client-response-status-is-options.d.ts

@@ -0,0 +1,7 @@
+import { type HttpStatus } from '@edumalin/platform/http';
+export type HttpClientResponseStatusIsOptions = {
+    readonly minimum: number;
+    readonly maximum?: number;
+} | {
+    readonly oneOf: ReadonlyArray<HttpStatus>;
+};

package/dist/esm/http/client/response/http-client-response-status-is-options.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/response/http-client-response-status-is.d.ts

@@ -0,0 +1,3 @@
+import { type HttpClientResponse } from './http-client-response.js';
+import { type HttpClientResponseStatusIsOptions } from './http-client-response-status-is-options.js';
+export declare function httpClientResponseStatusIs(options: HttpClientResponseStatusIsOptions): (response: HttpClientResponse) => boolean;

package/dist/esm/http/client/response/http-client-response-status-is.js

@@ -0,0 +1,10 @@
+export function httpClientResponseStatusIs(options) {
+    if ('minimum' in options) {
+        const { minimum, maximum = Number.MAX_SAFE_INTEGER } = options;
+        return ({ status }) => minimum <= status && status <= maximum;
+    }
+    else {
+        const statuses = new Set(options.oneOf);
+        return ({ status }) => statuses.has(status);
+    }
+}

package/dist/esm/http/client/response/http-client-response-to-array-buffer.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponse } from './http-client-response.js';
+export declare function httpClientResponseToArrayBuffer(): (response: HttpClientResponse) => Observable<ArrayBuffer>;

package/dist/esm/http/client/response/http-client-response-to-array-buffer.js

@@ -0,0 +1,5 @@
+import { defer } from 'rxjs';
+import { fetchResponseSymbol } from './fetch-response-symbol.js';
+export function httpClientResponseToArrayBuffer() {
+    return response => defer(() => response[fetchResponseSymbol].arrayBuffer());
+}

package/dist/esm/http/client/response/http-client-response-to-blob.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponse } from './http-client-response.js';
+export declare function httpClientResponseToBlob(): (response: HttpClientResponse) => Observable<Blob>;

package/dist/esm/http/client/response/http-client-response-to-blob.js

@@ -0,0 +1,5 @@
+import { defer } from 'rxjs';
+import { fetchResponseSymbol } from './fetch-response-symbol.js';
+export function httpClientResponseToBlob() {
+    return response => defer(() => response[fetchResponseSymbol].blob());
+}

package/dist/esm/http/client/response/http-client-response-to-json-stream-options.d.ts

@@ -0,0 +1,3 @@
+export interface HttpClientResponseToJsonStreamOptions {
+    readonly paths?: ReadonlyArray<string>;
+}

package/dist/esm/http/client/response/http-client-response-to-json-stream-options.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/response/http-client-response-to-json-stream.d.ts

@@ -0,0 +1,4 @@
+import { Observable } from 'rxjs';
+import { type HttpClientResponse } from './http-client-response.js';
+import { type HttpClientResponseToJsonStreamOptions } from './http-client-response-to-json-stream-options.js';
+export declare function httpClientResponseToJsonStream<T = unknown>(options?: HttpClientResponseToJsonStreamOptions): (response: HttpClientResponse) => Observable<T>;

package/dist/esm/http/client/response/http-client-response-to-json-stream.js

@@ -0,0 +1,35 @@
+import { JSONParser } from '@streamparser/json-whatwg';
+import { EMPTY, Observable } from 'rxjs';
+import { fetchResponseSymbol } from './fetch-response-symbol.js';
+export function httpClientResponseToJsonStream(options) {
+    const { paths = ['$.*'] } = options ?? {};
+    const keepStack = false;
+    return response => {
+        const { body } = response[fetchResponseSymbol];
+        if (body === null) {
+            return EMPTY;
+        }
+        return new Observable(subscriber => {
+            const jsonParser = new JSONParser({ keepStack, paths: [...paths] });
+            const reader = body.pipeThrough(jsonParser).getReader();
+            (async () => {
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done) {
+                            subscriber.complete();
+                            break;
+                        }
+                        subscriber.next(value.value);
+                    }
+                }
+                catch (error) {
+                    subscriber.error(error);
+                }
+            })();
+            subscriber.add(() => {
+                void reader.cancel();
+            });
+        });
+    };
+}

package/dist/esm/http/client/response/http-client-response-to-json.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponse } from './http-client-response.js';
+export declare function httpClientResponseToJson<T = unknown>(validator?: (json: unknown) => T | Observable<T>): (response: HttpClientResponse) => Observable<T>;

package/dist/esm/http/client/response/http-client-response-to-json.js

@@ -0,0 +1,11 @@
+import { asObservable } from '@edumalin/platform/reactive';
+import { defer, mergeMap } from 'rxjs';
+import { fetchResponseSymbol } from './fetch-response-symbol.js';
+export function httpClientResponseToJson(validator) {
+    return validator !== undefined
+        ? response => defer(() => response[fetchResponseSymbol].json()).pipe(mergeMap(json => {
+            const result = validator(json);
+            return asObservable(result);
+        }))
+        : response => defer(() => response[fetchResponseSymbol].json());
+}

package/dist/esm/http/client/response/http-client-response-to-text.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponse } from './http-client-response.js';
+export declare function httpClientResponseToText(): (response: HttpClientResponse) => Observable<string>;

package/dist/esm/http/client/response/http-client-response-to-text.js

@@ -0,0 +1,5 @@
+import { defer } from 'rxjs';
+import { fetchResponseSymbol } from './fetch-response-symbol.js';
+export function httpClientResponseToText() {
+    return response => defer(() => response[fetchResponseSymbol].text());
+}

package/dist/esm/http/client/response/http-client-response.d.ts

@@ -0,0 +1,7 @@
+import { type HttpHeader, type HttpStatus } from '@edumalin/platform/http';
+import { type fetchResponseSymbol } from './fetch-response-symbol.js';
+export interface HttpClientResponse {
+    readonly headers: ReadonlyArray<HttpHeader>;
+    readonly status: HttpStatus;
+    readonly [fetchResponseSymbol]: Response;
+}

package/dist/esm/http/client/response/http-client-response.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/response/response-to-http-client-response.d.ts

@@ -0,0 +1,2 @@
+import { type HttpClientResponse } from './http-client-response.js';
+export declare function responseToHttpClientResponse(response: Response): HttpClientResponse;

package/dist/esm/http/client/response/response-to-http-client-response.js

@@ -0,0 +1,11 @@
+import { fetchHeaderToHttpHeader } from '../header/fetch-header-to-http-header.js';
+import { fetchResponseSymbol } from './fetch-response-symbol.js';
+export function responseToHttpClientResponse(response) {
+    const { status } = response;
+    const headers = Array.from(response.headers.entries(), fetchHeaderToHttpHeader);
+    return {
+        headers,
+        status,
+        [fetchResponseSymbol]: response,
+    };
+}

package/dist/esm/http/client/response/url-to-http-client-response.d.ts

@@ -0,0 +1,4 @@
+import { type HttpClient } from '../http-client.js';
+import { type HttpClientRequest } from '../request/http-client-request.js';
+import { type HttpClientResponse } from './http-client-response.js';
+export declare function urlToHttpClientResponse(httpClient: HttpClient, httpClientRequest?: Omit<HttpClientRequest, 'url'>): (url: URL) => Observable<HttpClientResponse>;

package/dist/esm/http/client/response/url-to-http-client-response.js

@@ -0,0 +1,4 @@
+export function urlToHttpClientResponse(httpClient, httpClientRequest) {
+    const defaultOptions = httpClientRequest ?? {};
+    return url => httpClient({ ...defaultOptions, url });
+}

package/dist/esm/http/client/testing/create-test-http-client.d.ts

@@ -0,0 +1,3 @@
+import { type TestHttpClient } from './test-http-client.js';
+import { type TestHttpClientOptions } from './test-http-client-options.js';
+export declare function createTestHttpClient(clientOptions?: TestHttpClientOptions): TestHttpClient;

package/dist/esm/http/client/testing/create-test-http-client.js

@@ -0,0 +1,17 @@
+import { objectWithProperties } from '@edumalin/platform/functional';
+import { of } from 'rxjs';
+export function createTestHttpClient(clientOptions) {
+    const httpClientRequests = [];
+    const response = clientOptions?.response;
+    const func = request => {
+        httpClientRequests.push(request);
+        return of(response);
+    };
+    const clear = () => {
+        httpClientRequests.splice(0, httpClientRequests.length);
+    };
+    return objectWithProperties({
+        httpClientRequests,
+        clear,
+    })(func);
+}

package/dist/esm/http/client/testing/index.d.ts

@@ -0,0 +1,3 @@
+export { createTestHttpClient } from './create-test-http-client.js';
+export { type TestHttpClient } from './test-http-client.js';
+export { type TestHttpClientOptions } from './test-http-client-options.js';

package/dist/esm/http/client/testing/index.js

@@ -0,0 +1 @@
+export { createTestHttpClient } from './create-test-http-client.js';

package/dist/esm/http/client/testing/test-http-client-options.d.ts

@@ -0,0 +1,3 @@
+export interface TestHttpClientOptions {
+    readonly response?: unknown;
+}

package/dist/esm/http/client/testing/test-http-client-options.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/client/testing/test-http-client.d.ts

@@ -0,0 +1,5 @@
+import { type HttpClient, type HttpClientRequest } from '@edumalin/platform/http/client';
+export interface TestHttpClient extends HttpClient {
+    readonly httpClientRequests: ReadonlyArray<HttpClientRequest>;
+    clear(): void;
+}

package/dist/esm/http/client/testing/test-http-client.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/cookie/http-cookie.d.ts

@@ -0,0 +1,13 @@
+import { type HttpCookieSameSiteOption } from './same-site-option/http-cookie-same-site-option.js';
+export interface HttpCookie {
+    readonly domain?: string;
+    readonly expires?: Temporal.ZonedDateTime;
+    readonly httpOnly: boolean;
+    readonly maxAge?: number;
+    readonly name: string;
+    readonly partitioned?: boolean;
+    readonly path: string;
+    readonly sameSite?: HttpCookieSameSiteOption;
+    readonly secure: boolean;
+    readonly value: string;
+}

package/dist/esm/http/cookie/http-cookie.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/cookie/is-session-http-cookie.d.ts

@@ -0,0 +1,2 @@
+import { type HttpCookie } from './http-cookie.js';
+export declare function isSessionHttpCookie(httpCookie: HttpCookie): boolean;

package/dist/esm/http/cookie/is-session-http-cookie.js

@@ -0,0 +1,4 @@
+export function isSessionHttpCookie(httpCookie) {
+    const { expires, maxAge } = httpCookie;
+    return expires === undefined && maxAge === undefined;
+}

package/dist/esm/http/cookie/same-site-option/http-cookie-same-site-option.d.ts

@@ -0,0 +1,2 @@
+import { type httpCookieSameSiteOptions } from './http-cookie-same-site-options.js';
+export type HttpCookieSameSiteOption = (typeof httpCookieSameSiteOptions)[number];

package/dist/esm/http/cookie/same-site-option/http-cookie-same-site-option.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/cookie/same-site-option/http-cookie-same-site-options.d.ts

@@ -0,0 +1 @@
+export declare const httpCookieSameSiteOptions: readonly ["Lax", "None", "Strict"];

package/dist/esm/http/cookie/same-site-option/http-cookie-same-site-options.js

@@ -0,0 +1 @@
+export const httpCookieSameSiteOptions = ['Lax', 'None', 'Strict'];

package/dist/esm/http/cookie/same-site-option/is-http-cookie-same-site-option.d.ts

@@ -0,0 +1,2 @@
+import { type HttpCookieSameSiteOption } from './http-cookie-same-site-option.js';
+export declare function isHttpCookieSameSiteOption(value: string): value is HttpCookieSameSiteOption;

package/dist/esm/http/cookie/same-site-option/is-http-cookie-same-site-option.js

@@ -0,0 +1,5 @@
+import { httpCookieSameSiteOptions } from './http-cookie-same-site-options.js';
+export function isHttpCookieSameSiteOption(value) {
+    return set.has(value);
+}
+const set = new Set(httpCookieSameSiteOptions);

package/dist/esm/http/cookie/same-site-option/validate-http-cookie-same-site-option.d.ts

@@ -0,0 +1,2 @@
+import { type HttpCookieSameSiteOption } from './http-cookie-same-site-option.js';
+export declare function validateHttpCookieSameSiteOption(value: string): asserts value is HttpCookieSameSiteOption;

package/dist/esm/http/cookie/same-site-option/validate-http-cookie-same-site-option.js

@@ -0,0 +1,7 @@
+import { httpError } from '../../http.error.js';
+import { isHttpCookieSameSiteOption } from './is-http-cookie-same-site-option.js';
+export function validateHttpCookieSameSiteOption(value) {
+    if (!isHttpCookieSameSiteOption(value)) {
+        throw httpError.invalidCookieSameSiteOption({ value });
+    }
+}

package/dist/esm/http/error/invalid-cookie-header-value-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidCookieHeaderValueErrorProperties {
+    readonly value: string;
+}

package/dist/esm/http/error/invalid-cookie-header-value-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/error/invalid-cookie-same-site-option-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidCookieSameSiteOptionErrorProperties {
+    readonly value: string;
+}

package/dist/esm/http/error/invalid-cookie-same-site-option-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/error/invalid-http-header-name-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidHttpHeaderNameErrorProperties {
+    readonly value: string;
+}

package/dist/esm/http/error/invalid-http-header-name-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/error/invalid-http-method-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidHttpMethodErrorProperties {
+    readonly value: string;
+}

package/dist/esm/http/error/invalid-http-method-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/error/invalid-http-status-error-properties.d.ts

@@ -0,0 +1,3 @@
+export interface InvalidHttpStatusErrorProperties {
+    readonly value: number;
+}

package/dist/esm/http/error/invalid-http-status-error-properties.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/header/authorization/parse-authorization-header-value.d.ts

@@ -0,0 +1 @@
+export declare function parseAuthorizationHeaderValue(authorizationHeaderValue: string): readonly [authScheme: string, value: string] | undefined;

package/dist/esm/http/header/authorization/parse-authorization-header-value.js

@@ -0,0 +1,9 @@
+export function parseAuthorizationHeaderValue(authorizationHeaderValue) {
+    const matches = authorizationRegExp.exec(authorizationHeaderValue);
+    if (!matches) {
+        return undefined;
+    }
+    const [, authScheme, value] = matches;
+    return [authScheme, value];
+}
+const authorizationRegExp = /^([^\s]+) (.+)$/;

package/dist/esm/http/header/by-http-header-name.d.ts

@@ -0,0 +1,3 @@
+import { type HttpHeader } from './http-header.js';
+import { type HttpHeaderName } from './name/http-header-name.js';
+export declare function byHttpHeaderName(headerName: HttpHeaderName | (string & {})): (httpHeader: HttpHeader) => boolean;

package/dist/esm/http/header/by-http-header-name.js

@@ -0,0 +1,3 @@
+export function byHttpHeaderName(headerName) {
+    return ([name]) => name.toLocaleLowerCase() === headerName.toLocaleLowerCase();
+}

package/dist/esm/http/header/cookie/create-set-cookie-http-header.d.ts

@@ -0,0 +1,3 @@
+import { type HttpCookie } from '../../cookie/http-cookie.js';
+import { type HttpHeader } from '../http-header.js';
+export declare function createSetCookieHttpHeader(httpCookie: Pick<HttpCookie, 'name' | 'value'> & Partial<Omit<HttpCookie, 'name' | 'value'>>): HttpHeader;

package/dist/esm/http/header/cookie/create-set-cookie-http-header.js

@@ -0,0 +1,21 @@
+export function createSetCookieHttpHeader(httpCookie) {
+    const nameValuePair = httpCookieToHttpHeaderNameValuePair(httpCookie);
+    const { domain, expires, httpOnly, maxAge, partitioned, path, sameSite, secure } = httpCookie;
+    const properties = [
+        nameValuePair,
+        ...(domain !== undefined ? [`Domain=${domain}`] : []),
+        ...(expires !== undefined ? [`Expires=${expires}`] : []),
+        ...(httpOnly ? [`HttpOnly`] : []),
+        ...(maxAge !== undefined ? [`Max-Age=${maxAge}`] : []),
+        ...(partitioned ? ['Partitioned'] : []),
+        ...(path !== undefined ? [`Path=${path}`] : []),
+        ...(sameSite !== undefined ? [`SameSite=${sameSite}`] : []),
+        ...(secure ? [`Secure`] : []),
+    ];
+    const value = properties.join('; ');
+    return ['set-cookie', value];
+}
+function httpCookieToHttpHeaderNameValuePair(httpCookie) {
+    const { name, value } = httpCookie;
+    return `${name}=${value}`;
+}

package/dist/esm/http/header/cookie/parse-cookie-header-value.d.ts

@@ -0,0 +1,2 @@
+import { type ReadonlyRecord } from '@edumalin/platform/typescript';
+export declare function parseCookieHeaderValue(cookieHeaderValue: string): ReadonlyRecord<string, string>;

package/dist/esm/http/header/cookie/parse-cookie-header-value.js

@@ -0,0 +1,28 @@
+import { entriesToObject, isDefined } from '@edumalin/platform/functional';
+import { httpError } from '../../http.error.js';
+export function parseCookieHeaderValue(cookieHeaderValue) {
+    const entries = cookieHeaderValue.split(';').map(segmentToCookieNameValuePair).filter(isDefined);
+    return entriesToObject(entries);
+}
+function segmentToCookieNameValuePair(segment) {
+    const separator = segment.indexOf('=');
+    if (separator === -1) {
+        return undefined;
+    }
+    const namePart = segment.substring(0, separator);
+    const name = decodeString(namePart).trim();
+    if (!name) {
+        return undefined;
+    }
+    const valuePart = segment.substring(separator + 1);
+    const value = decodeString(valuePart).trim();
+    return [name, value];
+}
+function decodeString(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        throw httpError.invalidCookieHeaderValue({ value });
+    }
+}

package/dist/esm/http/header/http-header.d.ts

@@ -0,0 +1,2 @@
+import { type HttpHeaderName } from './name/http-header-name.js';
+export type HttpHeader = readonly [headerName: HttpHeaderName | (string & {}), headerValue: string];

package/dist/esm/http/header/http-header.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/header/name/as-http-header-name.d.ts

@@ -0,0 +1,2 @@
+import { type HttpHeaderName } from './http-header-name.js';
+export declare function asHttpHeaderName(string: string): HttpHeaderName;

package/dist/esm/http/header/name/as-http-header-name.js

@@ -0,0 +1,5 @@
+import { validateHttpHeaderName } from './validate-http-header-name.js';
+export function asHttpHeaderName(string) {
+    validateHttpHeaderName(string);
+    return string;
+}

package/dist/esm/http/header/name/http-header-name.d.ts

@@ -0,0 +1,2 @@
+import { type httpHeaderNames } from './http-header-names.js';
+export type HttpHeaderName = (typeof httpHeaderNames)[number];

package/dist/esm/http/header/name/http-header-name.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/http/header/name/http-header-names.d.ts

@@ -0,0 +1 @@
+export declare const httpHeaderNames: readonly ["accept", "accept-ch", "accept-charset", "accept-encoding", "accept-language", "accept-patch", "accept-post", "accept-ranges", "access-control-allow-credentials", "access-control-allow-headers", "access-control-allow-methods", "access-control-allow-origin", "access-control-expose-headers", "access-control-max-age", "access-control-request-headers", "access-control-request-method", "age", "allow", "alt-svc", "alt-used", "authorization", "cache-control", "clear-site-data", "connection", "content-disposition", "content-encoding", "content-language", "content-length", "content-location", "content-security-policy", "content-security-policy-report-only", "content-type", "cookie", "critical-ch", "cross-origin-embedder-policy", "cross-origin-opener-policy", "cross-origin-resource-policy", "date", "device-memory", "downlink", "early-data", "ect", "etag", "expect", "expect-ct", "expires", "forwarded", "from", "host", "if-match", "if-modified-since", "if-none-match", "if-range", "if-unmodified-since", "keep-alive", "last-modified", "link", "location", "max-forwards", "nel", "origin", "origin-agent-cluster", "permissions-policy", "pragma", "proxy-authenticate", "proxy-authorization", "range", "referer", "referrer-policy", "retry-after", "rtt", "save-data", "sec-ch-prefers-color-scheme", "sec-ch-prefers-reduced-motion", "sec-ch-prefers-reduced-transparency", "sec-ch-ua", "sec-ch-ua-arch", "sec-ch-ua-bitness", "sec-ch-ua-full-version-list", "sec-ch-ua-mobile", "sec-ch-ua-model", "sec-ch-ua-platform", "sec-ch-ua-platform-version", "sec-fetch-dest", "sec-fetch-mode", "sec-fetch-site", "sec-fetch-user", "sec-gpc", "sec-purpose", "sec-websocket-accept", "server", "server-timing", "service-worker-navigation-preload", "set-cookie", "sourcemap", "strict-transport-security", "supports-loading-mode", "te", "timing-allow-origin", "trailer", "upgrade", "upgrade-insecure-requests", "user-agent", "vary", "via", "www-authenticate", "x-content-type-options", "x-dns-prefetch-control", "x-forwarded-for", "x-forwarded-host", "x-forwarded-proto", "x-frame-options", "x-xss-protection"];