@fonoster/common 0.27.0 → 0.31.0

package/dist/config/resolveSecretRefs.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SECRETS_DIR = exports.SECRET_PREFIX = void 0;
+exports.isSecretRef = isSecretRef;
+exports.resolveSecretRef = resolveSecretRef;
+exports.resolveSecretRefs = resolveSecretRefs;
+/**
+ * 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");
+/**
+ * `secret://` references in config values (add-platform, decision D8). A string value that is
+ * exactly a reference is replaced at startup by the secret it names, so YAML never holds the raw
+ * secret:
+ *
+ *   secret://env/NAME                 the environment variable NAME
+ *   secret://file/<absolute path>     a file's contents (e.g. secret://file/run/secrets/db-url)
+ *   secret://k8s/<secret>#<key>       a Kubernetes Secret mounted as a volume, read from
+ *   secret://k8s/<ns>/<secret>#<key>  <FONOSTER_SECRETS_DIR>/<secret>/<key>
+ *                                     (default /var/run/fonoster/secrets; the Helm chart mounts
+ *                                     every referenced Secret there). The namespace, when given,
+ *                                     must be the pod's (POD_NAMESPACE) if that is known.
+ *
+ * File contents lose one trailing newline. Errors name the key path and the reference, never a
+ * value. Values that only contain `secret://` somewhere else are left alone.
+ */
+exports.SECRET_PREFIX = "secret://";
+exports.DEFAULT_SECRETS_DIR = "/var/run/fonoster/secrets";
+const NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const K8S_NAME = /^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$/;
+const K8S_KEY = /^[-._a-zA-Z0-9]+$/;
+function isSecretRef(value) {
+    return typeof value === "string" && value.startsWith(exports.SECRET_PREFIX);
+}
+function readSecretFile(ref, path, options) {
+    var _a;
+    const read = (_a = options.readFile) !== null && _a !== void 0 ? _a : ((p) => (0, fs_1.readFileSync)(p, { encoding: "utf8" }));
+    try {
+        return read(path).replace(/\r?\n$/, "");
+    }
+    catch (e) {
+        const code = e.code;
+        throw new Error(`${ref}: cannot read ${path}${code ? ` (${code})` : ""}`);
+    }
+}
+/** Resolves one `secret://` reference. Throws with a message that never contains the secret. */
+function resolveSecretRef(ref, options = {}) {
+    var _a, _b, _c;
+    const env = (_a = options.env) !== null && _a !== void 0 ? _a : process.env;
+    const rest = ref.slice(exports.SECRET_PREFIX.length);
+    const slash = rest.indexOf("/");
+    const kind = slash < 0 ? rest : rest.slice(0, slash);
+    const target = slash < 0 ? "" : rest.slice(slash + 1);
+    if (kind === "env") {
+        if (!NAME.test(target))
+            throw new Error(`invalid variable name in ${ref}`);
+        const value = env[target];
+        if (value === undefined || value === "")
+            throw new Error(`${ref}: environment variable ${target} is not set`);
+        return value;
+    }
+    if (kind === "file") {
+        if (!target)
+            throw new Error(`${ref}: missing file path`);
+        const path = (0, path_1.resolve)("/", target);
+        return readSecretFile(ref, path, options);
+    }
+    if (kind === "k8s") {
+        const hash = target.indexOf("#");
+        if (hash < 0)
+            throw new Error(`${ref}: missing #<key>`);
+        const parts = target.slice(0, hash).split("/");
+        const key = target.slice(hash + 1);
+        if (parts.length > 2 || !parts.every((p) => K8S_NAME.test(p)))
+            throw new Error(`${ref}: expected secret://k8s/[<namespace>/]<secret>#<key>`);
+        if (!K8S_KEY.test(key))
+            throw new Error(`${ref}: invalid key`);
+        const [namespace, name] = parts.length === 2 ? parts : [undefined, parts[0]];
+        const podNamespace = env.POD_NAMESPACE;
+        if (namespace && podNamespace && namespace !== podNamespace)
+            throw new Error(`${ref}: Secrets of namespace ${namespace} are not mounted here (${podNamespace})`);
+        const dir = (_c = (_b = options.secretsDir) !== null && _b !== void 0 ? _b : env.FONOSTER_SECRETS_DIR) !== null && _c !== void 0 ? _c : exports.DEFAULT_SECRETS_DIR;
+        const base = (0, path_1.isAbsolute)(dir) ? dir : (0, path_1.resolve)(dir);
+        return readSecretFile(ref, (0, path_1.join)(base, name, key), options);
+    }
+    throw new Error(`unsupported reference ${ref} (use secret://env/NAME, secret://file/<path> or secret://k8s/<secret>#<key>)`);
+}
+function walk(input, options, path) {
+    if (isSecretRef(input)) {
+        try {
+            return resolveSecretRef(input, options);
+        }
+        catch (e) {
+            throw new Error(`${path || "(root)"}: ${e.message}`);
+        }
+    }
+    if (Array.isArray(input))
+        return input.map((item, i) => walk(item, options, `${path}[${i}]`));
+    if (input !== null && typeof input === "object") {
+        return Object.fromEntries(Object.entries(input).map(([k, v]) => [
+            k,
+            walk(v, options, path ? `${path}.${k}` : k)
+        ]));
+    }
+    return input;
+}
+/**
+ * Returns a copy of a parsed config with every `secret://` value resolved. Errors name the key
+ * path (`providers.deepgram.credential.value: secret://env/DG: environment variable DG is not set`).
+ */
+function resolveSecretRefs(input, options = {}) {
+    return walk(input, options, "");
+}

package/dist/{assistants/audioFiltersSchema.d.ts → config/strictDeep.d.ts}

@@ -16,15 +16,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { z } from "zod";
-declare const audioFiltersSchema: z.ZodDefault<z.ZodArray<z.ZodObject<{
-    name: z.ZodString;
-    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    options?: Record<string, unknown>;
-    name?: string;
-}, {
-    options?: Record<string, unknown>;
-    name?: string;
-}>, "many">>;
-export { audioFiltersSchema };
+import { ZodTypeAny } from "zod";
+/**
+ * Returns a copy of `schema` in which every object rejects unknown keys, so a
+ * misspelled config key fails validation instead of being silently dropped.
+ * Objects declared with `.passthrough()` (free-form blocks such as provider
+ * credentials) are left as they are.
+ */
+declare function strictDeep<T extends ZodTypeAny>(schema: T): T;
+export { strictDeep };

package/dist/config/strictDeep.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.strictDeep = strictDeep;
+/**
+ * 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 zod_1 = require("zod");
+/**
+ * Returns a copy of `schema` in which every object rejects unknown keys, so a
+ * misspelled config key fails validation instead of being silently dropped.
+ * Objects declared with `.passthrough()` (free-form blocks such as provider
+ * credentials) are left as they are.
+ */
+function strictDeep(schema) {
+    if (schema instanceof zod_1.ZodObject) {
+        const shape = schema.shape;
+        const strictShape = Object.fromEntries(Object.entries(shape).map(([key, value]) => [key, strictDeep(value)]));
+        const unknownKeys = schema._def.unknownKeys === "passthrough" ? "passthrough" : "strict";
+        return new zod_1.ZodObject(Object.assign(Object.assign({}, schema._def), { shape: () => strictShape, unknownKeys }));
+    }
+    if (schema instanceof zod_1.ZodOptional) {
+        return new zod_1.ZodOptional(Object.assign(Object.assign({}, schema._def), { innerType: strictDeep(schema._def.innerType) }));
+    }
+    if (schema instanceof zod_1.ZodNullable) {
+        return new zod_1.ZodNullable(Object.assign(Object.assign({}, schema._def), { innerType: strictDeep(schema._def.innerType) }));
+    }
+    if (schema instanceof zod_1.ZodDefault) {
+        return new zod_1.ZodDefault(Object.assign(Object.assign({}, schema._def), { innerType: strictDeep(schema._def.innerType) }));
+    }
+    if (schema instanceof zod_1.ZodArray) {
+        return new zod_1.ZodArray(Object.assign(Object.assign({}, schema._def), { type: strictDeep(schema._def.type) }));
+    }
+    if (schema instanceof zod_1.ZodEffects) {
+        return new zod_1.ZodEffects(Object.assign(Object.assign({}, schema._def), { schema: strictDeep(schema._def.schema) }));
+    }
+    if (schema instanceof zod_1.ZodUnion) {
+        return new zod_1.ZodUnion(Object.assign(Object.assign({}, schema._def), { options: schema._def.options.map((option) => strictDeep(option)) }));
+    }
+    if (schema instanceof zod_1.ZodRecord) {
+        return new zod_1.ZodRecord(Object.assign(Object.assign({}, schema._def), { valueType: strictDeep(schema._def.valueType) }));
+    }
+    return schema;
+}

package/dist/config/telemetrySchema.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.
+ */
+import { z } from "zod";
+/**
+ * The `telemetry` section shared by every Fonoster service's config file
+ * (unify-config-placeholders): the OTLP/HTTP endpoint telemetry goes to. Empty or absent means
+ * off, unless the container environment sets `OTEL_EXPORTER_OTLP_ENDPOINT`.
+ */
+declare const telemetrySchema: z.ZodOptional<z.ZodObject<{
+    /** Usually `"${OTEL_EXPORTER_OTLP_ENDPOINT:-}"`, e.g. http://otel-collector:4318. */
+    otlpEndpoint: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    otlpEndpoint?: string;
+}, {
+    otlpEndpoint?: string;
+}>>;
+type TelemetryConfig = z.infer<typeof telemetrySchema>;
+/**
+ * The environment `initTelemetry` reads, with the config's endpoint (when set) in
+ * `OTEL_EXPORTER_OTLP_ENDPOINT`.
+ */
+declare function telemetryEnv(config: TelemetryConfig, env?: Record<string, string | undefined>): Record<string, string | undefined>;
+export { telemetrySchema, telemetryEnv, TelemetryConfig };

package/dist/config/telemetrySchema.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.telemetrySchema = void 0;
+exports.telemetryEnv = telemetryEnv;
+/**
+ * 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 zod_1 = require("zod");
+/**
+ * The `telemetry` section shared by every Fonoster service's config file
+ * (unify-config-placeholders): the OTLP/HTTP endpoint telemetry goes to. Empty or absent means
+ * off, unless the container environment sets `OTEL_EXPORTER_OTLP_ENDPOINT`.
+ */
+const telemetrySchema = zod_1.z
+    .object({
+    /** Usually `"${OTEL_EXPORTER_OTLP_ENDPOINT:-}"`, e.g. http://otel-collector:4318. */
+    otlpEndpoint: zod_1.z.string().optional()
+})
+    .optional();
+exports.telemetrySchema = telemetrySchema;
+/**
+ * The environment `initTelemetry` reads, with the config's endpoint (when set) in
+ * `OTEL_EXPORTER_OTLP_ENDPOINT`.
+ */
+function telemetryEnv(config, env = process.env) {
+    var _a;
+    const endpoint = (_a = config === null || config === void 0 ? void 0 : config.otlpEndpoint) === null || _a === void 0 ? void 0 : _a.trim();
+    return endpoint ? Object.assign(Object.assign({}, env), { OTEL_EXPORTER_OTLP_ENDPOINT: endpoint }) : env;
+}

package/dist/config/toJsonSchema.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+import { ZodTypeAny } from "zod";
+export type JsonSchema = Record<string, unknown>;
+/**
+ * The JSON Schema (draft 2020-12) of a service config schema. Unknown keys are rejected
+ * (`additionalProperties: false`) wherever the service rejects them: every object, as
+ * `strictDeep` makes them, except `.passthrough()` blocks.
+ */
+declare function toJsonSchema(schema: ZodTypeAny, options?: {
+    id?: string;
+    title?: string;
+}): JsonSchema;
+export { toJsonSchema };

package/dist/config/toJsonSchema.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toJsonSchema = toJsonSchema;
+/**
+ * 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 zod_1 = require("zod");
+const strictDeep_1 = require("./strictDeep");
+function stringSchema(checks) {
+    const out = { type: "string" };
+    for (const c of checks) {
+        if (c.kind === "min")
+            out.minLength = c.value;
+        else if (c.kind === "max")
+            out.maxLength = c.value;
+        else if (c.kind === "length")
+            out.minLength = out.maxLength = c.value;
+        else if (c.kind === "regex")
+            out.pattern = c.regex.source;
+        else if (c.kind === "url")
+            out.format = "uri";
+        else if (c.kind === "email")
+            out.format = "email";
+    }
+    return out;
+}
+function numberSchema(checks) {
+    const out = { type: "number" };
+    for (const c of checks) {
+        if (c.kind === "int")
+            out.type = "integer";
+        else if (c.kind === "min")
+            out[c.inclusive ? "minimum" : "exclusiveMinimum"] = c.value;
+        else if (c.kind === "max")
+            out[c.inclusive ? "maximum" : "exclusiveMaximum"] = c.value;
+        else if (c.kind === "multipleOf")
+            out.multipleOf = c.value;
+    }
+    return out;
+}
+/** Whether an object key may be left out of the input (optional, or has a default). */
+function isOptionalInput(schema) {
+    const kind = schema._def.typeName;
+    if (kind === zod_1.ZodFirstPartyTypeKind.ZodOptional ||
+        kind === zod_1.ZodFirstPartyTypeKind.ZodDefault)
+        return true;
+    if (kind === zod_1.ZodFirstPartyTypeKind.ZodEffects)
+        return isOptionalInput(schema._def.schema);
+    if (kind === zod_1.ZodFirstPartyTypeKind.ZodNullable)
+        return isOptionalInput(schema._def.innerType);
+    if (kind === zod_1.ZodFirstPartyTypeKind.ZodAny ||
+        kind === zod_1.ZodFirstPartyTypeKind.ZodUnknown)
+        return true;
+    return false;
+}
+function convert(schema, path) {
+    const def = schema._def;
+    const description = schema.description
+        ? { description: schema.description }
+        : {};
+    switch (def.typeName) {
+        case zod_1.ZodFirstPartyTypeKind.ZodString:
+            return Object.assign(Object.assign({}, stringSchema(def.checks)), description);
+        case zod_1.ZodFirstPartyTypeKind.ZodNumber:
+            return Object.assign(Object.assign({}, numberSchema(def.checks)), description);
+        case zod_1.ZodFirstPartyTypeKind.ZodBoolean:
+            return Object.assign({ type: "boolean" }, description);
+        case zod_1.ZodFirstPartyTypeKind.ZodLiteral:
+            return Object.assign({ const: def.value }, description);
+        case zod_1.ZodFirstPartyTypeKind.ZodEnum:
+            return Object.assign({ type: "string", enum: [...def.values] }, description);
+        case zod_1.ZodFirstPartyTypeKind.ZodAny:
+        case zod_1.ZodFirstPartyTypeKind.ZodUnknown:
+            return Object.assign({}, description);
+        case zod_1.ZodFirstPartyTypeKind.ZodNull:
+            return { type: "null" };
+        case zod_1.ZodFirstPartyTypeKind.ZodObject: {
+            const shape = def.shape();
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = convert(value, path ? `${path}.${key}` : key);
+                if (!isOptionalInput(value))
+                    required.push(key);
+            }
+            const catchall = def.catchall;
+            const hasCatchall = catchall && catchall._def.typeName !== zod_1.ZodFirstPartyTypeKind.ZodNever;
+            return Object.assign(Object.assign(Object.assign({ type: "object", properties }, (required.length ? { required } : {})), { additionalProperties: hasCatchall
+                    ? convert(catchall, `${path}.*`)
+                    : def.unknownKeys !== "strict" }), description);
+        }
+        case zod_1.ZodFirstPartyTypeKind.ZodArray: {
+            const out = Object.assign({ type: "array", items: convert(def.type, `${path}[]`) }, description);
+            if (def.minLength)
+                out.minItems = def.minLength.value;
+            if (def.maxLength)
+                out.maxItems = def.maxLength.value;
+            if (def.exactLength)
+                out.minItems = out.maxItems = def.exactLength.value;
+            return out;
+        }
+        case zod_1.ZodFirstPartyTypeKind.ZodRecord:
+            return Object.assign({ type: "object", additionalProperties: convert(def.valueType, `${path}.*`) }, description);
+        case zod_1.ZodFirstPartyTypeKind.ZodUnion:
+        case zod_1.ZodFirstPartyTypeKind.ZodDiscriminatedUnion: {
+            const options = Array.isArray(def.options)
+                ? def.options
+                : [...def.options.values()];
+            return Object.assign({ anyOf: options.map((o, i) => convert(o, `${path}|${i}`)) }, description);
+        }
+        case zod_1.ZodFirstPartyTypeKind.ZodOptional:
+            return Object.assign(Object.assign({}, convert(def.innerType, path)), description);
+        case zod_1.ZodFirstPartyTypeKind.ZodNullable:
+            return Object.assign({ anyOf: [convert(def.innerType, path), { type: "null" }] }, description);
+        case zod_1.ZodFirstPartyTypeKind.ZodDefault: {
+            const inner = convert(def.innerType, path);
+            // Object defaults such as `{}` are filled in by the inner schema; only scalars are shown.
+            const value = def.defaultValue();
+            return Object.assign(Object.assign(Object.assign({}, inner), (value === null || typeof value !== "object"
+                ? { default: value }
+                : {})), description);
+        }
+        case zod_1.ZodFirstPartyTypeKind.ZodEffects:
+            return Object.assign(Object.assign({}, convert(def.schema, path)), description);
+        case zod_1.ZodFirstPartyTypeKind.ZodBranded:
+            return convert(def.type, path);
+        case zod_1.ZodFirstPartyTypeKind.ZodCatch:
+            return convert(def.innerType, path);
+        case zod_1.ZodFirstPartyTypeKind.ZodReadonly:
+            return convert(def.innerType, path);
+        case zod_1.ZodFirstPartyTypeKind.ZodPipeline:
+            return convert(def.in, path);
+        case zod_1.ZodFirstPartyTypeKind.ZodLazy:
+            return convert(def.getter(), path);
+        default:
+            throw new Error(`toJsonSchema: unsupported Zod type ${def.typeName} at ${path || "(root)"}`);
+    }
+}
+/**
+ * The JSON Schema (draft 2020-12) of a service config schema. Unknown keys are rejected
+ * (`additionalProperties: false`) wherever the service rejects them: every object, as
+ * `strictDeep` makes them, except `.passthrough()` blocks.
+ */
+function toJsonSchema(schema, options = {}) {
+    return Object.assign(Object.assign(Object.assign({ $schema: "https://json-schema.org/draft/2020-12/schema" }, (options.id ? { $id: options.id } : {})), (options.title ? { title: options.title } : {})), convert((0, strictDeep_1.strictDeep)(schema), ""));
+}

package/dist/constants.d.ts

@@ -19,13 +19,8 @@
 import { ServingStatus } from "grpc-health-check";
 export declare const GRPC_NOT_SERVING_STATUS: ServingStatus;
 export declare const GRPC_SERVING_STATUS: ServingStatus;
-export declare const STASIS_APP_NAME = "mediacontroller";
-export declare const CALL_CONTEXT = "local-ctx-common";
-export declare const CALL_EXTENSION = "start";
-export declare const CALL_DETAIL_RECORD_MEASUREMENT = "cdr";
-export declare const INFLUXDB_CALLS_BUCKET = "calls";
 export declare const APP_REF_HEADER = "x-app-ref";
-export declare const ROUTR_DEFAULT_PEER_AOR = "sip:voice@default";
+export declare const ROUTR_DEFAULT_PEER_AOR = "sip:roomr@default";
 export declare const AUTOPILOT_SPECIAL_LOCAL_ADDRESS = "autopilot.fonoster.local";
 export declare const AUTOPILOT_INTERNAL_ADDRESS = "autopilot:50061";
 export declare const WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = "welcome.demo.fonoster.local";

package/dist/constants.js

@@ -1,15 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = exports.AUTOPILOT_INTERNAL_ADDRESS = exports.AUTOPILOT_SPECIAL_LOCAL_ADDRESS = exports.ROUTR_DEFAULT_PEER_AOR = exports.APP_REF_HEADER = exports.INFLUXDB_CALLS_BUCKET = exports.CALL_DETAIL_RECORD_MEASUREMENT = exports.CALL_EXTENSION = exports.CALL_CONTEXT = exports.STASIS_APP_NAME = exports.GRPC_SERVING_STATUS = exports.GRPC_NOT_SERVING_STATUS = void 0;
+exports.WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = exports.AUTOPILOT_INTERNAL_ADDRESS = exports.AUTOPILOT_SPECIAL_LOCAL_ADDRESS = exports.ROUTR_DEFAULT_PEER_AOR = exports.APP_REF_HEADER = exports.GRPC_SERVING_STATUS = exports.GRPC_NOT_SERVING_STATUS = void 0;
 exports.GRPC_NOT_SERVING_STATUS = "NOT_SERVING";
 exports.GRPC_SERVING_STATUS = "SERVING";
-exports.STASIS_APP_NAME = "mediacontroller";
-exports.CALL_CONTEXT = "local-ctx-common";
-exports.CALL_EXTENSION = "start";
-exports.CALL_DETAIL_RECORD_MEASUREMENT = "cdr";
-exports.INFLUXDB_CALLS_BUCKET = "calls";
 exports.APP_REF_HEADER = "x-app-ref";
-exports.ROUTR_DEFAULT_PEER_AOR = "sip:voice@default";
+// The peer app-linked numbers point at: the Go Roomr nodes (least-sessions). Asterisk's
+// sip:voice@default is gone (cleanbreak CB-B3).
+exports.ROUTR_DEFAULT_PEER_AOR = "sip:roomr@default";
 exports.AUTOPILOT_SPECIAL_LOCAL_ADDRESS = "autopilot.fonoster.local";
 exports.AUTOPILOT_INTERNAL_ADDRESS = "autopilot:50061";
 exports.WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = "welcome.demo.fonoster.local";

package/dist/envs.d.ts

@@ -1 +1,2 @@
-export declare const ROOT_DOMAIN: string;
+export declare const setRootDomain: (domain: string) => void;
+export declare const getRootDomain: () => string;

package/dist/envs.js

@@ -1,9 +1,6 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROOT_DOMAIN = void 0;
+exports.getRootDomain = exports.setRootDomain = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -22,10 +19,15 @@ exports.ROOT_DOMAIN = void 0;
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const path_1 = require("path");
-const dotenv_1 = __importDefault(require("dotenv"));
-if (process.env.NODE_ENV === "development") {
-    dotenv_1.default.config({ path: (0, path_1.join)(__dirname, "..", "..", "..", ".env") });
-}
-const e = process.env;
-exports.ROOT_DOMAIN = e.APISERVER_ROOT_DOMAIN || e.ROOT_DOMAIN || "fonoster.local";
+/**
+ * Root SIP domain that workspace domains must end with. The API server sets it
+ * from fonoster.yaml's `domain` at boot (setRootDomain); nothing reads it from
+ * the environment or a .env file (fix-config-and-placement-gaps).
+ */
+let rootDomain = "fonoster.local";
+const setRootDomain = (domain) => {
+    rootDomain = domain;
+};
+exports.setRootDomain = setRootDomain;
+const getRootDomain = () => rootDomain;
+exports.getRootDomain = getRootDomain;

package/dist/errors/handleZodError.js

@@ -25,7 +25,9 @@ const zod_validation_error_1 = require("zod-validation-error");
 const logger = (0, logger_1.getLogger)({ service: "apiserver", filePath: __filename });
 function handleZodError(error, callback) {
     if ((error === null || error === void 0 ? void 0 : error.issues[0].code) === "custom") {
-        const message = error === null || error === void 0 ? void 0 : error.issues[0].message;
+        // Named like the other validation errors, so the caller knows which field is at fault.
+        const { message: text, path } = error.issues[0];
+        const message = path.length ? `${text} at "${path.join(".")}"` : text;
         logger.error("custom validation error", { message });
         callback({ code: grpc_js_1.status.INVALID_ARGUMENT, message });
     }

package/dist/filters/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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.
+ */
+import { z } from "zod";
+/**
+ * The audio filters an app may configure (voice-session, "An app's audio filters are set through
+ * the Applications API"). Apps are untrusted input, so each filter exposes a public option schema
+ * here, shared by the apiserver (validation on write) and the appbridge (the filter factory).
+ * Anything that touches the media server's filesystem, environment or credentials stays out.
+ */
+export declare const AI_COUSTICS_FILTER = "aiCoustics";
+/** The ai-coustics filter's public options. */
+export declare const aiCousticsPublicOptionsSchema: z.ZodObject<{
+    model: z.ZodDefault<z.ZodString>;
+    enhancementLevel: z.ZodDefault<z.ZodNumber>;
+    bypass: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    model?: string;
+    enhancementLevel?: number;
+    bypass?: boolean;
+}, {
+    model?: string;
+    enhancementLevel?: number;
+    bypass?: boolean;
+}>;
+/** Public option schemas by filter name. */
+export declare const FILTER_SCHEMAS: Record<string, z.ZodObject<z.ZodRawShape>>;
+/** The filter a noise-cancelling (`nc`) provider runs, by provider id. */
+export declare const FILTER_BY_PROVIDER: Record<string, string>;
+export declare const FILTER_NAMES: string[];
+/** The `nc` provider whose credential a filter runs with, or undefined for a filter without one. */
+export declare function providerOfFilter(name: string): string | undefined;
+export type AudioFilterConfig = {
+    name: string;
+    options?: Record<string, unknown>;
+};
+export declare const audioFilterConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    options?: Record<string, unknown>;
+    name?: string;
+}, {
+    options?: Record<string, unknown>;
+    name?: string;
+}>;
+export declare class AudioFilterConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates an app's `filters` list: known names and public options only. Returns the list with
+ * each filter's options as given (defaults are applied by the filter itself). Throws
+ * AudioFilterConfigError naming the first offending filter or option.
+ */
+export declare function parseFilters(input: unknown): AudioFilterConfig[];