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

package/README.md

@@ -66,6 +66,9 @@ 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
+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, and attaches a Runtime port.

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) {
@@ -16,7 +17,7 @@ export function createHouseBridgeTestHost(options = {}) {
     const listeners = new Set();
     const queued = [];
     let started = false;
-    let address = sameOriginPath(options.address ?? '/') ?? '/';
+    let address = appAddressOf('/', options.address ?? '/');
     function deliver(data, ports = []) {
         const event = { data, ports };
         if (!started) {
@@ -108,9 +109,7 @@ export function createHouseBridgeTestHost(options = {}) {
             return address;
         },
         open(asked) {
-            const target = sameOriginPath(asked);
-            if (target !== null)
-                arrive(target, false);
+            arrive(appAddressOf('/', asked), false);
         },
         publish(status) {
             deliver({ house: 'status', status });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "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}` || '/';
+}