@fuzdev/fuz_app 0.134.0 → 0.136.0

package/dist/testing/transports/ws_transport.d.ts

@@ -17,9 +17,11 @@ export interface WsTransportOptions {
      * Origin header for the upgrade. Backends running with
      * `ALLOWED_ORIGINS=http://localhost:*` accept `http://localhost:<port>`.
      * Defaults to `base_url` — acceptable because cross-process tests
-     * always run against `localhost`.
+     * always run against `localhost`. `null` sends no `Origin` at all, which a
+     * daemon-token upgrade needs: both spines discard a daemon token (and a
+     * bearer token) presented in a browser context.
      */
-    readonly origin?: string;
+    readonly origin?: string | null;
     /**
      * Optional per-call default for `wait_for` timeouts. Falls back to
      * `WS_CLIENT_DEFAULT_TIMEOUT_MS` if omitted.

package/dist/testing/transports/ws_transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws_transport.d.ts","sourceRoot":"../src/lib/","sources":["../../../src/lib/testing/transports/ws_transport.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAuB9B,OAAO,EAMN,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,MAAM,gBAAgB,CAAC;AAIxB,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IAClC,gHAAgH;IAChH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mBAAmB,GAAU,SAAS,kBAAkB,KAAG,OAAO,CAAC,QAAQ,CAwJvF,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,4BAA4B,GACxC,SAAS,kBAAkB,KACzB,OAAO,CAAC,QAAQ,CASlB,CAAC"}
+{"version":3,"file":"ws_transport.d.ts","sourceRoot":"../src/lib/","sources":["../../../src/lib/testing/transports/ws_transport.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAuB9B,OAAO,EAMN,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,MAAM,gBAAgB,CAAC;AAIxB,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IAClC,gHAAgH;IAChH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mBAAmB,GAAU,SAAS,kBAAkB,KAAG,OAAO,CAAC,QAAQ,CAyJvF,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,4BAA4B,GACxC,SAAS,kBAAkB,KACzB,OAAO,CAAC,QAAQ,CASlB,CAAC"}

package/dist/testing/transports/ws_transport.js

@@ -50,7 +50,8 @@ export const create_ws_transport = async (options) => {
         headers.Cookie = cookies.join('; ');
     const socket = new WebSocket(ws_url, {
         headers,
-        origin: origin ?? base_url
+        // `ws` sends no `Origin` header when the option is undefined
+        origin: origin === null ? undefined : (origin ?? base_url)
     });
     const received = [];
     const waiters = [];

package/dist/testing/ws_round_trip.d.ts

@@ -48,9 +48,29 @@ import { BackendWebsocketTransport } from '../actions/transports_ws_backend.js';
 import { type RequestContext } from '../auth/request_context.js';
 import { type CredentialType } from '../hono_context.js';
 import { type WsClient, type WsRequestResponder } from './transports/ws_client.js';
+/**
+ * The runtime socket behind a `FakeWs` — what `WSContext.raw` exposes, shaped
+ * like Node's `ws`: a `bufferedAmount` the outbound writer reads for
+ * backpressure, and a `terminate` it cuts a stalled socket with.
+ */
+export interface FakeWsSocket {
+    /**
+     * Bytes "handed to the socket and not yet written". Grows by each sent
+     * frame's UTF-8 length while `stalled`; set it (e.g. to `0`) to model the
+     * client reading.
+     */
+    bufferedAmount: number;
+    /** While `true`, sent frames stay in `bufferedAmount` — a client that is not reading. */
+    stalled: boolean;
+    /** Whether `terminate` was called — the socket was cut with no close frame. */
+    terminated: boolean;
+    /** Cut the socket. Records `terminated` and empties `bufferedAmount`. */
+    terminate: () => void;
+}
 /**
  * A `WSContext` paired with capture arrays. Use `sends` to assert on
- * outgoing frames; use `closes` to assert on revocation / close.
+ * outgoing frames; use `closes` to assert on revocation / close; use
+ * `socket` to model a client that stopped reading and to assert on a cut.
  */
 export interface FakeWs {
     ws: WSContext;
@@ -59,13 +79,23 @@ export interface FakeWs {
         code?: number;
         reason?: string;
     }>;
+    /** The fake runtime socket (`ws.raw`). */
+    socket: FakeWsSocket;
+}
+/** Options for `create_fake_ws`. */
+export interface CreateFakeWsOptions {
+    /** Start with the client not reading (`FakeWsSocket.stalled`). */
+    stalled?: boolean;
 }
 /**
  * Build a real `WSContext` backed by in-memory `send`/`close` capture.
  * Parsing of outgoing frames is left to the caller — `sends` holds the
  * raw strings as the dispatcher wrote them.
+ *
+ * `readyState` reads `1` (open) until the socket is closed (`2`) or
+ * terminated (`3`).
  */
-export declare const create_fake_ws: () => FakeWs;
+export declare const create_fake_ws: (options?: CreateFakeWsOptions) => FakeWs;
 /** Options for `create_fake_hono_context`. */
 export interface FakeHonoContextOptions {
     credential_type: CredentialType;

package/dist/testing/ws_round_trip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws_round_trip.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/ws_round_trip.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ws_round_trip.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/ws_round_trip.ts"],"names":[],"mappings":"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"}

package/dist/testing/ws_round_trip.js

@@ -11,24 +11,46 @@ import { ACCOUNT_ID_KEY, AUTH_API_TOKEN_ID_KEY, CREDENTIAL_TYPE_KEY, TEST_CONTEX
 import { create_jsonrpc_request } from '../http/jsonrpc_helpers.js';
 import { create_test_account, create_test_actor, create_test_role_grant } from './entities.js';
 import { WS_CLIENT_DEFAULT_TIMEOUT_MS, deliver_inbound, is_response_for } from './transports/ws_client.js';
+const fake_ws_text_encoder = new TextEncoder();
 /**
  * Build a real `WSContext` backed by in-memory `send`/`close` capture.
  * Parsing of outgoing frames is left to the caller — `sends` holds the
  * raw strings as the dispatcher wrote them.
+ *
+ * `readyState` reads `1` (open) until the socket is closed (`2`) or
+ * terminated (`3`).
  */
-export const create_fake_ws = () => {
+export const create_fake_ws = (options) => {
     const sends = [];
     const closes = [];
+    const socket = {
+        bufferedAmount: 0,
+        stalled: options?.stalled ?? false,
+        terminated: false,
+        terminate: () => {
+            socket.terminated = true;
+            socket.bufferedAmount = 0;
+        }
+    };
     const init = {
         send: (data) => {
-            sends.push(typeof data === 'string' ? data : '<binary>');
+            const text = typeof data === 'string' ? data : '<binary>';
+            sends.push(text);
+            if (socket.stalled)
+                socket.bufferedAmount += fake_ws_text_encoder.encode(text).byteLength;
         },
         close: (code, reason) => {
             closes.push({ code, reason });
+            // a close frame is a few bytes behind whatever is still unwritten
+            if (socket.stalled)
+                socket.bufferedAmount += 2;
         },
-        readyState: 1
+        raw: socket,
+        get readyState() {
+            return socket.terminated ? 3 : closes.length > 0 ? 2 : 1;
+        }
     };
-    return { ws: new WSContext(init), sends, closes };
+    return { ws: new WSContext(init), sends, closes, socket };
 };
 /**
  * Build a fake Hono `Context` exposing the auth keys the dispatcher

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.134.0",
+  "version": "0.136.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",

package/dist/env/resolve.d.ts

@@ -1,163 +0,0 @@
-/**
- * Environment variable `$$VAR$$` resolution suite.
- *
- * Resolves `$$VAR$$` references in strings and object trees,
- * scans configs for references, and validates/formats missing vars.
- *
- * The double-dollar bookending syntax is:
- * - Visually distinct from shell `$VAR` syntax
- * - Unambiguous about variable boundaries
- * - Easy to grep: `grep '\$\$'`
- * - Fails loud if accidentally shell-processed (`$$`=PID in shell)
- *
- * # Syntax
- *
- * - `$$VAR$$` — required reference. Missing or empty fails validation
- *   (see `validate_env_vars`).
- * - `$$?VAR$$` — optional reference. Missing or empty resolves to the
- *   empty string and passes validation. Use for vars that exist in the
- *   contract but may be intentionally blank (e.g. `SMTP_PASSWORD=` on
- *   a deployment that hasn't configured SMTP yet).
- * - `\$$VAR$$` — escape. The leading backslash is dropped at resolution
- *   time and the rest is emitted literally. Use this when documenting
- *   the syntax inside a string literal (comments in env-file templates,
- *   for example) where a regex scan would otherwise treat the mention
- *   as a real reference. Combines with `?` as `\$$?VAR$$`.
- *
- * @module
- */
-import type { EnvDeps } from '../runtime/deps.js';
-/**
- * Resolve environment variable references in a string.
- *
- * - `$$VAR$$` resolves from the runtime env; missing values are left as-is
- *   for the validation phase to report.
- * - `$$?VAR$$` is the optional form — missing or empty resolves to the empty
- *   string. Required validation skips refs marked optional.
- * - `\$$VAR$$` / `\$$?VAR$$` are escapes — the leading backslash is dropped
- *   and the body is emitted literally (no resolution attempted).
- *
- * @param runtime - runtime with `env_get` capability
- * @param value - string that may contain `$$VAR$$` references
- * @returns string with env vars resolved
- */
-export declare const resolve_env_vars: (runtime: Pick<EnvDeps, "env_get">, value: string) => string;
-/**
- * Check if a string contains unresolved env var references.
- *
- * Escaped references (`\$$VAR$$`) do not count — they're literal text once
- * resolved.
- *
- * @param value - string to check
- * @returns `true` if string contains unescaped `$$VAR$$` patterns
- */
-export declare const has_env_vars: (value: string) => boolean;
-/**
- * Get list of env var names referenced in a string.
- *
- * Escaped references are skipped; optional and required references are both
- * included (callers that care about the distinction should use `scan_env_vars`
- * which preserves the `optional` flag per ref).
- *
- * @param value - string to scan
- * @returns array of variable names (without `$$` delimiters)
- */
-export declare const get_env_var_names: (value: string) => Array<string>;
-/**
- * Resolve env vars in an object's string values (shallow).
- *
- * @param runtime - runtime with `env_get` capability
- * @param obj - object with string values
- * @returns new object with env vars resolved
- */
-export declare const resolve_env_vars_in_object: <T extends Record<string, unknown>>(runtime: Pick<EnvDeps, "env_get">, obj: T) => T;
-/**
- * Resolve env vars and throw if any are missing/empty.
- *
- * Use this for values that must be present. `$$?VAR$$` (optional) refs
- * resolve to the empty string on miss without contributing to the error.
- * Escaped references (`\$$VAR$$`) emit literally and never check the env.
- *
- * @param runtime - runtime with `env_get` capability
- * @param value - string with `$$VAR$$` references
- * @param context - description for error message (e.g., `"target.host"`)
- * @returns resolved string
- * @throws Error if any referenced env var is missing or empty
- */
-export declare const resolve_env_vars_required: (runtime: Pick<EnvDeps, "env_get">, value: string, context: string) => string;
-/**
- * An env var reference found in a config.
- */
-export interface EnvVarRef {
-    /** Variable name (without `$$` delimiters). */
-    name: string;
-    /** Path where the reference was found (e.g., `"target.host"`, `"resources[3].path"`). */
-    path: string;
-    /**
-     * Whether the reference is optional (`$$?VAR$$`). Optional refs resolve
-     * to the empty string when unset and are skipped by `validate_env_vars` —
-     * a var that's intentionally blank doesn't count as missing.
-     */
-    optional: boolean;
-}
-/**
- * Recursively scan an object for `$$VAR$$` env var references.
- *
- * Walks all string values in the object tree and extracts env var names
- * with their path context for error reporting. Escaped references
- * (`\$$VAR$$`) are skipped — they're literal text, not references.
- * The `optional` flag on each ref distinguishes `$$VAR$$` (required) from
- * `$$?VAR$$` (optional) for downstream validation.
- *
- * @param obj - object to scan (typically a config)
- * @returns array of env var references with paths and optional flags
- */
-export declare const scan_env_vars: (obj: unknown) => Array<EnvVarRef>;
-/**
- * Result of env var validation.
- *
- * Uses discriminated union for better type narrowing:
- * - `ok: true, missing: null` — all vars present
- * - `ok: false, missing: EnvVarRef[]` — some vars missing
- */
-export type EnvValidationResult = {
-    ok: true;
-    missing: null;
-} | {
-    ok: false;
-    missing: Array<EnvVarRef>;
-};
-/**
- * Validate that all referenced env vars exist in the environment.
- *
- * Returns all missing refs (including duplicates by name). Grouping
- * and deduplication is handled by `format_missing_env_vars` at display time.
- * Refs marked `optional: true` (from `$$?VAR$$` syntax) are skipped — a
- * deliberately-blank var is contract, not a missing dependency.
- *
- * @param runtime - runtime with `env_get` capability
- * @param refs - env var references from `scan_env_vars`
- * @returns validation result with any missing vars
- */
-export declare const validate_env_vars: (runtime: Pick<EnvDeps, "env_get">, refs: Array<EnvVarRef>) => EnvValidationResult;
-/**
- * Options for `format_missing_env_vars`.
- */
-export interface FormatMissingEnvVarsOptions {
-    /** Path to env file if one was loaded. */
-    env_file?: string;
-    /** Hint text for how to set up the environment. */
-    setup_hint?: string;
-}
-/**
- * Format missing env vars error message.
- *
- * Groups refs by variable name so each missing var is shown once
- * with all paths where it's referenced.
- *
- * @param missing - missing env var references (may contain duplicate names)
- * @param options - formatting options
- * @returns formatted error message for display
- */
-export declare const format_missing_env_vars: (missing: Array<EnvVarRef>, options?: FormatMissingEnvVarsOptions) => string;
-//# sourceMappingURL=resolve.d.ts.map

package/dist/env/resolve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/env/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAiBlD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,OAAO,MAAM,KAAG,MAYnF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAQ5C,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,KAAK,CAAC,MAAM,CAS7D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACjC,KAAK,CAAC,KACJ,CAQF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACjC,OAAO,MAAM,EACb,SAAS,MAAM,KACb,MAyBF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,KAAG,KAAK,CAAC,SAAS,CAI3D,CAAC;AA2BF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;CAAE,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACjC,MAAM,KAAK,CAAC,SAAS,CAAC,KACpB,mBAYF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,KAAK,CAAC,SAAS,CAAC,EACzB,UAAU,2BAA2B,KACnC,MA+BF,CAAC"}

package/dist/env/resolve.js

@@ -1,267 +0,0 @@
-/**
- * Environment variable `$$VAR$$` resolution suite.
- *
- * Resolves `$$VAR$$` references in strings and object trees,
- * scans configs for references, and validates/formats missing vars.
- *
- * The double-dollar bookending syntax is:
- * - Visually distinct from shell `$VAR` syntax
- * - Unambiguous about variable boundaries
- * - Easy to grep: `grep '\$\$'`
- * - Fails loud if accidentally shell-processed (`$$`=PID in shell)
- *
- * # Syntax
- *
- * - `$$VAR$$` — required reference. Missing or empty fails validation
- *   (see `validate_env_vars`).
- * - `$$?VAR$$` — optional reference. Missing or empty resolves to the
- *   empty string and passes validation. Use for vars that exist in the
- *   contract but may be intentionally blank (e.g. `SMTP_PASSWORD=` on
- *   a deployment that hasn't configured SMTP yet).
- * - `\$$VAR$$` — escape. The leading backslash is dropped at resolution
- *   time and the rest is emitted literally. Use this when documenting
- *   the syntax inside a string literal (comments in env-file templates,
- *   for example) where a regex scan would otherwise treat the mention
- *   as a real reference. Combines with `?` as `\$$?VAR$$`.
- *
- * @module
- */
-/**
- * Pattern matching `$$VAR$$`, `$$?VAR$$`, and their escaped forms
- * `\$$VAR$$` / `\$$?VAR$$`. Capture groups:
- *
- * - 1: the `$$...$$` body (without any leading escape char) — what to
- *   emit when the match is escaped.
- * - 2: `?` if the reference is optional, empty otherwise.
- * - 3: the variable name (without `$$` delimiters).
- *
- * The leading `\\?` (optional backslash) is the escape signal — its
- * presence in `match[0]` (vs. `match[1]`) drives the literal-emission
- * branch in the resolver.
- */
-const ENV_VAR_PATTERN = /\\?(\$\$(\??)([A-Za-z_][A-Za-z0-9_]*)\$\$)/g;
-/**
- * Resolve environment variable references in a string.
- *
- * - `$$VAR$$` resolves from the runtime env; missing values are left as-is
- *   for the validation phase to report.
- * - `$$?VAR$$` is the optional form — missing or empty resolves to the empty
- *   string. Required validation skips refs marked optional.
- * - `\$$VAR$$` / `\$$?VAR$$` are escapes — the leading backslash is dropped
- *   and the body is emitted literally (no resolution attempted).
- *
- * @param runtime - runtime with `env_get` capability
- * @param value - string that may contain `$$VAR$$` references
- * @returns string with env vars resolved
- */
-export const resolve_env_vars = (runtime, value) => {
-    return value.replace(ENV_VAR_PATTERN, (match, body, modifier, name) => {
-        if (match.startsWith('\\')) {
-            // Escaped: drop the leading backslash, emit the body literally.
-            return body;
-        }
-        const resolved = runtime.env_get(name);
-        if (resolved !== undefined && resolved !== '')
-            return resolved;
-        // Optional: empty-on-miss. Required: leave unresolved for validation.
-        if (modifier === '?')
-            return '';
-        return match;
-    });
-};
-/**
- * Check if a string contains unresolved env var references.
- *
- * Escaped references (`\$$VAR$$`) do not count — they're literal text once
- * resolved.
- *
- * @param value - string to check
- * @returns `true` if string contains unescaped `$$VAR$$` patterns
- */
-export const has_env_vars = (value) => {
-    // Iterate the shared pattern (fresh regex; lastIndex is fine on construct).
-    const pattern = new RegExp(ENV_VAR_PATTERN.source, 'g');
-    let match;
-    while ((match = pattern.exec(value)) !== null) {
-        if (!match[0].startsWith('\\'))
-            return true;
-    }
-    return false;
-};
-/**
- * Get list of env var names referenced in a string.
- *
- * Escaped references are skipped; optional and required references are both
- * included (callers that care about the distinction should use `scan_env_vars`
- * which preserves the `optional` flag per ref).
- *
- * @param value - string to scan
- * @returns array of variable names (without `$$` delimiters)
- */
-export const get_env_var_names = (value) => {
-    const names = [];
-    const pattern = new RegExp(ENV_VAR_PATTERN.source, 'g');
-    let match;
-    while ((match = pattern.exec(value)) !== null) {
-        if (match[0].startsWith('\\'))
-            continue;
-        names.push(match[3]);
-    }
-    return names;
-};
-/**
- * Resolve env vars in an object's string values (shallow).
- *
- * @param runtime - runtime with `env_get` capability
- * @param obj - object with string values
- * @returns new object with env vars resolved
- */
-export const resolve_env_vars_in_object = (runtime, obj) => {
-    const result = { ...obj };
-    for (const [key, value] of Object.entries(result)) {
-        if (typeof value === 'string') {
-            result[key] = resolve_env_vars(runtime, value);
-        }
-    }
-    return result;
-};
-/**
- * Resolve env vars and throw if any are missing/empty.
- *
- * Use this for values that must be present. `$$?VAR$$` (optional) refs
- * resolve to the empty string on miss without contributing to the error.
- * Escaped references (`\$$VAR$$`) emit literally and never check the env.
- *
- * @param runtime - runtime with `env_get` capability
- * @param value - string with `$$VAR$$` references
- * @param context - description for error message (e.g., `"target.host"`)
- * @returns resolved string
- * @throws Error if any referenced env var is missing or empty
- */
-export const resolve_env_vars_required = (runtime, value, context) => {
-    const missing = [];
-    const result = value.replace(ENV_VAR_PATTERN, (match, body, modifier, name) => {
-        if (match.startsWith('\\')) {
-            // Escaped — emit body, no env lookup.
-            return body;
-        }
-        const resolved = runtime.env_get(name);
-        if (resolved !== undefined && resolved !== '')
-            return resolved;
-        if (modifier === '?')
-            return '';
-        missing.push(name);
-        return match; // keep original for error message
-    });
-    if (missing.length > 0) {
-        throw new Error(`Missing required environment variable(s) for ${context}: ${missing.join(', ')}`);
-    }
-    return result;
-};
-/**
- * Recursively scan an object for `$$VAR$$` env var references.
- *
- * Walks all string values in the object tree and extracts env var names
- * with their path context for error reporting. Escaped references
- * (`\$$VAR$$`) are skipped — they're literal text, not references.
- * The `optional` flag on each ref distinguishes `$$VAR$$` (required) from
- * `$$?VAR$$` (optional) for downstream validation.
- *
- * @param obj - object to scan (typically a config)
- * @returns array of env var references with paths and optional flags
- */
-export const scan_env_vars = (obj) => {
-    const refs = [];
-    scan_recursive(obj, '', refs);
-    return refs;
-};
-/**
- * Recursive helper for `scan_env_vars`. Uses the full pattern (not
- * `get_env_var_names`) to preserve the `optional` modifier on each ref.
- */
-const scan_recursive = (value, path, refs) => {
-    if (typeof value === 'string') {
-        const pattern = new RegExp(ENV_VAR_PATTERN.source, 'g');
-        let match;
-        while ((match = pattern.exec(value)) !== null) {
-            if (match[0].startsWith('\\'))
-                continue; // escaped — literal text
-            refs.push({ name: match[3], path, optional: match[2] === '?' });
-        }
-    }
-    else if (Array.isArray(value)) {
-        for (let i = 0; i < value.length; i++) {
-            scan_recursive(value[i], `${path}[${i}]`, refs);
-        }
-    }
-    else if (value !== null && typeof value === 'object') {
-        for (const [key, v] of Object.entries(value)) {
-            const new_path = path ? `${path}.${key}` : key;
-            scan_recursive(v, new_path, refs);
-        }
-    }
-    // primitives (number, boolean, null, undefined) have no env vars
-};
-/**
- * Validate that all referenced env vars exist in the environment.
- *
- * Returns all missing refs (including duplicates by name). Grouping
- * and deduplication is handled by `format_missing_env_vars` at display time.
- * Refs marked `optional: true` (from `$$?VAR$$` syntax) are skipped — a
- * deliberately-blank var is contract, not a missing dependency.
- *
- * @param runtime - runtime with `env_get` capability
- * @param refs - env var references from `scan_env_vars`
- * @returns validation result with any missing vars
- */
-export const validate_env_vars = (runtime, refs) => {
-    let missing = null;
-    for (const ref of refs) {
-        if (ref.optional)
-            continue;
-        const value = runtime.env_get(ref.name);
-        if (value === undefined || value === '') {
-            (missing ??= []).push(ref);
-        }
-    }
-    return missing === null ? { ok: true, missing: null } : { ok: false, missing };
-};
-/**
- * Format missing env vars error message.
- *
- * Groups refs by variable name so each missing var is shown once
- * with all paths where it's referenced.
- *
- * @param missing - missing env var references (may contain duplicate names)
- * @param options - formatting options
- * @returns formatted error message for display
- */
-export const format_missing_env_vars = (missing, options) => {
-    const lines = ['Missing required environment variables:', ''];
-    // group by variable name, preserving insertion order
-    const grouped = new Map();
-    for (const ref of missing) {
-        let paths = grouped.get(ref.name);
-        if (!paths) {
-            paths = [];
-            grouped.set(ref.name, paths);
-        }
-        paths.push(ref.path);
-    }
-    for (const [name, paths] of grouped) {
-        lines.push(`  ${name} - used in ${paths.join(', ')}`);
-    }
-    lines.push('');
-    const env_file = options?.env_file;
-    if (env_file) {
-        lines.push(`Loaded from: ${env_file}`);
-        lines.push(`Add these to your ${env_file} file.`);
-        if (options.setup_hint) {
-            lines.push(options.setup_hint);
-        }
-    }
-    else {
-        lines.push('Use --env_file to load environment variables from a file.');
-    }
-    return lines.join('\n');
-};