execute fn in a subprocess like local-run.ts

Author: vegeris

src/README.md

@@ -25,15 +25,18 @@ This library has four modes of operation:
 3. Using `self-hosted-socket-mode.ts` as the entrypoint. This establishes a persistent
    WebSocket connection to Slack using Socket Mode and maintains a long-running process that listens for events.
 4. Using `self-hosted-http-mode.ts` as the entrypoint. This starts an HTTP server that
-   accepts events via POST requests to `/events` endpoints, similar to
-   Bolt JS's HTTPReceiver.
+   accepts events via POST requests to `/events` endpoints, similar to Bolt JS's
+   HTTPReceiver. The only required environment variable is
+   `SLACK_SIGNING_SECRET`; optional variables include `PORT`,
+   `SLACK_SIGNATURE_VERIFICATION`, and `SLACK_API_URL` (e.g.
+   `SLACK_SIGNING_SECRET=xxx PORT=3000 deno run src/self-hosted-http-mode.ts`).
 
 Regardless of which mode of operation used, each runtime definition for a
 function is specified in its own file and must be the default export.
 
 ## Usage
 
-By default, your Slack app has a `/slack.json` file that defines a `get-hooks`
+By default, your Slack app has a `.slack/hooks.json` file that defines a `get-hooks`
 hook. The Slack CLI will automatically use the version of the
 `deno-slack-runtime` that is specified by the version of the `get-hooks` script
 that you're using. To use this library via the Slack CLI out of the box, use the
@@ -47,7 +50,7 @@ You also have the option to
 You can change the script that runs by specifying a new script for the `start`
 command. For instance, if you wanted to point to your local instance of this
 repo, you could accomplish that by adding a `start` command to your
-`/slack.json` file and setting it to the following:
+`.slack/hooks.json` file and setting it to the following:
 
 ```json
 {
@@ -66,9 +69,9 @@ operating this library in:
 2. Local project with a manifest file:
    `deno run -q --config=deno.jsonc --allow-read --allow-net https://deno.land/x/deno_slack_runtime@0.1.1/local-run.ts`
 3. Self-hosted socket mode:
-   `deno run -q --config=deno.jsonc --allow-read --allow-net --allow-env https://deno.land/x/deno_slack_runtime@0.1.1/self-hosted-socket-mode.ts`
+   `deno run -q --config=deno.jsonc --allow-read --allow-net --allow-run --allow-env --allow-sys=osRelease https://deno.land/x/deno_slack_runtime@0.1.1/self-hosted-socket-mode.ts`
 4. Self-hosted HTTP Receiver:
-   `deno run -q --config=deno.jsonc --allow-read --allow-net --allow-env https://deno.land/x/deno_slack_runtime@0.1.1/self-hosted-http-mode.ts`
+   `deno run -q --config=deno.jsonc --allow-read --allow-net --allow-env --allow-sys=osRelease https://deno.land/x/deno_slack_runtime@0.1.1/self-hosted-http-mode.ts`
 
 ⚠️ Don't forget to update the version specifier in the URL inside the above
 commands to match the version you want to test! You can also drop the `@` and

src/local-run.ts

@@ -56,6 +56,7 @@ export const getCommandline = function (
     "--config=deno.jsonc",
     "--allow-read",
     "--allow-env",
+    "--allow-sys=osRelease",
   ];
 
   const allowedDomains = manifest.outgoing_domains ?? [];

src/self-hosted-http-mode.ts

@@ -22,6 +22,20 @@ export interface HTTPReceiverOptions {
   slackApiUrl?: string;
 }
 
+/**
+ * Prompts the user for the Request URL to set under settings.event_subscriptions
+ * in the app manifest. Call this before apps.manifest.validate so the user can set
+ * the URL in the manifest before validation runs.
+ * @returns The trimmed URL string, or null if the user skipped (Enter with no input).
+ */
+export function promptRequestUrlForEventSubscriptions(): string | null {
+  const raw = prompt(
+    "Request URL to set under settings.event_subscriptions in your app manifest (optional; press Enter to skip):",
+  );
+  const url = raw?.trim() ?? null;
+  return url === "" ? null : url;
+}
+
 /**
  * Constant-time string comparison to mitigate timing attacks (aligned with bolt-js verify-request).
  */
@@ -93,6 +107,23 @@ async function verifySlackRequest(
   return timingSafeEqual(computedHash, signatureHash);
 }
 
+/**
+ * Parse event endpoint body like bolt-js HTTPModuleFunctions.parseHTTPRequestBody:
+ * application/x-www-form-urlencoded with a "payload" field, or raw JSON.
+ */
+// deno-lint-ignore no-explicit-any
+function parseEventRequestBody(bodyText: string, contentType: string | null): any {
+  if (contentType?.includes("application/x-www-form-urlencoded")) {
+    const params = new URLSearchParams(bodyText);
+    const payload = params.get("payload");
+    if (typeof payload === "string") {
+      return JSON.parse(payload);
+    }
+    return Object.fromEntries(params);
+  }
+  return JSON.parse(bodyText);
+}
+
 /**
  * Runs the app as an HTTP server that accepts Slack events via POST to the
  * configured endpoints. Request handling (verify → parse → ssl_check →
@@ -148,11 +179,55 @@ export const runWithHTTPReceiver = async function (
 
     // Health check endpoint
     if (request.method === "GET" && pathname === "/health") {
+      // TODO: remove
+      hookCLI.log(`[info] ${request.method} ${pathname} called`);
       return new Response("OK", { status: 200 });
     }
 
+    // POST /functions — raw invocation payload (no signature verification), same as mod.ts
+    if (request.method === "POST" && pathname === "/functions") {
+      // TODO: remove
+      hookCLI.log(`[info] ${request.method} ${pathname} called`);
+      try {
+        const body = await request.text();
+        // deno-lint-ignore no-explicit-any
+        const payload: InvocationPayload<any> = JSON.parse(body);
+        const resp = await dispatch(payload, hookCLI, (functionCallbackId) => {
+          const functionDefn = manifest.functions[functionCallbackId];
+          if (!functionDefn) {
+            throw new Error(
+              `No function definition for function callback id ${functionCallbackId} was found in the manifest! manifest.functions: ${
+                Object.keys(manifest.functions).join(", ")
+              }`,
+            );
+          }
+          const functionFile =
+            `file://${workingDirectory}/${functionDefn.source_file}`;
+          return functionFile;
+        });
+        return new Response(JSON.stringify(resp ?? {}), {
+          status: 200,
+          headers: { "Content-Type": "application/json" },
+        });
+      } catch (error) {
+        hookCLI.error("❌ Error processing /functions request:", error);
+        if (error instanceof Error && error.stack) {
+          hookCLI.error(error.stack);
+        }
+        return new Response(
+          JSON.stringify({ error: String(error) }),
+          {
+            status: 500,
+            headers: { "Content-Type": "application/json" },
+          },
+        );
+      }
+    }
+
     // Event endpoints
     if (request.method === "POST" && eventEndpoints.includes(pathname)) {
+      // TODO: remove
+      hookCLI.log(`[info] ${request.method} ${pathname} called`);
       try {
         const body = await request.text();
 
@@ -169,26 +244,27 @@ export const runWithHTTPReceiver = async function (
           }
         }
 
-        // Parse the body
-        // deno-lint-ignore no-explicit-any
-        const parsedBody: any = JSON.parse(body);
+        // Parse the body (JSON or form-encoded with payload= like bolt-js)
+        const parsedBody = parseEventRequestBody(
+          body,
+          request.headers.get("content-type"),
+        );
 
         // Log incoming event
         const eventType = parsedBody.type || parsedBody.event?.type ||
           "unknown";
         const eventId = parsedBody.event_id || "no-id";
         hookCLI.log(`📨 Received event: ${eventType} (${eventId})`);
 
-        // Handle URL verification challenge
+        // Handle URL verification challenge (response format matches bolt-js
+        // HTTPReceiver buildUrlVerificationResponse)
         if (parsedBody.type === "url_verification") {
           hookCLI.log("✅ Responding to URL verification challenge");
-          return new Response(
-            JSON.stringify({ challenge: parsedBody.challenge }),
-            {
-              status: 200,
-              headers: { "Content-Type": "application/json" },
-            },
-          );
+          const challenge = parsedBody.challenge;
+          return new Response(JSON.stringify({ challenge }), {
+            status: 200,
+            headers: { "Content-Type": "application/json" },
+          });
         }
 
         // Handle SSL check
@@ -281,12 +357,15 @@ export const runWithHTTPReceiver = async function (
     }
 
     // 404 for unknown routes
+    // TODO: remove
+    hookCLI.log(`[info] ${request.method} ${pathname} — not found (404)`);
     return new Response("Not Found", { status: 404 });
   };
 
   // Start the server
   hookCLI.log(`🚀 Starting HTTP server on port ${port}`);
   hookCLI.log(`📡 Event endpoints: ${eventEndpoints.join(", ")}`);
+  hookCLI.log(`📮 Invocation endpoint: POST /functions`);
   hookCLI.log(`🏥 Health check: /health`);
 
   const server = Deno.serve({
@@ -345,6 +424,18 @@ if (import.meta.main) {
 
   const hookCLI = getProtocolInterface(Deno.args);
 
+  // Prompt for the Request URL before any manifest validate; caller can set it in manifest then validate
+  const requestUrl = promptRequestUrlForEventSubscriptions();
+  if (requestUrl) {
+    console.log(
+      `Set this Request URL in your app manifest under /settings/event_subscriptions: ${requestUrl}`,
+    );
+  } else {
+    console.log(
+      "Remember to set the Request URL under settings.event_subscriptions in your app manifest when using Event Subscriptions.",
+    );
+  }
+
   await runWithHTTPReceiver(
     getManifest,
     DispatchPayload,