react-native-debug-toolkit 2.2.0 → 3.0.0

package/lib/typescript/src/utils/createPersistedObservableStore.d.ts

@@ -6,8 +6,9 @@ export interface PersistedStoreOptions<T> {
     serialize?: (entry: T) => unknown;
 }
 export interface PersistedObservableStore<T> extends ObservableStore<T> {
-    /** Returns the next auto-incrementing ID and advances the counter. */
     nextId: () => string;
+    ready: Promise<void>;
+    destroy: () => void;
 }
 export declare function createPersistedObservableStore<T extends {
     id?: string;

package/lib/typescript/src/utils/createPersistedObservableStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPersistedObservableStore.d.ts","sourceRoot":"","sources":["../../../../src/utils/createPersistedObservableStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGtF,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACrE,sEAAsE;IACtE,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,wBAAwB,CAAC,CAAC,CAAC,CA0D7B"}
+{"version":3,"file":"createPersistedObservableStore.d.ts","sourceRoot":"","sources":["../../../../src/utils/createPersistedObservableStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGtF,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACrE,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,wBAAwB,CAAC,CAAC,CAAC,CAsE7B"}

package/lib/typescript/src/utils/daemonConnection.d.ts

@@ -0,0 +1,18 @@
+export type DaemonConnectionFailureReason = 'fetch_unavailable' | 'timeout' | 'http' | 'invalid_response' | 'network';
+export type DaemonConnectionResult = {
+    ok: true;
+    endpoint: string;
+    status: number;
+} | {
+    ok: false;
+    endpoint: string;
+    reason: DaemonConnectionFailureReason;
+    status?: number;
+    error?: string;
+};
+export interface DaemonConnectionOptions {
+    endpoint?: string;
+    timeoutMs?: number;
+}
+export declare function checkDaemonConnection(options?: DaemonConnectionOptions): Promise<DaemonConnectionResult>;
+//# sourceMappingURL=daemonConnection.d.ts.map

package/lib/typescript/src/utils/daemonConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonConnection.d.ts","sourceRoot":"","sources":["../../../../src/utils/daemonConnection.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,6BAA6B,GACrC,mBAAmB,GACnB,SAAS,GACT,MAAM,GACN,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,sBAAsB,GAC9B;IACA,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACC;IACA,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,6BAA6B,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEJ,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAmEjC"}

package/lib/typescript/src/utils/daemonSettings.d.ts

@@ -0,0 +1,19 @@
+export declare const DAEMON_ENDPOINT_STORAGE_KEY = "debugToolkit_streamEndpoint";
+export declare const DAEMON_TOKEN_STORAGE_KEY = "debugToolkit_streamToken";
+export declare const DAEMON_CONNECTION_MODE_STORAGE_KEY = "debugToolkit_connectionMode";
+export declare const DAEMON_DEVICE_HOST_STORAGE_KEY = "debugToolkit_deviceHost";
+export type DaemonConnectionMode = 'simulator' | 'device';
+export interface DaemonSettings {
+    mode: DaemonConnectionMode;
+    endpoint: string;
+    deviceHost: string;
+    token: string;
+}
+export declare function loadDaemonSettings(): Promise<DaemonSettings>;
+export declare function saveDaemonSettings(settings: DaemonSettings): Promise<void>;
+export declare function buildDeviceDaemonEndpoint(host: string): string;
+export declare function normalizeDaemonSettings(settings: DaemonSettings): {
+    endpoint?: string;
+    token?: string;
+};
+//# sourceMappingURL=daemonSettings.d.ts.map

package/lib/typescript/src/utils/daemonSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonSettings.d.ts","sourceRoot":"","sources":["../../../../src/utils/daemonSettings.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AACzE,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,kCAAkC,gCAAgC,CAAC;AAChF,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAgBD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CA0BlE;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF;AA2BD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB9D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CASA"}

package/lib/typescript/src/utils/reportToDaemon.d.ts

@@ -0,0 +1,34 @@
+import { type DebugSessionReport, type DebugSessionReportOptions } from './sessionReport';
+type FetchResponseLike = {
+    ok: boolean;
+    status: number;
+    json?: () => Promise<unknown>;
+    text?: () => Promise<string>;
+};
+type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    signal?: unknown;
+}) => Promise<FetchResponseLike>;
+export interface ReportToDaemonOptions extends DebugSessionReportOptions {
+    endpoint?: string;
+    timeoutMs?: number;
+    token?: string;
+}
+export interface ReportResult {
+    ok: boolean;
+    endpoint: string;
+    report: DebugSessionReport;
+    status?: number;
+    sessionId?: string;
+    receivedAt?: string;
+    logCount?: Record<string, number>;
+    error?: string;
+}
+export declare function getGlobalFetch(): FetchLike | undefined;
+export declare function getDefaultDaemonEndpoint(): string;
+export declare function buildDaemonUrl(endpoint: string, path: string): string;
+export declare function reportDebugSessionToDaemon(options?: ReportToDaemonOptions): Promise<ReportResult>;
+export {};
+//# sourceMappingURL=reportToDaemon.d.ts.map

package/lib/typescript/src/utils/reportToDaemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportToDaemon.d.ts","sourceRoot":"","sources":["../../../../src/utils/reportToDaemon.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAC;AAIzB,KAAK,iBAAiB,GAAG;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,KAAK,SAAS,GAAG,CACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,KACE,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAOhC,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,SAAS,GAAG,SAAS,CAEtD;AASD,wBAAgB,wBAAwB,IAAI,MAAM,CAKjD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrE;AAiCD,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,YAAY,CAAC,CAiEvB"}

package/lib/typescript/src/utils/sessionReport.d.ts

@@ -0,0 +1,18 @@
+export interface DebugSessionReportOptions {
+    maxPerType?: number;
+    maxBodyBytes?: number;
+    includeTypes?: string[];
+}
+export interface DeviceInfo {
+    platform: string;
+    model: string;
+    osVersion: string;
+    appVersion: string;
+}
+export interface DebugSessionReport {
+    version: 2;
+    device: DeviceInfo;
+    logs: Record<string, unknown[] | undefined>;
+}
+export declare function createDebugSessionReport(options?: DebugSessionReportOptions): DebugSessionReport;
+//# sourceMappingURL=sessionReport.d.ts.map

package/lib/typescript/src/utils/sessionReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionReport.d.ts","sourceRoot":"","sources":["../../../../src/utils/sessionReport.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;CAC7C;AAuID,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAuCpB"}

package/lib/typescript/src/utils/streamToDaemon.d.ts

@@ -0,0 +1,23 @@
+export interface StreamToDaemonOptions {
+    endpoint?: string;
+    token?: string;
+    debounceMs?: number;
+    timeoutMs?: number;
+    onStatus?: (status: StreamStatus) => void;
+}
+export type StreamStatus = {
+    state: 'connecting';
+} | {
+    state: 'connected';
+    sessionId: string;
+} | {
+    state: 'retrying';
+    retryInMs: number;
+} | {
+    state: 'failed';
+    reason: 'auth' | 'retry_limit';
+};
+export declare function startStreaming(options?: StreamToDaemonOptions): void;
+export declare function stopStreaming(): void;
+export declare function isStreaming(): boolean;
+//# sourceMappingURL=streamToDaemon.d.ts.map

package/lib/typescript/src/utils/streamToDaemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamToDaemon.d.ts","sourceRoot":"","sources":["../../../../src/utils/streamToDaemon.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GACvB;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,CAAC;AAiVxD,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CA0CxE;AAED,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/node/daemon/src/cli.js

@@ -0,0 +1,75 @@
+'use strict';
+
+const {
+  DAEMON_NAME,
+  DEFAULT_HOST,
+  DEFAULT_PORT,
+  getLanIPs,
+} = require('./constants');
+const { createDaemonServer } = require('./server');
+
+function readOption(args, name, fallback) {
+  const index = args.indexOf(name);
+  if (index < 0) {
+    return fallback;
+  }
+  return args[index + 1] || fallback;
+}
+
+function hasHelpFlag(args) {
+  return args.includes('--help') || args.includes('-h');
+}
+
+function printHelp() {
+  process.stdout.write('Usage: debug-toolkit-daemon [--host 0.0.0.0] [--port 3799] [--token dev-token]\n');
+}
+
+function getLocalOrigin(host, port) {
+  const localHost = host === '0.0.0.0' || host === '::' ? '127.0.0.1' : host;
+  return `http://${localHost}:${port}`;
+}
+
+function startDaemonFromCli(args) {
+  if (hasHelpFlag(args)) {
+    printHelp();
+    return;
+  }
+
+  const host = readOption(args, '--host', process.env.DEBUG_TOOLKIT_DAEMON_HOST || DEFAULT_HOST);
+  const port = Number(readOption(args, '--port', process.env.DEBUG_TOOLKIT_DAEMON_PORT || DEFAULT_PORT));
+  const token = readOption(args, '--token', process.env.DEBUG_TOOLKIT_DAEMON_TOKEN || '');
+
+  if (!Number.isFinite(port) || port <= 0) {
+    process.stderr.write('Invalid --port value\n');
+    process.exitCode = 1;
+    return;
+  }
+
+  const { server } = createDaemonServer({ token });
+
+  server.on('error', (error) => {
+    process.stderr.write(`${DAEMON_NAME} failed to start: ${error.message}\n`);
+    process.exitCode = 1;
+  });
+
+  server.listen(port, host, () => {
+    const consolePath = token ? `/console?token=${encodeURIComponent(token)}` : '/console';
+    process.stderr.write(`${DAEMON_NAME} listening on http://${host}:${port}\n`);
+    process.stderr.write(`Web Console: ${getLocalOrigin(host, port)}${consolePath}\n`);
+    const lanIPs = getLanIPs();
+    if (lanIPs.length > 0) {
+      process.stderr.write(`LAN IPs: ${lanIPs.join(', ')}\n`);
+    }
+  });
+
+  const close = () => {
+    server.close(() => process.exit(0));
+  };
+
+  process.on('SIGINT', close);
+  process.on('SIGTERM', close);
+}
+
+module.exports = {
+  startDaemonFromCli,
+};