@onlyworlds/sdk 2.1.0 → 2.1.2

package/dist/index.d.mts

@@ -544,6 +544,7 @@ interface Marker extends BaseElement {
     x?: number;
     y?: number;
     z?: number;
+    order?: number;
 }
 /**
  * Pin element type
@@ -553,8 +554,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;
 }
 /**
@@ -1965,6 +1980,9 @@ declare const FIELD_SCHEMA: {
         readonly z: {
             readonly type: "number";
         };
+        readonly order: {
+            readonly type: "number";
+        };
     };
     readonly narrative: {
         readonly name: {
@@ -3007,6 +3025,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

@@ -544,6 +544,7 @@ interface Marker extends BaseElement {
     x?: number;
     y?: number;
     z?: number;
+    order?: number;
 }
 /**
  * Pin element type
@@ -553,8 +554,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;
 }
 /**
@@ -1965,6 +1980,9 @@ declare const FIELD_SCHEMA: {
         readonly z: {
             readonly type: "number";
         };
+        readonly order: {
+            readonly type: "number";
+        };
     };
     readonly narrative: {
         readonly name: {
@@ -3007,6 +3025,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}`;
           }
@@ -431,7 +461,7 @@ var ELEMENT_SECTIONS = {
     { name: "Details", order: 1, fields: ["background_color", "hierarchy", "width", "height", "depth", "parent_map", "location"] }
   ],
   ["marker" /* Marker */]: [
-    { name: "Details", order: 1, fields: ["map", "zone", "x", "y", "z"] }
+    { name: "Details", order: 1, fields: ["map", "zone", "x", "y", "z", "order"] }
   ],
   ["narrative" /* Narrative */]: [
     { name: "Context", order: 1, fields: ["story", "consequences", "start_date", "end_date", "order", "parent_narrative", "protagonist", "antagonist", "narrator", "conservator"] },
@@ -881,7 +911,8 @@ var FIELD_SCHEMA = {
     zone: { type: "single_link", target: "zone" },
     x: { type: "number" },
     y: { type: "number" },
-    z: { type: "number" }
+    z: { type: "number" },
+    order: { type: "number" }
   },
   narrative: {
     // Base fields (shared by all elements)

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}`;
           }
@@ -390,7 +420,7 @@ var ELEMENT_SECTIONS = {
     { name: "Details", order: 1, fields: ["background_color", "hierarchy", "width", "height", "depth", "parent_map", "location"] }
   ],
   ["marker" /* Marker */]: [
-    { name: "Details", order: 1, fields: ["map", "zone", "x", "y", "z"] }
+    { name: "Details", order: 1, fields: ["map", "zone", "x", "y", "z", "order"] }
   ],
   ["narrative" /* Narrative */]: [
     { name: "Context", order: 1, fields: ["story", "consequences", "start_date", "end_date", "order", "parent_narrative", "protagonist", "antagonist", "narrator", "conservator"] },
@@ -840,7 +870,8 @@ var FIELD_SCHEMA = {
     zone: { type: "single_link", target: "zone" },
     x: { type: "number" },
     y: { type: "number" },
-    z: { type: "number" }
+    z: { type: "number" },
+    order: { type: "number" }
   },
   narrative: {
     // Base fields (shared by all elements)

package/package.json

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