@sudo-ping-pong/prism-expo-client 0.1.1

package/dist/transport.js

@@ -0,0 +1,153 @@
+import { isPrismCommand } from '@sudo-ping-pong/prism-protocol';
+import { EventBuffer } from './buffer';
+import { handlePrismCommand } from './command-handler';
+const WS_OPEN = 1;
+const MAX_BACKOFF_MS = 30_000;
+export class PrismTransport {
+    ws = null;
+    buffer = new EventBuffer();
+    reconnectTimer = null;
+    options;
+    connected = false;
+    destroyed = false;
+    authFailed = false;
+    reconnectAttempts = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    connect() {
+        if (this.destroyed || this.authFailed)
+            return;
+        const url = `ws://${this.options.host}:${this.options.port}`;
+        const WS = getWebSocketConstructor();
+        if (!WS) {
+            this.options.onError?.({
+                type: 'unavailable',
+                message: 'WebSocket is not available in this environment',
+            });
+            return;
+        }
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.onerror = null;
+            this.ws.onmessage = null;
+            this.ws.close();
+            this.ws = null;
+        }
+        this.ws = new WS(url);
+        this.ws.onopen = () => {
+            this.reconnectAttempts = 0;
+            this.ws?.send(JSON.stringify({
+                type: 'handshake',
+                role: 'sdk',
+            }));
+        };
+        this.ws.onmessage = (ev) => {
+            try {
+                const msg = JSON.parse(ev.data);
+                if (typeof msg === 'object' &&
+                    msg !== null &&
+                    'type' in msg &&
+                    msg.type === 'handshake_ack') {
+                    const ack = msg;
+                    if (ack.success) {
+                        this.connected = true;
+                        this.options.onConnect?.();
+                        this.flushBuffer();
+                    }
+                    else {
+                        this.authFailed = true;
+                        const message = ack.message ?? 'Handshake rejected by server';
+                        this.options.onError?.({ type: 'auth', message });
+                        this.ws?.close();
+                    }
+                    return;
+                }
+                if (this.connected && isPrismCommand(msg)) {
+                    handlePrismCommand(msg);
+                }
+            }
+            catch {
+                // ignore malformed messages
+            }
+        };
+        this.ws.onclose = () => {
+            this.connected = false;
+            this.ws = null;
+            if (this.destroyed || this.authFailed)
+                return;
+            this.options.onDisconnect?.();
+            this.scheduleReconnect();
+        };
+        this.ws.onerror = () => {
+            this.connected = false;
+            this.options.onError?.({
+                type: 'network',
+                message: `Cannot reach Prism server at ${this.options.host}:${this.options.port}`,
+            });
+        };
+    }
+    send(envelope) {
+        queueMicrotask(() => {
+            if (this.connected && this.ws?.readyState === WS_OPEN) {
+                try {
+                    this.ws.send(JSON.stringify(envelope));
+                }
+                catch {
+                    this.buffer.push(envelope);
+                }
+            }
+            else {
+                this.buffer.push(envelope);
+            }
+        });
+    }
+    disconnect() {
+        this.destroyed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.onerror = null;
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connected = false;
+    }
+    resetAuthFailure() {
+        this.authFailed = false;
+        this.destroyed = false;
+        this.reconnectAttempts = 0;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    get hasAuthFailed() {
+        return this.authFailed;
+    }
+    flushBuffer() {
+        const pending = this.buffer.drain();
+        for (const envelope of pending) {
+            this.send(envelope);
+        }
+    }
+    scheduleReconnect() {
+        if (this.destroyed || this.authFailed || this.reconnectTimer)
+            return;
+        const delay = Math.min(3000 * 2 ** this.reconnectAttempts, MAX_BACKOFF_MS);
+        this.reconnectAttempts++;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+    }
+}
+function getWebSocketConstructor() {
+    if (typeof globalThis.WebSocket !== 'undefined') {
+        return globalThis.WebSocket;
+    }
+    return null;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@sudo-ping-pong/prism-expo-client",
+  "version": "0.1.1",
+  "description": "Client SDK for Prism DevTools — network, log, and state interception for Expo and React Native",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./src/index.ts",
+  "exports": {
+    ".": {
+      "react-native": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./zustand": {
+      "react-native": "./src/middleware/zustand.ts",
+      "types": "./dist/middleware/zustand.d.ts",
+      "import": "./dist/middleware/zustand.js",
+      "default": "./dist/middleware/zustand.js"
+    },
+    "./profiler": {
+      "react-native": "./src/profiler.tsx",
+      "types": "./dist/profiler.d.ts",
+      "import": "./dist/profiler.js",
+      "default": "./dist/profiler.js"
+    },
+    "./capture": {
+      "types": "./dist/capture.d.ts",
+      "import": "./dist/capture.js",
+      "default": "./dist/capture.js"
+    },
+    "./transport-registry": {
+      "types": "./dist/transport-registry.d.ts",
+      "import": "./dist/transport-registry.js",
+      "default": "./dist/transport-registry.js"
+    },
+    "./redux": {
+      "react-native": "./src/middleware/redux.ts",
+      "types": "./dist/middleware/redux.d.ts",
+      "import": "./dist/middleware/redux.js",
+      "default": "./dist/middleware/redux.js"
+    },
+    "./axios": {
+      "types": "./dist/patches/axios.d.ts",
+      "import": "./dist/patches/axios.js",
+      "default": "./dist/patches/axios.js"
+    }
+  },
+  "files": ["dist", "src"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudo-ping-pong/prism-expo-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sudo-ping-pong/prism-expo-client/issues"
+  },
+  "homepage": "https://github.com/sudo-ping-pong/prism-expo-client#readme",
+  "keywords": [
+    "prism",
+    "devtools",
+    "expo",
+    "react-native",
+    "debugging",
+    "redux",
+    "zustand",
+    "websocket"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@sudo-ping-pong/prism-protocol": "^0.1.1"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "redux": ">=4.0.0",
+    "zustand": ">=4.0.0",
+    "axios": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "redux": {
+      "optional": true
+    },
+    "zustand": {
+      "optional": true
+    },
+    "axios": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@sudo-ping-pong/prism-protocol": "^0.1.1",
+    "@types/react": "^19.0.2",
+    "axios": "^1.7.9",
+    "react": "^19.0.0",
+    "redux": "^5.0.1",
+    "typescript": "^5.7.3",
+    "zustand": "^5.0.3"
+  }
+}

package/src/buffer.ts

@@ -0,0 +1,23 @@
+import type { PrismEnvelope } from '@sudo-ping-pong/prism-protocol';
+import { PRISM_MAX_BUFFER_SIZE } from '@sudo-ping-pong/prism-protocol';
+
+export class EventBuffer {
+  private buffer: PrismEnvelope[] = [];
+
+  push(envelope: PrismEnvelope): void {
+    if (this.buffer.length >= PRISM_MAX_BUFFER_SIZE) {
+      this.buffer.shift();
+    }
+    this.buffer.push(envelope);
+  }
+
+  drain(): PrismEnvelope[] {
+    const items = [...this.buffer];
+    this.buffer = [];
+    return items;
+  }
+
+  get size(): number {
+    return this.buffer.length;
+  }
+}

package/src/capture.ts

@@ -0,0 +1,40 @@
+import { createEnvelope } from '@sudo-ping-pong/prism-protocol';
+import type { LogLevel, LogPayload, NetworkPayload, StatePayload } from '@sudo-ping-pong/prism-protocol';
+import { sendToPrism } from './transport-registry';
+
+export function captureLogEvent(level: LogLevel, args: unknown[]): void {
+  const payload: LogPayload = {
+    level,
+    args: serializeArgs(args),
+    stack: level === 'error' ? captureStack() : undefined,
+  };
+  sendToPrism(createEnvelope('LOG', payload));
+}
+
+export function captureNetworkEvent(payload: NetworkPayload): void {
+  sendToPrism(createEnvelope('NETWORK', payload));
+}
+
+export function captureStateEvent(payload: StatePayload): void {
+  sendToPrism(createEnvelope('STATE', payload));
+}
+
+function serializeArgs(args: unknown[]): unknown[] {
+  return args.map((arg) => {
+    if (arg instanceof Error) {
+      return { name: arg.name, message: arg.message, stack: arg.stack };
+    }
+    try {
+      JSON.stringify(arg);
+      return arg;
+    } catch {
+      return String(arg);
+    }
+  });
+}
+
+function captureStack(): string | undefined {
+  const err = new Error();
+  const lines = err.stack?.split('\n').slice(2);
+  return lines?.join('\n');
+}

package/src/command-handler.ts

@@ -0,0 +1,15 @@
+import { isPrismCommand } from '@sudo-ping-pong/prism-protocol';
+import { dispatchPrismReduxCommand } from './middleware/redux';
+
+export function handlePrismCommand(raw: unknown): void {
+  if (!isPrismCommand(raw)) return;
+
+  if (raw.command === 'dispatch') {
+    dispatchPrismReduxCommand(raw.storeId, 'dispatch', raw.action);
+    return;
+  }
+
+  if (raw.command === 'replace_state') {
+    dispatchPrismReduxCommand(raw.storeId, 'replace_state', raw.state);
+  }
+}

package/src/config.ts

@@ -0,0 +1,29 @@
+import { PRISM_DEFAULT_PORT } from '@sudo-ping-pong/prism-protocol';
+import type { PrismTransportError } from './transport';
+
+export interface PrismLocalConfigOptions {
+  port?: number;
+  network?: boolean;
+  logs?: boolean;
+  forceEnable?: boolean;
+  onConnect?: () => void;
+  onDisconnect?: () => void;
+  onError?: (error: PrismTransportError) => void;
+}
+
+/** Build SDK config for a host (defaults to port 8080). */
+export function createPrismLocalConfig(
+  host: string,
+  overrides?: PrismLocalConfigOptions,
+) {
+  return {
+    host,
+    port: overrides?.port ?? PRISM_DEFAULT_PORT,
+    network: overrides?.network,
+    logs: overrides?.logs,
+    forceEnable: overrides?.forceEnable,
+    onConnect: overrides?.onConnect,
+    onDisconnect: overrides?.onDisconnect,
+    onError: overrides?.onError,
+  };
+}

package/src/env.d.ts

@@ -0,0 +1 @@
+declare const process: { env?: { NODE_ENV?: string } } | undefined;

package/src/index.ts

@@ -0,0 +1,148 @@
+import { PrismTransport } from './transport';
+import { installFetchPatch } from './patches/fetch';
+import { installXhrPatch } from './patches/xhr';
+import { installAxiosPatch } from './patches/axios';
+import { installConsolePatch } from './patches/console';
+import { setActiveTransport } from './transport-registry';
+import { createPrismLocalConfig } from './config';
+import type { PrismTransportError } from './transport';
+
+export interface PrismConfig {
+  /** Machine running Prism (LAN IP or localhost) */
+  host: string;
+  /** WebSocket port (default 8080) */
+  port?: number;
+  /** Intercept fetch (default true) */
+  network?: boolean;
+  /** Intercept console.log/warn/error (default true) */
+  logs?: boolean;
+  /** Force enable in production (default: only __DEV__) */
+  forceEnable?: boolean;
+  onConnect?: () => void;
+  onDisconnect?: () => void;
+  onError?: (error: PrismTransportError) => void;
+}
+
+let initialized = false;
+let transport: PrismTransport | null = null;
+let patchesInstalled = false;
+let unsubs: Array<() => void> = [];
+
+function startTransport(config: PrismConfig): void {
+  transport?.disconnect();
+
+  transport = new PrismTransport({
+    host: config.host,
+    port: config.port ?? 8080,
+    onConnect: config.onConnect ?? (() => logDev('[Prism] Connected to DevTools')),
+    onDisconnect: config.onDisconnect ?? (() => logDev('[Prism] Disconnected — retrying…')),
+    onError:
+      config.onError ??
+      ((error) => {
+        if (error.type === 'auth') {
+          console.warn(`[Prism] ${error.message}`);
+        } else if (error.type === 'network') {
+          logDev(`[Prism] ${error.message}`);
+        } else {
+          console.warn(`[Prism] ${error.message}`);
+        }
+      }),
+  });
+
+  setActiveTransport(transport);
+  transport.resetAuthFailure();
+  transport.connect();
+}
+
+function installPatches(config: PrismConfig): void {
+  if (patchesInstalled || !transport) return;
+
+  if (config.network !== false) {
+    unsubs.push(installFetchPatch());
+    unsubs.push(installXhrPatch());
+    unsubs.push(installAxiosPatch());
+  }
+  if (config.logs !== false) {
+    unsubs.push(installConsolePatch());
+  }
+  patchesInstalled = true;
+}
+
+export function initPrism(config: PrismConfig): void {
+  const isDev =
+    typeof __DEV__ !== 'undefined'
+      ? __DEV__
+      : typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production';
+
+  if (!config.forceEnable && !isDev) return;
+  if (initialized) return;
+
+  initialized = true;
+  startTransport(config);
+  installPatches(config);
+}
+
+/** One-liner init — pass your machine's LAN IP (or Expo dev host). */
+export function initPrismLocal(host: string, overrides?: Partial<PrismConfig>): void {
+  initPrism(createPrismLocalConfig(host, overrides));
+}
+
+/** Reconnect with updated host/port without reinstalling patches. */
+export function reconnectPrism(config: PrismConfig): void {
+  const isDev =
+    typeof __DEV__ !== 'undefined'
+      ? __DEV__
+      : typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production';
+
+  if (!config.forceEnable && !isDev) return;
+
+  if (!initialized) {
+    initPrism(config);
+    return;
+  }
+
+  startTransport(config);
+}
+
+export function destroyPrism(): void {
+  transport?.disconnect();
+  setActiveTransport(null);
+  transport = null;
+  initialized = false;
+
+  for (const unsub of unsubs) unsub();
+  unsubs = [];
+  patchesInstalled = false;
+}
+
+export function getPrismTransport(): PrismTransport | null {
+  return transport;
+}
+
+export { PrismTransport } from './transport';
+export type { TransportOptions, PrismTransportError } from './transport';
+
+export { prismZustandMiddleware } from './middleware/zustand';
+export type { PrismZustandOptions } from './middleware/zustand';
+export { PrismProfiler } from './profiler';
+export type { PrismProfilerProps } from './profiler';
+export {
+  prismReduxMiddleware,
+  withPrismStateReplay,
+  registerPrismReduxStore,
+  PRISM_REPLACE_STATE,
+} from './middleware/redux';
+export type { PrismReduxOptions, PrismReplaceStateAction } from './middleware/redux';
+export { parsePrismConnectUri } from '@sudo-ping-pong/prism-protocol';
+export type { PrismConnectConfig, PrismCommand, StateSource } from '@sudo-ping-pong/prism-protocol';
+export { installAxiosPatch } from './patches/axios';
+export { createPrismLocalConfig } from './config';
+export type { PrismLocalConfigOptions } from './config';
+
+declare const __DEV__: boolean | undefined;
+
+function logDev(message: string): void {
+  if (typeof __DEV__ !== 'undefined' ? __DEV__ : true) {
+    console.log(message);
+  }
+}

package/src/middleware/redux.ts

@@ -0,0 +1,126 @@
+import type { Store, Action, Reducer } from 'redux';
+import type { StatePayload } from '@sudo-ping-pong/prism-protocol';
+import { captureStateEvent } from '../capture';
+
+/** Dispatched by Prism to replace the entire Redux state (time-travel jump). */
+export const PRISM_REPLACE_STATE = '@@prism/REPLACE_STATE';
+
+export interface PrismReplaceStateAction<S = unknown> extends Action<typeof PRISM_REPLACE_STATE> {
+  payload: S;
+}
+
+export interface PrismReduxOptions {
+  storeId?: string;
+  /** Redux action types to skip, e.g. ['@@INIT'] */
+  ignoredActions?: string[];
+}
+
+const reduxStores = new Map<string, Store>();
+
+export function registerPrismReduxStore(store: Store, storeId = 'redux'): () => void {
+  reduxStores.set(storeId, store);
+  return () => reduxStores.delete(storeId);
+}
+
+export function getPrismReduxStore(storeId: string): Store | undefined {
+  return reduxStores.get(storeId);
+}
+
+/**
+ * Wrap a root reducer so Prism can jump to a historical state snapshot.
+ *
+ * ```ts
+ * const store = configureStore({
+ *   reducer: withPrismStateReplay(rootReducer),
+ *   middleware: (gDM) => gDM().concat(prismReduxMiddleware('app')),
+ * });
+ * registerPrismReduxStore(store, 'app');
+ * ```
+ */
+export function withPrismStateReplay<S>(reducer: Reducer<S>): Reducer<S> {
+  return (state, action) => {
+    if (action.type === PRISM_REPLACE_STATE) {
+      return (action as unknown as PrismReplaceStateAction<S>).payload;
+    }
+    return reducer(state, action);
+  };
+}
+
+const DEFAULT_IGNORED = ['@@INIT', '@@redux/INIT'];
+
+export function prismReduxMiddleware(
+  storeIdOrOptions?: string | PrismReduxOptions,
+): import('redux').Middleware {
+  const opts: PrismReduxOptions =
+    typeof storeIdOrOptions === 'string'
+      ? { storeId: storeIdOrOptions }
+      : { storeId: 'redux', ...storeIdOrOptions };
+
+  const storeId = opts.storeId ?? 'redux';
+  const ignored = new Set([...DEFAULT_IGNORED, ...(opts.ignoredActions ?? [])]);
+
+  return (storeApi) => {
+    reduxStores.set(storeId, storeApi as unknown as Store);
+
+    return (next) => (action) => {
+      const prevState = storeApi.getState();
+      const result = next(action);
+      const nextState = storeApi.getState();
+
+      const actionType = (action as Action).type ?? 'unknown';
+      if (ignored.has(actionType) || actionType === PRISM_REPLACE_STATE) {
+        return result;
+      }
+
+      const payload: StatePayload = {
+        actionLabel: actionType,
+        payload: serializeAction(action),
+        prevState: cloneState(prevState),
+        nextState: cloneState(nextState),
+        storeId,
+        source: 'redux',
+      };
+
+      captureStateEvent(payload);
+      return result;
+    };
+  };
+}
+
+export function dispatchPrismReduxCommand(
+  storeId: string,
+  command: 'dispatch' | 'replace_state',
+  data: unknown,
+): boolean {
+  const store = reduxStores.get(storeId);
+  if (!store) return false;
+
+  if (command === 'dispatch') {
+    store.dispatch(data as Action);
+    return true;
+  }
+
+  store.dispatch({
+    type: PRISM_REPLACE_STATE,
+    payload: data,
+  } as unknown as Action);
+  return true;
+}
+
+function serializeAction(action: unknown): unknown {
+  if (typeof action !== 'object' || action === null) return action;
+  try {
+    JSON.stringify(action);
+    return action;
+  } catch {
+    return { type: (action as Action).type, note: '(non-serializable action)' };
+  }
+}
+
+function cloneState<T>(value: T): T {
+  try {
+    return JSON.parse(JSON.stringify(value)) as T;
+  } catch {
+    return value;
+  }
+}