arcane-os 0.15.0 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.15.1
+
+- Use the published `node-http-server` public lifecycle for the mail gateway.
+  Pass original requests and responses through its raw-request hook to the
+  existing mail handler, preserving complete content, provider results,
+  cancellation, and the returned native listener. Retain the disabled socket
+  inactivity timeout and use the module's listener shutdown and malformed-client
+  response handling.
+
 ## 0.15.0
 
 - Add explicit `arcane dev --http` and source API `http:true` for HTTP

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles preserve the same app URLs, theme, packaging,
 event, cancellation, and browser run contracts.
 
-This checkout defines the `0.13.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.15.1` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 

package/docs/reference/mail.md

@@ -283,6 +283,12 @@ Non-interactive structured output requires `--app-key-stdin` and redirected
 stdin. The server binds numeric loopback only; the default is
 `127.0.0.1:8025/v1/mail`.
 
+The gateway uses the published `node-http-server` instance lifecycle. Its raw
+request hook hands the original request and response directly to the mail
+handler before body parsing or static routing. Socket inactivity timeout remains
+disabled; caller-selected mail deadlines, cancellation, and complete responses
+remain owned by the mail handler.
+
 The gateway protects the provider credential by requiring:
 
 - its exact numeric-loopback `Host` authority and `/v1/mail` route;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/src/mail-server.mjs

@@ -1,6 +1,6 @@
 import Is from 'strong-type';
 import {createHash,randomUUID,timingSafeEqual} from 'node:crypto';
-import http from 'node:http';
+import {Server} from 'node-http-server';
 
 const is = new Is(false);
 
@@ -1283,40 +1283,16 @@ export function createResendMailRequestHandler(options={}){
     };
 }
 
-function listen(server,{host,port}){
+function deployMailServer(mailServer){
     return new Promise(function waitForMailListener(resolve,reject){
-        function cleanup(){
-            server.removeListener('error',onError);
-            server.removeListener('listening',onListening);
-        }
         function onError(error){
-            cleanup();
             reject(error);
         }
-        function onListening(){
-            cleanup();
-            resolve();
-        }
-        server.once('error',onError);
-        server.once('listening',onListening);
-        server.listen({exclusive:true,host,port});
-    });
-}
-
-function closeHttpServer(server){
-    return new Promise(function waitForHttpServerClose(resolve,reject){
-        if(!server.listening){
-            resolve();
-            return;
-        }
-        server.close(function finishHttpServerClose(error){
-            if(error){
-                reject(error);
-            }else{
-                resolve();
-            }
+        mailServer.deploy(function onListening(instance,server){
+            server.removeListener('error',onError);
+            resolve(server);
         });
-        server.closeIdleConnections?.();
+        mailServer.server.once('error',onError);
     });
 }
 
@@ -1325,29 +1301,27 @@ export async function startResendMailServer(options={}){
     if(configuration.signal?.aborted){
         throw configuration.signal.reason??new Error('Mail server start was cancelled.');
     }
-    const requestHandler=createResendMailRequestHandler(options);
-    const server=http.createServer(requestHandler.handle);
-    server.on('clientError',function rejectMalformedClient(error,socket){
-        if(!socket.writable){
-            return;
-        }
-        socket.end(
-            'HTTP/1.1 400 Bad Request\r\n'
-            +'Connection: close\r\n'
-            +'Content-Length: 0\r\n'
-            +'\r\n'
-        );
+    const mailServer=new Server({
+        host:configuration.host,
+        port:configuration.port,
+        server:{timeout:0}
     });
+    const requestHandler=createResendMailRequestHandler(options);
+    mailServer.onRawRequest=function handleMailRequest(request,response){
+        requestHandler.handle(request,response);
+        return true;
+    };
 
+    let server;
     try{
-        await listen(server,{host:configuration.host,port:configuration.port});
+        server=await deployMailServer(mailServer);
     }catch(error){
-        await requestHandler.close();
+        await Promise.allSettled([mailServer.close(),requestHandler.close()]);
         throw error;
     }
     const address=server.address();
     if(!address||is.string(address)||!isNumericLoopback(address.address)){
-        await Promise.allSettled([closeHttpServer(server),requestHandler.close()]);
+        await Promise.allSettled([mailServer.close(),requestHandler.close()]);
         throw configurationError('Mail server did not bind to a numeric loopback address.');
     }
     const displayHost=address.address.includes(':')?`[${address.address}]`:address.address;
@@ -1365,7 +1339,7 @@ export async function startResendMailServer(options={}){
         configuration.signal?.removeEventListener('abort',closeFromSignal);
         const handlerClosing=requestHandler.close();
         try{
-            await Promise.all([closeHttpServer(server),handlerClosing]);
+            await Promise.all([mailServer.close(),handlerClosing]);
             resolveLifecycle();
         }catch(error){
             rejectLifecycle(error);