feat: Refactor TypedServer to use SmartServe and introduce new request handlers

- Removed legacy servertools and Express dependencies in favor of SmartServe.
- Introduced DevToolsHandler and TypedRequestHandler for handling specific routes.
- Added support for custom route registration with regex parsing.
- Implemented sitemap and feed handling with dedicated helper classes.
- Enhanced HTML response handling with reload script injection.
- Updated UtilityServiceServer and UtilityWebsiteServer to utilize new TypedServer API.
- Removed deprecated compression options and Express-based route handling.
- Added comprehensive request handling for various endpoints including robots.txt, manifest.json, and sitemap.
- Improved error handling and response formatting across the server.

ts/servertools/index.ts

@@ -1,12 +1,22 @@
-export * from './classes.server.js';
-export * from './classes.route.js';
-export * from './classes.handler.js';
-export * from './classes.handlerstatic.js';
-export * from './classes.handlerproxy.js';
-export * from './classes.handlertypedrouter.js';
+// Core utilities that don't depend on Express
 export * from './classes.compressor.js';
-import * as serviceworker from './tools.serviceworker.js';
 
-export {
-  serviceworker,
-}
+// Legacy Express-based classes - deprecated, will be removed in next major version
+// These are kept for backward compatibility but should not be used for new code
+// Use SmartServe decorator-based controllers instead
+/** @deprecated Use SmartServe directly */
+export * from './classes.server.js';
+/** @deprecated Use SmartServe @Route decorator */
+export * from './classes.route.js';
+/** @deprecated Use SmartServe @Get/@Post decorators */
+export * from './classes.handler.js';
+/** @deprecated Use SmartServe static file serving */
+export * from './classes.handlerstatic.js';
+/** @deprecated Use SmartServe custom handler */
+export * from './classes.handlerproxy.js';
+/** @deprecated Use SmartServe TypedRouter integration */
+export * from './classes.handlertypedrouter.js';
+
+// Service worker utilities - uses legacy patterns, will be migrated
+import * as serviceworker from './tools.serviceworker.js';
+export { serviceworker };

ts/servertools/tools.serviceworker.ts

@@ -1,10 +1,8 @@
 import * as plugins from '../plugins.js';
 import * as paths from '../paths.js';
 
-import * as interfaces from '../../dist_ts_interfaces/index.js'
-import { Handler } from './classes.handler.js';
+import * as interfaces from '../../dist_ts_interfaces/index.js';
 import type { TypedServer } from '../classes.typedserver.js';
-import { HandlerTypedRouter } from './classes.handlertypedrouter.js';
 
 // Lazy-loaded service worker bundle content
 let swBundleJs: string | null = null;
@@ -12,64 +10,83 @@ let swBundleJsMap: string | null = null;
 
 const loadServiceWorkerBundle = async (): Promise<void> => {
   if (swBundleJs === null) {
-    swBundleJs = await plugins.fsInstance
+    swBundleJs = (await plugins.fsInstance
       .file(plugins.path.join(paths.serviceworkerBundleDir, './serviceworker.bundle.js'))
       .encoding('utf8')
-      .read() as string;
+      .read()) as string;
   }
   if (swBundleJsMap === null) {
-    swBundleJsMap = await plugins.fsInstance
+    swBundleJsMap = (await plugins.fsInstance
       .file(plugins.path.join(paths.serviceworkerBundleDir, './serviceworker.bundle.js.map'))
       .encoding('utf8')
-      .read() as string;
+      .read()) as string;
   }
 };
 
 let swVersionInfo: interfaces.serviceworker.IRequest_Serviceworker_Backend_VersionInfo['response'] =
   null;
 
-const serviceworkerHandler = new Handler(
-  'GET',
-  async (req, res) => {
-    await loadServiceWorkerBundle();
-    if (req.path === '/serviceworker.bundle.js') {
-      res.status(200);
-      res.set('Content-Type', 'text/javascript');
-      res.write(swBundleJs + '\n' + `/** appSemVer: ${swVersionInfo?.appSemVer || 'not set'} */`);
-    } else if (req.path === '/serviceworker.bundle.js.map') {
-      res.status(200);
-      res.set('Content-Type', 'application/json');
-      res.write(swBundleJsMap);
-    }
-    res.end();
-  }
-);
-
 export const addServiceWorkerRoute = (
   typedserverInstance: TypedServer,
   swDataFunc: () => interfaces.serviceworker.IRequest_Serviceworker_Backend_VersionInfo['response']
 ) => {
-  // lets the version info as unique string;
+  // Set the version info
   swVersionInfo = swDataFunc();
 
-  // the basic stuff
-  typedserverInstance.server.addRoute('/serviceworker/*splat', serviceworkerHandler);
+  // Service worker bundle handler
+  typedserverInstance.addRoute('/serviceworker/*splat', 'GET', async (request: Request) => {
+    await loadServiceWorkerBundle();
+    const url = new URL(request.url);
+    const path = url.pathname;
 
-  // the typed stuff
-  const typedrouter = new plugins.typedrequest.TypedRouter();
+    if (path === '/serviceworker/serviceworker.bundle.js' || path === '/serviceworker.bundle.js') {
+      return new Response(
+        swBundleJs + '\n' + `/** appSemVer: ${swVersionInfo?.appSemVer || 'not set'} */`,
+        {
+          status: 200,
+          headers: { 'Content-Type': 'text/javascript' },
+        }
+      );
+    } else if (
+      path === '/serviceworker/serviceworker.bundle.js.map' ||
+      path === '/serviceworker.bundle.js.map'
+    ) {
+      return new Response(swBundleJsMap, {
+        status: 200,
+        headers: { 'Content-Type': 'application/json' },
+      });
+    }
 
-  typedrouter.addTypedHandler(
-    new plugins.typedrequest.TypedHandler<interfaces.serviceworker.IRequest_Serviceworker_Backend_VersionInfo>(
-      'serviceworker_versionInfo',
-      async (req) => {
-        const versionInfoResponse = swDataFunc();
-        return versionInfoResponse;
-      }
-    )
-  );
+    return null;
+  });
 
-  typedserverInstance.server.addRoute(
-    '/sw-typedrequest',
-    new HandlerTypedRouter(typedrouter)
-  );
+  // Typed request handler for service worker
+  typedserverInstance.addRoute('/sw-typedrequest', 'POST', async (request: Request) => {
+    try {
+      const body = await request.json();
+
+      // Create a local typed router for service worker requests
+      const typedrouter = new plugins.typedrequest.TypedRouter();
+
+      typedrouter.addTypedHandler(
+        new plugins.typedrequest.TypedHandler<interfaces.serviceworker.IRequest_Serviceworker_Backend_VersionInfo>(
+          'serviceworker_versionInfo',
+          async () => {
+            return swDataFunc();
+          }
+        )
+      );
+
+      const response = await typedrouter.routeAndAddResponse(body);
+      return new Response(plugins.smartjson.stringify(response), {
+        status: 200,
+        headers: { 'Content-Type': 'application/json' },
+      });
+    } catch (error) {
+      return new Response(JSON.stringify({ error: 'Invalid request' }), {
+        status: 400,
+        headers: { 'Content-Type': 'application/json' },
+      });
+    }
+  });
 };