@tenonhq/sincronia-core 0.0.68 → 0.0.71

package/dist/FileUtils.js

@@ -37,6 +37,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeFileForce = exports.writeSNFileForce = exports.writeSNFileIfNotExists = exports.writeBuildFile = exports.summarizeFile = exports.encodedPathsToFilePaths = exports.isValidPath = exports.splitEncodedPaths = exports.getPathsInPath = exports.isDirectory = exports.toAbsolutePath = exports.getFileContextFromPath = exports.getBuildExt = exports.isUnderPath = exports.appendToPath = exports.pathExists = exports.createDirRecursively = exports.writeSNFileCurry = exports.writeScopeManifest = exports.writeManifestFile = exports.SNFileExists = void 0;
+exports.writeEnvVar = writeEnvVar;
+exports.writeEnvVars = writeEnvVars;
 const constants_1 = require("./constants");
 const fs_1 = __importStar(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -255,3 +257,61 @@ exports.writeBuildFile = writeBuildFile;
 exports.writeSNFileIfNotExists = (0, exports.writeSNFileCurry)(true);
 exports.writeSNFileForce = (0, exports.writeSNFileCurry)(false);
 exports.writeFileForce = fs_1.promises.writeFile;
+// ============================================================================
+// .env File Utilities — merge-style writes (never destructive)
+// ============================================================================
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function quoteEnvValue(value) {
+    if (/[\s#"'\\]/.test(value)) {
+        return "\"" + value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n") + "\"";
+    }
+    return value;
+}
+function mergeEnvLine(content, key, value) {
+    const escaped = escapeRegex(key);
+    const regex = new RegExp("^" + escaped + "=.*$", "m");
+    const line = key + "=" + quoteEnvValue(value);
+    if (regex.test(content)) {
+        return content.replace(regex, line);
+    }
+    if (content.length > 0 && content.charAt(content.length - 1) !== "\n") {
+        content += "\n";
+    }
+    return content + line + "\n";
+}
+function readEnvFile(envPath) {
+    try {
+        return fs_1.default.readFileSync(envPath, "utf8");
+    }
+    catch (e) {
+        return "";
+    }
+}
+/**
+ * @description Writes a single env variable to a .env file, preserving existing values.
+ * @param {Object} params - Parameters object.
+ * @param {string} params.key - The environment variable name.
+ * @param {string} params.value - The value to set.
+ * @param {string} [params.envPath] - Path to .env file. Defaults to process.cwd()/.env.
+ */
+function writeEnvVar(params) {
+    const resolvedPath = params.envPath || path_1.default.resolve(process.cwd(), ".env");
+    const content = mergeEnvLine(readEnvFile(resolvedPath), params.key, params.value);
+    fs_1.default.writeFileSync(resolvedPath, content, "utf8");
+}
+/**
+ * @description Writes multiple env variables to a .env file in a single read/write cycle.
+ * @param {Object} params - Parameters object.
+ * @param {Array<{key: string; value: string}>} params.vars - Array of key/value pairs to write.
+ * @param {string} [params.envPath] - Path to .env file. Defaults to process.cwd()/.env.
+ */
+function writeEnvVars(params) {
+    const resolvedPath = params.envPath || path_1.default.resolve(process.cwd(), ".env");
+    let content = readEnvFile(resolvedPath);
+    params.vars.forEach(({ key, value }) => {
+        content = mergeEnvLine(content, key, value);
+    });
+    fs_1.default.writeFileSync(resolvedPath, content, "utf8");
+}

package/dist/allScopesCommands.js

@@ -32,6 +32,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initScopesCommand = initScopesCommand;
 exports.watchAllScopesCommand = watchAllScopesCommand;
@@ -44,6 +47,7 @@ const commands_1 = require("./commands");
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const child_process_1 = require("child_process");
+const progress_1 = __importDefault(require("progress"));
 const fsp = fs.promises;
 // Custom function to process manifest with specific source directory
 async function processManifestForScope(manifest, sourceDirectory, forceWrite = false) {
@@ -58,7 +62,20 @@ async function processManifestForScope(manifest, sourceDirectory, forceWrite = f
         }
         const tables = manifest.tables || {};
         const tableNames = Object.keys(tables);
-        Logger_1.logger.info("Processing " + tableNames.length + " tables for " + sourceDirectory);
+        var totalRecords = 0;
+        for (var tn = 0; tn < tableNames.length; tn++) {
+            totalRecords += Object.keys(tables[tableNames[tn]].records || {}).length;
+        }
+        var scopeLabel = sourceDirectory.split(path.sep).pop() || "scope";
+        var progBar = null;
+        if (Logger_1.logger.getLogLevel() === "info" && totalRecords > 0) {
+            progBar = new progress_1.default(":scope :bar :current/:total (:percent)", {
+                total: totalRecords,
+                width: 40,
+                complete: "=",
+                incomplete: "-",
+            });
+        }
         for (const tableName of tableNames) {
             const tableRecords = tables[tableName];
             const tablePath = path.join(sourceDirectory, tableName);
@@ -102,9 +119,10 @@ async function processManifestForScope(manifest, sourceDirectory, forceWrite = f
                         Logger_1.logger.error("Failed to write metadata: " + metadataFilePath);
                     }
                 }
+                if (progBar)
+                    progBar.tick({ scope: scopeLabel });
             }
         }
-        Logger_1.logger.info("Files written to " + sourceDirectory);
     }
     catch (error) {
         Logger_1.logger.error("Error processing files for " + sourceDirectory + ": " + error);

package/dist/appUtils.js

@@ -89,7 +89,7 @@ const processFilesInManRec = async (recPath, rec, forceWrite) => {
         return fileCopy;
     });
 };
-const processRecsInManTable = async (tablePath, table, forceWrite) => {
+const processRecsInManTable = async (tablePath, table, forceWrite, onRecordProcessed) => {
     const { records } = table;
     const recKeys = Object.keys(records);
     const recKeyToPath = (key) => path_1.default.join(tablePath, records[key].name);
@@ -100,23 +100,36 @@ const processRecsInManTable = async (tablePath, table, forceWrite) => {
     const filePromises = recKeys.reduce((acc, recKey) => {
         return [
             ...acc,
-            processFilesInManRec(recKeyToPath(recKey), records[recKey], forceWrite),
+            processFilesInManRec(recKeyToPath(recKey), records[recKey], forceWrite).then(function () {
+                if (onRecordProcessed)
+                    onRecordProcessed();
+            }),
         ];
     }, []);
     return Promise.all(filePromises);
 };
-const processTablesInManifest = async (tables, forceWrite, sourcePath) => {
+const countRecordsInTables = (tables) => {
+    return Object.keys(tables).reduce(function (sum, tableName) {
+        return sum + Object.keys(tables[tableName].records).length;
+    }, 0);
+};
+const processTablesInManifest = async (tables, forceWrite, sourcePath, onRecordProcessed) => {
     var basePath = sourcePath || ConfigManager.getSourcePath();
     const tableNames = Object.keys(tables);
     const tablePromises = tableNames.map((tableName) => {
-        return processRecsInManTable(path_1.default.join(basePath, tableName), tables[tableName], forceWrite);
+        return processRecsInManTable(path_1.default.join(basePath, tableName), tables[tableName], forceWrite, onRecordProcessed);
     });
     await Promise.all(tablePromises);
 };
 const processManifest = async (manifest, forceWrite = false, sourcePath) => {
     const tableCount = Object.keys(manifest.tables).length;
     FileLogger_1.fileLogger.debug("Processing manifest: " + (manifest.scope || "legacy") + " (" + tableCount + " tables)");
-    await processTablesInManifest(manifest.tables, forceWrite, sourcePath);
+    var recordCount = countRecordsInTables(manifest.tables);
+    var progress = createScopeProgress(Logger_1.logger.getLogLevel(), {
+        scope: manifest.scope || "default",
+        total: recordCount,
+    });
+    await processTablesInManifest(manifest.tables, forceWrite, sourcePath, progress.tick);
     if (manifest.scope) {
         await fUtils.writeScopeManifest(manifest.scope, manifest);
     }
@@ -245,13 +258,18 @@ const processMissingFiles = async (newManifest, sourcePath) => {
     try {
         const missing = await (0, exports.findMissingFiles)(newManifest, sourcePath);
         const missingTableCount = Object.keys(missing).length;
-        if (missingTableCount > 0) {
-            FileLogger_1.fileLogger.debug("Downloading missing files from " + missingTableCount + " tables");
-        }
+        if (missingTableCount === 0)
+            return;
+        FileLogger_1.fileLogger.debug("Downloading missing files from " + missingTableCount + " tables");
         const { tableOptions = {} } = ConfigManager.getConfig();
         const client = (0, snClient_1.defaultClient)();
         const filesToProcess = await (0, snClient_1.unwrapSNResponse)(client.getMissingFiles(missing, tableOptions));
-        await processTablesInManifest(filesToProcess, false, sourcePath);
+        var recordCount = countRecordsInTables(filesToProcess);
+        var progress = createScopeProgress(Logger_1.logger.getLogLevel(), {
+            scope: newManifest.scope || "default",
+            total: recordCount,
+        });
+        await processTablesInManifest(filesToProcess, false, sourcePath, progress.tick);
     }
     catch (e) {
         throw e;
@@ -375,6 +393,25 @@ const pushFiles = async (recs) => {
 exports.pushFiles = pushFiles;
 const summarizeRecord = (table, recDescriptor) => `${table} > ${recDescriptor}`;
 exports.summarizeRecord = summarizeRecord;
+const createScopeProgress = (logLevel, options) => {
+    if (logLevel !== "info" || options.total === 0) {
+        return { tick: function () { }, setTotal: function () { } };
+    }
+    var progBar = new progress_1.default(":scope :bar :current/:total (:percent)", {
+        total: options.total,
+        width: 40,
+        complete: "=",
+        incomplete: "-",
+    });
+    return {
+        tick: function () {
+            progBar.tick({ scope: options.scope });
+        },
+        setTotal: function (n) {
+            progBar.total = n;
+        },
+    };
+};
 const getProgTick = (logLevel, total) => {
     if (logLevel === "info") {
         const progBar = new progress_1.default(":bar (:percent)", {

package/dist/clickupCommands.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -51,8 +18,7 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const chalk_1 = __importDefault(require("chalk"));
 const Logger_1 = require("./Logger");
 const commands_1 = require("./commands");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+const FileUtils_1 = require("./FileUtils");
 // --- Token & API Helpers ---
 function getClickUpToken() {
     var token = process.env.CLICKUP_API_TOKEN;
@@ -337,7 +303,7 @@ async function clickupSetupCommand(args) {
             Logger_1.logger.info("  Workspace: " + teams[i].name + " (" + memberCount + " members)");
         }
         // Write token to .env file
-        await writeEnvVar("CLICKUP_API_TOKEN", token);
+        (0, FileUtils_1.writeEnvVar)({ key: "CLICKUP_API_TOKEN", value: token });
         Logger_1.logger.info("");
         Logger_1.logger.success(chalk_1.default.green("✓ ClickUp configured! Token saved to .env"));
         Logger_1.logger.info("");
@@ -504,26 +470,3 @@ function refineUpdateSetName(params) {
         .trim()
         .substring(0, 80);
 }
-// --- Env File Helper ---
-async function writeEnvVar(key, value) {
-    var envPath = path.resolve(process.cwd(), ".env");
-    var content = "";
-    try {
-        content = fs.readFileSync(envPath, "utf8");
-    }
-    catch (e) {
-        // File doesn't exist yet — will create
-    }
-    var regex = new RegExp("^" + key + "=.*$", "m");
-    var line = key + "=" + value;
-    if (regex.test(content)) {
-        content = content.replace(regex, line);
-    }
-    else {
-        if (content.length > 0 && content.charAt(content.length - 1) !== "\n") {
-            content = content + "\n";
-        }
-        content = content + line + "\n";
-    }
-    fs.writeFileSync(envPath, content, "utf8");
-}

package/dist/commander.js

@@ -13,6 +13,7 @@ const claudeCommand_1 = require("./claudeCommand");
 const createRecordCommand_1 = require("./createRecordCommand");
 const deleteRecordCommand_1 = require("./deleteRecordCommand");
 const clickupCommands_1 = require("./clickupCommands");
+const loginCommand_1 = require("./loginCommand");
 const yargs_1 = __importDefault(require("yargs"));
 async function initCommands() {
     const sharedOptions = {
@@ -74,7 +75,34 @@ async function initCommands() {
         .command("download <scope>", "Downloads a scoped application's files from ServiceNow. Must specify a scope prefix for a scoped app.", sharedOptions, async (args) => {
         await (0, commands_1.downloadCommand)(args);
     })
-        .command("init", "Provisions an initial project for you", sharedOptions, commands_1.initCommand)
+        .command("init", "Set up Sincronia — discovers installed packages, authenticates, and configures your project", sharedOptions, commands_1.initCommand)
+        .command("login [plugin]", "Authenticate with ServiceNow and other integrations", function (cmdArgs) {
+        cmdArgs.positional("plugin", {
+            describe: "Plugin name to login (e.g., clickup). Omit for ServiceNow only.",
+            type: "string",
+        });
+        cmdArgs.options({
+            ...sharedOptions,
+            all: {
+                type: "boolean",
+                default: false,
+                describe: "Login to all detected integrations",
+            },
+            instance: {
+                type: "string",
+                describe: "ServiceNow instance URL (non-interactive)",
+            },
+            user: {
+                type: "string",
+                describe: "ServiceNow username (non-interactive)",
+            },
+            password: {
+                type: "string",
+                describe: "ServiceNow password (non-interactive)",
+            },
+        });
+        return cmdArgs;
+    }, loginCommand_1.loginCommand)
         .command("initScopes", "Provisions an initial project for the scopes defined in the config", {
         ...sharedOptions,
         delay: {

package/dist/commands.js

@@ -48,7 +48,7 @@ exports.statusCommand = statusCommand;
 const ConfigManager = __importStar(require("./config"));
 const Watcher_1 = require("./Watcher");
 const AppUtils = __importStar(require("./appUtils"));
-const wizard_1 = require("./wizard");
+const orchestrator_1 = require("./initSystem/orchestrator");
 const Logger_1 = require("./Logger");
 const FileLogger_1 = require("./FileLogger");
 const logMessages_1 = require("./logMessages");
@@ -233,7 +233,6 @@ async function downloadCommand(args) {
         });
         Logger_1.logger.info("Received " + tableCount + " tables, " + recordCount + " records");
         FileLogger_1.fileLogger.debug("Download manifest: " + tableCount + " tables, " + recordCount + " records");
-        Logger_1.logger.info("Writing files to disk...");
         await AppUtils.processManifest(man, true);
         Logger_1.logger.success("Download complete — " + recordCount + " records written");
     }
@@ -244,7 +243,7 @@ async function downloadCommand(args) {
 async function initCommand(args) {
     setLogLevel(args);
     try {
-        await (0, wizard_1.startWizard)();
+        await (0, orchestrator_1.runInit)({ logLevel: args.logLevel });
     }
     catch (e) {
         throw e;

package/dist/initSystem/corePlugin.js

@@ -0,0 +1,228 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.corePlugin = void 0;
+exports.validateCoreLogin = validateCoreLogin;
+exports.normalizeInstance = normalizeInstance;
+const snClient_1 = require("../snClient");
+const Logger_1 = require("../Logger");
+const ConfigManager = __importStar(require("../config"));
+const AppUtils = __importStar(require("../appUtils"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * @description Core init plugin — handles ServiceNow authentication, app selection, and file download.
+ * This plugin is always included in sinc init and sinc login.
+ */
+exports.corePlugin = {
+    name: "core",
+    displayName: "ServiceNow",
+    description: "Connect to a ServiceNow instance and sync application files",
+    login: [
+        {
+            envKey: "SN_INSTANCE",
+            prompt: {
+                type: "input",
+                message: "ServiceNow instance (e.g. mycompany.service-now.com):",
+            },
+            required: true,
+        },
+        {
+            envKey: "SN_USER",
+            prompt: {
+                type: "input",
+                message: "Username:",
+            },
+            required: true,
+        },
+        {
+            envKey: "SN_PASSWORD",
+            prompt: {
+                type: "password",
+                message: "Password:",
+                mask: "*",
+            },
+            required: true,
+        },
+    ],
+    configure: [
+        {
+            key: "app",
+            label: "Selecting ServiceNow application",
+            run: async (context) => {
+                const baseUrl = instanceBaseUrl(context.env.SN_INSTANCE);
+                const client = (0, snClient_1.snClient)(baseUrl, context.env.SN_USER, context.env.SN_PASSWORD);
+                Logger_1.logger.info("Fetching application list...");
+                const apps = await (0, snClient_1.unwrapSNResponse)(client.getAppList());
+                if (apps.length === 0) {
+                    Logger_1.logger.warn("No applications found on this instance.");
+                    return null;
+                }
+                const choices = apps.map((app) => ({
+                    name: app.displayName + " (" + app.scope + ")",
+                    value: app.scope,
+                    short: app.displayName,
+                }));
+                const answer = await inquirer_1.default.prompt([{
+                        type: "list",
+                        name: "app",
+                        message: "Which app would you like to work with?",
+                        choices,
+                    }]);
+                context.answers.selectedScope = answer.app;
+                context.answers.apps = apps;
+                return answer.app;
+            },
+        },
+    ],
+    initialize: async (context) => {
+        const scope = context.answers.selectedScope;
+        if (!scope) {
+            Logger_1.logger.warn("No application selected — skipping initialization.");
+            return;
+        }
+        const rootDir = context.rootDir;
+        const configPath = path_1.default.join(rootDir, "sinc.config.js");
+        // Write or merge sinc.config.js
+        let hasExistingConfig = false;
+        try {
+            fs_1.default.accessSync(configPath, fs_1.default.constants.F_OK);
+            hasExistingConfig = true;
+        }
+        catch (e) {
+            // No existing config
+        }
+        if (!hasExistingConfig) {
+            Logger_1.logger.info("Generating sinc.config.js...");
+            fs_1.default.writeFileSync(configPath, ConfigManager.getDefaultConfigFile(), "utf8");
+        }
+        else {
+            Logger_1.logger.info("sinc.config.js already exists — preserving configuration.");
+        }
+        // Reload configs so ConfigManager picks up the new/existing config
+        try {
+            await ConfigManager.loadConfigs();
+        }
+        catch (e) {
+            Logger_1.logger.warn("Config reload incomplete — this is expected during first-time init.");
+        }
+        // Check if manifest already exists for this scope
+        const manifestPath = path_1.default.join(rootDir, "sinc.manifest." + scope + ".json");
+        let hasManifest = false;
+        try {
+            fs_1.default.accessSync(manifestPath, fs_1.default.constants.F_OK);
+            hasManifest = true;
+        }
+        catch (e) {
+            // No existing manifest
+        }
+        if (hasManifest) {
+            const redownload = await inquirer_1.default.prompt([{
+                    type: "confirm",
+                    name: "confirmed",
+                    message: "Manifest for " + scope + " already exists. Re-download?",
+                    default: false,
+                }]);
+            if (!redownload.confirmed) {
+                Logger_1.logger.info("Skipping download for " + scope);
+                return;
+            }
+        }
+        // Download application files — errors propagate to orchestrator
+        Logger_1.logger.info("Downloading " + scope + "...");
+        const baseUrl = instanceBaseUrl(context.env.SN_INSTANCE);
+        const client = (0, snClient_1.snClient)(baseUrl, context.env.SN_USER, context.env.SN_PASSWORD);
+        const config = ConfigManager.getConfig();
+        const man = await (0, snClient_1.unwrapSNResponse)(client.getManifest(scope, config, true));
+        await AppUtils.processManifest(man);
+        const tableNames = Object.keys(man.tables || {});
+        const recordCount = tableNames.reduce((sum, t) => {
+            return sum + Object.keys(man.tables[t].records || {}).length;
+        }, 0);
+        Logger_1.logger.success(chalk_1.default.green("✓ ServiceNow configured — " + tableNames.length + " tables, " + recordCount + " records"));
+    },
+};
+/**
+ * @description Validates ServiceNow credentials by testing the connection.
+ * Called by the orchestrator after all core login hooks are collected.
+ */
+async function validateCoreLogin(context) {
+    const instance = context.env.SN_INSTANCE;
+    const user = context.env.SN_USER;
+    const password = context.env.SN_PASSWORD;
+    if (!instance || !user || !password) {
+        return "Missing required credentials";
+    }
+    const instanceUrl = normalizeInstance(instance);
+    const baseUrl = instanceBaseUrl(instance);
+    try {
+        const client = (0, snClient_1.snClient)(baseUrl, user, password);
+        await (0, snClient_1.unwrapSNResponse)(client.getAppList());
+        context.env.SN_INSTANCE = instanceUrl;
+        return true;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        const status = e && e.response && e.response.status;
+        if (msg.includes("Invalid URL") || msg.includes("ENOTFOUND") || msg.includes("getaddrinfo")) {
+            return "Instance not found — check the URL (got: " + instanceUrl + ")";
+        }
+        if (status === 401 || msg.includes("401")) {
+            return "Invalid username or password.";
+        }
+        if (status === 403 || msg.includes("403")) {
+            return "Access denied — user may lack required roles.";
+        }
+        if (msg.includes("ECONNREFUSED") || msg.includes("ETIMEDOUT") || msg.includes("ECONNRESET")) {
+            return "Could not reach " + instanceUrl + " — check network connectivity.";
+        }
+        return "Connection failed: " + msg;
+    }
+}
+function normalizeInstance(instance) {
+    let url = instance.trim().replace("https://", "").replace("http://", "");
+    if (url.endsWith("/")) {
+        url = url.slice(0, -1);
+    }
+    return url;
+}
+function instanceBaseUrl(instance) {
+    return "https://" + normalizeInstance(instance) + "/";
+}