@rest-vir/implement-service 0.11.3 → 0.12.0

package/dist/implementation/implement-endpoint.d.ts

@@ -63,6 +63,18 @@ export type EndpointImplementationParams<Context = any, ServiceName extends stri
     response: ServerResponse;
     log: Readonly<ServiceLogger>;
     searchParams: SpecificEndpoint extends NoParam ? BaseSearchParams : Exclude<SpecificEndpoint, NoParam>['SearchParamsType'];
+    /** The actual running server info. */
+    server: RunningServerInfo;
+};
+/**
+ * Information passed to an endpoint or WebSocket about the currently running server.
+ *
+ * @category Internal
+ * @category Package : @rest-vir/implement-service
+ * @package [`@rest-vir/implement-service`](https://www.npmjs.com/package/@rest-vir/implement-service)
+ */
+export type RunningServerInfo = {
+    serviceOrigin: string;
 };
 /**
  * Generic parameters for {@link EndpointImplementation} that should be compatible with _any_
@@ -84,6 +96,8 @@ export type GenericEndpointImplementationParams = {
     request: ServerRequest;
     response: ServerResponse;
     log: Readonly<ServiceLogger>;
+    /** The actual running server info. */
+    server: RunningServerInfo;
 };
 /**
  * A full, type-safe endpoint implementation type.

package/dist/implementation/implement-web-socket.d.ts

@@ -4,6 +4,7 @@ import { type IncomingHttpHeaders } from 'node:http';
 import { type IsEqual } from 'type-fest';
 import { type ServerRequest, type ServerWebSocket } from '../util/data.js';
 import { type ServiceLogger } from '../util/service-logger.js';
+import { type RunningServerInfo } from './implement-endpoint.js';
 /**
  * A WebSocket implementation, with callbacks for WebSocket events.
  *
@@ -59,6 +60,8 @@ export type WebSocketImplementationParams<Context = any, ServiceName extends str
     request: ServerRequest;
     protocols: SpecificWebSocket extends NoParam ? string[] : Exclude<SpecificWebSocket, NoParam>['ProtocolsType'];
     searchParams: SpecificWebSocket extends NoParam ? BaseSearchParams : Exclude<SpecificWebSocket, NoParam>['SearchParamsType'];
+    /** The actual running server info. */
+    server: RunningServerInfo;
 } & (IsEqual<WithMessage, true> extends true ? {
     message: SpecificWebSocket extends NoParam ? any : Exclude<SpecificWebSocket, NoParam>['MessageFromClientType'];
 } : unknown);

package/dist/implementation/service-context-init.d.ts

@@ -3,7 +3,7 @@ import { type BaseServiceEndpointsInit, type BaseServiceWebSocketsInit, type End
 import { type IncomingHttpHeaders } from 'node:http';
 import { type RequireExactlyOne } from 'type-fest';
 import { type ServerRequest, type ServerResponse } from '../util/data.js';
-import { EndpointImplementationErrorOutput } from './implement-endpoint.js';
+import { EndpointImplementationErrorOutput, type RunningServerInfo } from './implement-endpoint.js';
 /**
  * User-defined service implementation Context generator.
  *
@@ -34,6 +34,8 @@ export type ContextInitParameters<ServiceName extends string = any, EndpointsIni
     requestData: EndpointsInit extends NoParam ? unknown : WithFinalEndpointProps<Values<EndpointsInit>, Extract<keyof EndpointsInit, EndpointPathBase>>['RequestType'];
     request: ServerRequest;
     response: ServerResponse;
+    /** The actual running server info. */
+    server: RunningServerInfo;
     endpointDefinition?: (EndpointsInit extends NoParam ? EndpointDefinition : WithFinalEndpointProps<Values<EndpointsInit>, Extract<keyof EndpointsInit, EndpointPathBase>>) | undefined;
     webSocketDefinition?: (WebSocketsInit extends NoParam ? WebSocketDefinition : WithFinalWebSocketProps<Values<WebSocketsInit>, Extract<keyof WebSocketsInit, EndpointPathBase>>) | undefined;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rest-vir/implement-service",
-    "version": "0.11.3",
+    "version": "0.12.0",
     "description": "Implement a service defined by @rest-vir/define-service.",
     "keywords": [
         "rest",
@@ -39,17 +39,17 @@
         "test:update": "npm test update"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.10.2",
-        "@augment-vir/common": "^31.10.2",
-        "@rest-vir/define-service": "^0.11.3",
+        "@augment-vir/assert": "^31.11.0",
+        "@augment-vir/common": "^31.11.0",
+        "@rest-vir/define-service": "^0.12.0",
         "@types/ws": "^8.18.1",
-        "fastify": "^5.2.2",
+        "fastify": "^5.3.0",
         "path-to-regexp": "^8.2.0",
-        "type-fest": "^4.39.1"
+        "type-fest": "^4.40.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.10.2",
-        "@types/node": "^22.14.0",
+        "@augment-vir/test": "^31.11.0",
+        "@types/node": "^22.14.1",
         "c8": "^10.1.3",
         "istanbul-smart-text-reporter": "^1.1.5",
         "markdown-code-example-inserter": "^3.0.3",