@simon-says-build/harbormaster 0.14.0 → 0.14.2

package/README.md

@@ -155,6 +155,25 @@ env, under the caller's explicit `--fn-env`. `exec`: on top of the caller's
 ambient env, so a key exported in some shell can't leak into the suite.
 `python3 test/project_env.py`.
 
+## A function env value can name a leased port (0.14.2)
+
+`--fn-env KEY={port:firestore}`, or the same in `harbormaster.env`, becomes
+this lease's firestore port, inside a value too (`127.0.0.1:{port:auth}`). A
+caller can't know its ports before the lease, and an app whose functions read
+their own variable for the emulator (Tapuat's `EMULATOR_PORT_FIRESTORE ||
+"8080"`) otherwise talks to whatever holds the default. An unknown service is
+left as written. `python3 test/port_env.py`.
+
+## A lease never reads the hosting config it doesn't start (0.14.1)
+
+A lease whose `--only` leaves hosting out boots from a config with no
+`hosting` block. firebase-tools 15.33 reads `hosting` even when it starts no
+hosting emulator, and a web-framework target (`"source": "."`, Next.js)
+makes it refuse every emulator without the `webframeworks` experiment.
+Tapuat's lease on simon-linux-1 died there on 2026-10-21; 15.28 on the
+studio never checked. An `--only` that asks for hosting, or no `--only`,
+keeps it. `python3 test/injected_config.py`.
+
 ## An idle simulator nobody leases is shut down (0.13.0)
 
 The world sweep (every `FBPORTS_SWEEP_INTERVAL`, 5 min) now shuts down a

package/harbormaster

@@ -84,7 +84,7 @@ import uuid
 from datetime import datetime, timezone
 from pathlib import Path
 
-VERSION = "0.14.0"
+VERSION = "0.14.2"
 
 # Overridable for tests / parallel installs; default is the shared user daemon.
 # The dir keeps the old "firebase-ports" name: pre-rename binaries still installed
@@ -361,11 +361,35 @@ def _service_ports(ports):
     return {s: p for s, p in ports.items() if s not in ("ui", "hub", "logging")}
 
 
-def _write_injected_config(cwd, ports):
+# A value that names a LEASED port: `{port:firestore}` becomes this lease's
+# firestore port. The caller cannot know its ports before the lease, and an
+# app whose functions read their own variable for the emulator (Tapuat's
+# admin.ts: `127.0.0.1:${EMULATOR_PORT_FIRESTORE || "8080"}`, unconditionally)
+# otherwise talks to whatever holds the default — on simon-linux-1, nothing;
+# every callable 500'd (run 20261021-131438-exploration-everyday-user). An
+# unknown service is left as written, so a typo shows in the app's own error.
+_PORT_REF = re.compile(r"\{port:([a-z_]+)\}")
+
+def _with_ports(env, ports):
+    return {k: _PORT_REF.sub(lambda m: str(ports[m.group(1)]) if m.group(1) in ports else m.group(0), v)
+            for k, v in env.items()}
+
+
+def _write_injected_config(cwd, ports, only=None):
     """Set ports on the emulators the portless firebase.json DECLARES (+ hub/logging).
-    Never adds emulators the project doesn't use. Returns the temp config basename."""
+    Never adds emulators the project doesn't use. Returns the temp config basename.
+
+    With an --only that leaves hosting out, the `hosting` block goes too: no
+    emulator a lease starts serves it, and firebase-tools still READS it. A
+    web-framework target (`"source": "."`, a Next.js app) makes 15.33 refuse to
+    start ANY emulator without the webframeworks experiment — Tapuat's run
+    20261021-130009-exploration-everyday-user died there on simon-linux-1 while
+    15.28 on the studio never checked."""
     cfg = json.loads((Path(cwd) / "firebase.json").read_text())
     emu = cfg.setdefault("emulators", {})
+    if only and "hosting" not in only:
+        cfg.pop("hosting", None)
+        emu.pop("hosting", None)
     for svc in [k for k in emu if k != "singleProjectMode"]:
         if svc in ports and isinstance(emu[svc], dict):
             emu[svc]["port"] = ports[svc]
@@ -775,7 +799,7 @@ class Broker:
 
     def _boot(self, cwd, block, only, project_id, label, on_spawn=None, extra_env=None):
         all_ports = _block_ports(block)
-        tmp = _write_injected_config(cwd, all_ports)
+        tmp = _write_injected_config(cwd, all_ports, only)
         # Readiness/liveness track ONLY the data services actually started (respect
         # --only, else the project's declared emulators; skip ui/hub/logging) — else
         # we'd wait forever for ports (functions, pubsub, …) that never open.
@@ -804,9 +828,9 @@ class Broker:
         # daemon's env — the functions emulator runtime inherits it, which is
         # the only way a CALLER can set per-suite env (e.g. LLM_CACHE_DIR)
         # when the daemon, not the caller, spawns the emulator.
-        spawn_env = {**os.environ, **project_env(cwd), "TMPDIR": str(suite_tmp)}
+        spawn_env = {**os.environ, **_with_ports(project_env(cwd), all_ports), "TMPDIR": str(suite_tmp)}
         if extra_env:
-            spawn_env.update({str(k): str(v) for k, v in dict(extra_env).items()})
+            spawn_env.update(_with_ports({str(k): str(v) for k, v in dict(extra_env).items()}, all_ports))
         with open(log, "w") as lf:
             proc = subprocess.Popen(cmd, cwd=cwd, stdout=lf, stderr=subprocess.STDOUT, start_new_session=True, env=spawn_env)
         if on_spawn:
@@ -1841,7 +1865,7 @@ def main():
         me = os.getpid()                      # this process owns the reservation for the run
         res = ok(_call("POST", "/allocate", {"owner_pid": me, "owner_start": _proc_start(me), "label": "exec"}), "exec")
         base, lid = res["base"], res["leaseId"]
-        tmp = _write_injected_config(cwd, _block_ports(base))
+        tmp = _write_injected_config(cwd, _block_ports(base), only)
         try:
             run = ["firebase", "emulators:exec", "--config", tmp]
             if only:
@@ -1850,7 +1874,7 @@ def main():
             # The project's env beats the caller's AMBIENT env here: a key
             # exported in some shell for a one-off script is exactly what
             # harbormaster.env exists to keep out of the suite (project_env).
-            rc = subprocess.call(run, cwd=cwd, env={**os.environ, **project_env(cwd)})
+            rc = subprocess.call(run, cwd=cwd, env={**os.environ, **_with_ports(project_env(cwd), _block_ports(base))})
         finally:
             try:
                 _call("POST", "/release", {"leaseId": lid})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simon-says-build/harbormaster",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "A localhost daemon that leases each caller its own port block — isolated Firebase emulator sandboxes, Metro/Expo ports, private iOS simulators — reaped when the caller exits. No port collisions, no shared instances, no pkill.",
   "bin": {
     "harbormaster": "harbormaster",