@dbx-tools/shared-core 0.6.82 → 0.6.86

package/src/context.ts

@@ -0,0 +1,164 @@
+/**
+ * The ambient CONTEXT a cached value belongs to, and a cache keyed by it.
+ *
+ * Most of the expensive lookups in this repo are pure functions of the directory
+ * (or the page) they were asked from: `npm prefix`, `git rev-parse`, a `.env`
+ * file, `databricks bundle validate`. Memoizing them with
+ * {@link functionModule.memoize} is wrong in exactly one situation, and it is the
+ * situation a CLI hits: the process changes directory, and the cached answer now
+ * describes somewhere else. Every caller therefore grew the same guard - resolve
+ * `cwd`, compare it against `process.cwd()`, and skip the cache when they differ
+ * (see the `cacheEnabled` dance this module replaced in node-core's `project`).
+ *
+ * This is that guard, once. A cache slot stores the context it was loaded under,
+ * so a context change (a moved `cwd`, a different origin) MISSES rather than
+ * returns a stale value, and a lookup for some OTHER directory is not cached at
+ * all - one off-context call must not evict or poison the hot path.
+ *
+ * The context is the process working directory on a server and
+ * `location.origin` in a browser, whichever this runtime has. Browser-safe:
+ * `process` and `location` are reached through `globalThis` and guarded, so this
+ * module needs no Node types and simply has no context off-process.
+ *
+ * @example
+ * const roots = context.cached(["project", "npm", "prefix"], (cwd) =>
+ *   spawnSync("npm", ["prefix"], { cwd }),
+ * );
+ *
+ * @module
+ */
+
+import type { OneOrMany } from "./object.ts";
+
+/** A loader for a cached value; receives the resolved context. */
+export type ContextLoader<T> = (context: string | undefined) => T;
+
+interface CacheEntry {
+  context: string;
+  value: unknown;
+}
+
+const CACHE = new Map<string, CacheEntry>();
+
+/**
+ * The current context: the process working directory, else `location.origin`,
+ * else `undefined` (a runtime with neither, where nothing is cacheable).
+ */
+export function getContext(): string | undefined {
+  for (const context of getContexts()) return context;
+  return undefined;
+}
+
+/**
+ * Whether `value` names a context this runtime is CURRENTLY in - the live `cwd`
+ * or origin. This is the cacheability test: a value loaded for some other
+ * directory is correct but not shareable, so it is never stored.
+ */
+export function isContext(value: unknown): boolean {
+  const context = toContext(value);
+  if (context === undefined) return false;
+  for (const candidate of getContexts()) {
+    if (candidate === context) return true;
+  }
+  return false;
+}
+
+/**
+ * Load `name` through `loader`, reusing the cached value while the context is
+ * unchanged.
+ *
+ * `context` selects what the value is loaded FOR: omitted, `null`, or `"."` mean
+ * the current context. It is passed straight to `loader`, so a loader never has
+ * to reach for `process.cwd()` itself.
+ *
+ * Caching happens only when the resolved context is one this runtime is in
+ * ({@link isContext}), so `cached(name, loader, "/somewhere/else")` always calls
+ * `loader` and stores nothing. A stored entry remembers its context and is
+ * discarded on the next call once that context changes. A thrown error is never
+ * cached; a rejected promise evicts its entry so a later call retries.
+ *
+ * `name` identifies the slot and must be stable across calls - pass a
+ * module-qualified list of string parts (`["project", command, ...args]`) so two
+ * modules cannot collide on one slot.
+ */
+export function cached<T>(
+  name: OneOrMany<string>,
+  loader: ContextLoader<T>,
+  context?: string | null,
+): T {
+  const resolved = toContext(context) ?? getContext();
+  const key = resolved !== undefined && isContext(resolved) ? cacheKey(name) : undefined;
+  if (key !== undefined) {
+    const entry = CACHE.get(key);
+    if (entry && entry.context === resolved) return entry.value as T;
+  }
+  const value = loader(resolved);
+  if (key !== undefined && resolved !== undefined) {
+    const entry: CacheEntry = { context: resolved, value };
+    CACHE.set(key, entry);
+    if (isThenable(value)) {
+      void Promise.resolve(value).catch(() => {
+        if (CACHE.get(key) === entry) CACHE.delete(key);
+      });
+    }
+  }
+  return value;
+}
+
+/** Drop one cached slot, or the whole cache when `name` is omitted. */
+export function clear(name?: OneOrMany<string>): void {
+  if (name === undefined) CACHE.clear();
+  else CACHE.delete(cacheKey(name));
+}
+
+/**
+ * Canonical slot key. `JSON.stringify` over the parts rather than a hash: the
+ * parts are already strings, and an exact key cannot collide two unrelated
+ * lookups onto one slot the way a truncated digest can.
+ */
+function cacheKey(name: OneOrMany<string>): string {
+  return JSON.stringify(typeof name === "string" ? [name] : name);
+}
+
+/**
+ * Every context this runtime reports, in precedence order. A server yields its
+ * `cwd`; a browser yields `location.origin`. A hybrid (a worker with both) yields
+ * both, which is what makes {@link isContext} accept either.
+ */
+function* getContexts(): Generator<string, void, void> {
+  const global = globalThis as {
+    process?: { cwd?: () => string };
+    location?: { origin?: string };
+  };
+  const cwd = global.process?.cwd;
+  if (typeof cwd === "function") {
+    let current: unknown;
+    try {
+      current = cwd();
+    } catch {
+      current = undefined;
+    }
+    const context = toContext(current);
+    if (context !== undefined) yield context;
+  }
+  const origin = toContext(global.location?.origin);
+  if (origin !== undefined) yield origin;
+}
+
+/** A non-blank string, with `"."` treated as "the current context" (unresolved). */
+function toContext(value: unknown): string | undefined {
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim();
+  return trimmed && trimmed !== "." ? trimmed : undefined;
+}
+
+/** Duck-type any value with a callable `.then` as a thenable. */
+function isThenable(value: unknown): value is PromiseLike<unknown> {
+  return (
+    value instanceof Promise ||
+    (typeof value === "object" &&
+      value !== null &&
+      "then" in value &&
+      typeof (value as PromiseLike<unknown>).then === "function")
+  );
+}

package/src/object.ts

@@ -26,7 +26,8 @@
 /** Lazy sequence over iterable source(s). See {@link sequence}. */
 export type Sequence<T> = SequenceImpl<T>;
 
-type SequenceSource<T> = Iterable<T> | ReadonlyMap<unknown, T> | OneOrMany<T> | null | undefined;
+type SequenceSource<T> =
+  Iterable<T> | ReadonlyMap<unknown, T> | OneOrMany<T> | Extract<T, string> | null | undefined;
 
 /**
  * A non-scalar {@link Iterable} - one to treat as a collection of elements
@@ -159,7 +160,7 @@ function sequenceSources<T>(...sources: SequenceSource<T>[]): Iterable<T>[] {
   const sourceIterables: Iterable<T>[] = [];
   for (const source of sources) {
     if (source == null || (isCollection(source) && isEmpty(source))) continue;
-    sourceIterables.push(values(source));
+    sourceIterables.push(isContainer<T>(source) ? values(source) : [source as T]);
   }
   return sourceIterables;
 }
@@ -979,7 +980,7 @@ export function toStableKey(value: unknown, seen: Set<object> = new Set()): stri
  *
  * @example
  * return {
- *   ...optional("appId", env.text("MICROSOFT_APP_ID")),
+ *   ...optional("appId", configuredAppId),
  *   ...optional("endpoint", config.endpoint),
  * };
  */

package/lib/src/env.d.ts

@@ -1,101 +0,0 @@
-/**
- * Reading configuration out of the environment.
- *
- * Every plugin config in this repo resolves the same way: take the typed
- * config value when the caller set one, else fall back to one or more
- * environment variables, else a default. Written by hand that becomes a
- * `config.x ?? Number(process.env.X)` chain per field, and each package grew
- * its own `fromEnv` / `resolvePositiveInt` helper with slightly different
- * coercion rules. These are those helpers, once.
- *
- * Browser-safe: `process` is reached through `globalThis` and guarded, so this
- * module needs no Node types and is inert in a browser (every lookup misses and
- * the caller's fallback applies).
- *
- * @module
- */
-/** Highest valid TCP port number. */
-export declare const MAX_TCP_PORT = 65535;
-/** One env var name, or several tried in order. */
-export type EnvKey = string | readonly string[];
-/**
- * Detect the Databricks App runtime from its required environment shape.
- *
- * A valid app has a non-empty name, an HTTP(S) workspace host, and a valid
- * `DATABRICKS_APP_PORT`. Reads the ambient environment when none is supplied.
- */
-export declare function isAppEnv(source?: Record<string, string | undefined>): boolean;
-/**
- * The PRIMARY (current, non-deprecated) name in an {@link EnvKey}.
- *
- * Use this when naming a variable in a log line or error rather than indexing
- * `keys[0]`: an {@link EnvKey} may be a bare string, and `"TUNNEL_X"[0]` is the
- * character `"T"`, which produces a message naming a variable that does not
- * exist. Returns `""` only for an empty list, which no caller should have.
- *
- * @example
- * logger.warn(`${env.name(JWT_SECRET_ENV)} is not set`);
- */
-export declare function name(keys: EnvKey): string;
-/**
- * First non-empty value among `keys`, trimmed, else `null`.
- *
- * Several names for one setting is the norm (a package-specific variable plus
- * the Databricks-standard one), so `keys` is order-sensitive: earlier names win.
- *
- * @example
- * env.text(["TEAMS_APP_ID", "MICROSOFT_APP_ID"]);
- */
-export declare function text(keys: EnvKey): string | null;
-/**
- * Resolve a string setting: `configured` when set and non-empty, else the first
- * non-empty variable among `keys`, else `null`.
- *
- * @example
- * env.string(config.host, "SMTP_HOST");
- */
-export declare function string(configured: unknown, keys: EnvKey): string | null;
-/**
- * Resolve a boolean setting through {@link toBoolean}, so the loose spellings an
- * env var actually carries (`1`, `on`, `yes`, ...) are accepted. Returns
- * `undefined` when neither source is interpretable, letting the caller pick a
- * default with `??`.
- *
- * @example
- * env.boolean(config.fuzzy, "WEB_SEARCH_FUZZY") ?? true;
- */
-export declare function boolean(configured: unknown, keys: EnvKey): boolean | undefined;
-/**
- * Resolve a positive-number setting that may be fractional (a score threshold,
- * a ratio): `configured` when it is a finite number greater than zero, else the
- * first variable among `keys` that parses that way, else `fallback`.
- *
- * {@link positiveInt} is the right choice for a count; this one keeps the
- * fraction, so a `0.4` threshold does not floor to `0`.
- *
- * @example
- * env.positiveNumber(config.fuzzyThreshold, "SEARCH_FUZZY_THRESHOLD", 0.4);
- */
-export declare function positiveNumber(configured: unknown, keys: EnvKey, fallback: number): number;
-/**
- * Resolve a positive-integer setting (a port, timeout, page size, or cap):
- * `configured` when it is a finite number greater than zero, else the first
- * variable among `keys` that parses that way, else `fallback`. Floored, so a
- * fractional value can't leak into a count.
- *
- * A non-numeric or non-positive value is treated as absent rather than fatal -
- * these are ceilings and timeouts where a sane default beats a boot failure.
- *
- * @example
- * env.positiveInt(config.timeoutMs, "SEARCH_TIMEOUT_MS", 30_000);
- */
-export declare function positiveInt(configured: unknown, keys: EnvKey, fallback: number): number;
-/**
- * Resolve a list setting through {@link parseList}, so an array from typed
- * config and a `"a, b c"` env string normalize identically. Returns `[]` when
- * neither source has entries.
- *
- * @example
- * env.list(config.modelFallbacks, "WEB_SEARCH_MODEL_FALLBACKS");
- */
-export declare function list(configured: string | readonly string[] | undefined | null, keys: EnvKey, transform?: (entry: string) => string): string[];

package/lib/src/env.js

@@ -1,153 +0,0 @@
-/**
- * Reading configuration out of the environment.
- *
- * Every plugin config in this repo resolves the same way: take the typed
- * config value when the caller set one, else fall back to one or more
- * environment variables, else a default. Written by hand that becomes a
- * `config.x ?? Number(process.env.X)` chain per field, and each package grew
- * its own `fromEnv` / `resolvePositiveInt` helper with slightly different
- * coercion rules. These are those helpers, once.
- *
- * Browser-safe: `process` is reached through `globalThis` and guarded, so this
- * module needs no Node types and is inert in a browser (every lookup misses and
- * the caller's fallback applies).
- *
- * @module
- */
-import { toBoolean, toNumber } from "./object.js";
-import { parseList, trimToNull } from "./string.js";
-/** Highest valid TCP port number. */
-export const MAX_TCP_PORT = 65_535;
-/** The ambient environment, or `{}` off-process (a browser). */
-function environment() {
-    return globalThis.process?.env ?? {};
-}
-/**
- * Detect the Databricks App runtime from its required environment shape.
- *
- * A valid app has a non-empty name, an HTTP(S) workspace host, and a valid
- * `DATABRICKS_APP_PORT`. Reads the ambient environment when none is supplied.
- */
-export function isAppEnv(source = environment()) {
-    const appName = source.DATABRICKS_APP_NAME?.trim();
-    const host = source.DATABRICKS_HOST?.trim();
-    const port = source.DATABRICKS_APP_PORT?.trim();
-    if (!appName || !host || !port)
-        return false;
-    try {
-        if (!["http:", "https:"].includes(new URL(host).protocol))
-            return false;
-    }
-    catch {
-        return false;
-    }
-    const portNumber = toNumber(port);
-    return (portNumber !== undefined &&
-        Number.isInteger(portNumber) &&
-        portNumber >= 1 &&
-        portNumber <= MAX_TCP_PORT);
-}
-/**
- * The PRIMARY (current, non-deprecated) name in an {@link EnvKey}.
- *
- * Use this when naming a variable in a log line or error rather than indexing
- * `keys[0]`: an {@link EnvKey} may be a bare string, and `"TUNNEL_X"[0]` is the
- * character `"T"`, which produces a message naming a variable that does not
- * exist. Returns `""` only for an empty list, which no caller should have.
- *
- * @example
- * logger.warn(`${env.name(JWT_SECRET_ENV)} is not set`);
- */
-export function name(keys) {
-    return typeof keys === "string" ? keys : (keys[0] ?? "");
-}
-/**
- * First non-empty value among `keys`, trimmed, else `null`.
- *
- * Several names for one setting is the norm (a package-specific variable plus
- * the Databricks-standard one), so `keys` is order-sensitive: earlier names win.
- *
- * @example
- * env.text(["TEAMS_APP_ID", "MICROSOFT_APP_ID"]);
- */
-export function text(keys) {
-    const env = environment();
-    for (const key of typeof keys === "string" ? [keys] : keys) {
-        const value = trimToNull(env[key]);
-        if (value !== null)
-            return value;
-    }
-    return null;
-}
-/**
- * Resolve a string setting: `configured` when set and non-empty, else the first
- * non-empty variable among `keys`, else `null`.
- *
- * @example
- * env.string(config.host, "SMTP_HOST");
- */
-export function string(configured, keys) {
-    return trimToNull(configured) ?? text(keys);
-}
-/**
- * Resolve a boolean setting through {@link toBoolean}, so the loose spellings an
- * env var actually carries (`1`, `on`, `yes`, ...) are accepted. Returns
- * `undefined` when neither source is interpretable, letting the caller pick a
- * default with `??`.
- *
- * @example
- * env.boolean(config.fuzzy, "WEB_SEARCH_FUZZY") ?? true;
- */
-export function boolean(configured, keys) {
-    return toBoolean(configured) ?? toBoolean(text(keys));
-}
-/**
- * Resolve a positive-number setting that may be fractional (a score threshold,
- * a ratio): `configured` when it is a finite number greater than zero, else the
- * first variable among `keys` that parses that way, else `fallback`.
- *
- * {@link positiveInt} is the right choice for a count; this one keeps the
- * fraction, so a `0.4` threshold does not floor to `0`.
- *
- * @example
- * env.positiveNumber(config.fuzzyThreshold, "SEARCH_FUZZY_THRESHOLD", 0.4);
- */
-export function positiveNumber(configured, keys, fallback) {
-    return toPositiveNumber(configured) ?? toPositiveNumber(text(keys)) ?? fallback;
-}
-/**
- * Resolve a positive-integer setting (a port, timeout, page size, or cap):
- * `configured` when it is a finite number greater than zero, else the first
- * variable among `keys` that parses that way, else `fallback`. Floored, so a
- * fractional value can't leak into a count.
- *
- * A non-numeric or non-positive value is treated as absent rather than fatal -
- * these are ceilings and timeouts where a sane default beats a boot failure.
- *
- * @example
- * env.positiveInt(config.timeoutMs, "SEARCH_TIMEOUT_MS", 30_000);
- */
-export function positiveInt(configured, keys, fallback) {
-    return toPositiveInt(configured) ?? toPositiveInt(text(keys)) ?? fallback;
-}
-function toPositiveNumber(value) {
-    const parsed = toNumber(value);
-    return parsed !== undefined && parsed > 0 ? parsed : undefined;
-}
-function toPositiveInt(value) {
-    const parsed = toPositiveNumber(value);
-    return parsed === undefined ? undefined : Math.floor(parsed);
-}
-/**
- * Resolve a list setting through {@link parseList}, so an array from typed
- * config and a `"a, b c"` env string normalize identically. Returns `[]` when
- * neither source has entries.
- *
- * @example
- * env.list(config.modelFallbacks, "WEB_SEARCH_MODEL_FALLBACKS");
- */
-export function list(configured, keys, transform) {
-    const fromConfig = parseList(configured, transform);
-    return fromConfig.length > 0 ? fromConfig : parseList(text(keys), transform);
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW52LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Vudi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFFSCxPQUFPLEVBQUUsU0FBUyxFQUFFLFFBQVEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUNsRCxPQUFPLEVBQUUsU0FBUyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQU9wRCxxQ0FBcUM7QUFDckMsTUFBTSxDQUFDLE1BQU0sWUFBWSxHQUFHLE1BQU0sQ0FBQztBQUtuQyxnRUFBZ0U7QUFDaEUsU0FBUyxXQUFXO0lBQ2xCLE9BQVEsVUFBd0MsQ0FBQyxPQUFPLEVBQUUsR0FBRyxJQUFJLEVBQUUsQ0FBQztBQUN0RSxDQUFDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLFVBQVUsUUFBUSxDQUFDLFNBQTZDLFdBQVcsRUFBRTtJQUNqRixNQUFNLE9BQU8sR0FBRyxNQUFNLENBQUMsbUJBQW1CLEVBQUUsSUFBSSxFQUFFLENBQUM7SUFDbkQsTUFBTSxJQUFJLEdBQUcsTUFBTSxDQUFDLGVBQWUsRUFBRSxJQUFJLEVBQUUsQ0FBQztJQUM1QyxNQUFNLElBQUksR0FBRyxNQUFNLENBQUMsbUJBQW1CLEVBQUUsSUFBSSxFQUFFLENBQUM7SUFDaEQsSUFBSSxDQUFDLE9BQU8sSUFBSSxDQUFDLElBQUksSUFBSSxDQUFDLElBQUk7UUFBRSxPQUFPLEtBQUssQ0FBQztJQUU3QyxJQUFJLENBQUM7UUFDSCxJQUFJLENBQUMsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDLENBQUMsUUFBUSxDQUFDLElBQUksR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLFFBQVEsQ0FBQztZQUFFLE9BQU8sS0FBSyxDQUFDO0lBQzFFLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7SUFFRCxNQUFNLFVBQVUsR0FBRyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUM7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QUMsU0FBUyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxTQUFTLENBQUMsQ0FBQztBQUMvRSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBSZWFkaW5nIGNvbmZpZ3VyYXRpb24gb3V0IG9mIHRoZSBlbnZpcm9ubWVudC5cbiAqXG4gKiBFdmVyeSBwbHVnaW4gY29uZmlnIGluIHRoaXMgcmVwbyByZXNvbHZlcyB0aGUgc2FtZSB3YXk6IHRha2UgdGhlIHR5cGVkXG4gKiBjb25maWcgdmFsdWUgd2hlbiB0aGUgY2FsbGVyIHNldCBvbmUsIGVsc2UgZmFsbCBiYWNrIHRvIG9uZSBvciBtb3JlXG4gKiBlbnZpcm9ubWVudCB2YXJpYWJsZXMsIGVsc2UgYSBkZWZhdWx0LiBXcml0dGVuIGJ5IGhhbmQgdGhhdCBiZWNvbWVzIGFcbiAqIGBjb25maWcueCA/PyBOdW1iZXIocHJvY2Vzcy5lbnYuWClgIGNoYWluIHBlciBmaWVsZCwgYW5kIGVhY2ggcGFja2FnZSBncmV3XG4gKiBpdHMgb3duIGBmcm9tRW52YCAvIGByZXNvbHZlUG9zaXRpdmVJbnRgIGhlbHBlciB3aXRoIHNsaWdodGx5IGRpZmZlcmVudFxuICogY29lcmNpb24gcnVsZXMuIFRoZXNlIGFyZSB0aG9zZSBoZWxwZXJzLCBvbmNlLlxuICpcbiAqIEJyb3dzZXItc2FmZTogYHByb2Nlc3NgIGlzIHJlYWNoZWQgdGhyb3VnaCBgZ2xvYmFsVGhpc2AgYW5kIGd1YXJkZWQsIHNvIHRoaXNcbiAqIG1vZHVsZSBuZWVkcyBubyBOb2RlIHR5cGVzIGFuZCBpcyBpbmVydCBpbiBhIGJyb3dzZXIgKGV2ZXJ5IGxvb2t1cCBtaXNzZXMgYW5kXG4gKiB0aGUgY2FsbGVyJ3MgZmFsbGJhY2sgYXBwbGllcykuXG4gKlxuICogQG1vZHVsZVxuICovXG5cbmltcG9ydCB7IHRvQm9vbGVhbiwgdG9OdW1iZXIgfSBmcm9tIFwiLi9vYmplY3QudHNcIjtcbmltcG9ydCB7IHBhcnNlTGlzdCwgdHJpbVRvTnVsbCB9IGZyb20gXCIuL3N0cmluZy50c1wiO1xuXG4vKiogYHByb2Nlc3NgLXNoYXBlZCB2aWV3IG9mZiBgZ2xvYmFsVGhpc2AsIHNvIG5vIG5vZGUgdHlwZXMgYXJlIG5lZWRlZC4gKi9cbmludGVyZmFjZSBQcm9jZXNzTGlrZSB7XG4gIGVudj86IFJlY29yZDxzdHJpbmcsIHN0cmluZyB8IHVuZGVmaW5lZD47XG59XG5cbi8qKiBIaWdoZXN0IHZhbGlkIFRDUCBwb3J0IG51bWJlci4gKi9cbmV4cG9ydCBjb25zdCBNQVhfVENQX1BPUlQgPSA2NV81MzU7XG5cbi8qKiBPbmUgZW52IHZhciBuYW1lLCBvciBzZXZlcmFsIHRyaWVkIGluIG9yZGVyLiAqL1xuZXhwb3J0IHR5cGUgRW52S2V5ID0gc3RyaW5nIHwgcmVhZG9ubHkgc3RyaW5nW107XG5cbi8qKiBUaGUgYW1iaWVudCBlbnZpcm9ubWVudCwgb3IgYHt9YCBvZmYtcHJvY2VzcyAoYSBicm93c2VyKS4gKi9cbmZ1bmN0aW9uIGVudmlyb25tZW50KCk6IFJlY29yZDxzdHJpbmcsIHN0cmluZyB8IHVuZGVmaW5lZD4ge1xuICByZXR1cm4gKGdsb2JhbFRoaXMgYXMgeyBwcm9jZXNzPzogUHJvY2Vzc0xpa2UgfSkucHJvY2Vzcz8uZW52ID8/IHt9O1xufVxuXG4vKipcbiAqIERldGVjdCB0aGUgRGF0YWJyaWNrcyBBcHAgcnVudGltZSBmcm9tIGl0cyByZXF1aXJlZCBlbnZpcm9ubWVudCBzaGFwZS5cbiAqXG4gKiBBIHZhbGlkIGFwcCBoYXMgYSBub24tZW1wdHkgbmFtZSwgYW4gSFRUUChTKSB3b3Jrc3BhY2UgaG9zdCwgYW5kIGEgdmFsaWRcbiAqIGBEQVRBQlJJQ0tTX0FQUF9QT1JUYC4gUmVhZHMgdGhlIGFtYmllbnQgZW52aXJvbm1lbnQgd2hlbiBub25lIGlzIHN1cHBsaWVkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNBcHBFbnYoc291cmNlOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmcgfCB1bmRlZmluZWQ+ID0gZW52aXJvbm1lbnQoKSk6IGJvb2xlYW4ge1xuICBjb25zdCBhcHBOYW1lID0gc291cmNlLkRBVEFCUklDS1NfQVBQX05BTUU/LnRyaW0oKTtcbiAgY29uc3QgaG9zdCA9IHNvdXJjZS5EQVRBQlJJQ0tTX0hPU1Q/LnRyaW0oKTtcbiAgY29uc3QgcG9ydCA9IHNvdXJjZS5EQVRBQlJJQ0tTX0FQUF9QT1JUPy50cmltKCk7XG4gIGlmICghYXBwTmFtZSB8fCAhaG9zdCB8fCAhcG9ydCkgcmV0dXJuIGZhbHNlO1xuXG4gIHRyeSB7XG4gICAgaWYgKCFbXCJodHRwOlwiLCBcImh0dHBzOlwiXS5pbmNsdWRlcyhuZXcgVVJMKGhvc3QpLnByb3RvY29sKSkgcmV0dXJuIGZhbHNlO1xuICB9IGNhdGNoIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICBjb25zdCBwb3J0TnVtYmVyID0gdG9OdW1iZXIocG9ydCk7XG4gIHJldHVybiAoXG4gICAgcG9ydE51bWJlciAhPT0gdW5kZWZpbmVkICYmXG4gICAgTnVtYmVyLmlzSW50ZWdlcihwb3J0TnVtYmVyKSAmJlxuICAgIHBvcnROdW1iZXIgPj0gMSAmJlxuICAgIHBvcnROdW1iZXIgPD0gTUFYX1RDUF9QT1JUXG4gICk7XG59XG5cbi8qKlxuICogVGhlIFBSSU1BUlkgKGN1cnJlbnQsIG5vbi1kZXByZWNhdGVkKSBuYW1lIGluIGFuIHtAbGluayBFbnZLZXl9LlxuICpcbiAqIFVzZSB0aGlzIHdoZW4gbmFtaW5nIGEgdmFyaWFibGUgaW4gYSBsb2cgbGluZSBvciBlcnJvciByYXRoZXIgdGhhbiBpbmRleGluZ1xuICogYGtleXNbMF1gOiBhbiB7QGxpbmsgRW52S2V5fSBtYXkgYmUgYSBiYXJlIHN0cmluZywgYW5kIGBcIlRVTk5FTF9YXCJbMF1gIGlzIHRoZVxuICogY2hhcmFjdGVyIGBcIlRcImAsIHdoaWNoIHByb2R1Y2VzIGEgbWVzc2FnZSBuYW1pbmcgYSB2YXJpYWJsZSB0aGF0IGRvZXMgbm90XG4gKiBleGlzdC4gUmV0dXJucyBgXCJcImAgb25seSBmb3IgYW4gZW1wdHkgbGlzdCwgd2hpY2ggbm8gY2FsbGVyIHNob3VsZCBoYXZlLlxuICpcbiAqIEBleGFtcGxlXG4gKiBsb2dnZXIud2FybihgJHtlbnYubmFtZShKV1RfU0VDUkVUX0VOVil9IGlzIG5vdCBzZXRgKTtcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5hbWUoa2V5czogRW52S2V5KTogc3RyaW5nIHtcbiAgcmV0dXJuIHR5cGVvZiBrZXlzID09PSBcInN0cmluZ1wiID8ga2V5cyA6IChrZXlzWzBdID8/IFwiXCIpO1xufVxuXG4vKipcbiAqIEZpcnN0IG5vbi1lbXB0eSB2YWx1ZSBhbW9uZyBga2V5c2AsIHRyaW1tZWQsIGVsc2UgYG51bGxgLlxuICpcbiAqIFNldmVyYWwgbmFtZXMgZm9yIG9uZSBzZXR0aW5nIGlzIHRoZSBub3JtIChhIHBhY2thZ2Utc3BlY2lmaWMgdmFyaWFibGUgcGx1c1xuICogdGhlIERhdGFicmlja3Mtc3RhbmRhcmQgb25lKSwgc28gYGtleXNgIGlzIG9yZGVyLXNlbnNpdGl2ZTogZWFybGllciBuYW1lcyB3aW4uXG4gKlxuICogQGV4YW1wbGVcbiAqIGVudi50ZXh0KFtcIlRFQU1TX0FQUF9JRFwiLCBcIk1JQ1JPU09GVF9BUFBfSURcIl0pO1xuICovXG5leHBvcnQgZnVuY3Rpb24gdGV4dChrZXlzOiBFbnZLZXkpOiBzdHJpbmcgfCBudWxsIHtcbiAgY29uc3QgZW52ID0gZW52aXJvbm1lbnQoKTtcbiAgZm9yIChjb25zdCBrZXkgb2YgdHlwZW9mIGtleXMgPT09IFwic3RyaW5nXCIgPyBba2V5c10gOiBrZXlzKSB7XG4gICAgY29uc3QgdmFsdWUgPSB0cmltVG9OdWxsKGVudltrZXldKTtcbiAgICBpZiAodmFsdWUgIT09IG51bGwpIHJldHVybiB2YWx1ZTtcbiAgfVxuICByZXR1cm4gbnVsbDtcbn1cblxuLyoqXG4gKiBSZXNvbHZlIGEgc3RyaW5nIHNldHRpbmc6IGBjb25maWd1cmVkYCB3aGVuIHNldCBhbmQgbm9uLWVtcHR5LCBlbHNlIHRoZSBmaXJzdFxuICogbm9uLWVtcHR5IHZhcmlhYmxlIGFtb25nIGBrZXlzYCwgZWxzZSBgbnVsbGAuXG4gKlxuICogQGV4YW1wbGVcbiAqIGVudi5zdHJpbmcoY29uZmlnLmhvc3QsIFwiU01UUF9IT1NUXCIpO1xuICovXG5leHBvcnQgZnVuY3Rpb24gc3RyaW5nKGNvbmZpZ3VyZWQ6IHVua25vd24sIGtleXM6IEVudktleSk6IHN0cmluZyB8IG51bGwge1xuICByZXR1cm4gdHJpbVRvTnVsbChjb25maWd1cmVkKSA/PyB0ZXh0KGtleXMpO1xufVxuXG4vKipcbiAqIFJlc29sdmUgYSBib29sZWFuIHNldHRpbmcgdGhyb3VnaCB7QGxpbmsgdG9Cb29sZWFufSwgc28gdGhlIGxvb3NlIHNwZWxsaW5ncyBhblxuICogZW52IHZhciBhY3R1YWxseSBjYXJyaWVzIChgMWAsIGBvbmAsIGB5ZXNgLCAuLi4pIGFyZSBhY2NlcHRlZC4gUmV0dXJuc1xuICogYHVuZGVmaW5lZGAgd2hlbiBuZWl0aGVyIHNvdXJjZSBpcyBpbnRlcnByZXRhYmxlLCBsZXR0aW5nIHRoZSBjYWxsZXIgcGljayBhXG4gKiBkZWZhdWx0IHdpdGggYD8/YC5cbiAqXG4gKiBAZXhhbXBsZVxuICogZW52LmJvb2xlYW4oY29uZmlnLmZ1enp5LCBcIldFQl9TRUFSQ0hfRlVaWllcIikgPz8gdHJ1ZTtcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJvb2xlYW4oY29uZmlndXJlZDogdW5rbm93biwga2V5czogRW52S2V5KTogYm9vbGVhbiB8IHVuZGVmaW5lZCB7XG4gIHJldHVybiB0b0Jvb2xlYW4oY29uZmlndXJlZCkgPz8gdG9Cb29sZWFuKHRleHQoa2V5cykpO1xufVxuXG4vKipcbiAqIFJlc29sdmUgYSBwb3NpdGl2ZS1udW1iZXIgc2V0dGluZyB0aGF0IG1heSBiZSBmcmFjdGlvbmFsIChhIHNjb3JlIHRocmVzaG9sZCxcbiAqIGEgcmF0aW8pOiBgY29uZmlndXJlZGAgd2hlbiBpdCBpcyBhIGZpbml0ZSBudW1iZXIgZ3JlYXRlciB0aGFuIHplcm8sIGVsc2UgdGhlXG4gKiBmaXJzdCB2YXJpYWJsZSBhbW9uZyBga2V5c2AgdGhhdCBwYXJzZXMgdGhhdCB3YXksIGVsc2UgYGZhbGxiYWNrYC5cbiAqXG4gKiB7QGxpbmsgcG9zaXRpdmVJbnR9IGlzIHRoZSByaWdodCBjaG9pY2UgZm9yIGEgY291bnQ7IHRoaXMgb25lIGtlZXBzIHRoZVxuICogZnJhY3Rpb24sIHNvIGEgYDAuNGAgdGhyZXNob2xkIGRvZXMgbm90IGZsb29yIHRvIGAwYC5cbiAqXG4gKiBAZXhhbXBsZVxuICogZW52LnBvc2l0aXZlTnVtYmVyKGNvbmZpZy5mdXp6eVRocmVzaG9sZCwgXCJTRUFSQ0hfRlVaWllfVEhSRVNIT0xEXCIsIDAuNCk7XG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBwb3NpdGl2ZU51bWJlcihjb25maWd1cmVkOiB1bmtub3duLCBrZXlzOiBFbnZLZXksIGZhbGxiYWNrOiBudW1iZXIpOiBudW1iZXIge1xuICByZXR1cm4gdG9Qb3NpdGl2ZU51bWJlcihjb25maWd1cmVkKSA/PyB0b1Bvc2l0aXZlTnVtYmVyKHRleHQoa2V5cykpID8/IGZhbGxiYWNrO1xufVxuXG4vKipcbiAqIFJlc29sdmUgYSBwb3NpdGl2ZS1pbnRlZ2VyIHNldHRpbmcgKGEgcG9ydCwgdGltZW91dCwgcGFnZSBzaXplLCBvciBjYXApOlxuICogYGNvbmZpZ3VyZWRgIHdoZW4gaXQgaXMgYSBmaW5pdGUgbnVtYmVyIGdyZWF0ZXIgdGhhbiB6ZXJvLCBlbHNlIHRoZSBmaXJzdFxuICogdmFyaWFibGUgYW1vbmcgYGtleXNgIHRoYXQgcGFyc2VzIHRoYXQgd2F5LCBlbHNlIGBmYWxsYmFja2AuIEZsb29yZWQsIHNvIGFcbiAqIGZyYWN0aW9uYWwgdmFsdWUgY2FuJ3QgbGVhayBpbnRvIGEgY291bnQuXG4gKlxuICogQSBub24tbnVtZXJpYyBvciBub24tcG9zaXRpdmUgdmFsdWUgaXMgdHJlYXRlZCBhcyBhYnNlbnQgcmF0aGVyIHRoYW4gZmF0YWwgLVxuICogdGhlc2UgYXJlIGNlaWxpbmdzIGFuZCB0aW1lb3V0cyB3aGVyZSBhIHNhbmUgZGVmYXVsdCBiZWF0cyBhIGJvb3QgZmFpbHVyZS5cbiAqXG4gKiBAZXhhbXBsZVxuICogZW52LnBvc2l0aXZlSW50KGNvbmZpZy50aW1lb3V0TXMsIFwiU0VBUkNIX1RJTUVPVVRfTVNcIiwgMzBfMDAwKTtcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBvc2l0aXZlSW50KGNvbmZpZ3VyZWQ6IHVua25vd24sIGtleXM6IEVudktleSwgZmFsbGJhY2s6IG51bWJlcik6IG51bWJlciB7XG4gIHJldHVybiB0b1Bvc2l0aXZlSW50KGNvbmZpZ3VyZWQpID8/IHRvUG9zaXRpdmVJbnQodGV4dChrZXlzKSkgPz8gZmFsbGJhY2s7XG59XG5cbmZ1bmN0aW9uIHRvUG9zaXRpdmVOdW1iZXIodmFsdWU6IHVua25vd24pOiBudW1iZXIgfCB1bmRlZmluZWQge1xuICBjb25zdCBwYXJzZWQgPSB0b051bWJlcih2YWx1ZSk7XG4gIHJldHVybiBwYXJzZWQgIT09IHVuZGVmaW5lZCAmJiBwYXJzZWQgPiAwID8gcGFyc2VkIDogdW5kZWZpbmVkO1xufVxuXG5mdW5jdGlvbiB0b1Bvc2l0aXZlSW50KHZhbHVlOiB1bmtub3duKTogbnVtYmVyIHwgdW5kZWZpbmVkIHtcbiAgY29uc3QgcGFyc2VkID0gdG9Qb3NpdGl2ZU51bWJlcih2YWx1ZSk7XG4gIHJldHVybiBwYXJzZWQgPT09IHVuZGVmaW5lZCA/IHVuZGVmaW5lZCA6IE1hdGguZmxvb3IocGFyc2VkKTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlIGEgbGlzdCBzZXR0aW5nIHRocm91Z2gge0BsaW5rIHBhcnNlTGlzdH0sIHNvIGFuIGFycmF5IGZyb20gdHlwZWRcbiAqIGNvbmZpZyBhbmQgYSBgXCJhLCBiIGNcImAgZW52IHN0cmluZyBub3JtYWxpemUgaWRlbnRpY2FsbHkuIFJldHVybnMgYFtdYCB3aGVuXG4gKiBuZWl0aGVyIHNvdXJjZSBoYXMgZW50cmllcy5cbiAqXG4gKiBAZXhhbXBsZVxuICogZW52Lmxpc3QoY29uZmlnLm1vZGVsRmFsbGJhY2tzLCBcIldFQl9TRUFSQ0hfTU9ERUxfRkFMTEJBQ0tTXCIpO1xuICovXG5leHBvcnQgZnVuY3Rpb24gbGlzdChcbiAgY29uZmlndXJlZDogc3RyaW5nIHwgcmVhZG9ubHkgc3RyaW5nW10gfCB1bmRlZmluZWQgfCBudWxsLFxuICBrZXlzOiBFbnZLZXksXG4gIHRyYW5zZm9ybT86IChlbnRyeTogc3RyaW5nKSA9PiBzdHJpbmcsXG4pOiBzdHJpbmdbXSB7XG4gIGNvbnN0IGZyb21Db25maWcgPSBwYXJzZUxpc3QoY29uZmlndXJlZCwgdHJhbnNmb3JtKTtcbiAgcmV0dXJuIGZyb21Db25maWcubGVuZ3RoID4gMCA/IGZyb21Db25maWcgOiBwYXJzZUxpc3QodGV4dChrZXlzKSwgdHJhbnNmb3JtKTtcbn1cbiJdfQ==

package/src/env.ts

@@ -1,177 +0,0 @@
-/**
- * Reading configuration out of the environment.
- *
- * Every plugin config in this repo resolves the same way: take the typed
- * config value when the caller set one, else fall back to one or more
- * environment variables, else a default. Written by hand that becomes a
- * `config.x ?? Number(process.env.X)` chain per field, and each package grew
- * its own `fromEnv` / `resolvePositiveInt` helper with slightly different
- * coercion rules. These are those helpers, once.
- *
- * Browser-safe: `process` is reached through `globalThis` and guarded, so this
- * module needs no Node types and is inert in a browser (every lookup misses and
- * the caller's fallback applies).
- *
- * @module
- */
-
-import { toBoolean, toNumber } from "./object.ts";
-import { parseList, trimToNull } from "./string.ts";
-
-/** `process`-shaped view off `globalThis`, so no node types are needed. */
-interface ProcessLike {
-  env?: Record<string, string | undefined>;
-}
-
-/** Highest valid TCP port number. */
-export const MAX_TCP_PORT = 65_535;
-
-/** One env var name, or several tried in order. */
-export type EnvKey = string | readonly string[];
-
-/** The ambient environment, or `{}` off-process (a browser). */
-function environment(): Record<string, string | undefined> {
-  return (globalThis as { process?: ProcessLike }).process?.env ?? {};
-}
-
-/**
- * Detect the Databricks App runtime from its required environment shape.
- *
- * A valid app has a non-empty name, an HTTP(S) workspace host, and a valid
- * `DATABRICKS_APP_PORT`. Reads the ambient environment when none is supplied.
- */
-export function isAppEnv(source: Record<string, string | undefined> = environment()): boolean {
-  const appName = source.DATABRICKS_APP_NAME?.trim();
-  const host = source.DATABRICKS_HOST?.trim();
-  const port = source.DATABRICKS_APP_PORT?.trim();
-  if (!appName || !host || !port) return false;
-
-  try {
-    if (!["http:", "https:"].includes(new URL(host).protocol)) return false;
-  } catch {
-    return false;
-  }
-
-  const portNumber = toNumber(port);
-  return (
-    portNumber !== undefined &&
-    Number.isInteger(portNumber) &&
-    portNumber >= 1 &&
-    portNumber <= MAX_TCP_PORT
-  );
-}
-
-/**
- * The PRIMARY (current, non-deprecated) name in an {@link EnvKey}.
- *
- * Use this when naming a variable in a log line or error rather than indexing
- * `keys[0]`: an {@link EnvKey} may be a bare string, and `"TUNNEL_X"[0]` is the
- * character `"T"`, which produces a message naming a variable that does not
- * exist. Returns `""` only for an empty list, which no caller should have.
- *
- * @example
- * logger.warn(`${env.name(JWT_SECRET_ENV)} is not set`);
- */
-export function name(keys: EnvKey): string {
-  return typeof keys === "string" ? keys : (keys[0] ?? "");
-}
-
-/**
- * First non-empty value among `keys`, trimmed, else `null`.
- *
- * Several names for one setting is the norm (a package-specific variable plus
- * the Databricks-standard one), so `keys` is order-sensitive: earlier names win.
- *
- * @example
- * env.text(["TEAMS_APP_ID", "MICROSOFT_APP_ID"]);
- */
-export function text(keys: EnvKey): string | null {
-  const env = environment();
-  for (const key of typeof keys === "string" ? [keys] : keys) {
-    const value = trimToNull(env[key]);
-    if (value !== null) return value;
-  }
-  return null;
-}
-
-/**
- * Resolve a string setting: `configured` when set and non-empty, else the first
- * non-empty variable among `keys`, else `null`.
- *
- * @example
- * env.string(config.host, "SMTP_HOST");
- */
-export function string(configured: unknown, keys: EnvKey): string | null {
-  return trimToNull(configured) ?? text(keys);
-}
-
-/**
- * Resolve a boolean setting through {@link toBoolean}, so the loose spellings an
- * env var actually carries (`1`, `on`, `yes`, ...) are accepted. Returns
- * `undefined` when neither source is interpretable, letting the caller pick a
- * default with `??`.
- *
- * @example
- * env.boolean(config.fuzzy, "WEB_SEARCH_FUZZY") ?? true;
- */
-export function boolean(configured: unknown, keys: EnvKey): boolean | undefined {
-  return toBoolean(configured) ?? toBoolean(text(keys));
-}
-
-/**
- * Resolve a positive-number setting that may be fractional (a score threshold,
- * a ratio): `configured` when it is a finite number greater than zero, else the
- * first variable among `keys` that parses that way, else `fallback`.
- *
- * {@link positiveInt} is the right choice for a count; this one keeps the
- * fraction, so a `0.4` threshold does not floor to `0`.
- *
- * @example
- * env.positiveNumber(config.fuzzyThreshold, "SEARCH_FUZZY_THRESHOLD", 0.4);
- */
-export function positiveNumber(configured: unknown, keys: EnvKey, fallback: number): number {
-  return toPositiveNumber(configured) ?? toPositiveNumber(text(keys)) ?? fallback;
-}
-
-/**
- * Resolve a positive-integer setting (a port, timeout, page size, or cap):
- * `configured` when it is a finite number greater than zero, else the first
- * variable among `keys` that parses that way, else `fallback`. Floored, so a
- * fractional value can't leak into a count.
- *
- * A non-numeric or non-positive value is treated as absent rather than fatal -
- * these are ceilings and timeouts where a sane default beats a boot failure.
- *
- * @example
- * env.positiveInt(config.timeoutMs, "SEARCH_TIMEOUT_MS", 30_000);
- */
-export function positiveInt(configured: unknown, keys: EnvKey, fallback: number): number {
-  return toPositiveInt(configured) ?? toPositiveInt(text(keys)) ?? fallback;
-}
-
-function toPositiveNumber(value: unknown): number | undefined {
-  const parsed = toNumber(value);
-  return parsed !== undefined && parsed > 0 ? parsed : undefined;
-}
-
-function toPositiveInt(value: unknown): number | undefined {
-  const parsed = toPositiveNumber(value);
-  return parsed === undefined ? undefined : Math.floor(parsed);
-}
-
-/**
- * Resolve a list setting through {@link parseList}, so an array from typed
- * config and a `"a, b c"` env string normalize identically. Returns `[]` when
- * neither source has entries.
- *
- * @example
- * env.list(config.modelFallbacks, "WEB_SEARCH_MODEL_FALLBACKS");
- */
-export function list(
-  configured: string | readonly string[] | undefined | null,
-  keys: EnvKey,
-  transform?: (entry: string) => string,
-): string[] {
-  const fromConfig = parseList(configured, transform);
-  return fromConfig.length > 0 ? fromConfig : parseList(text(keys), transform);
-}