@fonoster/ctl 0.27.0 → 0.31.0

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; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/ctl",
-  "version": "0.27.0",
+  "version": "0.31.0",
   "description": "Fonoster Control Tool",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -14,7 +14,6 @@
   "scripts": {
     "prebuild": "rimraf ./dist tsconfig.tsbuildinfo",
     "build": "tsc -b tsconfig.json",
-    "clean": "rimraf ./dist node_modules tsconfig.tsbuildinfo",
     "generate:readme": "oclif readme"
   },
   "files": [
@@ -30,7 +29,7 @@
   "bugs": {
     "url": "https://github.com/fonoster/fonoster/issues"
   },
-  "gitHead": "1191b34677b51a36000177887ff82303ef2693e1",
+  "gitHead": "f0a5102dddeea0f70f659234108805bc10690f2e",
   "bin": {
     "fonoster": "./bin/run.js"
   },
@@ -51,7 +50,7 @@
     }
   },
   "dependencies": {
-    "@fonoster/sdk": "^0.27.0",
+    "@fonoster/sdk": "^0.31.0",
     "@inquirer/prompts": "^7.1.0",
     "@oclif/core": "^4.0.34",
     "@oclif/plugin-warn-if-update-available": "^3.1.28",
@@ -59,9 +58,8 @@
     "cli-table3": "^0.6.5",
     "cliui": "^8.0.1",
     "figlet": "^1.8.0",
-    "js-yaml": "^4.1.1",
+    "js-yaml": "^4.3.2",
     "moment": "^2.30.1",
-    "oclif": "^4.17.46",
     "phone": "^3.1.55",
     "terminal-link": "^3.0.0",
     "twilio": "^5.4.0",
@@ -71,6 +69,7 @@
     "@oclif/test": "^4.1.3",
     "@types/figlet": "^1.7.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "22.10.1"
+    "@types/node": "22.10.1",
+    "oclif": "^4.17.46"
   }
 }