xmpkit 0.1.3

Pure Rust implementation of Adobe XMP Toolkit
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

//! WebAssembly error handling for XMP operations

use crate::core::error::XmpError as RustXmpError;
use wasm_bindgen::prelude::*;

/// WebAssembly error type for XMP operations
///
/// This provides structured error information that JavaScript can inspect.
///
/// # Example
///
/// ```javascript
/// import { XmpErrorKind } from './pkg/xmpkit.js';
/// try {
///     file.from_bytes(data);
/// } catch (error) {
///     if (error instanceof XmpError) {
///         if (error.kind === XmpErrorKind.BadParam) {
///             console.log("Bad parameter error:", error.message);
///         }
///     }
/// }
/// ```
#[wasm_bindgen]
pub struct XmpError {
    kind: XmpErrorKind,
    message: String,
}

impl std::fmt::Display for XmpError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:?}: {}", self.kind, self.message)
    }
}

/// XMP Error kinds (exported enum for JavaScript)
///
/// These enum values can be used in JavaScript to check error types:
///
/// ```javascript
/// import { XmpErrorKind } from './pkg/xmpkit.js';
/// try {
///     file.from_bytes(data);
/// } catch (error) {
///     if (error.kind() === XmpErrorKind.BadParam) {
///         console.log("Bad parameter error");
///     }
/// }
/// ```
#[wasm_bindgen]
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum XmpErrorKind {
    /// Bad parameter error
    BadParam,
    /// Bad value error
    BadValue,
    /// Bad schema error
    BadSchema,
    /// Bad XPath error
    BadXPath,
    /// Parse error
    ParseError,
    /// Serialization error
    SerializationError,
    /// IO error
    IoError,
    /// Internal error
    InternalError,
    /// Not found error
    NotFound,
    /// Not supported error
    NotSupported,
}

#[wasm_bindgen]
impl XmpError {
    /// Get the error kind enum value
    #[wasm_bindgen(getter)]
    pub fn kind(&self) -> XmpErrorKind {
        self.kind
    }

    /// Get the error message
    #[wasm_bindgen(getter)]
    pub fn message(&self) -> String {
        self.message.clone()
    }
}

/// Convert Rust XmpError to WebAssembly XmpError
pub(crate) fn xmp_error_to_wasm_error(err: RustXmpError) -> XmpError {
    let (kind, message) = match &err {
        RustXmpError::BadParam(msg) => (XmpErrorKind::BadParam, msg.clone()),
        RustXmpError::BadValue(msg) => (XmpErrorKind::BadValue, msg.clone()),
        RustXmpError::BadSchema(msg) => (XmpErrorKind::BadSchema, msg.clone()),
        RustXmpError::BadXPath(msg) => (XmpErrorKind::BadXPath, msg.clone()),
        RustXmpError::ParseError(msg) => (XmpErrorKind::ParseError, msg.clone()),
        RustXmpError::SerializationError(msg) => (XmpErrorKind::SerializationError, msg.clone()),
        RustXmpError::IoError(io_err) => (XmpErrorKind::IoError, io_err.to_string()),
        RustXmpError::InternalError(msg) => (XmpErrorKind::InternalError, msg.clone()),
        RustXmpError::NotFound(msg) => (XmpErrorKind::NotFound, msg.clone()),
        RustXmpError::NotSupported(msg) => (XmpErrorKind::NotSupported, msg.clone()),
    };
    XmpError { kind, message }
}