persian-data-grid 0.5.0 → 0.7.0

package/dist/chunk-7T6AWRPU.js

@@ -0,0 +1,581 @@
+import { DomainError } from './chunk-KHMG6EI2.js';
+import { ColumnId, RowId } from './chunk-XLRE2J25.js';
+
+// application/handlers/cellCommandsHandler.ts
+function logError(audit, error, context) {
+  if (error instanceof DomainError) {
+    audit.log({
+      type: error.code,
+      message: error.message,
+      payload: { details: error.details, context }
+    });
+  } else if (error instanceof Error) {
+    audit.log({
+      type: "INVARIANT_VIOLATION",
+      message: error.message,
+      payload: { stack: error.stack, context }
+    });
+  } else {
+    audit.log({
+      type: "INVARIANT_VIOLATION",
+      message: "Unexpected error",
+      payload: { error, context }
+    });
+  }
+}
+async function applyRemoteVisibilityRules(dynamic, input, audit) {
+  const {
+    table,
+    rowId,
+    changedColumnId,
+    newValue,
+    clearDependents = true
+  } = input;
+  const meta = dynamic?.columnMeta;
+  if (!meta) return true;
+  const colKey = `${table.getActiveCollectionName() ?? "default"}_${changedColumnId.value}`;
+  const changedMeta = meta.get(colKey) ?? meta.get(changedColumnId.value);
+  const resolveOn = changedMeta?.resolveOn;
+  if (!resolveOn) return true;
+  if (resolveOn.fieldName !== changedColumnId.value) return true;
+  const row = table.getRows().find((r) => r.id.value === rowId.value);
+  if (!row) return true;
+  const rowValues = {};
+  for (const [colId, cell] of row.getCells().entries()) {
+    rowValues[colId] = cell.getValue();
+  }
+  if (newValue == null || newValue === "") return true;
+  const params = typeof resolveOn.buildParams === "function" ? resolveOn.buildParams(rowValues) : { value: newValue };
+  let response;
+  let failed = false;
+  try {
+    response = await dynamic.remoteApi.request({
+      endpoint: resolveOn.endpoint,
+      params,
+      method: "POST"
+    });
+  } catch (error) {
+    failed = true;
+    if (audit) logError(audit, error, `resolveOn[${resolveOn.endpoint}]`);
+  }
+  if (!failed) resolveOn.getResponse?.(response, row);
+  const flags = failed ? {} : resolveOn.mapFlags?.(response) ?? {};
+  const toShow = [];
+  const visibilityCondition = {};
+  const activeCollection = table.getActiveCollectionName() ?? "default";
+  meta.forEach((colCfg) => {
+    if ((colCfg.fieldCollection ?? "default") !== activeCollection) return;
+    const v = colCfg.visibility;
+    if (!failed && v?.kind === "whenRemoteFlag" && v.sourceFieldName === changedColumnId.value) {
+      const colId = new ColumnId(colCfg.fieldName);
+      const schema = table.getColumnSchema(colId);
+      const flagValue = flags[v.flag] ?? false;
+      visibilityCondition[colCfg.fieldName] = flagValue;
+      if (flagValue && schema) {
+        toShow.push({ ...schema, hidden: false });
+      }
+    }
+    const dependency = colCfg.dynamicSource?.dependsOn;
+    if (clearDependents && dependency && dependency.includes(changedColumnId.value) && !Object.hasOwn(visibilityCondition, colCfg.fieldName) && colCfg.visibility?.kind !== "whenTableType" && colCfg.visibility?.kind !== "whenCollection") {
+      const cell = row.getCell(colCfg.fieldName);
+      cell?.changeValue(null);
+      cell?.changeDisplay(null);
+    }
+  });
+  if (toShow.length > 0) {
+    table.addColumns(toShow);
+  }
+  if (!failed) row.setVisibilityCondition(visibilityCondition);
+  return !failed;
+}
+var ChangeCellValueHandler = class {
+  constructor(repo, audit, permissionPolicy, dynamic) {
+    this.repo = repo;
+    this.audit = audit;
+    this.permissionPolicy = permissionPolicy;
+    this.dynamic = dynamic;
+  }
+  async execute(command, actor) {
+    const table = await this.repo.getById(command.store, command.tableKey);
+    try {
+      const rowId = new RowId(command.rowId);
+      const columnId = new ColumnId(command.columnId);
+      const schema = table.getColumnSchema(columnId);
+      if (!schema) {
+        throw new DomainError("COLUMN_NOT_FOUND", "Column does not exist", {
+          columnId: columnId.value
+        });
+      }
+      if (schema.editable === false) {
+        throw new DomainError("NOT_EDITABLE", "Cell is not editable", {
+          rowId: rowId.value,
+          columnId: columnId.value
+        });
+      }
+      if (!this.permissionPolicy.canChangeCell({
+        actor,
+        rowId: command.rowId,
+        columnId: command.columnId
+      })) {
+        throw new DomainError(
+          "FORBIDDEN",
+          "Actor is not allowed to change this cell",
+          { actor, rowId: rowId.value, columnId: columnId.value }
+        );
+      }
+      const validated = this.validateCellValue(schema.fieldType, command.newValue);
+      const domainEvent = table.changeCell(rowId, columnId, validated.value);
+      if (!domainEvent) {
+        throw new DomainError(
+          "CELL_NOT_FOUND",
+          "Cell not found or value not changed",
+          { rowId: rowId.value, columnId: columnId.value }
+        );
+      }
+      if (this.dynamic) {
+        await this.applyComputedColumns({
+          table,
+          rowId,
+          changedColumnId: columnId,
+          remoteApi: this.dynamic.remoteApi
+        });
+        await this.applyRemoteVisibilityRules({
+          table,
+          rowId,
+          changedColumnId: columnId,
+          newValue: command.newValue
+        });
+        this.applyDynamicProjection({
+          table,
+          rowId,
+          changedColumnId: columnId,
+          validatedValue: command.newValue
+        });
+      }
+      const state = table.getRows().find((r) => r.id.value === rowId.value)?.getCells().get("RowState")?.getValue();
+      if (state === "None" /* Unchanged */) {
+        table.changeCell(rowId, new ColumnId("RowState"), "Update" /* Modified */);
+        table.changeDisplay(rowId, new ColumnId("RowState"), "Update" /* Modified */);
+      }
+      await this.repo.save(command.store, table);
+      const out = {
+        type: "CELL_CHANGED",
+        tableId: command.tableKey,
+        rowId: domainEvent.rowId.value,
+        columnId: domainEvent.columnId.value,
+        newValue: domainEvent.newValue,
+        previousValue: domainEvent.previousValue
+      };
+      this.audit.log({ type: "CELL_CHANGED", message: out.type, payload: out });
+      return [out];
+    } catch (e) {
+      logError(this.audit, e, `ChangeCellValueHandler[${command.tableKey}:${command.rowId}:${command.columnId}]`);
+      return [];
+    }
+  }
+  /* ── helpers ─────────────────────────────────────────────────────── */
+  applyRemoteVisibilityRules(input) {
+    return applyRemoteVisibilityRules(this.dynamic, input, this.audit);
+  }
+  async applyComputedColumns(input) {
+    const { table, rowId, changedColumnId, remoteApi } = input;
+    const meta = this.dynamic.columnMeta;
+    const computedColumns = Array.from(meta.values()).filter(
+      (c) => c.computed != null
+    );
+    if (computedColumns.length === 0) return;
+    const row = table.getRows().find((r) => r.id.value === rowId.value);
+    if (!row) return;
+    const rowValues = {};
+    for (const [colId, cell] of row.getCells().entries()) {
+      rowValues[colId] = cell.getValue();
+    }
+    const dependents = /* @__PURE__ */ new Map();
+    for (const col of computedColumns) {
+      for (const dep of col.computed.dependsOn ?? []) {
+        if (!dependents.has(dep)) dependents.set(dep, []);
+        dependents.get(dep).push(col);
+      }
+    }
+    const queue = [changedColumnId.value];
+    const visited = /* @__PURE__ */ new Set();
+    let safetyCounter = 0;
+    const MAX = computedColumns.length + 1;
+    while (queue.length > 0) {
+      if (safetyCounter++ > MAX) {
+        throw new Error("Computed cycle detected");
+      }
+      const source = queue.shift();
+      const targets = dependents.get(source) ?? [];
+      for (const colCfg of targets) {
+        const targetField = colCfg.fieldName;
+        const targetColId = new ColumnId(targetField);
+        const schema = table.getColumnSchema(targetColId);
+        if (!schema || !colCfg.computed) continue;
+        let newValue;
+        try {
+          const rawValue = colCfg.computed.compute(rowValues, remoteApi);
+          newValue = rawValue instanceof Promise ? await rawValue : rawValue;
+        } catch (error) {
+          logError(this.audit, error, `computed[${targetField}]`);
+          continue;
+        }
+        const validated = this.validateCellValue(schema.fieldType, newValue);
+        if (validated.value instanceof Promise) {
+          throw new Error(
+            `Computed column "${targetField}" returned a Promise after validation`
+          );
+        }
+        const prev = rowValues[targetField];
+        if (Object.is(prev, validated.value)) continue;
+        table.changeCell(rowId, targetColId, validated.value);
+        if (schema.displayFormat) {
+          const validatedDisplay = this.validateCellValue(
+            schema.fieldType,
+            schema.displayFormat(newValue)
+          );
+          table.changeDisplay(rowId, targetColId, validatedDisplay.value);
+        } else {
+          table.changeDisplay(rowId, targetColId, validated.value);
+        }
+        rowValues[targetField] = validated.value;
+        queue.push(targetField);
+        visited.add(targetField);
+      }
+    }
+  }
+  validateCellValue(type, value) {
+    switch (type) {
+      case "text":
+      case "textArea":
+      case "description":
+      case "date":
+        return typeof value === "string" ? { ok: true, value } : { ok: false, error: { message: "Expected string", details: { value } }, value };
+      case "static":
+        return { ok: true, value };
+      case "checkbox":
+        return typeof value === "boolean" ? { ok: true, value } : { ok: false, error: { message: "Expected boolean", details: { value } }, value };
+      case "number":
+      case "price":
+      case "select":
+      case "selectOption": {
+        if (value === "" || value === void 0) {
+          return { ok: true, value };
+        }
+        const n = typeof value === "number" ? value : Number(value);
+        return Number.isFinite(n) ? { ok: true, value: n } : { ok: false, error: { message: "Expected number", details: { value } }, value };
+      }
+      default:
+        return { ok: false, error: { message: "Unsupported type", details: { type, value } }, value };
+    }
+  }
+  applyDynamicProjection(input) {
+    const { table, changedColumnId, validatedValue } = input;
+    const activeCollection = table.getActiveCollectionName() ?? "default";
+    this.dynamic.columnMeta.forEach((colMeta, key) => {
+      if ((colMeta.fieldCollection ?? "default") !== activeCollection) return;
+      const col = table.getColumnSchema(new ColumnId(colMeta.fieldName));
+      const depends = colMeta.dynamicSource?.dependsOn;
+      if (depends?.includes(changedColumnId.value)) {
+        const { dynamicSource } = colMeta;
+        const { endpoint, dependsOn, ...restDynamic } = dynamicSource ?? {};
+        const base = col ?? colMeta;
+        table.setColumnSchema(new ColumnId(base.fieldName), {
+          ...base,
+          dynamicSelectFilterOption: base.dynamicSelectFilterOption ?? (() => true),
+          dynamicSource: {
+            endpoint: endpoint ?? "",
+            ...restDynamic,
+            dependOn: {
+              fieldName: changedColumnId.value,
+              value: validatedValue
+            }
+          }
+        });
+      }
+      if (colMeta.visibility?.kind === "whenFieldTruthy" && colMeta.visibility.fieldName === changedColumnId.value && col) {
+        table.setColumnSchema(new ColumnId(colMeta.fieldName), col);
+      }
+    });
+  }
+};
+var ChangeCellDisplayValueHandler = class {
+  constructor(repo, audit, permissionPolicy) {
+    this.repo = repo;
+    this.audit = audit;
+    this.permissionPolicy = permissionPolicy;
+  }
+  async execute(command, actor) {
+    const table = await this.repo.getById(command.store, command.tableKey);
+    try {
+      const rowId = new RowId(command.rowId);
+      const columnId = new ColumnId(command.columnId);
+      const schema = table.getColumnSchema(columnId);
+      if (!schema) {
+        throw new DomainError("COLUMN_NOT_FOUND", "Column does not exist", {
+          columnId: columnId.value
+        });
+      }
+      if (schema.editable === false) {
+        throw new DomainError("NOT_EDITABLE", "Cell is not editable", {
+          rowId: rowId.value,
+          columnId: columnId.value
+        });
+      }
+      if (!this.permissionPolicy.canChangeCell({
+        actor,
+        rowId: command.rowId,
+        columnId: command.columnId
+      })) {
+        throw new DomainError(
+          "FORBIDDEN",
+          "Actor is not allowed to change this cell",
+          { actor, rowId: rowId.value, columnId: columnId.value }
+        );
+      }
+      const domainEvent = table.changeDisplay(rowId, columnId, command.newValue);
+      if (!domainEvent) {
+        throw new DomainError(
+          "CELL_NOT_FOUND",
+          "Cell not found or value not changed",
+          { rowId: rowId.value, columnId: columnId.value }
+        );
+      }
+      await this.repo.save(command.store, table);
+      const out = {
+        type: "CELL_DISPLAY_CHANGED",
+        tableId: command.tableKey,
+        rowId: domainEvent.rowId.value,
+        columnId: domainEvent.columnId.value,
+        newValue: domainEvent.newValue
+      };
+      this.audit.log({ type: "CELL_DISPLAY_CHANGED", message: out.type, payload: out });
+      return [out];
+    } catch (e) {
+      logError(this.audit, e, `ChangeCellDisplayValueHandler[${command.tableKey}:${command.rowId}:${command.columnId}]`);
+      return [];
+    }
+  }
+};
+var SaveDescriptionHandler = class {
+  constructor(repo, audit, permissionPolicy) {
+    this.repo = repo;
+    this.audit = audit;
+    this.permissionPolicy = permissionPolicy;
+  }
+  async execute(command, actor) {
+    const table = await this.repo.getById(command.store, command.tableKey);
+    try {
+      const rowId = new RowId(command.rowId);
+      const domainEvent = table.saveDescription(rowId, command.flag);
+      if (!domainEvent) {
+        throw new DomainError(
+          "CELL_NOT_FOUND",
+          "Cell not found or value not changed",
+          { rowId: rowId.value, flag: command.flag }
+        );
+      }
+      await this.repo.save(command.store, table);
+      const out = {
+        type: "ROW_DESCRIPTION_SAVED",
+        tableId: command.tableKey,
+        rowId: domainEvent.rowId.value,
+        description: command.flag
+      };
+      this.audit.log({ type: "INFORMATION", message: out.type, payload: out });
+      return [out];
+    } catch (e) {
+      logError(this.audit, e, `SaveDescriptionHandler[${command.tableKey}:${command.rowId}]`);
+      return [];
+    }
+  }
+};
+var ApplyDynamicProjectionHandler = class {
+  constructor(repo, audit, permissionPolicy, dynamic) {
+    this.repo = repo;
+    this.audit = audit;
+    this.permissionPolicy = permissionPolicy;
+    this.dynamic = dynamic;
+  }
+  async execute(command, actor) {
+    const { store, tableKey, rowId, columnId } = command;
+    const table = await this.repo.getById(store, tableKey);
+    try {
+      const row = table.getRow(rowId);
+      if (!row) {
+        throw new DomainError("ROW_NOT_FOUND", `Row ${rowId} not found`, { rowId });
+      }
+      const cell = row.getCell(columnId);
+      if (!cell) {
+        throw new DomainError("CELL_NOT_FOUND", `Cell ${columnId} not found`, { columnId });
+      }
+      const colValue = cell.getValue();
+      const previousValue = colValue;
+      const newRowId = new RowId(rowId);
+      const newColumnId = new ColumnId(columnId);
+      if (this.dynamic) {
+        await this.applyComputedColumns({
+          table,
+          rowId: newRowId,
+          changedColumnId: newColumnId,
+          remoteApi: this.dynamic.remoteApi
+        });
+        await this.applyRemoteVisibilityRules({
+          table,
+          rowId: newRowId,
+          changedColumnId: newColumnId,
+          newValue: colValue,
+          clearDependents: false
+        });
+        this.applyDynamicProjection({
+          table,
+          rowId: newRowId,
+          changedColumnId: newColumnId,
+          validatedValue: colValue
+        });
+      }
+      const state = table.getRows().find((r) => r.id.value === newRowId.value)?.getCells().get("RowState")?.getValue();
+      if (state === "None" /* Unchanged */) {
+        table.changeCell(newRowId, new ColumnId("RowState"), "Update" /* Modified */);
+        table.changeDisplay(newRowId, new ColumnId("RowState"), "Update" /* Modified */);
+      }
+      await this.repo.save(store, table);
+      const out = {
+        type: "CELL_CHANGED",
+        tableId: tableKey,
+        rowId: newRowId.value,
+        columnId: newColumnId.value,
+        newValue: colValue,
+        previousValue
+      };
+      this.audit.log({ type: "CELL_CHANGED", message: out.type, payload: out });
+      return [out];
+    } catch (e) {
+      logError(this.audit, e, `ApplyDynamicProjectionHandler[${tableKey}:${rowId}:${columnId}]`);
+      return [];
+    }
+  }
+  /* ── helpers (identical to ChangeCellValueHandler) ───────────────── */
+  applyRemoteVisibilityRules(input) {
+    return applyRemoteVisibilityRules(this.dynamic, input, this.audit);
+  }
+  async applyComputedColumns(input) {
+    const { table, rowId, changedColumnId, remoteApi } = input;
+    const meta = this.dynamic.columnMeta;
+    const computedColumns = Array.from(meta.values()).filter(
+      (c) => c.computed != null
+    );
+    if (computedColumns.length === 0) return;
+    const row = table.getRows().find((r) => r.id.value === rowId.value);
+    if (!row) return;
+    const rowValues = {};
+    for (const [colId, cell] of row.getCells().entries()) {
+      rowValues[colId] = cell.getValue();
+    }
+    const dependents = /* @__PURE__ */ new Map();
+    for (const col of computedColumns) {
+      for (const dep of col.computed.dependsOn ?? []) {
+        if (!dependents.has(dep)) dependents.set(dep, []);
+        dependents.get(dep).push(col);
+      }
+    }
+    const queue = [changedColumnId.value];
+    const visited = /* @__PURE__ */ new Set();
+    let safetyCounter = 0;
+    const MAX = computedColumns.length + 1;
+    while (queue.length > 0) {
+      if (safetyCounter++ > MAX) throw new Error("Computed cycle detected");
+      const source = queue.shift();
+      const targets = dependents.get(source) ?? [];
+      for (const colCfg of targets) {
+        const targetField = colCfg.fieldName;
+        const targetColId = new ColumnId(targetField);
+        const schema = table.getColumnSchema(targetColId);
+        if (!schema || !colCfg.computed) continue;
+        let newValue;
+        try {
+          const rawValue = colCfg.computed.compute(rowValues, remoteApi);
+          newValue = rawValue instanceof Promise ? await rawValue : rawValue;
+        } catch (error) {
+          logError(this.audit, error, `computed[${targetField}]`);
+          continue;
+        }
+        const validated = this.validateCellValue(schema.fieldType, newValue);
+        if (validated.value instanceof Promise) {
+          throw new Error(`Computed column "${targetField}" returned a Promise after validation`);
+        }
+        const prev = rowValues[targetField];
+        if (Object.is(prev, validated.value)) continue;
+        table.changeCell(rowId, targetColId, validated.value);
+        if (schema.displayFormat) {
+          const validatedDisplay = this.validateCellValue(
+            schema.fieldType,
+            schema.displayFormat(newValue)
+          );
+          table.changeDisplay(rowId, targetColId, validatedDisplay.value);
+        } else {
+          table.changeDisplay(rowId, targetColId, validated.value);
+        }
+        rowValues[targetField] = validated.value;
+        queue.push(targetField);
+        visited.add(targetField);
+      }
+    }
+  }
+  validateCellValue(type, value) {
+    switch (type) {
+      case "text":
+      case "textArea":
+      case "description":
+      case "date":
+        return typeof value === "string" ? { ok: true, value } : { ok: false, error: { message: "Expected string", details: { value } }, value };
+      case "static":
+        return { ok: true, value };
+      case "checkbox":
+        return typeof value === "boolean" ? { ok: true, value } : { ok: false, error: { message: "Expected boolean", details: { value } }, value };
+      case "number":
+      case "price":
+      case "select":
+      case "selectOption": {
+        if (value === "" || value === void 0) return { ok: true, value };
+        const n = typeof value === "number" ? value : Number(value);
+        return Number.isFinite(n) ? { ok: true, value: n } : { ok: false, error: { message: "Expected number", details: { value } }, value };
+      }
+      default:
+        return { ok: false, error: { message: "Unsupported type", details: { type, value } }, value };
+    }
+  }
+  applyDynamicProjection(input) {
+    const { table, changedColumnId, validatedValue } = input;
+    const activeCollection = table.getActiveCollectionName() ?? "default";
+    this.dynamic.columnMeta.forEach((colMeta, key) => {
+      if ((colMeta.fieldCollection ?? "default") !== activeCollection) return;
+      const col = table.getColumnSchema(new ColumnId(colMeta.fieldName));
+      const depends = colMeta.dynamicSource?.dependsOn;
+      if (depends?.includes(changedColumnId.value)) {
+        const { dynamicSource } = colMeta;
+        const { endpoint, dependsOn, ...restDynamic } = dynamicSource ?? {};
+        const base = col ?? colMeta;
+        table.setColumnSchema(new ColumnId(base.fieldName), {
+          ...base,
+          dynamicSelectFilterOption: base.dynamicSelectFilterOption ?? (() => true),
+          dynamicSource: {
+            endpoint: endpoint ?? "",
+            ...restDynamic,
+            dependOn: {
+              fieldName: changedColumnId.value,
+              value: validatedValue
+            }
+          }
+        });
+      }
+      if (colMeta.visibility?.kind === "whenFieldTruthy" && colMeta.visibility.fieldName === changedColumnId.value && col) {
+        table.setColumnSchema(new ColumnId(colMeta.fieldName), col);
+      }
+    });
+  }
+};
+
+export { ApplyDynamicProjectionHandler, ChangeCellDisplayValueHandler, ChangeCellValueHandler, SaveDescriptionHandler, applyRemoteVisibilityRules, logError };
+//# sourceMappingURL=chunk-7T6AWRPU.js.map
+//# sourceMappingURL=chunk-7T6AWRPU.js.map