improve Port and readme in example

Author: scammo

examples/adonisjs/.env.example

@@ -3,7 +3,10 @@ NODE_ENV=development
 PORT=3333
 HOST=localhost
 LOG_LEVEL=debug
-PUBLIC_URL=http://localhost:3333
+# The address remote servers reach this app at, e.g. a "fedify tunnel" URL.
+# Leave it unset for local development: the origin then follows whatever
+# port the server actually binds.
+#PUBLIC_URL=https://example.pinggy.link
 # A throwaway key so that "cp .env.example .env" boots. Generate your own
 # with "node ace generate:key" before deploying anything real.
 APP_KEY=exampleAppKeyReplaceMeBeforeUse32

examples/adonisjs/README.md

@@ -46,9 +46,11 @@ Running the example
 
     The application listens on <http://localhost:3333> and the actor is `demo`.
 
-    > [!IMPORTANT]
+    > [!NOTE]
     > `node ace serve` falls back to a free random port when 3333 is already
-    > taken, and it prints the address it settled on.
+    > taken, and it prints the address it settled on.  Use that port in the
+    > commands below; with `PUBLIC_URL` unset the actor URIs follow it
+    > automatically.
 
 3.  Open _http://localhost:3333/_. Browsers asking for HTML at
     _http://localhost:3333/users/demo_ get the profile page:
@@ -64,6 +66,13 @@ Running the example
       http://localhost:3333/users/demo | jq
     ~~~~
 
+    The [Fedify CLI] can look the actor up the same way, and `-a` signs the
+    request the way a remote server would:
+
+    ~~~~ sh
+    pnpx @fedify/cli lookup http://localhost:3333/users/demo -a
+    ~~~~
+
 4.  Localhost is not reachable from other servers, so to actually exchange
     activities you need a public address. The [Fedify CLI] provides one:
 

examples/adonisjs/config/fedify.ts

@@ -9,8 +9,14 @@ export default defineConfig({
   |
   | Fedify mints actor URIs, activity IDs and collection URLs from this
   | value, so it has to be the address remote servers can reach, not the
-  | address Node happens to be listening on.
+  | address Node happens to be listening on.  Set PUBLIC_URL to the tunnel
+  | or deployment address for that.
+  |
+  | Without PUBLIC_URL the origin follows the port the server actually
+  | bound: "node ace serve" picks a free one when PORT is taken and passes
+  | it to the app, so local lookups keep working after such a fallback.
   |
   */
-  origin: env.get("PUBLIC_URL"),
+  origin: env.get("PUBLIC_URL") ??
+    `http://${env.get("HOST")}:${env.get("PORT")}`,
 });

examples/adonisjs/start/env.ts

@@ -23,5 +23,5 @@ export default await Env.create(new URL("../", import.meta.url), {
   | Variables for configuring Fedify
   |----------------------------------------------------------
   */
-  PUBLIC_URL: Env.schema.string({ format: "url", tld: false }),
+  PUBLIC_URL: Env.schema.string.optional({ format: "url", tld: false }),
 });

packages/adonisjs/README.md

@@ -35,7 +35,7 @@ Requirements
 ------------
 
  -  AdonisJS 7.0 or later
- -  Fedify 2.3.4 or later
+ -  Fedify 2.4.0 or later
  -  Node.js 24 or later — and Node.js only; see below
 
 The package ships both ESM and CommonJS builds.  The CommonJS one works because