@sockethub/server 5.0.0-alpha.22 → 5.0.0-alpha.24

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;

package/dist/platform.js

@@ -26685,7 +26685,7 @@ var init_package = __esm(() => {
   package_default = {
     name: "@sockethub/schemas",
     description: "JSON schema files for validating Sockethub Activity Streams",
-    version: "3.0.0-alpha.22",
+    version: "3.0.0-alpha.24",
     type: "module",
     private: false,
     author: "Nick Jennings <nick@silverbucket.net>",
@@ -26755,7 +26755,7 @@ var init_package = __esm(() => {
       "ajv-formats": "^2.1.1",
       "ajv-formats-draft2019": "^1.6.1"
     },
-    gitHead: "1630010f605e85cc548e3323cb9694fbe3a7a18a",
+    gitHead: "e778256d7067e2743cd6807a15d39a0cc65a358d",
     types: "./dist/index.d.ts"
   };
 });
@@ -71563,7 +71563,13 @@ function errorMessage(value) {
   }
   return String(value);
 }
-var init_error = () => {};
+function isExpectedError(value) {
+  return value instanceof Error && value[EXPECTED_ERROR] === true;
+}
+var EXPECTED_ERROR;
+var init_error = __esm(() => {
+  EXPECTED_ERROR = Symbol.for("sockethub.expectedError");
+});
 
 // ../../node_modules/convict/node_modules/yargs-parser/build/index.cjs
 var require_build = __commonJS(function(exports, module) {
@@ -110492,6 +110498,7 @@ var init_observability = __esm(() => {
   noopAdapter = {
     count: () => {},
     gauge: () => {},
+    distribution: () => {},
     startAction: () => () => {}
   };
   adapter = noopAdapter;
@@ -115189,6 +115196,7 @@ var exports_sentry = {};
 __export(exports_sentry, {
   SENTRY_FLUSH_TIMEOUT_MS: () => SENTRY_FLUSH_TIMEOUT_MS,
   count: () => count2,
+  distribution: () => distribution2,
   flush: () => flush3,
   gauge: () => gauge2,
   reportError: () => reportError,
@@ -115212,9 +115220,14 @@ function gauge2(name, value, attributes = {}) {
     exports_public_api.gauge(name, value, { attributes });
   }
 }
-function startAction(platform3, action) {
+function distribution2(name, value, unit, attributes = {}) {
+  if (sentryConfig.enableMetrics) {
+    exports_public_api.distribution(name, value, { unit, attributes });
+  }
+}
+function startAction(platform3, action, additionalAttributes = {}) {
   const startedAt = performance.now();
-  const attributes = { platform: platform3, action };
+  const attributes = { platform: platform3, action, ...additionalAttributes };
   count2("sockethub.action.started", 1, attributes);
   const span = startInactiveSpan({
     name: `${platform3}.${action}`,
@@ -115226,12 +115239,7 @@ function startAction(platform3, action) {
     span.setStatus({ code: error4 ? 2 : 1 });
     span.end();
     count2(error4 ? "sockethub.action.failed" : "sockethub.action.completed", 1, attributes);
-    if (sentryConfig.enableMetrics) {
-      exports_public_api.distribution("sockethub.action.duration", duration, {
-        unit: "millisecond",
-        attributes
-      });
-    }
+    distribution2("sockethub.action.duration", duration, "millisecond", attributes);
   };
 }
 async function sendTestEvent() {
@@ -115284,7 +115292,7 @@ var init_sentry = __esm(async () => {
   setTag("service", "sockethub");
   setTag("process", process.env.SOCKETHUB_PLATFORM_CHILD === "1" ? "platform" : "server");
   logger2.info("initialized sentry observability");
-  setObservabilityAdapter({ count: count2, gauge: gauge2, startAction });
+  setObservabilityAdapter({ count: count2, gauge: gauge2, distribution: distribution2, startAction });
 });
 
 // ../data-layer/src/index.ts
@@ -136951,7 +136959,14 @@ async function startPlatformProcess() {
             } catch {
               message = errorMessage(err);
             }
-            sentry.reportError(new Error(message));
+            if (isExpectedError(err)) {
+              sentry.count?.("platform.job.expected_failure", 1, {
+                platform: platformName,
+                type: job.msg.type
+              });
+            } else {
+              sentry.reportError(new Error(message));
+            }
             reject(new Error(message));
           } else {
             jobLog.debug(`completed ${job.title} ${job.msg.type}`);
@@ -137077,4 +137092,4 @@ export {
   mergePackageConfig
 };
 
-//# debugId=6CD4B2D6787607E264756E2164756E21
+//# debugId=22D352D86E997D3764756E2164756E21