@rebasepro/common 0.0.1-canary.2 → 0.0.1-canary.4d4fb3e

package/dist/index.umd.js

@@ -1,298 +1,16 @@
 (function(global, factory) {
-  typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("@rebasepro/types"), require("object-hash"), require("json-logic-js"), require("fast-equals"), require("lodash/cloneDeep.js")) : typeof define === "function" && define.amd ? define(["exports", "@rebasepro/types", "object-hash", "json-logic-js", "fast-equals", "lodash/cloneDeep.js"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["Rebase Util"] = {}, global.types, global.hash, global.jsonLogic, global.fastEquals, global.cloneDeep));
-})(this, function(exports2, types, hash, jsonLogic, fastEquals, cloneDeep) {
+  typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("@rebasepro/types"), require("@rebasepro/utils"), require("json-logic-js"), require("fast-equals"), require("lodash/cloneDeep.js")) : typeof define === "function" && define.amd ? define(["exports", "@rebasepro/types", "@rebasepro/utils", "json-logic-js", "fast-equals", "lodash/cloneDeep.js"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["Rebase Util"] = {}, global.types, global.utils, global.jsonLogic, global.fastEquals, global.cloneDeep));
+})(this, function(exports2, types, utils, jsonLogic, fastEquals, cloneDeep) {
   "use strict";
   const DEFAULT_ONE_OF_TYPE = "type";
   const DEFAULT_ONE_OF_VALUE = "value";
-  const isEmptyArray = (value) => Array.isArray(value) && value.length === 0;
-  const isFunction = (obj) => typeof obj === "function";
-  const isInteger = (obj) => String(Math.floor(Number(obj))) === String(obj);
-  const isNaN$1 = (obj) => obj !== obj;
-  function getIn$1(obj, key, def, p = 0) {
-    const path = toPath(key);
-    while (obj && p < path.length) {
-      obj = obj[path[p++]];
-    }
-    if (p !== path.length && !obj) {
-      return def;
-    }
-    return obj === void 0 ? def : obj;
-  }
-  function setIn(obj, path, value) {
-    const res = clone(obj);
-    let resVal = res;
-    let i = 0;
-    const pathArray = toPath(path);
-    for (; i < pathArray.length - 1; i++) {
-      const currentPath = pathArray[i];
-      const currentObj = getIn$1(obj, pathArray.slice(0, i + 1));
-      if (currentObj && (isObject(currentObj) || Array.isArray(currentObj))) {
-        resVal = resVal[currentPath] = clone(currentObj);
-      } else {
-        const nextPath = pathArray[i + 1];
-        resVal = resVal[currentPath] = isInteger(nextPath) && Number(nextPath) >= 0 ? [] : {};
-      }
-    }
-    if ((i === 0 ? obj : resVal)[pathArray[i]] === value) {
-      return obj;
-    }
-    if (value === void 0) {
-      delete resVal[pathArray[i]];
-    } else {
-      resVal[pathArray[i]] = value;
-    }
-    if (i === 0 && value === void 0) {
-      delete res[pathArray[i]];
-    }
-    return res;
-  }
-  function clone(value) {
-    if (Array.isArray(value)) {
-      return [...value];
-    } else if (typeof value === "object" && value !== null) {
-      return {
-        ...value
-      };
-    } else {
-      return value;
-    }
-  }
-  function toPath(value) {
-    if (Array.isArray(value)) return value;
-    return value.replace(/\[(\d+)]/g, ".$1").replace(/^\./, "").replace(/\.$/, "").split(".");
-  }
-  const pick = (obj, ...args) => ({
-    ...args.reduce((res, key) => ({
-      ...res,
-      [key]: obj[key]
-    }), {})
-  });
-  function isObject(item) {
-    return !!item && typeof item === "object" && !Array.isArray(item);
-  }
-  function isPlainObject(obj) {
-    if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
-      return false;
-    }
-    const proto = Object.getPrototypeOf(obj);
-    return proto === Object.prototype;
-  }
-  function mergeDeep(target, source, ignoreUndefined = false) {
-    if (!isObject(target)) {
-      return target;
-    }
-    const output = {
-      ...target
-    };
-    if (!isObject(source)) {
-      return output;
-    }
-    for (const key in source) {
-      if (Object.prototype.hasOwnProperty.call(source, key)) {
-        const sourceValue = source[key];
-        const outputValue = output[key];
-        if (ignoreUndefined && sourceValue === void 0) {
-          continue;
-        }
-        if (sourceValue instanceof Date) {
-          output[key] = new Date(sourceValue.getTime());
-        } else if (Array.isArray(sourceValue)) {
-          if (Array.isArray(outputValue)) {
-            const newArray = [];
-            const maxLength = Math.max(outputValue.length, sourceValue.length);
-            for (let i = 0; i < maxLength; i++) {
-              const sourceItem = sourceValue[i];
-              const targetItem = outputValue[i];
-              if (i >= sourceValue.length) {
-                newArray[i] = targetItem;
-              } else if (i >= outputValue.length) {
-                newArray[i] = sourceItem;
-              } else if (sourceItem === null) {
-                newArray[i] = targetItem;
-              } else if (isPlainObject(sourceItem) && isPlainObject(targetItem)) {
-                newArray[i] = mergeDeep(targetItem, sourceItem, ignoreUndefined);
-              } else {
-                newArray[i] = sourceItem;
-              }
-            }
-            output[key] = newArray;
-          } else {
-            output[key] = [...sourceValue];
-          }
-        } else if (isPlainObject(sourceValue)) {
-          if (isPlainObject(outputValue)) {
-            output[key] = mergeDeep(outputValue, sourceValue, ignoreUndefined);
-          } else {
-            output[key] = sourceValue;
-          }
-        } else if (isObject(sourceValue)) {
-          output[key] = sourceValue;
-        } else {
-          output[key] = sourceValue;
-        }
-      }
-    }
-    return output;
-  }
-  function getValueInPath(o, path) {
-    if (!o) return void 0;
-    if (typeof o === "object") {
-      if (path in o) {
-        return o[path];
-      }
-      if (path.includes(".") || path.includes("[")) {
-        let pathSegments = path.split(/[.[]/);
-        if (path.includes("[")) {
-          pathSegments = pathSegments.map((segment) => segment.replace("]", ""));
-        }
-        const firstSegment = pathSegments[0];
-        const isArrayAndIndexExists = Array.isArray(o[firstSegment]) && !isNaN$1(parseInt(pathSegments[1]));
-        const nextObject = isArrayAndIndexExists ? o[firstSegment][parseInt(pathSegments[1])] : o[firstSegment];
-        const nextPath = pathSegments.slice(isArrayAndIndexExists ? 2 : 1).join(".");
-        if (nextPath === "") return nextObject;
-        return getValueInPath(nextObject, nextPath);
-      }
-    }
-    return void 0;
-  }
-  function removeInPath(o, path) {
-    let currentObject = {
-      ...o
-    };
-    const parts = path.split(".");
-    const last = parts.pop();
-    for (const part of parts) {
-      currentObject = currentObject[part];
-    }
-    if (last) delete currentObject[last];
-    return currentObject;
-  }
-  function removeFunctions(o) {
-    if (o === void 0) return void 0;
-    if (o === null) return null;
-    if (typeof o === "object") {
-      if (Array.isArray(o)) {
-        return o.map((v) => removeFunctions(v));
-      }
-      if (!isPlainObject(o)) {
-        return o;
-      }
-      return Object.entries(o).filter(([_, value]) => typeof value !== "function").map(([key, value]) => {
-        if (Array.isArray(value)) {
-          return {
-            [key]: value.map((v) => removeFunctions(v))
-          };
-        } else if (typeof value === "object") {
-          return {
-            [key]: removeFunctions(value)
-          };
-        } else return {
-          [key]: value
-        };
-      }).reduce((a, b) => ({
-        ...a,
-        ...b
-      }), {});
-    }
-    return o;
-  }
-  function getHashValue(v) {
-    if (!v) return null;
-    if (typeof v === "object" && v !== null) {
-      if ("id" in v) return String(v.id);
-      else if (v instanceof Date) return v.toLocaleString();
-      else if (v instanceof types.GeoPoint) return hash(v);
-    }
-    return hash(v, {
-      ignoreUnknown: true
-    });
-  }
-  function removeUndefined(value, removeEmptyStrings) {
-    if (typeof value === "function") {
-      return value;
-    }
-    if (Array.isArray(value)) {
-      return value.map((v) => removeUndefined(v, removeEmptyStrings));
-    }
-    if (typeof value === "object") {
-      if (value === null) return value;
-      if (!isPlainObject(value)) {
-        return value;
-      }
-      const res = {};
-      Object.keys(value).forEach((key) => {
-        if (!isEmptyObject(value)) {
-          const childRes = removeUndefined(value[key], removeEmptyStrings);
-          const isString = typeof childRes === "string";
-          const shouldKeepIfString = !removeEmptyStrings || removeEmptyStrings && !isString || removeEmptyStrings && isString && childRes !== "";
-          if (childRes !== void 0 && !isEmptyObject(childRes) && shouldKeepIfString) res[key] = childRes;
-        }
-      });
-      return res;
-    }
-    return value;
-  }
-  function removeNulls(value) {
-    if (typeof value === "function") {
-      return value;
-    }
-    if (Array.isArray(value)) {
-      return value.map((v) => removeNulls(v));
-    }
-    if (typeof value === "object") {
-      if (value === null) return value;
-      if (!isPlainObject(value)) {
-        return value;
-      }
-      const res = {};
-      const obj = value;
-      Object.keys(obj).forEach((key) => {
-        if (obj[key] !== null) res[key] = removeNulls(obj[key]);
-      });
-      return res;
-    }
-    return value;
-  }
-  function isEmptyObject(obj) {
-    return obj && Object.getPrototypeOf(obj) === Object.prototype && Object.keys(obj).length === 0;
-  }
-  function removePropsIfExisting(source, comparison) {
-    const isObject2 = (val) => typeof val === "object" && val !== null;
-    const isArray = (val) => Array.isArray(val);
-    if (!isObject2(source) || !isObject2(comparison)) {
-      return source;
-    }
-    const res = isArray(source) ? [...source] : {
-      ...source
-    };
-    if (isArray(res)) {
-      for (let i = res.length - 1; i >= 0; i--) {
-        if (res[i] === comparison[i]) {
-          res.splice(i, 1);
-        } else if (isObject2(res[i]) && isObject2(comparison[i])) {
-          res[i] = removePropsIfExisting(res[i], comparison[i]);
-        }
-      }
-    } else {
-      Object.keys(comparison).forEach((key) => {
-        if (key in res) {
-          if (isObject2(res[key]) && isObject2(comparison[key])) {
-            res[key] = removePropsIfExisting(res[key], comparison[key]);
-          } else if (res[key] === comparison[key]) {
-            delete res[key];
-          }
-        }
-      });
-    }
-    return res;
-  }
   function isReadOnly(property) {
     if (property.readOnly) return true;
     if (property.type === "date") {
       if (property.autoValue) return true;
     }
     if (property.type === "reference") {
-      return !property.path && !property.Field;
+      return !property.path && !("Field" in property && property.Field);
     }
     return false;
   }
@@ -378,12 +96,20 @@
     return new types.EntityReference({
       id: entity.id,
       path: entity.path,
-      datasource: entity.datasource,
+      driver: entity.driver,
       databaseId: entity.databaseId
     });
   }
   function getRelationFrom(entity) {
-    return new types.EntityRelation(entity.id, entity.path);
+    return new types.EntityRelation(entity.id, entity.path, entity);
+  }
+  function normalizeToEntityRelation(value) {
+    if (value instanceof types.EntityRelation) return value;
+    if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+    const obj = value;
+    const isRelationLike = obj.__type === "relation" || typeof obj.isEntityRelation === "function" && obj.isEntityRelation();
+    if (!isRelationLike) return null;
+    return new types.EntityRelation(obj.id, obj.path, obj.data);
   }
   function traverseValuesProperties(inputValues, properties, operation) {
     const safeInputValues = inputValues ?? {};
@@ -399,7 +125,7 @@
       ...a,
       ...b
     }), {});
-    const result = mergeDeep(safeInputValues, updatedValues);
+    const result = utils.mergeDeep(safeInputValues, updatedValues);
     if (!result || Object.keys(result).length === 0) return void 0;
     return result;
   }
@@ -537,58 +263,6 @@
     }
     return ["id"];
   }
-  const kebabCaseRegex = /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g;
-  const toKebabCase = (str) => {
-    const regExpMatchArray = str.match(kebabCaseRegex);
-    if (!regExpMatchArray) return "";
-    return regExpMatchArray.map((x) => x.toLowerCase()).join("-");
-  };
-  const snakeCaseRegex = /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g;
-  const toSnakeCase = (str) => {
-    const regExpMatchArray = str.match(snakeCaseRegex);
-    if (!regExpMatchArray) return "";
-    return regExpMatchArray.map((x) => x.toLowerCase()).join("_");
-  };
-  function randomString(strLength = 5) {
-    return Math.random().toString(36).slice(2, 2 + strLength);
-  }
-  function randomColor() {
-    return Math.floor(Math.random() * 16777215).toString(16);
-  }
-  function slugify(text, separator = "_", lowercase = true) {
-    if (!text) return "";
-    const from = "ãàáäâẽèéëêìíïîõòóöôùúüûñç·/_,:;-";
-    const to = `aaaaaeeeeeiiiiooooouuuunc${separator}${separator}${separator}${separator}${separator}${separator}${separator}`;
-    for (let i = 0, l = from.length; i < l; i++) {
-      text = text.replace(new RegExp(from.charAt(i), "g"), to.charAt(i));
-    }
-    text = text.toString().replace(/\s+/g, separator).replace(/&/g, separator).replace(/[^\w\\-]+/g, "").replace(new RegExp("\\" + separator + "\\" + separator + "+", "g"), separator).trim().replace(/^\s+|\s+$/g, "");
-    return lowercase ? text.toLowerCase() : text;
-  }
-  function unslugify(slug) {
-    if (!slug) return "";
-    if (slug.includes("-") || slug.includes("_") || !slug.includes(" ")) {
-      const result = slug.replace(/[-_]/g, " ");
-      return result.replace(/\w\S*/g, function(txt) {
-        return txt.charAt(0).toUpperCase() + txt.substring(1);
-      }).trim();
-    } else {
-      return slug.trim();
-    }
-  }
-  function prettifyIdentifier(input) {
-    if (!input) return "";
-    let text = input;
-    text = text.replace(/([a-z])([A-Z])|([A-Z])([A-Z][a-z])/g, "$1$3 $2$4");
-    text = text.replace(/[_-]+/g, " ");
-    const s = text.trim().replace(/\b\w/g, (char) => char.toUpperCase());
-    console.log("Prettified identifier:", {
-      input,
-      s
-    });
-    return s;
-  }
-  const defaultDateFormat = "MMMM dd, yyyy, HH:mm:ss";
   function enumToObjectEntries(enumValues) {
     if (Array.isArray(enumValues)) {
       return enumValues;
@@ -623,28 +297,6 @@
   function fullPathToCollectionSegments(path) {
     return path.split("/").filter((e, i) => i % 2 === 0);
   }
-  function serializeRegExp(input) {
-    if (!input) return "";
-    return input.toString();
-  }
-  function hydrateRegExp(input) {
-    if (!input) return void 0;
-    const fragments = input.match(/\/(.*?)\/([a-z]*)?$/i);
-    if (fragments) {
-      return new RegExp(fragments[1], fragments[2] || "");
-    } else {
-      return new RegExp(input, "");
-    }
-  }
-  function isValidRegExp(input) {
-    const fullRegexp = input.match(/\/((?![*+?])(?:[^\r\n[/\\]|\\.|\[(?:[^\r\n\]\\]|\\.)*])+)\/((?:g(?:im?|mi?)?|i(?:gm?|mg?)?|m(?:gi?|ig?)?)?)/);
-    if (fullRegexp) return true;
-    const simpleRegexp = input.match(/((?![*+?])(?:[^\r\n[/\\]|\\.|\[(?:[^\r\n\]\\]|\\.)*])+)/);
-    return !!simpleRegexp;
-  }
-  function isDefaultFieldConfigId(id) {
-    return ["text_field", "multiline", "markdown", "url", "email", "switch", "select", "multi_select", "number_input", "number_select", "multi_number_select", "file_upload", "multi_file_upload", "reference_as_string", "reference", "multi_references", "relation", "date_time", "group", "key_value", "repeat", "custom_array", "block"].includes(id);
-  }
   function resolveProperty(props) {
     const {
       property,
@@ -655,7 +307,7 @@
     if (isPropertyBuilder(property)) {
       const path = rest.path;
       if (!path) throw Error("Trying to resolve a property builder without specifying the entity path");
-      const usedPropertyValue = rest.propertyKey ? getIn$1(rest.values, rest.propertyKey) : void 0;
+      const usedPropertyValue = rest.propertyKey ? utils.getIn(rest.values, rest.propertyKey) : void 0;
       const dynamicProps = property.dynamicProps?.({
         ...rest,
         path,
@@ -663,14 +315,14 @@
         values: rest.values ?? {},
         previousValues: rest.previousValues ?? rest.values ?? {}
       });
-      resultProperty = mergeDeep(property, dynamicProps ?? {});
+      resultProperty = utils.mergeDeep(property, dynamicProps ?? {});
     } else {
       resultProperty = property;
     }
     if (resultProperty.dynamicProps) {
       const path = rest.path;
       if (!path) throw Error("Trying to resolve dynamicProps without specifying the entity path");
-      const usedPropertyValue = rest.propertyKey ? getIn$1(rest.values, rest.propertyKey) : void 0;
+      const usedPropertyValue = rest.propertyKey ? utils.getIn(rest.values, rest.propertyKey) : void 0;
       const dynamicPropsResult = resultProperty.dynamicProps({
         ...rest,
         path,
@@ -679,7 +331,7 @@
         previousValues: rest.previousValues ?? rest.values ?? {}
       });
       if (dynamicPropsResult) {
-        resultProperty = mergeDeep(resultProperty, dynamicPropsResult);
+        resultProperty = utils.mergeDeep(resultProperty, dynamicPropsResult);
       }
     }
     let resolvedProperty;
@@ -700,7 +352,7 @@
     } else {
       resolvedProperty = resultProperty;
     }
-    if (resolvedProperty?.propertyConfig && !isDefaultFieldConfigId(resolvedProperty.propertyConfig)) {
+    if (resolvedProperty?.propertyConfig && !utils.isDefaultFieldConfigId(resolvedProperty.propertyConfig)) {
       const cmsFields = rest.propertyConfigs;
       if (!cmsFields && !ignoreMissingFields) {
         throw Error(`Trying to resolve a property with key '${resolvedProperty.propertyConfig}' that inherits from a custom property config but no custom property configs were provided. Use the property 'propertyConfigs' in your app config to provide them`);
@@ -711,10 +363,10 @@
         return resolvedProperty;
       }
       if (customField.property) {
-        const {
-          propertyConfig: _unused,
-          ...restConfigProperty
-        } = customField.property;
+        const restConfigProperty = {
+          ...customField.property
+        };
+        delete restConfigProperty.propertyConfig;
         const customFieldProperty = resolveProperty({
           property: {
             name: "",
@@ -724,7 +376,7 @@
           ...rest
         });
         if (customFieldProperty) {
-          resolvedProperty = mergeDeep(customFieldProperty, resolvedProperty);
+          resolvedProperty = utils.mergeDeep(customFieldProperty, resolvedProperty);
         }
       }
     }
@@ -777,7 +429,7 @@
     ignoreMissingFields = false,
     ...props
   }) {
-    const propertyValue = propertyKey ? getIn$1(props.values, propertyKey) : void 0;
+    const propertyValue = propertyKey ? utils.getIn(props.values, propertyKey) : void 0;
     if (property.of) {
       if (Array.isArray(property.of)) {
         return property.of.map((p, index) => {
@@ -826,7 +478,7 @@
         });
       }).filter((e) => Boolean(e)) : [];
       return resolvedProperties;
-    } else if (!property.Field) {
+    } else if (!("Field" in property && property.Field)) {
       throw Error(`The array property (${propertyKey}) needs to declare an 'of' or a 'oneOf' property, or provide a custom \`Field\` component`);
     } else {
       return [];
@@ -861,209 +513,21 @@
       return void 0;
     }
   }
-  function resolveEntityView$1(entityView, contextEntityViews) {
-    if (typeof entityView === "string") {
-      return contextEntityViews?.find((entry) => entry.key === entityView);
-    } else {
-      return entityView;
-    }
-  }
-  function resolveEntityAction(entityAction, contextEntityActions) {
-    if (typeof entityAction === "string") {
-      return contextEntityActions?.find((entry) => entry.key === entityAction);
-    } else {
-      return entityAction;
-    }
-  }
-  function resolvedSelectedEntityView(customViews, customizationController, selectedTab, canEdit) {
-    const resolvedEntityViews = customViews ? customViews.map((e) => resolveEntityView$1(e, customizationController.entityViews)).filter((e) => Boolean(e)) : [];
-    const selectedEntityView = resolvedEntityViews.find((e) => e.key === selectedTab);
-    const selectedSecondaryForm = customViews && resolvedEntityViews.filter((e) => e.includeActions).find((e) => e.key === selectedTab);
-    return {
-      resolvedEntityViews,
-      selectedEntityView,
-      selectedSecondaryForm
-    };
-  }
   function getSubcollections(collection) {
-    const subcollections = [];
-    subcollections.push(...collection.subcollections?.() ?? []);
-    subcollections.push(...(collection.relations ?? []).filter((rel) => rel.cardinality === "many").map((relation) => {
-      const targetCollection = relation.target();
-      const overrides = relation.overrides;
-      return overrides ? mergeDeep(targetCollection, overrides) : targetCollection;
-    }) ?? []);
-    return subcollections;
-  }
-  function removeInitialAndTrailingSlashes(s) {
-    return removeInitialSlash(removeTrailingSlash(s));
-  }
-  function removeInitialSlash(s) {
-    if (s.startsWith("/")) return s.slice(1);
-    else return s;
-  }
-  function removeTrailingSlash(s) {
-    if (s.endsWith("/")) return s.slice(0, -1);
-    else return s;
-  }
-  function addInitialSlash(s) {
-    if (s.startsWith("/")) return s;
-    else return `/${s}`;
-  }
-  function getLastSegment(path) {
-    const cleanPath = removeInitialAndTrailingSlashes(path);
-    if (cleanPath.includes("/")) {
-      const segments = cleanPath.split("/");
-      return segments[segments.length - 1];
+    if (collection.childCollections) {
+      return collection.childCollections() ?? [];
     }
-    return cleanPath;
-  }
-  function resolveCollectionPathIds(path, allCollections) {
-    let remainingPath = removeInitialAndTrailingSlashes(path);
-    if (!remainingPath) {
-      return "";
+    if (types.isFirebaseCollection(collection) && collection.subcollections) {
+      return collection.subcollections() ?? [];
     }
-    let currentCollections = allCollections;
-    const resolvedPathParts = [];
-    while (remainingPath.length > 0) {
-      if (!currentCollections || currentCollections.length === 0) {
-        console.warn(`resolveCollectionPathIds: Path structure implies subcollections, but none found before segment starting with "${remainingPath}" in original path "${path}". Appending remaining original path.`);
-        resolvedPathParts.push(remainingPath);
-        remainingPath = "";
-        break;
-      }
-      let foundMatch = false;
-      const potentialMatches = currentCollections.flatMap((col) => [{
-        col,
-        match: col.slug
-      }]).filter((p) => p.match && remainingPath.startsWith(p.match)).sort((a, b) => b.match.length - a.match.length);
-      if (potentialMatches.length > 0) {
-        const {
-          col: foundCollection,
-          match: matchString
-        } = potentialMatches[0];
-        resolvedPathParts.push(foundCollection.dbPath);
-        remainingPath = removeInitialSlash(remainingPath.substring(matchString.length));
-        if (remainingPath.length === 0) {
-          foundMatch = true;
-          break;
-        }
-        const idSeparatorIndex = remainingPath.indexOf("/");
-        let entityId;
-        if (idSeparatorIndex > -1) {
-          entityId = remainingPath.substring(0, idSeparatorIndex);
-          remainingPath = remainingPath.substring(idSeparatorIndex + 1);
-        } else {
-          entityId = remainingPath;
-          remainingPath = "";
-          console.warn(`resolveCollectionPathIds: Path seems to end with an entity ID "${entityId}" instead of a collection segment in original path "${path}". This might indicate an invalid input path.`);
-        }
-        resolvedPathParts.push(entityId);
-        currentCollections = getSubcollections(foundCollection);
-        foundMatch = true;
-        if (!currentCollections && remainingPath.length > 0) {
-          console.warn(`resolveCollectionPathIds: Path continues after entity ID "${entityId}", but no subcollections are defined for the preceding collection "${foundCollection.slug}" in path "${path}". Appending remaining original path.`);
-          resolvedPathParts.push(remainingPath);
-          remainingPath = "";
-          break;
-        }
-      }
-      if (!foundMatch) {
-        console.warn(`resolveCollectionPathIds: Collection definition not found for segment starting with "${remainingPath}" in original path "${path}". Appending remaining original path.`);
-        resolvedPathParts.push(remainingPath);
-        remainingPath = "";
-        break;
-      }
-    }
-    return resolvedPathParts.join("/");
-  }
-  function getCollectionBySlugWithin(slugOrPath, collections) {
-    const subpaths = removeInitialAndTrailingSlashes(slugOrPath).split("/");
-    if (subpaths.length % 2 === 0) {
-      throw Error(`getCollectionBySlug: Collection paths must have an odd number of segments: ${slugOrPath}`);
-    }
-    const subpathCombinations = getCollectionPathsCombinations(subpaths);
-    let result;
-    for (let i = 0; i < subpathCombinations.length; i++) {
-      const subpathCombination = subpathCombinations[i];
-      const navigationEntry = collections && collections.sort((a, b) => (a.slug ?? "").localeCompare(b.slug ?? "")).find((entry) => entry.slug === subpathCombination);
-      if (navigationEntry) {
-        if (subpathCombination === slugOrPath) {
-          result = navigationEntry;
-        } else if (navigationEntry.subcollections) {
-          const newPath = slugOrPath.replace(subpathCombination, "").split("/").slice(2).join("/");
-          if (newPath.length > 0) result = getCollectionBySlugWithin(newPath, getSubcollections(navigationEntry));
-        }
-      }
-      if (result) break;
-    }
-    return result;
-  }
-  function getCollectionPathsCombinations(subpaths) {
-    const entries = subpaths.length > 0 && subpaths.length % 2 === 0 ? subpaths.splice(0, subpaths.length - 1) : subpaths;
-    const length = entries.length;
-    const result = [];
-    for (let i = length; i > 0; i = i - 2) {
-      result.push(entries.slice(0, i).join("/"));
-    }
-    return result;
-  }
-  function navigateToEntity({
-    openEntityMode,
-    collection,
-    entityId,
-    copy,
-    path,
-    selectedTab,
-    sideEntityController,
-    onClose,
-    navigation
-  }) {
-    if (openEntityMode === "side_panel") {
-      sideEntityController.open({
-        entityId,
-        path,
-        copy,
-        selectedTab,
-        collection,
-        updateUrl: true,
-        onClose
+    if (types.isPostgresCollection(collection) && collection.relations) {
+      const manyRelations = collection.relations.filter((r) => r.cardinality === "many");
+      return manyRelations.map((r) => {
+        const target = r.target();
+        return r.overrides ? utils.mergeDeep(target, r.overrides) : target;
       });
-    } else {
-      let to = navigation.buildUrlCollectionPath(entityId ? `${path ?? path}/${entityId}` : path ?? path);
-      if (entityId && selectedTab) {
-        to += `/${selectedTab}`;
-      }
-      if (!entityId) {
-        to += "#new";
-      }
-      if (copy) {
-        to += "#copy";
-      }
-      navigation.navigate(to);
-    }
-  }
-  const reservedKeys = ["edit", "copy", "delete"];
-  function mergeEntityActions(currentActions, newActions) {
-    const updatedActions = [];
-    currentActions.forEach((action) => {
-      const newAction = newActions.find((a) => a.key === action.key);
-      if (newAction) {
-        const mergedAction = {
-          ...action,
-          ...newAction
-        };
-        updatedActions.push(mergedAction);
-      } else {
-        updatedActions.push(action);
-      }
-    });
-    newActions.forEach((action) => {
-      if (!currentActions.find((a) => a.key === action.key) && (!action.key || !reservedKeys.includes(action.key))) {
-        updatedActions.push(action);
-      }
-    });
-    return updatedActions;
+    }
+    return [];
   }
   function evaluateAST(sqlString, auth, entity) {
     if (!entity) return true;
@@ -1163,10 +627,11 @@
     return true;
   }
   function checkOperation(collection, authController, entity, targetOperation) {
-    if (!collection.securityRules || collection.securityRules.length === 0) {
+    const securityRules = types.isPostgresCollection(collection) ? collection.securityRules : void 0;
+    if (!securityRules || securityRules.length === 0) {
       return true;
     }
-    const applicableRules = collection.securityRules.filter((r) => r.operation === targetOperation || r.operation === "all" || r.operations?.includes(targetOperation) || r.operations?.includes("all"));
+    const applicableRules = securityRules.filter((r) => r.operation === targetOperation || r.operation === "all" || r.operations?.includes(targetOperation) || r.operations?.includes("all"));
     if (applicableRules.length === 0) return false;
     const userRoleIds = authController.user?.roles ?? [];
     const userRoles = [...userRoleIds, "public"];
@@ -1203,127 +668,11 @@
     return checkOperation(collection, authController, entity, "update");
   }
   function canCreateEntity(collection, authController, path, entity) {
-    if (collection.collectionGroup) return false;
     return checkOperation(collection, authController, entity, "insert");
   }
   function canDeleteEntity(collection, authController, path, entity) {
     return checkOperation(collection, authController, entity, "delete");
   }
-  function plural(word, amount) {
-    if (amount !== void 0 && amount === 1) {
-      return word;
-    }
-    const plurals = {
-      "(quiz)$": "$1zes",
-      "^(ox)$": "$1en",
-      "([m|l])ouse$": "$1ice",
-      "(matr|vert|ind)ix|ex$": "$1ices",
-      "(x|ch|ss|sh)$": "$1es",
-      "([^aeiouy]|qu)y$": "$1ies",
-      "(hive)$": "$1s",
-      "(?:([^f])fe|([lr])f)$": "$1$2ves",
-      "(shea|lea|loa|thie)f$": "$1ves",
-      sis$: "ses",
-      "([ti])um$": "$1a",
-      "(tomat|potat|ech|her|vet)o$": "$1oes",
-      "(bu)s$": "$1ses",
-      "(alias)$": "$1es",
-      "(octop)us$": "$1i",
-      "(ax|test)is$": "$1es",
-      "(us)$": "$1es",
-      "([^s]+)$": "$1s"
-    };
-    const irregular = {
-      move: "moves",
-      foot: "feet",
-      goose: "geese",
-      sex: "sexes",
-      child: "children",
-      man: "men",
-      tooth: "teeth",
-      person: "people"
-    };
-    const uncountable = ["sheep", "fish", "deer", "moose", "series", "species", "money", "rice", "information", "equipment", "bison", "cod", "offspring", "pike", "salmon", "shrimp", "swine", "trout", "aircraft", "hovercraft", "spacecraft", "sugar", "tuna", "you", "wood"];
-    if (uncountable.indexOf(word.toLowerCase()) >= 0) {
-      return word;
-    }
-    for (const w in irregular) {
-      const pattern = new RegExp(`${w}$`, "i");
-      const replace = irregular[w];
-      if (pattern.test(word)) {
-        return word.replace(pattern, replace);
-      }
-    }
-    for (const reg in plurals) {
-      const pattern = new RegExp(reg, "i");
-      if (pattern.test(word)) {
-        return word.replace(pattern, plurals[reg]);
-      }
-    }
-    return word;
-  }
-  function singular(word, amount) {
-    if (amount !== void 0 && amount !== 1) {
-      return word;
-    }
-    const singulars = {
-      "(quiz)zes$": "$1",
-      "(matr)ices$": "$1ix",
-      "(vert|ind)ices$": "$1ex",
-      "^(ox)en$": "$1",
-      "(alias)es$": "$1",
-      "(octop|vir)i$": "$1us",
-      "(cris|ax|test)es$": "$1is",
-      "(shoe)s$": "$1",
-      "(o)es$": "$1",
-      "(bus)es$": "$1",
-      "([m|l])ice$": "$1ouse",
-      "(x|ch|ss|sh)es$": "$1",
-      "(m)ovies$": "$1ovie",
-      "(s)eries$": "$1eries",
-      "([^aeiouy]|qu)ies$": "$1y",
-      "([lr])ves$": "$1f",
-      "(tive)s$": "$1",
-      "(hive)s$": "$1",
-      "(li|wi|kni)ves$": "$1fe",
-      "(shea|loa|lea|thie)ves$": "$1f",
-      "(^analy)ses$": "$1sis",
-      "((a)naly|(b)a|(d)iagno|(p)arenthe|(p)rogno|(s)ynop|(t)he)ses$": "$1$2sis",
-      "([ti])a$": "$1um",
-      "(n)ews$": "$1ews",
-      "(h|bl)ouses$": "$1ouse",
-      "(corpse)s$": "$1",
-      "(us)es$": "$1",
-      s$: ""
-    };
-    const irregular = {
-      move: "moves",
-      foot: "feet",
-      goose: "geese",
-      sex: "sexes",
-      child: "children",
-      man: "men",
-      tooth: "teeth",
-      person: "people"
-    };
-    const uncountable = ["sheep", "fish", "deer", "moose", "series", "species", "money", "rice", "information", "equipment", "bison", "cod", "offspring", "pike", "salmon", "shrimp", "swine", "trout", "aircraft", "hovercraft", "spacecraft", "sugar", "tuna", "you", "wood"];
-    if (uncountable.indexOf(word.toLowerCase()) >= 0) {
-      return word;
-    }
-    for (const w in irregular) {
-      const pattern = new RegExp(`${irregular[w]}$`, "i");
-      if (pattern.test(word)) {
-        return word.replace(pattern, w);
-      }
-    }
-    for (const reg in singulars) {
-      const pattern = new RegExp(reg, "i");
-      if (pattern.test(word)) {
-        return word.replace(pattern, singulars[reg]);
-      }
-    }
-    return word;
-  }
   function getEntityImagePreviewPropertyKey(collection) {
     for (const key in collection.properties) {
       const property = collection.properties[key];
@@ -1345,46 +694,136 @@
     }
     for (const key in collection.properties) {
       const property = collection.properties[key];
-      if (property.type === "array" && property.of?.type === "string" && property.of.url === "image") {
+      if (property.type === "array" && property.of && !Array.isArray(property.of) && property.of.type === "string" && property.of.url === "image") {
+        return key;
+      }
+    }
+    for (const key in collection.properties) {
+      const property = collection.properties[key];
+      if (property.type === "string" && property.storage && !property.storage.acceptedFiles) {
+        return key;
+      }
+    }
+    for (const key in collection.properties) {
+      const property = collection.properties[key];
+      if (property.type === "array" && !Array.isArray(property.of) && property.of?.type === "string" && property.of.storage && !property.of.storage.acceptedFiles) {
         return key;
       }
     }
     return void 0;
   }
-  function flattenObject(obj, parentKey = "") {
-    if (!obj) return obj;
-    return Object.keys(obj).reduce((flatObj, key) => {
-      const newKey = parentKey ? `${parentKey}.${key}` : key;
-      if (typeof obj[key] === "object" && obj[key] !== null) {
-        if (Array.isArray(obj[key])) {
-          obj[key].forEach((item, index) => {
-            Object.assign(flatObj, flattenObject(item, `${newKey}[${index}]`));
-          });
+  function removeInitialAndTrailingSlashes(s) {
+    return removeInitialSlash(removeTrailingSlash(s));
+  }
+  function removeInitialSlash(s) {
+    if (s.startsWith("/")) return s.slice(1);
+    else return s;
+  }
+  function removeTrailingSlash(s) {
+    if (s.endsWith("/")) return s.slice(0, -1);
+    else return s;
+  }
+  function addInitialSlash(s) {
+    if (s.startsWith("/")) return s;
+    else return `/${s}`;
+  }
+  function getLastSegment(path) {
+    const cleanPath = removeInitialAndTrailingSlashes(path);
+    if (cleanPath.includes("/")) {
+      const segments = cleanPath.split("/");
+      return segments[segments.length - 1];
+    }
+    return cleanPath;
+  }
+  function resolveCollectionPathIds(path, allCollections) {
+    let remainingPath = removeInitialAndTrailingSlashes(path);
+    if (!remainingPath) {
+      return "";
+    }
+    let currentCollections = allCollections;
+    const resolvedPathParts = [];
+    while (remainingPath.length > 0) {
+      if (!currentCollections || currentCollections.length === 0) {
+        console.warn(`resolveCollectionPathIds: Path structure implies subcollections, but none found before segment starting with "${remainingPath}" in original path "${path}". Appending remaining original path.`);
+        resolvedPathParts.push(remainingPath);
+        remainingPath = "";
+        break;
+      }
+      let foundMatch = false;
+      const potentialMatches = currentCollections.flatMap((col) => [{
+        col,
+        match: col.slug
+      }]).filter((p) => p.match && remainingPath.startsWith(p.match)).sort((a, b) => b.match.length - a.match.length);
+      if (potentialMatches.length > 0) {
+        const {
+          col: foundCollection,
+          match: matchString
+        } = potentialMatches[0];
+        resolvedPathParts.push(foundCollection.slug);
+        remainingPath = removeInitialSlash(remainingPath.substring(matchString.length));
+        if (remainingPath.length === 0) {
+          foundMatch = true;
+          break;
+        }
+        const idSeparatorIndex = remainingPath.indexOf("/");
+        let entityId;
+        if (idSeparatorIndex > -1) {
+          entityId = remainingPath.substring(0, idSeparatorIndex);
+          remainingPath = remainingPath.substring(idSeparatorIndex + 1);
         } else {
-          Object.assign(flatObj, flattenObject(obj[key], newKey));
+          entityId = remainingPath;
+          remainingPath = "";
+          console.warn(`resolveCollectionPathIds: Path seems to end with an entity ID "${entityId}" instead of a collection segment in original path "${path}". This might indicate an invalid input path.`);
         }
-      } else {
-        flatObj[newKey] = obj[key];
-      }
-      return flatObj;
-    }, {});
-  }
-  function getArrayValuesCount(array) {
-    return array.reduce((acc, obj) => {
-      Object.entries(obj).forEach(([key, value]) => {
-        if (Array.isArray(value)) {
-          acc[key] = Math.max(acc[key] || 0, value.length);
+        resolvedPathParts.push(entityId);
+        currentCollections = getSubcollections(foundCollection);
+        foundMatch = true;
+        if (!currentCollections && remainingPath.length > 0) {
+          console.warn(`resolveCollectionPathIds: Path continues after entity ID "${entityId}", but no subcollections are defined for the preceding collection "${foundCollection.slug}" in path "${path}". Appending remaining original path.`);
+          resolvedPathParts.push(remainingPath);
+          remainingPath = "";
+          break;
         }
-        if (typeof value === "object" && value !== null) {
-          const nested = getArrayValuesCount([value]);
-          Object.entries(nested).forEach(([nestedKey, nestedCount]) => {
-            const compoundKey = `${key}.${nestedKey}`;
-            acc[compoundKey] = Math.max(acc[compoundKey] || 0, nestedCount);
-          });
+      }
+      if (!foundMatch) {
+        console.warn(`resolveCollectionPathIds: Collection definition not found for segment starting with "${remainingPath}" in original path "${path}". Appending remaining original path.`);
+        resolvedPathParts.push(remainingPath);
+        remainingPath = "";
+        break;
+      }
+    }
+    return resolvedPathParts.join("/");
+  }
+  function getCollectionBySlugWithin(slugOrPath, collections) {
+    const subpaths = removeInitialAndTrailingSlashes(slugOrPath).split("/");
+    if (subpaths.length % 2 === 0) {
+      throw Error(`getCollectionBySlug: Collection paths must have an odd number of segments: ${slugOrPath}`);
+    }
+    const subpathCombinations = getCollectionPathsCombinations(subpaths);
+    let result;
+    for (let i = 0; i < subpathCombinations.length; i++) {
+      const subpathCombination = subpathCombinations[i];
+      const navigationEntry = collections && collections.sort((a, b) => (a.slug ?? "").localeCompare(b.slug ?? "")).find((entry) => entry.slug === subpathCombination);
+      if (navigationEntry) {
+        if (subpathCombination === slugOrPath) {
+          result = navigationEntry;
+        } else if (getSubcollections(navigationEntry).length > 0) {
+          const newPath = slugOrPath.replace(subpathCombination, "").split("/").slice(2).join("/");
+          if (newPath.length > 0) result = getCollectionBySlugWithin(newPath, getSubcollections(navigationEntry));
         }
-      });
-      return acc;
-    }, {});
+      }
+      if (result) break;
+    }
+    return result;
+  }
+  function getCollectionPathsCombinations(subpaths) {
+    const entries = subpaths.length > 0 && subpaths.length % 2 === 0 ? subpaths.splice(0, subpaths.length - 1) : subpaths;
+    const length = entries.length;
+    const result = [];
+    for (let i = length; i > 0; i = i - 2) {
+      result.push(entries.slice(0, i).join("/"));
+    }
+    return result;
   }
   function getNavigationEntriesFromPath(props) {
     const {
@@ -1425,7 +864,7 @@
               throw Error("collection not found resolving path: " + collection);
             }
             const entityViews = collection.entityViews;
-            const customView = entityViews && entityViews.map((entry) => resolveEntityView(entry, props.contextEntityViews)).filter(Boolean).find((entry) => entry.key === newPath);
+            const customView = entityViews && entityViews.map((entry) => resolveEntityView(entry, props.contextEntityViews)).filter((v) => v != null).find((entry) => entry.key === newPath);
             const subcollections = getSubcollections(collection);
             if (customView) {
               result.push({
@@ -1485,7 +924,7 @@
             if (!collection) {
               throw Error("collection not found resolving path: " + collection);
             }
-            if (collection.subcollections) {
+            if (getSubcollections(collection).length > 0) {
               result.push(...getParentReferencesFromPath({
                 path: newPath,
                 collections: getSubcollections(collection),
@@ -1523,9 +962,6 @@
   function buildAdditionalFieldDelegate(additionalFieldDelegate) {
     return additionalFieldDelegate;
   }
-  function buildFieldConfig(propertyConfig) {
-    return propertyConfig;
-  }
   async function resolveStorageFilenameString({
     input,
     storage,
@@ -1557,7 +993,7 @@
         path
       });
     }
-    if (!result) result = randomString() + "_" + file.name;
+    if (!result) result = utils.randomString() + "_" + file.name;
     return result;
   }
   function resolveStoragePathString({
@@ -1591,7 +1027,7 @@
         path
       });
     }
-    if (!result) result = randomString() + "_" + file.name;
+    if (!result) result = utils.randomString() + "_" + file.name;
     return result;
   }
   function replacePlaceholders({
@@ -1602,7 +1038,7 @@
     path
   }) {
     const ext = file.name.split(".").pop();
-    let result = input.replace("{propertyKey}", propertyKey).replace("{rand}", randomString()).replace("{file}", file.name).replace("{file.type}", file.type);
+    let result = input.replace("{propertyKey}", propertyKey).replace("{rand}", utils.randomString()).replace("{file}", file.name).replace("{file.type}", file.type);
     if (entityId) {
       result = result.replace("{entityId}", String(entityId));
     }
@@ -1614,12 +1050,9 @@
       const name = file.name.replace(`.${ext}`, "");
       result = result.replace("{file.name}", name);
     }
-    if (!result) result = randomString() + "_" + file.name;
+    if (!result) result = utils.randomString() + "_" + file.name;
     return result;
   }
-  function toArray(input) {
-    return Array.isArray(input) ? input : input ? [input] : [];
-  }
   function hasPropertyCallbacks(properties, callbackName) {
     if (!properties) return false;
     for (const property of Object.values(properties)) {
@@ -1638,13 +1071,13 @@
   }
   async function processProperties(properties, values, previousValues, propsContext, callbackName) {
     if (!values || typeof values !== "object") return values;
-    let result = {
+    const result = {
       ...values
     };
     for (const [key, property] of Object.entries(properties)) {
       if (result[key] === void 0) continue;
       let currentValue = result[key];
-      let previousValue = previousValues?.[key];
+      const previousValue = previousValues?.[key];
       if (property.type === "array" && Array.isArray(currentValue)) {
         if (property.of && !Array.isArray(property.of)) {
           currentValue = await Promise.all(currentValue.map(async (item, index) => {
@@ -1696,22 +1129,6 @@
     }
     return Object.keys(propertyCallbacks).length > 0 ? propertyCallbacks : void 0;
   };
-  function hashString(str) {
-    let hash2 = 0;
-    let i;
-    let chr;
-    for (i = 0; i < str.length; i++) {
-      chr = str.charCodeAt(i);
-      hash2 = (hash2 << 5) - hash2 + chr;
-      hash2 |= 0;
-    }
-    return Math.abs(hash2);
-  }
-  function generateForeignKeyName(name) {
-    const snakeCaseName = toSnakeCase(name);
-    const singularName = snakeCaseName.endsWith("s") ? snakeCaseName.slice(0, -1) : snakeCaseName;
-    return `${singularName}_id`;
-  }
   function sanitizeRelation(relation, sourceCollection) {
     if (!relation.target) {
       throw new Error("Relation is missing a `target` collection.");
@@ -1721,7 +1138,7 @@
       ...relation
     };
     if (!newRelation.relationName) {
-      newRelation.relationName = toSnakeCase(targetCollection.slug ?? targetCollection.dbPath);
+      newRelation.relationName = utils.toSnakeCase(targetCollection.slug);
     }
     if (!newRelation.direction) {
       if (newRelation.foreignKeyOnTarget) newRelation.direction = "inverse";
@@ -1730,10 +1147,10 @@
       else newRelation.direction = "owning";
     }
     if (!newRelation.joinPath) {
-      const sourceName = toSnakeCase(sourceCollection.slug ?? sourceCollection.name);
+      const sourceName = utils.toSnakeCase(sourceCollection.slug ?? sourceCollection.name);
       if (newRelation.cardinality === "one" && newRelation.direction === "owning") {
         if (!newRelation.localKey) {
-          newRelation.localKey = generateForeignKeyName(newRelation.relationName);
+          newRelation.localKey = utils.generateForeignKeyName(newRelation.relationName);
         }
       } else if (newRelation.cardinality === "one" && newRelation.direction === "inverse") {
         if (!newRelation.foreignKeyOnTarget) {
@@ -1744,7 +1161,7 @@
               if (targetRel.direction === "owning" && targetRel.cardinality === "one" && targetRel.localKey) {
                 try {
                   const targetRelTarget = targetRel.target();
-                  if (targetRelTarget.slug === sourceCollection.slug || targetRelTarget.dbPath === sourceCollection.dbPath) {
+                  if (targetRelTarget.slug === sourceCollection.slug) {
                     newRelation.foreignKeyOnTarget = targetRel.localKey;
                     foundForeignKey = true;
                     break;
@@ -1757,8 +1174,8 @@
           } catch (e) {
           }
           if (!foundForeignKey) {
-            const keyPrefix = newRelation.inverseRelationName ? toSnakeCase(newRelation.inverseRelationName) : sourceName;
-            newRelation.foreignKeyOnTarget = generateForeignKeyName(keyPrefix);
+            const keyPrefix = newRelation.inverseRelationName ? utils.toSnakeCase(newRelation.inverseRelationName) : sourceName;
+            newRelation.foreignKeyOnTarget = utils.generateForeignKeyName(keyPrefix);
           }
         }
       } else if (newRelation.cardinality === "many" && newRelation.direction === "inverse") {
@@ -1767,7 +1184,7 @@
           try {
             const targetRelations = targetCollection.relations || [];
             for (const targetRel of targetRelations) {
-              if (targetRel.cardinality === "many" && targetRel.direction === "owning" && targetRel.through && targetRel.relationName === newRelation.inverseRelationName) {
+              if (targetRel.cardinality === "many" && (targetRel.direction === "owning" || !targetRel.direction) && targetRel.relationName === newRelation.inverseRelationName) {
                 isManyToManyInverse = true;
                 break;
               }
@@ -1776,15 +1193,15 @@
           }
         }
         if (!isManyToManyInverse && !newRelation.foreignKeyOnTarget) {
-          newRelation.foreignKeyOnTarget = generateForeignKeyName(sourceName);
+          newRelation.foreignKeyOnTarget = utils.generateForeignKeyName(sourceName);
         }
       } else if (newRelation.cardinality === "many" && newRelation.direction === "owning") {
         const sourceTableName = getTableName(sourceCollection);
         const targetTableName = getTableName(targetCollection);
         newRelation.through = {
           table: newRelation.through?.table ?? [sourceTableName, targetTableName].sort().join("_"),
-          sourceColumn: newRelation.through?.sourceColumn ?? generateForeignKeyName(sourceName),
-          targetColumn: newRelation.through?.targetColumn ?? generateForeignKeyName(newRelation.relationName)
+          sourceColumn: newRelation.through?.sourceColumn ?? utils.generateForeignKeyName(sourceName),
+          targetColumn: newRelation.through?.targetColumn ?? utils.generateForeignKeyName(newRelation.relationName)
         };
       }
     }
@@ -1794,7 +1211,7 @@
     if (newRelation.cardinality === "one" && newRelation.direction === "inverse" && !newRelation.foreignKeyOnTarget && !newRelation.joinPath) {
       throw new Error(`Configuration Error in relation from '${sourceCollection.name}': An 'inverse' one-to-one relation requires a 'foreignKeyOnTarget'. Check the relation config for '${newRelation.relationName}'`);
     }
-    if (newRelation.cardinality === "many" && newRelation.direction === "inverse" && !newRelation.foreignKeyOnTarget && !newRelation.joinPath) {
+    if (newRelation.cardinality === "many" && newRelation.direction === "inverse" && !newRelation.foreignKeyOnTarget && !newRelation.joinPath && !newRelation.inverseRelationName) {
       throw new Error(`Configuration Error in relation from '${sourceCollection.name}': An 'inverse' one-to-many relation requires a 'foreignKeyOnTarget'. Check the relation config for '${newRelation.relationName}'`);
     }
     return newRelation;
@@ -1835,15 +1252,18 @@
     sourceCollection
   }) {
     if (property.type !== "relation") return void 0;
-    const relation = sourceCollection.relations?.find((rel) => rel.relationName === property.relationName);
+    const relation = (sourceCollection.relations ?? []).find((rel) => rel.relationName === property.relationName);
     if (!relation) {
-      console.warn(`Unrecognized relation format for property '${propertyKey}' in collection '${sourceCollection.slug || sourceCollection.dbPath}'`);
+      console.warn(`Unrecognized relation format for property '${propertyKey}' in collection '${sourceCollection.slug}'`);
       return void 0;
     }
     return relation;
   }
   function getTableName(collection) {
-    return collection.dbPath ?? toSnakeCase(collection.slug) ?? toSnakeCase(collection.name);
+    if (types.isPostgresCollection(collection)) {
+      return collection.table ?? utils.toSnakeCase(collection.slug) ?? utils.toSnakeCase(collection.name);
+    }
+    return utils.toSnakeCase(collection.slug) ?? utils.toSnakeCase(collection.name);
   }
   function getTableVarName(tableName) {
     return tableName.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
@@ -1941,7 +1361,7 @@
         email: user?.email ?? null,
         displayName: user?.displayName ?? null,
         photoURL: user?.photoURL ?? null,
-        roles: user?.roles ?? []
+        roles: (user?.roles ?? []).map((r) => typeof r === "string" ? r : r.id)
       },
       now: Date.now()
     };
@@ -1991,8 +1411,8 @@
     if (context.isNew && conditions.defaultValue !== void 0) {
       result.defaultValue = evaluateCondition(conditions.defaultValue, context);
     }
-    if ("enumValues" in result && result.enumValues && (conditions.enumConditions || conditions.allowedEnumValues || conditions.excludedEnumValues)) {
-      result.enumValues = applyEnumConditions(result.enumValues, conditions, context);
+    if ("enum" in result && result.enum && (conditions.enumConditions || conditions.allowedEnumValues || conditions.excludedEnumValues)) {
+      result.enum = applyEnumConditions(result.enum, conditions, context);
     }
     if (result.type === "reference") {
       if (conditions.referencePath) {
@@ -2058,11 +1478,11 @@
   }
   class CollectionRegistry {
     // Normalized runtime layer (used by Data Grid / UI)
-    collectionsByDbPath = /* @__PURE__ */ new Map();
+    collectionsByTableName = /* @__PURE__ */ new Map();
     collectionsBySlug = /* @__PURE__ */ new Map();
     rootCollections = [];
     // Raw configuration layer (used by Collection Editor AST generator)
-    rawCollectionsByDbPath = /* @__PURE__ */ new Map();
+    rawCollectionsByTableName = /* @__PURE__ */ new Map();
     rawCollectionsBySlug = /* @__PURE__ */ new Map();
     rawRootCollections = [];
     // Snapshot of raw input for idempotency check — compared BEFORE normalization
@@ -2074,10 +1494,10 @@
       }
     }
     reset() {
-      this.collectionsByDbPath.clear();
+      this.collectionsByTableName.clear();
       this.collectionsBySlug.clear();
       this.rootCollections = [];
-      this.rawCollectionsByDbPath.clear();
+      this.rawCollectionsByTableName.clear();
       this.rawCollectionsBySlug.clear();
       this.rawRootCollections = [];
     }
@@ -2090,7 +1510,7 @@
      * @param collections
      */
     registerMultiple(collections) {
-      const rawSnapshot = collections.map((c) => removeFunctions(c));
+      const rawSnapshot = collections.map((c) => utils.removeFunctions(c));
       if (this.lastRawInputSnapshot && fastEquals.deepEqual(this.lastRawInputSnapshot, rawSnapshot)) {
         return false;
       }
@@ -2098,7 +1518,29 @@
       const normalizedCollections = collections.map((c) => this.normalizeCollection({
         ...c
       }));
-      normalizedCollections.forEach((c, index) => this.register(c, collections[index]));
+      normalizedCollections.forEach((c, index) => {
+        const raw = cloneDeep(collections[index]);
+        this.rootCollections.push(c);
+        this.rawRootCollections.push(raw);
+        const normalized = this.normalizeCollection(c);
+        this.collectionsByTableName.set(getTableName(normalized), normalized);
+        this.rawCollectionsByTableName.set(getTableName(raw), raw);
+        if (normalized.slug) {
+          this.collectionsBySlug.set(normalized.slug, normalized);
+        }
+        if (raw.slug) {
+          this.rawCollectionsBySlug.set(raw.slug, raw);
+        }
+      });
+      normalizedCollections.forEach((c, index) => {
+        const subcollections = getSubcollections(c);
+        const rawSubcollections = getSubcollections(collections[index]);
+        if (subcollections && rawSubcollections) {
+          subcollections.forEach((subCollection, subIndex) => {
+            this._registerRecursively(this.normalizeCollection(subCollection), cloneDeep(rawSubcollections[subIndex]));
+          });
+        }
+      });
       this.lastRawInputSnapshot = rawSnapshot;
       return true;
     }
@@ -2109,12 +1551,12 @@
       this._registerRecursively(collection, raw);
     }
     _registerRecursively(collection, rawCollection) {
-      if (this.collectionsByDbPath.has(collection.dbPath)) {
+      if (this.collectionsByTableName.has(getTableName(collection))) {
         return;
       }
       const normalizedCollection = this.normalizeCollection(collection);
-      this.collectionsByDbPath.set(normalizedCollection.dbPath, normalizedCollection);
-      this.rawCollectionsByDbPath.set(rawCollection.dbPath, rawCollection);
+      this.collectionsByTableName.set(getTableName(normalizedCollection), normalizedCollection);
+      this.rawCollectionsByTableName.set(getTableName(rawCollection), rawCollection);
       if (normalizedCollection.slug) {
         this.collectionsBySlug.set(normalizedCollection.slug, normalizedCollection);
       }
@@ -2130,8 +1572,22 @@
       }
     }
     normalizeCollection(collection) {
-      const properties = this.normalizeProperties(collection.properties, collection.relations ?? []);
+      const relations = types.isPostgresCollection(collection) ? collection.relations ?? [] : [];
+      const properties = this.normalizeProperties(collection.properties, relations);
       collection.properties = properties;
+      if (!collection.childCollections) {
+        if (types.isFirebaseCollection(collection) && collection.subcollections) {
+          collection.childCollections = collection.subcollections;
+        } else if (types.isPostgresCollection(collection) && collection.relations) {
+          const manyRelations = collection.relations.filter((r) => r.cardinality === "many");
+          if (manyRelations.length > 0) {
+            collection.childCollections = () => manyRelations.map((r) => {
+              const target = r.target();
+              return r.overrides ? utils.mergeDeep(target, r.overrides) : target;
+            });
+          }
+        }
+      }
       return collection;
     }
     normalizeProperties(properties, relations) {
@@ -2148,10 +1604,15 @@
       if (newProperty.type === "map" && newProperty.properties) {
         newProperty.properties = this.normalizeProperties(newProperty.properties, relations);
       } else if (newProperty.type === "array") {
-        if (newProperty.of) {
-          newProperty.of = this.normalizeProperty(newProperty.of, relations);
-        } else if (newProperty.oneOf && newProperty.oneOf.properties) {
-          newProperty.oneOf.properties = this.normalizeProperties(newProperty.oneOf.properties, relations);
+        const arrayProp = newProperty;
+        if (arrayProp.of) {
+          if (Array.isArray(arrayProp.of)) {
+            arrayProp.of = arrayProp.of.map((p) => this.normalizeProperty(p, relations));
+          } else {
+            arrayProp.of = this.normalizeProperty(arrayProp.of, relations);
+          }
+        } else if (arrayProp.oneOf && arrayProp.oneOf.properties) {
+          arrayProp.oneOf.properties = this.normalizeProperties(arrayProp.oneOf.properties, relations);
         }
       } else if ((newProperty.type === "string" || newProperty.type === "number") && newProperty.enum) {
         const stringOrNumberProperty = newProperty;
@@ -2172,7 +1633,7 @@
     get(path) {
       const bySlug = this.collectionsBySlug.get(path);
       if (bySlug) return bySlug;
-      return this.collectionsByDbPath.get(path);
+      return this.collectionsByTableName.get(path);
     }
     /**
      * Gets the pristine, un-normalized collection exactly as it was provided.
@@ -2181,7 +1642,7 @@
     getRaw(path) {
       const bySlug = this.rawCollectionsBySlug.get(path);
       if (bySlug) return bySlug;
-      return this.rawCollectionsByDbPath.get(path);
+      return this.rawCollectionsByTableName.get(path);
     }
     /**
      * Get collection by resolving multi-segment paths through relations
@@ -2202,10 +1663,13 @@
       }
       for (let i = 2; i < pathSegments.length; i += 2) {
         const relationKey = pathSegments[i];
+        if (!types.isPostgresCollection(currentCollection)) {
+          throw new Error(`Relation path navigation requires a PostgreSQL collection, but '${currentCollection.slug}' uses driver '${currentCollection.driver}'`);
+        }
         const resolvedRelations = resolveCollectionRelations(currentCollection);
         const relation = resolvedRelations[relationKey];
         if (!relation) {
-          throw new Error(`Relation '${relationKey}' not found in collection '${currentCollection.slug || currentCollection.dbPath}'`);
+          throw new Error(`Relation '${relationKey}' not found in collection '${currentCollection.slug}'`);
         }
         currentCollection = relation.target();
         if (i + 1 < pathSegments.length) ;
@@ -2213,10 +1677,10 @@
       return currentCollection;
     }
     getCollections() {
-      return Array.from(this.collectionsByDbPath.values());
+      return Array.from(this.collectionsByTableName.values());
     }
     getRawCollections() {
-      return Array.from(this.rawCollectionsByDbPath.values());
+      return Array.from(this.rawCollectionsByTableName.values());
     }
     /**
      * Resolves a multi-segment path like "products/123/locales" and returns
@@ -2242,13 +1706,13 @@
         entityIds.push(entityId);
         if (i + 1 < pathSegments.length) {
           const subcollectionSlug = pathSegments[i + 1];
-          const subcollections = currentCollection.subcollections?.();
-          if (!subcollections) {
-            throw new Error(`No subcollections found for ${currentCollection.slug || currentCollection.dbPath} in path: ${path}`);
+          const subcollections = getSubcollections(currentCollection);
+          if (!subcollections || subcollections.length === 0) {
+            throw new Error(`No subcollections found for ${currentCollection.slug} in path: ${path}`);
           }
           const subcollection = subcollections.find((c) => c.slug === subcollectionSlug);
           if (!subcollection) {
-            throw new Error(`Subcollection '${subcollectionSlug}' not found in ${currentCollection.slug || currentCollection.dbPath}`);
+            throw new Error(`Subcollection '${subcollectionSlug}' not found in ${currentCollection.slug}`);
           }
           currentCollection = subcollection;
           collections.push(currentCollection);
@@ -2261,6 +1725,166 @@
       };
     }
   }
+  function convertWhereToFilter(where) {
+    if (!where) return void 0;
+    const operatorMap = {
+      "eq": "==",
+      "neq": "!=",
+      "gt": ">",
+      "gte": ">=",
+      "lt": "<",
+      "lte": "<=",
+      "in": "in",
+      "nin": "not-in",
+      "cs": "array-contains",
+      "csa": "array-contains-any"
+    };
+    const filter = {};
+    for (const [field, rawValue] of Object.entries(where)) {
+      const dotIndex = rawValue.indexOf(".");
+      if (dotIndex === -1) continue;
+      const op = rawValue.substring(0, dotIndex);
+      let value = rawValue.substring(dotIndex + 1);
+      if (typeof value === "string" && value.startsWith("(") && value.endsWith(")")) {
+        value = value.slice(1, -1).split(",").map((v) => v.trim());
+      }
+      if (typeof value === "string" && !isNaN(Number(value)) && value.trim() !== "") {
+        value = Number(value);
+      }
+      const mappedOp = operatorMap[op];
+      if (mappedOp) {
+        filter[field] = [mappedOp, value];
+      }
+    }
+    return Object.keys(filter).length > 0 ? filter : void 0;
+  }
+  function parseOrderBy(orderBy) {
+    if (!orderBy) return void 0;
+    const parts = orderBy.split(":");
+    const field = parts[0];
+    const direction = parts[1] || "asc";
+    return [field, direction];
+  }
+  function createDriverAccessor(driver, slug) {
+    return {
+      async find(params) {
+        const orderParsed = parseOrderBy(params?.orderBy);
+        const entities = await driver.fetchCollection({
+          path: slug,
+          limit: params?.limit,
+          startAfter: params?.offset,
+          filter: convertWhereToFilter(params?.where),
+          orderBy: orderParsed?.[0],
+          order: orderParsed?.[1],
+          searchString: params?.searchString
+        });
+        const limit = params?.limit ?? 20;
+        const offset = params?.offset ?? 0;
+        return {
+          data: entities,
+          meta: {
+            total: entities.length,
+            limit,
+            offset,
+            hasMore: entities.length >= limit
+          }
+        };
+      },
+      async findById(id) {
+        return driver.fetchEntity({
+          path: slug,
+          entityId: id
+        });
+      },
+      async create(data, id) {
+        return driver.saveEntity({
+          path: slug,
+          values: data,
+          entityId: id,
+          status: "new"
+        });
+      },
+      async update(id, data) {
+        return driver.saveEntity({
+          path: slug,
+          values: data,
+          entityId: id,
+          status: "existing"
+        });
+      },
+      async delete(id) {
+        return driver.deleteEntity({
+          entity: {
+            id,
+            path: slug,
+            values: {}
+          }
+        });
+      },
+      count: driver.countEntities ? async (params) => {
+        return driver.countEntities({
+          path: slug,
+          filter: convertWhereToFilter(params?.where)
+        });
+      } : void 0,
+      listen: driver.listenCollection ? (params, onUpdate, onError) => {
+        const orderParsed = parseOrderBy(params?.orderBy);
+        const limit = params?.limit ?? 20;
+        const offset = params?.offset ?? 0;
+        return driver.listenCollection({
+          path: slug,
+          limit: params?.limit,
+          startAfter: params?.offset,
+          filter: convertWhereToFilter(params?.where),
+          orderBy: orderParsed?.[0],
+          order: orderParsed?.[1],
+          searchString: params?.searchString,
+          onUpdate: (entities) => {
+            onUpdate({
+              data: entities,
+              meta: {
+                total: entities.length,
+                limit,
+                offset,
+                hasMore: entities.length >= limit
+              }
+            });
+          },
+          onError
+        });
+      } : void 0,
+      listenById: driver.listenEntity ? (id, onUpdate, onError) => {
+        return driver.listenEntity({
+          path: slug,
+          entityId: id,
+          onUpdate: (entity) => onUpdate(entity ?? void 0),
+          onError
+        });
+      } : void 0
+    };
+  }
+  function buildRebaseData(driver) {
+    const cache = /* @__PURE__ */ new Map();
+    function getAccessor(slug) {
+      let accessor = cache.get(slug);
+      if (!accessor) {
+        accessor = createDriverAccessor(driver, slug);
+        cache.set(slug, accessor);
+      }
+      return accessor;
+    }
+    const target = {
+      collection: getAccessor
+    };
+    return new Proxy(target, {
+      get(_target, prop) {
+        if (prop === "collection") return getAccessor;
+        if (typeof prop === "symbol") return void 0;
+        if (prop === "then" || prop === "toJSON" || prop === "$$typeof") return void 0;
+        return getAccessor(prop);
+      }
+    });
+  }
   exports2.COLLECTION_PATH_SEPARATOR = COLLECTION_PATH_SEPARATOR;
   exports2.CollectionRegistry = CollectionRegistry;
   exports2.DEFAULT_ONE_OF_TYPE = DEFAULT_ONE_OF_TYPE;
@@ -2273,23 +1897,19 @@
   exports2.buildEntityCallbacks = buildEntityCallbacks;
   exports2.buildEnum = buildEnum;
   exports2.buildEnumValueConfig = buildEnumValueConfig;
-  exports2.buildFieldConfig = buildFieldConfig;
   exports2.buildProperties = buildProperties;
   exports2.buildPropertiesOrBuilder = buildPropertiesOrBuilder;
   exports2.buildProperty = buildProperty;
   exports2.buildPropertyCallbacks = buildPropertyCallbacks;
+  exports2.buildRebaseData = buildRebaseData;
   exports2.canCreateEntity = canCreateEntity;
   exports2.canDeleteEntity = canDeleteEntity;
   exports2.canEditEntity = canEditEntity;
   exports2.canReadCollection = canReadCollection;
-  exports2.clone = clone;
-  exports2.defaultDateFormat = defaultDateFormat;
   exports2.enumToObjectEntries = enumToObjectEntries;
   exports2.evaluateCondition = evaluateCondition;
-  exports2.flattenObject = flattenObject;
   exports2.fullPathToCollectionSegments = fullPathToCollectionSegments;
   exports2.getArrayResolvedProperties = getArrayResolvedProperties;
-  exports2.getArrayValuesCount = getArrayValuesCount;
   exports2.getCollectionBySlugWithin = getCollectionBySlugWithin;
   exports2.getCollectionPathsCombinations = getCollectionPathsCombinations;
   exports2.getColumnName = getColumnName;
@@ -2298,8 +1918,6 @@
   exports2.getDefaultValuesFor = getDefaultValuesFor;
   exports2.getEntityImagePreviewPropertyKey = getEntityImagePreviewPropertyKey;
   exports2.getEnumVarName = getEnumVarName;
-  exports2.getHashValue = getHashValue;
-  exports2.getIn = getIn$1;
   exports2.getLabelOrConfigFrom = getLabelOrConfigFrom;
   exports2.getLastSegment = getLastSegment;
   exports2.getLocalChangesBackup = getLocalChangesBackup;
@@ -2311,44 +1929,18 @@
   exports2.getSubcollections = getSubcollections;
   exports2.getTableName = getTableName;
   exports2.getTableVarName = getTableVarName;
-  exports2.getValueInPath = getValueInPath;
-  exports2.hashString = hashString;
-  exports2.hydrateRegExp = hydrateRegExp;
-  exports2.isDefaultFieldConfigId = isDefaultFieldConfigId;
-  exports2.isEmptyArray = isEmptyArray;
-  exports2.isEmptyObject = isEmptyObject;
-  exports2.isFunction = isFunction;
   exports2.isHidden = isHidden;
-  exports2.isInteger = isInteger;
-  exports2.isNaN = isNaN$1;
-  exports2.isObject = isObject;
-  exports2.isPlainObject = isPlainObject;
   exports2.isPropertyBuilder = isPropertyBuilder;
   exports2.isReadOnly = isReadOnly;
-  exports2.isValidRegExp = isValidRegExp;
-  exports2.mergeDeep = mergeDeep;
-  exports2.mergeEntityActions = mergeEntityActions;
-  exports2.navigateToEntity = navigateToEntity;
-  exports2.pick = pick;
-  exports2.plural = plural;
-  exports2.prettifyIdentifier = prettifyIdentifier;
-  exports2.randomColor = randomColor;
-  exports2.randomString = randomString;
+  exports2.normalizeToEntityRelation = normalizeToEntityRelation;
   exports2.registerConditionOperations = registerConditionOperations;
-  exports2.removeFunctions = removeFunctions;
-  exports2.removeInPath = removeInPath;
   exports2.removeInitialAndTrailingSlashes = removeInitialAndTrailingSlashes;
   exports2.removeInitialSlash = removeInitialSlash;
-  exports2.removeNulls = removeNulls;
-  exports2.removePropsIfExisting = removePropsIfExisting;
   exports2.removeTrailingSlash = removeTrailingSlash;
-  exports2.removeUndefined = removeUndefined;
   exports2.resolveArrayProperties = resolveArrayProperties;
   exports2.resolveCollectionPathIds = resolveCollectionPathIds;
   exports2.resolveCollectionRelations = resolveCollectionRelations;
   exports2.resolveDefaultSelectedView = resolveDefaultSelectedView;
-  exports2.resolveEntityAction = resolveEntityAction;
-  exports2.resolveEntityView = resolveEntityView$1;
   exports2.resolveEnumValues = resolveEnumValues;
   exports2.resolveProperties = resolveProperties;
   exports2.resolveProperty = resolveProperty;
@@ -2357,22 +1949,13 @@
   exports2.resolveRelationProperty = resolveRelationProperty;
   exports2.resolveStorageFilenameString = resolveStorageFilenameString;
   exports2.resolveStoragePathString = resolveStoragePathString;
-  exports2.resolvedSelectedEntityView = resolvedSelectedEntityView;
   exports2.sanitizeData = sanitizeData;
   exports2.sanitizeRelation = sanitizeRelation;
   exports2.segmentsToStrippedPath = segmentsToStrippedPath;
-  exports2.serializeRegExp = serializeRegExp;
-  exports2.setIn = setIn;
-  exports2.singular = singular;
-  exports2.slugify = slugify;
   exports2.sortProperties = sortProperties;
   exports2.stripCollectionPath = stripCollectionPath;
-  exports2.toArray = toArray;
-  exports2.toKebabCase = toKebabCase;
-  exports2.toSnakeCase = toSnakeCase;
   exports2.traverseValueProperty = traverseValueProperty;
   exports2.traverseValuesProperties = traverseValuesProperties;
-  exports2.unslugify = unslugify;
   exports2.updateDateAutoValues = updateDateAutoValues;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 });