metro-mcp 0.1.0

package/dist/client/client-buffer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Simple circular buffer for client-side use.
+ * Shared across all client SDK modules.
+ */
+export declare class ClientBuffer<T> {
+    private maxSize;
+    private items;
+    constructor(maxSize: number);
+    push(item: T): void;
+    getAll(): T[];
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=client-buffer.d.ts.map

package/dist/client/client-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-buffer.d.ts","sourceRoot":"","sources":["../../src/client/client-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC;IAEb,OAAO,CAAC,OAAO;IAD3B,OAAO,CAAC,KAAK,CAAW;gBACJ,OAAO,EAAE,MAAM;IAEnC,IAAI,CAAC,IAAI,EAAE,CAAC;IAKZ,MAAM,IAAI,CAAC,EAAE;IACb,KAAK;IACL,IAAI,IAAI,WAAgC;CACzC"}

package/dist/client/index.cjs

@@ -0,0 +1,346 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/client/index.ts
+var exports_client = {};
+__export(exports_client, {
+  registerCommand: () => registerCommand,
+  createReduxMiddleware: () => createReduxMiddleware,
+  createNavigationTracking: () => createNavigationTracking,
+  StructuredLogger: () => StructuredLogger,
+  StateSubscriptionManager: () => StateSubscriptionManager,
+  PerformanceTracker: () => PerformanceTracker,
+  MetroMCPClient: () => MetroMCPClient,
+  LifecycleTracker: () => LifecycleTracker
+});
+module.exports = __toCommonJS(exports_client);
+
+// src/client/client-buffer.ts
+class ClientBuffer {
+  maxSize;
+  items = [];
+  constructor(maxSize) {
+    this.maxSize = maxSize;
+  }
+  push(item) {
+    this.items.push(item);
+    if (this.items.length > this.maxSize)
+      this.items.shift();
+  }
+  getAll() {
+    return [...this.items];
+  }
+  clear() {
+    this.items = [];
+  }
+  get size() {
+    return this.items.length;
+  }
+}
+
+// src/client/middleware/redux.ts
+function createReduxMiddleware() {
+  const actions = new ClientBuffer(200);
+  const middleware = (store) => (next) => (action) => {
+    const start = Date.now();
+    const actionObj = action;
+    const entry = {
+      type: actionObj?.type || "UNKNOWN",
+      timestamp: start,
+      payload: actionObj?.payload
+    };
+    const result = next(action);
+    entry.duration = Date.now() - start;
+    actions.push(entry);
+    return result;
+  };
+  return { middleware, actions };
+}
+
+// src/client/middleware/navigation.ts
+function createNavigationTracking(navigationRef) {
+  const events = new ClientBuffer(100);
+  function getState() {
+    try {
+      return navigationRef.current?.getRootState?.() || null;
+    } catch {
+      return null;
+    }
+  }
+  const addListener = navigationRef.addListener || navigationRef.current?.addListener;
+  if (addListener) {
+    try {
+      addListener("state", (e) => {
+        const state = getState();
+        if (state?.routes) {
+          const routes = state.routes;
+          const index = state.index ?? routes.length - 1;
+          const currentRoute = routes[index];
+          events.push({
+            timestamp: Date.now(),
+            type: "state_change",
+            routeName: currentRoute?.name,
+            params: currentRoute?.params
+          });
+        }
+      });
+    } catch {}
+  }
+  return { events, getState };
+}
+
+// src/client/performance.ts
+class PerformanceTracker {
+  marks = new Map;
+  measures = [];
+  mark(name) {
+    this.marks.set(name, Date.now());
+  }
+  measure(name, startMark, endMark) {
+    const start = this.marks.get(startMark);
+    const end = this.marks.get(endMark);
+    if (start === undefined || end === undefined)
+      return null;
+    const duration = end - start;
+    this.measures.push({ name, startMark, endMark, duration });
+    if (this.measures.length > 100) {
+      this.measures = this.measures.slice(-100);
+    }
+    return duration;
+  }
+  getMeasures() {
+    return [...this.measures];
+  }
+  clear() {
+    this.marks.clear();
+    this.measures = [];
+  }
+}
+
+// src/client/logger.ts
+class StructuredLogger {
+  channels = new Map;
+  log(channel, data) {
+    if (!this.channels.has(channel)) {
+      this.channels.set(channel, new ClientBuffer(200));
+    }
+    this.channels.get(channel).push({
+      timestamp: Date.now(),
+      channel,
+      data
+    });
+  }
+  getChannel(channel) {
+    return this.channels.get(channel)?.getAll() || [];
+  }
+  getAllChannels() {
+    return Array.from(this.channels.keys());
+  }
+  clear(channel) {
+    if (channel) {
+      this.channels.get(channel)?.clear();
+    } else {
+      this.channels.clear();
+    }
+  }
+}
+
+// src/client/state.ts
+class StateSubscriptionManager {
+  subscriptions = new Map;
+  subscribe(name, getter) {
+    this.subscriptions.set(name, getter);
+  }
+  unsubscribe(name) {
+    this.subscriptions.delete(name);
+  }
+  getState(name) {
+    const getter = this.subscriptions.get(name);
+    if (!getter)
+      return;
+    try {
+      return getter();
+    } catch {
+      return;
+    }
+  }
+  getAllStates() {
+    const result = {};
+    for (const [name, getter] of this.subscriptions) {
+      try {
+        result[name] = getter();
+      } catch {
+        result[name] = "[error]";
+      }
+    }
+    return result;
+  }
+  listSubscriptions() {
+    return Array.from(this.subscriptions.keys());
+  }
+}
+
+// src/client/lifecycle.ts
+class LifecycleTracker {
+  events = new ClientBuffer(100);
+  started = false;
+  start() {
+    if (this.started)
+      return;
+    this.started = true;
+    try {
+      const { AppState, Linking } = (()=>{throw new Error("Cannot require module "+"react-native");})();
+      if (AppState) {
+        AppState.addEventListener("change", (nextState) => {
+          this.events.push({
+            timestamp: Date.now(),
+            type: nextState === "active" ? "foreground" : "background"
+          });
+        });
+      }
+      if (Linking) {
+        Linking.addEventListener("url", (event) => {
+          this.events.push({
+            timestamp: Date.now(),
+            type: "deep_link",
+            data: { url: event.url }
+          });
+        });
+        Linking.getInitialURL().then((url) => {
+          if (url) {
+            this.events.push({
+              timestamp: Date.now(),
+              type: "deep_link",
+              data: { url, initial: true }
+            });
+          }
+        });
+      }
+    } catch {}
+    this.events.push({
+      timestamp: Date.now(),
+      type: "foreground",
+      data: { initial: true }
+    });
+  }
+  trackCustomEvent(type, data) {
+    this.events.push({
+      timestamp: Date.now(),
+      type: "custom",
+      data: { customType: type, ...data || {} }
+    });
+  }
+}
+
+// src/client/index.ts
+class MetroMCPClient {
+  mcpGlobal;
+  performance;
+  logger;
+  stateManager;
+  lifecycleTracker;
+  constructor() {
+    this.mcpGlobal = {
+      commands: {}
+    };
+    this.performance = new PerformanceTracker;
+    this.logger = new StructuredLogger;
+    this.stateManager = new StateSubscriptionManager;
+    this.lifecycleTracker = new LifecycleTracker;
+    global.__METRO_MCP__ = this.mcpGlobal;
+  }
+  registerCommand(name, handler) {
+    this.mcpGlobal.commands[name] = handler;
+  }
+  useReduxMiddleware(store) {
+    const { middleware, actions } = createReduxMiddleware();
+    this.mcpGlobal.redux = {
+      actions,
+      getState: () => store.getState(),
+      dispatch: (action) => store.dispatch(action)
+    };
+    store.__metroMcpMiddleware = middleware;
+  }
+  getReduxMiddleware() {
+    if (!this.mcpGlobal.redux) {
+      throw new Error("Call useReduxMiddleware(store) first");
+    }
+    return this.mcpGlobal.redux.actions;
+  }
+  useNavigationTracking(navigationRef) {
+    const { events, getState } = createNavigationTracking(navigationRef);
+    this.mcpGlobal.navigation = { events, getState };
+  }
+  mark(name) {
+    this.performance.mark(name);
+    this.ensurePerformanceGlobal();
+  }
+  measure(name, startMark, endMark) {
+    const duration = this.performance.measure(name, startMark, endMark);
+    this.ensurePerformanceGlobal();
+    return duration;
+  }
+  ensurePerformanceGlobal() {
+    this.mcpGlobal.performance = {
+      marks: this.performance.marks,
+      measures: this.performance.measures
+    };
+  }
+  log(channel, data) {
+    this.logger.log(channel, data);
+    this.mcpGlobal.logs = { channels: this.logger.channels };
+  }
+  subscribeState(name, getter) {
+    this.stateManager.subscribe(name, getter);
+    this.mcpGlobal.state = { subscriptions: this.stateManager.subscriptions };
+  }
+  trackLifecycle() {
+    this.lifecycleTracker.start();
+    this.mcpGlobal.lifecycle = { events: this.lifecycleTracker.events };
+  }
+}
+function registerCommand(name, handler) {
+  const g = global;
+  if (!g.__METRO_MCP__) {
+    g.__METRO_MCP__ = { commands: {} };
+  }
+  const mcp = g.__METRO_MCP__;
+  if (!mcp.commands)
+    mcp.commands = {};
+  mcp.commands[name] = handler;
+}

package/dist/client/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * metro-mcp Client SDK
+ *
+ * Optional dev dependency for enhanced features.
+ * All features register on global.__METRO_MCP__ which the server
+ * discovers via Runtime.evaluate.
+ *
+ * Usage:
+ *   import { MetroMCPClient } from 'metro-mcp/client';
+ *
+ *   if (__DEV__) {
+ *     const mcp = new MetroMCPClient();
+ *     mcp.registerCommand('login', async ({ email, password }) => { ... });
+ *     mcp.useReduxMiddleware(store);
+ *     mcp.useNavigationTracking(navigationRef);
+ *   }
+ */
+import { type ReduxStore } from './middleware/redux.js';
+import { type NavigationRef } from './middleware/navigation.js';
+import { ClientBuffer } from './client-buffer.js';
+export interface MetroMCPGlobal {
+    commands: Record<string, (params: Record<string, unknown>) => unknown>;
+    redux?: {
+        actions: ClientBuffer<unknown>;
+        getState: () => unknown;
+        dispatch: (action: unknown) => unknown;
+    };
+    navigation?: {
+        events: ClientBuffer<unknown>;
+        getState: () => unknown;
+    };
+    performance?: {
+        marks: Map<string, number>;
+        measures: Array<{
+            name: string;
+            startMark: string;
+            endMark: string;
+            duration: number;
+        }>;
+    };
+    logs?: {
+        channels: Map<string, ClientBuffer<unknown>>;
+    };
+    state?: {
+        subscriptions: Map<string, () => unknown>;
+    };
+    lifecycle?: {
+        events: ClientBuffer<unknown>;
+    };
+}
+export declare class MetroMCPClient {
+    private mcpGlobal;
+    private performance;
+    private logger;
+    private stateManager;
+    private lifecycleTracker;
+    constructor();
+    registerCommand(name: string, handler: (params: Record<string, unknown>) => unknown): void;
+    useReduxMiddleware(store: ReduxStore): void;
+    /**
+     * Get the Redux middleware to add to your store.
+     * Call this AFTER useReduxMiddleware().
+     */
+    getReduxMiddleware(): unknown;
+    useNavigationTracking(navigationRef: NavigationRef): void;
+    mark(name: string): void;
+    measure(name: string, startMark: string, endMark: string): number | null;
+    private ensurePerformanceGlobal;
+    log(channel: string, data: unknown): void;
+    subscribeState(name: string, getter: () => unknown): void;
+    trackLifecycle(): void;
+}
+export { createReduxMiddleware } from './middleware/redux.js';
+export { createNavigationTracking } from './middleware/navigation.js';
+export { PerformanceTracker } from './performance.js';
+export { StructuredLogger } from './logger.js';
+export { StateSubscriptionManager } from './state.js';
+export { LifecycleTracker } from './lifecycle.js';
+export declare function registerCommand(name: string, handler: (params: Record<string, unknown>) => unknown): void;
+//# sourceMappingURL=index.d.ts.map

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

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