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

package/README.md

@@ -152,6 +152,17 @@ metrics and traces. Logs are opt-in. Profiling is disabled when its sample rate
 is zero. Run `sockethub --sentry-test --config /path/to/config.json` to send a
 verification event and exit.
 
+The published server package intentionally omits source maps. They accounted
+for most of the package size while providing limited value for the server
+bundles. Source maps are not uploaded to Sentry either: Sockethub does not
+currently run a release artifact upload, and its public source remains the
+debugging reference. If artifact uploads are added later, maps should remain
+excluded from npm packages.
+
+The build also leaves the Sentry runtime packages external. The package
+manager can then install the profiler binary appropriate for the deployment
+instead of the server bundle carrying binaries for every platform and Node ABI.
+
 ### Command-line params
 
 ```

package/dist/api-info.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Public API compatibility information.
+ *
+ * Both public transports publish from here — the Socket.IO `schemas`
+ * bootstrap and the HTTP actions service descriptor — so they cannot disagree
+ * on API versions. Exact package versions are deliberately absent: clients
+ * check compatibility against SemVer majors, and publishing release numbers
+ * would make deployments easy to fingerprint.
+ */
+import { type ServiceDescriptor } from "@sockethub/schemas";
+import type { PlatformMap } from "./bootstrap/load-platforms.js";
+/**
+ * The machine-readable descriptor served on a bare GET of the HTTP actions
+ * path. Its shape is published as `ServiceDescriptorSchema`.
+ */
+export declare function buildServiceDescriptor(platforms: PlatformMap): ServiceDescriptor;
+/**
+ * The platform registry payload sent to Socket.IO clients.
+ * This is the canonical source for base contexts + platform context/schema metadata.
+ */
+export declare function buildPlatformRegistryPayload(platforms: PlatformMap): {
+    apiVersion: number;
+    contexts: {
+        as: string;
+        sockethub: string;
+    };
+    platforms: {
+        id: string;
+        apiVersion: number;
+        contextUrl: string;
+        contextVersion: string;
+        schemaVersion: string;
+        types: string[];
+        schemas: {
+            credentials: true | import("ajv").SchemaObject;
+            messages: true | import("ajv").SchemaObject;
+        };
+    }[];
+};

package/dist/bootstrap/load-platforms.d.ts

@@ -7,6 +7,7 @@ export type PlatformStruct = {
     config: PlatformConfig;
     schemas: PlatformSchemaRegistry;
     version: string;
+    apiVersion: number;
     contextUrl: string;
     contextVersion: string;
     schemaVersion: string;

package/dist/http/actions.d.ts

@@ -3,16 +3,20 @@
  *
  * Accepts ActivityStreams via POST, streams NDJSON results as jobs complete,
  * and optionally caches results in Redis for idempotent replay + GET retrieval.
+ * A GET without a request id returns the public service descriptor (API
+ * versions of the server and loaded platforms).
  */
 import type { RedisConfig } from "@sockethub/data-layer";
 import { type CredentialsStoreInterface } from "@sockethub/data-layer";
 import { type Express, type RequestHandler } from "express";
+import type { PlatformMap } from "../bootstrap/load-platforms.js";
 import { createMessageHandlers } from "../message-handlers.js";
 import type ProcessManager from "../process-manager.js";
 interface HttpActionsOptions {
     processManager: ProcessManager;
     parentId: string;
     parentSecret1: string;
+    platforms: PlatformMap;
 }
 interface HttpActionsDependencies {
     getConfig?: (key: string) => unknown;