@fonoster/ctl 0.27.0 → 0.30.0

package/dist/utils/applicationFlags.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applicationFlags = void 0;
+/**
+ * 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 core_1 = require("@oclif/core");
+/** Flags shared by `applications:create` and `applications:update` (a stream or an Autopilot agent). */
+exports.applicationFlags = {
+    "from-file": core_1.Flags.string({
+        char: "f",
+        description: "a YAML or JSON file with the Application (an `assistant` key makes it an Autopilot agent)"
+    }),
+    name: core_1.Flags.string({ char: "n", description: "the Application name" }),
+    url: core_1.Flags.string({
+        char: "u",
+        description: "the stream's WebSocket URL (ws:// or wss://)"
+    }),
+    protocol: core_1.Flags.string({
+        description: "the protocol the stream speaks",
+        options: ["fonoster", "twilio"]
+    }),
+    agent: core_1.Flags.string({
+        char: "a",
+        description: "a YAML or JSON agent file; makes it an Autopilot agent (hosted by Fonoster)"
+    }),
+    // Renamed in 0.30; kept hidden so old scripts get a clear error.
+    flavor: core_1.Flags.string({ hidden: true }),
+    assistant: core_1.Flags.string({ hidden: true }),
+    voice: core_1.Flags.string({
+        description: "TTS voice as a catalog id (e.g. deepgram/aura-2-thalia-en)"
+    }),
+    language: core_1.Flags.string({ description: "speech language (e.g. en-US)" }),
+    "stt-model": core_1.Flags.string({
+        description: "STT model as a catalog id (e.g. deepgram/nova-3)"
+    }),
+    "tts-model": core_1.Flags.string({
+        description: "TTS model as a catalog id (e.g. elevenlabs/eleven_flash_v2_5)"
+    }),
+    "silence-timeout": core_1.Flags.integer({
+        description: "milliseconds of caller silence before a silence event"
+    }),
+    patience: core_1.Flags.string({
+        description: "how long to wait before taking the turn",
+        options: ["low", "normal", "high"]
+    }),
+    "audio-codec": core_1.Flags.string({
+        description: "audio frames for fonoster-protocol streams",
+        options: ["pcm16", "pcmu"]
+    }),
+    "audio-rate": core_1.Flags.integer({
+        description: "audio sample rate for fonoster-protocol streams: 8000, 16000 or 24000 (pcmu is 8000 only)"
+    }),
+    "fallback-app": core_1.Flags.string({
+        description: "the Application to hand the call to when this one fails"
+    }),
+    "fallback-message": core_1.Flags.string({
+        description: "what the caller hears when the app fails and no fallback app answers"
+    }),
+    listener: core_1.Flags.string({
+        char: "l",
+        description: "a listen-only socket: <wss-url>[,inbound|outbound|both] (repeatable, at most 4)",
+        multiple: true
+    }),
+    "clear-listeners": core_1.Flags.boolean({
+        description: "remove the current listeners (update; combine with --listener to replace)",
+        default: false
+    }),
+    recording: core_1.Flags.string({
+        description: "the recording policy",
+        options: ["off", "on", "consent"]
+    }),
+    amd: core_1.Flags.boolean({
+        description: "answering-machine detection: the app gets one amd.result per call (--no-amd turns it off)",
+        allowNo: true
+    }),
+    "amd-window": core_1.Flags.integer({
+        description: "milliseconds of caller audio AMD classifies (500 to 15000, default 4000); implies --amd"
+    })
+};

package/dist/utils/applicationRequest.d.ts

@@ -0,0 +1,43 @@
+import { Application, AppListener, CreateApplicationRequest } from "@fonoster/types";
+type ApplicationFlags = {
+    name?: string;
+    url?: string;
+    protocol?: string;
+    agent?: string;
+    /** Renamed flags (0.30): rejected with a clear error. */
+    flavor?: string;
+    assistant?: string;
+    voice?: string;
+    language?: string;
+    "stt-model"?: string;
+    "tts-model"?: string;
+    "silence-timeout"?: number;
+    patience?: string;
+    "audio-codec"?: string;
+    "audio-rate"?: number;
+    "fallback-app"?: string;
+    "fallback-message"?: string;
+    listener?: string[];
+    "clear-listeners"?: boolean;
+    recording?: string;
+    amd?: boolean;
+    "amd-window"?: number;
+};
+type AppRequest = CreateApplicationRequest & {
+    ref?: string;
+};
+/** Reads a YAML or JSON file into an object. */
+declare function readConfigFile<T = Record<string, unknown>>(filePath: string): T;
+/** `wss://host/path` or `wss://host/path,inbound` (tracks: inbound, outbound or both). */
+declare function parseListener(value: string): AppListener;
+/** An existing app as a create/update request (blank fields dropped). */
+declare function applicationToRequest(app: Application): AppRequest;
+/** A file in the new app model; `assistant` (inline) makes it an Autopilot agent. */
+declare function fileToRequest(raw: Record<string, unknown>): AppRequest;
+/**
+ * Applies command flags on top of `base` (the current app on update, `{}` on create).
+ */
+declare function applyFlags(base: AppRequest, flags: ApplicationFlags): AppRequest;
+/** Throws the errors the control plane would, before a round trip. */
+declare function checkRequest(request: AppRequest): void;
+export { AppRequest, ApplicationFlags, applicationToRequest, applyFlags, checkRequest, fileToRequest, parseListener, readConfigFile };

package/dist/utils/applicationRequest.js

@@ -0,0 +1,209 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applicationToRequest = applicationToRequest;
+exports.applyFlags = applyFlags;
+exports.checkRequest = checkRequest;
+exports.fileToRequest = fileToRequest;
+exports.parseListener = parseListener;
+exports.readConfigFile = readConfigFile;
+/**
+ * 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 = __importDefault(require("path"));
+const js_yaml_1 = require("js-yaml");
+const TRACKS = ["inbound", "outbound", "both"];
+/** Reads a YAML or JSON file into an object. */
+function readConfigFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, "utf8");
+    const ext = path_1.default.extname(filePath).toLowerCase();
+    if (ext === ".yaml" || ext === ".yml")
+        return (0, js_yaml_1.load)(content);
+    if (ext === ".json")
+        return JSON.parse(content);
+    throw new Error("Unsupported file format. Please use YAML or JSON files.");
+}
+/** `wss://host/path` or `wss://host/path,inbound` (tracks: inbound, outbound or both). */
+function parseListener(value) {
+    const comma = value.lastIndexOf(",");
+    const tail = comma > 0 ? value.slice(comma + 1).trim() : "";
+    if (comma > 0 && TRACKS.includes(tail)) {
+        return {
+            url: value.slice(0, comma).trim(),
+            tracks: tail
+        };
+    }
+    if (comma > 0 && tail && !tail.includes("/")) {
+        throw new Error(`invalid listener tracks "${tail}" (use inbound, outbound or both)`);
+    }
+    return { url: value.trim(), tracks: "both" };
+}
+function blank(value) {
+    return value === "" || value === 0 || value === null || value === undefined;
+}
+function compact(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => !blank(v)));
+}
+/** The LLM product the control plane files the assistant under (`llm.<provider>`). */
+function intelligenceFor(assistant) {
+    var _a;
+    const model = (_a = assistant.languageModel) === null || _a === void 0 ? void 0 : _a.model;
+    return {
+        productRef: (model === null || model === void 0 ? void 0 : model.includes("/")) ? `llm.${model.split("/")[0]}` : "",
+        config: assistant
+    };
+}
+/** An existing app as a create/update request (blank fields dropped). */
+function applicationToRequest(app) {
+    var _a, _b, _c, _d, _e;
+    const request = {
+        name: app.name,
+        type: app.type,
+        protocol: (app.protocol || undefined),
+        speech: compact(Object.assign({}, ((_a = app.speech) !== null && _a !== void 0 ? _a : {}))),
+        audio: ((_b = app.audio) === null || _b === void 0 ? void 0 : _b.codec) ? app.audio : undefined,
+        fallbackAppRef: app.fallbackAppRef || undefined,
+        fallbackMessage: app.fallbackMessage || undefined,
+        listeners: (_c = app.listeners) !== null && _c !== void 0 ? _c : [],
+        recording: (app.recording || undefined),
+        amd: ((_d = app.amd) === null || _d === void 0 ? void 0 : _d.enabled)
+            ? compact({ enabled: true, windowMs: app.amd.windowMs })
+            : undefined
+    };
+    // Autopilot apps follow the operator's hosted Autopilot URL; only streams carry theirs.
+    if (app.type !== "AUTOPILOT")
+        request.url = app.url || app.endpoint;
+    const config = (_e = app.intelligence) === null || _e === void 0 ? void 0 : _e.config;
+    if (app.type === "AUTOPILOT" && config && Object.keys(config).length) {
+        request.intelligence = intelligenceFor(config);
+    }
+    return compact(request);
+}
+/** A file in the new app model; `assistant` (inline) makes it an Autopilot agent. */
+function fileToRequest(raw) {
+    var _a, _b;
+    if (raw.flavor !== undefined)
+        throw new Error("`flavor` was renamed to `protocol` (fonoster or twilio; native is now fonoster)");
+    if (raw.type === "EXTERNAL")
+        throw new Error("type EXTERNAL was renamed to STREAM");
+    const _c = raw, { assistant } = _c, rest = __rest(_c, ["assistant"]);
+    const request = Object.assign({}, rest);
+    // Test cases belong to applications:eval, not to the app.
+    delete request.testCases;
+    if (assistant) {
+        request.type = "AUTOPILOT";
+        request.intelligence = intelligenceFor(assistant);
+    }
+    // Never send a model key that sits in an agent file; keys live in the vendor keys.
+    const lm = (_b = (_a = request.intelligence) === null || _a === void 0 ? void 0 : _a.config) === null || _b === void 0 ? void 0 : _b.languageModel;
+    if (lm)
+        delete lm.apiKey;
+    return request;
+}
+/**
+ * Applies command flags on top of `base` (the current app on update, `{}` on create).
+ */
+function applyFlags(base, flags) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const request = Object.assign(Object.assign({}, base), { speech: Object.assign({}, ((_a = base.speech) !== null && _a !== void 0 ? _a : {})), listeners: [...((_b = base.listeners) !== null && _b !== void 0 ? _b : [])] });
+    if (flags.assistant !== undefined)
+        throw new Error("--assistant was renamed to --agent");
+    if (flags.flavor !== undefined)
+        throw new Error("--flavor was renamed to --protocol (fonoster or twilio; native is now fonoster)");
+    if (flags.name !== undefined)
+        request.name = flags.name;
+    if (flags.agent) {
+        const assistant = readConfigFile(flags.agent);
+        request.type = "AUTOPILOT";
+        request.intelligence = fileToRequest({ assistant }).intelligence;
+    }
+    if (flags.url !== undefined)
+        request.url = flags.url;
+    if (flags.protocol !== undefined)
+        request.protocol = flags.protocol;
+    const speech = request.speech;
+    if (flags.voice !== undefined)
+        speech.voice = flags.voice;
+    if (flags.language !== undefined)
+        speech.language = flags.language;
+    if (flags["stt-model"] !== undefined)
+        speech.sttModel = flags["stt-model"];
+    if (flags["tts-model"] !== undefined)
+        speech.ttsModel = flags["tts-model"];
+    if (flags["silence-timeout"] !== undefined)
+        speech.silenceTimeoutMs = flags["silence-timeout"];
+    if (flags.patience !== undefined)
+        speech.patience = flags.patience;
+    if (flags["audio-codec"] !== undefined || flags["audio-rate"] !== undefined) {
+        const codec = ((_e = (_c = flags["audio-codec"]) !== null && _c !== void 0 ? _c : (_d = request.audio) === null || _d === void 0 ? void 0 : _d.codec) !== null && _e !== void 0 ? _e : "pcm16");
+        const rate = (_f = flags["audio-rate"]) !== null && _f !== void 0 ? _f : (codec === "pcmu" ? 8000 : ((_h = (_g = request.audio) === null || _g === void 0 ? void 0 : _g.rate) !== null && _h !== void 0 ? _h : 16000));
+        request.audio = { codec, rate };
+    }
+    if (flags["fallback-app"] !== undefined)
+        request.fallbackAppRef = flags["fallback-app"];
+    if (flags["fallback-message"] !== undefined)
+        request.fallbackMessage = flags["fallback-message"];
+    if (flags["clear-listeners"])
+        request.listeners = [];
+    if ((_j = flags.listener) === null || _j === void 0 ? void 0 : _j.length) {
+        request.listeners = [
+            ...((_k = request.listeners) !== null && _k !== void 0 ? _k : []),
+            ...flags.listener.map(parseListener)
+        ];
+    }
+    if (flags.recording !== undefined)
+        request.recording = flags.recording;
+    if (flags.amd === false)
+        request.amd = undefined;
+    else if (flags.amd || flags["amd-window"] !== undefined) {
+        const windowMs = (_l = flags["amd-window"]) !== null && _l !== void 0 ? _l : (_m = request.amd) === null || _m === void 0 ? void 0 : _m.windowMs;
+        request.amd = windowMs ? { enabled: true, windowMs } : { enabled: true };
+    }
+    if (!request.type)
+        request.type = "STREAM";
+    return request;
+}
+/** Throws the errors the control plane would, before a round trip. */
+function checkRequest(request) {
+    var _a;
+    if (!request.name)
+        throw new Error("a name is required (--name)");
+    if (request.type === "AUTOPILOT") {
+        if (!((_a = request.intelligence) === null || _a === void 0 ? void 0 : _a.config))
+            throw new Error("an Autopilot agent needs an agent file (--agent)");
+        if (request.protocol && request.protocol !== "fonoster")
+            throw new Error("Autopilot agents use the fonoster protocol");
+    }
+    else if (!request.url) {
+        throw new Error("a url is required (--url ws:// or wss://)");
+    }
+}

package/dist/utils/createOrUpdateApplication.d.ts

@@ -1,2 +1,27 @@
+/**
+ * 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 * as SDK from "@fonoster/sdk";
-export declare function createOrUpdateApplication(client: SDK.Client, filePath: string, appRef?: string, isUpdate?: boolean): Promise<import("@fonoster/types").BaseApiObject>;
+import { CreateApplicationResponse } from "@fonoster/types";
+import { ApplicationFlags } from "./applicationRequest";
+/**
+ * Creates an app, or updates one, from an optional YAML/JSON file in the app model plus flags.
+ * An update starts from the current app (the control plane replaces the whole app), then the
+ * file, then the flags.
+ */
+export declare function createOrUpdateApplication(client: SDK.Client, filePath?: string, appRef?: string, isUpdate?: boolean, flags?: ApplicationFlags): Promise<CreateApplicationResponse>;

package/dist/utils/createOrUpdateApplication.js

@@ -41,9 +41,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOrUpdateApplication = createOrUpdateApplication;
 /**
@@ -64,39 +61,38 @@ exports.createOrUpdateApplication = createOrUpdateApplication;
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const fs_1 = require("fs");
-const path_1 = __importDefault(require("path"));
 const SDK = __importStar(require("@fonoster/sdk"));
-const js_yaml_1 = require("js-yaml");
+const applicationRequest_1 = require("./applicationRequest");
+/**
+ * Creates an app, or updates one, from an optional YAML/JSON file in the app model plus flags.
+ * An update starts from the current app (the control plane replaces the whole app), then the
+ * file, then the flags.
+ */
 function createOrUpdateApplication(client_1, filePath_1, appRef_1) {
-    return __awaiter(this, arguments, void 0, function* (client, filePath, appRef, isUpdate = false) {
-        var _a, _b, _c;
-        const fileContent = (0, fs_1.readFileSync)(filePath, "utf8");
-        const fileExt = path_1.default.extname(filePath).toLowerCase();
-        let config;
-        if (fileExt === ".yaml" || fileExt === ".yml") {
-            config = (0, js_yaml_1.load)(fileContent);
-        }
-        else if (fileExt === ".json") {
-            config = JSON.parse(fileContent);
-        }
-        else {
-            throw new Error("Unsupported file format. Please use YAML or JSON files.");
-        }
+    return __awaiter(this, arguments, void 0, function* (client, filePath, appRef, isUpdate = false, flags = {}) {
+        var _a, _b;
+        const fromFile = filePath
+            ? (0, applicationRequest_1.fileToRequest)((0, applicationRequest_1.readConfigFile)(filePath))
+            : {};
         const applications = new SDK.Applications(client);
-        delete config.testCases;
-        (_c = (_b = (_a = config.intelligence) === null || _a === void 0 ? void 0 : _a.config) === null || _b === void 0 ? void 0 : _b.languageModel) === null || _c === void 0 ? true : delete _c.apiKey;
         if (isUpdate) {
             // The positional appRef takes precedence over any `ref` in the file; fall
             // back to the file's `ref` when the positional is omitted.
-            const ref = appRef !== null && appRef !== void 0 ? appRef : config.ref;
+            const ref = appRef !== null && appRef !== void 0 ? appRef : fromFile.ref;
             if (!ref) {
                 throw new Error("An Application ref is required to update. Provide it as the positional argument or include `ref` in the file.");
             }
-            delete config.ref;
-            const updateConfig = Object.assign(Object.assign({}, config), { ref });
-            return applications.updateApplication(updateConfig);
+            const current = (0, applicationRequest_1.applicationToRequest)(yield applications.getApplication(ref));
+            const merged = Object.assign(Object.assign(Object.assign({}, current), fromFile), { speech: Object.assign(Object.assign({}, ((_a = current.speech) !== null && _a !== void 0 ? _a : {})), ((_b = fromFile.speech) !== null && _b !== void 0 ? _b : {})) });
+            delete merged.ref;
+            const request = (0, applicationRequest_1.applyFlags)(merged, flags);
+            (0, applicationRequest_1.checkRequest)(request);
+            const updateRequest = Object.assign(Object.assign({}, request), { ref });
+            return applications.updateApplication(updateRequest);
         }
-        return applications.createApplication(config);
+        delete fromFile.ref;
+        const request = (0, applicationRequest_1.applyFlags)(fromFile, flags);
+        (0, applicationRequest_1.checkRequest)(request);
+        return applications.createApplication(request);
     });
 }

package/dist/utils/format.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+/** ISO time without milliseconds, or "-" when absent. */
+export declare const formatDate: (value?: Date | string | null) => string;

package/dist/utils/format.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = void 0;
+/**
+ * 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.
+ */
+/** ISO time without milliseconds, or "-" when absent. */
+const formatDate = (value) => {
+    if (!value)
+        return "-";
+    const date = new Date(value);
+    return isNaN(date.getTime())
+        ? "-"
+        : date.toISOString().replace(/\.\d{3}Z$/, "Z");
+};
+exports.formatDate = formatDate;

package/dist/utils/index.d.ts

@@ -26,3 +26,4 @@ export * from "./getTwilioTrunk";
 export * from "./linkTwilioNumberToApplication";
 export * from "./types";
 export * from "./createOrUpdateApplication";
+export * from "./applicationRequest";

package/dist/utils/index.js

@@ -42,3 +42,4 @@ __exportStar(require("./getTwilioTrunk"), exports);
 __exportStar(require("./linkTwilioNumberToApplication"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./createOrUpdateApplication"), exports);
+__exportStar(require("./applicationRequest"), exports);

package/dist/utils/trackCallStatus.d.ts

@@ -0,0 +1,4 @@
+/** Prints each dial status until a final one (or the stream ends); returns the last status. */
+export declare function trackCallStatus(statusStream: AsyncIterable<{
+    status: string;
+}>, log: (message: string) => void): Promise<string | undefined>;

package/dist/utils/trackCallStatus.js

@@ -0,0 +1,67 @@
+"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());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackCallStatus = trackCallStatus;
+/**
+ * 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.
+ */
+// The dial ends at one of these; the stream may stay open a moment after (the server closes it).
+const FINAL = ["ANSWER", "BUSY", "CANCEL", "FAILED", "NOANSWER", "ERROR"];
+/** Prints each dial status until a final one (or the stream ends); returns the last status. */
+function trackCallStatus(statusStream, log) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, statusStream_1, statusStream_1_1;
+        var _b, e_1, _c, _d;
+        let last;
+        try {
+            // eslint-disable-next-line no-loops/no-loops
+            for (_a = true, statusStream_1 = __asyncValues(statusStream); statusStream_1_1 = yield statusStream_1.next(), _b = statusStream_1_1.done, !_b; _a = true) {
+                _d = statusStream_1_1.value;
+                _a = false;
+                const entry = _d;
+                last = entry.status;
+                log(`Call status: ${entry.status}`);
+                if (FINAL.includes(entry.status))
+                    break;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_a && !_b && (_c = statusStream_1.return)) yield _c.call(statusStream_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return last;
+    });
+}

package/dist/utils/webhookFlags.d.ts

@@ -0,0 +1,3 @@
+export declare const WEBHOOK_EVENTS: string[];
+export declare const eventFlag: (required: boolean) => import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+export { formatDate } from "./format";

package/dist/utils/webhookFlags.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = exports.eventFlag = exports.WEBHOOK_EVENTS = void 0;
+/**
+ * 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 common_1 = require("@fonoster/common");
+const core_1 = require("@oclif/core");
+exports.WEBHOOK_EVENTS = [...common_1.Webhooks.WEBHOOK_EVENT_TYPES];
+const eventFlag = (required) => core_1.Flags.string({
+    char: "e",
+    description: "an event to receive (repeatable)",
+    options: exports.WEBHOOK_EVENTS,
+    multiple: true,
+    required
+});
+exports.eventFlag = eventFlag;
+var format_1 = require("./format");
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return format_1.formatDate; } });