ocean-brain 0.5.0 → 0.6.1

package/server/dist/features/note/services/properties.js

@@ -0,0 +1,874 @@
+import models, { Prisma } from "../../../models.js";
+import { buildNoteSearchProjection } from "./search.js";
+import { captureNoteBaseline } from "./snapshot.js";
+import { createNoteVersionConflictError, MissingNoteVersionError, parseNoteVersion } from "./write-conflict.js";
+const PROPERTY_KEY_MAX_LENGTH = 80;
+const PROPERTY_NAME_MAX_LENGTH = 120;
+const PROPERTY_TEXT_VALUE_MAX_LENGTH = 2e3;
+const PROPERTY_OPTION_LABEL_MAX_LENGTH = 80;
+const PROPERTY_OPTION_VALUE_MAX_LENGTH = 80;
+const PROPERTY_OPTION_LIMIT = 50;
+const PROPERTY_PATCH_SET_LIMIT = 50;
+const PROPERTY_PATCH_DELETE_LIMIT = 50;
+class InvalidNotePropertyInputError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InvalidNotePropertyInputError";
+  }
+}
+class NotePropertyDeleteConfirmationRequiredError extends Error {
+  code = "NOTE_PROPERTY_DELETE_CONFIRMATION_REQUIRED";
+  affectedNoteCount;
+  constructor(key, affectedNoteCount) {
+    super(`Property ${key} is used by ${affectedNoteCount} note(s). Confirm deletion to remove those values.`);
+    this.name = "NotePropertyDeleteConfirmationRequiredError";
+    this.affectedNoteCount = affectedNoteCount;
+  }
+}
+const isRecordNotFoundError = (error) => {
+  return error instanceof Prisma.PrismaClientKnownRequestError && error.code === "P2025";
+};
+const normalizePropertyKey = (value) => {
+  const normalized = value.trim().toLowerCase().replace(/\s+/g, "-");
+  if (!normalized) {
+    throw new InvalidNotePropertyInputError("Property key is required.");
+  }
+  if (normalized.length > PROPERTY_KEY_MAX_LENGTH) {
+    throw new InvalidNotePropertyInputError(`Property key must be ${PROPERTY_KEY_MAX_LENGTH} characters or fewer.`);
+  }
+  if (!/^[a-z0-9][a-z0-9_-]*$/.test(normalized)) {
+    throw new InvalidNotePropertyInputError("Property key must use letters, numbers, dashes, or underscores.");
+  }
+  return normalized;
+};
+const normalizePropertyName = (value, key) => {
+  const normalized = value?.trim() || key;
+  if (normalized.length > PROPERTY_NAME_MAX_LENGTH) {
+    throw new InvalidNotePropertyInputError(
+      `Property name must be ${PROPERTY_NAME_MAX_LENGTH} characters or fewer.`
+    );
+  }
+  return normalized;
+};
+const normalizeOptionValue = (value) => {
+  const normalized = value.trim().toLowerCase().replace(/\s+/g, "-");
+  if (!normalized) {
+    throw new InvalidNotePropertyInputError("Property option value is required.");
+  }
+  if (normalized.length > PROPERTY_OPTION_VALUE_MAX_LENGTH) {
+    throw new InvalidNotePropertyInputError(
+      `Property option value must be ${PROPERTY_OPTION_VALUE_MAX_LENGTH} characters or fewer.`
+    );
+  }
+  if (!/^[a-z0-9][a-z0-9_-]*$/.test(normalized)) {
+    throw new InvalidNotePropertyInputError(
+      "Property option value must use letters, numbers, dashes, or underscores."
+    );
+  }
+  return normalized;
+};
+const normalizeOptionLabel = (value) => {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new InvalidNotePropertyInputError("Property option label is required.");
+  }
+  if (normalized.length > PROPERTY_OPTION_LABEL_MAX_LENGTH) {
+    throw new InvalidNotePropertyInputError(
+      `Property option label must be ${PROPERTY_OPTION_LABEL_MAX_LENGTH} characters or fewer.`
+    );
+  }
+  return normalized;
+};
+const normalizePropertyOptions = (options) => {
+  const normalizedOptions = options ?? [];
+  if (normalizedOptions.length > PROPERTY_OPTION_LIMIT) {
+    throw new InvalidNotePropertyInputError(`Select properties can have up to ${PROPERTY_OPTION_LIMIT} options.`);
+  }
+  const seenValues = /* @__PURE__ */ new Set();
+  return normalizedOptions.map((option, index) => {
+    const label = normalizeOptionLabel(option.label);
+    const value = normalizeOptionValue(option.value ?? label);
+    if (seenValues.has(value)) {
+      throw new InvalidNotePropertyInputError("Property options contain duplicate values.");
+    }
+    seenValues.add(value);
+    return {
+      label,
+      value,
+      color: option.color?.trim() || null,
+      order: Number.isFinite(Number(option.order)) ? Number(option.order) : index
+    };
+  });
+};
+const normalizePropertyOptionUpdates = (options, existingOptions) => {
+  const normalizedOptions = options ?? [];
+  if (normalizedOptions.length > PROPERTY_OPTION_LIMIT) {
+    throw new InvalidNotePropertyInputError(`Select properties can have up to ${PROPERTY_OPTION_LIMIT} options.`);
+  }
+  const existingOptionById = new Map(existingOptions.map((option) => [String(option.id), option]));
+  const seenValues = /* @__PURE__ */ new Set();
+  return normalizedOptions.map((option, index) => {
+    const label = normalizeOptionLabel(option.label);
+    const existingOption = option.id === void 0 || option.id === null ? null : existingOptionById.get(String(option.id));
+    if (option.id !== void 0 && option.id !== null && !existingOption) {
+      throw new InvalidNotePropertyInputError("Property option does not belong to this property.");
+    }
+    const value = normalizeOptionValue(option.value ?? existingOption?.value ?? label);
+    if (existingOption && value !== existingOption.value) {
+      throw new InvalidNotePropertyInputError(
+        `Property option ${existingOption.value} value cannot be changed. Create a new option instead.`
+      );
+    }
+    if (seenValues.has(value)) {
+      throw new InvalidNotePropertyInputError("Property options contain duplicate values.");
+    }
+    seenValues.add(value);
+    return {
+      id: existingOption?.id,
+      label,
+      value,
+      color: option.color?.trim() || null,
+      order: Number.isFinite(Number(option.order)) ? Number(option.order) : index
+    };
+  });
+};
+const normalizeTextValue = (value) => {
+  if (value.length > PROPERTY_TEXT_VALUE_MAX_LENGTH) {
+    throw new InvalidNotePropertyInputError(
+      `Property text value must be ${PROPERTY_TEXT_VALUE_MAX_LENGTH} characters or fewer.`
+    );
+  }
+  return value;
+};
+const normalizeUrlValue = (value) => {
+  const trimmedValue = normalizeTextValue(value.trim());
+  if (!trimmedValue) {
+    throw new InvalidNotePropertyInputError("URL property value is required.");
+  }
+  let url;
+  try {
+    url = new URL(trimmedValue);
+  } catch {
+    throw new InvalidNotePropertyInputError("URL property values must be valid http(s) URLs.");
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new InvalidNotePropertyInputError("URL property values must use http or https.");
+  }
+  return url.toString();
+};
+const normalizeDateValue = (value) => {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+    throw new InvalidNotePropertyInputError("Date property values must use YYYY-MM-DD.");
+  }
+  const date = /* @__PURE__ */ new Date(`${value}T00:00:00.000Z`);
+  if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== value) {
+    throw new InvalidNotePropertyInputError("Date property value is invalid.");
+  }
+  return date;
+};
+const normalizeBooleanValue = (value) => {
+  if (value === "true") {
+    return true;
+  }
+  if (value === "false") {
+    return false;
+  }
+  throw new InvalidNotePropertyInputError("Boolean property values must be true or false.");
+};
+const normalizeNumberValue = (value) => {
+  const numberValue = Number(value);
+  if (!Number.isFinite(numberValue)) {
+    throw new InvalidNotePropertyInputError("Number property value must be finite.");
+  }
+  return numberValue;
+};
+const serializeOption = (option) => ({
+  id: String(option.id),
+  label: option.label,
+  value: option.value,
+  color: option.color,
+  order: option.order
+});
+const serializeDefinitionOption = (option) => ({
+  id: String(option.id),
+  label: option.label,
+  value: option.value,
+  color: option.color,
+  order: option.order
+});
+const serializePropertyValue = (property) => {
+  switch (property.definition.valueType) {
+    case "number":
+      return property.numberValue === null ? "" : String(property.numberValue);
+    case "date":
+      return property.dateValue ? property.dateValue.toISOString().slice(0, 10) : "";
+    case "boolean":
+      return property.boolValue === null ? "" : String(property.boolValue);
+    case "select":
+      return property.option?.value ?? "";
+    case "url":
+    case "text":
+    default:
+      return property.textValue ?? "";
+  }
+};
+const serializeNoteProperty = (property) => ({
+  key: property.definition.key,
+  name: property.definition.name,
+  value: serializePropertyValue(property),
+  valueType: property.definition.valueType,
+  option: property.option ? serializeOption(property.option) : null,
+  createdAt: property.createdAt.toISOString(),
+  updatedAt: property.updatedAt.toISOString()
+});
+const serializeNoteProperties = (properties) => {
+  return properties.map(serializeNoteProperty).sort((left, right) => left.key.localeCompare(right.key));
+};
+const serializePropertyDefinition = (definition) => ({
+  key: definition.key,
+  name: definition.name,
+  valueType: definition.valueType,
+  noteCount: definition._count.properties,
+  options: definition.options.sort((left, right) => left.order - right.order).map(serializeDefinitionOption),
+  updatedAt: definition.updatedAt.toISOString()
+});
+const assertPropertyOptionUpdateKeepsUsedValues = ({
+  existingOptions,
+  nextOptions
+}) => {
+  const nextValues = new Set(nextOptions.map((option) => option.value));
+  const removedUsedOption = existingOptions.find(
+    (option) => option._count.properties > 0 && !nextValues.has(option.value)
+  );
+  if (removedUsedOption) {
+    throw new InvalidNotePropertyInputError(
+      `Property option ${removedUsedOption.value} is used by notes and cannot be removed.`
+    );
+  }
+};
+const isRecord = (value) => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+const parseViewQueryRecord = (value) => {
+  if (!value) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(value);
+    return isRecord(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+};
+const getNormalizedViewFilterKey = (filter) => {
+  if (typeof filter.key !== "string") {
+    return null;
+  }
+  try {
+    return normalizePropertyKey(filter.key);
+  } catch {
+    return null;
+  }
+};
+const renamePropertyFiltersInViewQuery = ({
+  query,
+  key,
+  name
+}) => {
+  const parsed = parseViewQueryRecord(query);
+  if (!parsed || !Array.isArray(parsed.propertyFilters)) {
+    return null;
+  }
+  let changed = false;
+  const propertyFilters = parsed.propertyFilters.map((filter) => {
+    if (!isRecord(filter) || getNormalizedViewFilterKey(filter) !== key) {
+      return filter;
+    }
+    changed = true;
+    return {
+      ...filter,
+      key,
+      name
+    };
+  });
+  if (!changed) {
+    return null;
+  }
+  return JSON.stringify({
+    ...parsed,
+    propertyFilters
+  });
+};
+const normalizeReferencedOptionValue = (value) => {
+  return typeof value === "string" ? normalizeOptionValue(value) : null;
+};
+const findReferencedRemovedPropertyOptionValue = ({
+  query,
+  key,
+  removedValues
+}) => {
+  const parsed = parseViewQueryRecord(query);
+  if (!parsed || !Array.isArray(parsed.propertyFilters)) {
+    return null;
+  }
+  for (const filter of parsed.propertyFilters) {
+    if (!isRecord(filter) || getNormalizedViewFilterKey(filter) !== key) {
+      continue;
+    }
+    if (filter.valueType !== "select" || filter.operator === "exists" || filter.operator === "notExists") {
+      continue;
+    }
+    try {
+      const optionValue = normalizeReferencedOptionValue(filter.value);
+      if (optionValue && removedValues.has(optionValue)) {
+        return optionValue;
+      }
+    } catch {
+      continue;
+    }
+  }
+  return null;
+};
+const buildTypedValueData = async (input, definitionId, tx = models) => {
+  const resetValues = {
+    textValue: null,
+    textValueNormalized: null,
+    numberValue: null,
+    dateValue: null,
+    boolValue: null,
+    optionId: null
+  };
+  switch (input.valueType) {
+    case "number": {
+      const numberValue = normalizeNumberValue(input.value);
+      return { ...resetValues, numberValue };
+    }
+    case "date": {
+      const dateValue = normalizeDateValue(input.value);
+      return { ...resetValues, dateValue };
+    }
+    case "boolean": {
+      const boolValue = normalizeBooleanValue(input.value);
+      return { ...resetValues, boolValue };
+    }
+    case "select": {
+      const optionValue = normalizeOptionValue(input.value);
+      const option = await tx.propertyOption.findUnique({
+        where: {
+          propertyDefinitionId_value: {
+            propertyDefinitionId: definitionId,
+            value: optionValue
+          }
+        }
+      });
+      if (!option) {
+        throw new InvalidNotePropertyInputError(`Property option ${optionValue} is not defined.`);
+      }
+      return { ...resetValues, optionId: option.id };
+    }
+    case "url": {
+      const urlValue = normalizeUrlValue(input.value);
+      return { ...resetValues, textValue: urlValue, textValueNormalized: urlValue.toLowerCase() };
+    }
+    case "text": {
+      const textValue = normalizeTextValue(input.value);
+      return { ...resetValues, textValue, textValueNormalized: textValue.toLowerCase() };
+    }
+    default:
+      throw new InvalidNotePropertyInputError("Unsupported property value type.");
+  }
+};
+const normalizePatch = (patch) => {
+  const set = patch.set ?? [];
+  const deleteKeys = patch.deleteKeys ?? [];
+  if (set.length === 0 && deleteKeys.length === 0) {
+    throw new InvalidNotePropertyInputError("At least one property change is required.");
+  }
+  if (set.length > PROPERTY_PATCH_SET_LIMIT || deleteKeys.length > PROPERTY_PATCH_DELETE_LIMIT) {
+    throw new InvalidNotePropertyInputError("Too many property changes in one request.");
+  }
+  const normalizedSet = set.map((item) => {
+    const key = normalizePropertyKey(item.key);
+    return {
+      ...item,
+      key,
+      name: normalizePropertyName(item.name, key)
+    };
+  });
+  const normalizedDeleteKeys = deleteKeys.map(normalizePropertyKey);
+  const seenSetKeys = /* @__PURE__ */ new Set();
+  const seenDeleteKeys = /* @__PURE__ */ new Set();
+  for (const item of normalizedSet) {
+    if (seenSetKeys.has(item.key)) {
+      throw new InvalidNotePropertyInputError("Property patch contains duplicate keys.");
+    }
+    seenSetKeys.add(item.key);
+  }
+  for (const key of normalizedDeleteKeys) {
+    if (seenDeleteKeys.has(key)) {
+      throw new InvalidNotePropertyInputError("Property patch contains duplicate delete keys.");
+    }
+    if (seenSetKeys.has(key)) {
+      throw new InvalidNotePropertyInputError("Property patch cannot set and delete the same key.");
+    }
+    seenDeleteKeys.add(key);
+  }
+  return { set: normalizedSet, deleteKeys: normalizedDeleteKeys };
+};
+const normalizePatchByKey = (patch) => {
+  const set = patch.set ?? [];
+  const deleteKeys = patch.deleteKeys ?? [];
+  if (set.length === 0 && deleteKeys.length === 0) {
+    throw new InvalidNotePropertyInputError("At least one property change is required.");
+  }
+  if (set.length > PROPERTY_PATCH_SET_LIMIT || deleteKeys.length > PROPERTY_PATCH_DELETE_LIMIT) {
+    throw new InvalidNotePropertyInputError("Too many property changes in one request.");
+  }
+  const normalizedSet = set.map((item) => ({
+    key: normalizePropertyKey(item.key),
+    value: item.value
+  }));
+  const normalizedDeleteKeys = deleteKeys.map(normalizePropertyKey);
+  const seenSetKeys = /* @__PURE__ */ new Set();
+  const seenDeleteKeys = /* @__PURE__ */ new Set();
+  for (const item of normalizedSet) {
+    if (seenSetKeys.has(item.key)) {
+      throw new InvalidNotePropertyInputError("Property patch contains duplicate keys.");
+    }
+    seenSetKeys.add(item.key);
+  }
+  for (const key of normalizedDeleteKeys) {
+    if (seenDeleteKeys.has(key)) {
+      throw new InvalidNotePropertyInputError("Property patch contains duplicate delete keys.");
+    }
+    if (seenSetKeys.has(key)) {
+      throw new InvalidNotePropertyInputError("Property patch cannot set and delete the same key.");
+    }
+    seenDeleteKeys.add(key);
+  }
+  return { set: normalizedSet, deleteKeys: normalizedDeleteKeys };
+};
+const resolveNotePropertiesPatchValueTypes = async (patch, tx = models) => {
+  const normalizedPatch = normalizePatchByKey(patch);
+  if (normalizedPatch.set.length === 0) {
+    return normalizePatch({ deleteKeys: normalizedPatch.deleteKeys });
+  }
+  const definitions = await tx.propertyDefinition.findMany({
+    where: { key: { in: normalizedPatch.set.map((item) => item.key) } },
+    select: {
+      key: true,
+      name: true,
+      valueType: true
+    }
+  });
+  const definitionByKey = new Map(definitions.map((definition) => [definition.key, definition]));
+  return normalizePatch({
+    set: normalizedPatch.set.map((item) => {
+      const definition = definitionByKey.get(item.key);
+      if (!definition) {
+        throw new InvalidNotePropertyInputError(
+          `Property ${item.key} is not defined. Create it in property settings first.`
+        );
+      }
+      return {
+        key: item.key,
+        name: definition.name,
+        value: item.value,
+        valueType: definition.valueType
+      };
+    }),
+    deleteKeys: normalizedPatch.deleteKeys
+  });
+};
+const validateNotePropertiesPatchValues = async (patch, tx = models) => {
+  const normalizedPatch = normalizePatch(patch);
+  for (const item of normalizedPatch.set) {
+    const definition = await tx.propertyDefinition.findUnique({ where: { key: item.key } });
+    if (!definition) {
+      throw new InvalidNotePropertyInputError(
+        `Property ${item.key} is not defined. Create it in property settings first.`
+      );
+    }
+    if (definition.valueType !== item.valueType) {
+      throw new InvalidNotePropertyInputError(
+        `Property ${item.key} already uses ${definition.valueType} values.`
+      );
+    }
+    await buildTypedValueData(item, definition.id, tx);
+  }
+  return normalizedPatch;
+};
+const listNoteProperties = async (noteId) => {
+  const properties = await models.noteProperty.findMany({
+    where: { noteId },
+    include: { definition: true, option: true },
+    orderBy: [{ definition: { key: "asc" } }]
+  });
+  return serializeNoteProperties(properties);
+};
+const listNotePropertyKeys = async (input) => {
+  const normalizedQuery = input?.query?.trim();
+  const where = normalizedQuery ? {
+    OR: [{ key: { contains: normalizedQuery } }, { name: { contains: normalizedQuery } }]
+  } : void 0;
+  const take = Math.max(1, Math.min(100, Number(input?.limit ?? 50)));
+  const skip = Math.max(0, Number(input?.offset ?? 0));
+  const [definitions, totalCount] = await Promise.all([
+    models.propertyDefinition.findMany({
+      where,
+      orderBy: { key: "asc" },
+      take,
+      skip,
+      include: { options: { orderBy: { order: "asc" } }, _count: { select: { properties: true } } }
+    }),
+    models.propertyDefinition.count({ where })
+  ]);
+  return {
+    totalCount,
+    keys: definitions.map(serializePropertyDefinition)
+  };
+};
+const createNotePropertyDefinition = async (input) => {
+  const key = normalizePropertyKey(input.key);
+  const name = normalizePropertyName(input.name, key);
+  const options = normalizePropertyOptions(input.options);
+  if (input.valueType !== "select" && options.length > 0) {
+    throw new InvalidNotePropertyInputError("Only select properties can have options.");
+  }
+  if (input.valueType === "select" && options.length === 0) {
+    throw new InvalidNotePropertyInputError("Select properties require at least one option.");
+  }
+  try {
+    const definition = await models.propertyDefinition.create({
+      data: {
+        key,
+        name,
+        valueType: input.valueType,
+        ...input.valueType === "select" ? {
+          options: {
+            create: options
+          }
+        } : {}
+      },
+      include: { options: { orderBy: { order: "asc" } }, _count: { select: { properties: true } } }
+    });
+    return serializePropertyDefinition(definition);
+  } catch (error) {
+    if (error instanceof Prisma.PrismaClientKnownRequestError && error.code === "P2002") {
+      throw new InvalidNotePropertyInputError(`Property ${key} already exists.`);
+    }
+    throw error;
+  }
+};
+const updateNotePropertyDefinition = async ({
+  key,
+  input
+}) => {
+  const normalizedKey = normalizePropertyKey(key);
+  return models.$transaction(async (tx) => {
+    const definition = await tx.propertyDefinition.findUnique({
+      where: { key: normalizedKey },
+      include: {
+        options: {
+          orderBy: { order: "asc" },
+          include: { _count: { select: { properties: true } } }
+        },
+        _count: { select: { properties: true } }
+      }
+    });
+    if (!definition) {
+      return null;
+    }
+    const nextName = input.name !== void 0 ? normalizePropertyName(input.name, definition.key) : definition.name;
+    const shouldUpdateOptions = input.options !== void 0;
+    let nextOptions = null;
+    if (shouldUpdateOptions) {
+      nextOptions = normalizePropertyOptionUpdates(input.options, definition.options);
+      if (definition.valueType !== "select" && nextOptions.length > 0) {
+        throw new InvalidNotePropertyInputError("Only select properties can have options.");
+      }
+      if (definition.valueType === "select" && nextOptions.length === 0) {
+        throw new InvalidNotePropertyInputError("Select properties require at least one option.");
+      }
+      assertPropertyOptionUpdateKeepsUsedValues({
+        existingOptions: definition.options,
+        nextOptions
+      });
+      const nextValues = new Set(nextOptions.map((option) => option.value));
+      const removedValues = new Set(
+        definition.options.filter((option) => !nextValues.has(option.value)).map((option) => option.value)
+      );
+      if (removedValues.size > 0) {
+        const referencingViewSections = await tx.viewSection.findMany({
+          where: { query: { contains: definition.key } },
+          select: { title: true, query: true }
+        });
+        for (const section of referencingViewSections) {
+          const removedReferencedValue = findReferencedRemovedPropertyOptionValue({
+            query: section.query,
+            key: definition.key,
+            removedValues
+          });
+          if (removedReferencedValue) {
+            throw new InvalidNotePropertyInputError(
+              `Property option ${removedReferencedValue} is used by view ${section.title} and cannot be removed.`
+            );
+          }
+        }
+      }
+    }
+    await tx.propertyDefinition.update({
+      where: { id: definition.id },
+      data: { name: nextName }
+    });
+    if (nextName !== definition.name) {
+      const referencingViewSections = await tx.viewSection.findMany({
+        where: { query: { contains: definition.key } },
+        select: { id: true, query: true }
+      });
+      for (const section of referencingViewSections) {
+        const nextQuery = renamePropertyFiltersInViewQuery({
+          query: section.query,
+          key: definition.key,
+          name: nextName
+        });
+        if (nextQuery) {
+          await tx.viewSection.update({
+            where: { id: section.id },
+            data: { query: nextQuery }
+          });
+        }
+      }
+    }
+    if (nextOptions) {
+      const existingOptionByValue = new Map(definition.options.map((option) => [option.value, option]));
+      const nextValues = new Set(nextOptions.map((option) => option.value));
+      const removableOptionIds = definition.options.filter((option) => !nextValues.has(option.value) && option._count.properties === 0).map((option) => option.id);
+      if (removableOptionIds.length > 0) {
+        await tx.propertyOption.deleteMany({
+          where: {
+            id: { in: removableOptionIds }
+          }
+        });
+      }
+      for (const option of nextOptions) {
+        const existingOption = existingOptionByValue.get(option.value);
+        if (existingOption) {
+          await tx.propertyOption.update({
+            where: { id: existingOption.id },
+            data: {
+              label: option.label,
+              color: option.color,
+              order: option.order
+            }
+          });
+          continue;
+        }
+        await tx.propertyOption.create({
+          data: {
+            propertyDefinitionId: definition.id,
+            label: option.label,
+            value: option.value,
+            color: option.color,
+            order: option.order
+          }
+        });
+      }
+    }
+    const updatedDefinition = await tx.propertyDefinition.findUniqueOrThrow({
+      where: { id: definition.id },
+      include: { options: { orderBy: { order: "asc" } }, _count: { select: { properties: true } } }
+    });
+    return serializePropertyDefinition(updatedDefinition);
+  });
+};
+const deleteNotePropertyDefinition = async ({
+  key,
+  confirmImpact = false
+}) => {
+  const normalizedKey = normalizePropertyKey(key);
+  return models.$transaction(async (tx) => {
+    const definition = await tx.propertyDefinition.findUnique({
+      where: { key: normalizedKey },
+      include: { _count: { select: { properties: true } } }
+    });
+    if (!definition) {
+      return null;
+    }
+    const affectedNoteCount = definition._count.properties;
+    if (affectedNoteCount > 0 && !confirmImpact) {
+      throw new NotePropertyDeleteConfirmationRequiredError(normalizedKey, affectedNoteCount);
+    }
+    if (affectedNoteCount > 0) {
+      await tx.note.updateMany({
+        where: {
+          properties: {
+            some: {
+              propertyDefinitionId: definition.id
+            }
+          }
+        },
+        data: {
+          updatedAt: /* @__PURE__ */ new Date()
+        }
+      });
+    }
+    await tx.propertyDefinition.delete({
+      where: { id: definition.id }
+    });
+    return {
+      key: definition.key,
+      name: definition.name,
+      valueType: definition.valueType,
+      affectedNoteCount,
+      deleted: true
+    };
+  });
+};
+const updateNotePropertiesWithVersionGuardAndSnapshot = async ({
+  id,
+  patch,
+  editSessionId,
+  expectedUpdatedAt,
+  force = false,
+  noteData,
+  snapshotMeta
+}) => {
+  const normalizedPatch = normalizePatch(patch);
+  const expectedTimestamp = parseNoteVersion(expectedUpdatedAt);
+  if (expectedTimestamp === null && !force) {
+    throw new MissingNoteVersionError();
+  }
+  try {
+    const result = await models.$transaction(async (tx) => {
+      const existingNote = await tx.note.findUnique({
+        where: { id },
+        include: { properties: { include: { definition: true, option: true } } }
+      });
+      if (!existingNote) {
+        return null;
+      }
+      if (!force && existingNote.updatedAt.getTime() !== expectedTimestamp) {
+        throw createNoteVersionConflictError({
+          currentUpdatedAt: existingNote.updatedAt.getTime(),
+          expectedUpdatedAt: expectedTimestamp ?? existingNote.updatedAt.getTime()
+        });
+      }
+      const baseline = {
+        ...existingNote,
+        properties: existingNote.properties.map((property) => ({
+          key: property.definition.key,
+          name: property.definition.name,
+          valueType: property.definition.valueType,
+          textValue: property.textValue,
+          textValueNormalized: property.textValueNormalized,
+          numberValue: property.numberValue,
+          dateValue: property.dateValue,
+          boolValue: property.boolValue,
+          optionValue: property.option?.value ?? null,
+          optionLabel: property.option?.label ?? null,
+          optionColor: property.option?.color ?? null
+        }))
+      };
+      for (const item of normalizedPatch.set) {
+        const definition = await tx.propertyDefinition.findUnique({ where: { key: item.key } });
+        if (!definition) {
+          throw new InvalidNotePropertyInputError(
+            `Property ${item.key} is not defined. Create it in property settings first.`
+          );
+        }
+        if (definition.valueType !== item.valueType) {
+          throw new InvalidNotePropertyInputError(
+            `Property ${item.key} already uses ${definition.valueType} values.`
+          );
+        }
+        const valueData = await buildTypedValueData(item, definition.id, tx);
+        await tx.noteProperty.upsert({
+          where: {
+            noteId_propertyDefinitionId: {
+              noteId: id,
+              propertyDefinitionId: definition.id
+            }
+          },
+          create: {
+            noteId: id,
+            propertyDefinitionId: definition.id,
+            ...valueData
+          },
+          update: valueData
+        });
+      }
+      if (normalizedPatch.deleteKeys.length > 0) {
+        const definitions = await tx.propertyDefinition.findMany({
+          where: { key: { in: normalizedPatch.deleteKeys } },
+          select: { id: true }
+        });
+        if (definitions.length > 0) {
+          await tx.noteProperty.deleteMany({
+            where: {
+              noteId: id,
+              propertyDefinitionId: { in: definitions.map((definition) => definition.id) }
+            }
+          });
+        }
+      }
+      const updatedNote = await tx.note.update({
+        where: { id },
+        data: {
+          ...noteData?.title !== void 0 ? { title: noteData.title } : {},
+          ...noteData?.layout !== void 0 ? { layout: noteData.layout } : {},
+          ...noteData?.title !== void 0 ? buildNoteSearchProjection({
+            title: noteData.title,
+            content: existingNote.content
+          }) : {},
+          updatedAt: /* @__PURE__ */ new Date()
+        }
+      });
+      return { updatedNote, baseline };
+    });
+    if (!result) {
+      return null;
+    }
+    const snapshot = await captureNoteBaseline({
+      noteId: id,
+      baseline: result.baseline,
+      ...editSessionId && !force ? { editSessionId } : {},
+      ...snapshotMeta ? { meta: snapshotMeta } : {},
+      ...force ? { force: true } : {}
+    });
+    return {
+      note: result.updatedNote,
+      snapshot
+    };
+  } catch (error) {
+    if (isRecordNotFoundError(error)) {
+      return null;
+    }
+    throw error;
+  }
+};
+const updateNotePropertiesWithVersionGuard = async (input) => {
+  const result = await updateNotePropertiesWithVersionGuardAndSnapshot(input);
+  return result?.note ?? null;
+};
+export {
+  InvalidNotePropertyInputError,
+  NotePropertyDeleteConfirmationRequiredError,
+  assertPropertyOptionUpdateKeepsUsedValues,
+  createNotePropertyDefinition,
+  deleteNotePropertyDefinition,
+  findReferencedRemovedPropertyOptionValue,
+  listNoteProperties,
+  listNotePropertyKeys,
+  normalizePropertyKey,
+  normalizeUrlValue,
+  renamePropertyFiltersInViewQuery,
+  resolveNotePropertiesPatchValueTypes,
+  serializeNoteProperties,
+  serializeNoteProperty,
+  updateNotePropertiesWithVersionGuard,
+  updateNotePropertiesWithVersionGuardAndSnapshot,
+  updateNotePropertyDefinition,
+  validateNotePropertiesPatchValues
+};
+//# sourceMappingURL=properties.js.map