@sockethub/server 5.0.0-alpha.13 → 5.0.0-alpha.15

package/dist/listener.d.ts

@@ -1,4 +1,5 @@
 import * as HTTP from "node:http";
+import { type Express } from "express";
 import { Server, type Socket } from "socket.io";
 /**
  * Handles the initialization and access of Sockethub resources.
@@ -8,6 +9,7 @@ import { Server, type Socket } from "socket.io";
  *  - Socket.io (bidirectional websocket communication)
  */
 declare class Listener {
+    app?: Express;
     io: Server;
     http: HTTP.Server;
     /**
@@ -31,6 +33,7 @@ declare class Listener {
     private static corsOrigin;
     private startHttp;
     private static initExpress;
+    getApp(): Express;
 }
 declare const listener: Listener;
 /**

package/dist/message-handlers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared handler pipelines for socket and HTTP request paths.
+ *
+ * Keeps validation, credentials storage, and queueing logic identical so
+ * both transports behave the same.
+ */
+import type { CredentialsStoreInterface } from "@sockethub/data-layer";
+import type { ActivityStream, InternalActivityStream } from "@sockethub/schemas";
+import type PlatformInstance from "./platform-instance.js";
+import type ProcessManager from "./process-manager.js";
+export type MessageHandler<T> = (data: T, callback: (data?: T | Error) => void) => void;
+export interface MessageHandlers {
+    credentials: MessageHandler<ActivityStream>;
+    message: MessageHandler<InternalActivityStream>;
+}
+export interface MessageHandlersOptions {
+    processManager: ProcessManager;
+    sessionId: string;
+    sessionSecret: string;
+    credentialsStore: CredentialsStoreInterface;
+    clientIp?: string;
+    isSessionActive?: (sessionId: string) => boolean;
+    platformSessionId?: string;
+    onPlatformInstance?: (platformInstance: PlatformInstance) => void;
+}
+/**
+ * Normalize middleware errors into payload-safe error responses.
+ * Removes internal-only properties that must never be sent to clients.
+ */
+export declare function attachError<T extends ActivityStream>(err: unknown, msg?: T): Error | (T & {
+    sessionSecret?: string;
+});
+export declare function createMessageHandlers(options: MessageHandlersOptions): MessageHandlers;

package/dist/middleware/validate.d.ts

@@ -3,5 +3,5 @@
  */
 import { type ActivityStream } from "@sockethub/schemas";
 import { type IInitObject } from "../bootstrap/init.js";
-import type { MiddlewareChainInterface } from "../middleware.js";
-export default function validate<T extends ActivityStream>(type: "credentials" | "message", sockethubId: string, passedInitObj?: IInitObject): (msg: T, done: MiddlewareChainInterface<T>) => void;
+import type { MiddlewareHandler } from "../middleware.js";
+export default function validate<T extends ActivityStream>(type: "credentials" | "message", sockethubId: string, passedInitObj?: IInitObject): MiddlewareHandler<T>;

package/dist/platform-instance.d.ts

@@ -12,6 +12,7 @@ export interface PlatformInstanceParams {
 type EnvFormat = {
     LOG_LEVEL?: string;
     REDIS_URL: string;
+    SOCKETHUB_CREDENTIALS_TTL_MS?: string;
     SOCKETHUB_PLATFORM_CHILD?: string;
     SOCKETHUB_PLATFORM_CONFIG?: string;
     SOCKETHUB_PLATFORM_HEARTBEAT_INTERVAL_MS?: string;
@@ -45,6 +46,8 @@ export default class PlatformInstance {
     private heartbeatMonitor?;
     private heartbeatListener?;
     private heartbeatFailureHandled;
+    private replaced;
+    private shutdownResult?;
     private readonly actor?;
     constructor(params: PlatformInstanceParams);
     createQueue(): void;
@@ -55,9 +58,26 @@ export default class PlatformInstance {
      */
     isInitialized(): boolean;
     /**
-     * Destroys all references to this platform instance, internal listeners and controlled processes
+     * Marks this instance as superseded by a replacement that shares its
+     * identifier — and therefore its Redis queue name and platformInstances
+     * slot. shutdown() on a replaced instance must leave those shared
+     * resources alone: pausing/obliterating the queue would destroy the
+     * replacement's pending jobs, and deleting the map entry would evict
+     * the replacement, causing duplicate child processes (#1166).
+     */
+    markReplaced(): void;
+    /**
+     * Destroys all references to this platform instance, internal listeners and controlled processes.
+     *
+     * Single-flight: every caller shares one teardown run. A crash-close
+     * teardown pauses and obliterates the Redis queue asynchronously, so a
+     * caller about to create a replacement (ProcessManager.ensureProcess)
+     * must be able to await the teardown *already in flight* — a second,
+     * independent run would resolve while the first is still obliterating
+     * the queue name the replacement is about to reuse.
      */
     shutdown(): Promise<void>;
+    private teardown;
     /**
      * When jobs are completed or failed, we prepare the results and send them to the client socket
      */