@reticlehq/browser 3.7.0 → 3.8.1

package/dist/reticle.d.ts

@@ -1,8 +1,8 @@
 import { EventType, RETICLE_URL_PARAM, HudVisibility, type ReticleEvent } from '@reticlehq/core';
 import { type CapabilitiesInput } from './registry/capabilities.js';
-import type { ReticleConnectOptions } from './connect-options.js';
+import { type ReticleConnectOptions } from './connect-options.js';
+export { helloMode, shouldBlockProduction } from './connect-options.js';
 export type { ReticleConnectOptions };
-export declare function shouldBlockProduction(nodeEnv: string | undefined, allowInProduction: boolean): boolean;
 export declare function withBridgePath(bridgeUrl: string): {
     url: string;
     adjusted: boolean;
@@ -43,7 +43,9 @@ export declare class Reticle {
     #private;
     connect(options?: ReticleConnectOptions): void;
     get connected(): boolean;
+    routes(patterns: readonly string[]): void;
     signal(name: string, data?: Record<string, unknown>): void;
+    busy<T>(work: Promise<T>): Promise<T>;
     state(name: string, value: unknown): void;
     renderCommit(commits: number): void;
     describe(input: CapabilitiesInput): void;

package/dist/reticle.js

@@ -1,4 +1,6 @@
 import { setPresenterViewer, setPresenterVisible } from './dom/dom-ignore.js';
+import { trackBusy } from './busy.js';
+import { declareRoutes } from './observers/route.js';
 import { setOutwardPolicy } from './actions/danger-context.js';
 import { coverageMarkers, notApplicableFor } from './dom/addressing/coverage-markers.js';
 import { EventType, RETICLE_DEFAULT_PORT, RETICLE_PROTOCOL_VERSION, RETICLE_URL_PARAM, RETICLE_WS_PATH, bridgeWsUrl, ReticleCommand, MessageKind, SESSION_AUTO, SessionState, TRANSPORT_LIMITS, buildRedactionPolicy, isLoopbackHostname, isLocalPage, setActiveRedactionPolicy, wireRedactionKeys, RETICLE_ROOT_GLOBAL, RETICLE_SDK_VERSION_GLOBAL, CONTRACT_FINGERPRINT, CONTRACT_PARTS, newDocumentId, NO_EDITS_OBSERVED, PresenterMode, CommandActor, HudCorner, HudVisibility, } from '@reticlehq/core';
@@ -14,6 +16,8 @@ import { registerCapabilities, setCapabilitiesListener, hasCapabilities, } from
 import { installAllObservers, runTeardowns } from './observers/install-all.js';
 import { setTestIdAttr } from './dom/addressing/testid-attr.js';
 import { setNetworkBodyMaxChars } from './observers/net-detail/network-body.js';
+import { pageHref } from './security/page-location.js';
+import { scrubKnownSecrets } from './security/serialization.js';
 import { installOverlay } from './presenter/chrome/overlay.js';
 import { LOG_ACTOR, LOG_KIND, LOG_RESULT } from './presenter/chrome/log-kinds.js';
 import { actionVerb } from './presenter/chrome/presenter-verbs.js';
@@ -22,9 +26,8 @@ import { resetClock } from './timers/clock.js';
 import { nativeWarn } from './timers/console/native-console.js';
 import { installRecorder } from './recorder/recorder.js';
 import { Annotator } from './review/annotator.js';
-export function shouldBlockProduction(nodeEnv, allowInProduction) {
-    return 'production' === nodeEnv && !allowInProduction;
-}
+import { helloMode, leaseToken, shouldBlockProduction, } from './connect-options.js';
+export { helloMode, shouldBlockProduction } from './connect-options.js';
 export function withBridgePath(bridgeUrl) {
     let parsed;
     try {
@@ -153,6 +156,7 @@ export class Reticle {
     #annotator;
     #eventCount = 0;
     #token;
+    #mode = {};
     #sdkVersion;
     #captureBodies = false;
     #sourceMapping = undefined;
@@ -160,8 +164,15 @@ export class Reticle {
     #redactKeys = [];
     #actHandle;
     connect(options = {}) {
-        if (this.#connected)
+        if (this.#connected) {
+            const leased = leaseToken(options, this.#token);
+            if (leased !== undefined) {
+                this.#token = leased;
+                this.#transport?.redialAfterRefusal();
+            }
+            this.#adoptLateProjectId(options);
             return;
+        }
         if ('undefined' === typeof window || 'undefined' === typeof document)
             return;
         const proc = globalThis.process;
@@ -198,6 +209,7 @@ export class Reticle {
         this.#token =
             options.token !== undefined && options.token.length > 0 ? options.token : undefined;
         this.#projectId = identity.projectId;
+        this.#mode = helloMode(options);
         this.#applyRedaction(options.redact);
         this.#start = performance.now();
         this.#registry = createCommandRegistry();
@@ -344,9 +356,17 @@ export class Reticle {
     get connected() {
         return this.#connected;
     }
+    routes(patterns) {
+        declareRoutes(patterns);
+    }
     signal(name, data = {}) {
         this.#emit(EventType.SIGNAL, { name, data });
     }
+    busy(work) {
+        return trackBusy(work, (name, data) => {
+            this.signal(name, data);
+        });
+    }
     state(name, value) {
         this.#emit(EventType.STATE_CHANGE, { name, value });
     }
@@ -407,16 +427,26 @@ export class Reticle {
         setActiveRedactionPolicy(buildRedactionPolicy(config, nativeWarn));
         this.#redactKeys = wireRedactionKeys(config);
     }
+    #adoptLateProjectId(options) {
+        if (this.#projectId !== undefined)
+            return;
+        const late = resolveConnectIdentity(options, window.location.search).projectId;
+        if (late === undefined)
+            return;
+        this.#projectId = late;
+        this.#transport?.reannounce();
+    }
     #hello() {
         return {
             kind: MessageKind.HELLO,
             protocolVersion: RETICLE_PROTOCOL_VERSION,
             sessionId: this.#session,
             ...(this.#projectId === undefined ? {} : { projectId: this.#projectId }),
-            url: location.href,
-            title: document.title,
+            url: pageHref(),
+            title: scrubKnownSecrets(document.title),
             adapters: adapterNames(),
             ...(this.#token === undefined ? {} : { token: this.#token }),
+            ...this.#mode,
             hasCapabilities: hasCapabilities(),
             channels: declaredChannels(),
             platform: declaredPlatform(),

package/dist/security/page-location.d.ts

@@ -0,0 +1,2 @@
+export declare function pageHref(): string;
+export declare function pageRoute(withHash?: boolean): string;

package/dist/security/page-location.js

@@ -0,0 +1,7 @@
+import { redactUrl } from '@reticlehq/core';
+export function pageHref() {
+    return redactUrl(location.href);
+}
+export function pageRoute(withHash = true) {
+    return redactUrl(`${location.pathname}${location.search}${withHash ? location.hash : ''}`);
+}

package/dist/security/serialization.js

@@ -29,7 +29,7 @@ function sanitize(value, state, depth, key) {
     if (null === value || 'boolean' === typeof value)
         return value;
     if ('string' === typeof value) {
-        return boundedString(value, state, 'error' === key?.toLowerCase()
+        return boundedString(scrubKnownSecrets(value), state, 'error' === key?.toLowerCase()
             ? TRANSPORT_LIMITS.MAX_ERROR_LENGTH
             : TRANSPORT_LIMITS.MAX_STRING_LENGTH);
     }

package/dist/storage-keys.d.ts

@@ -5,6 +5,7 @@ export declare const ReticleStorageKey: {
     readonly PRESENTER_LOG_OWNER: "reticle-presenter-log-owner";
     readonly PRESENTER_SETTINGS: "reticle-presenter-settings";
     readonly PRESENTER_MINIMISED: "reticle-presenter-minimised";
+    readonly PRESENTER_OPEN: "reticle-presenter-open";
     readonly PRESENTER_VIEW: "reticle-presenter-view";
     readonly CAROUSEL_DISMISSED: "reticle.carousel.dismissed";
     readonly ANNOTATION_HISTORY: "reticle.annotations.history.v1";

package/dist/storage-keys.js

@@ -5,6 +5,7 @@ export const ReticleStorageKey = {
     PRESENTER_LOG_OWNER: 'reticle-presenter-log-owner',
     PRESENTER_SETTINGS: 'reticle-presenter-settings',
     PRESENTER_MINIMISED: 'reticle-presenter-minimised',
+    PRESENTER_OPEN: 'reticle-presenter-open',
     PRESENTER_VIEW: 'reticle-presenter-view',
     CAROUSEL_DISMISSED: 'reticle.carousel.dismissed',
     ANNOTATION_HISTORY: 'reticle.annotations.history.v1',

package/dist/timers/native/native-timers.d.ts

@@ -8,4 +8,5 @@ interface FrameOutcome {
 export declare const boundedFrame: (budgetMs?: number) => Promise<FrameOutcome>;
 export declare const nativeFrame: () => Promise<void>;
 export declare const settle: (budgetMs?: number) => Promise<FrameOutcome>;
+export declare function asSettleBudget(raw: unknown): number | undefined;
 export {};

package/dist/timers/native/native-timers.js

@@ -46,3 +46,8 @@ export const settle = async (budgetMs = FRAME_BUDGET_MS) => {
     await Promise.resolve();
     return boundedFrame(budgetMs);
 };
+export function asSettleBudget(raw) {
+    if ('number' !== typeof raw || !Number.isFinite(raw))
+        return undefined;
+    return Math.max(0, Math.min(raw, FRAME_BUDGET_MS));
+}

package/dist/transport/transport.d.ts

@@ -26,6 +26,7 @@ export declare class Transport {
     constructor(deps: TransportDeps);
     connect(): void;
     sendEvent(event: ReticleEvent): void;
+    redialAfterRefusal(): void;
     reannounce(): void;
     close(): void;
 }

package/dist/transport/transport.js

@@ -27,6 +27,7 @@ export class Transport {
     #insertOrder = 0;
     #closed = false;
     #refused = false;
+    #redialOnRefusal = false;
     #disconnectedSince;
     #reconnectDelay = RECONNECT_DELAY_MS;
     #lost = false;
@@ -94,6 +95,11 @@ export class Transport {
         ws.onclose = (event) => {
             this.#ws = undefined;
             if (event.code === WS_POLICY_VIOLATION) {
+                if (this.#redialOnRefusal && !this.#closed) {
+                    this.#redialOnRefusal = false;
+                    this.#open();
+                    return;
+                }
                 this.#refused = true;
                 const reason = event.reason.length > 0 ? event.reason : 'policy violation';
                 nativeWarn(`[reticle] bridge refused the connection: ${reason} — not retrying until you come back to this tab.`);
@@ -197,6 +203,18 @@ export class Transport {
             type: event.type,
         });
     }
+    redialAfterRefusal() {
+        if (this.#closed) {
+            return;
+        }
+        if (this.#refused && this.#ws === undefined) {
+            this.#refused = false;
+            this.#reconnectDelay = RECONNECT_DELAY_MS;
+            this.#open();
+            return;
+        }
+        this.#redialOnRefusal = true;
+    }
     reannounce() {
         if (this.#ws === undefined || this.#ws.readyState !== WebSocket.OPEN)
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reticlehq/browser",
-  "version": "3.7.0",
+  "version": "3.8.1",
   "description": "Reticle browser SDK — installs observers, builds semantic snapshots, executes actions, talks to the bridge.",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,10 +15,14 @@
     "./inject": {
       "types": "./dist/reticle-inject.d.ts",
       "default": "./dist/reticle-inject.js"
+    },
+    "./activate": {
+      "types": "./dist/activate.d.ts",
+      "default": "./dist/activate.js"
     }
   },
   "dependencies": {
-    "@reticlehq/core": "3.7.0"
+    "@reticlehq/core": "3.8.1"
   },
   "devDependencies": {
     "@iconify-json/heroicons-outline": "^1.2.1",