feat(api): expose telegram TMA link in bootstrap claim

src/__tests__/server.test.ts

@@ -22,6 +22,9 @@ import { createApp } from "../server.js";
 const now = new Date().toISOString();
 const botHeaders = { "x-spawndock-bot-secret": "spawndock-dev-bot-secret" };
 
+process.env.TELEGRAM_BOT_USERNAME ??= "rustgpt_bot";
+process.env.TELEGRAM_MINI_APP_SHORT_NAME ??= "tma";
+
 function createRuntime(): Runtime {
   return {
     state: { projects: [], pairingTokens: [], deviceCredentials: [], tunnelSessions: [] },

src/config.ts

@@ -13,6 +13,8 @@ function readContainerRuntime(): "docker" | "podman" {
 export const config = {
   port: parseInt(process.env.PORT || "3000", 10),
   botSecret: process.env.SPAWNDOCK_BOT_SECRET || "spawndock-dev-bot-secret",
+  telegramBotUsername: process.env.TELEGRAM_BOT_USERNAME || "",
+  telegramMiniAppShortName: process.env.TELEGRAM_MINI_APP_SHORT_NAME || "tma",
   rateLimitRps: parseInt(process.env.RATE_LIMIT_RPS || "10", 10),
   get qwenMode() {
     return readQwenMode();

src/routes/projects.ts

@@ -4,6 +4,7 @@ import type { Runtime } from "../types.js";
 import { createProject, claimPairingToken, inspectPairingToken, resolveOwnedProjectLaunchInfo, buildLaunchUrl } from "../projects.js";
 import { saveState } from "../store.js";
 import { config } from "../config.js";
+import { buildTelegramMiniAppUrl } from "../bot/links.js";
 
 export function projectRoutes(runtime: Runtime, stateFilePath: string): Router {
   const router = Router();
@@ -93,6 +94,7 @@ export function projectRoutes(runtime: Runtime, stateFilePath: string): Router {
     saveState(stateFilePath, runtime.state);
 
     const project = result.project;
+    const telegramMiniAppUrl = resolveTelegramMiniAppUrl(project.slug);
     res.status(201).json({
       project,
       projectId: project.id,
@@ -104,6 +106,7 @@ export function projectRoutes(runtime: Runtime, stateFilePath: string): Router {
       tunnelWsUrl: `${config.publicOrigin.replace(/^http/, "ws")}${config.tunnelPath}?token=${result.deviceCredential.secret}`,
       controlPlaneUrl: config.publicOrigin,
       localPort: config.tmaLocalPort,
+      ...(telegramMiniAppUrl ? { telegramMiniAppUrl } : {}),
     });
   };
 
@@ -187,3 +190,15 @@ function readOwnerTelegramId(value: unknown): number | null {
 
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+
+function resolveTelegramMiniAppUrl(projectSlug: string): string | null {
+  if (config.telegramBotUsername.length === 0) {
+    return null;
+  }
+
+  return buildTelegramMiniAppUrl(
+    config.telegramBotUsername,
+    config.telegramMiniAppShortName,
+    projectSlug,
+  );
+}