@agentshouse/app-bridge 0.1.0-alpha.2 → 0.1.0-alpha.4

package/README.md

@@ -13,7 +13,11 @@ port's one listener. It carries four families:
   returns there when it completes. An App names an address House gave it in a
   reading and composes none.
 - **Status** - the App reference the Runtime port is attached under, sync
-  state, credential state, release availability and observed failure.
+  state, credential state, release availability and observed failure, and
+  `ga`: whether the page measures and the visitor's stored analytics choice.
+  The App reports the visitor's choice with `gaConsent('accept')` or
+  `gaConsent('decline')`; the shell hands it to House's analytics loader, and
+  the choice never reaches House.
 - **Site image read** - given a Published Room and an original attachment
   reference, it answers the web copy's path and metadata, or `null` when no
   copy exists. The original bytes never cross this bridge at a Site.
@@ -66,6 +70,11 @@ host.open('/rooms/atlas');
 ```
 
 The host plays the shell and the worker: it delivers the address the App starts
-at, records every push and replace and answers each with the address the shell
-would then show, records an admitted ceremony, refuses one that is not a
-same-origin absolute path, publishes a status, and attaches a Runtime port.
+at and each address `open` plays as Back or Forward through the shell's own
+slice below the App's path, admitting nothing, so it delivers `//notes` exactly
+as a browser at `/apps/<app>//notes` does. It records every push and replace
+and answers each with the address the shell would then show, records an
+admitted ceremony, refuses a push, replace or ceremony that is not a
+same-origin absolute path, publishes a status, records in `consents` each
+`gaConsent` it takes while that status measures and publishes the status the
+choice leaves, and attaches a Runtime port.

package/{bridge.d.ts → client/src/bridge.d.ts}

@@ -1,4 +1,4 @@
-import type { HouseBridgePort, HouseMessagePort, HouseStatus } from './wire.js';
+import type { HouseBridgePort, HouseGaChoice, HouseMessagePort, HouseStatus } from './wire.js';
 export declare class HouseCeremonyRefused extends Error {
     readonly path: string | null;
     constructor(path: string | null);
@@ -23,5 +23,6 @@ export interface HouseBridge {
     readAttachment(room: string, attachment: string): Promise<HouseImageCopy | null>;
     status(): HouseStatus | null;
     onStatus(listener: (status: HouseStatus) => void): () => void;
+    gaConsent(choice: HouseGaChoice): void;
 }
 export declare function connectHouseBridge(source?: Promise<HouseBridgePort>): HouseBridge;

package/{bridge.js → client/src/bridge.js}

@@ -150,5 +150,8 @@ export function connectHouseBridge(source = heldBridge()) {
                 statusListeners.delete(listener);
             };
         },
+        gaConsent(choice) {
+            send({ house: 'ga/consent', choice });
+        },
     };
 }

package/{index.d.ts → client/src/index.d.ts}

@@ -1,3 +1,3 @@
 export { connectHouseBridge, HouseCeremonyRefused, HouseNavigationRefused, type HouseBridge, type HouseImageCopy, } from './bridge.js';
 export { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';
-export type { HouseBridgeEvent, HouseBridgePort, HouseCredentialState, HouseMessagePort, HouseNavigationMode, HouseStatus, HouseSyncState, } from './wire.js';
+export type { HouseBridgeEvent, HouseBridgePort, HouseCredentialState, HouseGa, HouseGaChoice, HouseMessagePort, HouseNavigationMode, HouseStatus, HouseSyncState, } from './wire.js';

package/{test-host.d.ts → client/src/test-host.d.ts}

@@ -1,5 +1,5 @@
 import type { HouseImageCopy } from './bridge.js';
-import type { HouseBridgePort, HouseMessagePort, HouseNavigationMode, HouseStatus } from './wire.js';
+import type { HouseBridgePort, HouseGaChoice, HouseMessagePort, HouseNavigationMode, HouseStatus } from './wire.js';
 export interface HouseBridgeNavigation {
     readonly mode: HouseNavigationMode;
     readonly address: string;
@@ -8,6 +8,7 @@ export interface HouseBridgeTestHost {
     readonly port: Promise<HouseBridgePort>;
     readonly navigations: readonly HouseBridgeNavigation[];
     readonly ceremonies: readonly string[];
+    readonly consents: readonly HouseGaChoice[];
     address(): string;
     open(address: string): void;
     publish(status: HouseStatus): void;

package/{test-host.js → client/src/test-host.js}

@@ -1,3 +1,4 @@
+import { appAddressOf } from '../../src/apps/remainder.js';
 import { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';
 const HOST_ORIGIN = 'https://house.invalid';
 function sameOriginPath(value) {
@@ -13,10 +14,12 @@ function sameOriginPath(value) {
 export function createHouseBridgeTestHost(options = {}) {
     const navigations = [];
     const ceremonies = [];
+    const consents = [];
     const listeners = new Set();
     const queued = [];
     let started = false;
-    let address = sameOriginPath(options.address ?? '/') ?? '/';
+    let address = appAddressOf('/', options.address ?? '/');
+    let status = options.status ?? null;
     function deliver(data, ports = []) {
         const event = { data, ports };
         if (!started) {
@@ -52,6 +55,18 @@ export function createHouseBridgeTestHost(options = {}) {
         }
         ceremonies.push(target);
     }
+    function publish(next) {
+        status = next;
+        deliver({ house: 'status', status });
+    }
+    function consent(choice) {
+        if (status === null || !status.ga.measures)
+            return;
+        if (choice !== 'accept' && choice !== 'decline')
+            return;
+        consents.push(choice);
+        publish({ ...status, ga: { measures: true, choice } });
+    }
     function receive(message) {
         const data = message;
         if (data === null || typeof data !== 'object')
@@ -62,6 +77,9 @@ export function createHouseBridgeTestHost(options = {}) {
         else if (data.house === 'ceremony') {
             ceremony(data.path);
         }
+        else if (data.house === 'ga/consent') {
+            consent(data.choice);
+        }
         else if (data.house === 'attachment-read') {
             const asked = data;
             const image = options.images?.find((entry) => entry.room === asked.room && entry.attachment === asked.attachment);
@@ -97,24 +115,21 @@ export function createHouseBridgeTestHost(options = {}) {
             });
         },
     };
-    if (options.status !== undefined)
-        deliver({ house: 'status', status: options.status });
+    if (status !== null)
+        deliver({ house: 'status', status });
     deliver({ house: 'address', address, navigated: false });
     return {
         port: Promise.resolve(port),
         navigations,
         ceremonies,
+        consents,
         address() {
             return address;
         },
         open(asked) {
-            const target = sameOriginPath(asked);
-            if (target !== null)
-                arrive(target, false);
-        },
-        publish(status) {
-            deliver({ house: 'status', status });
+            arrive(appAddressOf('/', asked), false);
         },
+        publish,
         attachRuntime(runtime) {
             deliver({ house: 'runtime' }, [runtime]);
         },

package/{wire.d.ts → client/src/wire.d.ts}

@@ -16,6 +16,11 @@ export interface HouseCredentialState {
     readonly state: 'none' | 'held' | 'rejected';
     readonly expires_at: number | null;
 }
+export type HouseGaChoice = 'accept' | 'decline';
+export interface HouseGa {
+    readonly measures: boolean;
+    readonly choice: HouseGaChoice | null;
+}
 export interface HouseStatus {
     readonly app: string;
     readonly runtime: string;
@@ -26,6 +31,7 @@ export interface HouseStatus {
     } | null;
     readonly loss: string | null;
     readonly release: unknown;
+    readonly ga: HouseGa;
 }
 export type HouseNavigationMode = 'push' | 'replace';
 export declare const HOUSE_ADDRESS_MAX_CHARS = 1000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "Renderer-side client of the agents.house App bridge: navigation, ceremonies, status and Site image reads, with an in-page test host.",
   "license": "UNLICENSED",
   "type": "module",
@@ -10,17 +10,19 @@
   },
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "default": "./index.js"
+      "types": "./client/src/index.d.ts",
+      "default": "./client/src/index.js"
     },
     "./test-host": {
-      "types": "./test-host.d.ts",
-      "default": "./test-host.js"
+      "types": "./client/src/test-host.d.ts",
+      "default": "./client/src/test-host.js"
     }
   },
   "files": [
-    "*.js",
-    "*.d.ts",
+    "client/src/*.js",
+    "client/src/*.d.ts",
+    "src/apps/remainder.js",
+    "src/apps/remainder.d.ts",
     "README.md"
   ]
 }

package/src/apps/remainder.d.ts

@@ -0,0 +1,2 @@
+export declare function appAddressOf(root: string, address: string): string;
+export declare function shellAddressOf(root: string, appAddress: string): string;

package/src/apps/remainder.js

@@ -0,0 +1,16 @@
+function split(address) {
+    const mark = address.search(/[?#]/u);
+    return mark < 0
+        ? { path: address, rest: '' }
+        : { path: address.slice(0, mark), rest: address.slice(mark) };
+}
+export function appAddressOf(root, address) {
+    const { path, rest } = split(address);
+    const below = root === '/' ? path : path.slice(root.length);
+    return `${below.startsWith('/') ? below : `/${below}`}${rest}`;
+}
+export function shellAddressOf(root, appAddress) {
+    const { path, rest } = split(appAddress);
+    const below = path === '/' ? '' : path;
+    return `${root === '/' ? '' : root}${below}${rest}` || '/';
+}