Surface runtime inference source in debug logs

Adds getCloudflareWorkersOverride() to common/runtime.ts and logs the
runtime decision in init() when a Workers context is present, e.g.
`[CH] Cloudflare Workers runtime: true (via override)` vs `(via
navigator inference)`. Helps integrators confirm at a glance which
signal drove the transport decision.

Bumps to 2.4.2.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: luke-owen-crowdhandler

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "crowdhandler-sdk",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "",
   "homepage": "https://www.crowdhandler.com",
   "repository": {

package.json

@@ -21,6 +21,10 @@ export function setCloudflareWorkersOverride(value: boolean | null): void {
   cloudflareWorkersOverride = value;
 }
 
+export function getCloudflareWorkersOverride(): boolean | null {
+  return cloudflareWorkersOverride;
+}
+
 export function isCloudflareWorkers(): boolean {
   if (cloudflareWorkersOverride !== null) return cloudflareWorkersOverride;
   return detectCloudflareWorkers();

src/common/runtime.ts

@@ -4,7 +4,12 @@ import { RequestContext } from "./request/requestContext";
 import { Gatekeeper } from "./gatekeeper/gatekeeper";
 import { GatekeeperOptions, Mode, Modes } from "./common/types";
 import { CrowdHandlerError, createError, ErrorCodes } from "./common/errors";
-import { setCloudflareWorkersOverride } from "./common/runtime";
+import {
+  getCloudflareWorkersOverride,
+  isCloudflareWorkers,
+  setCloudflareWorkersOverride,
+} from "./common/runtime";
+import { logger } from "./common/logger";
 
 /**
  * Configuration options for initializing CrowdHandler
@@ -191,6 +196,18 @@ export function init(config: InitConfig): InitResult {
     setCloudflareWorkersOverride(true);
   }
 
+  // When a Workers context is provided, surface which signal drove the runtime
+  // decision so debug logs can distinguish forced overrides from navigator
+  // inference. Only emitted in debug mode.
+  if (config.cloudflareWorkersRequest) {
+    const source = getCloudflareWorkersOverride() !== null ? "override" : "navigator inference";
+    logger(
+      !!config.options?.debug,
+      "info",
+      `[CH] Cloudflare Workers runtime: ${isCloudflareWorkers()} (via ${source})`
+    );
+  }
+
   // Create unified client
   const client = new Client({
     publicKey: config.publicKey,