@fonoster/common 0.27.0 → 0.30.0

package/dist/config/cli/main.d.ts

@@ -0,0 +1,11 @@
+import { Io } from "./types";
+export declare const HELP = "Usage: fonoster-config <command> [options]\n\nSets up Fonoster from its Docker Compose bundle. Run it in the unpacked fonoster folder.\n\nCommands:\n  init     Generate secrets and keys, detect the host address, write .env and config/*.yaml.\n           Secrets stay in .env; config/*.yaml reference them as ${NAME}. Running it again\n           keeps every existing secret and adds only missing ones.\n  info     Print the dashboard URL, the owner login, the SIP address and where files live.\n  check    Validate config/*.yaml with .env's values (unknown keys, missing values, unset\n           ${NAME} placeholders, secret:// references).\n\nOptions:\n  --dir <folder>        The bundle folder (default: the current folder)\n  --host-ip <address>   init: the address softphones and browsers reach this machine at\n  -h, --help            Show this help\n\nThen start it with: docker compose up -d\nGuide: https://docs.fonoster.com/self-hosting/install-compose\n";
+type Parsed = {
+    command?: string;
+    flags: Record<string, string | true>;
+    lists: Record<string, string[]>;
+    error?: string;
+};
+export declare function parseArgs(argv: string[]): Parsed;
+export declare function main(argv: string[], io?: Io): Promise<number>;
+export {};

package/dist/config/cli/main.js

@@ -0,0 +1,155 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.parseArgs = parseArgs;
+exports.main = main;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const path_1 = require("path");
+const check_1 = require("./check");
+const envFile_1 = require("./envFile");
+const info_1 = require("./info");
+const init_1 = require("./init");
+const render_1 = require("./render");
+const types_1 = require("./types");
+// fonoster-config: sets up a Fonoster install from the Docker Compose bundle (self-host
+// installer). Run it in the unpacked folder: `npx -p @fonoster/common fonoster-config init`.
+exports.HELP = `Usage: fonoster-config <command> [options]
+
+Sets up Fonoster from its Docker Compose bundle. Run it in the unpacked fonoster folder.
+
+Commands:
+  init     Generate secrets and keys, detect the host address, write .env and config/*.yaml.
+           Secrets stay in .env; config/*.yaml reference them as \${NAME}. Running it again
+           keeps every existing secret and adds only missing ones.
+  info     Print the dashboard URL, the owner login, the SIP address and where files live.
+  check    Validate config/*.yaml with .env's values (unknown keys, missing values, unset
+           \${NAME} placeholders, secret:// references).
+
+Options:
+  --dir <folder>        The bundle folder (default: the current folder)
+  --host-ip <address>   init: the address softphones and browsers reach this machine at
+  -h, --help            Show this help
+
+Then start it with: docker compose up -d
+Guide: https://docs.fonoster.com/self-hosting/install-compose
+`;
+const VALUE_FLAGS = ["dir", "host-ip", "config-dir", "env-file", "overlay"];
+function parseArgs(argv) {
+    var _a;
+    var _b;
+    const out = { flags: {}, lists: {} };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "-h" || a === "--help")
+            out.flags.help = true;
+        else if (a.startsWith("--")) {
+            const eq = a.indexOf("=");
+            const name = eq < 0 ? a.slice(2) : a.slice(2, eq);
+            const inline = eq < 0 ? undefined : a.slice(eq + 1);
+            if (!VALUE_FLAGS.includes(name))
+                return Object.assign(Object.assign({}, out), { error: `unknown option ${a}` });
+            const value = inline !== null && inline !== void 0 ? inline : argv[++i];
+            if (value === undefined)
+                return Object.assign(Object.assign({}, out), { error: `${a} needs a value` });
+            out.flags[name] = value;
+            ((_a = (_b = out.lists)[name]) !== null && _a !== void 0 ? _a : (_b[name] = [])).push(value);
+        }
+        else if (!out.command)
+            out.command = a;
+        else
+            return Object.assign(Object.assign({}, out), { error: `unexpected argument ${a}` });
+    }
+    return out;
+}
+/**
+ * render: the renderer init uses, for other layouts (the development stack): renders the
+ * examples in --config-dir (default <dir>/config) with the values of each --env-file (default
+ * <dir>/.env; later files win), deep-merging YAML overlays from --overlay.
+ */
+function runRender(args, dir, io) {
+    var _a, _b, _c;
+    const envFiles = (_a = args.lists["env-file"]) !== null && _a !== void 0 ? _a : [(0, path_1.resolve)(dir, ".env")];
+    const entries = new Map();
+    for (const f of envFiles)
+        for (const [k, v] of (0, envFile_1.readEnvFile)((0, path_1.resolve)(f)))
+            entries.set(k, v);
+    const configDir = (0, path_1.resolve)(String((_b = args.flags["config-dir"]) !== null && _b !== void 0 ? _b : `${dir}/config`));
+    try {
+        const files = (0, render_1.renderConfigDir)({
+            configDir,
+            env: (0, envFile_1.expandEnv)(entries),
+            overlayDirs: ((_c = args.lists.overlay) !== null && _c !== void 0 ? _c : []).map((d) => (0, path_1.resolve)(d))
+        });
+        io.out(`rendered ${files.join(", ")}`);
+        return 0;
+    }
+    catch (e) {
+        if (!(e instanceof render_1.RenderError))
+            throw e;
+        e.problems.forEach((p) => io.err(p));
+        return 1;
+    }
+}
+function main(argv_1) {
+    return __awaiter(this, arguments, void 0, function* (argv, io = types_1.consoleIo) {
+        var _a;
+        const args = parseArgs(argv);
+        if (args.error) {
+            io.err(`fonoster-config: ${args.error}`);
+            io.err("Run fonoster-config --help for usage.");
+            return 2;
+        }
+        if (args.flags.help || !args.command || args.command === "help") {
+            exports.HELP.trimEnd()
+                .split("\n")
+                .forEach((l) => io.out(l));
+            return args.command || args.flags.help ? 0 : 2;
+        }
+        const dir = (0, path_1.resolve)(String((_a = args.flags.dir) !== null && _a !== void 0 ? _a : "."));
+        switch (args.command) {
+            case "init":
+                return (0, init_1.runInit)({
+                    dir,
+                    hostIp: args.flags["host-ip"] === undefined
+                        ? undefined
+                        : String(args.flags["host-ip"])
+                }, io);
+            case "info":
+                return (0, info_1.runInfo)({ dir }, io);
+            case "check":
+                return (0, check_1.runCheck)({ dir }, io);
+            case "render":
+                return runRender(args, dir, io);
+            default:
+                io.err(`fonoster-config: unknown command ${args.command}`);
+                io.err("Run fonoster-config --help for usage.");
+                return 2;
+        }
+    });
+}

package/dist/config/cli/render.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Renders `config/<name>.example.<ext>` into `config/<name>.<ext>` (self-host bundle, D1).
+ *
+ * A Fonoster service's file (FONOSTER_SERVICE_FILES) is the example as written: `${NAME}` and
+ * `${NAME:-default}` stay placeholders that the service resolves from its container environment,
+ * which Compose fills from .env (unify-config-placeholders), so no secret is written into it.
+ * Another container's file (Routr's EdgePort) gets the values, since that container cannot
+ * resolve them; those hold no secrets. Either way every `${NAME}` without a default must be set,
+ * so a missing value fails at init, not at start.
+ *
+ * An overlay folder (the development stack's; several merge in order) may hold a
+ * `<name>.<ext>` YAML that is deep-merged into the result: objects merge, other values replace,
+ * and `null` removes a key.
+ */
+export type Env = Record<string, string | undefined>;
+export declare class RenderError extends Error {
+    readonly problems: string[];
+    constructor(problems: string[]);
+}
+/** Config files read by Fonoster's own services: placeholders stay in them. */
+export declare const FONOSTER_SERVICE_FILES: string[];
+/**
+ * Checks one template's placeholders and returns it with them kept (`substitute` false) or
+ * replaced by their values. Problems name the file, the line and the variable, never a value.
+ * Whole-line comments are copied as they are (they may mention `${NAME}`).
+ */
+export declare function renderTemplate(text: string, env: Env, file?: string, substitute?: boolean): string;
+export declare function deepMerge(base: unknown, overlay: unknown): unknown;
+export declare const EXAMPLE: RegExp;
+/** The rendered name of an example (`gateway.example.yaml` → `gateway.yaml`). */
+export declare function renderedName(example: string): string | undefined;
+export declare function listExamples(configDir: string): string[];
+export type RenderOptions = {
+    configDir: string;
+    /** Where rendered files go (default configDir). */
+    outDir?: string;
+    env: Env;
+    /** Overlay folders, merged in order. */
+    overlayDirs?: string[];
+    /** File mode of rendered files (default 0644). */
+    mode?: number;
+};
+/** Renders every example of a config folder; returns the rendered file names. */
+export declare function renderConfigDir(options: RenderOptions): string[];

package/dist/config/cli/render.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXAMPLE = exports.FONOSTER_SERVICE_FILES = exports.RenderError = void 0;
+exports.renderTemplate = renderTemplate;
+exports.deepMerge = deepMerge;
+exports.renderedName = renderedName;
+exports.listExamples = listExamples;
+exports.renderConfigDir = renderConfigDir;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+const yaml_1 = require("yaml");
+const envFile_1 = require("./envFile");
+const REF = /\$\{([A-Za-z_][A-Za-z0-9_]*)(:-([^}]*))?\}/g;
+class RenderError extends Error {
+    constructor(problems) {
+        super(problems.join("\n"));
+        this.problems = problems;
+    }
+}
+exports.RenderError = RenderError;
+/** Config files read by Fonoster's own services: placeholders stay in them. */
+exports.FONOSTER_SERVICE_FILES = [
+    "fonoster",
+    "identity",
+    "gateway",
+    "autopilot",
+    "medianode"
+];
+/**
+ * Checks one template's placeholders and returns it with them kept (`substitute` false) or
+ * replaced by their values. Problems name the file, the line and the variable, never a value.
+ * Whole-line comments are copied as they are (they may mention `${NAME}`).
+ */
+function renderTemplate(text, env, file = "template", substitute = false) {
+    const problems = [];
+    const out = text.split("\n").map((line, i) => {
+        if (line.trimStart().startsWith("#"))
+            return line;
+        return line.replace(REF, (m, name, dflt, fallback) => {
+            const v = env[name];
+            if (v !== undefined && v !== "")
+                return substitute ? v : m;
+            if (dflt !== undefined)
+                return substitute ? fallback : m;
+            problems.push(`${file}:${i + 1}: \${${name}} is not set`);
+            return m;
+        });
+    });
+    if (problems.length)
+        throw new RenderError(problems);
+    return out.join("\n");
+}
+const isObj = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+function deepMerge(base, overlay) {
+    if (!isObj(base) || !isObj(overlay))
+        return overlay;
+    const out = Object.assign({}, base);
+    for (const [k, v] of Object.entries(overlay)) {
+        if (v === null)
+            delete out[k];
+        else
+            out[k] = k in out ? deepMerge(out[k], v) : v;
+    }
+    return out;
+}
+exports.EXAMPLE = /^(.+)\.example\.([A-Za-z0-9]+)$/;
+/** The rendered name of an example (`gateway.example.yaml` → `gateway.yaml`). */
+function renderedName(example) {
+    const m = exports.EXAMPLE.exec(example);
+    return m ? `${m[1]}.${m[2]}` : undefined;
+}
+function listExamples(configDir) {
+    return (0, fs_1.readdirSync)(configDir)
+        .filter((f) => exports.EXAMPLE.test(f))
+        .sort();
+}
+/** Renders every example of a config folder; returns the rendered file names. */
+function renderConfigDir(options) {
+    var _a, _b, _c, _d, _e;
+    const outDir = (_a = options.outDir) !== null && _a !== void 0 ? _a : options.configDir;
+    const problems = [];
+    const rendered = [];
+    for (const example of listExamples(options.configDir)) {
+        const name = renderedName(example);
+        const substitute = !exports.FONOSTER_SERVICE_FILES.includes(exports.EXAMPLE.exec(example)[1]);
+        try {
+            let text = renderTemplate((0, fs_1.readFileSync)((0, path_1.join)(options.configDir, example), "utf8"), options.env, `config/${example}`, substitute);
+            const overlays = ((_b = options.overlayDirs) !== null && _b !== void 0 ? _b : [])
+                .map((d) => (0, path_1.join)(d, name))
+                .filter((f) => (0, fs_1.existsSync)(f));
+            if (overlays.length) {
+                let merged = (_c = (0, yaml_1.parse)(text)) !== null && _c !== void 0 ? _c : {};
+                for (const overlay of overlays)
+                    merged = deepMerge(merged, (_d = (0, yaml_1.parse)(renderTemplate((0, fs_1.readFileSync)(overlay, "utf8"), options.env, overlay, substitute))) !== null && _d !== void 0 ? _d : {});
+                text = (0, yaml_1.stringify)(merged, { lineWidth: 0 });
+            }
+            rendered.push({ name, text });
+        }
+        catch (e) {
+            if (e instanceof RenderError)
+                problems.push(...e.problems);
+            else
+                problems.push(`config/${example}: ${e.message}`);
+        }
+    }
+    if (problems.length)
+        throw new RenderError(problems);
+    for (const { name, text } of rendered)
+        (0, envFile_1.writeWithMode)((0, path_1.join)(outDir, name), text, (_e = options.mode) !== null && _e !== void 0 ? _e : 0o644);
+    return rendered.map((r) => r.name);
+}

package/dist/config/cli/secrets.d.ts

@@ -0,0 +1,21 @@
+/** A Cloak key (`npx @47ng/cloak generate` format): base64url of 32 random bytes. */
+export declare function encryptionKey(): string;
+/**
+ * The value `init` generates for an empty `.env` name, or undefined when the name is not a
+ * secret. Passwords start with a letter: NATS parses a variable's value as config, and one
+ * starting with a digit fails to load.
+ */
+export declare function generateSecret(name: string): string | undefined;
+/**
+ * The IPv4 address of the default route's interface: a UDP socket "connected" to a public
+ * address (no packet is sent) reports the source address the kernel would use.
+ */
+export declare function detectHostIp(timeoutMs?: number): Promise<string | undefined>;
+/** Files the containers read: world-readable, not writable (they run as another user). */
+export declare const CONTAINER_READ = 420;
+/**
+ * The keys of an install, each generated only when its file is missing (config/keys):
+ * Identity's RS256 pair and the call-record ES256 key. Hosting private regions is a manual
+ * addition (fonoster-region-hub-setup in the apiserver image), not part of init.
+ */
+export declare function ensureKeys(configDir: string): string[];

package/dist/config/cli/secrets.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTAINER_READ = void 0;
+exports.encryptionKey = encryptionKey;
+exports.generateSecret = generateSecret;
+exports.detectHostIp = detectHostIp;
+exports.ensureKeys = ensureKeys;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const crypto_1 = require("crypto");
+const dgram_1 = require("dgram");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const envFile_1 = require("./envFile");
+const hex = (bytes) => (0, crypto_1.randomBytes)(bytes).toString("hex");
+/** A Cloak key (`npx @47ng/cloak generate` format): base64url of 32 random bytes. */
+function encryptionKey() {
+    return `k1.aesgcm256.${(0, crypto_1.randomBytes)(32).toString("base64url")}=`;
+}
+/**
+ * The value `init` generates for an empty `.env` name, or undefined when the name is not a
+ * secret. Passwords start with a letter: NATS parses a variable's value as config, and one
+ * starting with a digit fails to load.
+ */
+function generateSecret(name) {
+    if (name === "ENCRYPTION_KEY")
+        return encryptionKey();
+    if (name === "AUTOPILOT_SIGNING_SECRET")
+        return hex(24);
+    if (name === "OWNER_PASSWORD")
+        return `p${hex(8)}`;
+    if (/(_PASSWORD|_SECRET|_KEY|_TOKEN)$/.test(name))
+        return `s${hex(16)}`;
+    return undefined;
+}
+/**
+ * The IPv4 address of the default route's interface: a UDP socket "connected" to a public
+ * address (no packet is sent) reports the source address the kernel would use.
+ */
+function detectHostIp(timeoutMs = 2000) {
+    return new Promise((resolve) => {
+        const socket = (0, dgram_1.createSocket)("udp4");
+        const done = (ip) => {
+            clearTimeout(timer);
+            try {
+                socket.close();
+            }
+            catch (_a) {
+                // already closed
+            }
+            resolve(ip && ip !== "0.0.0.0" ? ip : undefined);
+        };
+        const timer = setTimeout(() => done(), timeoutMs);
+        socket.on("error", () => done());
+        try {
+            socket.connect(53, "192.0.2.1", () => {
+                try {
+                    done(socket.address().address);
+                }
+                catch (_a) {
+                    done();
+                }
+            });
+        }
+        catch (_a) {
+            done();
+        }
+    });
+}
+/** Files the containers read: world-readable, not writable (they run as another user). */
+exports.CONTAINER_READ = 0o644;
+function once(path, make, created) {
+    if ((0, fs_1.existsSync)(path))
+        return;
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true, mode: 0o755 });
+    (0, envFile_1.writeWithMode)(path, make().toString(), exports.CONTAINER_READ);
+    created.push(path);
+}
+/**
+ * The keys of an install, each generated only when its file is missing (config/keys):
+ * Identity's RS256 pair and the call-record ES256 key. Hosting private regions is a manual
+ * addition (fonoster-region-hub-setup in the apiserver image), not part of init.
+ */
+function ensureKeys(configDir) {
+    const keys = (0, path_1.join)(configDir, "keys");
+    const created = [];
+    if (!(0, fs_1.existsSync)((0, path_1.join)(keys, "private.pem"))) {
+        const pair = (0, crypto_1.generateKeyPairSync)("rsa", { modulusLength: 2048 });
+        (0, fs_1.mkdirSync)(keys, { recursive: true, mode: 0o755 });
+        const pub = (0, path_1.join)(keys, "public.pem");
+        const priv = (0, path_1.join)(keys, "private.pem");
+        (0, envFile_1.writeWithMode)(pub, pair.publicKey.export({ type: "spki", format: "pem" }).toString(), exports.CONTAINER_READ);
+        (0, envFile_1.writeWithMode)(priv, pair.privateKey.export({ type: "pkcs8", format: "pem" }).toString(), exports.CONTAINER_READ);
+        created.push(priv, pub);
+    }
+    once((0, path_1.join)(keys, "records.pem"), () => (0, crypto_1.generateKeyPairSync)("ec", { namedCurve: "P-256" }).privateKey.export({
+        type: "pkcs8",
+        format: "pem"
+    }), created);
+    return created;
+}

package/dist/{utils/findIntegrationsCredentials.d.ts → config/cli/types.d.ts}

@@ -16,8 +16,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-declare function findIntegrationsCredentials(integrations: {
-    productRef: string;
-    credentials: Record<string, unknown>;
-}[], engine: string): Record<string, unknown>;
-export { findIntegrationsCredentials };
+/** Where a command writes: its normal output and its problems (tests capture both). */
+export type Io = {
+    out: (line: string) => void;
+    err: (line: string) => void;
+};
+export declare const consoleIo: Io;

package/dist/config/cli/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleIo = void 0;
+exports.consoleIo = {
+    out: (line) => process.stdout.write(`${line}\n`),
+    err: (line) => process.stderr.write(`${line}\n`)
+};

package/dist/config/configHints.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+type Env = Record<string, string | undefined>;
+/** Old key path → new key path, e.g. `{ encryptionKey: "encryption.key" }`. */
+type MovedKeys = Record<string, string>;
+/**
+ * Lists the moved keys present in a raw config, as readable hints. The new
+ * location may itself be valid, so this only reports what was found.
+ */
+declare function findMovedKeys(raw: unknown, movedKeys: MovedKeys): string[];
+/**
+ * Names of environment variables that look like the old env-based config for
+ * this service. Values are never returned, so they can be logged safely.
+ */
+declare function findLegacyEnv(prefixes: string[], env?: Env): string[];
+/** Edit distance between two strings (insertions, deletions, substitutions). */
+declare function levenshtein(a: string, b: string): number;
+/**
+ * The known key closest to an unknown one (`turnTakng` → `turnTaking`), when it is close enough
+ * to be a typo: at most a third of the key's length (at least 1) edits away, ignoring case.
+ */
+declare function suggestKey(unknown: string, known: string[]): string | undefined;
+export { findMovedKeys, findLegacyEnv, levenshtein, suggestKey, MovedKeys };

package/dist/config/configHints.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findMovedKeys = findMovedKeys;
+exports.findLegacyEnv = findLegacyEnv;
+exports.levenshtein = levenshtein;
+exports.suggestKey = suggestKey;
+function hasPath(input, path) {
+    let current = input;
+    for (const segment of path.split(".")) {
+        if (current === null ||
+            typeof current !== "object" ||
+            !(segment in current)) {
+            return false;
+        }
+        current = current[segment];
+    }
+    return true;
+}
+/**
+ * Lists the moved keys present in a raw config, as readable hints. The new
+ * location may itself be valid, so this only reports what was found.
+ */
+function findMovedKeys(raw, movedKeys) {
+    return Object.entries(movedKeys)
+        .filter(([from]) => hasPath(raw, from))
+        .map(([from, to]) => `"${from}" moved to "${to}"`);
+}
+/**
+ * Names of environment variables that look like the old env-based config for
+ * this service. Values are never returned, so they can be logged safely.
+ */
+function findLegacyEnv(prefixes, env = process.env) {
+    return Object.keys(env)
+        .filter((name) => prefixes.some((prefix) => name.startsWith(prefix)))
+        .sort();
+}
+/** Edit distance between two strings (insertions, deletions, substitutions). */
+function levenshtein(a, b) {
+    let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= a.length; i++) {
+        const row = [i];
+        for (let j = 1; j <= b.length; j++)
+            row[j] = Math.min(prev[j] + 1, row[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        prev = row;
+    }
+    return prev[b.length];
+}
+/**
+ * The known key closest to an unknown one (`turnTakng` → `turnTaking`), when it is close enough
+ * to be a typo: at most a third of the key's length (at least 1) edits away, ignoring case.
+ */
+function suggestKey(unknown, known) {
+    const limit = Math.max(1, Math.floor(unknown.length / 3));
+    let best;
+    for (const key of known) {
+        const distance = levenshtein(unknown.toLowerCase(), key.toLowerCase());
+        if (distance <= limit && (!best || distance < best.distance))
+            best = { key, distance };
+    }
+    return best === null || best === void 0 ? void 0 : best.key;
+}

package/dist/{voice → config}/index.d.ts

@@ -16,16 +16,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from "./Dial";
-export * from "./Gather";
-export * from "./Mute";
-export * from "./Play";
-export * from "./PlayDtmf";
-export * from "./PlaybackControl";
-export * from "./Record";
-export * from "./Say";
-export * from "./Stream";
-export * from "./StreamGather";
-export * from "./StopSay";
-export * from "./Verb";
-export * from "./voice";
+export * from "./configHints";
+export * from "./integrationsSchema";
+export * from "./interpolateEnv";
+export * from "./loadServiceConfig";
+export * from "./logsSchema";
+export * from "./parseConfigFile";
+export * from "./resolveConfigFile";
+export * from "./resolveSecretRefs";
+export * from "./strictDeep";
+export * from "./telemetrySchema";
+export * from "./natsConnection";
+export * from "./toJsonSchema";