@absolutejs/absolute 0.19.0-beta.1074 → 0.19.0-beta.1076

package/dist/src/angular/components/constants.d.ts

@@ -75,6 +75,8 @@ export declare const TWO_THIRDS: number;
 export declare const UNFOUND_INDEX = -1;
 export declare const WEBSOCKET_NORMAL_CLOSURE = 1000;
 export declare const DEFAULT_WEBSOCKET_IDLE_TIMEOUT_SECONDS = 240;
+export declare const DEFAULT_HTTP_IDLE_TIMEOUT_SECONDS = 240;
+export declare const MAX_HTTP_IDLE_TIMEOUT_SECONDS = 255;
 export declare const WORKSPACE_COMMAND_ARGS_OFFSET = 3;
 export declare const WORKSPACE_FAILURE_LOG_PRINT_LIMIT = 30;
 export declare const WORKSPACE_FAILURE_RECENT_LOG_LIMIT = 60;

package/dist/src/constants.d.ts

@@ -75,6 +75,8 @@ export declare const TWO_THIRDS: number;
 export declare const UNFOUND_INDEX = -1;
 export declare const WEBSOCKET_NORMAL_CLOSURE = 1000;
 export declare const DEFAULT_WEBSOCKET_IDLE_TIMEOUT_SECONDS = 240;
+export declare const DEFAULT_HTTP_IDLE_TIMEOUT_SECONDS = 240;
+export declare const MAX_HTTP_IDLE_TIMEOUT_SECONDS = 255;
 export declare const WORKSPACE_COMMAND_ARGS_OFFSET = 3;
 export declare const WORKSPACE_FAILURE_LOG_PRINT_LIMIT = 30;
 export declare const WORKSPACE_FAILURE_RECENT_LOG_LIMIT = 60;

package/dist/src/core/pageResponseCache.d.ts

@@ -2,8 +2,22 @@ export declare const STREAMING_PAGE_HEADER = "x-absolute-stream";
 /** Headers for a STREAMING html page response — `text/html` plus the streaming
  *  marker so {@link withPageCacheHeaders} marks it `no-cache` (no ETag). */
 export declare const streamingPageHeaders: (extra?: HeadersInit) => Headers;
+/** Options for {@link withPageCacheHeaders}. */
+export type PageCacheOptions = {
+    /** Opt a *streaming* page into the buffered-ETag path: buffer its whole
+     *  body before sending so it can carry a content-hash `ETag` and serve a
+     *  `304` on repeat visits. This trades streaming's fast first byte for the
+     *  revalidation saving, so only set it on pages whose output is static
+     *  enough that the 304 is worth losing the stream (e.g. a marketing page).
+     *  No effect on already-buffered pages — those are ETagged regardless. */
+    bufferStreamForEtag?: boolean;
+};
 /** Apply the SPA cache policy to a page Response. HTML gets `no-cache` (+ a
  *  content-hash `ETag` / `304` for buffered responses); non-HTML responses
  *  (redirects, JSON, etc.) pass through untouched. Safe to call on every page
- *  handler's final response. */
-export declare const withPageCacheHeaders: (response: Response, request?: Request) => Promise<Response>;
+ *  handler's final response.
+ *
+ *  Streaming pages skip the ETag (their headers flush before the body renders)
+ *  unless the caller passes `bufferStreamForEtag`, which buffers the stream so
+ *  it can be hashed — see {@link PageCacheOptions}. */
+export declare const withPageCacheHeaders: (response: Response, request?: Request, options?: PageCacheOptions) => Promise<Response>;

package/dist/src/react/pageHandler.d.ts

@@ -2,6 +2,11 @@ import type { ComponentType as ReactComponent } from 'react';
 import { type StreamingSlotEnhancerOptions } from '../core/responseEnhancers';
 type ReactPageRenderOptions = StreamingSlotEnhancerOptions & {
     collectStreamingSlots?: boolean;
+    /** Buffer this page's stream so it can carry a content-hash `ETag` and
+     *  serve a `304` on repeat visits, at the cost of streaming's fast first
+     *  byte. Only worth it on pages static enough that the 304 beats the
+     *  stream. See {@link PageCacheOptions.bufferStreamForEtag}. */
+    bufferStreamForEtag?: boolean;
 };
 export type ReactPageRequestInput<Props extends Record<string, unknown> = Record<never, never>> = ReactPageRenderOptions & {
     Page: ReactComponent<Props>;

package/dist/src/svelte/pageHandler.d.ts

@@ -5,6 +5,11 @@ export type SveltePageRenderOptions = {
     collectStreamingSlots?: boolean;
     bodyContent?: string;
     headContent?: string;
+    /** Buffer this page's stream so it can carry a content-hash `ETag` and
+     *  serve a `304` on repeat visits, at the cost of streaming's fast first
+     *  byte. Only worth it on pages static enough that the 304 beats the
+     *  stream. See {@link PageCacheOptions.bufferStreamForEtag}. */
+    bufferStreamForEtag?: boolean;
 } & StreamingSlotEnhancerOptions;
 type HasNoSvelteProps<Props> = [Props] extends [never] ? true : keyof Props extends never ? true : false;
 export type SveltePageRequestInput<Component extends SvelteComponent<never> = SvelteComponent<Record<never, never>>> = SveltePageRenderOptions & {

package/dist/src/vue/pageHandler.d.ts

@@ -3,6 +3,11 @@ import type { VuePropsOf } from '../../types/vue';
 import { type StreamingSlotEnhancerOptions } from '../core/responseEnhancers';
 type VuePageRenderOptions = StreamingSlotEnhancerOptions & {
     collectStreamingSlots?: boolean;
+    /** Buffer this page's stream so it can carry a content-hash `ETag` and
+     *  serve a `304` on repeat visits, at the cost of streaming's fast first
+     *  byte. Only worth it on pages static enough that the 304 beats the
+     *  stream. See {@link PageCacheOptions.bufferStreamForEtag}. */
+    bufferStreamForEtag?: boolean;
 };
 /** Hydration mode for the page bundle.
  *  - `'auto'` (default): emit `<script>window.__INITIAL_PROPS__=…</script>`

package/dist/svelte/index.js

@@ -134,7 +134,7 @@ var resolveExportPath = (entry, conditions) => {
 var init_resolvePackageImport = () => {};
 
 // src/constants.ts
-var ANGULAR_INIT_TIMEOUT_MS = 500, ANSI_ESCAPE_CODE = 27, ANSI_ESCAPE_LENGTH = 3, ASCII_SPACE = 32, BASE_36_RADIX = 36, BUN_BUILD_WARNING_SUPPRESSION = "wildcard sideEffects are not supported yet", TAILWIND_BUN_CSS_WARNING_PATTERN, BODY_SLICE_LENGTH = 2000, BYTES_PER_KILOBYTE = 1024, CLI_ARGS_OFFSET = 3, CSS_ERROR_RESOLVE_DELAY_MS = 50, CSS_MAX_CHECK_ATTEMPTS = 10, CSS_MAX_PARSE_TIMEOUT_MS = 500, CSS_SHEET_READY_TIMEOUT_MS = 100, DEFAULT_CHUNK_SIZE = 16384, DEFAULT_DEBOUNCE_MS = 15, DEFAULT_PORT = 3000, DEV_SERVER_RESTART_DEBOUNCE_MS = 100, DOM_UPDATE_DELAY_MS = 50, FILE_PROTOCOL_PREFIX_LENGTH = 7, FOCUS_ID_PREFIX_LENGTH = 3, FOCUS_IDX_PREFIX_LENGTH = 4, FOCUS_NAME_PREFIX_LENGTH = 5, ESLINT_STUDIO_DEFAULT_HOST = "eslint.absolute.localhost", ESLINT_STUDIO_DEFAULT_PORT = 4099, CONFIG_DEFAULT_HOST = "config.absolute.localhost", CONFIG_DEFAULT_PORT = 4099, HMR_UPDATE_TIMEOUT_MS = 2000, HOOK_SIGNATURE_LENGTH = 12, EXCLUDE_LAST_OFFSET = -1, HTTP_STATUS_OK = 200, HTTP_STATUS_BAD_REQUEST = 400, HTTP_STATUS_NOT_FOUND = 404, HOURS_IN_DAY = 24, HOURS_IN_HALF_DAY = 12, IMAGE_DEFAULT_DEVICE_SIZES, IMAGE_DEFAULT_IMAGE_SIZES, IMAGE_DEFAULT_QUALITY = 75, IMAGE_GLOB_SUFFIX_LENGTH = 2, INSTANCE_PROBE_TIMEOUT_MS = 250, MAX_ERROR_LENGTH = 200, MAX_RECONNECT_ATTEMPTS = 60, MILLISECONDS_IN_A_SECOND = 1000, MINUTES_IN_AN_HOUR = 60, SECONDS_IN_A_MINUTE = 60, MILLISECONDS_IN_A_MINUTE, MILLISECONDS_IN_A_DAY, OVERLAY_FADE_DURATION_MS = 150, PING_INTERVAL_MS = 30000, LIST_LOG_TAIL_MAX_BYTES = 65536, LIST_TUI_COLUMN_GAP = 2, LIST_TUI_DEFAULT_HEIGHT = 28, LIST_TUI_DEFAULT_WIDTH = 100, LIST_TUI_ESCAPE_SEQUENCE_TIMEOUT_MS = 30, LIST_TUI_FOOTER_LINE_COUNT = 2, LIST_TUI_MARKER_WIDTH = 2, LIST_TUI_MIN_LOG_HEIGHT = 3, LIST_TUI_MIN_URL_WIDTH = 16, LIST_TUI_RENDER_DEBOUNCE_MS = 16, LIST_TUI_STATUS_MESSAGE_TIMEOUT_MS = 4000, LIST_WATCH_REFRESH_MS = 1000, RAF_BATCH_COUNT = 3, RANDOM_ID_END_INDEX = 11, REBUILD_BATCH_DELAY_MS = 10, REBUILD_RELOAD_DELAY_MS = 200, RECONNECT_INITIAL_DELAY_MS = 500, RECONNECT_POLL_INTERVAL_MS = 300, REACT_STREAM_SLOT_FAST_DELAY_MS = 5, REACT_STREAM_SLOT_SLOW_DELAY_MS = 20, SIGINT_EXIT_CODE = 130, SIGTERM_EXIT_CODE = 143, SVELTE_CSS_LOAD_TIMEOUT_MS = 500, TIME_PRECISION = 2, TWO_THIRDS, UNFOUND_INDEX = -1, WEBSOCKET_NORMAL_CLOSURE = 1000, DEFAULT_WEBSOCKET_IDLE_TIMEOUT_SECONDS = 240, WORKSPACE_COMMAND_ARGS_OFFSET = 3, WORKSPACE_FAILURE_LOG_PRINT_LIMIT = 30, WORKSPACE_FAILURE_RECENT_LOG_LIMIT = 60, WORKSPACE_READY_ATTEMPT_TIMEOUT_MS = 5000, WORKSPACE_READY_PROBE_INTERVAL_MS = 250, WORKSPACE_READY_TIMEOUT_MS = 30000, WORKSPACE_SHUTDOWN_TIMEOUT_MS = 1e4, WORKSPACE_TUI_DEFAULT_HEIGHT = 28, WORKSPACE_TUI_DEFAULT_WIDTH = 100, WORKSPACE_TUI_ESCAPE_SEQUENCE_TIMEOUT_MS = 30, WORKSPACE_TUI_FOOTER_LINE_COUNT = 3, WORKSPACE_TUI_MIN_LOG_HEIGHT = 3, WORKSPACE_TUI_MIN_SERVICE_NAME_WIDTH = 7, WORKSPACE_TUI_MIN_TARGET_WIDTH = 8, WORKSPACE_TUI_MIN_WRAP_WIDTH = 12, WORKSPACE_TUI_PROMPT_CURSOR_OFFSET = 3, WORKSPACE_TUI_RECENT_LOG_LIMIT = 40, WORKSPACE_TUI_RENDER_DEBOUNCE_MS = 16, WORKSPACE_TUI_STATUS_WIDTH = 10, WORKSPACE_TUI_TARGET_PADDING_WIDTH = 6, WORKSPACE_TUI_VISIBILITY_WIDTH = 8;
+var ANGULAR_INIT_TIMEOUT_MS = 500, ANSI_ESCAPE_CODE = 27, ANSI_ESCAPE_LENGTH = 3, ASCII_SPACE = 32, BASE_36_RADIX = 36, BUN_BUILD_WARNING_SUPPRESSION = "wildcard sideEffects are not supported yet", TAILWIND_BUN_CSS_WARNING_PATTERN, BODY_SLICE_LENGTH = 2000, BYTES_PER_KILOBYTE = 1024, CLI_ARGS_OFFSET = 3, CSS_ERROR_RESOLVE_DELAY_MS = 50, CSS_MAX_CHECK_ATTEMPTS = 10, CSS_MAX_PARSE_TIMEOUT_MS = 500, CSS_SHEET_READY_TIMEOUT_MS = 100, DEFAULT_CHUNK_SIZE = 16384, DEFAULT_DEBOUNCE_MS = 15, DEFAULT_PORT = 3000, DEV_SERVER_RESTART_DEBOUNCE_MS = 100, DOM_UPDATE_DELAY_MS = 50, FILE_PROTOCOL_PREFIX_LENGTH = 7, FOCUS_ID_PREFIX_LENGTH = 3, FOCUS_IDX_PREFIX_LENGTH = 4, FOCUS_NAME_PREFIX_LENGTH = 5, ESLINT_STUDIO_DEFAULT_HOST = "eslint.absolute.localhost", ESLINT_STUDIO_DEFAULT_PORT = 4099, CONFIG_DEFAULT_HOST = "config.absolute.localhost", CONFIG_DEFAULT_PORT = 4099, HMR_UPDATE_TIMEOUT_MS = 2000, HOOK_SIGNATURE_LENGTH = 12, EXCLUDE_LAST_OFFSET = -1, HTTP_STATUS_OK = 200, HTTP_STATUS_BAD_REQUEST = 400, HTTP_STATUS_NOT_FOUND = 404, HOURS_IN_DAY = 24, HOURS_IN_HALF_DAY = 12, IMAGE_DEFAULT_DEVICE_SIZES, IMAGE_DEFAULT_IMAGE_SIZES, IMAGE_DEFAULT_QUALITY = 75, IMAGE_GLOB_SUFFIX_LENGTH = 2, INSTANCE_PROBE_TIMEOUT_MS = 250, MAX_ERROR_LENGTH = 200, MAX_RECONNECT_ATTEMPTS = 60, MILLISECONDS_IN_A_SECOND = 1000, MINUTES_IN_AN_HOUR = 60, SECONDS_IN_A_MINUTE = 60, MILLISECONDS_IN_A_MINUTE, MILLISECONDS_IN_A_DAY, OVERLAY_FADE_DURATION_MS = 150, PING_INTERVAL_MS = 30000, LIST_LOG_TAIL_MAX_BYTES = 65536, LIST_TUI_COLUMN_GAP = 2, LIST_TUI_DEFAULT_HEIGHT = 28, LIST_TUI_DEFAULT_WIDTH = 100, LIST_TUI_ESCAPE_SEQUENCE_TIMEOUT_MS = 30, LIST_TUI_FOOTER_LINE_COUNT = 2, LIST_TUI_MARKER_WIDTH = 2, LIST_TUI_MIN_LOG_HEIGHT = 3, LIST_TUI_MIN_URL_WIDTH = 16, LIST_TUI_RENDER_DEBOUNCE_MS = 16, LIST_TUI_STATUS_MESSAGE_TIMEOUT_MS = 4000, LIST_WATCH_REFRESH_MS = 1000, RAF_BATCH_COUNT = 3, RANDOM_ID_END_INDEX = 11, REBUILD_BATCH_DELAY_MS = 10, REBUILD_RELOAD_DELAY_MS = 200, RECONNECT_INITIAL_DELAY_MS = 500, RECONNECT_POLL_INTERVAL_MS = 300, REACT_STREAM_SLOT_FAST_DELAY_MS = 5, REACT_STREAM_SLOT_SLOW_DELAY_MS = 20, SIGINT_EXIT_CODE = 130, SIGTERM_EXIT_CODE = 143, SVELTE_CSS_LOAD_TIMEOUT_MS = 500, TIME_PRECISION = 2, TWO_THIRDS, UNFOUND_INDEX = -1, WEBSOCKET_NORMAL_CLOSURE = 1000, DEFAULT_WEBSOCKET_IDLE_TIMEOUT_SECONDS = 240, DEFAULT_HTTP_IDLE_TIMEOUT_SECONDS = 240, MAX_HTTP_IDLE_TIMEOUT_SECONDS = 255, WORKSPACE_COMMAND_ARGS_OFFSET = 3, WORKSPACE_FAILURE_LOG_PRINT_LIMIT = 30, WORKSPACE_FAILURE_RECENT_LOG_LIMIT = 60, WORKSPACE_READY_ATTEMPT_TIMEOUT_MS = 5000, WORKSPACE_READY_PROBE_INTERVAL_MS = 250, WORKSPACE_READY_TIMEOUT_MS = 30000, WORKSPACE_SHUTDOWN_TIMEOUT_MS = 1e4, WORKSPACE_TUI_DEFAULT_HEIGHT = 28, WORKSPACE_TUI_DEFAULT_WIDTH = 100, WORKSPACE_TUI_ESCAPE_SEQUENCE_TIMEOUT_MS = 30, WORKSPACE_TUI_FOOTER_LINE_COUNT = 3, WORKSPACE_TUI_MIN_LOG_HEIGHT = 3, WORKSPACE_TUI_MIN_SERVICE_NAME_WIDTH = 7, WORKSPACE_TUI_MIN_TARGET_WIDTH = 8, WORKSPACE_TUI_MIN_WRAP_WIDTH = 12, WORKSPACE_TUI_PROMPT_CURSOR_OFFSET = 3, WORKSPACE_TUI_RECENT_LOG_LIMIT = 40, WORKSPACE_TUI_RENDER_DEBOUNCE_MS = 16, WORKSPACE_TUI_STATUS_WIDTH = 10, WORKSPACE_TUI_TARGET_PADDING_WIDTH = 6, WORKSPACE_TUI_VISIBILITY_WIDTH = 8;
 var init_constants = __esm(() => {
   TAILWIND_BUN_CSS_WARNING_PATTERN = /invalid @ rule encountered: '@(theme|tailwind|source|utility|variant|custom-variant|apply|reference|plugin|config)'/;
   IMAGE_DEFAULT_DEVICE_SIZES = [
@@ -1176,11 +1176,12 @@ var STREAMING_PAGE_HEADER = "x-absolute-stream", HTML_CONTENT_TYPE = "text/html"
   headers.set("content-type", HTML_CONTENT_TYPE);
   headers.set(STREAMING_PAGE_HEADER, "1");
   return headers;
-}, computeEtag = (html) => `W/"${createHash2("sha1").update(html).digest("base64url")}"`, withPageCacheHeaders = async (response, request) => {
+}, computeEtag = (html) => `W/"${createHash2("sha1").update(html).digest("base64url")}"`, withPageCacheHeaders = async (response, request, options) => {
   const contentType = response.headers.get("content-type") ?? "";
   if (!contentType.includes(HTML_CONTENT_TYPE))
     return response;
-  if (response.headers.get(STREAMING_PAGE_HEADER) === "1" || !response.body) {
+  const isStreaming = response.headers.get(STREAMING_PAGE_HEADER) === "1";
+  if (isStreaming && !options?.bufferStreamForEtag || !response.body) {
     response.headers.delete(STREAMING_PAGE_HEADER);
     response.headers.set("cache-control", "no-cache");
     return response;
@@ -1194,6 +1195,7 @@ var STREAMING_PAGE_HEADER = "x-absolute-stream", HTML_CONTENT_TYPE = "text/html"
     });
   }
   const headers = new Headers(response.headers);
+  headers.delete(STREAMING_PAGE_HEADER);
   headers.set("cache-control", "no-cache");
   headers.set("etag", etag);
   return new Response(html, {
@@ -4254,7 +4256,9 @@ var handleSveltePageRequest = async (input) => {
       ...resolvedOptions,
       runtimePlacement: resolvedOptions.runtimePlacement ?? "body"
     }) : renderPageResponse(), { handlerCallsite });
-    return withPageCacheHeaders(pageResponse, input.request);
+    return withPageCacheHeaders(pageResponse, input.request, {
+      bufferStreamForEtag: input.bufferStreamForEtag
+    });
   } catch (error) {
     console.error("[SSR] Svelte render error:", error);
     const pageName = derivePageName(resolvedPagePath);
@@ -4409,5 +4413,5 @@ export {
   createTypedIsland
 };
 
-//# debugId=B8B5C4E9053927DC64756E2164756E21
+//# debugId=6FD656B7D1771C9464756E2164756E21
 //# sourceMappingURL=index.js.map