@sockethub/server 5.0.0-alpha.23 → 5.0.0-alpha.25

package/dist/message-handlers.d.ts

@@ -21,6 +21,10 @@ export interface MessageHandlersOptions {
     clientIp?: string;
     platformSessionId?: string;
     onPlatformInstance?: (platformInstance: PlatformInstance) => void;
+    /** Bounded telemetry dimension identifying the public request path. */
+    transport?: "socket" | "http";
+    /** Called only after platform and action labels pass schema validation. */
+    onPlatformAction?: (platform: string, action: string) => void;
 }
 /**
  * Normalize middleware errors into payload-safe error responses.

package/dist/observability.d.ts

@@ -2,10 +2,21 @@ type Attributes = Record<string, string | number | boolean>;
 export interface ObservabilityAdapter {
     count(name: string, value?: number, attributes?: Attributes): void;
     gauge(name: string, value: number, attributes?: Attributes): void;
-    startAction(platform: string, action: string): (error?: boolean) => void;
+    distribution(name: string, value: number, unit: string, attributes?: Attributes): void;
+    startAction(platform: string, action: string, attributes?: Attributes): (error?: boolean) => void;
 }
 export declare function setObservabilityAdapter(next: ObservabilityAdapter): void;
 export declare const observability: ObservabilityAdapter;
+export interface ConnectionTelemetry {
+    recordPlatform(platform: string): void;
+    end(): void;
+}
+/**
+ * Aggregate one socket connection without exporting its socket/session id.
+ * Platform names have already come from the validated registry by the time
+ * recordPlatform is called.
+ */
+export declare function startConnectionTelemetry(): ConnectionTelemetry;
 export declare function resetObservabilityForTesting(): void;
 /** Remove common network/user identifiers before forwarding operational logs. */
 export declare function redactObservabilityLog(message: string): string;