feat: add shared space support (#2486)

Author: giacomocusinato

.github/workflows/build.yml

@@ -275,6 +275,8 @@ jobs:
       - build-type-determination
       - select-targets
     env:
+      # https://github.blog/changelog/2024-03-07-github-actions-all-actions-will-run-on-node20-instead-of-node16-by-default/
+      ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION: true
       # Location of artifacts generated by build.
       BUILD_ARTIFACTS_PATH: electron-app/dist/build-artifacts
       # to skip passing signing credentials to electron-builder

arduino-ide-extension/src/browser/arduino-preferences.ts

@@ -228,6 +228,14 @@ const properties: ArduinoPreferenceSchemaProperties = {
     ),
     default: 'https://api2.arduino.cc/create',
   },
+  'arduino.cloud.sharedSpaceID': {
+    type: 'string',
+    description: nls.localize(
+      'arduino/preferences/cloud.sharedSpaceId',
+      'The ID of the Arduino Cloud shared space to load the sketchbook from. If empty, your private space is selected.'
+    ),
+    default: '',
+  },
   'arduino.auth.clientID': {
     type: 'string',
     description: nls.localize(
@@ -329,6 +337,7 @@ export interface ArduinoConfiguration {
   'arduino.cloud.push.warn': boolean;
   'arduino.cloud.pushpublic.warn': boolean;
   'arduino.cloud.sketchSyncEndpoint': string;
+  'arduino.cloud.sharedSpaceID': string;
   'arduino.auth.clientID': string;
   'arduino.auth.domain': string;
   'arduino.auth.audience': string;

arduino-ide-extension/src/browser/create/create-api.ts

@@ -509,11 +509,19 @@ export class CreateApi {
 
   private async headers(): Promise<Record<string, string>> {
     const token = await this.token();
-    return {
+    const headers: Record<string, string> = {
       'content-type': 'application/json',
       accept: 'application/json',
       authorization: `Bearer ${token}`,
     };
+
+    const sharedSpaceID =
+      this.arduinoPreferences['arduino.cloud.sharedSpaceID'];
+    if (sharedSpaceID) {
+      headers['x-organization'] = sharedSpaceID;
+    }
+
+    return headers;
   }
 
   private domain(apiVersion = 'v2'): string {

arduino-ide-extension/src/browser/widgets/sketchbook/sketchbook-tree-model.ts

@@ -127,6 +127,9 @@ export class SketchbookTreeModel extends FileTreeModel {
         if (preferenceName === 'arduino.sketchbook.showAllFiles') {
           this.updateRoot();
         }
+        if (preferenceName === 'arduino.cloud.sharedSpaceID') {
+          this.updateRoot();
+        }
       })
     );
 

arduino-ide-extension/src/test/node/boards-service-impl.slow-test.ts

@@ -113,13 +113,13 @@ describe('boards-service-impl', () => {
       expect(result.length).greaterThan(1);
       const lastIndex = result.length - 1;
       const last = result[lastIndex];
-      expect(last.id).to.be.equal('arduino:mbed');
+      expect(last.id).to.be.equal('Microsoft:win10');
       expect(last.deprecated).to.be.true;
-      const windowsIoTCoreIndex = result.findIndex(
-        (platform) => platform.id === 'Microsoft:win10'
+      const arduinoMbedCoreIndex = result.findIndex(
+        (platform) => platform.id === 'arduino:mbed'
       );
-      expect(windowsIoTCoreIndex).to.be.greaterThanOrEqual(0);
-      expect(windowsIoTCoreIndex).to.be.lessThan(lastIndex);
+      expect(arduinoMbedCoreIndex).to.be.greaterThanOrEqual(0);
+      expect(arduinoMbedCoreIndex).to.be.lessThan(lastIndex);
       const first = result[0];
       expect(typeof first.deprecated).to.be.equal('boolean');
       expect(first.deprecated).to.be.false;

i18n/en.json

@@ -368,6 +368,7 @@
       "cloud.pull.warn": "True if users should be warned before pulling a cloud sketch. Defaults to true.",
       "cloud.push.warn": "True if users should be warned before pushing a cloud sketch. Defaults to true.",
       "cloud.pushpublic.warn": "True if users should be warned before pushing a public sketch to the cloud. Defaults to true.",
+      "cloud.sharedSpaceId": "The ID of the Arduino Cloud shared space to load the sketchbook from. If empty, your private space is selected.",
       "cloud.sketchSyncEndpoint": "The endpoint used to push and pull sketches from a backend. By default it points to Arduino Cloud API.",
       "compile": "compile",
       "compile.experimental": "True if the IDE should handle multiple compiler errors. False by default",