@tmhs/mobile-mcp 0.7.0 → 0.9.0

package/dist/tools/setupI18n.js

@@ -0,0 +1,155 @@
+import { z } from "zod";
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { textResponse, errorResponse } from "../types.js";
+const inputSchema = {
+    project_path: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project root. Defaults to cwd."),
+    framework: z
+        .enum(["expo", "flutter"])
+        .optional()
+        .default("expo")
+        .describe("Project framework (default: expo)."),
+    default_locale: z
+        .string()
+        .optional()
+        .default("en")
+        .describe("Default locale code (default: en)."),
+    additional_locales: z
+        .array(z.string())
+        .optional()
+        .default([])
+        .describe("Additional locale codes to create placeholder files for (e.g. ['es', 'fr', 'de'])."),
+};
+function generateExpoI18nConfig(defaultLocale) {
+    return `import i18n from "i18next";
+import { initReactI18next } from "react-i18next";
+import { getLocales } from "expo-localization";
+import ${defaultLocale} from "./${defaultLocale}.json";
+
+const deviceLocale = getLocales()[0]?.languageCode ?? "${defaultLocale}";
+
+i18n.use(initReactI18next).init({
+  resources: {
+    ${defaultLocale}: { translation: ${defaultLocale} },
+  },
+  lng: deviceLocale,
+  fallbackLng: "${defaultLocale}",
+  interpolation: {
+    escapeValue: false,
+  },
+});
+
+export default i18n;
+`;
+}
+function generateLocaleJson(locale) {
+    return JSON.stringify({
+        common: {
+            ok: locale === "en" ? "OK" : `[${locale}] OK`,
+            cancel: locale === "en" ? "Cancel" : `[${locale}] Cancel`,
+            save: locale === "en" ? "Save" : `[${locale}] Save`,
+            delete: locale === "en" ? "Delete" : `[${locale}] Delete`,
+            loading: locale === "en" ? "Loading..." : `[${locale}] Loading...`,
+        },
+        errors: {
+            generic: locale === "en" ? "Something went wrong" : `[${locale}] Something went wrong`,
+            network: locale === "en" ? "Check your internet connection" : `[${locale}] Check your internet connection`,
+        },
+    }, null, 2);
+}
+function generateFlutterL10nYaml(defaultLocale) {
+    return `arb-dir: lib/l10n
+template-arb-file: app_${defaultLocale}.arb
+output-localization-file: app_localizations.dart
+output-class: AppLocalizations
+`;
+}
+function generateArbFile(locale) {
+    const data = {
+        "@@locale": locale,
+        ok: locale === "en" ? "OK" : `[${locale}] OK`,
+        "@ok": JSON.stringify({ description: "Generic OK button label" }),
+        cancel: locale === "en" ? "Cancel" : `[${locale}] Cancel`,
+        "@cancel": JSON.stringify({ description: "Generic Cancel button label" }),
+        save: locale === "en" ? "Save" : `[${locale}] Save`,
+        "@save": JSON.stringify({ description: "Generic Save button label" }),
+        errorGeneric: locale === "en" ? "Something went wrong" : `[${locale}] Something went wrong`,
+        "@errorGeneric": JSON.stringify({ description: "Generic error message" }),
+    };
+    return JSON.stringify(data, null, 2);
+}
+export function register(server) {
+    server.tool("mobile_setupI18n", "Initialize internationalization (i18n) config with locale files and translation structure. Supports i18next for Expo and flutter_localizations for Flutter.", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            const locales = [args.default_locale, ...args.additional_locales];
+            const filesCreated = [];
+            if (args.framework === "flutter") {
+                const l10nDir = join(root, "lib", "l10n");
+                mkdirSync(l10nDir, { recursive: true });
+                const l10nYamlPath = join(root, "l10n.yaml");
+                if (!existsSync(l10nYamlPath)) {
+                    writeFileSync(l10nYamlPath, generateFlutterL10nYaml(args.default_locale), "utf-8");
+                    filesCreated.push(l10nYamlPath);
+                }
+                for (const locale of locales) {
+                    const arbPath = join(l10nDir, `app_${locale}.arb`);
+                    if (!existsSync(arbPath)) {
+                        writeFileSync(arbPath, generateArbFile(locale), "utf-8");
+                        filesCreated.push(arbPath);
+                    }
+                }
+                return textResponse(JSON.stringify({
+                    success: true,
+                    framework: "flutter",
+                    files_created: filesCreated,
+                    default_locale: args.default_locale,
+                    locales,
+                    next_steps: [
+                        "Add flutter_localizations to pubspec.yaml dependencies",
+                        "Add generate: true to pubspec.yaml",
+                        "Import and add AppLocalizations.delegate to MaterialApp localizationsDelegates",
+                        "Add AppLocalizations.supportedLocales to MaterialApp supportedLocales",
+                        "Run flutter gen-l10n to generate the dart files",
+                        "Use AppLocalizations.of(context)!.ok in your widgets",
+                    ],
+                }, null, 2));
+            }
+            const i18nDir = join(root, "i18n");
+            mkdirSync(i18nDir, { recursive: true });
+            for (const locale of locales) {
+                const localePath = join(i18nDir, `${locale}.json`);
+                if (!existsSync(localePath)) {
+                    writeFileSync(localePath, generateLocaleJson(locale) + "\n", "utf-8");
+                    filesCreated.push(localePath);
+                }
+            }
+            const configPath = join(i18nDir, "index.ts");
+            if (!existsSync(configPath)) {
+                writeFileSync(configPath, generateExpoI18nConfig(args.default_locale), "utf-8");
+                filesCreated.push(configPath);
+            }
+            return textResponse(JSON.stringify({
+                success: true,
+                framework: "expo",
+                files_created: filesCreated,
+                default_locale: args.default_locale,
+                locales,
+                next_steps: [
+                    "Install dependencies: npx expo install i18next react-i18next expo-localization",
+                    'Import i18n config in your app entry: import "./i18n"',
+                    'Use translations: const { t } = useTranslation(); t("common.ok")',
+                    "Add more locale files to i18n/ for each supported language",
+                    "Consider i18next-parser for extracting strings from code",
+                ],
+            }, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=setupI18n.js.map

package/dist/tools/setupI18n.js.map

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

package/dist/tools/setupRealtime.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=setupRealtime.d.ts.map

package/dist/tools/setupRealtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupRealtime.d.ts","sourceRoot":"","sources":["../../src/tools/setupRealtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiQzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyFhD"}

package/dist/tools/setupRealtime.js

@@ -0,0 +1,311 @@
+import { z } from "zod";
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { textResponse, errorResponse } from "../types.js";
+const inputSchema = {
+    project_path: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project root. Defaults to cwd."),
+    provider: z
+        .enum(["websocket", "supabase", "socketio"])
+        .optional()
+        .default("websocket")
+        .describe("Real-time provider (default: websocket)."),
+    output_directory: z
+        .string()
+        .optional()
+        .default("lib")
+        .describe("Output directory relative to project root (default: lib)."),
+};
+function generateWebSocketClient() {
+    return `type MessageHandler = (data: unknown) => void;
+
+interface WebSocketClientOptions {
+  url: string;
+  reconnect?: boolean;
+  maxRetries?: number;
+  onOpen?: () => void;
+  onClose?: () => void;
+  onError?: (error: Event) => void;
+}
+
+export class RealtimeClient {
+  private ws: WebSocket | null = null;
+  private handlers = new Map<string, Set<MessageHandler>>();
+  private retryCount = 0;
+  private url: string;
+  private options: WebSocketClientOptions;
+
+  constructor(options: WebSocketClientOptions) {
+    this.url = options.url;
+    this.options = {
+      reconnect: true,
+      maxRetries: 5,
+      ...options,
+    };
+  }
+
+  connect(): void {
+    this.ws = new WebSocket(this.url);
+
+    this.ws.onopen = () => {
+      this.retryCount = 0;
+      this.options.onOpen?.();
+    };
+
+    this.ws.onmessage = (event) => {
+      try {
+        const message = JSON.parse(event.data as string) as {
+          type: string;
+          payload: unknown;
+        };
+        const listeners = this.handlers.get(message.type);
+        if (listeners) {
+          for (const handler of listeners) {
+            handler(message.payload);
+          }
+        }
+      } catch {
+        // Non-JSON message, ignore
+      }
+    };
+
+    this.ws.onclose = () => {
+      this.options.onClose?.();
+      if (this.options.reconnect && this.retryCount < (this.options.maxRetries ?? 5)) {
+        const delay = Math.min(1000 * 2 ** this.retryCount, 30000);
+        this.retryCount++;
+        setTimeout(() => this.connect(), delay);
+      }
+    };
+
+    this.ws.onerror = (error) => {
+      this.options.onError?.(error);
+    };
+  }
+
+  on(event: string, handler: MessageHandler): () => void {
+    if (!this.handlers.has(event)) {
+      this.handlers.set(event, new Set());
+    }
+    this.handlers.get(event)!.add(handler);
+
+    return () => {
+      this.handlers.get(event)?.delete(handler);
+    };
+  }
+
+  send(type: string, payload: unknown): void {
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      this.ws.send(JSON.stringify({ type, payload }));
+    }
+  }
+
+  disconnect(): void {
+    this.options.reconnect = false;
+    this.ws?.close();
+    this.ws = null;
+    this.handlers.clear();
+  }
+}
+`;
+}
+function generateSupabaseRealtimeClient() {
+    return `import { createClient, type RealtimeChannel } from "@supabase/supabase-js";
+
+const supabaseUrl = process.env.EXPO_PUBLIC_SUPABASE_URL!;
+const supabaseAnonKey = process.env.EXPO_PUBLIC_SUPABASE_ANON_KEY!;
+
+const supabase = createClient(supabaseUrl, supabaseAnonKey);
+
+type ChangeHandler<T> = (payload: {
+  eventType: "INSERT" | "UPDATE" | "DELETE";
+  new: T;
+  old: T;
+}) => void;
+
+type PresenceHandler = (state: Record<string, unknown[]>) => void;
+
+export class RealtimeClient {
+  private channels = new Map<string, RealtimeChannel>();
+
+  subscribeToTable<T extends Record<string, unknown>>(
+    table: string,
+    onChange: ChangeHandler<T>,
+    filter?: string,
+  ): () => void {
+    const channel = supabase
+      .channel(\`table-\${table}\`)
+      .on(
+        "postgres_changes" as any,
+        {
+          event: "*",
+          schema: "public",
+          table,
+          ...(filter ? { filter } : {}),
+        },
+        (payload: any) => {
+          onChange({
+            eventType: payload.eventType,
+            new: payload.new as T,
+            old: payload.old as T,
+          });
+        },
+      )
+      .subscribe();
+
+    this.channels.set(table, channel);
+
+    return () => {
+      supabase.removeChannel(channel);
+      this.channels.delete(table);
+    };
+  }
+
+  joinPresence(
+    roomId: string,
+    userState: Record<string, unknown>,
+    onSync: PresenceHandler,
+  ): () => void {
+    const channel = supabase
+      .channel(\`presence-\${roomId}\`)
+      .on("presence", { event: "sync" }, () => {
+        const state = channel.presenceState();
+        onSync(state);
+      })
+      .subscribe(async (status) => {
+        if (status === "SUBSCRIBED") {
+          await channel.track(userState);
+        }
+      });
+
+    this.channels.set(\`presence-\${roomId}\`, channel);
+
+    return () => {
+      supabase.removeChannel(channel);
+      this.channels.delete(\`presence-\${roomId}\`);
+    };
+  }
+
+  disconnectAll(): void {
+    for (const channel of this.channels.values()) {
+      supabase.removeChannel(channel);
+    }
+    this.channels.clear();
+  }
+}
+`;
+}
+function generateSocketIOClient() {
+    return `import { io, type Socket } from "socket.io-client";
+
+type EventHandler = (...args: unknown[]) => void;
+
+interface SocketClientOptions {
+  url: string;
+  auth?: Record<string, string>;
+  reconnect?: boolean;
+}
+
+export class RealtimeClient {
+  private socket: Socket | null = null;
+  private options: SocketClientOptions;
+
+  constructor(options: SocketClientOptions) {
+    this.options = options;
+  }
+
+  connect(): void {
+    this.socket = io(this.options.url, {
+      auth: this.options.auth,
+      reconnection: this.options.reconnect ?? true,
+      reconnectionAttempts: 5,
+      reconnectionDelay: 1000,
+      reconnectionDelayMax: 30000,
+    });
+  }
+
+  on(event: string, handler: EventHandler): () => void {
+    this.socket?.on(event, handler);
+    return () => {
+      this.socket?.off(event, handler);
+    };
+  }
+
+  emit(event: string, ...args: unknown[]): void {
+    this.socket?.emit(event, ...args);
+  }
+
+  joinRoom(room: string): void {
+    this.socket?.emit("join", room);
+  }
+
+  leaveRoom(room: string): void {
+    this.socket?.emit("leave", room);
+  }
+
+  disconnect(): void {
+    this.socket?.disconnect();
+    this.socket = null;
+  }
+}
+`;
+}
+export function register(server) {
+    server.tool("mobile_setupRealtime", "Add a real-time client module with connection management, event subscriptions, reconnection, and cleanup. Supports raw WebSocket, Supabase Realtime, and Socket.IO.", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            const outDir = join(root, args.output_directory);
+            mkdirSync(outDir, { recursive: true });
+            const fileName = "realtime-client.ts";
+            const filePath = join(outDir, fileName);
+            if (existsSync(filePath)) {
+                return errorResponse(new Error(`File already exists: ${filePath}`));
+            }
+            let content;
+            let dependencies;
+            switch (args.provider) {
+                case "supabase":
+                    content = generateSupabaseRealtimeClient();
+                    dependencies = ["@supabase/supabase-js"];
+                    break;
+                case "socketio":
+                    content = generateSocketIOClient();
+                    dependencies = ["socket.io-client"];
+                    break;
+                default:
+                    content = generateWebSocketClient();
+                    dependencies = [];
+                    break;
+            }
+            writeFileSync(filePath, content, "utf-8");
+            const nextSteps = [];
+            if (dependencies.length > 0) {
+                nextSteps.push(`Install dependencies: npx expo install ${dependencies.join(" ")}`);
+            }
+            switch (args.provider) {
+                case "supabase":
+                    nextSteps.push("Set EXPO_PUBLIC_SUPABASE_URL and EXPO_PUBLIC_SUPABASE_ANON_KEY in .env", "Enable Realtime on your table in the Supabase dashboard", "Use subscribeToTable() to listen for INSERT/UPDATE/DELETE events", "Use joinPresence() for user presence and typing indicators");
+                    break;
+                case "socketio":
+                    nextSteps.push("Create a new RealtimeClient({ url: 'wss://your-server' })", "Call connect() to establish the connection", "Use on() to subscribe and emit() to send events", "Call disconnect() in your cleanup/unmount");
+                    break;
+                default:
+                    nextSteps.push("Create a new RealtimeClient({ url: 'wss://your-server/ws' })", "Call connect() to establish the WebSocket connection", "Use on() to subscribe to typed events and send() to publish", "Call disconnect() in your cleanup/unmount", "Reconnection with exponential backoff is built in");
+                    break;
+            }
+            return textResponse(JSON.stringify({
+                success: true,
+                provider: args.provider,
+                file_created: filePath,
+                dependencies_needed: dependencies.length > 0 ? dependencies : undefined,
+                next_steps: nextSteps,
+            }, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=setupRealtime.js.map

package/dist/tools/setupRealtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupRealtime.js","sourceRoot":"","sources":["../../src/tools/setupRealtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;SAC3C,QAAQ,EAAE;SACV,OAAO,CAAC,WAAW,CAAC;SACpB,QAAQ,CAAC,0CAA0C,CAAC;IACvD,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC;AAEF,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0FR,CAAC;AACF,CAAC;AAED,SAAS,8BAA8B;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFR,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,qKAAqK,EACrK,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACjD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAExC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,OAAO,aAAa,CAAC,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,OAAe,CAAC;YACpB,IAAI,YAAsB,CAAC;YAE3B,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtB,KAAK,UAAU;oBACb,OAAO,GAAG,8BAA8B,EAAE,CAAC;oBAC3C,YAAY,GAAG,CAAC,uBAAuB,CAAC,CAAC;oBACzC,MAAM;gBACR,KAAK,UAAU;oBACb,OAAO,GAAG,sBAAsB,EAAE,CAAC;oBACnC,YAAY,GAAG,CAAC,kBAAkB,CAAC,CAAC;oBACpC,MAAM;gBACR;oBACE,OAAO,GAAG,uBAAuB,EAAE,CAAC;oBACpC,YAAY,GAAG,EAAE,CAAC;oBAClB,MAAM;YACV,CAAC;YAED,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE1C,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,SAAS,CAAC,IAAI,CAAC,0CAA0C,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;YAED,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtB,KAAK,UAAU;oBACb,SAAS,CAAC,IAAI,CACZ,wEAAwE,EACxE,yDAAyD,EACzD,kEAAkE,EAClE,4DAA4D,CAC7D,CAAC;oBACF,MAAM;gBACR,KAAK,UAAU;oBACb,SAAS,CAAC,IAAI,CACZ,2DAA2D,EAC3D,4CAA4C,EAC5C,iDAAiD,EACjD,2CAA2C,CAC5C,CAAC;oBACF,MAAM;gBACR;oBACE,SAAS,CAAC,IAAI,CACZ,8DAA8D,EAC9D,sDAAsD,EACtD,6DAA6D,EAC7D,2CAA2C,EAC3C,mDAAmD,CACpD,CAAC;oBACF,MAAM;YACV,CAAC;YAED,OAAO,YAAY,CACjB,IAAI,CAAC,SAAS,CACZ;gBACE,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,QAAQ;gBACtB,mBAAmB,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;gBACvE,UAAU,EAAE,SAAS;aACtB,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tmhs/mobile-mcp",
-  "version": "0.7.0",
-  "description": "MCP server for mobile app development - 19 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, App Store submission, Play Store submission, screenshot capture, bundle analysis, and OTA update configuration.",
+  "version": "0.9.0",
+  "description": "MCP server for mobile app development - 26 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, App Store submission, Play Store submission, screenshot capture, bundle analysis, OTA update configuration, test execution, CI/CD setup, test file generation, i18n setup, map integration, form generation, and real-time client setup.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {