@object-ui/data-objectstack 13.2.0 → 14.0.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @object-ui/data-objectstack
 
+## 14.0.0
+
+### Minor Changes
+
+- 6a74160: Sharing-rule form: pick, don't type. Three new widget-hint field components make
+  the generic object form render pickers where an admin previously had to type
+  machine data (driven by the framework `widget` hints on `sys_sharing_rule`;
+  generalizes the `capability-multiselect` pattern). All degrade to the underlying
+  `type` renderer when a widget is unregistered.
+
+  - **`object-ref`** — choose a registered object by name (searchable `Combobox`),
+    backed by the new `DataSource.getObjects()` (`ObjectStackAdapter` lists code-
+    and DB-defined objects via `/api/v1/meta/object`), falling back to a
+    `sys_metadata` query. Stores the object's `name`.
+  - **`filter-condition`** — a visual criteria builder (`FilterBuilder`) scoped to
+    the fields of the object chosen in a sibling field (via `getObjectSchema`),
+    round-tripping the stored **MongoDB-style** FilterCondition JSON. Criteria the
+    builder can't represent (or invalid JSON) fall back to a raw-JSON editor, with
+    an always-available "Edit as JSON" toggle — nothing is hidden or lost.
+  - **`recipient-picker`** — a record picker whose target object follows a sibling
+    `recipient_type` (`user`→sys_user, `team`→sys_team, `business_unit`/
+    `unit_and_subordinates`→sys_business_unit, `position`→sys_position), storing the
+    value the evaluator matches on (a record id, or the position **name**). Resets
+    the stored id when the type changes.
+
+  Wiring: the three keys join `DATA_SOURCE_FIELD_TYPES` (form.tsx) so the form
+  threads `dataSource` + `dependentValues` to them, and `INLINE_EXCLUDED_FIELD_TYPES`
+  (they're authored in the record form, not a grid cell). `DataSource.getObjects()`
+  is optional on the interface; the ObjectStack adapter implements it.
+
+### Patch Changes
+
+- Updated dependencies [443360a]
+- Updated dependencies [86c69c3]
+- Updated dependencies [05e56ca]
+- Updated dependencies [6a74160]
+  - @object-ui/core@14.0.0
+  - @object-ui/types@14.0.0
+
 ## 13.2.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -2525,6 +2525,35 @@ var ObjectStackAdapter = class {
     const data = body && typeof body === "object" && "success" in body && "data" in body ? body.data : body;
     return data && typeof data === "object" && "item" in data ? data.item : data;
   }
+  /**
+   * List every registered object (code- and DB-defined) from the metadata
+   * registry — `GET /api/v1/meta/object`. Returns lightweight `{ name, label }`
+   * headers for object-picker widgets (e.g. the sharing-rule `object-ref`
+   * field). The list endpoint is uncached server-side, so no cache-busting
+   * dance is needed. Returns `[]` on any failure so callers degrade gracefully.
+   */
+  async getObjects() {
+    try {
+      await this.connect();
+      const baseUrl = (this.baseUrl || "").replace(/\/$/, "");
+      const hasApiVersionSuffix = /\/api\/v\d+$/i.test(baseUrl);
+      const metaPath = hasApiVersionSuffix ? "/meta" : "/api/v1/meta";
+      const url = `${baseUrl}${metaPath}/object`;
+      const headers = { "Content-Type": "application/json" };
+      if (this.token) headers["Authorization"] = `Bearer ${this.token}`;
+      const res = await this.fetchImpl(url, { method: "GET", headers });
+      if (!res.ok) return [];
+      const body = await res.json();
+      const data = body && typeof body === "object" && "success" in body && "data" in body ? body.data : body;
+      const items = Array.isArray(data) ? data : Array.isArray(data?.items) ? data.items : [];
+      return items.map((it) => ({
+        name: String(it?.name ?? ""),
+        label: it?.label != null ? String(it.label) : void 0
+      })).filter((it) => it.name);
+    } catch {
+      return [];
+    }
+  }
   /**
    * Get access to the underlying ObjectStack client for advanced operations.
    */

package/dist/index.d.cts

@@ -1557,6 +1557,17 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * not expose the request cache mode.
      */
     private fetchObjectSchemaFresh;
+    /**
+     * List every registered object (code- and DB-defined) from the metadata
+     * registry — `GET /api/v1/meta/object`. Returns lightweight `{ name, label }`
+     * headers for object-picker widgets (e.g. the sharing-rule `object-ref`
+     * field). The list endpoint is uncached server-side, so no cache-busting
+     * dance is needed. Returns `[]` on any failure so callers degrade gracefully.
+     */
+    getObjects(): Promise<Array<{
+        name: string;
+        label?: string;
+    }>>;
     /**
      * Get access to the underlying ObjectStack client for advanced operations.
      */

package/dist/index.d.ts

@@ -1557,6 +1557,17 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * not expose the request cache mode.
      */
     private fetchObjectSchemaFresh;
+    /**
+     * List every registered object (code- and DB-defined) from the metadata
+     * registry — `GET /api/v1/meta/object`. Returns lightweight `{ name, label }`
+     * headers for object-picker widgets (e.g. the sharing-rule `object-ref`
+     * field). The list endpoint is uncached server-side, so no cache-busting
+     * dance is needed. Returns `[]` on any failure so callers degrade gracefully.
+     */
+    getObjects(): Promise<Array<{
+        name: string;
+        label?: string;
+    }>>;
     /**
      * Get access to the underlying ObjectStack client for advanced operations.
      */

package/dist/index.js

@@ -2477,6 +2477,35 @@ var ObjectStackAdapter = class {
     const data = body && typeof body === "object" && "success" in body && "data" in body ? body.data : body;
     return data && typeof data === "object" && "item" in data ? data.item : data;
   }
+  /**
+   * List every registered object (code- and DB-defined) from the metadata
+   * registry — `GET /api/v1/meta/object`. Returns lightweight `{ name, label }`
+   * headers for object-picker widgets (e.g. the sharing-rule `object-ref`
+   * field). The list endpoint is uncached server-side, so no cache-busting
+   * dance is needed. Returns `[]` on any failure so callers degrade gracefully.
+   */
+  async getObjects() {
+    try {
+      await this.connect();
+      const baseUrl = (this.baseUrl || "").replace(/\/$/, "");
+      const hasApiVersionSuffix = /\/api\/v\d+$/i.test(baseUrl);
+      const metaPath = hasApiVersionSuffix ? "/meta" : "/api/v1/meta";
+      const url = `${baseUrl}${metaPath}/object`;
+      const headers = { "Content-Type": "application/json" };
+      if (this.token) headers["Authorization"] = `Bearer ${this.token}`;
+      const res = await this.fetchImpl(url, { method: "GET", headers });
+      if (!res.ok) return [];
+      const body = await res.json();
+      const data = body && typeof body === "object" && "success" in body && "data" in body ? body.data : body;
+      const items = Array.isArray(data) ? data : Array.isArray(data?.items) ? data.items : [];
+      return items.map((it) => ({
+        name: String(it?.name ?? ""),
+        label: it?.label != null ? String(it.label) : void 0
+      })).filter((it) => it.name);
+    } catch {
+      return [];
+    }
+  }
   /**
    * Get access to the underlying ObjectStack client for advanced operations.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/data-objectstack",
-  "version": "13.2.0",
+  "version": "14.0.0",
   "description": "ObjectStack Data Adapter for Object UI",
   "license": "MIT",
   "type": "module",
@@ -22,9 +22,9 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@objectstack/client": "^14.3.0",
-    "@object-ui/core": "13.2.0",
-    "@object-ui/types": "13.2.0"
+    "@objectstack/client": "^14.6.0",
+    "@object-ui/core": "14.0.0",
+    "@object-ui/types": "14.0.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",

package/src/index.ts

@@ -1725,6 +1725,49 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     return data && typeof data === 'object' && 'item' in data ? data.item : data;
   }
 
+  /**
+   * List every registered object (code- and DB-defined) from the metadata
+   * registry — `GET /api/v1/meta/object`. Returns lightweight `{ name, label }`
+   * headers for object-picker widgets (e.g. the sharing-rule `object-ref`
+   * field). The list endpoint is uncached server-side, so no cache-busting
+   * dance is needed. Returns `[]` on any failure so callers degrade gracefully.
+   */
+  async getObjects(): Promise<Array<{ name: string; label?: string }>> {
+    try {
+      await this.connect();
+      const baseUrl = (this.baseUrl || '').replace(/\/$/, '');
+      // Avoid doubling /api/v1 when baseUrl already carries the version suffix
+      // (mirrors fetchObjectSchemaFresh).
+      const hasApiVersionSuffix = /\/api\/v\d+$/i.test(baseUrl);
+      const metaPath = hasApiVersionSuffix ? '/meta' : '/api/v1/meta';
+      const url = `${baseUrl}${metaPath}/object`;
+
+      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+      if (this.token) headers['Authorization'] = `Bearer ${this.token}`;
+
+      const res = await this.fetchImpl(url, { method: 'GET', headers });
+      if (!res.ok) return [];
+      const body: any = await res.json();
+      // Unwrap the `{ success, data }` envelope, the `{ type, items }` list
+      // shape, or a bare array.
+      const data =
+        body && typeof body === 'object' && 'success' in body && 'data' in body ? body.data : body;
+      const items: any[] = Array.isArray(data)
+        ? data
+        : Array.isArray(data?.items)
+          ? data.items
+          : [];
+      return items
+        .map((it: any) => ({
+          name: String(it?.name ?? ''),
+          label: it?.label != null ? String(it.label) : undefined,
+        }))
+        .filter((it) => it.name);
+    } catch {
+      return [];
+    }
+  }
+
   /**
    * Get access to the underlying ObjectStack client for advanced operations.
    */