Merge upstream/main to refresh flash core and keep Spectoda example app

Bring Spectoda/flash up to the current upstream esptool-js 0.6.0 state so the underlying flashing logic, chip targets, reset handling, transport changes, and stub flasher assets match the latest upstream implementation.

Resolve the example-layer conflicts by keeping the Spectoda-branded flashing UI, the preloaded firmware flow, and the parent-window integration on top of the updated core. Add the missing examples/typescript/static/fw placeholder structure so the example build no longer fails when the static firmware directory is absent in a clean checkout.

Impact: the fork is now up to date in the code paths that perform flashing, while the Spectoda wrapper remains intact. Verified with npm run build in the repository root and npm run build in examples/typescript.

Author: immakermatty

.github/workflows/ci.yml

@@ -1,3 +1,5 @@
+name: CI
+
 on:
   push:
     branches:
@@ -10,8 +12,8 @@ jobs:
   ci:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: 16
           registry-url: 'https://registry.npmjs.org'
@@ -30,7 +32,7 @@ jobs:
           echo $ESPTOOLJS_VERSION
           echo "version=$ESPTOOLJS_VERSION" >> $GITHUB_OUTPUT
       - name: Upload npm package file
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v4
         with:
           name: esptool-js-${{ steps.version.outputs.version }}.tgz
           path: esptool-js-${{ steps.version.outputs.version }}.tgz

.github/workflows/pages.yml

@@ -25,27 +25,26 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Set up Node
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
       - name: Install Node modules
         run: |
           npm install
       - name: Build example project and copy docs
         run: |
           npm run build
-          npm run genDocs
           cd examples/typescript
           npm install
           npm run build
       - name: Setup Pages
         uses: actions/configure-pages@v2
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v1
+        uses: actions/upload-pages-artifact@v3
         with:
           path: 'examples/typescript/dist'
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v1
+        uses: actions/deploy-pages@v4

.github/workflows/pr_comment.yml

@@ -0,0 +1,61 @@
+name: Comment on pull request
+on:
+  workflow_run:
+    workflows: [CI]
+    types: [completed]
+jobs:
+  pr_comment:
+    if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/github-script@v6
+        with:
+          # This snippet is public-domain, taken from
+          # https://github.com/oprypin/nightly.link/blob/master/.github/workflows/pr-comment.yml
+          script: |
+            async function upsertComment(owner, repo, issue_number, purpose, body) {
+              const {data: comments} = await github.rest.issues.listComments(
+                {owner, repo, issue_number});
+
+              const marker = `<!-- bot: ${purpose} -->`;
+              body = marker + "\n" + body;
+
+              const existing = comments.filter((c) => c.body.includes(marker));
+              if (existing.length > 0) {
+                const last = existing[existing.length - 1];
+                core.info(`Updating comment ${last.id}`);
+                await github.rest.issues.updateComment({
+                  owner, repo,
+                  body,
+                  comment_id: last.id,
+                });
+              } else {
+                core.info(`Creating a comment in issue / PR #${issue_number}`);
+                await github.rest.issues.createComment({issue_number, body, owner, repo});
+              }
+            }
+
+            const {owner, repo} = context.repo;
+            const run_id = ${{github.event.workflow_run.id}};
+
+            const pull_requests = ${{ toJSON(github.event.workflow_run.pull_requests) }};
+            if (!pull_requests.length) {
+              return core.error("This workflow doesn't match any pull requests!");
+            }
+
+            const artifacts = await github.paginate(
+              github.rest.actions.listWorkflowRunArtifacts, {owner, repo, run_id});
+            if (!artifacts.length) {
+              return core.error(`No artifacts found`);
+            }
+            let body = `Download the artifacts for this pull request:\n`;
+            for (const art of artifacts) {
+              body += `\n* [${art.name}.zip](https://nightly.link/${owner}/${repo}/actions/artifacts/${art.id}.zip)`;
+            }
+
+            core.info("Review thread message body:", body);
+
+            for (const pr of pull_requests) {
+              await upsertComment(owner, repo, pr.number,
+                "nightly-link", body);
+            }

.github/workflows/publish.yml

@@ -3,14 +3,18 @@ on:
     tags:
       - "v*"
 
+permissions:
+  id-token: write  # Required for OIDC
+  contents: write
+
 jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
-          node-version: 16
+          node-version: '24'
           registry-url: "https://registry.npmjs.org"
       - name: Install dependencies and build 🔧
         run: npm ci && npm run build
@@ -26,18 +30,14 @@ jobs:
           [ ${GITHUB_REF:11} = $(node -p "require('./package.json').version") ]
           echo "version=${GITHUB_REF:11}" >> $GITHUB_OUTPUT
       - name: Upload package file
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v7
         with:
           name: esptool-js-${{ steps.version.outputs.version }}.tgz
           path: esptool-js-${{ steps.version.outputs.version }}.tgz
-      - name: Create Release
-        id: create_release
-        uses: actions/create-release@v1.0.0
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - uses: ncipollo/release-action@v1
         with:
-          tag_name: ${{ github.ref }}
-          release_name: Espressif ESPTOOL-JS ${{ github.ref }}
+          artifacts: "./esptool-js-${{ steps.version.outputs.version }}.tgz"
+          name: Espressif ESPTOOL-JS ${{ github.ref }}
           draft: true
           body: |
             ### Release Highlights
@@ -49,17 +49,5 @@ jobs:
             ### Bug Fixes
 
             <!-- Insert The Bug Fixes below as points, also add relevant links -->
-      - name: Upload release
-        id: upload-release-asset
-        uses: actions/upload-release-asset@v1.0.1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./esptool-js-${{ steps.version.outputs.version }}.tgz
-          asset_name: esptool-js-${{ steps.version.outputs.version }}.tgz
-          asset_content_type: application/zip
       - name: Publish package on NPM 📦
         run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}