@dyrected/core 2.7.1 → 2.8.0

package/dist/index.cjs

@@ -549,6 +549,7 @@ __export(index_exports, {
   LIFECYCLE_EVENTS_COLLECTION: () => LIFECYCLE_EVENTS_COLLECTION,
   LIFECYCLE_EVENT_NAMES: () => LIFECYCLE_EVENT_NAMES,
   WORKFLOW_HISTORY_COLLECTION: () => WORKFLOW_HISTORY_COLLECTION,
+  abs: () => abs,
   addDays: () => addDays,
   assertValidAdminConditionsInConfig: () => assertValidAdminConditionsInConfig,
   assertValidDeclarativeAccessInConfig: () => assertValidDeclarativeAccessInConfig,
@@ -560,6 +561,7 @@ __export(index_exports, {
   buildSqlOrderBy: () => buildSqlOrderBy,
   canViewWorkflowDraft: () => canViewWorkflowDraft,
   capitalize: () => capitalize,
+  ceil: () => ceil,
   clamp: () => clamp,
   coalesce: () => coalesce,
   collectAdminConditionValidationIssues: () => collectAdminConditionValidationIssues,
@@ -568,6 +570,7 @@ __export(index_exports, {
   collectDeclarativeHookValidationIssues: () => collectDeclarativeHookValidationIssues,
   collectPreviewUrlValidationIssues: () => collectPreviewUrlValidationIssues,
   compact: () => compact,
+  count: () => count,
   createLifecycleEvent: () => createLifecycleEvent,
   createWorkflowDocument: () => createWorkflowDocument,
   defaultValue: () => defaultValue,
@@ -603,12 +606,28 @@ __export(index_exports, {
   diffDays: () => diffDays,
   dispatchLifecycleEvent: () => dispatchLifecycleEvent,
   dispatchPendingLifecycleEvents: () => dispatchPendingLifecycleEvents,
+  displayComputed: () => displayComputed,
+  displayCustom: () => displayCustom,
+  displayCustomComponent: () => displayCustomComponent,
+  displayDivider: () => displayDivider,
+  displayField: () => displayField,
+  displayGrid: () => displayGrid,
+  displayRepeat: () => displayRepeat,
+  displaySection: () => displaySection,
+  displayTab: () => displayTab,
+  displayTabs: () => displayTabs,
+  displayText: () => displayText,
   endsWith: () => endsWith,
+  evaluateDetailComputed: () => evaluateDetailComputed,
+  evaluateJexl: () => evaluateJexl,
+  evaluateJexlSync: () => evaluateJexlSync,
   executeFieldAfterRead: () => executeFieldAfterRead,
   executeFieldBeforeChange: () => executeFieldBeforeChange,
   first: () => first,
+  floor: () => floor,
   formatConfigDiagnostics: () => formatConfigDiagnostics,
   formatDate: () => formatDate,
+  generateDefaultDetailSchema: () => generateDefaultDetailSchema,
   generateOpenApi: () => generateOpenApi,
   get: () => get,
   getAdminAuthCollection: () => getAdminAuthCollection,
@@ -616,6 +635,7 @@ __export(index_exports, {
   includes: () => includes,
   initializeWorkflowDocument: () => initializeWorkflowDocument,
   isConfigValidationError: () => isConfigValidationError,
+  isDetailItemVisible: () => isDetailItemVisible,
   isEmpty: () => isEmpty,
   isFuture: () => isFuture,
   isPast: () => isPast,
@@ -624,12 +644,16 @@ __export(index_exports, {
   length: () => length,
   lower: () => lower,
   materializeWorkflowDocument: () => materializeWorkflowDocument,
+  max: () => max,
+  min: () => min,
   normalizeConfig: () => normalizeConfig,
+  normalizeDetailItem: () => normalizeDetailItem,
   now: () => now,
   numericFieldNames: () => numericFieldNames,
   parseMongoWhere: () => parseMongoWhere,
   parseSort: () => parseSort,
   parseSqlWhere: () => parseSqlWhere,
+  pow: () => pow,
   publishedStateName: () => publishedStateName,
   publishingWorkflow: () => publishingWorkflow,
   readingTime: () => readingTime,
@@ -641,7 +665,9 @@ __export(index_exports, {
   saveWorkflowDraft: () => saveWorkflowDraft,
   simplePublishingWorkflow: () => simplePublishingWorkflow,
   slugify: () => slugify,
+  sqrt: () => sqrt,
   startsWith: () => startsWith,
+  sum: () => sum,
   today: () => today,
   transitionWorkflow: () => transitionWorkflow,
   trim: () => trim,
@@ -1361,9 +1387,42 @@ function round(val, decimals = 0) {
 }
 function clamp(val, minVal, maxVal) {
   const num = Number(val) || 0;
-  const min = Number(minVal) || 0;
-  const max = Number(maxVal) || 0;
-  return Math.min(Math.max(num, min), max);
+  const min2 = Number(minVal) || 0;
+  const max2 = Number(maxVal) || 0;
+  return Math.min(Math.max(num, min2), max2);
+}
+function ceil(val) {
+  return Math.ceil(Number(val) || 0);
+}
+function floor(val) {
+  return Math.floor(Number(val) || 0);
+}
+function abs(val) {
+  return Math.abs(Number(val) || 0);
+}
+function min(...args) {
+  const nums = args.flat().map((n) => Number(n) || 0);
+  return nums.length ? Math.min(...nums) : 0;
+}
+function max(...args) {
+  const nums = args.flat().map((n) => Number(n) || 0);
+  return nums.length ? Math.max(...nums) : 0;
+}
+function pow(base, exp) {
+  return Math.pow(Number(base) || 0, Number(exp) || 0);
+}
+function sqrt(val) {
+  return Math.sqrt(Number(val) || 0);
+}
+function sum(arr) {
+  if (!Array.isArray(arr)) return Number(arr) || 0;
+  return arr.reduce((acc, val) => acc + (Number(val) || 0), 0);
+}
+function count(val) {
+  if (Array.isArray(val)) return val.length;
+  if (typeof val === "string") return val.length;
+  if (val !== void 0 && val !== null && val !== false) return 1;
+  return 0;
 }
 function defaultValue(val, fallback) {
   if (val === void 0 || val === null || val === "") return fallback;
@@ -1382,13 +1441,12 @@ function isEmpty(val) {
   return false;
 }
 function get(obj, path, fallback = null) {
-  if (!obj || typeof obj !== "object") return fallback;
-  const pathStr = String(path || "").trim();
-  if (!pathStr) return fallback;
-  const parts = pathStr.split(".");
+  if (obj === void 0 || obj === null || typeof obj !== "object") return fallback;
+  if (typeof path !== "string") return fallback;
+  const parts = path.split(".").filter(Boolean);
   let curr = obj;
   for (const part of parts) {
-    if (curr === void 0 || curr === null) return fallback;
+    if (curr === void 0 || curr === null || typeof curr !== "object") return fallback;
     curr = curr[part];
   }
   return curr === void 0 || curr === null ? fallback : curr;
@@ -1426,6 +1484,15 @@ function registerJexlHelpers(jexlInstance = import_jexl.default) {
     // Math
     round,
     clamp,
+    ceil,
+    floor,
+    abs,
+    min,
+    max,
+    pow,
+    sqrt,
+    sum,
+    count,
     // Objects & Logical
     default: defaultValue,
     coalesce,
@@ -1437,9 +1504,48 @@ function registerJexlHelpers(jexlInstance = import_jexl.default) {
       jexlInstance.addFunction(name, fn);
     } catch {
     }
+    try {
+      jexlInstance.addTransform(name, fn);
+    } catch {
+    }
+  }
+  try {
+    jexlInstance.addBinaryOp("and", 20, (left, right) => Boolean(left && right));
+    jexlInstance.addBinaryOp("or", 10, (left, right) => Boolean(left || right));
+  } catch {
   }
 }
 registerJexlHelpers(import_jexl.default);
+async function evaluateJexl(expression, context = {}) {
+  if (!expression || typeof expression !== "string") return void 0;
+  try {
+    const evalContext = {
+      null: null,
+      undefined: void 0,
+      ...context,
+      math: Math,
+      Math
+    };
+    return await import_jexl.default.eval(expression, evalContext);
+  } catch (_err) {
+    return void 0;
+  }
+}
+function evaluateJexlSync(expression, context = {}) {
+  if (!expression || typeof expression !== "string") return void 0;
+  try {
+    const evalContext = {
+      null: null,
+      undefined: void 0,
+      ...context,
+      math: Math,
+      Math
+    };
+    return import_jexl.default.evalSync(expression, evalContext);
+  } catch (_err) {
+    return void 0;
+  }
+}
 var BUILTIN_JEXL_HELPERS = [
   // Strings
   "slugify",
@@ -2021,7 +2127,7 @@ function collectConfigDiagnostics(config) {
 function formatConfigDiagnostics(source, diagnostics, options = {}) {
   const color = options.color ?? false;
   const header = `${colorize("Config validation failed", 31, color)} in ${colorize(source, 36, color)}`;
-  const docLink = `${colorize("   Learn how to write declarative rules:", 90, color)} ${colorize("https://docs.dyrected.com/docs/features/admin/form-and-field-hooks", 34, color)}`;
+  const docLink = `${colorize("   Learn how to write declarative rules:", 90, color)} ${colorize("https://docs.dyrected.com/docs/editor-experience/form-and-field-hooks", 34, color)}`;
   const lines = diagnostics.flatMap((issue, index) => [
     `${colorize(`${index + 1}.`, 31, color)} ${colorize(issue.path, 1, color)}`,
     `   ${issue.message}`,
@@ -3236,6 +3342,71 @@ function generateOpenApi(config) {
         responses: { 200: { description: "Deleted and failed document IDs" } }
       }
     };
+    spec.paths[`${path}/aggregate`] = {
+      post: {
+        tags: [collectionTag],
+        summary: `Aggregate ${labels.plural}`,
+        description: `Compute statistical aggregations (count, sum, avg, min, max) across ${labels.plural}.`,
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                additionalProperties: {
+                  type: "object",
+                  properties: {
+                    count: { type: "string", example: "*" },
+                    sum: { type: "string", description: "Field to sum" },
+                    avg: { type: "string", description: "Field to average" },
+                    min: { type: "string", description: "Field for minimum" },
+                    max: { type: "string", description: "Field for maximum" },
+                    cast: {
+                      type: "string",
+                      enum: [
+                        "number",
+                        "integer",
+                        "float",
+                        "boolean",
+                        "date",
+                        "string"
+                      ]
+                    },
+                    where: {
+                      type: "object",
+                      description: "Per-aggregate filter condition",
+                      additionalProperties: true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  additionalProperties: {
+                    type: "number",
+                    nullable: true
+                  }
+                }
+              }
+            }
+          },
+          400: {
+            description: "Bad Request - Invalid aggregate input"
+          },
+          403: {
+            description: "Forbidden - Access denied by read rule"
+          }
+        }
+      }
+    };
     if (collection.audit) {
       spec.paths[`${path}/__audit`] = {
         get: {
@@ -3763,6 +3934,246 @@ function fieldToSchema(field) {
   return schema;
 }
 
+// src/detail.ts
+function normalizeDetailItem(item) {
+  if (typeof item === "string") {
+    return {
+      type: "field",
+      field: item
+    };
+  }
+  return item;
+}
+function displaySection(title, items, options) {
+  return {
+    type: "section",
+    title,
+    items,
+    options
+  };
+}
+function displayTab(label, items, options) {
+  return {
+    type: "tab",
+    label,
+    items,
+    options
+  };
+}
+function displayTabs(tabs, options) {
+  return {
+    type: "tabs",
+    tabs,
+    options
+  };
+}
+function displayGrid(columns, items, options) {
+  return {
+    type: "grid",
+    columns,
+    items,
+    options
+  };
+}
+function displayField(fieldName, options) {
+  return {
+    type: "field",
+    field: fieldName,
+    options
+  };
+}
+function displayRepeat(fieldName, items, options) {
+  return {
+    type: "repeat",
+    field: fieldName,
+    items,
+    options
+  };
+}
+function displayComputed(label, expressionOrOptionsOrHandler, options) {
+  let expression;
+  let handler;
+  let finalOptions = options;
+  if (typeof expressionOrOptionsOrHandler === "string") {
+    expression = expressionOrOptionsOrHandler;
+  } else if (typeof expressionOrOptionsOrHandler === "function") {
+    handler = expressionOrOptionsOrHandler;
+  } else if (expressionOrOptionsOrHandler && typeof expressionOrOptionsOrHandler === "object") {
+    expression = expressionOrOptionsOrHandler.expression;
+    handler = expressionOrOptionsOrHandler.handler;
+    finalOptions = {
+      ...expressionOrOptionsOrHandler,
+      ...options
+    };
+  }
+  const id = finalOptions?.id || label.toLowerCase().trim().replace(/[^a-z0-9]+/g, "_");
+  return {
+    type: "computed",
+    id,
+    label,
+    expression,
+    handler,
+    options: finalOptions
+  };
+}
+function displayDivider(options) {
+  return {
+    type: "divider",
+    options
+  };
+}
+function displayText(content, options) {
+  return {
+    type: "text",
+    content,
+    options
+  };
+}
+function displayCustom(name, options) {
+  return {
+    type: "custom",
+    name,
+    options
+  };
+}
+function displayCustomComponent(name, options) {
+  return displayCustom(name, options);
+}
+async function evaluateDetailComputed(detail, doc, user, db) {
+  if (!doc || !detail || !Array.isArray(detail)) {
+    return doc;
+  }
+  const computedItems = [];
+  const extractComputed = (items) => {
+    for (const rawItem of items) {
+      if (!rawItem) continue;
+      const item = normalizeDetailItem(rawItem);
+      if (item.type === "computed") {
+        const id = item.id || item.label?.toLowerCase().replace(/[^a-z0-9]+/g, "_");
+        if (id) {
+          computedItems.push({
+            id,
+            label: item.label,
+            expression: item.expression,
+            handler: item.handler
+          });
+        }
+      } else if (item.type === "section" || item.type === "grid" || item.type === "repeat") {
+        if (item.items && Array.isArray(item.items)) {
+          extractComputed(item.items);
+        }
+      } else if (item.type === "tabs" && item.tabs && Array.isArray(item.tabs)) {
+        for (const tab of item.tabs) {
+          if (tab.items) extractComputed(tab.items);
+        }
+      }
+    }
+  };
+  extractComputed(detail);
+  if (computedItems.length === 0) return doc;
+  const evaluated = {};
+  for (const item of computedItems) {
+    try {
+      if (typeof item.handler === "function") {
+        evaluated[item.id] = await item.handler({ doc, user, db });
+      } else if (item.expression) {
+        evaluated[item.id] = await evaluateJexl(item.expression, { doc, user });
+      }
+    } catch (_err) {
+      evaluated[item.id] = null;
+    }
+  }
+  return {
+    ...doc,
+    _meta: {
+      ...doc._meta || {},
+      computed: evaluated
+    }
+  };
+}
+var SENSITIVE_DETAIL_FIELDS = /* @__PURE__ */ new Set([
+  "password",
+  "salt",
+  "resetPasswordToken",
+  "resetPasswordExpires",
+  "loginAttempts",
+  "lockUntil",
+  "apiKey",
+  "secret"
+]);
+function generateDefaultDetailSchema(schema) {
+  const fields = schema.fields || [];
+  const sidebarFieldTypes = /* @__PURE__ */ new Set([
+    "select",
+    "radio",
+    "boolean",
+    "date",
+    "datetime",
+    "relationship"
+  ]);
+  const mainFields = [];
+  const sidebarFields = [];
+  for (const field of fields) {
+    if (!field.name) continue;
+    if (SENSITIVE_DETAIL_FIELDS.has(field.name)) continue;
+    if (field.hidden) continue;
+    if (field.admin?.hidden) continue;
+    const isSidebar = sidebarFieldTypes.has(field.type) && field.type !== "relationship" && !field.hasMany;
+    if (isSidebar && sidebarFields.length < 5) {
+      sidebarFields.push(
+        displayField(field.name, {
+          span: 12,
+          display: field.type === "select" || field.type === "radio" ? "badge" : void 0
+        })
+      );
+    } else {
+      const span = field.type === "richText" || field.type === "blocks" || field.type === "textarea" || field.type === "array" || field.type === "json" || field.type === "object" ? 12 : 6;
+      mainFields.push(
+        displayField(field.name, {
+          span
+        })
+      );
+    }
+  }
+  const sections = [];
+  const mainTitle = schema.labels?.singular || schema.label || "Details";
+  if (sidebarFields.length > 0) {
+    sections.push(
+      displaySection(mainTitle, mainFields, {
+        span: 8
+      })
+    );
+    sections.push(
+      displaySection("Overview", sidebarFields, {
+        span: 4
+      })
+    );
+  } else {
+    sections.push(
+      displaySection(mainTitle, mainFields, {
+        span: 12
+      })
+    );
+  }
+  return sections;
+}
+function isDetailItemVisible(item, doc, user) {
+  if (!item) return true;
+  const it = normalizeDetailItem(item);
+  const visible = it.options?.visible;
+  if (visible === void 0 || visible === null) return true;
+  if (typeof visible === "boolean") return visible;
+  if (typeof visible === "string") {
+    if (visible.trim().length === 0) return true;
+    try {
+      return Boolean(evaluateJexlSync(visible, { doc, user }));
+    } catch {
+      return true;
+    }
+  }
+  return true;
+}
+
 // src/index.ts
 function defineCollection(config) {
   return config;
@@ -3817,6 +4228,7 @@ function defineTab(args) {
   LIFECYCLE_EVENTS_COLLECTION,
   LIFECYCLE_EVENT_NAMES,
   WORKFLOW_HISTORY_COLLECTION,
+  abs,
   addDays,
   assertValidAdminConditionsInConfig,
   assertValidDeclarativeAccessInConfig,
@@ -3828,6 +4240,7 @@ function defineTab(args) {
   buildSqlOrderBy,
   canViewWorkflowDraft,
   capitalize,
+  ceil,
   clamp,
   coalesce,
   collectAdminConditionValidationIssues,
@@ -3836,6 +4249,7 @@ function defineTab(args) {
   collectDeclarativeHookValidationIssues,
   collectPreviewUrlValidationIssues,
   compact,
+  count,
   createLifecycleEvent,
   createWorkflowDocument,
   defaultValue,
@@ -3871,12 +4285,28 @@ function defineTab(args) {
   diffDays,
   dispatchLifecycleEvent,
   dispatchPendingLifecycleEvents,
+  displayComputed,
+  displayCustom,
+  displayCustomComponent,
+  displayDivider,
+  displayField,
+  displayGrid,
+  displayRepeat,
+  displaySection,
+  displayTab,
+  displayTabs,
+  displayText,
   endsWith,
+  evaluateDetailComputed,
+  evaluateJexl,
+  evaluateJexlSync,
   executeFieldAfterRead,
   executeFieldBeforeChange,
   first,
+  floor,
   formatConfigDiagnostics,
   formatDate,
+  generateDefaultDetailSchema,
   generateOpenApi,
   get,
   getAdminAuthCollection,
@@ -3884,6 +4314,7 @@ function defineTab(args) {
   includes,
   initializeWorkflowDocument,
   isConfigValidationError,
+  isDetailItemVisible,
   isEmpty,
   isFuture,
   isPast,
@@ -3892,12 +4323,16 @@ function defineTab(args) {
   length,
   lower,
   materializeWorkflowDocument,
+  max,
+  min,
   normalizeConfig,
+  normalizeDetailItem,
   now,
   numericFieldNames,
   parseMongoWhere,
   parseSort,
   parseSqlWhere,
+  pow,
   publishedStateName,
   publishingWorkflow,
   readingTime,
@@ -3909,7 +4344,9 @@ function defineTab(args) {
   saveWorkflowDraft,
   simplePublishingWorkflow,
   slugify,
+  sqrt,
   startsWith,
+  sum,
   today,
   transitionWorkflow,
   trim,