ugly-app 0.1.716 → 0.1.717

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.716";
+export declare const CLI_VERSION = "0.1.717";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.716";
+export const CLI_VERSION = "0.1.717";
 //# sourceMappingURL=version.js.map

package/dist/inspect/index.d.ts

@@ -3,4 +3,5 @@ export type { AgentEvents, AgentMeta, InspectAgent } from './agent/types.js';
 export { createInspectAgent, installInspectAgent } from './agent/install.js';
 export { InspectClient, type InspectTransport } from './client.js';
 export { buildTarget, dispatchToAgent, HOST_ONLY_CHANNELS } from './dispatch.js';
+export { createSelfInspectHost, SELF_TARGET_ID, type SelfInspectHost, type SelfInspectHostOpts, } from './selfHost.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC"}

package/dist/inspect/index.js

@@ -5,4 +5,5 @@ export * from './protocol.js';
 export { createInspectAgent, installInspectAgent } from './agent/install.js';
 export { InspectClient } from './client.js';
 export { buildTarget, dispatchToAgent, HOST_ONLY_CHANNELS } from './dispatch.js';
+export { createSelfInspectHost, SELF_TARGET_ID, } from './selfHost.js';
 //# sourceMappingURL=index.js.map

package/dist/inspect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAE/E,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAE/E,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,cAAc,GAGf,MAAM,eAAe,CAAC"}

package/dist/inspect/selfHost.d.ts

@@ -0,0 +1,20 @@
+import type { InspectPlatform, Screenshot, ScreenshotRequest } from './protocol.js';
+/** The id this host reports for its single (self) target. */
+export declare const SELF_TARGET_ID = "self";
+export interface SelfInspectHostOpts {
+    platform: InspectPlatform;
+    /** Screenshot delegate — on mobile this calls native (WKWebView.takeSnapshot /
+     *  Android PixelCopy) via the uglyNative `capture.screenshot` channel. */
+    screenshot?: (req: ScreenshotRequest) => Promise<Screenshot>;
+    /** Forward live agent events to the proxy connection. Event names are the
+     *  per-target dynamic form (`inspect.console:self`, `inspect.network:self`,
+     *  `inspect.picked:self`). */
+    onEvent?: (event: string, data: unknown) => void;
+}
+export interface SelfInspectHost {
+    /** Route one inspect.* channel (targetId is ignored — there is only `self`). */
+    dispatch(channel: string, payload?: Record<string, unknown>): Promise<unknown>;
+    stop(): void;
+}
+export declare function createSelfInspectHost(opts: SelfInspectHostOpts): SelfInspectHost;
+//# sourceMappingURL=selfHost.d.ts.map

package/dist/inspect/selfHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfHost.d.ts","sourceRoot":"","sources":["../../src/inspect/selfHost.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpF,6DAA6D;AAC7D,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B;8EAC0E;IAC1E,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D;;kCAE8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/E,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CAuBhF"}

package/dist/inspect/selfHost.js

@@ -0,0 +1,38 @@
+// A single-page inspect host: answers inspect.* for the CURRENT page only,
+// routing to the in-page agent. This is the building block for shells that have
+// no native cross-tab host — chiefly the MOBILE SPA (iOS WKWebView / Android
+// WebView), where the whole proxy stack lives in the webview JS (browser
+// RTCPeerConnection) and there is exactly one inspectable page: itself.
+//
+// The transport that connects a remote inspector to this host (the SPA acting
+// as an MSK-authenticated proxy host) is shell-specific and wired separately;
+// this module is just the platform-agnostic dispatch + target it answers with.
+import { installInspectAgent } from './agent/install.js';
+import { buildTarget, dispatchToAgent } from './dispatch.js';
+/** The id this host reports for its single (self) target. */
+export const SELF_TARGET_ID = 'self';
+export function createSelfInspectHost(opts) {
+    const agent = installInspectAgent({
+        onConsole: (e) => opts.onEvent?.(`inspect.console:${SELF_TARGET_ID}`, e),
+        onNetwork: (e) => opts.onEvent?.(`inspect.network:${SELF_TARGET_ID}`, e),
+        onPicked: (p) => opts.onEvent?.(`inspect.picked:${SELF_TARGET_ID}`, p),
+    });
+    return {
+        async dispatch(channel, payload = {}) {
+            if (channel === 'inspect.listTargets') {
+                return { targets: [buildTarget(SELF_TARGET_ID, opts.platform, agent.meta())] };
+            }
+            if (channel === 'inspect.screenshot') {
+                if (!opts.screenshot)
+                    throw new Error('inspect.screenshot: no native capture on this shell');
+                return opts.screenshot({ ...payload, targetId: SELF_TARGET_ID });
+            }
+            // Everything else is an agent method (targetId stripped — there is only self).
+            return dispatchToAgent(agent, channel, payload);
+        },
+        stop() {
+            agent.stop();
+        },
+    };
+}
+//# sourceMappingURL=selfHost.js.map

package/dist/inspect/selfHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfHost.js","sourceRoot":"","sources":["../../src/inspect/selfHost.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,gFAAgF;AAChF,6EAA6E;AAC7E,yEAAyE;AACzE,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG7D,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAmBrC,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,mBAAmB,cAAc,EAAE,EAAE,CAAC,CAAC;QACxE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,mBAAmB,cAAc,EAAE,EAAE,CAAC,CAAC;QACxE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,kBAAkB,cAAc,EAAE,EAAE,CAAC,CAAC;KACvE,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,UAAmC,EAAE;YACnE,IAAI,OAAO,KAAK,qBAAqB,EAAE,CAAC;gBACtC,OAAO,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACjF,CAAC;YACD,IAAI,OAAO,KAAK,oBAAoB,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,UAAU;oBAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBAC7F,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,GAAI,OAAwC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;YACrG,CAAC;YACD,+EAA+E;YAC/E,OAAO,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,IAAI;YACF,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-app",
-  "version": "0.1.716",
+  "version": "0.1.717",
   "type": "module",
   "comment:files": "Allowlist what ships to npm. dist = runtime; src = sourcemap targets (dist/*.js.map reference ../../src/); templates = CLI scaffold. Everything else at repo root (.pgdata local Postgres, coverage, assets/icons sources, test/, test-results/) is excluded by omission. The !negations strip the scaffold's installed deps + cruft (templates/node_modules is 200MB+ and must never ship). package.json/README/LICENSE ship automatically.",
   "files": [

package/src/cli/version.ts

@@ -1,2 +1,2 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.716";
+export const CLI_VERSION = "0.1.717";

package/src/inspect/index.ts

@@ -7,3 +7,9 @@ export type { AgentEvents, AgentMeta, InspectAgent } from './agent/types.js';
 export { createInspectAgent, installInspectAgent } from './agent/install.js';
 export { InspectClient, type InspectTransport } from './client.js';
 export { buildTarget, dispatchToAgent, HOST_ONLY_CHANNELS } from './dispatch.js';
+export {
+  createSelfInspectHost,
+  SELF_TARGET_ID,
+  type SelfInspectHost,
+  type SelfInspectHostOpts,
+} from './selfHost.js';

package/src/inspect/selfHost.test.ts

@@ -0,0 +1,59 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { createSelfInspectHost, SELF_TARGET_ID } from './selfHost.js';
+import type { Screenshot } from './protocol.js';
+
+afterEach(() => {
+  // Reset the singleton agent between tests.
+  delete (window as { __uglyInspectAgent?: unknown }).__uglyInspectAgent;
+});
+
+describe('createSelfInspectHost', () => {
+  it('lists exactly one target (self) with the given platform', async () => {
+    document.title = 'Mobile App';
+    const host = createSelfInspectHost({ platform: 'ios' });
+    const res = (await host.dispatch('inspect.listTargets')) as { targets: { id: string; platform: string }[] };
+    expect(res.targets).toHaveLength(1);
+    expect(res.targets[0].id).toBe(SELF_TARGET_ID);
+    expect(res.targets[0].platform).toBe('ios');
+  });
+
+  it('routes inspect.eval to the in-page agent', async () => {
+    const host = createSelfInspectHost({ platform: 'android' });
+    const res = (await host.dispatch('inspect.eval', { expression: '21 * 2' })) as {
+      ok: boolean;
+      value: { value: number };
+    };
+    expect(res.ok).toBe(true);
+    expect(res.value.value).toBe(42);
+  });
+
+  it('captures the DOM via the agent', async () => {
+    document.body.innerHTML = '<main id="x">hi</main>';
+    const host = createSelfInspectHost({ platform: 'ios' });
+    const snap = (await host.dispatch('inspect.dom.capture')) as { root: { nodeName: string } };
+    expect(snap.root.nodeName).toBe('HTML');
+  });
+
+  it('delegates inspect.screenshot to the native capture callback', async () => {
+    const shot: Screenshot = { base64: 'AAAA', width: 390, height: 844, dpr: 3, format: 'png' };
+    const capture = vi.fn(async () => shot);
+    const host = createSelfInspectHost({ platform: 'ios', screenshot: capture });
+    const res = await host.dispatch('inspect.screenshot', { fullPage: true });
+    expect(res).toEqual(shot);
+    expect(capture).toHaveBeenCalledWith(expect.objectContaining({ targetId: SELF_TARGET_ID, fullPage: true }));
+  });
+
+  it('errors on screenshot when no native capture is provided', async () => {
+    const host = createSelfInspectHost({ platform: 'web' });
+    await expect(host.dispatch('inspect.screenshot', {})).rejects.toThrow(/no native capture/);
+  });
+
+  it('forwards live console events under the self event name', async () => {
+    const events: { event: string; data: unknown }[] = [];
+    createSelfInspectHost({ platform: 'android', onEvent: (event, data) => events.push({ event, data }) });
+    console.log('streamed-line');
+    const consoleEvt = events.find((e) => e.event === `inspect.console:${SELF_TARGET_ID}`);
+    expect(consoleEvt).toBeTruthy();
+  });
+});

package/src/inspect/selfHost.ts

@@ -0,0 +1,58 @@
+// A single-page inspect host: answers inspect.* for the CURRENT page only,
+// routing to the in-page agent. This is the building block for shells that have
+// no native cross-tab host — chiefly the MOBILE SPA (iOS WKWebView / Android
+// WebView), where the whole proxy stack lives in the webview JS (browser
+// RTCPeerConnection) and there is exactly one inspectable page: itself.
+//
+// The transport that connects a remote inspector to this host (the SPA acting
+// as an MSK-authenticated proxy host) is shell-specific and wired separately;
+// this module is just the platform-agnostic dispatch + target it answers with.
+
+import { installInspectAgent } from './agent/install.js';
+import { buildTarget, dispatchToAgent } from './dispatch.js';
+import type { InspectPlatform, Screenshot, ScreenshotRequest } from './protocol.js';
+
+/** The id this host reports for its single (self) target. */
+export const SELF_TARGET_ID = 'self';
+
+export interface SelfInspectHostOpts {
+  platform: InspectPlatform;
+  /** Screenshot delegate — on mobile this calls native (WKWebView.takeSnapshot /
+   *  Android PixelCopy) via the uglyNative `capture.screenshot` channel. */
+  screenshot?: (req: ScreenshotRequest) => Promise<Screenshot>;
+  /** Forward live agent events to the proxy connection. Event names are the
+   *  per-target dynamic form (`inspect.console:self`, `inspect.network:self`,
+   *  `inspect.picked:self`). */
+  onEvent?: (event: string, data: unknown) => void;
+}
+
+export interface SelfInspectHost {
+  /** Route one inspect.* channel (targetId is ignored — there is only `self`). */
+  dispatch(channel: string, payload?: Record<string, unknown>): Promise<unknown>;
+  stop(): void;
+}
+
+export function createSelfInspectHost(opts: SelfInspectHostOpts): SelfInspectHost {
+  const agent = installInspectAgent({
+    onConsole: (e) => opts.onEvent?.(`inspect.console:${SELF_TARGET_ID}`, e),
+    onNetwork: (e) => opts.onEvent?.(`inspect.network:${SELF_TARGET_ID}`, e),
+    onPicked: (p) => opts.onEvent?.(`inspect.picked:${SELF_TARGET_ID}`, p),
+  });
+
+  return {
+    async dispatch(channel: string, payload: Record<string, unknown> = {}): Promise<unknown> {
+      if (channel === 'inspect.listTargets') {
+        return { targets: [buildTarget(SELF_TARGET_ID, opts.platform, agent.meta())] };
+      }
+      if (channel === 'inspect.screenshot') {
+        if (!opts.screenshot) throw new Error('inspect.screenshot: no native capture on this shell');
+        return opts.screenshot({ ...(payload as unknown as ScreenshotRequest), targetId: SELF_TARGET_ID });
+      }
+      // Everything else is an agent method (targetId stripped — there is only self).
+      return dispatchToAgent(agent, channel, payload);
+    },
+    stop() {
+      agent.stop();
+    },
+  };
+}