@absolutejs/absolute 0.19.0-beta.350 → 0.19.0-beta.352

package/dist/index.js

@@ -209194,6 +209194,9 @@ var CLOSING_PAGE_TAG_REGEX = /<\/body>\s*<\/html>\s*$/i;
 var STREAMING_RUNTIME_GLOBAL = "__ABS_SLOT_ENQUEUE__";
 var STREAMING_PENDING_GLOBAL = "__ABS_SLOT_PENDING__";
 var STREAM_TAIL_LOOKBEHIND = 128;
+var STREAMING_SLOT_TIMEOUT_MS = 5000;
+var STREAMING_SLOT_MAX_PER_RESPONSE = 128;
+var STREAMING_SLOT_MAX_HTML_BYTES = 64000;
 var createSlotPlaceholderId = (id) => `${SLOT_PLACEHOLDER_PREFIX}${id}`;
 var createSlotPatchStatement = (id, html) => `(window.${STREAMING_RUNTIME_GLOBAL}||function(i,h){window.${STREAMING_PENDING_GLOBAL}=window.${STREAMING_PENDING_GLOBAL}||{};window.${STREAMING_PENDING_GLOBAL}[i]=h;})(${JSON.stringify(id)},${JSON.stringify(html)});`;
 var createNonceAttr = (nonce) => nonce ? ` nonce="${nonce}"` : "";
@@ -209210,32 +209213,197 @@ var injectHtmlIntoHead = (html, injection) => {
   return `${html}${injection}`;
 };
 var toUint8 = (value, encoder) => encoder.encode(value);
-var toStreamingSlot = (slot) => ({
-  ...slot,
-  id: slot.id ?? createStreamingSlotId()
+var currentStreamingSlotPolicy = {
+  timeoutMs: STREAMING_SLOT_TIMEOUT_MS,
+  fallbackHtml: "",
+  errorHtml: undefined,
+  maxSlotsPerResponse: STREAMING_SLOT_MAX_PER_RESPONSE,
+  maxSlotHtmlSizeBytes: STREAMING_SLOT_MAX_HTML_BYTES
+};
+var clonePolicy = (policy2) => ({
+  ...policy2
+});
+var normalizeSlotBytes = (value, fallback) => {
+  if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+    return Math.floor(value);
+  }
+  return fallback;
+};
+var normalizeSlotText = (value, fallback) => typeof value === "string" ? value : fallback;
+var normalizeSlotError = (value, fallback) => typeof value === "string" ? value : fallback;
+var hasPolicyValue = (policy2, key) => Object.prototype.hasOwnProperty.call(policy2, key);
+var applyStreamingSlotPolicyOverrides = (base, overridePolicy = {}) => ({
+  timeoutMs: hasPolicyValue(overridePolicy, "timeoutMs") ? normalizeSlotBytes(overridePolicy.timeoutMs, base.timeoutMs) : base.timeoutMs,
+  fallbackHtml: hasPolicyValue(overridePolicy, "fallbackHtml") ? normalizeSlotText(overridePolicy.fallbackHtml, "") : base.fallbackHtml,
+  errorHtml: hasPolicyValue(overridePolicy, "errorHtml") ? normalizeSlotError(overridePolicy.errorHtml) : base.errorHtml,
+  maxSlotsPerResponse: hasPolicyValue(overridePolicy, "maxSlotsPerResponse") ? normalizeSlotBytes(overridePolicy.maxSlotsPerResponse, base.maxSlotsPerResponse) : base.maxSlotsPerResponse,
+  maxSlotHtmlSizeBytes: hasPolicyValue(overridePolicy, "maxSlotHtmlSizeBytes") ? normalizeSlotBytes(overridePolicy.maxSlotHtmlSizeBytes, base.maxSlotHtmlSizeBytes) : base.maxSlotHtmlSizeBytes,
+  onError: hasPolicyValue(overridePolicy, "onError") ? overridePolicy.onError : base.onError,
+  onSlotMetric: hasPolicyValue(overridePolicy, "onSlotMetric") ? overridePolicy.onSlotMetric : base.onSlotMetric
+});
+var createCombinedSlotErrorHandler = (policyOnError, enhancerOnError) => {
+  if (!policyOnError && !enhancerOnError)
+    return;
+  return (error, slot) => {
+    policyOnError?.(error, slot);
+    enhancerOnError?.(error, slot);
+  };
+};
+var createCombinedSlotMetricHandler = (policyOnSlotMetric, callOnSlotMetric) => {
+  if (!policyOnSlotMetric && !callOnSlotMetric)
+    return;
+  return (metric) => {
+    policyOnSlotMetric?.(metric);
+    callOnSlotMetric?.(metric);
+  };
+};
+var resolveStreamingSlotPolicy = (overridePolicy = {}) => {
+  const base = getStreamingSlotPolicy();
+  return applyStreamingSlotPolicyOverrides(base, overridePolicy);
+};
+var getStreamingSlotPolicy = () => clonePolicy(currentStreamingSlotPolicy);
+var setStreamingSlotPolicy = (policy2 = {}) => {
+  const base = getStreamingSlotPolicy();
+  currentStreamingSlotPolicy = applyStreamingSlotPolicyOverrides(base, policy2);
+};
+var withStreamingSlotPolicy = async (policy2, callback) => {
+  const previous = getStreamingSlotPolicy();
+  setStreamingSlotPolicy(policy2);
+  try {
+    return await callback();
+  } finally {
+    currentStreamingSlotPolicy = previous;
+  }
+};
+var emitSlotMetric = (metric, onSlotMetric) => {
+  onSlotMetric?.(metric);
+};
+var createTimeoutError = (slot, timeoutMs) => {
+  const error = new Error(`Streaming slot "${slot.id}" timed out after ${timeoutMs}ms`);
+  error.__absTimeout = true;
+  return error;
+};
+var toStreamingSlot = (slot, policy2) => ({
+  errorHtml: slot.errorHtml === undefined ? policy2.errorHtml : slot.errorHtml,
+  fallbackHtml: normalizeSlotText(slot.fallbackHtml, policy2.fallbackHtml),
+  id: slot.id ?? createStreamingSlotId(),
+  timeoutMs: normalizeSlotBytes(slot.timeoutMs, policy2.timeoutMs),
+  resolve: slot.resolve
 });
-var resolveSlot = async (slot, onError) => {
+var prepareSlots = ({
+  policy: policy2,
+  slots,
+  onError,
+  onSlotMetric
+}) => {
+  const preparedSlots = slots.map((slot) => toStreamingSlot(slot, policy2));
+  const maxSlotsPerResponse = policy2.maxSlotsPerResponse;
+  if (maxSlotsPerResponse === 0) {
+    const error = new Error("Streaming slot limit is set to 0");
+    for (const slot of preparedSlots) {
+      onError?.(error, slot);
+      emitSlotMetric({
+        type: "dropped",
+        slotId: slot.id,
+        reason: "maxSlotsPerResponse is 0"
+      }, onSlotMetric);
+    }
+    return [];
+  }
+  if (preparedSlots.length <= maxSlotsPerResponse) {
+    preparedSlots.forEach((slot) => emitSlotMetric({
+      type: "prepared",
+      slotId: slot.id
+    }, onSlotMetric));
+    return preparedSlots;
+  }
+  const keptSlots = preparedSlots.slice(0, maxSlotsPerResponse);
+  const droppedSlots = preparedSlots.slice(maxSlotsPerResponse);
+  droppedSlots.forEach((slot) => {
+    onError?.(new Error(`Streaming slot "${slot.id}" dropped because ${maxSlotsPerResponse} slots is the configured maximum`), slot);
+    emitSlotMetric({
+      type: "dropped",
+      slotId: slot.id,
+      reason: `maxSlotsPerResponse is ${maxSlotsPerResponse}`
+    }, onSlotMetric);
+  });
+  keptSlots.forEach((slot) => emitSlotMetric({
+    type: "prepared",
+    slotId: slot.id
+  }, onSlotMetric));
+  return keptSlots;
+};
+var htmlByteLength = (value, encoder) => encoder.encode(value).length;
+var resolveSlot = async (slot, onError, policy2, onSlotMetric) => {
+  const safePolicy = policy2 ?? getStreamingSlotPolicy();
+  const encoder = new TextEncoder;
+  const start = Date.now();
   try {
-    const resolved = slot.resolve();
-    const html = typeof slot.timeoutMs === "number" && slot.timeoutMs > 0 ? await Promise.race([
-      Promise.resolve(resolved),
-      new Promise((_, reject) => setTimeout(() => reject(new Error(`Streaming slot "${slot.id}" timed out after ${slot.timeoutMs}ms`)), slot.timeoutMs))
-    ]) : await resolved;
+    const maybeAsyncValue = Promise.resolve(slot.resolve());
+    const resolved = typeof slot.timeoutMs === "number" && slot.timeoutMs > 0 ? await Promise.race([
+      maybeAsyncValue,
+      new Promise((_, reject) => setTimeout(() => {
+        reject(createTimeoutError(slot, slot.timeoutMs ?? 0));
+      }, slot.timeoutMs))
+    ]) : await maybeAsyncValue;
+    const html = typeof resolved === "string" ? resolved : `${resolved}`;
+    if (safePolicy.maxSlotHtmlSizeBytes > 0 && htmlByteLength(html, encoder) > safePolicy.maxSlotHtmlSizeBytes) {
+      const bytes2 = htmlByteLength(html, encoder);
+      const error = new Error(`Streaming slot "${slot.id}" exceeded max payload size of ${safePolicy.maxSlotHtmlSizeBytes} bytes`);
+      const durationMs2 = Date.now() - start;
+      onError?.(error, slot);
+      emitSlotMetric({
+        type: "size_exceeded",
+        slotId: slot.id,
+        durationMs: durationMs2,
+        bytes: bytes2,
+        error
+      }, onSlotMetric);
+      const fallbackHtml = typeof slot.errorHtml === "string" ? slot.errorHtml : null;
+      return {
+        html: fallbackHtml,
+        id: slot.id,
+        durationMs: durationMs2,
+        bytes: fallbackHtml === null ? 0 : htmlByteLength(fallbackHtml, encoder)
+      };
+    }
+    const durationMs = Date.now() - start;
+    const bytes = htmlByteLength(html, encoder);
+    emitSlotMetric({
+      type: "resolved",
+      slotId: slot.id,
+      durationMs,
+      bytes
+    }, onSlotMetric);
     return {
       html,
-      id: slot.id
+      id: slot.id,
+      durationMs,
+      bytes
     };
   } catch (error) {
+    const durationMs = Date.now() - start;
     onError?.(error, slot);
+    emitSlotMetric({
+      type: error?.__absTimeout === true ? "timeout" : "error",
+      slotId: slot.id,
+      durationMs,
+      error
+    }, onSlotMetric);
     if (typeof slot.errorHtml === "string") {
+      const html = slot.errorHtml;
       return {
-        html: slot.errorHtml,
-        id: slot.id
+        html,
+        id: slot.id,
+        durationMs,
+        bytes: htmlByteLength(html, encoder)
       };
     }
     return {
       html: null,
-      id: slot.id
+      id: slot.id,
+      durationMs,
+      bytes: 0
     };
   }
 };
@@ -209251,23 +209419,37 @@ var streamOutOfOrderSlots = ({
   footerHtml = "",
   headerHtml = "",
   nonce,
+  policy: policy2,
+  onSlotMetric,
   onError,
   slots
 }) => {
+  const resolvedPolicy = resolveStreamingSlotPolicy(policy2);
+  const combinedOnError = createCombinedSlotErrorHandler(resolvedPolicy.onError, onError);
+  const combinedOnSlotMetric = createCombinedSlotMetricHandler(resolvedPolicy.onSlotMetric, onSlotMetric);
+  const effectivePolicy = {
+    ...resolvedPolicy,
+    onSlotMetric: combinedOnSlotMetric
+  };
+  const preparedSlots = prepareSlots({
+    policy: effectivePolicy,
+    slots,
+    onError: combinedOnError,
+    onSlotMetric: combinedOnSlotMetric
+  });
   const encoder = new TextEncoder;
   return new ReadableStream({
     async start(controller) {
       try {
         let header = headerHtml;
-        if (!header.includes(STREAMING_RUNTIME_GLOBAL)) {
+        if (preparedSlots.length > 0 && !header.includes(STREAMING_RUNTIME_GLOBAL)) {
           header = injectHtmlIntoHead(header, renderStreamingSlotsRuntimeTag(nonce));
         }
         controller.enqueue(toUint8(header, encoder));
-        const pending = slots.map((slot) => {
-          const resolvedSlot = toStreamingSlot(slot);
-          const fallback = renderStreamingSlotPlaceholder(resolvedSlot.id, resolvedSlot.fallbackHtml ?? "");
+        const pending = preparedSlots.map((slot) => {
+          const fallback = renderStreamingSlotPlaceholder(slot.id, slot.fallbackHtml ?? "");
           controller.enqueue(toUint8(fallback, encoder));
-          return resolveSlot(resolvedSlot, onError);
+          return resolveSlot(slot, combinedOnError, effectivePolicy, combinedOnSlotMetric);
         });
         while (pending.length > 0) {
           const { original, result } = await nextResolvedSlot(pending);
@@ -209276,6 +209458,12 @@ var streamOutOfOrderSlots = ({
             pending.splice(index, 1);
           if (result.html === null)
             continue;
+          emitSlotMetric({
+            type: "patched",
+            slotId: result.id,
+            durationMs: result.durationMs,
+            bytes: result.bytes
+          }, combinedOnSlotMetric);
           controller.enqueue(toUint8(renderStreamingSlotPatchTag(result.id, result.html, nonce), encoder));
         }
         if (footerHtml.length > 0) {
@@ -209339,12 +209527,33 @@ var injectStreamingRuntimeIntoStream = (stream, nonce) => {
     }
   });
 };
-var appendStreamingSlotPatchesToStream = (stream, slots = [], { injectRuntime = true, nonce, onError } = {}) => {
+var appendStreamingSlotPatchesToStream = (stream, slots = [], {
+  injectRuntime = true,
+  nonce,
+  onError,
+  onSlotMetric,
+  policy: policy2
+} = {}) => {
+  const resolvedPolicy = resolveStreamingSlotPolicy(policy2);
+  const combinedOnError = createCombinedSlotErrorHandler(resolvedPolicy.onError, onError);
+  const combinedOnSlotMetric = createCombinedSlotMetricHandler(resolvedPolicy.onSlotMetric, onSlotMetric);
+  const effectivePolicy = {
+    ...resolvedPolicy,
+    onSlotMetric: combinedOnSlotMetric
+  };
+  const preparedSlots = prepareSlots({
+    policy: effectivePolicy,
+    slots,
+    onError: combinedOnError,
+    onSlotMetric: combinedOnSlotMetric
+  });
+  if (preparedSlots.length === 0)
+    return stream;
   const source = injectRuntime ? injectStreamingRuntimeIntoStream(stream, nonce) : stream;
   const encoder = new TextEncoder;
   const decoder = new TextDecoder;
   const reader = source.getReader();
-  const pending = slots.map((slot) => resolveSlot(slot, onError));
+  const pending = preparedSlots.map((slot) => resolveSlot(slot, combinedOnError, effectivePolicy, combinedOnSlotMetric));
   return new ReadableStream({
     async start(controller) {
       let baseDone = false;
@@ -209401,6 +209610,12 @@ var appendStreamingSlotPatchesToStream = (stream, slots = [], { injectRuntime =
             pending.splice(index, 1);
           if (winner.result.html === null)
             continue;
+          emitSlotMetric({
+            type: "patched",
+            slotId: winner.result.id,
+            durationMs: winner.result.durationMs,
+            bytes: winner.result.bytes
+          }, combinedOnSlotMetric);
           controller.enqueue(encoder.encode(renderStreamingSlotPatchTag(winner.result.id, winner.result.html, nonce)));
         }
         if (footer.length > 0)
@@ -209459,13 +209674,14 @@ var cloneHeaders = (response) => {
   const headers = new Headers(response.headers);
   return headers;
 };
-var enhanceHtmlResponseWithStreamingSlots = (response, { nonce, onError, streamingSlots = [] } = {}) => {
+var enhanceHtmlResponseWithStreamingSlots = (response, { nonce, onError, streamingSlots = [], policy: policy2 } = {}) => {
   if (!response.body || streamingSlots.length === 0) {
     return response;
   }
   const body = appendStreamingSlotPatchesToStream(response.body, streamingSlots, {
     nonce,
-    onError
+    onError,
+    policy: policy2
   });
   return new Response(body, {
     headers: cloneHeaders(response),
@@ -216071,11 +216287,70 @@ var getEnv = (key) => {
 
 // src/utils/index.ts
 init_registerClientScript();
+
+// src/utils/streamingSlotMetricSink.ts
+var shouldEmitType = (metric, includeTypes, excludeTypes) => {
+  if (Array.isArray(includeTypes) && includeTypes.length > 0 && !includeTypes.includes(metric.type)) {
+    return false;
+  }
+  if (Array.isArray(excludeTypes) && excludeTypes.includes(metric.type)) {
+    return false;
+  }
+  return true;
+};
+var shouldSample = (sampleRate = 1) => {
+  if (!Number.isFinite(sampleRate) || sampleRate <= 0)
+    return false;
+  if (sampleRate >= 1)
+    return true;
+  return Math.random() < sampleRate;
+};
+var asAsyncReporter = (reporter, onError) => {
+  return (metric) => {
+    try {
+      const result = reporter(metric);
+      if (result && typeof result === "object" && "catch" in result && typeof result.catch === "function") {
+        result.catch((error) => onError(error, metric));
+      }
+    } catch (error) {
+      onError(error, metric);
+    }
+  };
+};
+var createStreamingSlotMetricSink = ({
+  excludeTypes,
+  includeTypes,
+  metadata: metadata2,
+  onReport,
+  onError = () => {},
+  route,
+  sampleRate = 1
+} = {}) => {
+  if (typeof onReport !== "function") {
+    return () => {};
+  }
+  const emit = asAsyncReporter(onReport, onError);
+  const safeMetadata = metadata2 ?? {};
+  return (metric) => {
+    if (!shouldSample(sampleRate))
+      return;
+    if (!shouldEmitType(metric, includeTypes, excludeTypes))
+      return;
+    emit({
+      ...metric,
+      at: Date.now(),
+      route,
+      metadata: safeMetadata
+    });
+  };
+};
 export {
   wrapPageHandlerWithStreamingSlots,
   withStreamingSlots,
+  withStreamingSlotPolicy,
   withRegisteredStreamingSlots,
   streamOutOfOrderSlots,
+  setStreamingSlotPolicy,
   setSsrContextGetter,
   serializeIslandProps,
   renderStreamingSlotsRuntimeTag,
@@ -216100,6 +216375,7 @@ export {
   handleHTMXPageRequest,
   handleHTMLPageRequest,
   getStreamingSlotsRuntimeScript,
+  getStreamingSlotPolicy,
   getSsrContextId,
   getLocalIPAddress,
   getIslandManifestKey,
@@ -216116,6 +216392,7 @@ export {
   defineIslandComponent,
   defineEnv,
   defineConfig,
+  createStreamingSlotMetricSink,
   createStreamingSlotId,
   clearAllClientScripts,
   asset,
@@ -216171,5 +216448,5 @@ export {
   ANGULAR_INIT_TIMEOUT_MS
 };
 
-//# debugId=FCBDCB12C760F79464756E2164756E21
+//# debugId=62E7CA725B66B65F64756E2164756E21
 //# sourceMappingURL=index.js.map