@bleedingdev/modern-js-create-request 3.2.0-ultramodern.5 → 3.2.0-ultramodern.51

package/dist/cjs/requestContext.js

@@ -52,6 +52,25 @@ function parseTraceparent(traceparent) {
         spanId: spanId.toLowerCase()
     };
 }
+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));
@@ -62,6 +81,18 @@ function createRequestContextSnapshot(input = {}) {
     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 ? {
@@ -73,6 +104,9 @@ function createRequestContextSnapshot(input = {}) {
         ...parsedTraceparent ? {
             traceId: parsedTraceparent.traceId,
             spanId: parsedTraceparent.spanId
+        } : {},
+        ...operationContext ? {
+            operationContext
         } : {}
     };
 }

package/dist/esm/requestContext.mjs

@@ -21,6 +21,25 @@ function parseTraceparent(traceparent) {
         spanId: spanId.toLowerCase()
     };
 }
+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));
@@ -31,6 +50,18 @@ function createRequestContextSnapshot(input = {}) {
     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 ? {
@@ -42,6 +73,9 @@ function createRequestContextSnapshot(input = {}) {
         ...parsedTraceparent ? {
             traceId: parsedTraceparent.traceId,
             spanId: parsedTraceparent.spanId
+        } : {},
+        ...operationContext ? {
+            operationContext
         } : {}
     };
 }

package/dist/esm-node/requestContext.mjs

@@ -22,6 +22,25 @@ function parseTraceparent(traceparent) {
         spanId: spanId.toLowerCase()
     };
 }
+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));
@@ -32,6 +51,18 @@ function createRequestContextSnapshot(input = {}) {
     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 ? {
@@ -43,6 +74,9 @@ function createRequestContextSnapshot(input = {}) {
         ...parsedTraceparent ? {
             traceId: parsedTraceparent.traceId,
             spanId: parsedTraceparent.spanId
+        } : {},
+        ...operationContext ? {
+            operationContext
         } : {}
     };
 }

package/dist/types/browser.d.ts

@@ -0,0 +1,28 @@
+import type { IdentityBindingViolation, IOptions, OperationContractViolation, RequestCreator, UploadCreator } from './types';
+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 configure: (options: IOptions) => void;
+export declare const createRequest: RequestCreator;
+export declare const createUploader: UploadCreator;
+export * from './requestContext';
+export * from './types';

package/dist/types/handleRes.d.ts

@@ -0,0 +1,2 @@
+declare const handleRes: (res: Response) => Promise<any>;
+export { handleRes };

package/dist/types/node.d.ts

@@ -0,0 +1,29 @@
+import type { IdentityBindingViolation, IOptions, OperationContractViolation, RequestCreator, UploadCreator } from './types';
+type Fetch = typeof fetch;
+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 configure: (options: IOptions<Fetch>) => void;
+export declare const createRequest: RequestCreator<Fetch>;
+export declare const createUploader: UploadCreator;
+export * from './requestContext';
+export * from './types';

package/dist/types/qs.d.ts

@@ -0,0 +1 @@
+export { parse, stringify } from 'qs';

package/dist/types/requestContext.d.ts

@@ -0,0 +1,19 @@
+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/transport.d.ts

@@ -0,0 +1,12 @@
+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 {};

package/dist/types/types.d.ts

@@ -0,0 +1,174 @@
+import type { HttpMethodDecider } from '@modern-js/types';
+export declare const BFF_ENVELOPE_HEADER = "x-modernjs-bff-envelope";
+export declare const BFF_OPERATION_CONTEXT_HEADER = "x-operation-id";
+export declare const BFF_OPERATION_CONTEXT_DETAIL_HEADER = "x-modernjs-bff-operation-context";
+export declare const BFF_DEFAULT_PROTECTED_IDENTITY_HEADERS: readonly ['x-tenant-id', 'x-subject-id', 'x-user-id', "x-operation-id"];
+export type BFFRequestPayload = {
+    params?: Record<string, any>;
+    query?: Record<string, any>;
+    body?: string;
+    formUrlencoded?: string | Record<string, any> | URLSearchParams;
+    formData?: FormData;
+    data?: Record<string, any>;
+    headers?: Record<string, any>;
+    cookies?: Record<string, any>;
+    files?: Record<string, any>;
+};
+export type Sender<F = typeof fetch> = ((...args: any[]) => Promise<any>) & {
+    fetch?: F;
+};
+export type ResolveHeadersOptions = {
+    requestId: string;
+    allowedHeaders: string[];
+    incomingHeaders: Record<string, any>;
+};
+export type ResolveHeaders = (options: ResolveHeadersOptions) => Record<string, any> | void;
+export type AllowCrossOriginEnvelopeOptions = {
+    requestId: string;
+    sourceOrigin?: string;
+    targetOrigin?: string;
+    target: 'server' | 'browser';
+};
+export type AllowCrossOriginEnvelope = boolean | ((options: AllowCrossOriginEnvelopeOptions) => boolean);
+export type TransportTarget = 'server' | 'browser';
+export type RetryDecisionContext = {
+    requestId: string;
+    target: TransportTarget;
+    method: string;
+    url: string;
+    attempt: number;
+    maxAttempts: number;
+    error: unknown;
+    statusCode?: number;
+};
+export type RetryBackoffOptions = {
+    retries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitterRatio?: number;
+    retryableStatusCodes?: number[];
+    shouldRetry?: (context: RetryDecisionContext) => boolean;
+};
+export type DegradedModeReason = 'timeout' | 'retry' | 'retry_exhausted';
+export type DegradedModeEvent = {
+    requestId: string;
+    target: TransportTarget;
+    method: string;
+    url: string;
+    reason: DegradedModeReason;
+    attempt: number;
+    maxAttempts: number;
+    timeoutMs?: number;
+    backoffMs?: number;
+    statusCode?: number;
+    error?: unknown;
+};
+export type TransportResilienceOptions = {
+    timeoutMs?: number;
+    retry?: RetryBackoffOptions;
+    onDegraded?: (event: DegradedModeEvent) => void;
+};
+export type IdentityBindingViolationReason = 'client_override_blocked' | 'client_override_rejected';
+export type IdentityBindingViolation = {
+    requestId: string;
+    target: TransportTarget;
+    header: string;
+    reason: IdentityBindingViolationReason;
+    attemptedValue?: unknown;
+    derivedValue?: unknown;
+};
+export type DeriveIdentityHeadersOptions = {
+    requestId: string;
+    target: TransportTarget;
+    incomingHeaders: Record<string, any>;
+    protectedHeaders: string[];
+};
+export type IdentityBindingOptions = {
+    enabled?: boolean;
+    strict?: boolean;
+    protectedHeaders?: string[];
+    deriveHeaders?: (options: DeriveIdentityHeadersOptions) => Record<string, any> | void;
+    onViolation?: (violation: IdentityBindingViolation) => void;
+};
+export type OperationContractViolationReason = 'missing_schema_hash' | 'missing_operation_version';
+export type OperationContractViolation = {
+    requestId: string;
+    target: TransportTarget;
+    operationId: string;
+    reason: OperationContractViolationReason;
+    routePath?: string;
+    method?: string;
+    schemaHash?: string;
+    operationVersion?: number;
+};
+export type CrossProjectOperationContract = {
+    schemaHash?: string;
+    operationVersion?: number;
+};
+export type CrossProjectPolicyViolationReason = 'missing_envelope' | 'invalid_envelope' | 'missing_request_id' | 'namespace_not_allowed' | 'missing_operation_context' | 'operation_context_mismatch' | 'missing_operation_context_details' | 'invalid_operation_context_details' | 'operation_context_details_request_id_mismatch' | 'missing_operation_schema_hash' | 'missing_operation_version' | 'unknown_operation_contract' | 'operation_schema_hash_mismatch' | 'operation_version_mismatch';
+export type CrossProjectPolicyViolation = {
+    code: 'BFF_CROSS_PROJECT_POLICY_DENIED';
+    reason: CrossProjectPolicyViolationReason;
+    message: string;
+    status: number;
+};
+export type OperationContractOptions = {
+    enabled?: boolean;
+    strict?: boolean;
+    requireSchemaHash?: boolean;
+    requireOperationVersion?: boolean;
+    onViolation?: (violation: OperationContractViolation) => void;
+};
+export type OperationContextSource = 'client' | 'server' | 'generated-client' | 'effect-adapter' | 'data-platform' | 'unknown';
+export type OperationContext = {
+    requestId?: string;
+    operationId?: string;
+    routePath?: string;
+    method?: string;
+    schemaHash?: string;
+    operationVersion?: number;
+    locale?: string;
+    traceparent?: string;
+    traceId?: string;
+    spanId?: string;
+    source?: OperationContextSource;
+    scope?: Record<string, unknown>;
+    sessionClaims?: Record<string, unknown>;
+    attributes?: Record<string, unknown>;
+};
+export type RequestCreatorOptions<F = typeof fetch> = {
+    path: string;
+    method: string;
+    port: number;
+    httpMethodDecider?: HttpMethodDecider;
+    fetch?: F;
+    domain?: string;
+    requestId?: string;
+    operationContext?: OperationContext;
+};
+export type RequestCreator<F = typeof fetch> = {
+    (options: RequestCreatorOptions<F>): Sender;
+    (path: string, method: string, port: number, httpMethodDecider?: HttpMethodDecider, fetch?: F, requestId?: string, operationContext?: OperationContext): Sender;
+};
+export type UploadCreatorOptions = {
+    path: string;
+    domain?: string;
+    requestId?: string;
+};
+export type UploadCreator = (options: UploadCreatorOptions) => Sender;
+export type IOptions<F = typeof fetch> = {
+    request?: F;
+    interceptor?: (request: F) => F;
+    allowedHeaders?: string[];
+    resolveHeaders?: ResolveHeaders;
+    transport?: TransportResilienceOptions;
+    requireEnvelope?: boolean;
+    allowCrossOriginEnvelope?: AllowCrossOriginEnvelope;
+    identityBinding?: IdentityBindingOptions;
+    operationContract?: OperationContractOptions;
+    setDomain?: (ops?: {
+        target: 'server' | 'browser';
+        requestId?: string;
+    }) => string;
+    requestId?: string;
+};

package/dist/types/utiles.d.ts

@@ -0,0 +1,5 @@
+export declare const getUploadPayload: (args: any) => {
+    body: any;
+    headers: Record<string, any> | undefined;
+    params: Record<string, any> | undefined;
+};

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.0-ultramodern.5",
+  "version": "3.2.0-ultramodern.51",
   "modern:source": "./src/node.ts",
   "types": "./dist/types/browser.d.ts",
   "main": "./dist/cjs/node.js",
@@ -60,18 +60,18 @@
     "@swc/helpers": "^0.5.21",
     "encoding": "^0.1.13",
     "path-to-regexp": "^8.4.2",
-    "qs": "^6.15.1",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.5",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.2.0-ultramodern.5"
+    "qs": "^6.15.2",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.51",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.2.0-ultramodern.51"
   },
   "devDependencies": {
     "@rslib/core": "0.21.5",
-    "@types/node": "^25.8.0",
+    "@types/node": "^25.9.1",
     "@types/qs": "^6.15.1",
-    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+    "@typescript/native-preview": "7.0.0-dev.20260527.2",
     "nock": "^14.0.15",
-    "@scripts/rstest-config": "2.66.0",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.5"
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.51",
+    "@scripts/rstest-config": "2.66.0"
   },
   "sideEffects": false,
   "publishConfig": {