@astrale-os/kernel-server 0.5.0-beta.65 → 0.5.0-beta.67

package/dist/errors/classify.d.ts

@@ -1,3 +1,11 @@
 import * as errors from '@astrale-os/kernel-protocol/errors';
 /** Convert only errors owned by an admitted Server or Protocol boundary into safe public data. */
 export declare function classifyError(input: unknown): errors.ErrorPayload;
+/**
+ * Classify the failure of one request. Its own deadline or cancellation names the failure, except an
+ * outcome already unknown: ending the request proves nothing about an effect.
+ */
+export declare function classifyRequestError(input: unknown, request: {
+    readonly timedOut: boolean;
+    readonly signal: AbortSignal;
+}): errors.ErrorPayload;

package/dist/errors/classify.js

@@ -17,6 +17,21 @@ export function classifyError(input) {
     }
     return internal(input);
 }
+/**
+ * Classify the failure of one request. Its own deadline or cancellation names the failure, except an
+ * outcome already unknown: ending the request proves nothing about an effect.
+ */
+export function classifyRequestError(input, request) {
+    if (input instanceof errors.ProtocolError &&
+        input.payload.code === errors.CODES.OUTCOME_UNKNOWN) {
+        return input.payload;
+    }
+    if (request.timedOut)
+        return publicError('DEADLINE_EXCEEDED', 'Invocation deadline exceeded.');
+    if (request.signal.aborted)
+        return publicError('CANCELLED', 'Invocation was cancelled.');
+    return classifyError(input);
+}
 function publicError(name, message) {
     return { code: errors.CODES[name], message };
 }

package/dist/errors/index.d.ts

@@ -1,5 +1,5 @@
 export { ADMISSION_RETRY_AFTER_MS, admissionRefusal, retryAfterHeaders } from './admission.js';
 export { DeliveryUnavailableError, IssuerKeysUnavailableError } from './availability.js';
-export { classifyError } from './classify.js';
+export { classifyError, classifyRequestError } from './classify.js';
 export { RequestBodyInvalidError, RequestBodyTooLargeError } from './request-body.js';
 export { ResponseBodyTooLargeError } from './response-body.js';

package/dist/errors/index.js

@@ -1,5 +1,5 @@
 export { ADMISSION_RETRY_AFTER_MS, admissionRefusal, retryAfterHeaders } from './admission.js';
 export { DeliveryUnavailableError, IssuerKeysUnavailableError } from './availability.js';
-export { classifyError } from './classify.js';
+export { classifyError, classifyRequestError } from './classify.js';
 export { RequestBodyInvalidError, RequestBodyTooLargeError } from './request-body.js';
 export { ResponseBodyTooLargeError } from './response-body.js';

package/dist/routes/routes.js

@@ -5,7 +5,7 @@ import { bundleUrl } from '@astrale-os/kernel-protocol/publication';
 import { mediaType as publicationMediaType, PATH as PUBLICATION_PATH, url as publicationUrl, } from '@astrale-os/kernel-protocol/publication/publication';
 import { reference as publicationReference } from '@astrale-os/kernel-protocol/publication/reference';
 import * as routes from '@astrale-os/kernel-protocol/routes';
-import { admissionRefusal, classifyError, RequestBodyInvalidError, RequestBodyTooLargeError, retryAfterHeaders, } from '../errors/index.js';
+import { admissionRefusal, classifyError, classifyRequestError, RequestBodyInvalidError, RequestBodyTooLargeError, retryAfterHeaders, } from '../errors/index.js';
 import { invocationContext } from '../invocation/index.js';
 import { handleDelivery } from '../publication/delivery/index.js';
 import { readPreparedPublicationSnapshot, } from '../publication/index.js';
@@ -203,16 +203,7 @@ export function mountRoutes(app, source, deliveryProvider, handler, active, next
             if (cause instanceof routes.RouteError) {
                 return nativeError({ code: errors.CODES.INVALID_REQUEST, message: 'Native route request is invalid.' }, 400, corsFor);
             }
-            if (operation.timedOut) {
-                return nativeError({
-                    code: errors.CODES.DEADLINE_EXCEEDED,
-                    message: 'Invocation deadline exceeded.',
-                }, 504, corsFor);
-            }
-            if (operation.signal.aborted) {
-                return nativeError({ code: errors.CODES.CANCELLED, message: 'Invocation was cancelled.' }, 408, corsFor);
-            }
-            const payload = classifyError(cause);
+            const payload = classifyRequestError(cause, operation);
             return nativeError(payload, errors.httpStatusOf(payload), corsFor);
         }
         finally {
@@ -396,13 +387,13 @@ async function streamResponse(stream, operation, cors) {
         const cleanup = cancelSetup('native stream setup failed');
         if (!operation.signal.aborted)
             await cleanup;
-        const payload = preStreamError(cause, operation);
+        const payload = classifyRequestError(cause, operation);
         return nativeError(payload, errors.httpStatusOf(payload), cors);
     }
     unregisterSetupCancellation();
     if (operation.signal.aborted) {
         void cancelSetup('native stream setup cancelled');
-        const payload = preStreamError(operation.signal.reason, operation);
+        const payload = classifyRequestError(operation.signal.reason, operation);
         return response({ error: payload }, errors.httpStatusOf(payload), cors());
     }
     const encoder = new TextEncoder();
@@ -487,21 +478,6 @@ async function streamResponse(stream, operation, cors) {
         },
     });
 }
-function preStreamError(cause, operation) {
-    if (operation.timedOut) {
-        return {
-            code: errors.CODES.DEADLINE_EXCEEDED,
-            message: 'Invocation deadline exceeded before the native stream began.',
-        };
-    }
-    if (operation.signal.aborted) {
-        return {
-            code: errors.CODES.CANCELLED,
-            message: 'Invocation was cancelled before the native stream began.',
-        };
-    }
-    return classifyError(cause);
-}
 function sameRoute(left, right, externalOrigin) {
     const a = new URL(left);
     const b = new URL(right);

package/dist/transport/http/handler.js

@@ -1,7 +1,7 @@
 import * as codecs from '@astrale-os/kernel-protocol/codecs';
 import * as errors from '@astrale-os/kernel-protocol/errors';
 import * as protocol from '@astrale-os/kernel-protocol/invocation';
-import { admissionRefusal, classifyError, RequestBodyInvalidError, RequestBodyTooLargeError, } from '../../errors/index.js';
+import { admissionRefusal, classifyError, classifyRequestError, RequestBodyInvalidError, RequestBodyTooLargeError, } from '../../errors/index.js';
 import { invocationContext, publicationRouteDecision, } from '../../invocation/index.js';
 import { readBoundedBody } from '../body.js';
 import { loadCodecs } from '../codecs.js';
@@ -137,11 +137,7 @@ export function createHttpHandler(config) {
                 active.extend(config.binaryDownloadTimeoutMs);
             }
             if (active.signal.aborted) {
-                const timedOut = active.timedOut;
-                return renderError(envelope.requestId, {
-                    code: timedOut ? errors.CODES.DEADLINE_EXCEEDED : errors.CODES.CANCELLED,
-                    message: timedOut ? 'Invocation deadline exceeded.' : 'Invocation was cancelled.',
-                }, outgoing, { status: timedOut ? 504 : 408 });
+                return renderError(envelope.requestId, classifyRequestError(active.signal.reason, active), outgoing);
             }
             const publication = config.currentPublication?.(request);
             if (config.currentPublication !== undefined && publication === undefined) {
@@ -202,16 +198,7 @@ export function createHttpHandler(config) {
                 return response;
             }
             catch (input) {
-                if (active.timedOut) {
-                    return renderError(envelope.requestId, {
-                        code: errors.CODES.DEADLINE_EXCEEDED,
-                        message: 'Invocation deadline exceeded.',
-                    }, outgoing, { status: 504 });
-                }
-                if (active.signal.aborted) {
-                    return renderError(envelope.requestId, { code: errors.CODES.CANCELLED, message: 'Invocation was cancelled.' }, outgoing, { status: 408 });
-                }
-                return renderError(envelope.requestId, classifyError(input), outgoing);
+                return renderError(envelope.requestId, classifyRequestError(input, active), outgoing);
             }
         }
         catch (input) {

package/dist/transport/http/render.js

@@ -105,10 +105,15 @@ function streamingBinaryHttpResponse(binary, context) {
         mediaType: binary.mediaType,
         headers: binary.headers,
     }), context.cors, true);
-    if (binary.length !== undefined)
+    if (binary.length !== undefined) {
         headers.set('content-length', String(binary.length));
-    if (delivery !== undefined)
-        headers.set('cache-control', 'private, no-store');
+        // Content-Length belongs to HTTP and an intermediary may rewrite it; the Client counts the
+        // delivered bytes against this protocol field instead.
+        headers.set(protocol.http.BINARY_LENGTH_FIELD, String(binary.length));
+    }
+    // Clients that predate the protocol length count against Content-Length, which an intermediary
+    // that re-encodes the stream would rewrite, so a compressible media type would fail delivery.
+    headers.set('cache-control', delivery === undefined ? 'no-store, no-transform' : 'private, no-store, no-transform');
     let terminal = false;
     let delivered = 0;
     let controller;
@@ -207,7 +212,9 @@ function binaryHttpHeaders(binary, cors, streaming) {
         protocol.http.REQUEST_ID_FIELD,
         protocol.http.INVOCATION_FIELD,
         protocol.http.BINARY_HEADERS_FIELD,
-        ...(streaming ? [protocol.http.BINARY_DELIVERY_FIELD] : []),
+        ...(streaming
+            ? [protocol.http.BINARY_DELIVERY_FIELD, protocol.http.BINARY_LENGTH_FIELD]
+            : []),
         ...applicationHeaders,
     ]));
     for (const [name, value] of Object.entries(binary.headers ?? {})) {

package/dist/transport/websocket/session.js

@@ -1,6 +1,6 @@
 import * as errors from '@astrale-os/kernel-protocol/errors';
 import * as protocol from '@astrale-os/kernel-protocol/invocation';
-import { admissionRefusal, classifyError } from '../../errors/index.js';
+import { admissionRefusal, classifyError, classifyRequestError } from '../../errors/index.js';
 import { ResponseBodyTooLargeError } from '../../errors/index.js';
 import { invocationContext, publicationRouteDecision, } from '../../invocation/index.js';
 import { byteLength } from '../body.js';
@@ -152,14 +152,7 @@ export function createWebSocketSession(config) {
                     return;
                 }
                 if (socket.readyState === WS_OPEN) {
-                    const error = operation.timedOut
-                        ? {
-                            code: errors.CODES.DEADLINE_EXCEEDED,
-                            message: 'Invocation deadline exceeded.',
-                        }
-                        : operation.signal.aborted
-                            ? { code: errors.CODES.CANCELLED, message: 'Invocation was cancelled.' }
-                            : classifyError(input);
+                    const error = classifyRequestError(input, operation);
                     if (error.code === errors.CODES.INTERNAL_ERROR) {
                         socket.close(1011, 'Internal error');
                         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/kernel-server",
-  "version": "0.5.0-beta.65",
+  "version": "0.5.0-beta.67",
   "description": "Portable HTTP and WebSocket boundary for Astrale invocation, publication, installation, and issuer protocols",
   "license": "Apache-2.0",
   "repository": {
@@ -33,9 +33,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@astrale-os/kernel-core": "0.9.0-beta.57",
-    "@astrale-os/kernel-dsl": "0.2.0-beta.41",
-    "@astrale-os/kernel-protocol": "0.5.0-beta.63",
+    "@astrale-os/kernel-core": "0.9.0-beta.59",
+    "@astrale-os/kernel-dsl": "0.2.0-beta.43",
+    "@astrale-os/kernel-protocol": "0.5.0-beta.65",
     "hono": "^4.6.20",
     "msgpackr": "^2.0.5"
   },