prism-debugger 0.2.0

package/.env.example

@@ -0,0 +1,9 @@
+PORT=8097
+IOS_AUTH_KEYS=ios-dev-token
+UI_AUTH_KEYS=ui-dev-token
+HEARTBEAT_TIMEOUT_SEC=30
+RATE_LIMIT=30
+MAX_PAYLOAD_BYTES=262144
+RING_BUFFER_SIZE=500
+ENABLED_PLUGINS=context-device-event-logger
+CONTEXT_EVENT_LOG_DIR=./logs/context-events

package/README.md

@@ -0,0 +1,128 @@
+# Prism Debugger
+
+Real-time debugger for Janative (JavaScript + Native) iOS apps.
+WebSocket broker between iOS SDK and Web UI with event console, performance timeline, and reporting.
+
+## Quick Start
+
+```bash
+npx prism-debugger
+```
+
+Or install globally:
+
+```bash
+npm install -g prism-debugger
+prism
+```
+
+Server starts and prints the config summary:
+
+```
+  Prism Debugger
+  ─────────────────────────────────────
+  Config:    defaults (no .env, run prism init)
+  HTTP:      http://localhost:8080
+  UI:        http://192.168.1.10:8080/?token=ui-dev-token
+  WS iOS:    ws://192.168.1.10:8080/ws/ios
+  Plugins:   context-device-event-logger
+```
+
+Open the UI link in your browser — that's it.
+
+## Configuration
+
+### CLI flags
+
+```bash
+prism -p 8097                       # set port
+prism --ios-token my-secret         # iOS SDK auth token
+prism --ui-token my-secret          # Web UI auth token
+prism --plugins none                # disable plugins
+prism --log-dir ./my-logs           # context event log directory
+```
+
+### .env file
+
+Generate a config in the current directory:
+
+```bash
+prism init
+```
+
+This creates a `.env` file with all available options:
+
+```env
+PORT=8097
+IOS_AUTH_KEYS=ios-dev-token
+UI_AUTH_KEYS=ui-dev-token
+HEARTBEAT_TIMEOUT_SEC=30
+RATE_LIMIT=30
+MAX_PAYLOAD_BYTES=262144
+RING_BUFFER_SIZE=500
+ENABLED_PLUGINS=context-device-event-logger
+CONTEXT_EVENT_LOG_DIR=./logs/context-events
+```
+
+Priority: CLI flags > `.env` file > defaults.
+
+### Options reference
+
+| Option | CLI flag | Env variable | Default | Description |
+|--------|----------|--------------|---------|-------------|
+| Port | `-p, --port` | `PORT` | `8080` | HTTP and WebSocket port |
+| iOS token | `--ios-token` | `IOS_AUTH_KEYS` | `ios-dev-token` | Auth token for iOS SDK (comma-separated for multiple) |
+| UI token | `--ui-token` | `UI_AUTH_KEYS` | `ui-dev-token` | Auth token for Web UI (comma-separated for multiple) |
+| Plugins | `--plugins` | `ENABLED_PLUGINS` | `context-device-event-logger` | Comma-separated list of plugins |
+| Log dir | `--log-dir` | `CONTEXT_EVENT_LOG_DIR` | `./logs/context-events` | Directory for JSONL event logs |
+| Heartbeat | — | `HEARTBEAT_TIMEOUT_SEC` | `30` | Seconds before marking device offline |
+| Rate limit | — | `RATE_LIMIT` | `30` | Max events per second per debugger |
+| Payload size | — | `MAX_PAYLOAD_BYTES` | `262144` | Max message size (bytes) |
+| Ring buffer | — | `RING_BUFFER_SIZE` | `500` | Message history per debugger |
+
+## WebSocket endpoints
+
+| Endpoint | Purpose |
+|----------|---------|
+| `/ws/ios?token=<IOS_TOKEN>` | iOS SDK connection |
+| `/ws/ui?token=<UI_TOKEN>` | Web UI connection |
+
+## HTTP API
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/health` | Health check |
+| `GET` | `/api/connect-info` | Server IP and port for QR connect |
+| `GET` | `/api/debuggers` | List connected debuggers |
+| `GET` | `/api/debuggers/:id/messages` | Message history for a debugger |
+| `POST` | `/api/debuggers/:id/send` | Send command to a debugger |
+
+## Web UI
+
+Open `http://localhost:<port>/?token=<UI_TOKEN>` in your browser.
+
+Features:
+- Live event console with level/category filters
+- Performance timeline (Gantt chart) with badge grouping
+- PerfPoint detail popups with extra data
+- HTML / CSV / JSON report export
+- QR code for quick iOS SDK connection
+- Light and dark themes
+
+## Plugins
+
+Built-in plugin `context-device-event-logger` writes JSONL logs per context:
+
+```
+logs/context-events/{bundleId}/{device}/{sessionId}/{context}.log
+```
+
+Disable all plugins:
+
+```bash
+prism --plugins none
+```
+
+## License
+
+MIT

package/bin/prism.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+import { parseArgs } from 'node:util';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = resolve(__dirname, '..');
+
+const HELP = `
+  prism — Prism Debugger Server
+
+  Usage:
+    prism [options]       Start the server
+    prism init            Create .env config in current directory
+
+  Options:
+    -p, --port <number>       HTTP/WS port (default: 8080)
+    --ios-token <string>      iOS auth token (default: ios-dev-token)
+    --ui-token <string>       UI auth token (default: ui-dev-token)
+    --plugins <list>          Enabled plugins, comma-separated
+    --log-dir <path>          Context event log directory
+    -h, --help                Show this help
+    -v, --version             Show version
+
+  Config priority: CLI flags > .env file > defaults
+`.trimStart();
+
+const { values, positionals } = parseArgs({
+  allowPositionals: true,
+  options: {
+    port:       { type: 'string', short: 'p' },
+    'ios-token': { type: 'string' },
+    'ui-token':  { type: 'string' },
+    plugins:    { type: 'string' },
+    'log-dir':  { type: 'string' },
+    help:       { type: 'boolean', short: 'h' },
+    version:    { type: 'boolean', short: 'v' },
+  },
+});
+
+if (values.help) {
+  process.stdout.write(HELP);
+  process.exit(0);
+}
+
+if (values.version) {
+  const pkg = JSON.parse(readFileSync(resolve(PKG_ROOT, 'package.json'), 'utf8'));
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+if (positionals[0] === 'init') {
+  const dest = resolve(process.cwd(), '.env');
+  if (existsSync(dest)) {
+    console.log('.env уже существует в текущей директории');
+    process.exit(1);
+  }
+  const template = readFileSync(resolve(PKG_ROOT, '.env.example'), 'utf8');
+  writeFileSync(dest, template);
+  console.log('.env создан. Отредактируй под свои нужды и запусти prism');
+  process.exit(0);
+}
+
+if (values.port)        process.env.PORT = values.port;
+if (values['ios-token']) process.env.IOS_AUTH_KEYS = values['ios-token'];
+if (values['ui-token'])  process.env.UI_AUTH_KEYS = values['ui-token'];
+if (values.plugins)     process.env.ENABLED_PLUGINS = values.plugins;
+if (values['log-dir'])  process.env.CONTEXT_EVENT_LOG_DIR = values['log-dir'];
+
+await import('../src/index.js');

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "prism-debugger",
+  "version": "0.2.0",
+  "description": "Real-time debugger broker for Janative iOS apps — WebSocket bridge between iOS SDK and Web UI (Prism)",
+  "main": "src/index.js",
+  "type": "module",
+  "bin": {
+    "prism": "bin/prism.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "public/",
+    ".env.example"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js"
+  },
+  "keywords": [
+    "debugger",
+    "ios",
+    "janative",
+    "websocket",
+    "prism"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "ws": "^8.18.3"
+  }
+}