@vidyano-labs/virtual-service 0.4.3 → 0.5.0

package/README.md

@@ -144,7 +144,7 @@ Common attribute types supported by the virtual service:
 | `Date` | Dates only | `"2026-01-23"` |
 | `Byte` | Small integers (0-255) | `128` |
 
-> **Note:** Values are stored as strings in DTOs but converted to JavaScript types when accessed through `getValue()`. Boolean attributes accept both native booleans and string values `"True"`/`"False"`.
+> **Note:** Use native JavaScript types (boolean, number, Date, etc.) when setting attribute values. The `getValue<T>()` and `setValue<T>()` methods work directly with these types and support generics for type safety (e.g., `getValue<number>()`).
 
 ### Attribute Configuration
 
@@ -1142,8 +1142,8 @@ async onSave(obj: VirtualPersistentObject): Promise<VirtualPersistentObject> {
 | Method | Description |
 |--------|-------------|
 | `getAttribute(name)` | Get attribute by name |
-| `getAttributeValue(name)` | Get converted attribute value |
-| `setAttributeValue(name, value)` | Set attribute value with conversion |
+| `getAttributeValue<T>(name)` | Get attribute value |
+| `setAttributeValue<T>(name, value)` | Set attribute value |
 | `setValidationError(name, error)` | Set validation error (pass `null`/empty to clear) |
 | `setNotification(msg, type, duration?)` | Set notification |
 | `service` | Reference to the VirtualService instance |
@@ -1152,8 +1152,8 @@ async onSave(obj: VirtualPersistentObject): Promise<VirtualPersistentObject> {
 
 | Method | Description |
 |--------|-------------|
-| `getValue()` | Get converted value |
-| `setValue(value)` | Set value with conversion |
+| `getValue<T>()` | Get value |
+| `setValue<T>(value)` | Set value |
 | `setValidationError(error)` | Set validation error (pass `null`/empty to clear) |
 | `persistentObject` | Reference to the parent VirtualPersistentObject |
 | `service` | Reference to the VirtualService instance |

package/index.d.ts

@@ -93,13 +93,13 @@ type VirtualPersistentObjectAttributeWithReference = Dto.PersistentObjectAttribu
  */
 type VirtualPersistentObjectAttributeHelpers = {
     /**
-     * Gets the converted value of this attribute (e.g., Boolean as boolean, Int32 as number)
+     * Gets the value of this attribute
      */
-    getValue(): any;
+    getValue<T = any>(): T;
     /**
-     * Sets the value of this attribute with automatic type conversion
+     * Sets the value of this attribute
      */
-    setValue(value: any): void;
+    setValue<T = any>(value: T): void;
     /**
      * Sets a validation error on this attribute. Pass null/empty to clear.
      */
@@ -125,11 +125,11 @@ type VirtualPersistentObject = Omit<Dto.PersistentObjectDto, "queries"> & {
     /**
      * Gets the value of an attribute by name
      */
-    getAttributeValue(name: string): any;
+    getAttributeValue<T = any>(name: string): T;
     /**
      * Sets the value of an attribute by name
      */
-    setAttributeValue(name: string, value: any): void;
+    setAttributeValue<T = any>(name: string, value: T): void;
     /**
      * Sets a notification message on the persistent object
      */

package/index.js

@@ -471,8 +471,9 @@ function createVirtualQuery(dto, config, service) {
     return proxy;
 }
 /**
- * Unwraps a VirtualQuery to get the underlying DTO
- * @param wrapped - The VirtualQuery to unwrap
+ * Unwraps a VirtualQuery to get the underlying DTO.
+ * Also accepts raw DTOs for recursive handling.
+ * @param wrapped - The VirtualQuery or QueryDto to unwrap
  * @returns The underlying QueryDto
  */
 function unwrapVirtualQuery(wrapped) {
@@ -521,13 +522,14 @@ function createVirtualQueryResultItem(dto, query) {
  * @returns A VirtualPersistentObjectAttribute that combines DTO properties with helper methods
  */
 function createVirtualPersistentObjectAttribute(attr, persistentObject, service) {
+    const internalAttr = attr;
     const helpers = {
         getValue() {
-            return fromServiceString(attr.value, attr.type);
+            return internalAttr.value;
         },
         setValue(value) {
-            attr.value = toServiceString(value, attr.type);
-            attr.isValueChanged = true;
+            internalAttr.value = value;
+            internalAttr.isValueChanged = true;
         },
         setValidationError(error) {
             attr.validationError = error || undefined;
@@ -539,7 +541,7 @@ function createVirtualPersistentObjectAttribute(attr, persistentObject, service)
             return service;
         }
     };
-    return new Proxy(attr, {
+    return new Proxy(internalAttr, {
         get(target, prop) {
             if (prop in helpers) {
                 const value = helpers[prop];
@@ -547,8 +549,19 @@ function createVirtualPersistentObjectAttribute(attr, persistentObject, service)
             }
             return target[prop];
         },
-        set(target, prop, value) {
-            target[prop] = value;
+        set(target, prop, newValue) {
+            if (prop === "value") {
+                const oldValue = target.value;
+                const hasChanged = oldValue instanceof Date && newValue instanceof Date
+                    ? oldValue.getTime() !== newValue.getTime()
+                    : oldValue !== newValue;
+                if (hasChanged) {
+                    target.value = newValue;
+                    target.isValueChanged = true;
+                }
+            }
+            else
+                target[prop] = newValue;
             return true;
         }
     });
@@ -616,15 +629,21 @@ function createVirtualPersistentObject(dto, service) {
     return proxy;
 }
 /**
- * Unwraps a VirtualPersistentObject to get the underlying DTO
- * Since the Proxy wraps the DTO, we can safely cast it back
- * @param wrapped - The VirtualPersistentObject to unwrap
- * @returns The underlying PersistentObjectDto
+ * Unwraps a VirtualPersistentObject to get a DTO suitable for wire transmission.
+ * Converts primitive values to service string format.
+ * Also accepts raw DTOs for recursive handling of parent/nested objects.
  */
 function unwrapVirtualPersistentObject(wrapped) {
-    // The wrapped object is a Proxy around the DTO
-    // We can return it as-is since the DTO is the target of the Proxy
-    return wrapped;
+    const dto = wrapped;
+    return {
+        ...dto,
+        attributes: dto.attributes?.map(attr => ({
+            ...attr,
+            value: attr.value != null ? toServiceString(attr.value, attr.type) : attr.value
+        })),
+        parent: dto.parent ? unwrapVirtualPersistentObject(dto.parent) : undefined,
+        queries: dto.queries?.map(q => unwrapVirtualQuery(q))
+    };
 }
 
 var _a;
@@ -851,6 +870,9 @@ class VirtualServiceHooks extends ServiceHooks {
         clientAttr.tab = configAttr.tab || "";
         clientAttr.column = configAttr.column;
         clientAttr.columnSpan = configAttr.columnSpan;
+        // Convert incoming service string to primitive
+        if (clientAttr.value != null)
+            clientAttr.value = fromServiceString(clientAttr.value, clientAttr.type);
         // Reference attribute properties - only set if explicitly configured
         if (configAttr.lookup) {
             const refAttr = clientAttr;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vidyano-labs/virtual-service",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "Virtual service implementation for testing Vidyano applications",
   "type": "module",
   "main": "index.js",
@@ -20,5 +20,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHash": "61b241fe7c8e867fb6ee9b2c1d7acc19e6a6dc60"
+  "gitHash": "3d37759c3014945a12137766692d4501d0eb465a"
 }