@volter/world-runtime 3.0.18 → 3.0.20

package/dist/src/served-world.d.ts

@@ -375,6 +375,17 @@ export declare class WorldDoors {
         vendor: string;
         hosts: string[];
     }>>;
+    /** What a twin asks an application (`ctx.ask`) that this World can answer truthfully, where no process routes it (a
+     *  hosted World's isolate): a GET or HEAD of a URL whose hostname one of this World's twins answers (its hostsClaimed
+     *  door: a Cloudflare twin's Worker route or custom domain) is that twin's answer, read as a browser reads the site
+     *  here (`site`). Any other question (another method, a hostname no twin claims) is undefined: it goes on as it would
+     *  without this router (the application route, the World's egress rule, the network), never a World-made answer
+     *  dressed as the application's (architecture, "What an author writes, and how"). Given to each twin's fetch as its
+     *  `application` by apps/cloud. */
+    askInWorld(target: string, init: RequestInit): Promise<{
+        status: number;
+        body: string;
+    } | undefined>;
     /** A hostname one of this World's twins answers (its hostsClaimed door lists it), read as a browser reads it there:
      *  the request goes to that twin with the hostname as its original host, as the injector routes it inside the World.
      *  Reads only: the site is the twin's state as the World holds it, never a way to write it. */

package/dist/src/served-world.js

@@ -1038,6 +1038,33 @@ export class WorldDoors {
         }
         return out;
     }
+    /** What a twin asks an application (`ctx.ask`) that this World can answer truthfully, where no process routes it (a
+     *  hosted World's isolate): a GET or HEAD of a URL whose hostname one of this World's twins answers (its hostsClaimed
+     *  door: a Cloudflare twin's Worker route or custom domain) is that twin's answer, read as a browser reads the site
+     *  here (`site`). Any other question (another method, a hostname no twin claims) is undefined: it goes on as it would
+     *  without this router (the application route, the World's egress rule, the network), never a World-made answer
+     *  dressed as the application's (architecture, "What an author writes, and how"). Given to each twin's fetch as its
+     *  `application` by apps/cloud. */
+    async askInWorld(target, init) {
+        const method = (init.method ?? 'GET').toUpperCase();
+        if (method !== 'GET' && method !== 'HEAD')
+            return undefined;
+        let url;
+        try {
+            url = new URL(target);
+        }
+        catch {
+            return undefined;
+        }
+        if (url.protocol !== 'https:' && url.protocol !== 'http:')
+            return undefined;
+        const host = url.hostname.toLowerCase().replace(/\.$/, '');
+        const claimed = await this.claimedHosts(url.origin);
+        if (!claimed.some(({ hosts }) => hosts.includes(host)))
+            return undefined;
+        const answer = await this.site(new Request(url, { method, headers: init.headers ?? {} }), host);
+        return { status: answer.status, body: await answer.text() };
+    }
     /** A hostname one of this World's twins answers (its hostsClaimed door lists it), read as a browser reads it there:
      *  the request goes to that twin with the hostname as its original host, as the injector routes it inside the World.
      *  Reads only: the site is the twin's state as the World holds it, never a way to write it. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "3.0.18",
+  "version": "3.0.20",
   "description": "World configs for twins: boot named local runtimes, allocate ports, generate world.env/instance.json, and run apps against fake-key twin worlds.",
   "keywords": [
     "twin",
@@ -68,14 +68,14 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.18",
-    "@volter/world-console": "3.0.13"
+    "@volter/world-core": "3.0.20",
+    "@volter/world-console": "3.0.15"
   },
   "dependencies": {
     "@electric-sql/pglite": "0.5.8",
     "@electric-sql/pglite-pgvector": "0.0.9",
     "@volter/world-access": "3.0.1",
-    "@volter/world-core": "3.0.18",
+    "@volter/world-core": "3.0.20",
     "pg-gateway": "0.3.0-beta.4",
     "smol-toml": "^1.8.0",
     "yaml": "2.9.0"

package/src/served-world.ts

@@ -940,6 +940,26 @@ export class WorldDoors {
     return out;
   }
 
+  /** What a twin asks an application (`ctx.ask`) that this World can answer truthfully, where no process routes it (a
+   *  hosted World's isolate): a GET or HEAD of a URL whose hostname one of this World's twins answers (its hostsClaimed
+   *  door: a Cloudflare twin's Worker route or custom domain) is that twin's answer, read as a browser reads the site
+   *  here (`site`). Any other question (another method, a hostname no twin claims) is undefined: it goes on as it would
+   *  without this router (the application route, the World's egress rule, the network), never a World-made answer
+   *  dressed as the application's (architecture, "What an author writes, and how"). Given to each twin's fetch as its
+   *  `application` by apps/cloud. */
+  async askInWorld(target: string, init: RequestInit): Promise<{ status: number; body: string } | undefined> {
+    const method = (init.method ?? 'GET').toUpperCase();
+    if (method !== 'GET' && method !== 'HEAD') return undefined;
+    let url: URL;
+    try { url = new URL(target); } catch { return undefined; }
+    if (url.protocol !== 'https:' && url.protocol !== 'http:') return undefined;
+    const host = url.hostname.toLowerCase().replace(/\.$/, '');
+    const claimed = await this.claimedHosts(url.origin);
+    if (!claimed.some(({ hosts }) => hosts.includes(host))) return undefined;
+    const answer = await this.site(new Request(url, { method, headers: init.headers ?? {} }), host);
+    return { status: answer.status, body: await answer.text() };
+  }
+
   /** A hostname one of this World's twins answers (its hostsClaimed door lists it), read as a browser reads it there:
    *  the request goes to that twin with the hostname as its original host, as the injector routes it inside the World.
    *  Reads only: the site is the twin's state as the World holds it, never a way to write it. */