@mikrojs/esptool 0.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Bjørge Næss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @mikrojs/esptool
+
+Downloads and caches standalone [esptool](https://github.com/espressif/esptool) binaries from Espressif. Eliminates the Python dependency for flashing ESP32 devices.
+
+Binaries are cached locally after the first download.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+declare const ESPTOOL_VERSION = "v5.2.0";
+/**
+ * Get the path to the esptool binary, downloading it if necessary.
+ */
+export declare function getEsptoolPath(): Promise<string>;
+export { ESPTOOL_VERSION };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,eAAe,WAAW,CAAA;AA8DhC;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAoCtD;AAED,OAAO,EAAC,eAAe,EAAC,CAAA"}

package/dist/index.js

@@ -0,0 +1,95 @@
+import { execFile } from 'node:child_process';
+import { createWriteStream } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const ESPTOOL_VERSION = 'v5.2.0';
+const GITHUB_REPO = 'espressif/esptool';
+const CACHE_DIR = path.join(os.homedir(), '.cache', 'mikrojs', 'esptool');
+function getPlatform() {
+    switch (os.platform()) {
+        case 'linux':
+            return 'linux';
+        case 'darwin':
+            return 'macos';
+        case 'win32':
+            return 'windows';
+        default:
+            throw new Error(`Unsupported platform: ${os.platform()}`);
+    }
+}
+function getArch() {
+    switch (os.arch()) {
+        case 'x64':
+            return 'amd64';
+        case 'arm64':
+            return getPlatform() === 'linux' ? 'aarch64' : 'arm64';
+        default:
+            throw new Error(`Unsupported architecture: ${os.arch()}`);
+    }
+}
+function getAssetName(platform, arch) {
+    const ext = platform === 'windows' ? 'zip' : 'tar.gz';
+    return `esptool-${ESPTOOL_VERSION}-${platform}-${arch}.${ext}`;
+}
+function getExtractedDirName(platform, arch) {
+    return `esptool-${platform}-${arch}`;
+}
+function getBinaryName(platform) {
+    return platform === 'windows' ? 'esptool.exe' : 'esptool';
+}
+function getDownloadUrl(assetName) {
+    return `https://github.com/${GITHUB_REPO}/releases/download/${ESPTOOL_VERSION}/${assetName}`;
+}
+async function download(url, destPath) {
+    const response = await fetch(url, { redirect: 'follow' });
+    if (!response.ok) {
+        throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+    }
+    if (!response.body) {
+        throw new Error(`No response body from ${url}`);
+    }
+    await fs.mkdir(path.dirname(destPath), { recursive: true });
+    const fileStream = createWriteStream(destPath);
+    await pipeline(response.body, fileStream);
+}
+/**
+ * Get the path to the esptool binary, downloading it if necessary.
+ */
+export async function getEsptoolPath() {
+    const platform = getPlatform();
+    const arch = getArch();
+    const binaryName = getBinaryName(platform);
+    const extractedDir = getExtractedDirName(platform, arch);
+    const binaryPath = path.join(CACHE_DIR, ESPTOOL_VERSION, extractedDir, binaryName);
+    // Check if already cached
+    try {
+        await fs.access(binaryPath, fs.constants.X_OK);
+        return binaryPath;
+    }
+    catch {
+        // Not cached, proceed with download
+    }
+    const assetName = getAssetName(platform, arch);
+    const downloadUrl = getDownloadUrl(assetName);
+    const versionDir = path.join(CACHE_DIR, ESPTOOL_VERSION);
+    const archivePath = path.join(versionDir, assetName);
+    await fs.mkdir(versionDir, { recursive: true });
+    await download(downloadUrl, archivePath);
+    if (platform === 'windows') {
+        await execFileAsync('unzip', ['-o', archivePath, '-d', versionDir]);
+    }
+    else {
+        await execFileAsync('tar', ['xzf', archivePath, '-C', versionDir]);
+    }
+    // Clean up the archive
+    await fs.rm(archivePath);
+    // Ensure the binary is executable
+    await fs.chmod(binaryPath, 0o755);
+    return binaryPath;
+}
+export { ESPTOOL_VERSION };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mikrojs/esptool",
+  "version": "0.0.7",
+  "description": "Download and cache standalone esptool binaries from Espressif",
+  "keywords": [
+    "esp32",
+    "esptool",
+    "mikrojs"
+  ],
+  "homepage": "https://github.com/mikrojs/mikrojs#readme",
+  "bugs": {
+    "url": "https://github.com/mikrojs/mikrojs/issues"
+  },
+  "license": "MIT",
+  "author": "Bjørge Næss <bjoerge@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikrojs/mikrojs.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build:ts": "tsc -p tsconfig.build.json",
+    "publint": "publint",
+    "typecheck": "tsc --noEmit",
+    "watch": "tsc -p tsconfig.build.json --watch --preserveWatchOutput"
+  }
+}