@tmhs/mobile-mcp 0.10.0 → 0.12.0

package/dist/tools/createNativeModule.js

@@ -0,0 +1,291 @@
+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("Framework (default: expo)."),
+    module_name: z
+        .string()
+        .describe("Name of the native module (PascalCase, e.g. 'Haptics')."),
+    output_directory: z
+        .string()
+        .optional()
+        .default("modules")
+        .describe("Output directory relative to project root (default: modules)."),
+};
+function toPascalCase(name) {
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+function toKebabCase(name) {
+    return name.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function generateExpoModuleIndex(name) {
+    return `import ${name}Module from "./${name}Module";
+
+export function hello(): string {
+  return ${name}Module.hello();
+}
+
+export function multiply(a: number, b: number): number {
+  return ${name}Module.multiply(a, b);
+}
+`;
+}
+function generateExpoModuleNative(name) {
+    return `import { requireNativeModule } from "expo-modules-core";
+
+const ${name}Module = requireNativeModule("${name}");
+
+export default ${name}Module;
+`;
+}
+function generateExpoModuleConfig(name) {
+    return `{
+  "name": "${name}",
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["${name}Module"]
+  },
+  "android": {
+    "modules": ["${name}Module"]
+  }
+}
+`;
+}
+function generateSwiftModule(name) {
+    return `import ExpoModulesCore
+
+public class ${name}Module: Module {
+  public func definition() -> ModuleDefinition {
+    Name("${name}")
+
+    Function("hello") {
+      return "Hello from ${name} native module!"
+    }
+
+    Function("multiply") { (a: Double, b: Double) -> Double in
+      return a * b
+    }
+  }
+}
+`;
+}
+function generateKotlinModule(name) {
+    const pkg = `expo.modules.${name.toLowerCase()}`;
+    return `package ${pkg}
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class ${name}Module : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("${name}")
+
+    Function("hello") {
+      "Hello from ${name} native module!"
+    }
+
+    Function("multiply") { a: Double, b: Double ->
+      a * b
+    }
+  }
+}
+`;
+}
+function generateFlutterPluginDart(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `import 'dart:async';
+import 'package:flutter/services.dart';
+
+class ${name} {
+  static const MethodChannel _channel = MethodChannel('${snakeName}');
+
+  static Future<String> hello() async {
+    final result = await _channel.invokeMethod<String>('hello');
+    return result ?? '';
+  }
+
+  static Future<double> multiply(double a, double b) async {
+    final result = await _channel.invokeMethod<double>('multiply', {
+      'a': a,
+      'b': b,
+    });
+    return result ?? 0;
+  }
+}
+`;
+}
+function generateFlutterPlatformInterface(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `import 'package:flutter/services.dart';
+
+class ${name}Platform {
+  static const MethodChannel _channel = MethodChannel('${snakeName}');
+
+  Future<String> hello() async {
+    final result = await _channel.invokeMethod<String>('hello');
+    return result ?? '';
+  }
+
+  Future<double> multiply(double a, double b) async {
+    final result = await _channel.invokeMethod<double>('multiply', {
+      'a': a,
+      'b': b,
+    });
+    return result ?? 0;
+  }
+}
+`;
+}
+function generateSwiftPlugin(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `import Flutter
+import UIKit
+
+public class ${name}Plugin: NSObject, FlutterPlugin {
+  public static func register(with registrar: FlutterPluginRegistrar) {
+    let channel = FlutterMethodChannel(
+      name: "${snakeName}",
+      binaryMessenger: registrar.messenger()
+    )
+    let instance = ${name}Plugin()
+    registrar.addMethodCallDelegate(instance, channel: channel)
+  }
+
+  public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
+    switch call.method {
+    case "hello":
+      result("Hello from ${name} native module!")
+    case "multiply":
+      guard let args = call.arguments as? [String: Any],
+            let a = args["a"] as? Double,
+            let b = args["b"] as? Double else {
+        result(FlutterError(code: "INVALID_ARGS", message: "Expected a and b", details: nil))
+        return
+      }
+      result(a * b)
+    default:
+      result(FlutterMethodNotImplemented)
+    }
+  }
+}
+`;
+}
+function generateKotlinPlugin(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `package com.example.${snakeName}
+
+import io.flutter.embedding.engine.plugins.FlutterPlugin
+import io.flutter.plugin.common.MethodCall
+import io.flutter.plugin.common.MethodChannel
+
+class ${name}Plugin : FlutterPlugin, MethodChannel.MethodCallHandler {
+  private lateinit var channel: MethodChannel
+
+  override fun onAttachedToEngine(binding: FlutterPlugin.FlutterPluginBinding) {
+    channel = MethodChannel(binding.binaryMessenger, "${snakeName}")
+    channel.setMethodCallHandler(this)
+  }
+
+  override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
+    when (call.method) {
+      "hello" -> result.success("Hello from ${name} native module!")
+      "multiply" -> {
+        val a = call.argument<Double>("a") ?: return result.error("INVALID_ARGS", "Missing a", null)
+        val b = call.argument<Double>("b") ?: return result.error("INVALID_ARGS", "Missing b", null)
+        result.success(a * b)
+      }
+      else -> result.notImplemented()
+    }
+  }
+
+  override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
+    channel.setMethodCallHandler(null)
+  }
+}
+`;
+}
+export function register(server) {
+    server.tool("mobile_createNativeModule", "Scaffold an Expo Module or Flutter platform plugin with Swift/Kotlin stubs and TypeScript/Dart bindings.", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            const name = toPascalCase(args.module_name);
+            const kebab = toKebabCase(name);
+            const isFlutter = args.framework === "flutter";
+            const moduleDir = join(root, args.output_directory, kebab);
+            if (existsSync(moduleDir)) {
+                return errorResponse(new Error(`Module directory already exists: ${moduleDir}`));
+            }
+            const created = [];
+            if (isFlutter) {
+                const libDir = join(moduleDir, "lib");
+                const iosDir = join(moduleDir, "ios", "Classes");
+                const androidDir = join(moduleDir, "android", "src", "main", "kotlin", "com", "example", kebab.replace(/-/g, "_"));
+                mkdirSync(libDir, { recursive: true });
+                mkdirSync(iosDir, { recursive: true });
+                mkdirSync(androidDir, { recursive: true });
+                const files = [
+                    { path: join(libDir, `${kebab.replace(/-/g, "_")}.dart`), content: generateFlutterPluginDart(name) },
+                    { path: join(libDir, `${kebab.replace(/-/g, "_")}_platform.dart`), content: generateFlutterPlatformInterface(name) },
+                    { path: join(iosDir, `${name}Plugin.swift`), content: generateSwiftPlugin(name) },
+                    { path: join(androidDir, `${name}Plugin.kt`), content: generateKotlinPlugin(name) },
+                ];
+                for (const f of files) {
+                    writeFileSync(f.path, f.content, "utf-8");
+                    created.push(f.path);
+                }
+            }
+            else {
+                const srcDir = join(moduleDir, "src");
+                const iosDir = join(moduleDir, "ios");
+                const androidDir = join(moduleDir, "android", "src", "main", "java", "expo", "modules", name.toLowerCase());
+                mkdirSync(srcDir, { recursive: true });
+                mkdirSync(iosDir, { recursive: true });
+                mkdirSync(androidDir, { recursive: true });
+                const files = [
+                    { path: join(srcDir, "index.ts"), content: generateExpoModuleIndex(name) },
+                    { path: join(srcDir, `${name}Module.ts`), content: generateExpoModuleNative(name) },
+                    { path: join(moduleDir, "expo-module.config.json"), content: generateExpoModuleConfig(name) },
+                    { path: join(iosDir, `${name}Module.swift`), content: generateSwiftModule(name) },
+                    { path: join(androidDir, `${name}Module.kt`), content: generateKotlinModule(name) },
+                ];
+                for (const f of files) {
+                    writeFileSync(f.path, f.content, "utf-8");
+                    created.push(f.path);
+                }
+            }
+            const nextSteps = isFlutter
+                ? [
+                    `Add the plugin to pubspec.yaml as a path dependency: path: ${args.output_directory}/${kebab}`,
+                    "Run flutter pub get",
+                    "Import and call the module from Dart code",
+                    "Customize Swift and Kotlin implementations for your use case",
+                ]
+                : [
+                    `Import from "${args.output_directory}/${kebab}/src" in your app code`,
+                    "Run npx expo prebuild to generate native projects",
+                    "Customize the Swift and Kotlin Module definitions",
+                    "Add new native functions following the existing pattern",
+                ];
+            return textResponse(JSON.stringify({
+                success: true,
+                framework: args.framework,
+                module_name: name,
+                files_created: created,
+                next_steps: nextSteps,
+            }, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=createNativeModule.js.map

package/dist/tools/createNativeModule.js.map

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

package/dist/tools/setupFeatureFlags.d.ts

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

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

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

package/dist/tools/setupFeatureFlags.js

@@ -0,0 +1,266 @@
+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("Framework (default: expo)."),
+    provider: z
+        .enum(["posthog", "launchdarkly", "firebase"])
+        .optional()
+        .default("posthog")
+        .describe("Feature flag provider (default: posthog)."),
+    output_directory: z
+        .string()
+        .optional()
+        .default("lib")
+        .describe("Output directory relative to project root (default: lib)."),
+};
+function generatePostHogExpo() {
+    return `import PostHog from "posthog-react-native";
+
+const posthog = new PostHog(process.env.EXPO_PUBLIC_POSTHOG_KEY!, {
+  host: process.env.EXPO_PUBLIC_POSTHOG_HOST ?? "https://us.i.posthog.com",
+});
+
+export type FeatureFlags = {
+  new_onboarding: boolean;
+  premium_features: boolean;
+  experimental_ui: boolean;
+};
+
+const FLAG_DEFAULTS: FeatureFlags = {
+  new_onboarding: false,
+  premium_features: false,
+  experimental_ui: false,
+};
+
+export function getFlag<K extends keyof FeatureFlags>(key: K): FeatureFlags[K] {
+  const value = posthog.getFeatureFlag(key);
+  if (value === undefined || value === null) return FLAG_DEFAULTS[key];
+  return value as FeatureFlags[K];
+}
+
+export function useFeatureFlag<K extends keyof FeatureFlags>(key: K): FeatureFlags[K] {
+  const value = posthog.useFeatureFlag(key);
+  if (value === undefined || value === null) return FLAG_DEFAULTS[key];
+  return value as FeatureFlags[K];
+}
+
+export function identifyUser(userId: string, properties?: Record<string, unknown>): void {
+  posthog.identify(userId, properties);
+}
+
+export function resetUser(): void {
+  posthog.reset();
+}
+
+export { posthog };
+`;
+}
+function generateLaunchDarklyExpo() {
+    return `import { LDClient, LDConfig, LDContext } from "@launchdarkly/react-native-client-sdk";
+
+const config: LDConfig = {
+  mobileKey: process.env.EXPO_PUBLIC_LAUNCHDARKLY_KEY!,
+  debug: __DEV__,
+};
+
+const client = new LDClient();
+
+export type FeatureFlags = {
+  new_onboarding: boolean;
+  premium_features: boolean;
+  experimental_ui: boolean;
+};
+
+const FLAG_DEFAULTS: FeatureFlags = {
+  new_onboarding: false,
+  premium_features: false,
+  experimental_ui: false,
+};
+
+let initialized = false;
+
+export async function initFeatureFlags(userId: string): Promise<void> {
+  if (initialized) return;
+  const context: LDContext = { kind: "user", key: userId };
+  await client.configure(config, context);
+  initialized = true;
+}
+
+export function getFlag<K extends keyof FeatureFlags>(key: K): FeatureFlags[K] {
+  return (client.boolVariation(key, FLAG_DEFAULTS[key]) as FeatureFlags[K]);
+}
+
+export function onFlagChange(key: keyof FeatureFlags, callback: (value: boolean) => void): () => void {
+  const listener = (flagKey: string, value: unknown) => {
+    if (flagKey === key) callback(value as boolean);
+  };
+  client.registerFeatureFlagListener(key, listener);
+  return () => client.unregisterFeatureFlagListener(key, listener);
+}
+
+export { client as ldClient };
+`;
+}
+function generateFirebaseExpo() {
+    return `import remoteConfig from "@react-native-firebase/remote-config";
+
+export type FeatureFlags = {
+  new_onboarding: boolean;
+  premium_features: boolean;
+  experimental_ui: boolean;
+};
+
+const FLAG_DEFAULTS: FeatureFlags = {
+  new_onboarding: false,
+  premium_features: false,
+  experimental_ui: false,
+};
+
+export async function initFeatureFlags(): Promise<void> {
+  await remoteConfig().setDefaults(FLAG_DEFAULTS as Record<string, boolean>);
+  await remoteConfig().setConfigSettings({
+    minimumFetchIntervalMillis: __DEV__ ? 0 : 3600000,
+  });
+  await remoteConfig().fetchAndActivate();
+}
+
+export function getFlag<K extends keyof FeatureFlags>(key: K): FeatureFlags[K] {
+  return remoteConfig().getBoolean(key) as FeatureFlags[K];
+}
+
+export function getAllFlags(): FeatureFlags {
+  return {
+    new_onboarding: remoteConfig().getBoolean("new_onboarding"),
+    premium_features: remoteConfig().getBoolean("premium_features"),
+    experimental_ui: remoteConfig().getBoolean("experimental_ui"),
+  };
+}
+
+export async function refreshFlags(): Promise<void> {
+  await remoteConfig().fetchAndActivate();
+}
+`;
+}
+function generateFlutterFeatureFlags(provider) {
+    const providerImport = provider === "firebase"
+        ? "import 'package:firebase_remote_config/firebase_remote_config.dart';"
+        : "// Add your feature flag provider package import here";
+    return `${providerImport}
+
+enum FeatureFlag {
+  newOnboarding('new_onboarding', false),
+  premiumFeatures('premium_features', false),
+  experimentalUi('experimental_ui', false);
+
+  const FeatureFlag(this.key, this.defaultValue);
+  final String key;
+  final bool defaultValue;
+}
+
+class FeatureFlagService {
+  static final FeatureFlagService _instance = FeatureFlagService._();
+  factory FeatureFlagService() => _instance;
+  FeatureFlagService._();
+
+  final Map<String, bool> _overrides = {};
+
+  Future<void> init() async {
+${provider === "firebase" ? `    final rc = FirebaseRemoteConfig.instance;
+    await rc.setDefaults({
+      for (final flag in FeatureFlag.values) flag.key: flag.defaultValue,
+    });
+    await rc.setConfigSettings(RemoteConfigSettings(
+      fetchTimeout: const Duration(seconds: 10),
+      minimumFetchInterval: const Duration(hours: 1),
+    ));
+    await rc.fetchAndActivate();` : `    // Initialize your feature flag provider here
+    // Load remote flag values`}
+  }
+
+  bool isEnabled(FeatureFlag flag) {
+    if (_overrides.containsKey(flag.key)) return _overrides[flag.key]!;
+${provider === "firebase" ? `    return FirebaseRemoteConfig.instance.getBool(flag.key);` : `    return flag.defaultValue;`}
+  }
+
+  void setOverride(FeatureFlag flag, bool value) {
+    _overrides[flag.key] = value;
+  }
+
+  void clearOverrides() {
+    _overrides.clear();
+  }
+
+  Future<void> refresh() async {
+${provider === "firebase" ? `    await FirebaseRemoteConfig.instance.fetchAndActivate();` : `    // Refresh from remote provider`}
+  }
+}
+`;
+}
+export function register(server) {
+    server.tool("mobile_setupFeatureFlags", "Add a typed feature flag system with default values, remote sync, and provider integration (PostHog, LaunchDarkly, or Firebase Remote Config).", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            const outDir = join(root, args.output_directory);
+            mkdirSync(outDir, { recursive: true });
+            const isFlutter = args.framework === "flutter";
+            const ext = isFlutter ? "dart" : "ts";
+            const fileName = `feature-flags.${ext}`;
+            const filePath = join(outDir, fileName);
+            if (existsSync(filePath)) {
+                return errorResponse(new Error(`File already exists: ${filePath}`));
+            }
+            let content;
+            let dependencies;
+            const nextSteps = [];
+            if (isFlutter) {
+                content = generateFlutterFeatureFlags(args.provider);
+                dependencies = args.provider === "firebase"
+                    ? ["firebase_remote_config"]
+                    : [];
+                nextSteps.push("Call FeatureFlagService().init() in main() before runApp()", "Use FeatureFlagService().isEnabled(FeatureFlag.newOnboarding) to check flags", "Add new flags to the FeatureFlag enum as needed", `Configure ${args.provider} dashboard with matching flag keys`);
+            }
+            else {
+                switch (args.provider) {
+                    case "launchdarkly":
+                        content = generateLaunchDarklyExpo();
+                        dependencies = ["@launchdarkly/react-native-client-sdk"];
+                        nextSteps.push("Set EXPO_PUBLIC_LAUNCHDARKLY_KEY in .env", "Call initFeatureFlags(userId) after authentication", "Use getFlag('new_onboarding') to check flags");
+                        break;
+                    case "firebase":
+                        content = generateFirebaseExpo();
+                        dependencies = ["@react-native-firebase/remote-config", "@react-native-firebase/app"];
+                        nextSteps.push("Ensure Firebase is configured (google-services.json / GoogleService-Info.plist)", "Call initFeatureFlags() in app root before rendering", "Use getFlag('new_onboarding') to check flags");
+                        break;
+                    default:
+                        content = generatePostHogExpo();
+                        dependencies = ["posthog-react-native"];
+                        nextSteps.push("Set EXPO_PUBLIC_POSTHOG_KEY in .env", "Use useFeatureFlag('new_onboarding') in components", "Call identifyUser(userId) after authentication");
+                        break;
+                }
+            }
+            writeFileSync(filePath, content, "utf-8");
+            return textResponse(JSON.stringify({
+                success: true,
+                provider: args.provider,
+                framework: args.framework,
+                file_created: filePath,
+                dependencies_needed: dependencies,
+                next_steps: nextSteps,
+            }, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=setupFeatureFlags.js.map

package/dist/tools/setupFeatureFlags.js.map

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

package/dist/tools/setupTheming.d.ts

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

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

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