@onlyworlds/sdk 2.1.0 → 2.1.1

package/dist/index.d.mts

@@ -553,8 +553,22 @@ interface Pin extends BaseElement {
     map?: ElementId<ElementType.Map>;
     element_type?: ElementType;
     element_id?: AnyElementId;
+    /**
+     * X coordinate on map (must be integer)
+     * The API requires integer values. Float coordinates from mouse events
+     * or calculations should be rounded: Math.round(x)
+     */
     x?: number;
+    /**
+     * Y coordinate on map (must be integer)
+     * The API requires integer values. Float coordinates from mouse events
+     * or calculations should be rounded: Math.round(y)
+     */
     y?: number;
+    /**
+     * Z coordinate for 3D positioning (must be integer)
+     * The API requires integer values. Float coordinates should be rounded: Math.round(z)
+     */
     z?: number;
 }
 /**
@@ -3007,6 +3021,11 @@ declare class Resource<T, TInput> {
     create(data: TInput): Promise<T>;
     update(id: string, data: Partial<TInput>): Promise<T>;
     delete(id: string): Promise<void>;
+    /**
+     * Round Pin coordinates to integers (API requirement)
+     * @private
+     */
+    private roundPinCoordinates;
 }
 /**
  * Special resource class for World endpoint

package/dist/index.d.ts

@@ -553,8 +553,22 @@ interface Pin extends BaseElement {
     map?: ElementId<ElementType.Map>;
     element_type?: ElementType;
     element_id?: AnyElementId;
+    /**
+     * X coordinate on map (must be integer)
+     * The API requires integer values. Float coordinates from mouse events
+     * or calculations should be rounded: Math.round(x)
+     */
     x?: number;
+    /**
+     * Y coordinate on map (must be integer)
+     * The API requires integer values. Float coordinates from mouse events
+     * or calculations should be rounded: Math.round(y)
+     */
     y?: number;
+    /**
+     * Z coordinate for 3D positioning (must be integer)
+     * The API requires integer values. Float coordinates should be rounded: Math.round(z)
+     */
     z?: number;
 }
 /**
@@ -3007,6 +3021,11 @@ declare class Resource<T, TInput> {
     create(data: TInput): Promise<T>;
     update(id: string, data: Partial<TInput>): Promise<T>;
     delete(id: string): Promise<void>;
+    /**
+     * Round Pin coordinates to integers (API requirement)
+     * @private
+     */
+    private roundPinCoordinates;
 }
 /**
  * Special resource class for World endpoint

package/dist/index.js

@@ -191,20 +191,42 @@ var Resource = class {
     this.elementType = elementType;
   }
   async list(options) {
-    return this.client.request("GET", `/${this.elementType}/`, { params: options });
+    const response = await this.client.request("GET", `/${this.elementType}/`, { params: options });
+    if (Array.isArray(response)) {
+      return {
+        count: response.length,
+        next: null,
+        previous: null,
+        results: response
+      };
+    }
+    return response;
   }
   async get(id) {
     return this.client.request("GET", `/${this.elementType}/${id}/`);
   }
   async create(data) {
-    return this.client.request("POST", `/${this.elementType}/`, { body: data });
+    const body = this.elementType === "pin" ? this.roundPinCoordinates(data) : data;
+    return this.client.request("POST", `/${this.elementType}/`, { body });
   }
   async update(id, data) {
-    return this.client.request("PATCH", `/${this.elementType}/${id}/`, { body: data });
+    const body = this.elementType === "pin" ? this.roundPinCoordinates(data) : data;
+    return this.client.request("PATCH", `/${this.elementType}/${id}/`, { body });
   }
   async delete(id) {
     return this.client.request("DELETE", `/${this.elementType}/${id}/`);
   }
+  /**
+   * Round Pin coordinates to integers (API requirement)
+   * @private
+   */
+  roundPinCoordinates(data) {
+    const rounded = { ...data };
+    if (typeof rounded.x === "number") rounded.x = Math.round(rounded.x);
+    if (typeof rounded.y === "number") rounded.y = Math.round(rounded.y);
+    if (typeof rounded.z === "number") rounded.z = Math.round(rounded.z);
+    return rounded;
+  }
 };
 var WorldResource = class {
   constructor(client) {
@@ -284,7 +306,15 @@ var OnlyWorldsClient = class {
         if (errorText) {
           try {
             const errorJson = JSON.parse(errorText);
-            errorMessage += `: ${errorJson.detail || errorJson.error || errorText}`;
+            if (Array.isArray(errorJson.detail)) {
+              const validationErrors = errorJson.detail.map((err) => {
+                const location = err.loc ? err.loc.join(".") : "unknown";
+                return `${location}: ${err.msg}`;
+              }).join("; ");
+              errorMessage += `: ${validationErrors}`;
+            } else {
+              errorMessage += `: ${errorJson.detail || errorJson.error || errorText}`;
+            }
           } catch {
             errorMessage += `: ${errorText}`;
           }

package/dist/index.mjs

@@ -150,20 +150,42 @@ var Resource = class {
     this.elementType = elementType;
   }
   async list(options) {
-    return this.client.request("GET", `/${this.elementType}/`, { params: options });
+    const response = await this.client.request("GET", `/${this.elementType}/`, { params: options });
+    if (Array.isArray(response)) {
+      return {
+        count: response.length,
+        next: null,
+        previous: null,
+        results: response
+      };
+    }
+    return response;
   }
   async get(id) {
     return this.client.request("GET", `/${this.elementType}/${id}/`);
   }
   async create(data) {
-    return this.client.request("POST", `/${this.elementType}/`, { body: data });
+    const body = this.elementType === "pin" ? this.roundPinCoordinates(data) : data;
+    return this.client.request("POST", `/${this.elementType}/`, { body });
   }
   async update(id, data) {
-    return this.client.request("PATCH", `/${this.elementType}/${id}/`, { body: data });
+    const body = this.elementType === "pin" ? this.roundPinCoordinates(data) : data;
+    return this.client.request("PATCH", `/${this.elementType}/${id}/`, { body });
   }
   async delete(id) {
     return this.client.request("DELETE", `/${this.elementType}/${id}/`);
   }
+  /**
+   * Round Pin coordinates to integers (API requirement)
+   * @private
+   */
+  roundPinCoordinates(data) {
+    const rounded = { ...data };
+    if (typeof rounded.x === "number") rounded.x = Math.round(rounded.x);
+    if (typeof rounded.y === "number") rounded.y = Math.round(rounded.y);
+    if (typeof rounded.z === "number") rounded.z = Math.round(rounded.z);
+    return rounded;
+  }
 };
 var WorldResource = class {
   constructor(client) {
@@ -243,7 +265,15 @@ var OnlyWorldsClient = class {
         if (errorText) {
           try {
             const errorJson = JSON.parse(errorText);
-            errorMessage += `: ${errorJson.detail || errorJson.error || errorText}`;
+            if (Array.isArray(errorJson.detail)) {
+              const validationErrors = errorJson.detail.map((err) => {
+                const location = err.loc ? err.loc.join(".") : "unknown";
+                return `${location}: ${err.msg}`;
+              }).join("; ");
+              errorMessage += `: ${validationErrors}`;
+            } else {
+              errorMessage += `: ${errorJson.detail || errorJson.error || errorText}`;
+            }
           } catch {
             errorMessage += `: ${errorText}`;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "main": "dist/index.js",
   "module": "dist/index.mjs",