@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.1 → 3.5.0-ultramodern.100

package/dist/esm/loader.mjs

@@ -2,6 +2,8 @@ import { generateClient } from "@modern-js/bff-core";
 import { logger } from "@modern-js/utils";
 import path from "path";
 import { generateEffectClientCode, resolveEffectEntryFile } from "./utils/effectClientGenerator.mjs";
+const EFFECT_BFF_WORKER_RUNTIME_QUERY = 'modern-bff-runtime';
+const EFFECT_BFF_WORKER_RUNTIME_SOURCE_QUERY = 'modern-bff-runtime-source';
 async function transformEffectRuntimeSource(source, filename) {
     const swc = await import("@swc/core");
     const result = await swc.transform(source, {
@@ -20,22 +22,36 @@ async function transformEffectRuntimeSource(source, filename) {
     });
     return result.code;
 }
+function createEffectWorkerRuntimeWrapper(resourcePath) {
+    const sourceRequest = `${resourcePath}?${EFFECT_BFF_WORKER_RUNTIME_SOURCE_QUERY}`;
+    return `import * as effectBffModule from ${JSON.stringify(sourceRequest)};
+import { createEffectBffEdgeDispatcher } from '@modern-js/plugin-bff/effect-edge';
+
+export const __modern_create_effect_bff_dispatcher = options =>
+  createEffectBffEdgeDispatcher({
+    ...options,
+    module: effectBffModule,
+  });
+`;
+}
 async function loader(source) {
     this.cacheable();
     const { resourcePath } = this;
     delete require.cache[resourcePath];
     const callback = this.async();
     const draftOptions = this.getOptions();
+    const resourceQueries = new URLSearchParams(this.resourceQuery);
     const effectEntryFile = resolveEffectEntryFile({
         appDir: draftOptions.appDir,
         apiDir: draftOptions.apiDir,
         effectEntry: draftOptions.effectEntry
     });
-    if ('effect' === draftOptions.bffRuntimeFramework && effectEntryFile && path.resolve(effectEntryFile) === path.resolve(resourcePath) && this.resourceQuery.includes('modern-bff-runtime')) {
+    if ('effect' === draftOptions.bffRuntimeFramework && effectEntryFile && path.resolve(effectEntryFile) === path.resolve(resourcePath) && resourceQueries.has(EFFECT_BFF_WORKER_RUNTIME_SOURCE_QUERY)) {
         const code = await transformEffectRuntimeSource(source, resourcePath);
         callback(void 0, code);
         return;
     }
+    if ('effect' === draftOptions.bffRuntimeFramework && effectEntryFile && path.resolve(effectEntryFile) === path.resolve(resourcePath) && resourceQueries.has(EFFECT_BFF_WORKER_RUNTIME_QUERY)) return void callback(void 0, createEffectWorkerRuntimeWrapper(resourcePath));
     if ('effect' === draftOptions.bffRuntimeFramework && effectEntryFile && path.resolve(effectEntryFile) === path.resolve(resourcePath)) {
         const code = await generateEffectClientCode({
             appDir: draftOptions.appDir,
@@ -46,7 +62,8 @@ async function loader(source) {
             target: draftOptions.target,
             requestCreator: draftOptions.requestCreator,
             httpMethodDecider: draftOptions.httpMethodDecider,
-            dataPlatformBatch: draftOptions.effectDataPlatformBatch
+            dataPlatformBatch: draftOptions.effectDataPlatformBatch,
+            onDependency: (dependency)=>this.addDependency(dependency)
         });
         if (code) return void callback(void 0, code);
         callback(void 0, `throw new Error('Failed to generate Effect client for ${resourcePath}')`);

package/dist/esm/runtime/data-platform/batch/queue.mjs

@@ -0,0 +1,246 @@
+import { stableStringify } from "../codec.mjs";
+import { DEFAULT_DATA_BATCH_HEADER } from "../types.mjs";
+import { createBatchId, measureTextBytes, normalizeMethod, shouldBatchRequest, toHeaderRecord, toRequestBody } from "./request.mjs";
+import { isBatchResponsePayload, parseResponseLikeCreateRequest } from "./response.mjs";
+import { emitDataBatchTransportEvent } from "./telemetry.mjs";
+import { normalizeBatchEndpoint, toAbsoluteUrl } from "./url.mjs";
+function ensureBucket(buckets, endpoint) {
+    const existing = buckets.get(endpoint);
+    if (existing) return existing;
+    const next = {
+        items: [],
+        bytes: 0,
+        timer: null,
+        flushing: false
+    };
+    buckets.set(endpoint, next);
+    return next;
+}
+function createBatchTransportQueue({ options, baseFetch }) {
+    const flushIntervalMs = Math.max(0, options.flushIntervalMs ?? 8);
+    const maxBatchSize = Math.max(1, options.maxBatchSize ?? 16);
+    const maxBatchBytes = Math.max(1024, options.maxBatchBytes ?? 65536);
+    const requestTimeoutMs = options.requestTimeoutMs;
+    const allowedMethods = new Set((options.allowedMethods && options.allowedMethods.length > 0 ? options.allowedMethods : [
+        'GET'
+    ]).map((method)=>method.toUpperCase()));
+    const onEvent = options.onEvent;
+    const buckets = new Map();
+    const pendingByKey = new Map();
+    const disabledEndpoints = new Set();
+    let nextItemId = 0;
+    const runSingle = async (request)=>{
+        const response = await baseFetch(request.requestUrl, request.requestInit);
+        return parseResponseLikeCreateRequest(response);
+    };
+    const settleRequests = async (items, runner)=>{
+        await Promise.all(items.map(async (item)=>{
+            try {
+                const value = await runner(item);
+                item.resolve(value);
+            } catch (error) {
+                item.reject(error);
+            } finally{
+                pendingByKey.delete(item.key);
+            }
+        }));
+    };
+    const flushBucket = async (endpoint)=>{
+        const bucket = buckets.get(endpoint);
+        if (!bucket || bucket.flushing) return;
+        if (bucket.timer) {
+            clearTimeout(bucket.timer);
+            bucket.timer = null;
+        }
+        if (0 === bucket.items.length) return;
+        bucket.flushing = true;
+        const items = bucket.items;
+        bucket.items = [];
+        bucket.bytes = 0;
+        if (1 === items.length || disabledEndpoints.has(endpoint)) {
+            emitDataBatchTransportEvent(onEvent, {
+                type: disabledEndpoints.has(endpoint) ? 'fallback' : 'flush',
+                endpoint,
+                size: items.length,
+                reason: disabledEndpoints.has(endpoint) ? 'batch-disabled' : void 0
+            });
+            await settleRequests(items, runSingle);
+            bucket.flushing = false;
+            if (bucket.items.length > 0 && !bucket.timer) flushBucket(endpoint);
+            return;
+        }
+        const batchId = createBatchId();
+        const payload = {
+            protocolVersion: 1,
+            batchId,
+            sentAt: Date.now(),
+            items: items.map((item)=>item.item)
+        };
+        emitDataBatchTransportEvent(onEvent, {
+            type: 'flush',
+            endpoint,
+            batchId,
+            size: items.length
+        });
+        const payloadJson = JSON.stringify(payload);
+        const traceparent = items.find((item)=>'string' == typeof item.item.headers?.traceparent)?.item.headers?.traceparent || void 0;
+        const requestInit = {
+            method: 'POST',
+            headers: {
+                accept: 'application/json, */*;q=0.8',
+                'content-type': 'application/json; charset=utf-8',
+                [DEFAULT_DATA_BATCH_HEADER]: '1',
+                ...traceparent ? {
+                    traceparent
+                } : {}
+            },
+            body: payloadJson
+        };
+        let timeoutHandle = null;
+        try {
+            const controller = requestTimeoutMs && requestTimeoutMs > 0 ? new AbortController() : void 0;
+            if (controller) {
+                requestInit.signal = controller.signal;
+                timeoutHandle = setTimeout(()=>{
+                    controller.abort();
+                    emitDataBatchTransportEvent(onEvent, {
+                        type: 'fallback',
+                        endpoint,
+                        batchId,
+                        size: items.length,
+                        reason: 'batch-timeout'
+                    });
+                }, requestTimeoutMs);
+            }
+            const response = await baseFetch(endpoint, requestInit);
+            if (!response.ok) {
+                if (404 === response.status || 405 === response.status) {
+                    disabledEndpoints.add(endpoint);
+                    emitDataBatchTransportEvent(onEvent, {
+                        type: 'disable',
+                        endpoint,
+                        batchId,
+                        reason: `batch-endpoint-unavailable-${String(response.status)}`
+                    });
+                } else emitDataBatchTransportEvent(onEvent, {
+                    type: 'fallback',
+                    endpoint,
+                    batchId,
+                    size: items.length,
+                    reason: `batch-response-${String(response.status)}`
+                });
+                await settleRequests(items, runSingle);
+                bucket.flushing = false;
+                return;
+            }
+            const result = await response.json();
+            if (!isBatchResponsePayload(result)) {
+                emitDataBatchTransportEvent(onEvent, {
+                    type: 'fallback',
+                    endpoint,
+                    batchId,
+                    size: items.length,
+                    reason: 'invalid-batch-response'
+                });
+                await settleRequests(items, runSingle);
+                bucket.flushing = false;
+                return;
+            }
+            const itemMap = new Map();
+            for (const item of result.items)itemMap.set(item.id, item);
+            await settleRequests(items, async (request)=>{
+                const resultItem = itemMap.get(request.item.id);
+                if (!resultItem) return runSingle(request);
+                const reconstructedResponse = new Response(resultItem.body ?? '', {
+                    status: resultItem.status,
+                    headers: resultItem.headers
+                });
+                return parseResponseLikeCreateRequest(reconstructedResponse);
+            });
+        } catch (error) {
+            emitDataBatchTransportEvent(onEvent, {
+                type: 'fallback',
+                endpoint,
+                batchId,
+                size: items.length,
+                reason: 'batch-transport-error'
+            });
+            await settleRequests(items, runSingle);
+        } finally{
+            if (timeoutHandle) clearTimeout(timeoutHandle);
+            bucket.flushing = false;
+            if (bucket.items.length > 0 && !bucket.timer) flushBucket(endpoint);
+        }
+    };
+    return (input, init)=>{
+        const requestUrl = toAbsoluteUrl(input);
+        const batchEndpointUrl = normalizeBatchEndpoint(requestUrl, options.endpoint);
+        const endpoint = batchEndpointUrl.toString();
+        const method = normalizeMethod(init?.method);
+        const body = toRequestBody(init?.body ?? null);
+        const headers = toHeaderRecord(init?.headers);
+        const normalizedInit = {
+            ...init,
+            method,
+            headers,
+            body
+        };
+        if (disabledEndpoints.has(endpoint) || !shouldBatchRequest({
+            method,
+            body,
+            headers,
+            allowedMethods,
+            batchEndpoint: endpoint,
+            requestUrl
+        })) return baseFetch(requestUrl.toString(), normalizedInit).then(parseResponseLikeCreateRequest);
+        const itemId = `${Date.now().toString(36)}_${nextItemId.toString(36)}_${Math.random().toString(16).slice(2, 8)}`;
+        nextItemId += 1;
+        const item = {
+            id: itemId,
+            path: `${requestUrl.pathname}${requestUrl.search}`,
+            method,
+            headers,
+            ...body ? {
+                body
+            } : {}
+        };
+        const key = stableStringify({
+            endpoint,
+            path: item.path,
+            method: item.method,
+            headers: item.headers,
+            body: item.body ?? null
+        });
+        const existing = pendingByKey.get(key);
+        if (existing) return existing;
+        const size = measureTextBytes(stableStringify(item));
+        const promise = new Promise((resolve, reject)=>{
+            const bucket = ensureBucket(buckets, endpoint);
+            const queued = {
+                key,
+                endpoint,
+                requestUrl: requestUrl.toString(),
+                requestInit: normalizedInit,
+                item,
+                size,
+                resolve,
+                reject
+            };
+            bucket.items.push(queued);
+            bucket.bytes += size;
+            emitDataBatchTransportEvent(onEvent, {
+                type: 'enqueue',
+                endpoint,
+                size: bucket.items.length
+            });
+            if (bucket.items.length >= maxBatchSize || bucket.bytes >= maxBatchBytes) return void flushBucket(endpoint);
+            if (!bucket.timer) bucket.timer = setTimeout(()=>{
+                bucket.timer = null;
+                flushBucket(endpoint);
+            }, flushIntervalMs);
+        });
+        pendingByKey.set(key, promise);
+        return promise;
+    };
+}
+export { createBatchTransportQueue };

package/dist/esm/runtime/data-platform/batch/request.mjs

@@ -0,0 +1,45 @@
+import { DEFAULT_DATA_BATCH_HEADER } from "../types.mjs";
+function toHeaderRecord(headers) {
+    if (!headers) return {};
+    if (headers instanceof Headers) {
+        const next = {};
+        headers.forEach((value, key)=>{
+            next[key.toLowerCase()] = value;
+        });
+        return next;
+    }
+    if (Array.isArray(headers)) return headers.reduce((acc, [key, value])=>{
+        acc[String(key).toLowerCase()] = String(value);
+        return acc;
+    }, {});
+    return Object.entries(headers).reduce((acc, [key, value])=>{
+        if (void 0 === value) return acc;
+        acc[String(key).toLowerCase()] = Array.isArray(value) ? value.join(', ') : String(value);
+        return acc;
+    }, {});
+}
+function measureTextBytes(value) {
+    if ("u" > typeof TextEncoder) return new TextEncoder().encode(value).length;
+    if ("u" > typeof Buffer) return Buffer.byteLength(value);
+    return value.length;
+}
+function createBatchId() {
+    const now = Date.now().toString(36);
+    const random = Math.random().toString(16).slice(2, 10);
+    return `batch_${now}_${random}`;
+}
+function normalizeMethod(method) {
+    return (method || 'GET').toUpperCase();
+}
+function toRequestBody(initBody) {
+    if ('string' == typeof initBody) return initBody;
+    if ("u" > typeof URLSearchParams && initBody instanceof URLSearchParams) return initBody.toString();
+}
+function shouldBatchRequest(input) {
+    if (input.requestUrl.href === input.batchEndpoint) return false;
+    if ('off' === input.headers[DEFAULT_DATA_BATCH_HEADER]) return false;
+    if (!input.allowedMethods.has(input.method)) return false;
+    if (void 0 !== input.body) return false;
+    return true;
+}
+export { createBatchId, measureTextBytes, normalizeMethod, shouldBatchRequest, toHeaderRecord, toRequestBody };

package/dist/esm/runtime/data-platform/batch/response.mjs

@@ -0,0 +1,23 @@
+import { isPlainObject } from "../codec.mjs";
+function isBatchResponseItem(value) {
+    return isPlainObject(value) && 'string' == typeof value.id && 'number' == typeof value.status;
+}
+function isBatchResponsePayload(value) {
+    return isPlainObject(value) && 1 === value.protocolVersion && 'string' == typeof value.batchId && 'number' == typeof value.receivedAt && Array.isArray(value.items) && value.items.every((item)=>isBatchResponseItem(item));
+}
+async function parseResponseLikeCreateRequest(response) {
+    const contentType = (response.headers.get('content-type') || '').toLowerCase();
+    if (!response.ok) {
+        let data = null;
+        data = contentType.includes('application/json') ? await response.json() : await response.text();
+        response.data = data;
+        throw response;
+    }
+    if (contentType.includes('application/json') || contentType.includes('text/json')) return response.json();
+    if (contentType.includes('text/html') || contentType.includes('text/plain')) return response.text();
+    if (contentType.includes('application/x-www-form-urlencoded') || contentType.includes('multipart/form-data')) return response.formData();
+    if (contentType.includes('application/octet-stream')) return response.arrayBuffer();
+    if (contentType.includes('image/png')) return response;
+    return response.text();
+}
+export { isBatchResponsePayload, parseResponseLikeCreateRequest };

package/dist/esm/runtime/data-platform/batch/telemetry.mjs

@@ -0,0 +1,23 @@
+import { trace } from "@opentelemetry/api";
+const DATA_BATCH_TRANSPORT_OTEL_EVENT = 'modernjs.data.batch';
+function createDataBatchTransportTelemetryAttributes(event) {
+    return {
+        'modernjs.data.batch.type': event.type,
+        'modernjs.data.batch.endpoint': event.endpoint,
+        'modernjs.data.batch.degraded': 'fallback' === event.type || 'disable' === event.type,
+        ...event.batchId ? {
+            'modernjs.data.batch.id': event.batchId
+        } : {},
+        ...'number' == typeof event.size ? {
+            'modernjs.data.batch.size': event.size
+        } : {},
+        ...event.reason ? {
+            'modernjs.data.batch.reason': event.reason
+        } : {}
+    };
+}
+function emitDataBatchTransportEvent(onEvent, event) {
+    onEvent?.(event);
+    trace.getActiveSpan()?.addEvent(DATA_BATCH_TRANSPORT_OTEL_EVENT, createDataBatchTransportTelemetryAttributes(event));
+}
+export { DATA_BATCH_TRANSPORT_OTEL_EVENT, createDataBatchTransportTelemetryAttributes, emitDataBatchTransportEvent };

package/dist/esm/runtime/data-platform/batch/url.mjs

@@ -0,0 +1,25 @@
+import { DEFAULT_DATA_BATCH_ENDPOINT } from "../types.mjs";
+function resolveRuntimeOrigin() {
+    if ("u" > typeof window && window.location && 'string' == typeof window.location.origin && window.location.origin) return window.location.origin;
+    if ("u" > typeof globalThis && globalThis.location && 'string' == typeof globalThis.location?.origin) return globalThis.location.origin;
+    return 'http://localhost';
+}
+function toAbsoluteUrl(input) {
+    if (input instanceof URL) return input;
+    if ("u" > typeof Request && input instanceof Request) return new URL(input.url);
+    const value = String(input);
+    try {
+        return new URL(value);
+    } catch  {
+        return new URL(value, resolveRuntimeOrigin());
+    }
+}
+function normalizeBatchEndpoint(requestUrl, endpoint) {
+    const value = endpoint || DEFAULT_DATA_BATCH_ENDPOINT;
+    try {
+        return new URL(value);
+    } catch  {
+        return new URL(value, requestUrl.origin);
+    }
+}
+export { normalizeBatchEndpoint, resolveRuntimeOrigin, toAbsoluteUrl };

package/dist/esm/runtime/data-platform/batch-transport.mjs

@@ -0,0 +1,12 @@
+import { createBatchTransportQueue } from "./batch/queue.mjs";
+function createDataBatchTransport(options = {}) {
+    const fallbackFetch = 'function' == typeof fetch ? fetch.bind(globalThis) : void 0;
+    const baseFetch = options.fetch || fallbackFetch;
+    if (!baseFetch) throw new Error('createDataBatchTransport requires a fetch implementation');
+    return createBatchTransportQueue({
+        options,
+        baseFetch
+    });
+}
+export { DATA_BATCH_TRANSPORT_OTEL_EVENT, createDataBatchTransportTelemetryAttributes, emitDataBatchTransportEvent } from "./batch/telemetry.mjs";
+export { createDataBatchTransport };

package/dist/esm/runtime/data-platform/codec.mjs

@@ -0,0 +1,90 @@
+function isPlainObject(value) {
+    if ('object' != typeof value || null === value || Array.isArray(value)) return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || null === proto;
+}
+function canonicalize(value) {
+    if (Array.isArray(value)) return value.map((item)=>canonicalize(item));
+    if (isPlainObject(value)) return Object.keys(value).sort().reduce((acc, key)=>{
+        acc[key] = canonicalize(value[key]);
+        return acc;
+    }, {});
+    return value;
+}
+function stableStringify(value) {
+    return JSON.stringify(canonicalize(value));
+}
+function encodeRequestEnvelopeHeader(envelope) {
+    return encodeURIComponent(stableStringify(envelope));
+}
+function isRequestEnvelopeShape(value) {
+    if (!isPlainObject(value)) return false;
+    return 1 === value.protocolVersion && 'string' == typeof value.operationId && 'string' == typeof value.appNamespace && 'string' == typeof value.origin && 'string' == typeof value.scopeKey && 'string' == typeof value.inputHash && 'number' == typeof value.timestamp;
+}
+function decodeRequestEnvelopeHeader(value) {
+    try {
+        const decoded = decodeURIComponent(value);
+        const parsed = JSON.parse(decoded);
+        if (!isRequestEnvelopeShape(parsed)) return null;
+        return parsed;
+    } catch  {
+        return null;
+    }
+}
+function hashString(value) {
+    let hash = 0x811c9dc5;
+    for(let index = 0; index < value.length; index++){
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+function sanitizeSegment(segment) {
+    const normalized = segment.trim().replace(/[^a-zA-Z0-9_-]+/g, '_');
+    return normalized.length > 0 ? normalized : 'unknown';
+}
+function normalizeOrigin(origin) {
+    const normalized = origin.trim();
+    try {
+        const url = new URL(normalized);
+        return `${url.protocol}//${url.host}`.toLowerCase();
+    } catch  {
+        return normalized.toLowerCase();
+    }
+}
+function normalizeOperationDescriptor(input) {
+    return {
+        appNamespace: sanitizeSegment(input.appNamespace),
+        apiId: sanitizeSegment(input.apiId),
+        group: sanitizeSegment(input.group),
+        endpoint: sanitizeSegment(input.endpoint),
+        schemaHash: input.schemaHash || null,
+        version: input.version ?? 1
+    };
+}
+function createOperationId(input) {
+    const descriptor = normalizeOperationDescriptor(input);
+    const readable = `${descriptor.appNamespace}.${descriptor.apiId}.${descriptor.group}.${descriptor.endpoint}.v${String(descriptor.version)}`;
+    return `${readable}:${hashString(stableStringify(descriptor))}`;
+}
+function buildScopeKey(scope) {
+    const canonical = {
+        appNamespace: sanitizeSegment(scope.appNamespace),
+        origin: normalizeOrigin(scope.origin),
+        tenantId: scope.tenantId ?? null,
+        userId: scope.userId ?? null,
+        sessionId: scope.sessionId ?? null
+    };
+    return `${canonical.appNamespace}:${hashString(stableStringify(canonical))}`;
+}
+function buildQueryKey(input) {
+    const canonical = {
+        operationId: input.operationId,
+        scopeKey: input.scopeKey,
+        requestMode: input.requestMode ?? 'cache-first',
+        requestInput: input.requestInput ?? null,
+        selectionPlan: input.selectionPlan ?? null
+    };
+    return `${input.operationId}:${hashString(stableStringify(canonical))}`;
+}
+export { buildQueryKey, buildScopeKey, createOperationId, decodeRequestEnvelopeHeader, encodeRequestEnvelopeHeader, hashString, isPlainObject, normalizeOrigin, sanitizeSegment, stableStringify };