@ordinatio/entities 1.0.3 → 1.1.0

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
   evaluateConstraint,
   fireObservers,
   knowledgeError
-} from "./chunk-QXBSEBJW.mjs";
+} from "./chunk-WWGAALKG.mjs";
 
 // src/knowledge/field-definitions.ts
 import { Prisma } from "@prisma/client";
@@ -199,7 +199,7 @@ async function setEntityFields(db, entityType, entityId, fields, source, sourceI
       } catch {
       }
       try {
-        const { fireObservers: fireObservers2 } = await import("./observer-YUTEGG4S.mjs");
+        const { fireObservers: fireObservers2 } = await import("./observer-2GIY55TX.mjs");
         await fireObservers2(db, entityType, entityId, results.map((r) => r.key), callbacks);
       } catch {
       }
@@ -1668,6 +1668,7 @@ async function createNote(db, input, callbacks) {
       isDraft: input.isDraft ?? false,
       authorId: input.authorId ?? null,
       source: input.source ?? "MANUAL",
+      ...input.metadata ? { metadata: input.metadata } : {},
       ...input.attachments && input.attachments.length > 0 ? {
         attachments: {
           create: input.attachments.map((a) => ({
@@ -1726,6 +1727,21 @@ async function updateNote(db, noteId, entityId, input, callbacks) {
   });
   if (!note) return null;
   const isPublishing = note.isDraft && input.isDraft === false;
+  const isContentChange = input.content !== void 0 && input.content !== note.content || input.contentHtml !== void 0 && input.contentHtml !== note.contentHtml;
+  if (isContentChange && !note.isDraft) {
+    try {
+      await db.clientNoteRevision.create({
+        data: {
+          noteId: note.id,
+          content: note.content,
+          contentHtml: note.contentHtml,
+          editedBy: input.editedBy ?? note.authorId,
+          editedAt: /* @__PURE__ */ new Date()
+        }
+      });
+    } catch {
+    }
+  }
   const updated = await db.clientNote.update({
     where: { id: noteId },
     data: {
@@ -1735,7 +1751,11 @@ async function updateNote(db, noteId, entityId, input, callbacks) {
     },
     include: {
       author: { select: { id: true, name: true } },
-      attachments: true
+      attachments: true,
+      revisions: {
+        orderBy: { editedAt: "desc" },
+        select: { id: true, content: true, editedBy: true, editedAt: true }
+      }
     }
   });
   if (input.attachments !== void 0) {
@@ -1752,6 +1772,26 @@ async function updateNote(db, noteId, entityId, input, callbacks) {
       });
     }
   }
+  if (isContentChange && !note.isDraft && !isPublishing) {
+    try {
+      const noteContent = input.content ?? note.content;
+      const truncated = truncateText(noteContent, 200);
+      await callbacks?.logActivity?.(
+        "CLIENT_NOTE_EDITED",
+        `Note edited: ${truncated}`,
+        {
+          userId: input.editedBy ?? note.authorId ?? null,
+          clientId: entityId,
+          metadata: {
+            noteId,
+            contentPreview: truncateText(noteContent, 500),
+            revisionCount: updated.revisions?.length ?? 0
+          }
+        }
+      );
+    } catch {
+    }
+  }
   if (isPublishing) {
     try {
       const noteContent = input.content ?? note.content;
@@ -1776,7 +1816,11 @@ async function updateNote(db, noteId, entityId, input, callbacks) {
     where: { id: noteId },
     include: {
       author: { select: { id: true, name: true } },
-      attachments: true
+      attachments: true,
+      revisions: {
+        orderBy: { editedAt: "desc" },
+        select: { id: true, content: true, editedBy: true, editedAt: true }
+      }
     }
   });
 }
@@ -1960,6 +2004,7 @@ async function findOrCreateContact(db, email, name, source = "EMAIL_SYNC") {
 }
 
 // src/knowledge/contact-fields-seed.ts
+import { Prisma as Prisma4 } from "@prisma/client";
 var CONTACT_FIELD_DEFINITIONS = [
   // --- Communication ---
   { entityType: "contact", key: "preferred_contact_method", label: "Preferred Contact Method", dataType: "enum", category: "communication", enumOptions: ["email", "phone", "text", "in-person"], sortOrder: 0 },
@@ -1982,7 +2027,7 @@ async function seedContactFieldDefinitions(db) {
       label: d.label,
       dataType: d.dataType,
       category: d.category,
-      enumOptions: "enumOptions" in d ? d.enumOptions : null,
+      enumOptions: "enumOptions" in d ? [...d.enumOptions] : Prisma4.JsonNull,
       extractionHint: "extractionHint" in d ? d.extractionHint : null,
       sortOrder: d.sortOrder,
       status: "approved",
@@ -2119,7 +2164,7 @@ var CreateNoteSchema = z3.object({
   content: z3.string().min(1, "Note content is required").max(5e3, "Note content must be 5000 characters or fewer"),
   contentHtml: z3.string().max(5e4).optional(),
   isDraft: z3.boolean().default(false),
-  source: z3.enum(["MANUAL", "AGENT", "SYSTEM"]).default("MANUAL"),
+  source: z3.enum(["MANUAL", "AGENT", "SYSTEM", "QUOTE"]).default("MANUAL"),
   attachments: z3.array(AttachmentSchema).max(5, "Maximum 5 attachments").default([]),
   fields: z3.record(z3.string(), z3.unknown()).optional()
 });

package/dist/{observer-YUTEGG4S.mjs → observer-2GIY55TX.mjs}

@@ -2,7 +2,7 @@ import {
   checkConstraints,
   evaluateConstraint,
   fireObservers
-} from "./chunk-QXBSEBJW.mjs";
+} from "./chunk-WWGAALKG.mjs";
 export {
   checkConstraints,
   evaluateConstraint,

package/dist/tags/index.d.mts

@@ -0,0 +1,78 @@
+declare const TAG_COLORS: readonly ["neutral", "red", "amber", "green", "blue", "purple", "pink"];
+type TagColor = (typeof TAG_COLORS)[number];
+interface TagLimits {
+    /** Longest tag name, in characters, after cleaning. */
+    maxNameLength: number;
+    /** Upper bound on how many tags one save may add or remove: stops a crafted request sending thousands of ids into an IN query. */
+    maxChangesPerSave: number;
+    /** How many tags may be pinned (shown as bookmarks): pinning more is refused rather than silently ignored. */
+    maxPinned: number;
+    /** Per-workspace ceiling: forms load every tag, so an unbounded vocabulary would slow every form. */
+    maxPerWorkspace: number;
+}
+declare const DEFAULT_TAG_LIMITS: Readonly<TagLimits>;
+
+/** Trims and collapses every run of whitespace (including tabs and no-break spaces) to one plain space. */
+declare function cleanTagName(name: string): string;
+/** The identity of a name inside one workspace: the cleaned name, lower-cased. Two names with the same key are the same tag. */
+declare function tagNameKey(name: string): string;
+type TagNameCheck = {
+    ok: true;
+    name: string;
+    key: string;
+} | {
+    ok: false;
+    reason: 'empty' | 'too-long';
+    length: number;
+};
+/** Cleans the name and checks its length (1 to `maxLength`, default 40, counted in UTF-16 code units like the stored value). */
+declare function checkTagName(name: string, maxLength?: number): TagNameCheck;
+declare function isTagColor(value: unknown): value is TagColor;
+/** No colour means the neutral one; a name that is not in the list is invalid. */
+declare function resolveTagColor(color: string | undefined): {
+    ok: true;
+    color: TagColor;
+} | {
+    ok: false;
+};
+
+interface TagSnapshot {
+    name: string;
+    color: string;
+    pinned: boolean;
+}
+/** One phrase per field that actually changed; empty when nothing did (so nothing is logged). */
+declare function describeTagChanges(before: TagSnapshot, after: TagSnapshot): string[];
+/** Order-independent identity of a set of tag ids. */
+declare function tagSetKey(ids: readonly string[]): string;
+/**
+ * The server's tag set for an item changed while the user had the picker open (their own save came back, or a teammate tagged the item).
+ * Keep the user's unsaved edits (what they added and removed relative to the OLD baseline), apply them on top of the NEW server set, and
+ * make the new server set the baseline. So nothing the user chose is lost, nothing a teammate added is stripped, and the next save's diff
+ * stays correct.
+ */
+interface RebasedSelection {
+    /** The new baseline: the server's current set, de-duplicated. */
+    initial: string[];
+    /** The user's unsaved choices applied on top of it. */
+    selected: string[];
+}
+declare function rebaseSelection(args: {
+    initial: readonly string[];
+    selected: readonly string[];
+    server: readonly string[];
+}): RebasedSelection;
+interface TagChoice {
+    id: string;
+    name: string;
+    color: string;
+}
+/**
+ * The tag list a picker shows: the server's current list (so renames, new tags and deletions by teammates show up), plus tags created in
+ * this very picker that the server list has not caught up with yet. Sorted by name with `localeCompare`, which follows the runtime's
+ * locale and ICU data, so a server and a browser can order accented or mixed-case names differently: do not rely on the order matching
+ * across runtimes.
+ */
+declare function mergeTagOptions<T extends TagChoice>(fresh: readonly T[], createdHere: readonly T[]): T[];
+
+export { DEFAULT_TAG_LIMITS, type RebasedSelection, TAG_COLORS, type TagChoice, type TagColor, type TagLimits, type TagNameCheck, type TagSnapshot, checkTagName, cleanTagName, describeTagChanges, isTagColor, mergeTagOptions, rebaseSelection, resolveTagColor, tagNameKey, tagSetKey };

package/dist/tags/index.mjs

@@ -0,0 +1,66 @@
+// src/tags/constants.ts
+var TAG_COLORS = ["neutral", "red", "amber", "green", "blue", "purple", "pink"];
+var DEFAULT_TAG_LIMITS = Object.freeze({
+  maxNameLength: 40,
+  maxChangesPerSave: 50,
+  maxPinned: 15,
+  maxPerWorkspace: 500
+});
+
+// src/tags/name.ts
+function cleanTagName(name) {
+  return name.trim().replace(/\s+/g, " ");
+}
+function tagNameKey(name) {
+  return cleanTagName(name).toLowerCase();
+}
+function checkTagName(name, maxLength = DEFAULT_TAG_LIMITS.maxNameLength) {
+  const cleaned = cleanTagName(name);
+  if (cleaned.length < 1) return { ok: false, reason: "empty", length: cleaned.length };
+  if (cleaned.length > maxLength) return { ok: false, reason: "too-long", length: cleaned.length };
+  return { ok: true, name: cleaned, key: tagNameKey(cleaned) };
+}
+function isTagColor(value) {
+  return typeof value === "string" && TAG_COLORS.includes(value);
+}
+function resolveTagColor(color) {
+  if (color === void 0) return { ok: true, color: "neutral" };
+  return isTagColor(color) ? { ok: true, color } : { ok: false };
+}
+
+// src/tags/changes.ts
+function describeTagChanges(before, after) {
+  return [
+    before.name !== after.name ? `renamed "${before.name}" to "${after.name}"` : "",
+    before.color !== after.color ? `changed its color to ${after.color}` : "",
+    before.pinned !== after.pinned ? after.pinned ? "pinned it to Bookmarks" : "unpinned it from Bookmarks" : ""
+  ].filter(Boolean);
+}
+function tagSetKey(ids) {
+  return [...new Set(ids)].sort().join(",");
+}
+function rebaseSelection(args) {
+  const initial = new Set(args.initial);
+  const selected = new Set(args.selected);
+  const userAdded = [...selected].filter((t) => !initial.has(t));
+  const userRemoved = new Set([...initial].filter((t) => !selected.has(t)));
+  const next = new Set([...args.server, ...userAdded].filter((t) => !userRemoved.has(t)));
+  return { initial: [...new Set(args.server)], selected: [...next] };
+}
+function mergeTagOptions(fresh, createdHere) {
+  const freshIds = new Set(fresh.map((t) => t.id));
+  return [...fresh, ...createdHere.filter((t) => !freshIds.has(t.id))].sort((a, b) => a.name.localeCompare(b.name));
+}
+export {
+  DEFAULT_TAG_LIMITS,
+  TAG_COLORS,
+  checkTagName,
+  cleanTagName,
+  describeTagChanges,
+  isTagColor,
+  mergeTagOptions,
+  rebaseSelection,
+  resolveTagColor,
+  tagNameKey,
+  tagSetKey
+};

package/package.json

@@ -1,44 +1,37 @@
 {
   "name": "@ordinatio/entities",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "private": false,
   "license": "MIT",
   "description": "Entity knowledge, agent intelligence, notes, and contacts",
   "engines": {
     "node": ">=22.0.0"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./src/index.ts",
-      "types": "./src/index.ts"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     },
-    "./schemas": "./src/schemas.ts",
-    "./errors": "./src/errors.ts"
+    "./tags": {
+      "types": "./dist/tags/index.d.mts",
+      "import": "./dist/tags/index.mjs",
+      "default": "./dist/tags/index.mjs"
+    }
   },
   "publishConfig": {
-    "access": "public",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-      ".": {
-        "import": "./dist/index.js",
-        "types": "./dist/index.d.ts"
-      }
-    }
+    "access": "public"
   },
   "files": [
     "dist",
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --clean",
-    "test": "vitest",
-    "test:run": "vitest run"
+  "dependencies": {
+    "@ordinatio/errors": "1.2.0"
   },
-  "dependencies": {},
   "devDependencies": {
     "@ordinatio/core": "^1.0.0",
     "fast-check": "^4.5.3",
@@ -54,5 +47,10 @@
     "@prisma/client": {
       "optional": true
     }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/tags/index.ts --format esm --dts --clean",
+    "test": "vitest",
+    "test:run": "vitest run"
   }
 }