@camstack/sdk 1.2.122 → 1.2.123

package/dist/index.cjs

@@ -878,8 +878,9 @@ var System = class {
 	*   1. Query `localNetwork.getConnectionEndpoints({ port })` over the
 	*      already-authenticated tRPC channel — the cap is auth-gated,
 	*      so the LAN IPs never leak to anonymous callers.
-	*   2. For each candidate, fire a HEAD on `{baseUrl}/trpc/health`
-	*      with a short timeout (default 1500ms). The first 2xx wins.
+	*   2. For each candidate, fire a GET on `{baseUrl}/health` (the
+	*      auth-free liveness route) with a short timeout (default 1500ms).
+	*      The first 2xx wins.
 	*   3. If the winner differs from `this.serverUrl`, call
 	*      `switchServerUrl(winner)` and return it. Otherwise return
 	*      the current URL unchanged.
@@ -1357,7 +1358,7 @@ function createSystem(config) {
 }
 /**
 * Race a list of candidate base URLs and return the first one that
-* responds to `GET {baseUrl}/trpc/health` with a 2xx within
+* responds to `GET {baseUrl}/health` with a 2xx within
 * `timeoutMs`. Returns `null` if every candidate fails / times out.
 *
 * Implementation notes:
@@ -1365,10 +1366,12 @@ function createSystem(config) {
 *     stalled candidate doesn't pin the wallclock for the whole race.
 *   - Cancels every still-pending probe as soon as the first one
 *     succeeds — no wasted bandwidth on the loser candidates.
-*   - `/trpc/health` is the only endpoint guaranteed to respond on every
-*     CamStack deployment (registered alongside the tRPC plugin). It is
-*     intentionally NOT auth-gated since it's used by load balancers /
-*     uptime probes — same surface every reverse proxy already monitors.
+*   - `/health` is the hub's auth-free liveness route (`{"ok":true}`),
+*     the one load balancers and uptime probes already watch. NOT
+*     `/trpc/health`: under `/trpc/*` the tRPC plugin resolves `health` as
+*     a procedure name and answers 404 on a HEALTHY hub (the fastify route
+*     of that name exists only on the degraded branch taken when tRPC fails
+*     to register), so every race over it rejected and fell back.
 *   - HEAD would be nicer but Cloudflare Tunnel + some browsers
 *     mishandle HEAD on the ingress path; GET is safer.
 *
@@ -1385,7 +1388,7 @@ async function raceFastestEndpoint(candidates, timeoutMs) {
 		const ctrl = controllers[i];
 		const timer = setTimeout(() => ctrl.abort(), timeoutMs);
 		try {
-			const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/trpc/health`, {
+			const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/health`, {
 				method: "GET",
 				signal: ctrl.signal,
 				credentials: "omit"

package/dist/index.js

@@ -877,8 +877,9 @@ var System = class {
 	*   1. Query `localNetwork.getConnectionEndpoints({ port })` over the
 	*      already-authenticated tRPC channel — the cap is auth-gated,
 	*      so the LAN IPs never leak to anonymous callers.
-	*   2. For each candidate, fire a HEAD on `{baseUrl}/trpc/health`
-	*      with a short timeout (default 1500ms). The first 2xx wins.
+	*   2. For each candidate, fire a GET on `{baseUrl}/health` (the
+	*      auth-free liveness route) with a short timeout (default 1500ms).
+	*      The first 2xx wins.
 	*   3. If the winner differs from `this.serverUrl`, call
 	*      `switchServerUrl(winner)` and return it. Otherwise return
 	*      the current URL unchanged.
@@ -1356,7 +1357,7 @@ function createSystem(config) {
 }
 /**
 * Race a list of candidate base URLs and return the first one that
-* responds to `GET {baseUrl}/trpc/health` with a 2xx within
+* responds to `GET {baseUrl}/health` with a 2xx within
 * `timeoutMs`. Returns `null` if every candidate fails / times out.
 *
 * Implementation notes:
@@ -1364,10 +1365,12 @@ function createSystem(config) {
 *     stalled candidate doesn't pin the wallclock for the whole race.
 *   - Cancels every still-pending probe as soon as the first one
 *     succeeds — no wasted bandwidth on the loser candidates.
-*   - `/trpc/health` is the only endpoint guaranteed to respond on every
-*     CamStack deployment (registered alongside the tRPC plugin). It is
-*     intentionally NOT auth-gated since it's used by load balancers /
-*     uptime probes — same surface every reverse proxy already monitors.
+*   - `/health` is the hub's auth-free liveness route (`{"ok":true}`),
+*     the one load balancers and uptime probes already watch. NOT
+*     `/trpc/health`: under `/trpc/*` the tRPC plugin resolves `health` as
+*     a procedure name and answers 404 on a HEALTHY hub (the fastify route
+*     of that name exists only on the degraded branch taken when tRPC fails
+*     to register), so every race over it rejected and fell back.
 *   - HEAD would be nicer but Cloudflare Tunnel + some browsers
 *     mishandle HEAD on the ingress path; GET is safer.
 *
@@ -1384,7 +1387,7 @@ async function raceFastestEndpoint(candidates, timeoutMs) {
 		const ctrl = controllers[i];
 		const timer = setTimeout(() => ctrl.abort(), timeoutMs);
 		try {
-			const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/trpc/health`, {
+			const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/health`, {
 				method: "GET",
 				signal: ctrl.signal,
 				credentials: "omit"

package/dist/system.d.ts

@@ -184,8 +184,9 @@ export declare class System {
      *   1. Query `localNetwork.getConnectionEndpoints({ port })` over the
      *      already-authenticated tRPC channel — the cap is auth-gated,
      *      so the LAN IPs never leak to anonymous callers.
-     *   2. For each candidate, fire a HEAD on `{baseUrl}/trpc/health`
-     *      with a short timeout (default 1500ms). The first 2xx wins.
+     *   2. For each candidate, fire a GET on `{baseUrl}/health` (the
+     *      auth-free liveness route) with a short timeout (default 1500ms).
+     *      The first 2xx wins.
      *   3. If the winner differs from `this.serverUrl`, call
      *      `switchServerUrl(winner)` and return it. Otherwise return
      *      the current URL unchanged.
@@ -431,7 +432,7 @@ export declare class System {
 export declare function createSystem(config: SystemConfig): System;
 /**
  * Race a list of candidate base URLs and return the first one that
- * responds to `GET {baseUrl}/trpc/health` with a 2xx within
+ * responds to `GET {baseUrl}/health` with a 2xx within
  * `timeoutMs`. Returns `null` if every candidate fails / times out.
  *
  * Implementation notes:
@@ -439,10 +440,12 @@ export declare function createSystem(config: SystemConfig): System;
  *     stalled candidate doesn't pin the wallclock for the whole race.
  *   - Cancels every still-pending probe as soon as the first one
  *     succeeds — no wasted bandwidth on the loser candidates.
- *   - `/trpc/health` is the only endpoint guaranteed to respond on every
- *     CamStack deployment (registered alongside the tRPC plugin). It is
- *     intentionally NOT auth-gated since it's used by load balancers /
- *     uptime probes — same surface every reverse proxy already monitors.
+ *   - `/health` is the hub's auth-free liveness route (`{"ok":true}`),
+ *     the one load balancers and uptime probes already watch. NOT
+ *     `/trpc/health`: under `/trpc/*` the tRPC plugin resolves `health` as
+ *     a procedure name and answers 404 on a HEALTHY hub (the fastify route
+ *     of that name exists only on the degraded branch taken when tRPC fails
+ *     to register), so every race over it rejected and fell back.
  *   - HEAD would be nicer but Cloudflare Tunnel + some browsers
  *     mishandle HEAD on the ingress path; GET is safer.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/sdk",
-  "version": "1.2.122",
+  "version": "1.2.123",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",