@bleedingdev/modern-js-create-request 3.8.3-ultramodern.6 → 3.9.0-ultramodern.10

package/dist/esm-node/requestContext.mjs

@@ -1,75 +0,0 @@
-import "node:module";
-import { parseTraceparent } from "./traceparent.mjs";
-const BFF_LOCALE_HEADER = 'accept-language';
-const BFF_TRACEPARENT_HEADER = 'traceparent';
-const readHeader = (headers, header)=>{
-    if (!headers) return;
-    const normalized = header.toLowerCase();
-    const key = Object.keys(headers).find((current)=>current.toLowerCase() === normalized);
-    if (!key) return;
-    const value = headers[key];
-    return Array.isArray(value) ? value[0] : value;
-};
-const readString = (value)=>'string' == typeof value && value.length > 0 ? value : void 0;
-function createOperationContextSnapshot(operationContext, safeContext) {
-    if (!operationContext) return;
-    const snapshot = {
-        ...operationContext,
-        ...safeContext.locale || operationContext?.locale ? {
-            locale: safeContext.locale || operationContext?.locale
-        } : {},
-        ...safeContext.traceparent || operationContext?.traceparent ? {
-            traceparent: safeContext.traceparent || operationContext?.traceparent
-        } : {},
-        ...safeContext.traceId || operationContext?.traceId ? {
-            traceId: safeContext.traceId || operationContext?.traceId
-        } : {},
-        ...safeContext.spanId || operationContext?.spanId ? {
-            spanId: safeContext.spanId || operationContext?.spanId
-        } : {}
-    };
-    return Object.keys(snapshot).some((key)=>void 0 !== snapshot[key]) ? snapshot : void 0;
-}
-function createRequestContextSnapshot(input = {}) {
-    const locale = readString(input.locale) || readString(readHeader(input.headers, BFF_LOCALE_HEADER));
-    const traceparent = readString(input.traceparent) || readString(input.operationContext?.traceparent) || readString(readHeader(input.headers, BFF_TRACEPARENT_HEADER));
-    const parsedTraceparent = input.operationContext?.traceId && input.operationContext?.spanId ? {
-        traceId: input.operationContext.traceId,
-        spanId: input.operationContext.spanId
-    } : parseTraceparent(traceparent);
-    const headers = {};
-    if (locale) headers[BFF_LOCALE_HEADER] = locale;
-    if (traceparent) headers[BFF_TRACEPARENT_HEADER] = traceparent;
-    const operationContext = createOperationContextSnapshot(input.operationContext, {
-        ...locale ? {
-            locale
-        } : {},
-        ...traceparent ? {
-            traceparent
-        } : {},
-        ...parsedTraceparent ? {
-            traceId: parsedTraceparent.traceId,
-            spanId: parsedTraceparent.spanId
-        } : {}
-    });
-    return {
-        headers,
-        ...locale ? {
-            locale
-        } : {},
-        ...traceparent ? {
-            traceparent
-        } : {},
-        ...parsedTraceparent ? {
-            traceId: parsedTraceparent.traceId,
-            spanId: parsedTraceparent.spanId
-        } : {},
-        ...operationContext ? {
-            operationContext
-        } : {}
-    };
-}
-function createRequestContextHeaders(input = {}) {
-    return createRequestContextSnapshot(input).headers;
-}
-export { BFF_LOCALE_HEADER, BFF_TRACEPARENT_HEADER, createRequestContextHeaders, createRequestContextSnapshot };

package/dist/esm-node/traceparent.mjs

@@ -1,19 +0,0 @@
-import "node:module";
-const TRACEPARENT_REGEX = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;
-const isAllZeroHex = (value)=>/^0+$/.test(value);
-function parseTraceparent(traceparent) {
-    if (!traceparent) return;
-    const match = traceparent.trim().match(TRACEPARENT_REGEX);
-    if (!match) return;
-    const [, rawTraceId, rawSpanId, rawFlags] = match;
-    if (!rawTraceId || !rawSpanId || !rawFlags) return;
-    const traceId = rawTraceId.toLowerCase();
-    const spanId = rawSpanId.toLowerCase();
-    if (isAllZeroHex(traceId) || isAllZeroHex(spanId)) return;
-    return {
-        traceId,
-        spanId,
-        sampled: (0x1 & Number.parseInt(rawFlags, 16)) === 1
-    };
-}
-export { parseTraceparent };

package/dist/esm-node/transport.mjs

@@ -1,197 +0,0 @@
-import "node:module";
-const DEFAULT_RETRYABLE_STATUS_CODES = [
-    408,
-    425,
-    429,
-    500,
-    502,
-    503,
-    504
-];
-const DEFAULT_BASE_DELAY_MS = 100;
-const DEFAULT_MAX_DELAY_MS = 1000;
-const DEFAULT_JITTER_RATIO = 0.1;
-const DEFAULT_RETRYABLE_METHODS = new Set([
-    'DELETE',
-    'GET',
-    'HEAD',
-    'OPTIONS',
-    'PUT',
-    'TRACE'
-]);
-const createTimeoutError = (timeoutMs)=>{
-    const error = new Error(`Request timed out after ${timeoutMs}ms`);
-    error.name = 'TimeoutError';
-    return error;
-};
-const unrefTimer = (timer)=>{
-    if ('object' == typeof timer && null !== timer && 'unref' in timer && 'function' == typeof timer.unref) timer.unref();
-};
-const wait = (ms)=>new Promise((resolve)=>{
-        const timer = setTimeout(()=>resolve(), ms);
-        unrefTimer(timer);
-    });
-const toStatusCode = (error)=>{
-    if (!error || 'object' != typeof error) return;
-    const status = error.status;
-    if ('number' == typeof status) return status;
-    const responseStatus = error.response?.status;
-    if ('number' == typeof responseStatus) return responseStatus;
-};
-const isRetryableNetworkError = (error)=>{
-    if (!error || 'object' != typeof error) return false;
-    const name = error.name;
-    if ('FetchError' === name || 'TimeoutError' === name || 'TypeError' === name) return true;
-    const code = error.code;
-    return 'ECONNRESET' === code || 'ETIMEDOUT' === code || 'ECONNREFUSED' === code || 'EPIPE' === code;
-};
-const normalizePositiveNumber = (value, fallback)=>'number' == typeof value && Number.isFinite(value) && value > 0 ? value : fallback;
-const normalizeNonNegativeInt = (value, fallback)=>'number' == typeof value && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
-const normalizeJitterRatio = (value)=>{
-    if ('number' != typeof value || !Number.isFinite(value)) return DEFAULT_JITTER_RATIO;
-    return Math.max(0, Math.min(1, value));
-};
-const shouldRetryWithDefaults = (method, statusCode, error, retryableStatusCodes)=>{
-    if (!DEFAULT_RETRYABLE_METHODS.has(method.toUpperCase())) return false;
-    if ('number' == typeof statusCode) return retryableStatusCodes.includes(statusCode);
-    return isRetryableNetworkError(error);
-};
-const shouldRetry = (retryOptions, context, retryableStatusCodes)=>{
-    if ('function' == typeof retryOptions?.shouldRetry) try {
-        return retryOptions.shouldRetry(context);
-    } catch (error) {
-        return false;
-    }
-    return shouldRetryWithDefaults(context.method, context.statusCode, context.error, retryableStatusCodes);
-};
-const getBackoffMs = (retryOptions, attempt)=>{
-    const baseDelayMs = normalizePositiveNumber(retryOptions?.baseDelayMs, DEFAULT_BASE_DELAY_MS);
-    const maxDelayMs = normalizePositiveNumber(retryOptions?.maxDelayMs, DEFAULT_MAX_DELAY_MS);
-    const jitterRatio = normalizeJitterRatio(retryOptions?.jitterRatio);
-    const exponentialDelay = Math.min(maxDelayMs, baseDelayMs * 2 ** Math.max(0, attempt - 1));
-    const jitterFactor = 0 === jitterRatio ? 1 : 1 + (2 * Math.random() - 1) * jitterRatio;
-    return Math.max(0, Math.floor(exponentialDelay * jitterFactor));
-};
-const emitDegradedEvent = (transport, event)=>{
-    if ('function' != typeof transport?.onDegraded) return;
-    try {
-        transport.onDegraded(event);
-    } catch (error) {}
-};
-const withTimeout = async (promise, timeoutMs, signalBuilder)=>{
-    if (!timeoutMs || timeoutMs <= 0) {
-        const result = await promise;
-        return {
-            result
-        };
-    }
-    const controller = signalBuilder?.();
-    let timeoutTriggered = false;
-    let rejectTimeout;
-    const timeoutPromise = new Promise((_, reject)=>{
-        rejectTimeout = reject;
-    });
-    const timer = setTimeout(()=>{
-        timeoutTriggered = true;
-        if (controller) controller.abort();
-        rejectTimeout?.(createTimeoutError(timeoutMs));
-    }, timeoutMs);
-    unrefTimer(timer);
-    try {
-        const result = await Promise.race([
-            promise,
-            timeoutPromise
-        ]);
-        return {
-            result,
-            timeoutTriggered
-        };
-    } catch (error) {
-        if (timeoutTriggered && error?.name === 'AbortError') throw createTimeoutError(timeoutMs);
-        throw error;
-    } finally{
-        clearTimeout(timer);
-    }
-};
-const executeWithResilience = async ({ requestId, target, method, url, init, fetcher, transport })=>{
-    const retries = normalizeNonNegativeInt(transport?.retry?.retries, 0);
-    const timeoutMs = 'number' == typeof transport?.timeoutMs && transport.timeoutMs > 0 ? transport.timeoutMs : void 0;
-    const maxAttempts = retries + 1;
-    const retryableStatusCodes = transport?.retry?.retryableStatusCodes && transport.retry.retryableStatusCodes.length > 0 ? transport.retry.retryableStatusCodes : DEFAULT_RETRYABLE_STATUS_CODES;
-    let attempt = 0;
-    while(attempt < maxAttempts){
-        attempt += 1;
-        const canUseAbortController = "u" > typeof AbortController;
-        let controller;
-        if (timeoutMs && canUseAbortController) controller = new AbortController();
-        const callerSignal = init.signal;
-        const requestSignal = controller ? callerSignal && !callerSignal.aborted ? AbortSignal.any([
-            callerSignal,
-            controller.signal
-        ]) : callerSignal || controller.signal : callerSignal;
-        const nextInit = requestSignal ? {
-            ...init,
-            signal: requestSignal
-        } : init;
-        try {
-            const { result } = await withTimeout(fetcher(url, nextInit), timeoutMs, ()=>controller);
-            return result;
-        } catch (error) {
-            const statusCode = toStatusCode(error);
-            const decisionContext = {
-                requestId,
-                target,
-                method,
-                url,
-                attempt,
-                maxAttempts,
-                error,
-                statusCode
-            };
-            if (error?.name === 'TimeoutError') emitDegradedEvent(transport, {
-                requestId,
-                target,
-                method,
-                url,
-                reason: 'timeout',
-                attempt,
-                maxAttempts,
-                timeoutMs,
-                statusCode,
-                error
-            });
-            const canRetry = attempt < maxAttempts && shouldRetry(transport?.retry, decisionContext, retryableStatusCodes);
-            if (!canRetry) {
-                if (retries > 0 || error?.name === 'TimeoutError') emitDegradedEvent(transport, {
-                    requestId,
-                    target,
-                    method,
-                    url,
-                    reason: 'retry_exhausted',
-                    attempt,
-                    maxAttempts,
-                    timeoutMs,
-                    statusCode,
-                    error
-                });
-                throw error;
-            }
-            const backoffMs = getBackoffMs(transport?.retry, attempt);
-            emitDegradedEvent(transport, {
-                requestId,
-                target,
-                method,
-                url,
-                reason: 'retry',
-                attempt,
-                maxAttempts,
-                timeoutMs,
-                backoffMs,
-                statusCode,
-                error
-            });
-            if (backoffMs > 0) await wait(backoffMs);
-        }
-    }
-};
-export { executeWithResilience };

package/dist/types/policyCore.d.ts

@@ -1,108 +0,0 @@
-import type { IdentityBindingViolation, OperationContext, OperationContractOptions, OperationContractViolation, TransportTarget } from './types';
-export declare const TRACEPARENT_HEADER = "traceparent";
-export declare const isSecuredRequestId: (requestId: string) => boolean;
-export declare const isEmptyDomain: (domain?: string) => boolean;
-export declare const firstHeaderValue: (value: unknown) => any;
-export declare const findHeaderKey: (headers: Record<string, any>, header: string) => string | undefined;
-export declare const readHeader: (headers: Record<string, any>, header: string) => any;
-export declare const writeHeader: (headers: Record<string, any>, header: string, value: unknown) => void;
-export declare const deleteHeader: (headers: Record<string, any>, header: string) => void;
-export declare const toOrigin: (value?: string) => string | undefined;
-export declare const parseTraceparentValue: (value: unknown) => import("./traceparent").TraceparentContext | undefined;
-export declare const extractPathParamNames: (path: string) => string[];
-export declare const buildOperationContext: ({ requestId, method, path, operationContext, traceparent, }: {
-    requestId: string;
-    method: string;
-    path: string;
-    operationContext?: OperationContext | undefined;
-    traceparent?: unknown;
-}) => {
-    requestId: string;
-    operationId: string;
-    routePath: string;
-    method: string;
-    schemaHash?: string | undefined;
-    operationVersion?: number | undefined;
-    traceparent?: string | undefined;
-    traceId?: string | undefined;
-    spanId?: string | undefined;
-};
-type OperationContextPayload = ReturnType<typeof buildOperationContext>;
-export declare class ProducerClientNotInitializedError extends Error {
-    readonly code = "BFF_PRODUCER_CLIENT_NOT_INITIALIZED";
-    constructor(requestId: string);
-}
-export declare class ProducerDomainNotConfiguredError extends Error {
-    readonly code = "BFF_PRODUCER_DOMAIN_NOT_CONFIGURED";
-    constructor(requestId: string);
-}
-export declare class CrossOriginEnvelopePolicyError extends Error {
-    readonly code = "BFF_CROSS_ORIGIN_ENVELOPE_NOT_ALLOWED";
-    constructor(requestId: string, sourceOrigin?: string, targetOrigin?: string);
-}
-export declare class IdentityBindingViolationError extends Error {
-    readonly code = "BFF_IDENTITY_BINDING_VIOLATION";
-    readonly violation: IdentityBindingViolation;
-    constructor(violation: IdentityBindingViolation);
-}
-export declare class OperationContractViolationError extends Error {
-    readonly code = "BFF_OPERATION_CONTRACT_VIOLATION";
-    readonly violation: OperationContractViolation;
-    constructor(violation: OperationContractViolation);
-}
-export declare const validateOperationContract: ({ requestId, target, contextPayload, operationContract, }: {
-    requestId: string;
-    target: TransportTarget;
-    contextPayload: OperationContextPayload;
-    operationContract: OperationContractOptions | undefined;
-}) => void;
-export declare const resolveConfiguredRequest: <F>(configuredRequests: Map<string, F>, requestId: string, fallback: F) => F;
-/**
- * Builds the JSON value for the `x-modernjs-bff-envelope` header and throws
- * when the cross-origin envelope policy denies the flow. Returns the
- * serialized envelope.
- */
-export declare const buildEnvelopeHeaderValue: ({ requestId, target, sourceOrigin, targetOrigin, traceContext, allowCrossOriginEnvelope, }: {
-    requestId: string;
-    target: TransportTarget;
-    sourceOrigin: string | undefined;
-    targetOrigin: string | undefined;
-    traceContext: {
-        traceId: string;
-        spanId: string;
-    } | null | undefined;
-    allowCrossOriginEnvelope: boolean | ((options: {
-        requestId: string;
-        sourceOrigin?: string;
-        targetOrigin?: string;
-        target: TransportTarget;
-    }) => boolean) | undefined;
-}) => string;
-/**
- * Derives the operation context for a secured requestId, validates it against
- * the configured operation contract and writes the `x-operation-id` and
- * `x-modernjs-bff-operation-context` headers (without clobbering caller
- * provided values for the id header).
- */
-export declare const attachOperationContextHeaders: ({ headers, requestId, target, method, path, operationContext, operationContract, operationContextHeader, operationContextDetailHeader, }: {
-    headers: Record<string, any>;
-    requestId: string;
-    target: TransportTarget;
-    method: string;
-    path: string;
-    operationContext: OperationContext | undefined;
-    operationContract: OperationContractOptions | undefined;
-    operationContextHeader: string;
-    operationContextDetailHeader: string;
-}) => {
-    requestId: string;
-    operationId: string;
-    routePath: string;
-    method: string;
-    schemaHash?: string | undefined;
-    operationVersion?: number | undefined;
-    traceparent?: string | undefined;
-    traceId?: string | undefined;
-    spanId?: string | undefined;
-};
-export {};

package/dist/types/requestContext.d.ts

@@ -1,19 +0,0 @@
-import type { OperationContext } from './types';
-export declare const BFF_LOCALE_HEADER = "accept-language";
-export declare const BFF_TRACEPARENT_HEADER = "traceparent";
-export type RequestContextInput = {
-    headers?: Record<string, unknown>;
-    locale?: string;
-    traceparent?: string;
-    operationContext?: OperationContext;
-};
-export type RequestContextSnapshot = {
-    headers: Record<string, string>;
-    locale?: string;
-    traceparent?: string;
-    traceId?: string;
-    spanId?: string;
-    operationContext?: OperationContext;
-};
-export declare function createRequestContextSnapshot(input?: RequestContextInput): RequestContextSnapshot;
-export declare function createRequestContextHeaders(input?: RequestContextInput): Record<string, string>;

package/dist/types/traceparent.d.ts

@@ -1,10 +0,0 @@
-export type TraceparentContext = {
-    traceId: string;
-    spanId: string;
-    sampled: boolean;
-};
-/**
- * Parse a W3C trace context `traceparent` header (version 00).
- * All-zero trace ids and span ids are rejected per the W3C spec.
- */
-export declare function parseTraceparent(traceparent: string | undefined | null): TraceparentContext | undefined;

package/dist/types/transport.d.ts

@@ -1,12 +0,0 @@
-import type { TransportResilienceOptions, TransportTarget } from './types';
-type ExecuteWithResilienceOptions = {
-    requestId: string;
-    target: TransportTarget;
-    method: string;
-    url: string;
-    init: Record<string, any>;
-    fetcher: (...args: any[]) => Promise<any>;
-    transport?: TransportResilienceOptions;
-};
-export declare const executeWithResilience: ({ requestId, target, method, url, init, fetcher, transport, }: ExecuteWithResilienceOptions) => Promise<any>;
-export {};