@ruya.sa/ui 3.71.3

package/dist/utilities/hasSavePermission.js

@@ -0,0 +1,16 @@
+export const hasSavePermission = args => {
+  const {
+    collectionSlug,
+    docPermissions,
+    globalSlug,
+    isEditing
+  } = args;
+  if (collectionSlug) {
+    return Boolean(isEditing && docPermissions?.update || !isEditing && docPermissions?.create);
+  }
+  if (globalSlug) {
+    return Boolean(docPermissions?.update);
+  }
+  return false;
+};
+//# sourceMappingURL=hasSavePermission.js.map

package/dist/utilities/hasSavePermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasSavePermission.js","names":["hasSavePermission","args","collectionSlug","docPermissions","globalSlug","isEditing","Boolean","update","create"],"sources":["../../src/utilities/hasSavePermission.ts"],"sourcesContent":["import type {\n  SanitizedCollectionPermission,\n  SanitizedDocumentPermissions,\n  SanitizedGlobalPermission,\n} from '@ruya.sa/payload'\n\nexport const hasSavePermission = (args: {\n  /*\n   * Pass either `collectionSlug` or `globalSlug`\n   */\n  collectionSlug?: string\n  docPermissions: SanitizedDocumentPermissions\n  /*\n   * Pass either `collectionSlug` or `globalSlug`\n   */\n  globalSlug?: string\n  isEditing: boolean\n}) => {\n  const { collectionSlug, docPermissions, globalSlug, isEditing } = args\n\n  if (collectionSlug) {\n    return Boolean(\n      (isEditing && docPermissions?.update) ||\n        (!isEditing && (docPermissions as SanitizedCollectionPermission)?.create),\n    )\n  }\n\n  if (globalSlug) {\n    return Boolean((docPermissions as SanitizedGlobalPermission)?.update)\n  }\n\n  return false\n}\n"],"mappings":"AAMA,OAAO,MAAMA,iBAAA,GAAqBC,IAAA;EAYhC,MAAM;IAAEC,cAAc;IAAEC,cAAc;IAAEC,UAAU;IAAEC;EAAS,CAAE,GAAGJ,IAAA;EAElE,IAAIC,cAAA,EAAgB;IAClB,OAAOI,OAAA,CACLD,SAAC,IAAaF,cAAA,EAAgBI,MAAA,IAC3B,CAACF,SAAA,IAAcF,cAAA,EAAkDK,MAAA;EAExE;EAEA,IAAIJ,UAAA,EAAY;IACd,OAAOE,OAAA,CAASH,cAAA,EAA8CI,MAAA;EAChE;EAEA,OAAO;AACT","ignoreList":[]}

package/dist/utilities/isClientUserObject.d.ts

@@ -0,0 +1,3 @@
+import type { ClientUser } from '@ruya.sa/payload';
+export declare const isClientUserObject: (user: any) => user is ClientUser;
+//# sourceMappingURL=isClientUserObject.d.ts.map

package/dist/utilities/isClientUserObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isClientUserObject.d.ts","sourceRoot":"","sources":["../../src/utilities/isClientUserObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,eAAO,MAAM,kBAAkB,iBAAW,IAAI,IAAI,UAEjD,CAAA"}

package/dist/utilities/isClientUserObject.js

@@ -0,0 +1,4 @@
+export const isClientUserObject = user => {
+  return user && typeof user === 'object';
+};
+//# sourceMappingURL=isClientUserObject.js.map

package/dist/utilities/isClientUserObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isClientUserObject.js","names":["isClientUserObject","user"],"sources":["../../src/utilities/isClientUserObject.ts"],"sourcesContent":["import type { ClientUser } from '@ruya.sa/payload'\n\nexport const isClientUserObject = (user): user is ClientUser => {\n  return user && typeof user === 'object'\n}\n"],"mappings":"AAEA,OAAO,MAAMA,kBAAA,GAAsBC,IAAA;EACjC,OAAOA,IAAA,IAAQ,OAAOA,IAAA,KAAS;AACjC","ignoreList":[]}

package/dist/utilities/isEditing.d.ts

@@ -0,0 +1,6 @@
+export declare const isEditing: ({ id, collectionSlug, globalSlug, }: {
+    collectionSlug?: string;
+    globalSlug?: string;
+    id?: number | string;
+}) => boolean;
+//# sourceMappingURL=isEditing.d.ts.map

package/dist/utilities/isEditing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEditing.d.ts","sourceRoot":"","sources":["../../src/utilities/isEditing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,wCAInB;IACD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACrB,KAAG,OAA0D,CAAA"}

package/dist/utilities/isEditing.js

@@ -0,0 +1,6 @@
+export const isEditing = ({
+  id,
+  collectionSlug,
+  globalSlug
+}) => Boolean(globalSlug || collectionSlug && !!id);
+//# sourceMappingURL=isEditing.js.map

package/dist/utilities/isEditing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEditing.js","names":["isEditing","id","collectionSlug","globalSlug","Boolean"],"sources":["../../src/utilities/isEditing.ts"],"sourcesContent":["export const isEditing = ({\n  id,\n  collectionSlug,\n  globalSlug,\n}: {\n  collectionSlug?: string\n  globalSlug?: string\n  id?: number | string\n}): boolean => Boolean(globalSlug || (collectionSlug && !!id))\n"],"mappings":"AAAA,OAAO,MAAMA,SAAA,GAAYA,CAAC;EACxBC,EAAE;EACFC,cAAc;EACdC;AAAU,CAKX,KAAcC,OAAA,CAAQD,UAAA,IAAeD,cAAA,IAAkB,CAAC,CAACD,EAAA","ignoreList":[]}

package/dist/utilities/isURLAllowed.d.ts

@@ -0,0 +1,3 @@
+import type { AllowList } from '@ruya.sa/payload';
+export declare const isURLAllowed: (url: string, allowList: AllowList) => boolean;
+//# sourceMappingURL=isURLAllowed.d.ts.map

package/dist/utilities/isURLAllowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isURLAllowed.d.ts","sourceRoot":"","sources":["../../src/utilities/isURLAllowed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,eAAO,MAAM,YAAY,QAAS,MAAM,aAAa,SAAS,KAAG,OA+BhE,CAAA"}

package/dist/utilities/isURLAllowed.js

@@ -0,0 +1,31 @@
+export const isURLAllowed = (url, allowList) => {
+  try {
+    const parsedUrl = new URL(url);
+    return allowList.some(allowItem => {
+      return Object.entries(allowItem).every(([key, value]) => {
+        // Skip undefined or null values
+        if (!value) {
+          return true;
+        }
+        // Compare protocol with colon
+        if (key === 'protocol') {
+          return typeof value === 'string' && parsedUrl.protocol === `${value}:`;
+        }
+        if (key === 'pathname') {
+          // Convert wildcards to a regex
+          const regexPattern = value.replace(/\*\*/g, '.*') // Match any path
+          .replace(/\*/g, '[^/]*') // Match any part of a path segment
+          ;
+          const regex = new RegExp(`^${regexPattern}$`);
+          return regex.test(parsedUrl.pathname);
+        }
+        // Default comparison for all other properties (hostname, port, search)
+        return parsedUrl[key] === value;
+      });
+    });
+  } catch {
+    return false // If the URL is invalid, deny by default
+    ;
+  }
+};
+//# sourceMappingURL=isURLAllowed.js.map

package/dist/utilities/isURLAllowed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isURLAllowed.js","names":["isURLAllowed","url","allowList","parsedUrl","URL","some","allowItem","Object","entries","every","key","value","protocol","regexPattern","replace","regex","RegExp","test","pathname"],"sources":["../../src/utilities/isURLAllowed.ts"],"sourcesContent":["import type { AllowList } from '@ruya.sa/payload'\n\nexport const isURLAllowed = (url: string, allowList: AllowList): boolean => {\n  try {\n    const parsedUrl = new URL(url)\n\n    return allowList.some((allowItem) => {\n      return Object.entries(allowItem).every(([key, value]) => {\n        // Skip undefined or null values\n        if (!value) {\n          return true\n        }\n        // Compare protocol with colon\n        if (key === 'protocol') {\n          return typeof value === 'string' && parsedUrl.protocol === `${value}:`\n        }\n\n        if (key === 'pathname') {\n          // Convert wildcards to a regex\n          const regexPattern = value\n            .replace(/\\*\\*/g, '.*') // Match any path\n            .replace(/\\*/g, '[^/]*') // Match any part of a path segment\n          const regex = new RegExp(`^${regexPattern}$`)\n          return regex.test(parsedUrl.pathname)\n        }\n\n        // Default comparison for all other properties (hostname, port, search)\n        return parsedUrl[key as keyof URL] === value\n      })\n    })\n  } catch {\n    return false // If the URL is invalid, deny by default\n  }\n}\n"],"mappings":"AAEA,OAAO,MAAMA,YAAA,GAAeA,CAACC,GAAA,EAAaC,SAAA;EACxC,IAAI;IACF,MAAMC,SAAA,GAAY,IAAIC,GAAA,CAAIH,GAAA;IAE1B,OAAOC,SAAA,CAAUG,IAAI,CAAEC,SAAA;MACrB,OAAOC,MAAA,CAAOC,OAAO,CAACF,SAAA,EAAWG,KAAK,CAAC,CAAC,CAACC,GAAA,EAAKC,KAAA,CAAM;QAClD;QACA,IAAI,CAACA,KAAA,EAAO;UACV,OAAO;QACT;QACA;QACA,IAAID,GAAA,KAAQ,YAAY;UACtB,OAAO,OAAOC,KAAA,KAAU,YAAYR,SAAA,CAAUS,QAAQ,KAAK,GAAGD,KAAA,GAAQ;QACxE;QAEA,IAAID,GAAA,KAAQ,YAAY;UACtB;UACA,MAAMG,YAAA,GAAeF,KAAA,CAClBG,OAAO,CAAC,SAAS,MAAM;UAAA,CACvBA,OAAO,CAAC,OAAO,SAAS;UAAA;UAC3B,MAAMC,KAAA,GAAQ,IAAIC,MAAA,CAAO,IAAIH,YAAA,GAAe;UAC5C,OAAOE,KAAA,CAAME,IAAI,CAACd,SAAA,CAAUe,QAAQ;QACtC;QAEA;QACA,OAAOf,SAAS,CAACO,GAAA,CAAiB,KAAKC,KAAA;MACzC;IACF;EACF,EAAE,MAAM;IACN,OAAO,MAAM;IAAA;EACf;AACF","ignoreList":[]}

package/dist/utilities/isValidReactElement.d.ts

@@ -0,0 +1,7 @@
+import { type ReactElement } from 'react';
+/**
+ * Since Next.js 15.4, `React.isValidElement()` returns `false` for components that cross the server-client boundary.
+ * This utility expands on that check so that it returns true for valid React elements.
+ */
+export declare function isValidReactElement<P>(object: {} | null | undefined): object is ReactElement<P>;
+//# sourceMappingURL=isValidReactElement.d.ts.map

package/dist/utilities/isValidReactElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidReactElement.d.ts","sourceRoot":"","sources":["../../src/utilities/isValidReactElement.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAIhD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,CAE/F"}

package/dist/utilities/isValidReactElement.js

@@ -0,0 +1,10 @@
+import React from 'react';
+const LazyReactComponentSymbol = Symbol.for('react.lazy');
+/**
+ * Since Next.js 15.4, `React.isValidElement()` returns `false` for components that cross the server-client boundary.
+ * This utility expands on that check so that it returns true for valid React elements.
+ */
+export function isValidReactElement(object) {
+  return React.isValidElement(object) || object?.['$$typeof'] === LazyReactComponentSymbol;
+}
+//# sourceMappingURL=isValidReactElement.js.map

package/dist/utilities/isValidReactElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidReactElement.js","names":["React","LazyReactComponentSymbol","Symbol","for","isValidReactElement","object","isValidElement"],"sources":["../../src/utilities/isValidReactElement.ts"],"sourcesContent":["import React, { type ReactElement } from 'react'\n\nconst LazyReactComponentSymbol = Symbol.for('react.lazy')\n\n/**\n * Since Next.js 15.4, `React.isValidElement()` returns `false` for components that cross the server-client boundary.\n * This utility expands on that check so that it returns true for valid React elements.\n */\nexport function isValidReactElement<P>(object: {} | null | undefined): object is ReactElement<P> {\n  return React.isValidElement(object) || object?.['$$typeof'] === LazyReactComponentSymbol\n}\n"],"mappings":"AAAA,OAAOA,KAAA,MAAkC;AAEzC,MAAMC,wBAAA,GAA2BC,MAAA,CAAOC,GAAG,CAAC;AAE5C;;;;AAIA,OAAO,SAASC,oBAAuBC,MAA6B;EAClE,OAAOL,KAAA,CAAMM,cAAc,CAACD,MAAA,KAAWA,MAAA,GAAS,WAAW,KAAKJ,wBAAA;AAClE","ignoreList":[]}

package/dist/utilities/normalizeRelationshipValue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Normalizes relationship/upload field values by extracting IDs from nested objects
+ * and returning them in the appropriate format based on whether the field is polymorphic.
+ *
+ * @param value - The value to normalize (can be a simple ID, or an object with relationTo and value)
+ * @param relationTo - The relationTo config (string for monomorphic, array for polymorphic)
+ * @returns The normalized value (simple ID for monomorphic, {relationTo, value} for polymorphic)
+ *
+ * @example
+ * // Monomorphic field - returns simple ID
+ * normalizeRelationshipValue('123', 'users') // '123'
+ * normalizeRelationshipValue({ relationTo: 'users', value: '123' }, 'users') // '123'
+ *
+ * @example
+ * // Polymorphic field - returns {relationTo, value}
+ * normalizeRelationshipValue('123', ['users', 'posts']) // '123' (kept as-is, no relationTo to infer)
+ * normalizeRelationshipValue({ relationTo: 'users', value: '123' }, ['users', 'posts'])
+ * // { relationTo: 'users', value: '123' }
+ *
+ * @example
+ * // Handles nested value objects (populated documents)
+ * normalizeRelationshipValue(
+ *   { relationTo: 'users', value: { id: '123', name: 'John' } },
+ *   ['users', 'posts']
+ * )
+ * // { relationTo: 'users', value: '123' }
+ */
+export declare function normalizeRelationshipValue(value: any, relationTo: string | string[]): any;
+//# sourceMappingURL=normalizeRelationshipValue.d.ts.map

package/dist/utilities/normalizeRelationshipValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeRelationshipValue.d.ts","sourceRoot":"","sources":["../../src/utilities/normalizeRelationshipValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,CAkCzF"}

package/dist/utilities/normalizeRelationshipValue.js

@@ -0,0 +1,59 @@
+/**
+ * Normalizes relationship/upload field values by extracting IDs from nested objects
+ * and returning them in the appropriate format based on whether the field is polymorphic.
+ *
+ * @param value - The value to normalize (can be a simple ID, or an object with relationTo and value)
+ * @param relationTo - The relationTo config (string for monomorphic, array for polymorphic)
+ * @returns The normalized value (simple ID for monomorphic, {relationTo, value} for polymorphic)
+ *
+ * @example
+ * // Monomorphic field - returns simple ID
+ * normalizeRelationshipValue('123', 'users') // '123'
+ * normalizeRelationshipValue({ relationTo: 'users', value: '123' }, 'users') // '123'
+ *
+ * @example
+ * // Polymorphic field - returns {relationTo, value}
+ * normalizeRelationshipValue('123', ['users', 'posts']) // '123' (kept as-is, no relationTo to infer)
+ * normalizeRelationshipValue({ relationTo: 'users', value: '123' }, ['users', 'posts'])
+ * // { relationTo: 'users', value: '123' }
+ *
+ * @example
+ * // Handles nested value objects (populated documents)
+ * normalizeRelationshipValue(
+ *   { relationTo: 'users', value: { id: '123', name: 'John' } },
+ *   ['users', 'posts']
+ * )
+ * // { relationTo: 'users', value: '123' }
+ */export function normalizeRelationshipValue(value, relationTo) {
+  const isPoly = Array.isArray(relationTo);
+  // If it's already a simple ID (string or number), return as-is for non-poly or wrap for poly
+  if (typeof value === 'string' || typeof value === 'number') {
+    return value;
+  }
+  // If it's an object with relationTo and value
+  if (value && typeof value === 'object' && 'relationTo' in value && 'value' in value) {
+    // Extract the actual ID value, handling nested objects
+    let idValue = value.value;
+    while (idValue && typeof idValue === 'object' && idValue !== null && 'value' in idValue) {
+      idValue = idValue.value;
+    }
+    // If the nested value is a populated document with an ID, extract it
+    if (idValue && typeof idValue === 'object' && idValue !== null && 'id' in idValue) {
+      idValue = idValue.id;
+    }
+    // Return the normalized structure
+    if (isPoly) {
+      return {
+        relationTo: value.relationTo,
+        value: idValue
+      };
+    }
+    return idValue;
+  }
+  // If it's a populated document object (has id but no relationTo/value structure)
+  if (value && typeof value === 'object' && 'id' in value) {
+    return value.id;
+  }
+  return value;
+}
+//# sourceMappingURL=normalizeRelationshipValue.js.map

package/dist/utilities/normalizeRelationshipValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeRelationshipValue.js","names":["normalizeRelationshipValue","value","relationTo","isPoly","Array","isArray","idValue","id"],"sources":["../../src/utilities/normalizeRelationshipValue.ts"],"sourcesContent":["/**\n * Normalizes relationship/upload field values by extracting IDs from nested objects\n * and returning them in the appropriate format based on whether the field is polymorphic.\n *\n * @param value - The value to normalize (can be a simple ID, or an object with relationTo and value)\n * @param relationTo - The relationTo config (string for monomorphic, array for polymorphic)\n * @returns The normalized value (simple ID for monomorphic, {relationTo, value} for polymorphic)\n *\n * @example\n * // Monomorphic field - returns simple ID\n * normalizeRelationshipValue('123', 'users') // '123'\n * normalizeRelationshipValue({ relationTo: 'users', value: '123' }, 'users') // '123'\n *\n * @example\n * // Polymorphic field - returns {relationTo, value}\n * normalizeRelationshipValue('123', ['users', 'posts']) // '123' (kept as-is, no relationTo to infer)\n * normalizeRelationshipValue({ relationTo: 'users', value: '123' }, ['users', 'posts'])\n * // { relationTo: 'users', value: '123' }\n *\n * @example\n * // Handles nested value objects (populated documents)\n * normalizeRelationshipValue(\n *   { relationTo: 'users', value: { id: '123', name: 'John' } },\n *   ['users', 'posts']\n * )\n * // { relationTo: 'users', value: '123' }\n */\nexport function normalizeRelationshipValue(value: any, relationTo: string | string[]): any {\n  const isPoly = Array.isArray(relationTo)\n\n  // If it's already a simple ID (string or number), return as-is for non-poly or wrap for poly\n  if (typeof value === 'string' || typeof value === 'number') {\n    return value\n  }\n\n  // If it's an object with relationTo and value\n  if (value && typeof value === 'object' && 'relationTo' in value && 'value' in value) {\n    // Extract the actual ID value, handling nested objects\n    let idValue: any = value.value\n    while (idValue && typeof idValue === 'object' && idValue !== null && 'value' in idValue) {\n      idValue = idValue.value\n    }\n\n    // If the nested value is a populated document with an ID, extract it\n    if (idValue && typeof idValue === 'object' && idValue !== null && 'id' in idValue) {\n      idValue = idValue.id\n    }\n\n    // Return the normalized structure\n    if (isPoly) {\n      return { relationTo: value.relationTo, value: idValue }\n    }\n    return idValue\n  }\n\n  // If it's a populated document object (has id but no relationTo/value structure)\n  if (value && typeof value === 'object' && 'id' in value) {\n    return value.id\n  }\n\n  return value\n}\n"],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BA,OAAO,SAASA,2BAA2BC,KAAU,EAAEC,UAA6B;EAClF,MAAMC,MAAA,GAASC,KAAA,CAAMC,OAAO,CAACH,UAAA;EAE7B;EACA,IAAI,OAAOD,KAAA,KAAU,YAAY,OAAOA,KAAA,KAAU,UAAU;IAC1D,OAAOA,KAAA;EACT;EAEA;EACA,IAAIA,KAAA,IAAS,OAAOA,KAAA,KAAU,YAAY,gBAAgBA,KAAA,IAAS,WAAWA,KAAA,EAAO;IACnF;IACA,IAAIK,OAAA,GAAeL,KAAA,CAAMA,KAAK;IAC9B,OAAOK,OAAA,IAAW,OAAOA,OAAA,KAAY,YAAYA,OAAA,KAAY,QAAQ,WAAWA,OAAA,EAAS;MACvFA,OAAA,GAAUA,OAAA,CAAQL,KAAK;IACzB;IAEA;IACA,IAAIK,OAAA,IAAW,OAAOA,OAAA,KAAY,YAAYA,OAAA,KAAY,QAAQ,QAAQA,OAAA,EAAS;MACjFA,OAAA,GAAUA,OAAA,CAAQC,EAAE;IACtB;IAEA;IACA,IAAIJ,MAAA,EAAQ;MACV,OAAO;QAAED,UAAA,EAAYD,KAAA,CAAMC,UAAU;QAAED,KAAA,EAAOK;MAAQ;IACxD;IACA,OAAOA,OAAA;EACT;EAEA;EACA,IAAIL,KAAA,IAAS,OAAOA,KAAA,KAAU,YAAY,QAAQA,KAAA,EAAO;IACvD,OAAOA,KAAA,CAAMM,EAAE;EACjB;EAEA,OAAON,KAAA;AACT","ignoreList":[]}

package/dist/utilities/normalizeRelationshipValue.spec.js

@@ -0,0 +1,373 @@
+import { describe, it, expect } from 'vitest';
+import { normalizeRelationshipValue } from './normalizeRelationshipValue.js';
+describe('normalizeRelationshipValue', () => {
+  describe('Monomorphic relationships (string relationTo)', () => {
+    const relationTo = 'users';
+    it('should return simple string ID as-is', () => {
+      const result = normalizeRelationshipValue('user123', relationTo);
+      expect(result).toBe('user123');
+    });
+    it('should return simple number ID as-is', () => {
+      const result = normalizeRelationshipValue(123, relationTo);
+      expect(result).toBe(123);
+    });
+    it('should extract ID from object with relationTo and value', () => {
+      const value = {
+        relationTo: 'users',
+        value: 'user456'
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toBe('user456');
+    });
+    it('should extract ID from nested value structure', () => {
+      const value = {
+        relationTo: 'users',
+        value: {
+          value: 'user789'
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toBe('user789');
+    });
+    it('should extract ID from deeply nested value structure', () => {
+      const value = {
+        relationTo: 'users',
+        value: {
+          value: {
+            value: 'user999'
+          }
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toBe('user999');
+    });
+    it('should extract ID from populated document', () => {
+      const value = {
+        relationTo: 'users',
+        value: {
+          id: 'user111',
+          name: 'John Doe',
+          email: 'john@example.com'
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toBe('user111');
+    });
+    it('should extract ID from populated document without relationTo wrapper', () => {
+      const value = {
+        id: 'user222',
+        name: 'Jane Doe',
+        email: 'jane@example.com'
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toBe('user222');
+    });
+    it('should handle null values', () => {
+      const result = normalizeRelationshipValue(null, relationTo);
+      expect(result).toBeNull();
+    });
+    it('should handle undefined values', () => {
+      const result = normalizeRelationshipValue(undefined, relationTo);
+      expect(result).toBeUndefined();
+    });
+    it('should handle empty object', () => {
+      const result = normalizeRelationshipValue({}, relationTo);
+      expect(result).toEqual({});
+    });
+  });
+  describe('Polymorphic relationships (array relationTo)', () => {
+    const relationTo = ['users', 'posts', 'pages'];
+    it('should return simple string ID as-is', () => {
+      const result = normalizeRelationshipValue('user123', relationTo);
+      expect(result).toBe('user123');
+    });
+    it('should return simple number ID as-is', () => {
+      const result = normalizeRelationshipValue(456, relationTo);
+      expect(result).toBe(456);
+    });
+    it('should preserve relationTo structure with string value', () => {
+      const value = {
+        relationTo: 'users',
+        value: 'user789'
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toEqual({
+        relationTo: 'users',
+        value: 'user789'
+      });
+    });
+    it('should preserve relationTo structure with number value', () => {
+      const value = {
+        relationTo: 'posts',
+        value: 123
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toEqual({
+        relationTo: 'posts',
+        value: 123
+      });
+    });
+    it('should extract ID from nested value structure', () => {
+      const value = {
+        relationTo: 'posts',
+        value: {
+          value: 'post456'
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toEqual({
+        relationTo: 'posts',
+        value: 'post456'
+      });
+    });
+    it('should extract ID from deeply nested value structure', () => {
+      const value = {
+        relationTo: 'pages',
+        value: {
+          value: {
+            value: 'page789'
+          }
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toEqual({
+        relationTo: 'pages',
+        value: 'page789'
+      });
+    });
+    it('should extract ID from populated document', () => {
+      const value = {
+        relationTo: 'users',
+        value: {
+          id: 'user999',
+          name: 'John Smith',
+          email: 'john.smith@example.com'
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toEqual({
+        relationTo: 'users',
+        value: 'user999'
+      });
+    });
+    it('should extract ID from complex populated document', () => {
+      const value = {
+        relationTo: 'posts',
+        value: {
+          id: 'post123',
+          title: 'My Post',
+          author: {
+            id: 'author456',
+            name: 'Author Name'
+          },
+          createdAt: '2023-01-01T00:00:00.000Z'
+        }
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toEqual({
+        relationTo: 'posts',
+        value: 'post123'
+      });
+    });
+    it('should handle different relationTo values', () => {
+      const values = [{
+        relationTo: 'users',
+        value: 'user1'
+      }, {
+        relationTo: 'posts',
+        value: 'post2'
+      }, {
+        relationTo: 'pages',
+        value: 'page3'
+      }];
+      const results = values.map(v => normalizeRelationshipValue(v, relationTo));
+      expect(results).toEqual([{
+        relationTo: 'users',
+        value: 'user1'
+      }, {
+        relationTo: 'posts',
+        value: 'post2'
+      }, {
+        relationTo: 'pages',
+        value: 'page3'
+      }]);
+    });
+    it('should handle null values', () => {
+      const result = normalizeRelationshipValue(null, relationTo);
+      expect(result).toBeNull();
+    });
+    it('should handle undefined values', () => {
+      const result = normalizeRelationshipValue(undefined, relationTo);
+      expect(result).toBeUndefined();
+    });
+    it('should extract ID from populated document without relationTo wrapper', () => {
+      const value = {
+        id: 'doc123',
+        title: 'Document Title'
+      };
+      const result = normalizeRelationshipValue(value, relationTo);
+      expect(result).toBe('doc123');
+    });
+  });
+  describe('Edge cases', () => {
+    it('should handle object with only value property (no relationTo)', () => {
+      const value = {
+        value: 'someValue'
+      };
+      const result = normalizeRelationshipValue(value, 'users');
+      // Since there's no 'id' field and no relationTo, it should return the value as-is
+      expect(result).toEqual({
+        value: 'someValue'
+      });
+    });
+    it('should handle object with relationTo but no value', () => {
+      const value = {
+        relationTo: 'users'
+      };
+      const result = normalizeRelationshipValue(value, ['users', 'posts']);
+      expect(result).toEqual({
+        relationTo: 'users'
+      });
+    });
+    it('should handle empty array relationTo', () => {
+      const result = normalizeRelationshipValue('user123', []);
+      expect(result).toBe('user123');
+    });
+    it('should handle single-item array relationTo as polymorphic', () => {
+      const value = {
+        relationTo: 'users',
+        value: 'user123'
+      };
+      const result = normalizeRelationshipValue(value, ['users']);
+      expect(result).toEqual({
+        relationTo: 'users',
+        value: 'user123'
+      });
+    });
+    it('should handle numeric IDs in populated documents', () => {
+      const value = {
+        relationTo: 'users',
+        value: {
+          id: 12345,
+          name: 'User with numeric ID'
+        }
+      };
+      const result = normalizeRelationshipValue(value, ['users', 'posts']);
+      expect(result).toEqual({
+        relationTo: 'users',
+        value: 12345
+      });
+    });
+    it('should handle nested null values', () => {
+      const value = {
+        relationTo: 'users',
+        value: null
+      };
+      const result = normalizeRelationshipValue(value, 'users');
+      expect(result).toBeNull();
+    });
+    it('should handle zero as a valid ID', () => {
+      const result = normalizeRelationshipValue(0, 'users');
+      expect(result).toBe(0);
+    });
+    it('should handle empty string as a valid ID', () => {
+      const result = normalizeRelationshipValue('', 'users');
+      expect(result).toBe('');
+    });
+    it('should handle false as a value', () => {
+      const result = normalizeRelationshipValue(false, 'users');
+      expect(result).toBe(false);
+    });
+    it('should handle array values (return as-is)', () => {
+      const result = normalizeRelationshipValue(['user1', 'user2'], 'users');
+      expect(result).toEqual(['user1', 'user2']);
+    });
+  });
+  describe('Real-world scenarios', () => {
+    it('should normalize upload field value for monomorphic upload', () => {
+      // Upload field with populated media document
+      const value = {
+        id: 'media123',
+        filename: 'image.jpg',
+        mimeType: 'image/jpeg',
+        filesize: 12345,
+        url: '/media/image.jpg'
+      };
+      const result = normalizeRelationshipValue(value, 'media');
+      expect(result).toBe('media123');
+    });
+    it('should normalize upload field value for polymorphic upload', () => {
+      // Upload field with relationTo structure
+      const value = {
+        relationTo: 'images',
+        value: {
+          id: 'image456',
+          filename: 'photo.png',
+          url: '/media/photo.png'
+        }
+      };
+      const result = normalizeRelationshipValue(value, ['images', 'videos']);
+      expect(result).toEqual({
+        relationTo: 'images',
+        value: 'image456'
+      });
+    });
+    it('should normalize form submission data', () => {
+      // Data coming from form with populated relationship
+      const value = {
+        relationTo: 'posts',
+        value: {
+          id: 'post789',
+          title: 'Blog Post Title',
+          author: {
+            id: 'author123',
+            name: 'Author'
+          },
+          publishedDate: '2023-12-01'
+        }
+      };
+      const result = normalizeRelationshipValue(value, ['posts', 'pages']);
+      expect(result).toEqual({
+        relationTo: 'posts',
+        value: 'post789'
+      });
+    });
+    it('should normalize API response with nested relationships', () => {
+      // Complex nested structure from API
+      const value = {
+        relationTo: 'categories',
+        value: {
+          value: {
+            id: 'cat123',
+            name: 'Category Name'
+          }
+        }
+      };
+      const result = normalizeRelationshipValue(value, ['categories', 'tags']);
+      expect(result).toEqual({
+        relationTo: 'categories',
+        value: 'cat123'
+      });
+    });
+    it('should handle table cell data normalization', () => {
+      // Cell data from table that might be just an ID
+      const simpleValue = 'user123';
+      const result = normalizeRelationshipValue(simpleValue, 'users');
+      expect(result).toBe('user123');
+      // Cell data with full structure
+      const complexValue = {
+        relationTo: 'users',
+        value: {
+          id: 'user456',
+          name: 'John Doe'
+        }
+      };
+      const result2 = normalizeRelationshipValue(complexValue, ['users', 'admins']);
+      expect(result2).toEqual({
+        relationTo: 'users',
+        value: 'user456'
+      });
+    });
+  });
+});
+//# sourceMappingURL=normalizeRelationshipValue.spec.js.map