@object-ui/data-objectstack 11.4.0 → 11.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @object-ui/data-objectstack
 
+## 11.5.0
+
+### Minor Changes
+
+- 1072701: Import wizard: use registered server-side import mappings (framework #2611). When an object has `mapping` metadata artifacts targeting it, the wizard shows a "Saved mapping" selector; picking one hands rename + transforms + write semantics to the server (the artifact is authoritative), replaces the manual column table with a read-only summary of the mapping, and submits `mappingName` over source-header rows (mutually exclusive with the inline column rename). `ImportRequestOptions` gains `mappingName`; the objectstack adapter gains `listImportMappings(objectName)` (feature-detected — the selector simply doesn't appear when unsupported). New `grid.import.*` strings added across all locales.
+
+### Patch Changes
+
+- Updated dependencies [9255686]
+- Updated dependencies [1072701]
+  - @object-ui/types@11.5.0
+  - @object-ui/core@11.5.0
+
 ## 11.4.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -2645,6 +2645,25 @@ var ObjectStackAdapter = class {
       return [];
     }
   }
+  /**
+   * List registered import `mapping` artifacts targeting a given object
+   * (framework #2611). Reads the `mapping` metadata kind via the overlay API
+   * and filters by `targetObject` client-side (the metadata index is
+   * name-only). Feeds the import wizard's "saved mapping" selector; a failure
+   * (older server without the `mapping` kind) degrades to an empty list, so
+   * the selector simply doesn't appear.
+   */
+  async listImportMappings(objectName) {
+    await this.connect();
+    try {
+      const result = await this.client.meta.getItems("mapping");
+      const items = Array.isArray(result?.items) ? result.items : Array.isArray(result) ? result : [];
+      return items.filter((m) => m && m.targetObject === objectName);
+    } catch (err) {
+      console.warn("[OBJECTSTACKDataSource] listImportMappings failed:", err);
+      return [];
+    }
+  }
   /**
    * Create a new overlay view for an object. The view's `name` is the
    * stable identifier — must be unique within the project scope. Returns

package/dist/index.d.cts

@@ -1621,6 +1621,15 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * client-side because the metadata index is name-only, not field-typed.
      */
     listViews(objectName: string): Promise<any[]>;
+    /**
+     * List registered import `mapping` artifacts targeting a given object
+     * (framework #2611). Reads the `mapping` metadata kind via the overlay API
+     * and filters by `targetObject` client-side (the metadata index is
+     * name-only). Feeds the import wizard's "saved mapping" selector; a failure
+     * (older server without the `mapping` kind) degrades to an empty list, so
+     * the selector simply doesn't appear.
+     */
+    listImportMappings(objectName: string): Promise<any[]>;
     /**
      * Create a new overlay view for an object. The view's `name` is the
      * stable identifier — must be unique within the project scope. Returns

package/dist/index.d.ts

@@ -1621,6 +1621,15 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * client-side because the metadata index is name-only, not field-typed.
      */
     listViews(objectName: string): Promise<any[]>;
+    /**
+     * List registered import `mapping` artifacts targeting a given object
+     * (framework #2611). Reads the `mapping` metadata kind via the overlay API
+     * and filters by `targetObject` client-side (the metadata index is
+     * name-only). Feeds the import wizard's "saved mapping" selector; a failure
+     * (older server without the `mapping` kind) degrades to an empty list, so
+     * the selector simply doesn't appear.
+     */
+    listImportMappings(objectName: string): Promise<any[]>;
     /**
      * Create a new overlay view for an object. The view's `name` is the
      * stable identifier — must be unique within the project scope. Returns

package/dist/index.js

@@ -2597,6 +2597,25 @@ var ObjectStackAdapter = class {
       return [];
     }
   }
+  /**
+   * List registered import `mapping` artifacts targeting a given object
+   * (framework #2611). Reads the `mapping` metadata kind via the overlay API
+   * and filters by `targetObject` client-side (the metadata index is
+   * name-only). Feeds the import wizard's "saved mapping" selector; a failure
+   * (older server without the `mapping` kind) degrades to an empty list, so
+   * the selector simply doesn't appear.
+   */
+  async listImportMappings(objectName) {
+    await this.connect();
+    try {
+      const result = await this.client.meta.getItems("mapping");
+      const items = Array.isArray(result?.items) ? result.items : Array.isArray(result) ? result : [];
+      return items.filter((m) => m && m.targetObject === objectName);
+    } catch (err) {
+      console.warn("[OBJECTSTACKDataSource] listImportMappings failed:", err);
+      return [];
+    }
+  }
   /**
    * Create a new overlay view for an object. The view's `name` is the
    * stable identifier — must be unique within the project scope. Returns

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/data-objectstack",
-  "version": "11.4.0",
+  "version": "11.5.0",
   "description": "ObjectStack Data Adapter for Object UI",
   "license": "MIT",
   "type": "module",
@@ -23,8 +23,8 @@
   ],
   "dependencies": {
     "@objectstack/client": "^11.5.0",
-    "@object-ui/core": "11.4.0",
-    "@object-ui/types": "11.4.0"
+    "@object-ui/core": "11.5.0",
+    "@object-ui/types": "11.5.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",

package/src/index.ts

@@ -1889,6 +1889,28 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     }
   }
 
+  /**
+   * List registered import `mapping` artifacts targeting a given object
+   * (framework #2611). Reads the `mapping` metadata kind via the overlay API
+   * and filters by `targetObject` client-side (the metadata index is
+   * name-only). Feeds the import wizard's "saved mapping" selector; a failure
+   * (older server without the `mapping` kind) degrades to an empty list, so
+   * the selector simply doesn't appear.
+   */
+  async listImportMappings(objectName: string): Promise<any[]> {
+    await this.connect();
+    try {
+      const result: any = await this.client.meta.getItems('mapping');
+      const items: any[] = Array.isArray(result?.items)
+        ? result.items
+        : Array.isArray(result) ? result : [];
+      return items.filter((m: any) => m && m.targetObject === objectName);
+    } catch (err) {
+      console.warn('[OBJECTSTACKDataSource] listImportMappings failed:', err);
+      return [];
+    }
+  }
+
   /**
    * Create a new overlay view for an object. The view's `name` is the
    * stable identifier — must be unique within the project scope. Returns