@winccoa-tools-pack/npm-winccoa-core 0.1.0-9ec3b86

package/dist/cjs/types/project/ProjEnvProjectRegistry.js

@@ -0,0 +1,301 @@
+"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.getRegisteredProjects = getRegisteredProjects;
+exports.getRegisteredProducts = getRegisteredProducts;
+exports.findProjectRegistryById = findProjectRegistryById;
+exports.getProductByVersion = getProductByVersion;
+exports.getLastUsedProjectDir = getLastUsedProjectDir;
+exports.reloadProjectRegistries = reloadProjectRegistries;
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Cache for registered projects loaded from pvssInst.conf.
+ * Automatically refreshed when the configuration file changes.
+ */
+let registeredProjectsCache;
+/**
+ * Cache for registered products (WinCC OA installations) loaded from pvssInst.conf.
+ * Automatically refreshed when the configuration file changes.
+ */
+let registeredProducts;
+/**
+ * File system watcher for pvssInst.conf.
+ * Monitors changes to the configuration file and triggers cache refresh.
+ */
+let fileWatcher;
+/**
+ * Debounce timeout handle for file change events.
+ * Prevents multiple rapid reloads by waiting 500ms after the last change.
+ */
+let reloadTimeout;
+/**
+ * Retrieves all registered WinCC OA projects from the system configuration.
+ * Loads from pvssInst.conf on first call and caches the results.
+ * The cache is automatically refreshed when the configuration file changes.
+ *
+ * @returns Array of all registered project configurations
+ */
+function getRegisteredProjects() {
+    loadProjectRegistries();
+    return registeredProjectsCache;
+}
+/**
+ * Retrieves all registered WinCC OA product installations (versions) from the system.
+ * Loads from pvssInst.conf on first call and caches the results.
+ * The cache is automatically refreshed when the configuration file changes.
+ *
+ * @returns Array of all registered product (version) configurations
+ */
+function getRegisteredProducts() {
+    loadProjectRegistries();
+    return registeredProducts;
+}
+/**
+ * Finds a registered project by its unique identifier.
+ *
+ * @param id - The project ID to search for
+ * @returns Project registry entry if found, undefined otherwise
+ */
+function findProjectRegistryById(id) {
+    return getRegisteredProjects().find((projRegistry) => projRegistry.id === id);
+}
+function getProductByVersion(version) {
+    loadProjectRegistries();
+    return registeredProducts.find((product) => product.id === version);
+}
+function getLastUsedProjectDir(version) {
+    loadProjectRegistries();
+    return getProductByVersion(version)?.lastUsedProjectDir;
+}
+/**
+ * Forces an immediate reload of project registries from pvssInst.conf.
+ * Useful when you need to ensure the cache is up-to-date.
+ * Note: File watching with automatic reload is already active, so this
+ * is typically only needed for manual refresh scenarios.
+ */
+function reloadProjectRegistries() {
+    loadProjectRegistries();
+}
+/**
+ * Internal function that loads project registries from pvssInst.conf and sets up file watching.
+ *
+ * **File Watching Behavior:**
+ * - Sets up a file system watcher on first call to monitor pvssInst.conf
+ * - Uses debouncing (500ms) to handle rapid successive file changes
+ * - Prevents premature reads of incomplete file writes
+ * - Automatically updates cache when changes are detected
+ *
+ * **Debouncing Strategy:**
+ * Multiple file change events within 500ms are collapsed into a single reload.
+ * This ensures the file is fully written and prevents performance issues from
+ * excessive parsing during bulk operations.
+ *
+ * The watcher remains active for the lifetime of the process.
+ */
+function loadProjectRegistries() {
+    if (fileWatcher) {
+        return;
+    }
+    const configPath = getPvssInstConfPath();
+    parseProjRegistryFile(configPath);
+    // Set up file watcher to refresh cache when pvssInst.conf changes
+    if (!fileWatcher && fs.existsSync(configPath)) {
+        try {
+            console.log(`[${new Date().toISOString()}] Setting up file watcher for pvssInst.conf:`, configPath);
+            fileWatcher = fs.watch(configPath, (eventType) => {
+                if (eventType === 'change') {
+                    // Debounce file changes - wait 500ms after last change before reloading
+                    if (reloadTimeout) {
+                        clearTimeout(reloadTimeout);
+                    }
+                    // console.log(
+                    //     `[${new Date().toISOString()}] pvssInst.conf change detected, scheduling reload in 100ms`,
+                    // );
+                    reloadTimeout = setTimeout(() => {
+                        console.log(`[${new Date().toISOString()}] pvssInst.conf changed, reloading project registries`);
+                        reloadTimeout = undefined;
+                        console.log(`[${new Date().toISOString()}] Reloading project registries. Current cache size: ${registeredProjectsCache.length}`);
+                        parseProjRegistryFile(configPath);
+                        console.log(`[${new Date().toISOString()}] Project registries reloaded. Current cache size: ${registeredProjectsCache.length}`);
+                    }, 100);
+                }
+            });
+        }
+        catch (error) {
+            // Silently fail if file watching is not supported
+            console.warn(`[${new Date().toISOString()}] Could not create file watcher for pvssInst.conf:`, error);
+        }
+    }
+}
+function parseProjRegistryFile(configPath) {
+    console.log(`[${new Date().toISOString()}] Loading project registries from ${configPath}`);
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`The WinCC OA is probably not installed. The pvssInst.conf file not found at path: ${configPath}`);
+    }
+    const content = fs.readFileSync(configPath, 'utf-8');
+    const lines = content.split('\n');
+    const projects = [];
+    const products = [];
+    let currentProjectSection = {
+        currentProject: false,
+        id: '',
+        installationDir: '',
+        notRunnable: true,
+        installationDate: '',
+        installationVersion: undefined,
+    };
+    let lastUsedProjectDir = '';
+    let currentproject = '';
+    let inProductSection = false;
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine.startsWith('[') && trimmedLine.endsWith(']')) {
+            // Save previous project if complete
+            if (inProductSection) {
+                const currentProductRegistry = currentProjectSection;
+                currentProductRegistry.lastUsedProjectDir = lastUsedProjectDir;
+                currentProductRegistry.currentproject = currentproject;
+                currentProductRegistry.notRunnable = true;
+                inProductSection = false;
+                products.push(currentProductRegistry);
+            }
+            else if (currentProjectSection.id != '') {
+                projects.push(currentProjectSection);
+            }
+            // Extract content inside the brackets
+            // Format: Software\<company>\<product>\Configs\<projectID>
+            // or:     Software\<company>\<product>\<versionNumber>
+            const sectionPath = trimmedLine.slice(1, -1); // Remove [ and ]
+            const pathParts = sectionPath.split('\\');
+            // Extract project ID or version from the last part of the path
+            const projectId = pathParts[pathParts.length - 1] || '';
+            // Start new project section
+            currentProjectSection = {
+                currentProject: false,
+                id: projectId,
+                installationDir: '',
+                notRunnable: true,
+                installationDate: '',
+            };
+            lastUsedProjectDir = '';
+            currentproject = '';
+        }
+        else if (trimmedLine.includes('=')) {
+            const [key, value] = trimmedLine.split('=', 2).map((s) => s.trim());
+            switch (key.toLowerCase()) {
+                case 'firstPAStart':
+                    inProductSection = true;
+                    break;
+                case 'currentproject':
+                    currentproject = value.replace(/['"]/g, '');
+                    inProductSection = true;
+                    break;
+                case 'lastusedprojectdir':
+                    lastUsedProjectDir = value.replace(/['"]/g, '');
+                    inProductSection = true;
+                    break;
+                case 'installationdir':
+                    {
+                        const entryValue = value.replace(/['"]/g, '');
+                        const idFromPath = path_1.default.basename(entryValue);
+                        if (idFromPath && idFromPath !== currentProjectSection.id) {
+                            currentProjectSection.invalidReason = `Project ID mismatch in registry entry. Expected: ${currentProjectSection.id}, Found in path: ${idFromPath}`;
+                            break;
+                        }
+                        currentProjectSection.installationDir = path_1.default.dirname(entryValue);
+                    }
+                    break;
+                case 'installationdate':
+                    currentProjectSection.installationDate = value.replace(/['"]/g, '');
+                    break;
+                case 'installationversion':
+                    currentProjectSection.installationVersion = value.replace(/['"]/g, '');
+                    break;
+                case 'notrunnable':
+                    {
+                        if (value === '0' || value === '"0"') {
+                            currentProjectSection.notRunnable = false;
+                        }
+                        else {
+                            currentProjectSection.notRunnable = true;
+                        }
+                    }
+                    break;
+                case 'company':
+                    currentProjectSection.company = value.replace(/['"]/g, '');
+                    break;
+                case 'name':
+                    currentProjectSection.name = value.replace(/['"]/g, '');
+                    break;
+                case 'description':
+                    currentProjectSection.description = value.replace(/['"]/g, '');
+                    break;
+            }
+        }
+    }
+    // Don't forget the last project
+    if (inProductSection) {
+        const currentProductRegistry = currentProjectSection;
+        currentProductRegistry.lastUsedProjectDir = lastUsedProjectDir;
+        currentProductRegistry.currentproject = currentproject;
+        currentProductRegistry.notRunnable = true;
+        products.push(currentProductRegistry);
+    }
+    else if (currentProjectSection.id != '') {
+        projects.push(currentProjectSection);
+    }
+    registeredProjectsCache = projects;
+    registeredProducts = products;
+}
+/**
+ * Gets the platform-specific path to the pvssInst.conf file
+ * @returns The full path to the pvssInst.conf file
+ */
+function getPvssInstConfPath() {
+    if (os.platform() === 'win32') {
+        // Windows path
+        return 'C:\\ProgramData\\Siemens\\WinCC_OA\\pvssInst.conf';
+    }
+    else {
+        // Unix/Linux path
+        return '/etc/opt/pvss/pvssInst.conf';
+    }
+}
+//# sourceMappingURL=ProjEnvProjectRegistry.js.map

package/dist/cjs/types/project/ProjEnvProjectRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjEnvProjectRegistry.js","sourceRoot":"","sources":["../../../../src/types/project/ProjEnvProjectRegistry.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types/status/WinCCOAManager.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=WinCCOAManager.js.map

package/dist/cjs/types/status/WinCCOAManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WinCCOAManager.js","sourceRoot":"","sources":["../../../../src/types/status/WinCCOAManager.ts"],"names":[],"mappings":""}

package/dist/cjs/types/version/DetailedVersionInfo.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Detailed version information for WinCC OA components.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DetailedVersionInfo.js.map

package/dist/cjs/types/version/DetailedVersionInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailedVersionInfo.js","sourceRoot":"","sources":["../../../../src/types/version/DetailedVersionInfo.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Utility Functions
+ * Core utility functions for WinCC OA operations
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./winccoa-components"), exports);
+__exportStar(require("./winccoa-paths"), exports);
+__exportStar(require("./winccoa-project-environment"), exports);
+__exportStar(require("./winccoa-version-info"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,kDAAgC;AAChC,gEAA8C;AAC9C,yDAAuC"}

package/dist/cjs/utils/winccoa-components.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getComponentName = getComponentName;
+function getComponentName(component) {
+    return component.getName();
+}
+//# sourceMappingURL=winccoa-components.js.map

package/dist/cjs/utils/winccoa-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-components.js","sourceRoot":"","sources":["../../../src/utils/winccoa-components.ts"],"names":[],"mappings":";;AAEA,4CAEC;AAFD,SAAgB,gBAAgB,CAAC,SAA2B;IACxD,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/cjs/utils/winccoa-localization.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tr = tr;
+/** Translatess given 'text' string into current user langauge
+ *
+ * TODO: implement localizations
+ *
+ */
+function tr(text) {
+    return text;
+}
+//# sourceMappingURL=winccoa-localization.js.map

package/dist/cjs/utils/winccoa-localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-localization.js","sourceRoot":"","sources":["../../../src/utils/winccoa-localization.ts"],"names":[],"mappings":";;AAKA,gBAEC;AAPD;;;;GAIG;AACH,SAAgB,EAAE,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/cjs/utils/winccoa-logging.js

@@ -0,0 +1,3 @@
+"use strict";
+// todo export here WinCC OA logging features
+//# sourceMappingURL=winccoa-logging.js.map

package/dist/cjs/utils/winccoa-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-logging.js","sourceRoot":"","sources":["../../../src/utils/winccoa-logging.ts"],"names":[],"mappings":";AAAA,6CAA6C"}

package/dist/cjs/utils/winccoa-paths.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * WinCC OA Installation Path Utilities
+ * Handles platform-specific path discovery and component path resolution
+ *
+ * PERFORMANCE OPTIMIZATION:
+ * This module implements aggressive caching to minimize expensive file system
+ * and Windows registry operations. Cached values persist for the lifetime of
+ * the extension.
+ *
+ * IMPORTANT: If WinCC OA is installed or removed while VS Code is running,
+ * the extension must be reloaded (or VS Code restarted) to detect the changes.
+ * This is an acceptable trade-off for the significant performance improvement.
+ *
+ * Cache Strategy:
+ * - Installation paths are cached per version in cachedWinCCOAInstallationPathByVersion
+ * - Available versions list is cached once in cachedAvailableWinCCOAVersions
+ * - Both caches persist until extension reload/restart
+ *
+ * @author mPokornyETM
+ * @performance Caching reduces registry queries and file system operations by ~95%
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWinCCOAInstallationPathByVersion = getWinCCOAInstallationPathByVersion;
+exports.getAvailableWinCCOAVersions = getAvailableWinCCOAVersions;
+exports.getWindowsAvailableVersions = getWindowsAvailableVersions;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+const winccoa_version_info_js_1 = require("./winccoa-version-info.js");
+/**
+ * Cache for WinCC OA installation paths indexed by version
+ * Prevents redundant registry queries and file system checks
+ *
+ * Note: Cache persists for extension lifetime. Extension reload required
+ * if WinCC OA installations change.
+ */
+const cachedWinCCOAInstallationPathByVersion = {};
+/**
+ * Finds the WinCC OA installation path for a given version
+ *
+ * CACHED: This function caches results per version. First lookup for each version
+ * performs registry query (Windows) or file system check (Linux). Subsequent
+ * lookups return cached value immediately.
+ *
+ * @param version - WinCC OA version (e.g., "3.20", "3.21")
+ * @returns Installation path or null if not found
+ * @performance First call per version: ~50-100ms, subsequent calls: <1ms
+ */
+function getWinCCOAInstallationPathByVersion(version) {
+    // Check cache first - even null results are cached to avoid repeated failed lookups
+    if (cachedWinCCOAInstallationPathByVersion[version] !== undefined) {
+        return cachedWinCCOAInstallationPathByVersion[version];
+    }
+    const platform = os.platform();
+    if (platform === 'win32') {
+        cachedWinCCOAInstallationPathByVersion[version] = getWindowsInstallationPath(version);
+    }
+    else {
+        // Unix/Linux systems
+        cachedWinCCOAInstallationPathByVersion[version] = getUnixInstallationPath(version);
+    }
+    return cachedWinCCOAInstallationPathByVersion[version];
+}
+/**
+ * Gets WinCC OA installation path from Windows registry
+ * @param version - WinCC OA version
+ * @returns Installation path or null if not found
+ */
+function getWindowsInstallationPath(version) {
+    try {
+        // Try to read from registry using execFileSync to prevent shell injection
+        const regKey = `HKLM\\Software\\ETM\\WinCC_OA\\${version}`;
+        const args = ['query', regKey, '/v', 'INSTALLDIR'];
+        const output = (0, child_process_1.execFileSync)('reg', args, { encoding: 'utf-8' });
+        // Parse the output to extract the INSTALLDIR value
+        const match = output.match(/INSTALLDIR\s+REG_SZ\s+(.+)/);
+        if (match && match[1]) {
+            const installPath = match[1].trim();
+            if (fs.existsSync(installPath)) {
+                return installPath;
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    }
+    catch (error) {
+        // Registry key not found or command failed
+        // Fall back to default paths
+    }
+    return null;
+}
+/**
+ * Gets WinCC OA installation path on Unix/Linux systems
+ * @param version - WinCC OA version
+ * @returns Installation path or null if not found
+ */
+function getUnixInstallationPath(version) {
+    const installPath = `/opt/WinCC_OA/${version}`;
+    if (fs.existsSync(installPath)) {
+        return installPath;
+    }
+    return null;
+}
+/**
+ * Cache for available WinCC OA versions list
+ * Prevents redundant registry enumeration and directory scanning
+ *
+ * Performance Impact:
+ * - Windows: Eliminates repeated "reg query" command executions (~100ms each)
+ * - Linux: Eliminates repeated directory scans of /opt/WinCC_OA
+ *
+ * Note: Set to null initially, populated on first call. Cache persists for
+ * extension lifetime. Extension reload required if WinCC OA versions change.
+ */
+let cachedAvailableWinCCOAVersions = null;
+/**
+ * Gets available WinCC OA versions installed on the system
+ *
+ * CACHED: This function caches its result on first call. Subsequent calls
+ * return the cached value immediately without any file system or registry access.
+ *
+ * @returns Array of version strings sorted from highest to lowest
+ * @performance First call: ~100-200ms, subsequent calls: <1ms
+ */
+function getAvailableWinCCOAVersions() {
+    // Return cached result if available - avoids expensive registry/filesystem operations
+    if (cachedAvailableWinCCOAVersions !== null) {
+        return cachedAvailableWinCCOAVersions;
+    }
+    const platform = os.platform();
+    if (platform === 'win32') {
+        cachedAvailableWinCCOAVersions = getWindowsAvailableVersions();
+    }
+    else {
+        cachedAvailableWinCCOAVersions = getUnixAvailableVersions();
+    }
+    return cachedAvailableWinCCOAVersions;
+}
+/**
+ * Gets available WinCC OA versions on Windows
+ * @returns Array of version strings sorted from highest to lowest
+ */
+function getWindowsAvailableVersions() {
+    const versions = [];
+    try {
+        // Try to read from registry
+        const regKey = 'HKLM\\Software\\ETM\\WinCC_OA';
+        const command = `reg query "${regKey}"`;
+        const output = (0, child_process_1.execSync)(command, { encoding: 'utf-8' });
+        const lines = output.split('\n');
+        for (const line of lines) {
+            const match = line.match(/WinCC_OA\\(\d+\.\d+(?:\.\d+)?)/);
+            if (match && match[1]) {
+                versions.push(match[1]);
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    }
+    catch (error) {
+        // Registry query failed, try common paths
+    }
+    // Sort versions descending
+    return versions.sort((a, b) => (0, winccoa_version_info_js_1.parseVersionString)(b) - (0, winccoa_version_info_js_1.parseVersionString)(a));
+}
+/**
+ * Gets available WinCC OA versions on Unix/Linux
+ * @returns Array of version strings sorted from highest to lowest
+ */
+function getUnixAvailableVersions() {
+    const basePath = '/opt/WinCC_OA';
+    if (!fs.existsSync(basePath)) {
+        return [];
+    }
+    try {
+        const entries = fs.readdirSync(basePath);
+        const versions = entries.filter((entry) => {
+            const fullPath = path.join(basePath, entry);
+            return fs.statSync(fullPath).isDirectory() && /^\d+\.\d+/.test(entry);
+        });
+        // Sort versions descending
+        return versions.sort((a, b) => (0, winccoa_version_info_js_1.parseVersionString)(b) - (0, winccoa_version_info_js_1.parseVersionString)(a));
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    }
+    catch (error) {
+        return [];
+    }
+}
+//# sourceMappingURL=winccoa-paths.js.map

package/dist/cjs/utils/winccoa-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-paths.js","sourceRoot":"","sources":["../../../src/utils/winccoa-paths.ts"],"names":[],"mappings":"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"}