@covenant-rpc/server 1.0.0 → 2.1.0

package/bin/sidekick.ts

@@ -0,0 +1,90 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+import { startSidekickServer } from "../sidekick/webserver";
+import { httpSidekickToServer } from "../interfaces/http";
+
+const program = new Command();
+
+program
+  .name("covenant-sidekick")
+  .description("Standalone WebSocket service for Covenant RPC realtime channels and resource invalidation")
+  .version("1.0.0")
+  .option("-p, --port <number>", "Port to listen on (env: SIDEKICK_PORT)", process.env.SIDEKICK_PORT || "3000")
+  .option("-s, --secret <string>", "Secret key for authentication (env: SIDEKICK_SECRET)", process.env.SIDEKICK_SECRET)
+  .option("--auth-delay <milliseconds>", "Delay before responding to failed auth attempts", process.env.SIDEKICK_AUTH_DELAY || "3000")
+  .option("--server-url <url>", "URL of the Covenant server to forward channel messages to (env: SIDEKICK_SERVER_URL)", process.env.SIDEKICK_SERVER_URL)
+  .option("--server-secret <string>", "Secret key for authenticating with the server (env: SIDEKICK_SERVER_SECRET)", process.env.SIDEKICK_SERVER_SECRET)
+  .addHelpText("after", `
+Environment Variables:
+  SIDEKICK_PORT           Port to listen on
+  SIDEKICK_SECRET         Secret key for authentication (required)
+  SIDEKICK_AUTH_DELAY     Auth failure delay in milliseconds
+  SIDEKICK_SERVER_URL     URL of the Covenant server for channel message forwarding (required for channels)
+  SIDEKICK_SERVER_SECRET  Secret key for authenticating with the Covenant server
+
+Examples:
+  $ covenant-sidekick --port 8080 --secret my-secret-key --server-url http://localhost:3000/api/covenant --server-secret my-server-key
+  $ SIDEKICK_SECRET=my-key covenant-sidekick --port 3001
+  $ bunx @covenant-rpc/server covenant-sidekick --secret my-key
+  `)
+  .action((options) => {
+    const port = parseInt(options.port);
+    const secret = options.secret;
+    const authFailureDelayMs = parseInt(options.authDelay);
+    const serverUrl: string | undefined = options.serverUrl;
+    const serverSecret: string | undefined = options.serverSecret;
+
+    // Validate port
+    if (isNaN(port) || port < 1 || port > 65535) {
+      console.error("Error: --port must be a valid port number (1-65535)");
+      process.exit(1);
+    }
+
+    // Validate secret
+    if (!secret) {
+      console.error("Error: Secret key is required. Provide it via --secret or SIDEKICK_SECRET environment variable.");
+      process.exit(1);
+    }
+
+    // Validate auth delay
+    if (isNaN(authFailureDelayMs) || authFailureDelayMs < 0) {
+      console.error("Error: --auth-delay must be a non-negative number");
+      process.exit(1);
+    }
+
+    if (serverUrl && !serverSecret) {
+      console.warn("Warning: --server-url provided without --server-secret. Channel message forwarding may fail authentication.");
+    }
+
+    console.log("Starting Covenant Sidekick Server...");
+    console.log(`  Port: ${port}`);
+    console.log(`  Auth failure delay: ${authFailureDelayMs}ms`);
+    if (serverUrl) {
+      console.log(`  Server URL: ${serverUrl}`);
+    }
+
+    const server = startSidekickServer({
+      port,
+      secret,
+      authFailureDelayMs,
+      serverConnection: httpSidekickToServer(serverUrl ?? "", serverSecret ?? ""),
+    });
+
+    console.log(`\nSidekick server listening on http://localhost:${port}`);
+    console.log(`WebSocket endpoint: ws://localhost:${port}/socket`);
+    console.log("\nPress Ctrl+C to stop");
+
+    // Graceful shutdown
+    const shutdown = () => {
+      console.log("\n\nShutting down gracefully...");
+      server.close(() => {
+        console.log("Server closed");
+        process.exit(0);
+      });
+    };
+
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+  });
+
+program.parse();

package/dist/bin/sidekick.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=sidekick.d.ts.map

package/dist/bin/sidekick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidekick.d.ts","sourceRoot":"","sources":["../../bin/sidekick.ts"],"names":[],"mappings":""}

package/dist/bin/sidekick.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+import { startSidekickServer } from "../sidekick/webserver";
+import { httpSidekickToServer } from "../interfaces/http";
+const program = new Command();
+program
+    .name("covenant-sidekick")
+    .description("Standalone WebSocket service for Covenant RPC realtime channels and resource invalidation")
+    .version("1.0.0")
+    .option("-p, --port <number>", "Port to listen on (env: SIDEKICK_PORT)", process.env.SIDEKICK_PORT || "3000")
+    .option("-s, --secret <string>", "Secret key for authentication (env: SIDEKICK_SECRET)", process.env.SIDEKICK_SECRET)
+    .option("--auth-delay <milliseconds>", "Delay before responding to failed auth attempts", process.env.SIDEKICK_AUTH_DELAY || "3000")
+    .option("--server-url <url>", "URL of the Covenant server to forward channel messages to (env: SIDEKICK_SERVER_URL)", process.env.SIDEKICK_SERVER_URL)
+    .option("--server-secret <string>", "Secret key for authenticating with the server (env: SIDEKICK_SERVER_SECRET)", process.env.SIDEKICK_SERVER_SECRET)
+    .addHelpText("after", `
+Environment Variables:
+  SIDEKICK_PORT           Port to listen on
+  SIDEKICK_SECRET         Secret key for authentication (required)
+  SIDEKICK_AUTH_DELAY     Auth failure delay in milliseconds
+  SIDEKICK_SERVER_URL     URL of the Covenant server for channel message forwarding (required for channels)
+  SIDEKICK_SERVER_SECRET  Secret key for authenticating with the Covenant server
+
+Examples:
+  $ covenant-sidekick --port 8080 --secret my-secret-key --server-url http://localhost:3000/api/covenant --server-secret my-server-key
+  $ SIDEKICK_SECRET=my-key covenant-sidekick --port 3001
+  $ bunx @covenant-rpc/server covenant-sidekick --secret my-key
+  `)
+    .action((options) => {
+    const port = parseInt(options.port);
+    const secret = options.secret;
+    const authFailureDelayMs = parseInt(options.authDelay);
+    const serverUrl = options.serverUrl;
+    const serverSecret = options.serverSecret;
+    // Validate port
+    if (isNaN(port) || port < 1 || port > 65535) {
+        console.error("Error: --port must be a valid port number (1-65535)");
+        process.exit(1);
+    }
+    // Validate secret
+    if (!secret) {
+        console.error("Error: Secret key is required. Provide it via --secret or SIDEKICK_SECRET environment variable.");
+        process.exit(1);
+    }
+    // Validate auth delay
+    if (isNaN(authFailureDelayMs) || authFailureDelayMs < 0) {
+        console.error("Error: --auth-delay must be a non-negative number");
+        process.exit(1);
+    }
+    if (serverUrl && !serverSecret) {
+        console.warn("Warning: --server-url provided without --server-secret. Channel message forwarding may fail authentication.");
+    }
+    console.log("Starting Covenant Sidekick Server...");
+    console.log(`  Port: ${port}`);
+    console.log(`  Auth failure delay: ${authFailureDelayMs}ms`);
+    if (serverUrl) {
+        console.log(`  Server URL: ${serverUrl}`);
+    }
+    const server = startSidekickServer({
+        port,
+        secret,
+        authFailureDelayMs,
+        serverConnection: httpSidekickToServer(serverUrl ?? "", serverSecret ?? ""),
+    });
+    console.log(`\nSidekick server listening on http://localhost:${port}`);
+    console.log(`WebSocket endpoint: ws://localhost:${port}/socket`);
+    console.log("\nPress Ctrl+C to stop");
+    // Graceful shutdown
+    const shutdown = () => {
+        console.log("\n\nShutting down gracefully...");
+        server.close(() => {
+            console.log("Server closed");
+            process.exit(0);
+        });
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+});
+program.parse();
+//# sourceMappingURL=sidekick.js.map

package/dist/bin/sidekick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidekick.js","sourceRoot":"","sources":["../../bin/sidekick.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,6 +4,6 @@ export { vanillaAdapter } from "./adapters/vanilla";
 export { Sidekick, type SidekickClient } from "./sidekick";
 export { httpServerToSidekick, httpSidekickToServer } from "./interfaces/http";
 export { emptyServerToSidekick } from "./interfaces/empty";
-export { directClientToServer } from "./interfaces/direct";
+export { directClientToServer, directSidekickToServer } from "./interfaces/direct";
 export type { LoggerLevel, Prefix } from "@covenant-rpc/core/logger";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGnF,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -4,5 +4,5 @@ export { vanillaAdapter } from "./adapters/vanilla";
 export { Sidekick } from "./sidekick";
 export { httpServerToSidekick, httpSidekickToServer } from "./interfaces/http";
 export { emptyServerToSidekick } from "./interfaces/empty";
-export { directClientToServer } from "./interfaces/direct";
+export { directClientToServer, directSidekickToServer } from "./interfaces/direct";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAuB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAuB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/interfaces/direct.d.ts

@@ -1,4 +1,5 @@
-import type { ClientToServerConnection } from "@covenant-rpc/core/interfaces";
+import type { ClientToServerConnection, SidekickToServerConnection } from "@covenant-rpc/core/interfaces";
 import type { CovenantServer } from "../server";
 export declare function directClientToServer(server: CovenantServer<any, any, any, any>, extraHeaders: Record<string, string>): ClientToServerConnection;
+export declare function directSidekickToServer(server: CovenantServer<any, any, any, any>): SidekickToServerConnection;
 //# sourceMappingURL=direct.d.ts.map

package/dist/interfaces/direct.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct.d.ts","sourceRoot":"","sources":["../../interfaces/direct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAA0D,MAAM,+BAA+B,CAAC;AAEtI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,wBAAwB,CAqG1B"}
+{"version":3,"file":"direct.d.ts","sourceRoot":"","sources":["../../interfaces/direct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE1G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,wBAAwB,CAqG1B;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GACzC,0BAA0B,CAmC5B"}

package/dist/interfaces/direct.js

@@ -95,4 +95,37 @@ export function directClientToServer(server, extraHeaders) {
         }
     };
 }
+export function directSidekickToServer(server) {
+    return {
+        async sendMessage(message) {
+            try {
+                const url = new URL("http://localhost");
+                url.searchParams.set("type", "channel");
+                const request = new Request(url.toString(), {
+                    method: "POST",
+                    body: ION.stringify(message),
+                    headers: { "Content-Type": "application/json" },
+                });
+                const response = await server.handle(request);
+                if (response.ok) {
+                    return null;
+                }
+                return {
+                    channel: message.channel,
+                    params: message.params,
+                    fault: "server",
+                    message: `Failed to send message to server. Received: ${response.status} - ${response.statusText}`,
+                };
+            }
+            catch (e) {
+                return {
+                    channel: message.channel,
+                    params: message.params,
+                    fault: "server",
+                    message: `Unknown error sending message to server: ${e}`,
+                };
+            }
+        },
+    };
+}
 //# sourceMappingURL=direct.js.map

package/dist/interfaces/direct.js.map

@@ -1 +1 @@
-{"version":3,"file":"direct.js","sourceRoot":"","sources":["../../interfaces/direct.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"direct.js","sourceRoot":"","sources":["../../interfaces/direct.ts"],"names":[],"mappings":"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"}

package/dist/sidekick/index.d.ts

@@ -23,7 +23,7 @@ export declare class Sidekick {
     private publish;
     private state;
     private logger;
-    constructor(publishFunction: PublishFunction, logLevel?: LoggerLevel);
+    constructor(publishFunction: PublishFunction, serverConnection: SidekickToServerConnection, logLevel?: LoggerLevel);
     updateResources(resources: string[]): Promise<void>;
     postServerMessage(message: ServerMessage): Promise<void>;
     addConnection(payload: ChannelConnectionPayload): void;

package/dist/sidekick/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sidekick/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAA6C,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE7J,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,MAAM,CAAC;IAChB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAChD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC,CAAA;IACF,gBAAgB,EAAE,0BAA0B,CAAC;CAC9C;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAGjG,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,MAAM,CAAS;gBAEX,eAAe,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,WAAW;IAO9D,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE;IAiBnC,iBAAiB,CAAC,OAAO,EAAE,aAAa;IAQ9C,aAAa,CAAC,OAAO,EAAE,wBAAwB;IAIzC,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB;CA8BnF;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sidekick/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAA6C,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE7J,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,MAAM,CAAC;IAChB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAChD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC,CAAA;IACF,gBAAgB,EAAE,0BAA0B,CAAC;CAC9C;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAGjG,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,QAAQ,CAAC,EAAE,WAAW;IAa5G,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE;IAiBnC,iBAAiB,CAAC,OAAO,EAAE,aAAa;IAQ9C,aAAa,CAAC,OAAO,EAAE,wBAAwB;IAIzC,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB;CA8BnF;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}

package/dist/sidekick/index.js

@@ -1,21 +1,21 @@
-import { httpSidekickToServer } from "../interfaces/http";
 import { Logger } from "../logger";
 import { handleListenMessage, handleSendMessage, handleSubscribeMessage, handleUnlistenMessage, handleUnsubscribeMessage } from "./handlers";
 import { getChannelTopicName, getResourceTopicName } from "@covenant-rpc/core/sidekick/protocol";
 export class Sidekick {
     publish;
-    state = {
-        contextMap: new Map(),
-        tokenMap: new Map(),
-        usedTokenMap: new Map(),
-        serverConnection: httpSidekickToServer("", ""),
-    };
+    state;
     logger;
-    constructor(publishFunction, logLevel) {
+    constructor(publishFunction, serverConnection, logLevel) {
         this.publish = publishFunction;
         this.logger = new Logger(logLevel ?? "info", [
             () => new Date().toUTCString(),
         ]);
+        this.state = {
+            contextMap: new Map(),
+            tokenMap: new Map(),
+            usedTokenMap: new Map(),
+            serverConnection,
+        };
     }
     async updateResources(resources) {
         const promises = [];

package/dist/sidekick/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../sidekick/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../sidekick/index.ts"],"names":[],"mappings":"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"}

package/dist/sidekick/internal.d.ts

@@ -0,0 +1,14 @@
+import type { ClientToSidekickConnection, ServerToSidekickConnection } from "@covenant-rpc/core/interfaces";
+export declare class InternalSidekick {
+    private sidekick;
+    private clients;
+    private serverCallback;
+    constructor();
+    setServerCallback(callback: (channelName: string, params: Record<string, string>, data: any, context: any) => Promise<{
+        fault: "client" | "server";
+        message: string;
+    } | null>): void;
+    getConnectionFromServer(): ServerToSidekickConnection;
+    getConnectionFromClient(): ClientToSidekickConnection;
+}
+//# sourceMappingURL=internal.d.ts.map

package/dist/sidekick/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../sidekick/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,0BAA0B,EAA8B,MAAM,+BAA+B,CAAC;AASxI,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,cAAc,CAAoK;;IAsC1L,iBAAiB,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAI7K,uBAAuB,IAAI,0BAA0B;IAsBrD,uBAAuB,IAAI,0BAA0B;CActD"}

package/dist/sidekick/internal.js

@@ -0,0 +1,119 @@
+import { Sidekick } from "../";
+// internal sidekick is good when you want you have a single server that can act as a sidekick and the core api (for example,
+// when you are not on the edge)
+export class InternalSidekick {
+    sidekick;
+    clients = [];
+    serverCallback = null;
+    constructor() {
+        const clients = this.clients;
+        const getServerCallback = () => this.serverCallback;
+        const serverConnection = {
+            async sendMessage(message) {
+                const callback = getServerCallback();
+                if (!callback) {
+                    return {
+                        fault: "server",
+                        message: "Server connection not initialized",
+                        channel: message.channel,
+                        params: message.params,
+                    };
+                }
+                const result = await callback(message.channel, message.params, message.data, message.context);
+                if (result) {
+                    return {
+                        ...result,
+                        channel: message.channel,
+                        params: message.params,
+                    };
+                }
+                return null;
+            },
+        };
+        this.sidekick = new Sidekick(async (topic, message) => {
+            const subscribed = clients.filter(c => c.isSubscribed(topic));
+            for (const s of subscribed) {
+                s.directMessage(message);
+            }
+        }, serverConnection);
+    }
+    setServerCallback(callback) {
+        this.serverCallback = callback;
+    }
+    getConnectionFromServer() {
+        // we have to do this because of the way the this
+        // keyword works in javascript
+        const sidekick = this.sidekick;
+        return {
+            // these will never fail - no network layer
+            addConnection(payload) {
+                sidekick.addConnection(payload);
+                return Promise.resolve(null);
+            },
+            async update(resources) {
+                await sidekick.updateResources(resources);
+                return null;
+            },
+            async postMessage(message) {
+                await sidekick.postServerMessage(message);
+                return null;
+            },
+        };
+    }
+    getConnectionFromClient() {
+        const client = new InternalSidekickClient();
+        const sidekick = this.sidekick;
+        this.clients.push(client);
+        return {
+            sendMessage(message) {
+                sidekick.handleClientMessage(client, message);
+            },
+            onMessage(handler) {
+                return client.addHandler(handler);
+            },
+        };
+    }
+}
+class InternalSidekickClient {
+    id;
+    subscribedTopics;
+    handlers;
+    constructor() {
+        this.id = crypto.randomUUID();
+        this.subscribedTopics = new Set();
+        this.handlers = [];
+    }
+    subscribe(topic) {
+        this.subscribedTopics.add(topic);
+    }
+    directMessage(message) {
+        for (const h of this.handlers) {
+            const p = h(message);
+            if (p instanceof Promise) {
+                p.catch((e) => {
+                    throw new Error(`Unhandlable error in message handler: ${e}`);
+                });
+            }
+        }
+    }
+    getHandlers() {
+        return this.handlers;
+    }
+    unsubscribe(topic) {
+        this.subscribedTopics.delete(topic);
+    }
+    getId() {
+        return this.id;
+    }
+    isSubscribed(topic) {
+        return this.subscribedTopics.has(topic);
+    }
+    addHandler(handler) {
+        this.handlers.push(handler);
+        return () => this.removeHandler(handler);
+    }
+    removeHandler(handler) {
+        this.handlers = this.handlers.filter(h => h !== handler);
+    }
+}
+//# sourceMappingURL=internal.js.map

package/dist/sidekick/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../sidekick/internal.ts"],"names":[],"mappings":"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"}

package/dist/sidekick/webserver.d.ts

@@ -0,0 +1,11 @@
+import { type Server } from "node:http";
+import type { SidekickToServerConnection } from "@covenant-rpc/core/interfaces";
+export interface SidekickWebserverOptions {
+    secret: string;
+    port: number;
+    serverConnection: SidekickToServerConnection;
+    /** Delay in milliseconds before responding to failed auth attempts (default: 3000) */
+    authFailureDelayMs?: number;
+}
+export declare function startSidekickServer({ port, secret, serverConnection, authFailureDelayMs }: SidekickWebserverOptions): Server;
+//# sourceMappingURL=webserver.d.ts.map

package/dist/sidekick/webserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webserver.d.ts","sourceRoot":"","sources":["../../sidekick/webserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AAGjG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAYhF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmID,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAyB,EAAE,EAAE,wBAAwB,GAAG,MAAM,CA0FnI"}

package/dist/sidekick/webserver.js

@@ -0,0 +1,197 @@
+import { createServer } from "node:http";
+import { WebSocketServer } from "ws";
+import { Sidekick } from "../";
+import { v } from "@covenant-rpc/core/validation";
+import { channelConnectionPayload, serverMessageSchema } from "@covenant-rpc/core/channel";
+import { sidekickIncomingMessageSchema } from "@covenant-rpc/core/sidekick/protocol";
+import ION from "@covenant-rpc/ion";
+async function handleResourcesRoute(req, res, ctx) {
+    if (!await ctx.validateKey(req)) {
+        res.writeHead(401).end("Key didn't match");
+        return;
+    }
+    let body;
+    try {
+        body = JSON.parse(await ctx.readBody(req));
+    }
+    catch {
+        res.writeHead(400).end("Invalid JSON");
+        return;
+    }
+    const parsed = v.parseSafe(body, v.obj({ resources: v.array(v.string()) }));
+    if (!parsed) {
+        res.writeHead(400).end("Invalid body schema");
+        return;
+    }
+    await ctx.sidekick.updateResources(parsed.resources);
+    res.writeHead(200).end("OK");
+}
+async function handleConnectionRoute(req, res, ctx) {
+    if (!await ctx.validateKey(req)) {
+        res.writeHead(401).end("Key didn't match");
+        return;
+    }
+    let body;
+    try {
+        body = ION.parse(await ctx.readBody(req));
+    }
+    catch (e) {
+        res.writeHead(400).end(`Error parsing ION: ${e}`);
+        return;
+    }
+    const payload = v.parseSafe(body, channelConnectionPayload);
+    if (!payload) {
+        res.writeHead(400).end("Did not recieve payload in correct schema");
+        return;
+    }
+    ctx.sidekick.addConnection(payload);
+    res.writeHead(200).end("OK");
+}
+async function handleMessageRoute(req, res, ctx) {
+    if (!await ctx.validateKey(req)) {
+        res.writeHead(401).end("Key didn't match");
+        return;
+    }
+    let body;
+    try {
+        body = ION.parse(await ctx.readBody(req));
+    }
+    catch (e) {
+        res.writeHead(400).end(`Error parsing ION: ${e}`);
+        return;
+    }
+    const message = v.parseSafe(body, serverMessageSchema);
+    if (!message) {
+        res.writeHead(400).end("Did not recieve message in correct schema");
+        return;
+    }
+    await ctx.sidekick.postServerMessage(message);
+    res.writeHead(200).end("OK");
+}
+async function handleWebSocketMessage(ws, raw, tracked, sidekick) {
+    let parsed;
+    try {
+        parsed = ION.parse(raw.toString());
+    }
+    catch {
+        const err = {
+            type: "error",
+            error: {
+                fault: "client",
+                message: "Failed to parse last message as an incoming message. This is a bug in covenant's client code.",
+                params: {},
+                channel: "unknown",
+            },
+        };
+        ws.send(ION.stringify(err));
+        return;
+    }
+    const message = v.parseSafe(parsed, sidekickIncomingMessageSchema);
+    if (message === null) {
+        const err = {
+            type: "error",
+            error: {
+                fault: "client",
+                message: "Failed to parse last message as an incoming message. This is a bug in covenant's client code.",
+                params: {},
+                channel: "unknown",
+            },
+        };
+        ws.send(ION.stringify(err));
+        return;
+    }
+    const client = {
+        subscribe(topic) {
+            tracked.topics.add(topic);
+        },
+        unsubscribe(topic) {
+            tracked.topics.delete(topic);
+        },
+        getId() {
+            return tracked.id;
+        },
+        directMessage(message) {
+            ws.send(ION.stringify(message));
+        },
+    };
+    await sidekick.handleClientMessage(client, message);
+}
+export function startSidekickServer({ port, secret, serverConnection, authFailureDelayMs = 3000 }) {
+    const connections = new Set();
+    const sidekick = new Sidekick(async (topic, message) => {
+        const data = ION.stringify(message);
+        for (const conn of connections) {
+            if (conn.topics.has(topic)) {
+                conn.ws.send(data);
+            }
+        }
+    }, serverConnection);
+    async function validateKey(req) {
+        const authorization = req.headers["authorization"];
+        if (authorization !== `Bearer ${secret}`) {
+            if (authFailureDelayMs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, authFailureDelayMs));
+            }
+            return false;
+        }
+        return true;
+    }
+    function readBody(req) {
+        return new Promise((resolve, reject) => {
+            let body = "";
+            req.on("data", (chunk) => { body += chunk.toString(); });
+            req.on("end", () => resolve(body));
+            req.on("error", reject);
+        });
+    }
+    const routeContext = {
+        sidekick,
+        validateKey,
+        readBody,
+    };
+    const httpServer = createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+        if (req.method !== "POST") {
+            res.writeHead(404).end("Not Found");
+            return;
+        }
+        switch (url.pathname) {
+            case "/resources":
+                await handleResourcesRoute(req, res, routeContext);
+                return;
+            case "/connection":
+                await handleConnectionRoute(req, res, routeContext);
+                return;
+            case "/message":
+                await handleMessageRoute(req, res, routeContext);
+                return;
+            default:
+                res.writeHead(404).end("Not Found");
+        }
+    });
+    const wss = new WebSocketServer({ noServer: true });
+    httpServer.on("upgrade", (req, socket, head) => {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+        if (url.pathname !== "/socket") {
+            socket.destroy();
+            return;
+        }
+        wss.handleUpgrade(req, socket, head, (ws) => {
+            const tracked = {
+                ws,
+                id: crypto.randomUUID(),
+                topics: new Set(),
+            };
+            connections.add(tracked);
+            ws.on("close", () => {
+                connections.delete(tracked);
+            });
+            ws.on("message", async (raw) => {
+                await handleWebSocketMessage(ws, raw, tracked, sidekick);
+            });
+        });
+    });
+    httpServer.listen(port);
+    return httpServer;
+}
+//# sourceMappingURL=webserver.js.map

package/dist/sidekick/webserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webserver.js","sourceRoot":"","sources":["../../sidekick/webserver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@covenant-rpc/server",
   "module": "./dist/index.js",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "type": "module",
+  "bin": {
+    "covenant-sidekick": "./bin/sidekick.ts"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -14,7 +17,8 @@
     }
   },
   "scripts": {
-    "build": "bun ../../scripts/build-package.ts ."
+    "build": "bun ../../scripts/build-package.ts .",
+    "sidekick": "bun ./bin/sidekick.ts"
   },
   "publishConfig": {
     "access": "public"
@@ -23,9 +27,14 @@
     "typescript": "^5"
   },
   "dependencies": {
-    "@covenant-rpc/core": "^1.0.0",
-    "@covenant-rpc/ion": "^2.0.0",
-    "@covenant-rpc/request-serializer": "^2.0.0"
+    "@covenant-rpc/core": "^2.0.0",
+    "@covenant-rpc/ion": "^2.1.0",
+    "@covenant-rpc/request-serializer": "^2.1.0",
+    "commander": "^12.1.0",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
   },
   "types": "./dist/index.d.ts",
   "files": [

package/dist/sidekick/socket.d.ts

@@ -1,4 +0,0 @@
-export declare class SocketSidekick {
-    constructor(ws: WebSocket);
-}
-//# sourceMappingURL=socket.d.ts.map

package/dist/sidekick/socket.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../sidekick/socket.ts"],"names":[],"mappings":"AACA,qBAAa,cAAc;gBACb,EAAE,EAAE,SAAS;CAE1B"}

package/dist/sidekick/socket.js

@@ -1,5 +0,0 @@
-export class SocketSidekick {
-    constructor(ws) {
-    }
-}
-//# sourceMappingURL=socket.js.map

package/dist/sidekick/socket.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../sidekick/socket.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,cAAc;IACzB,YAAY,EAAa;IACzB,CAAC;CACF"}