feat(api): add SERIALIZE_TO_IPC_FN const and implement it for dpi types, add more constructors

.changes/api-dpi-toJSON-toIPC.md

@@ -0,0 +1,8 @@
+---
+"@tauri-apps/api": "minor:enhance"
+---
+
+Improved support for `dpi` module types to allow these types to be used without manual conversions with `invoke`:
+
+- Added `toIPC`  method on `PhysicalSize`, `PhysicalPosition`, `LogicalSize` and `LogicalPosition` to convert it into a valid IPC-compatible value that can be deserialized correctly on the Rust side into its equivalent struct.
+- Implemented `toJSON`  method on `PhysicalSize`, `PhysicalPosition`, `LogicalSize` and `LogicalPosition` that calls the new `toIPC` method, so `JSON.stringify` would serialize these types correctly.

crates/tauri/scripts/ipc.js

@@ -88,6 +88,45 @@
       return
     }
 
+    // `postMessage` uses `structuredClone` to serialize the data before sending it
+    // unlike `JSON.stringify`, we can't extend a type with a method similar to `toJSON`
+    // so that `structuredClone` would use, so until https://github.com/whatwg/html/issues/7428
+    // we manually call `toIPC`
+    function processToIPCKey(data) {
+      // if this value changes, make sure to update it in:
+      // 1. process-ipc-message-fn.js
+      // 2. core.ts
+      const ToIPCKey = '__TAURI_TO_IPC_KEY__'
+
+      if (
+        typeof data === 'object' &&
+        'constructor' in data &&
+        data.constructor === Array
+      ) {
+        return data.map((v) => processToIPCKey(v))
+      }
+
+      if (typeof data === 'object' && ToIPCKey in data) {
+        return data[ToIPCKey]()
+      }
+
+      if (
+        typeof data === 'object' &&
+        'constructor' in data &&
+        data.constructor === Object
+      ) {
+        const acc = {}
+        Object.entries(data).forEach(([k, v]) => {
+          acc[k] = processToIPCKey(v)
+        })
+        return acc
+      }
+
+      return data
+    }
+
+    data.payload = processToIPCKey(data.payload)
+
     isolation.frame.contentWindow.postMessage(
       data,
       '*' /* todo: set this to the secure origin */

crates/tauri/scripts/process-ipc-message-fn.js

@@ -16,20 +16,25 @@
     }
   } else {
     const data = JSON.stringify(message, (_k, val) => {
+      // if this value changes, make sure to update it in:
+      // 1. ipc.js
+      // 2. core.ts
+      const ToIPCKey = '__TAURI_TO_IPC_KEY__'
+
       if (val instanceof Map) {
-        let o = {}
-        val.forEach((v, k) => (o[k] = v))
-        return o
+        return Object.fromEntries(val.entries())
       } else if (val instanceof Uint8Array) {
         return Array.from(val)
       } else if (val instanceof ArrayBuffer) {
         return Array.from(new Uint8Array(val))
       }  else if (
-        val instanceof Object &&
+        typeof val === "object" &&
         '__TAURI_CHANNEL_MARKER__' in val &&
         typeof val.id === 'number'
       ) {
         return `__CHANNEL__:${val.id}`
+      } else if (typeof val === "object" && ToIPCKey in val) {
+        return val[ToIPCKey]()
       } else {
         return val
       }

crates/tauri/src/window/mod.rs

@@ -2041,7 +2041,7 @@ tauri::Builder::default()
   docsrs,
   doc(cfg(any(target_os = "macos", target_os = "linux", windows)))
 )]
-#[derive(serde::Deserialize)]
+#[derive(serde::Deserialize, Debug)]
 pub struct ProgressBarState {
   /// The progress bar status.
   pub status: Option<ProgressBarStatus>,

packages/api/eslint.config.js

@@ -8,7 +8,7 @@ import prettierConfig from 'eslint-config-prettier'
 import securityPlugin from 'eslint-plugin-security'
 import tseslint from 'typescript-eslint'
 
-/** @type {import('eslint').Linter.FlatConfig[]} */
+/** @type {import('eslint').Linter.Config} */
 export default [
   eslint.configs.recommended,
   prettierConfig,

packages/api/package.json

@@ -40,8 +40,8 @@
     "npm-pack": "pnpm build && cd ./dist && npm pack",
     "npm-publish": "pnpm build && cd ./dist && pnpm publish --access public --loglevel silly --tag next --no-git-checks",
     "ts:check": "tsc --noEmit",
-    "eslint:check": "eslint src/**.ts",
-    "eslint:fix": "eslint src/**.ts --fix"
+    "eslint:check": "eslint src/**/*.ts",
+    "eslint:fix": "eslint src/**/*.ts --fix"
   },
   "devDependencies": {
     "@eslint/js": "^9.4.0",

packages/api/src/core.ts

@@ -258,6 +258,56 @@ export class Resource {
   }
 }
 
+/**
+ * A key to be used to implement a special function
+ * on your types that define how your type should be serialized
+ * when passing across the IPC.
+ * @example
+ * Given a type in Rust that looks like this
+ * ```rs
+ * #[derive(serde::Serialize, serde::Deserialize)
+ * enum UserId {
+ *   String(String),
+ *   Number(u32),
+ * }
+ * ```
+ * `UserId::String("id")` would be serialized into `{ String: "id" }`
+ * and so we need to pass the same structure back to Rust
+ * ```ts
+ * import { ToIPCKey } from "@tauri-apps/api/core"
+ *
+ * class UserIdString {
+ *   id
+ *   constructor(id) {
+ *     this.id = id
+ *   }
+ *
+ *   [ToIPCKey]() {
+ *     return { String: this.id }
+ *   }
+ * }
+ *
+ * class UserIdNumber {
+ *   id
+ *   constructor(id) {
+ *     this.id = id
+ *   }
+ *
+ *   [ToIPCKey]() {
+ *     return { Number: this.id }
+ *   }
+ * }
+ *
+ *
+ * type UserId = UserIdString | UserIdNumber
+ * ```
+ *
+ */
+// if this value changes, make sure to update it in:
+// 1. ipc.js
+// 2. process-ipc-message-fn.js
+export const ToIPCKey = '__TAURI_TO_IPC_KEY__'
+
 function isTauri(): boolean {
   return 'isTauri' in window && !!window.isTauri
 }