@mywallpaper/addon-sdk 2.13.0 → 2.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mywallpaper/addon-sdk",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "SDK for building MyWallpaper addons - TypeScript types, manifest validation, and utilities",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/runtime/addon-client.js

@@ -30,6 +30,7 @@
   var pendingOAuthScopes = new Map()
   var pendingFileAccess = new Map()
   var pendingNetworkAccess = new Map()  // For on-demand domain permission requests
+  var pendingSystem = new Map()  // requestId -> { resolve, reject } for system API
   var grantedBlobUrls = new Map() // settingKey -> blobUrl
   var dynamicSettingsOptions = new Map() // settingKey -> options[] (dynamic options from widget)
   var buttonCallbacks = new Map() // settingKey -> callback function for button clicks
@@ -244,6 +245,19 @@
         }
         break
 
+      case 'SYSTEM_RESPONSE':
+        // Handle system API response (openPath, etc.)
+        var sysOp = pendingSystem.get(d.payload.requestId)
+        if (sysOp) {
+          pendingSystem.delete(d.payload.requestId)
+          if (d.payload.success) {
+            sysOp.resolve({ success: true })
+          } else {
+            sysOp.reject(new Error(d.payload.error || 'System operation failed'))
+          }
+        }
+        break
+
       case 'AUDIO_STATE':
         // Sync audio state from host
         audioState = d.payload || d
@@ -852,8 +866,67 @@
         dynamicSettingsOptions.delete(settingKey)
         send('SETTINGS_OPTIONS_RESET', { settingKey: settingKey })
       }
+    },
+
+    /**
+     * System API - Interact with the host operating system
+     * Allows opening URLs, files, folders, and applications
+     *
+     * Requires 'system' permission in manifest:
+     * { "permissions": { "system": { "openPath": true } } }
+     *
+     * @example
+     * // Open a URL
+     * await MyWallpaper.system.openPath('https://github.com')
+     *
+     * // Open a folder in file explorer
+     * await MyWallpaper.system.openPath('/home/user/Documents', { type: 'folder' })
+     *
+     * // Open an app via protocol handler
+     * await MyWallpaper.system.openPath('spotify://open')
+     */
+    system: {
+      /**
+       * Open a URL, file, folder, or application
+       *
+       * @param {string} path - The path to open:
+       *   - URL: https://example.com
+       *   - File: /path/to/file.pdf (executes with default app)
+       *   - Folder: /path/to/folder (opens in file explorer)
+       *   - Protocol: spotify://, discord://, vscode:// (opens app)
+       * @param {object} options - Optional configuration
+       * @param {string} options.type - Force type: 'auto'|'url'|'file'|'folder'|'protocol'
+       * @returns {Promise<{success: true}>} Resolves when operation completes
+       * @throws {Error} If operation fails or permission denied
+       */
+      openPath: function (path, options) {
+        return new Promise(function (resolve, reject) {
+          if (!path || typeof path !== 'string') {
+            reject(new Error('path is required and must be a string'))
+            return
+          }
+
+          var id = Date.now() + '-' + Math.random().toString(36).slice(2)
+          pendingSystem.set(id, { resolve: resolve, reject: reject })
+
+          // Timeout after 10 seconds
+          setTimeout(function () {
+            if (pendingSystem.has(id)) {
+              pendingSystem.delete(id)
+              reject(new Error('System operation timeout'))
+            }
+          }, 10000)
+
+          options = options || {}
+          send('SYSTEM_OPEN_PATH', {
+            path: path,
+            type: options.type || 'auto',
+            requestId: id
+          })
+        })
+      }
     }
   }
 
-  console.warn('[MyWallpaper] SDK v2.13.0 ready:', layerId)
+  console.warn('[MyWallpaper] SDK v2.14.0 ready:', layerId)
 })()