@microtronics/studio-cli 0.47.0 → 0.49.0

package/out/run.js

@@ -1,254 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RunExitCode = void 0;
-exports.run = run;
-const vscode_uri_1 = require("vscode-uri");
-const apm_1 = require("./package/apm");
-const defaultFiles_1 = require("./defaultFiles");
-const package_1 = require("./package/package");
-const manifest_1 = require("./manifest");
-const myDatanetClient_1 = require("./myDatanetClient");
-Object.defineProperty(exports, "RunExitCode", { enumerable: true, get: function () { return myDatanetClient_1.RunExitCode; } });
-const usb_1 = require("./usb");
-/**
- * Helper to extract error message from unknown error
- */
-function getErrorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-/**
- * Helper to create a failure result
- */
-function failureResult(errorCode, message) {
-    return { success: false, errorCode, message };
-}
-/**
- * Step 1: Build the project
- */
-async function buildProject(ctx) {
-    const { cwd, fs, logger, env, apiToken, options } = ctx;
-    logger.info('[1/5] Building project...');
-    try {
-        const partsToBuild = options.part ? options.part : true;
-        await manifest_1.Manifest.validateBasicManifest(cwd, fs, null);
-        await package_1.Package.buildAll(cwd, fs, logger, env, apiToken, partsToBuild, true);
-        logger.done('Build completed successfully');
-        return null;
-    }
-    catch (error) {
-        return failureResult(myDatanetClient_1.RunExitCode.BuildFailed, `Build failed: ${getErrorMessage(error)}`);
-    }
-}
-/**
- * Step 2: Find and validate USB device
- */
-async function findDevice(ctx) {
-    const { logger, options } = ctx;
-    const { serial } = options;
-    logger.info(`[2/5] Searching for USB device with serial: ${serial}...`);
-    const device = await (0, usb_1.findDeviceBySerialNumber)(serial);
-    if (!device) {
-        return failureResult(myDatanetClient_1.RunExitCode.DeviceNotFound, `USB device not found with serial number: ${serial}`);
-    }
-    logger.done(`Device found: ${device.productName}`);
-    return device;
-}
-/**
- * Step 3: Upload binary to USB device
- */
-async function uploadToUsbDevice(ctx) {
-    const { cwd, fs, logger, options } = ctx;
-    const { serial, debug } = options;
-    logger.info('[3/5] Uploading binary to USB device...');
-    const amxPath = vscode_uri_1.Utils.joinPath(cwd, defaultFiles_1.DefaultFiles.filePaths.dist.mainAmxPath);
-    const uploadResult = await (0, usb_1.uploadToDevice)(serial, amxPath, fs, logger, debug);
-    if (!uploadResult.success) {
-        return failureResult(myDatanetClient_1.RunExitCode.UsbUploadFailed, `USB upload failed: ${uploadResult.message}`);
-    }
-    logger.done('USB upload completed');
-    return null;
-}
-/**
- * Step 4a: Authenticate with myDatanet
- */
-async function authenticateWithMyDatanet(mdnClient, logger) {
-    logger.info('[4/5] Connecting to myDatanet server...');
-    try {
-        return await mdnClient.authenticate();
-    }
-    catch (error) {
-        return failureResult(myDatanetClient_1.RunExitCode.AuthenticationFailed, `myDatanet authentication failed: ${getErrorMessage(error)}`);
-    }
-}
-/**
- * Step 4b: Resolve customer UID
- */
-async function resolveCustomer(mdnClient, customer, logger) {
-    if (customer) {
-        try {
-            const customerInfo = await mdnClient.getCustomer(customer);
-            logger.info(`Using customer: ${customerInfo.name} (${customerInfo._uid})`);
-            return customerInfo._uid;
-        }
-        catch {
-            return failureResult(myDatanetClient_1.RunExitCode.SiteCreationFailed, `Customer "${customer}" not found`);
-        }
-    }
-    // Try to get customer from available customers
-    const customers = await mdnClient.getCustomers();
-    if (customers.length === 0) {
-        return failureResult(myDatanetClient_1.RunExitCode.SiteCreationFailed, 'No customers available. Please specify --customer or set MYDATANET_CUSTOMER');
-    }
-    if (customers.length === 1) {
-        logger.info(`Using customer: ${customers[0].name} (${customers[0]._uid})`);
-        return customers[0]._uid;
-    }
-    const customerNames = customers.map(c => c.name).join(', ');
-    return failureResult(myDatanetClient_1.RunExitCode.SiteCreationFailed, `Multiple customers available. Please specify --customer or set MYDATANET_CUSTOMER. Available: ${customerNames}`);
-}
-/**
- * Step 4c: Update install info with existing site data if available
- */
-async function updateInstallInfoFromExistingSite(mdnClient, serial, installInfo, logger) {
-    const existingSite = await mdnClient.getDeviceSite(serial);
-    if (!existingSite) {
-        return;
-    }
-    if (existingSite.app.phase === 'dev') {
-        installInfo.apmId = existingSite.app.apmid;
-        installInfo.applicationId = existingSite.app.appl_id;
-    }
-    installInfo.siteUid = existingSite._uid;
-    installInfo.siteName = existingSite.name;
-    installInfo.customerUid = existingSite.customer_uid;
-    logger.info(`Found existing site: ${existingSite.name}`);
-}
-/**
- * Step 4d: Create and upload development APM tag
- */
-async function uploadDevTag(ctx, mdnClient, installInfo) {
-    const { cwd, fs, logger } = ctx;
-    logger.info('Creating development APM tag...');
-    try {
-        const apmBuffer = await apm_1.APM.createDevTag(cwd, fs);
-        const applicationId = await mdnClient.uploadDevTag(installInfo.apmId, apmBuffer);
-        installInfo.applicationId = applicationId;
-        logger.done('Development tag uploaded');
-        return null;
-    }
-    catch (error) {
-        return failureResult(myDatanetClient_1.RunExitCode.DevTagUploadFailed, `Development tag upload failed: ${getErrorMessage(error)}`);
-    }
-}
-/**
- * Step 5: Create or update development site
- */
-async function createOrUpdateSite(mdnClient, customerUid, installInfo, logger) {
-    logger.info('[5/5] Creating development site...');
-    try {
-        if (installInfo.siteUid) {
-            // Update site name if different
-            if (installInfo.siteName !== installInfo.name) {
-                await mdnClient.updateSiteName(installInfo.siteUid, installInfo.name);
-            }
-            logger.info(`Reusing existing site: ${installInfo.siteUid}`);
-            return installInfo.siteUid;
-        }
-        return await mdnClient.createDevelopmentSite(customerUid, installInfo);
-    }
-    catch (error) {
-        return failureResult(myDatanetClient_1.RunExitCode.SiteCreationFailed, `Site creation failed: ${getErrorMessage(error)}`);
-    }
-}
-/**
- * Log the deployment summary
- */
-function logDeploymentSummary(logger, siteUid, apmId) {
-    logger.done('Development deployment completed successfully!');
-    logger.info('');
-    logger.info('=== Deployment Summary ===');
-    logger.info(`Site UID: ${siteUid}`);
-    logger.info(`APM ID: ${apmId}`);
-    logger.info('==========================');
-}
-/**
- * Check if result is a failure
- */
-function isFailure(result) {
-    return typeof result === 'object' && result !== null && 'errorCode' in result;
-}
-/**
- * Builds, uploads to USB device, and creates a development site on myDatanet.
- *
- * This function orchestrates the complete development deployment workflow:
- * 1. Builds the project
- * 2. Uploads the binary to the USB device
- * 3. Authenticates with myDatanet
- * 4. Creates and uploads a development APM tag
- * 5. Creates or reuses a development site
- *
- * @param {URI} cwd - The current working directory of the project.
- * @param {LocalFS} fs - The file system interface for file operations.
- * @param {Log.Logger} logger - Logger instance for logging progress.
- * @param {Globals.ENV} env - The environment configuration.
- * @param {string | null} apiToken - The Studio API token for registry operations.
- * @param {RunOptions} options - Options for the run command.
- * @return {Promise<RunResult>} A promise that resolves to the result of the run command.
- */
-async function run(cwd, fs, logger, env, apiToken, options) {
-    const ctx = { cwd, fs, logger, env, apiToken, options };
-    const { serial, server, customer, mdnToken } = options;
-    logger.info('Starting development deployment...');
-    // Step 1: Build the project
-    const buildResult = await buildProject(ctx);
-    if (buildResult) {
-        return buildResult;
-    }
-    // Step 2: Find and validate USB device
-    const deviceResult = await findDevice(ctx);
-    if (isFailure(deviceResult)) {
-        return deviceResult;
-    }
-    // Step 3: Upload binary to USB device
-    const uploadResult = await uploadToUsbDevice(ctx);
-    if (uploadResult) {
-        return uploadResult;
-    }
-    // Step 4: myDatanet operations
-    const mdnClient = new myDatanetClient_1.MyDatanetClient(server, mdnToken, logger);
-    // 4a: Authenticate
-    const authResult = await authenticateWithMyDatanet(mdnClient, logger);
-    if (isFailure(authResult)) {
-        return authResult;
-    }
-    const userInfo = authResult;
-    // 4b: Resolve customer
-    const customerResult = await resolveCustomer(mdnClient, customer, logger);
-    if (isFailure(customerResult)) {
-        return customerResult;
-    }
-    const customerUid = customerResult;
-    // Build development install info
-    const installInfo = await (0, myDatanetClient_1.buildDevelopmentInstallInfo)(cwd, fs, serial, userInfo.name, customerUid);
-    // 4c: Check for existing site
-    await updateInstallInfoFromExistingSite(mdnClient, serial, installInfo, logger);
-    // 4d: Upload dev tag
-    const devTagResult = await uploadDevTag(ctx, mdnClient, installInfo);
-    if (devTagResult) {
-        return devTagResult;
-    }
-    // Step 5: Create or update development site
-    const siteResult = await createOrUpdateSite(mdnClient, customerUid, installInfo, logger);
-    if (isFailure(siteResult)) {
-        return siteResult;
-    }
-    const siteUid = siteResult;
-    logDeploymentSummary(logger, siteUid, installInfo.apmId);
-    return {
-        success: true,
-        siteUid,
-        apmId: installInfo.apmId,
-        message: 'Development deployment completed successfully'
-    };
-}
-//# sourceMappingURL=run.js.map

package/out/usb.js

@@ -1,189 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listUsbDevices = listUsbDevices;
-exports.printUsbDevices = printUsbDevices;
-exports.findDeviceBySerialNumber = findDeviceBySerialNumber;
-exports.uploadToDevice = uploadToDevice;
-const usb_1 = require("usb");
-const uto_master_1 = require("uto-master");
-const utoStack_1 = require("uto-master/dist/src/utilities/utoStack");
-// Microtronics vendor ID
-const MICROTRONICS_VENDOR_ID = 0x2544;
-/**
- * Custom WebUSB instance configured to allow Microtronics devices
- */
-const customWebUSB = new usb_1.WebUSB({
-    // Bypass checking for authorized devices
-    allowedDevices: [
-        {
-            vendorId: MICROTRONICS_VENDOR_ID
-        }
-    ]
-});
-/**
- * Lists all available USB devices filtered by Microtronics vendor ID
- * @returns Promise resolving to an array of USB device information
- */
-async function listUsbDevices() {
-    const devices = await customWebUSB.getDevices();
-    return devices.map((device) => ({
-        productName: device.productName,
-        serialNumber: device.serialNumber || device.productName?.split(' ').pop(),
-        vendorId: device.vendorId,
-        productId: device.productId
-    }));
-}
-/**
- * Prints USB device product names using the provided logger
- * @param logger - The logger instance to use for output
- */
-async function printUsbDevices(logger) {
-    const devices = await listUsbDevices();
-    if (devices.length === 0) {
-        logger.info('No USB devices found.');
-        return;
-    }
-    logger.info('Available USB devices:');
-    devices.forEach((device, index) => {
-        const name = device.productName ||
-            `Unknown Device (VID: 0x${device.vendorId.toString(16)}, PID: 0x${device.productId.toString(16)})`;
-        const serial = device.serialNumber ? ` [${device.serialNumber}]` : '';
-        logger.log(`  ${index + 1}. ${name}${serial}`);
-    });
-}
-/**
- * Find a USB device by its serial number
- * @param serialNumber - The 16-character hex serial number of the device
- * @returns The USB device or null if not found
- */
-async function findDeviceBySerialNumber(serialNumber) {
-    const devices = await customWebUSB.getDevices();
-    for (const device of devices) {
-        // Check direct serial number or serial from product name
-        const deviceSerial = device.serialNumber || device.productName?.split(' ').pop();
-        if (deviceSerial?.toLowerCase() === serialNumber.toLowerCase()) {
-            return device;
-        }
-    }
-    return null;
-}
-/**
- * Upload an AMX binary file to a USB device
- * @param serialNumber - The serial number of the target device
- * @param fileUri - The URI to the AMX file
- * @param fs - The filesystem interface for file operations
- * @param logger - The logger instance for output
- * @param debugLog - Enable debug logging
- * @returns Promise resolving to an UploadResult
- */
-async function uploadToDevice(serialNumber, fileUri, fs, logger, debugLog = false) {
-    // Check if file exists
-    const fileStat = await fs.stat(fileUri);
-    if (!fileStat) {
-        return {
-            success: false,
-            message: `File not found: ${fileUri.fsPath}`
-        };
-    }
-    // Find the device by serial number
-    logger.info(`Searching for device with serial number: ${serialNumber}`);
-    const device = await findDeviceBySerialNumber(serialNumber);
-    if (!device) {
-        return {
-            success: false,
-            message: `Device not found with serial number: ${serialNumber}`
-        };
-    }
-    logger.info(`Device found: ${device.productName}`);
-    // Read the file contents
-    const fileData = (await fs.readFile(fileUri));
-    // Initialize UTO Master
-    const utoMaster = new uto_master_1.UtoMaster();
-    let deviceConnected = false;
-    try {
-        await utoMaster.init();
-        // Set up UTO transmit callback
-        utoMaster.utoTx(async (data) => {
-            if (device.opened) {
-                await device.transferOut(uto_master_1.USB_CONFIGURATION.utoEndpoint, data);
-            }
-        });
-        if (debugLog) {
-            utoMaster.on('mdnCom', (message) => {
-                logger.log('mdnCom', message);
-            });
-            utoMaster.on('mdnComError', (message) => {
-                logger.log('mdnComError', message);
-            });
-        }
-        // Set up progress reporting
-        let lastProgress = -1;
-        utoMaster.on('installing', (data) => {
-            if (!data) {
-                return;
-            }
-            // /*const progress = Math.round(data.progress);
-            if (data !== lastProgress) {
-                lastProgress = data;
-                logger.info(`Upload progress: ${data}%`);
-            }
-        });
-        // Open device and claim interfaces
-        await device.open();
-        await device.selectConfiguration(uto_master_1.USB_CONFIGURATION.configurationNumber);
-        await device.claimInterface(uto_master_1.USB_CONFIGURATION.utoInterface);
-        deviceConnected = true;
-        logger.info('Device connected, starting upload...');
-        // Start UTO polling for receiving data
-        startUtoPolling(device, utoMaster, () => deviceConnected);
-        await utoMaster.requestDeviceInfo();
-        // Upload the file
-        await utoMaster.sendFile(utoStack_1.UtoFileType.pawn, new Uint8Array(fileData.buffer, fileData.byteOffset, fileData.length));
-        logger.done('Upload completed successfully!');
-        return {
-            success: true,
-            message: 'File uploaded successfully'
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            success: false,
-            message: `Upload failed: ${errorMessage}`
-        };
-    }
-    finally {
-        // Clean up - close device
-        deviceConnected = false;
-        if (device.opened) {
-            try {
-                await device.close().catch();
-            }
-            catch {
-                // Ignore close errors
-            }
-        }
-    }
-}
-/**
- * Start polling for UTO data from the device
- * @param device - The USB device
- * @param utoMaster - The UTO Master instance
- * @param isConnected - Function that returns connection status
- */
-async function startUtoPolling(device, utoMaster, isConnected) {
-    while (isConnected()) {
-        try {
-            const result = await device.transferIn(uto_master_1.USB_CONFIGURATION.utoEndpoint, uto_master_1.USB_CONFIGURATION.utoSize);
-            if (result.status === 'ok' && result.data) {
-                const uint8Data = new Uint8Array(result.data.buffer);
-                await utoMaster.utoRx(uint8Data);
-            }
-        }
-        catch {
-            // Connection lost or polling stopped
-            break;
-        }
-    }
-}
-//# sourceMappingURL=usb.js.map