@happyvertical/smrt-core 0.57.51 → 0.57.52

package/dist/utils/json-equal.js

@@ -0,0 +1,118 @@
+//#region src/utils/json-equal.ts
+/**
+* Structural equality for JSON field values (#4604).
+*
+* Diff guards (`SmrtCollection.getOrUpsert()` / `getDiff()`, sync-apply
+* no-op detection) must not report an unchanged JSON field as changed just
+* because the incoming object or array is a different instance, or because
+* its keys arrive in a different order than the stored row's. Doing so
+* re-saves the row, moves `updated_at`, and appends a change-feed entry on
+* every call.
+*
+* Equality is decided in the value's JSON (persisted) form:
+* - plain objects compare key-order-insensitively; a key whose value is
+*   `undefined` is absent (JSON drops it), but `null` is a real value;
+* - arrays compare element by element, in order;
+* - a `Date` equals another `Date` at the same instant, or the ISO string
+*   `JSON.stringify` would write for it;
+* - everything else compares with `===` (no numeric/string coercion).
+*
+* Errs toward "changed": anything it cannot prove equal is unequal.
+*/
+var JSON_NUMBER = /-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?/y;
+/**
+* Whether every number literal in JSON text survives `JSON.parse` exactly.
+*
+* `JSON.parse` reads numbers as doubles, so `9007199254740993` and
+* `9007199254740992` parse to the same value. A literal is exact when the
+* double it parses to prints back as the same text; anything else (unsafe
+* integers, more digits than a double holds, `1.0`, `1e2`) makes the text
+* unprovable. Digits inside JSON strings are not numbers and are skipped.
+*/
+function jsonNumbersRoundTrip(text) {
+	let inString = false;
+	for (let index = 0; index < text.length; index += 1) {
+		const char = text[index];
+		if (inString) {
+			if (char === "\\") index += 1;
+			else if (char === "\"") inString = false;
+			continue;
+		}
+		if (char === "\"") {
+			inString = true;
+			continue;
+		}
+		if (char === "-" || char >= "0" && char <= "9") {
+			JSON_NUMBER.lastIndex = index;
+			const match = JSON_NUMBER.exec(text);
+			if (!match) return false;
+			const literal = match[0];
+			if (JSON.stringify(Number(literal)) !== literal) return false;
+			index += literal.length - 1;
+		}
+	}
+	return true;
+}
+function isPlainObject(value) {
+	if (value === null || typeof value !== "object") return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+function dateTime(value) {
+	const time = value.getTime();
+	return Number.isNaN(time) ? null : time;
+}
+function definedKeys(value) {
+	return Object.keys(value).filter((key) => value[key] !== void 0);
+}
+/**
+* Whether two values are equal in their JSON form.
+*
+* Bounded by `depth` so a cyclic value (which cannot be persisted as JSON)
+* reports unequal instead of overflowing the stack.
+*/
+function jsonValuesEqual(a, b, depth = 0) {
+	if (a === b) return true;
+	if (depth > 256) return false;
+	if (a instanceof Date || b instanceof Date) {
+		if (a instanceof Date && b instanceof Date) {
+			const timeA = dateTime(a);
+			return timeA !== null && timeA === dateTime(b);
+		}
+		const [date, other] = a instanceof Date ? [a, b] : [b, a];
+		return typeof other === "string" && dateTime(date) !== null && date.toISOString() === other;
+	}
+	if (Array.isArray(a) || Array.isArray(b)) {
+		if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+		for (let index = 0; index < a.length; index += 1) if (!jsonValuesEqual(a[index], b[index], depth + 1)) return false;
+		return true;
+	}
+	if (isPlainObject(a) && isPlainObject(b)) {
+		const keysA = definedKeys(a);
+		const keysB = definedKeys(b);
+		if (keysA.length !== keysB.length) return false;
+		return keysA.every((key) => Object.hasOwn(b, key) && b[key] !== void 0 && jsonValuesEqual(a[key], b[key], depth + 1));
+	}
+	return false;
+}
+/**
+* Parse `value` when it is JSON text for an object or array; otherwise
+* return it unchanged. Used to compare a JSON field hydrated (or supplied)
+* as text against the same value supplied as an object.
+*/
+function parseJsonContainerText(value) {
+	if (typeof value !== "string") return value;
+	const trimmed = value.trim();
+	if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return value;
+	if (!jsonNumbersRoundTrip(trimmed)) return value;
+	try {
+		const parsed = JSON.parse(trimmed);
+		return parsed !== null && typeof parsed === "object" ? parsed : value;
+	} catch {
+		return value;
+	}
+}
+//#endregion
+export { jsonNumbersRoundTrip, jsonValuesEqual, parseJsonContainerText };
+
+//# sourceMappingURL=json-equal.js.map

package/dist/utils/json-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-equal.js","names":[],"sources":["../../src/utils/json-equal.ts"],"sourcesContent":["/**\n * Structural equality for JSON field values (#4604).\n *\n * Diff guards (`SmrtCollection.getOrUpsert()` / `getDiff()`, sync-apply\n * no-op detection) must not report an unchanged JSON field as changed just\n * because the incoming object or array is a different instance, or because\n * its keys arrive in a different order than the stored row's. Doing so\n * re-saves the row, moves `updated_at`, and appends a change-feed entry on\n * every call.\n *\n * Equality is decided in the value's JSON (persisted) form:\n * - plain objects compare key-order-insensitively; a key whose value is\n *   `undefined` is absent (JSON drops it), but `null` is a real value;\n * - arrays compare element by element, in order;\n * - a `Date` equals another `Date` at the same instant, or the ISO string\n *   `JSON.stringify` would write for it;\n * - everything else compares with `===` (no numeric/string coercion).\n *\n * Errs toward \"changed\": anything it cannot prove equal is unequal.\n */\n\n// Import-free on purpose: generated sync-apply routes bundle this module.\n\nconst JSON_NUMBER = /-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?/y;\n\n/**\n * Whether every number literal in JSON text survives `JSON.parse` exactly.\n *\n * `JSON.parse` reads numbers as doubles, so `9007199254740993` and\n * `9007199254740992` parse to the same value. A literal is exact when the\n * double it parses to prints back as the same text; anything else (unsafe\n * integers, more digits than a double holds, `1.0`, `1e2`) makes the text\n * unprovable. Digits inside JSON strings are not numbers and are skipped.\n */\nexport function jsonNumbersRoundTrip(text: string): boolean {\n  let inString = false;\n  for (let index = 0; index < text.length; index += 1) {\n    const char = text[index];\n    if (inString) {\n      if (char === '\\\\') index += 1;\n      else if (char === '\"') inString = false;\n      continue;\n    }\n    if (char === '\"') {\n      inString = true;\n      continue;\n    }\n    if (char === '-' || (char >= '0' && char <= '9')) {\n      JSON_NUMBER.lastIndex = index;\n      const match = JSON_NUMBER.exec(text);\n      if (!match) return false;\n      const literal = match[0];\n      if (JSON.stringify(Number(literal)) !== literal) return false;\n      index += literal.length - 1;\n    }\n  }\n  return true;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== 'object') return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction dateTime(value: Date): number | null {\n  const time = value.getTime();\n  return Number.isNaN(time) ? null : time;\n}\n\nfunction definedKeys(value: Record<string, unknown>): string[] {\n  return Object.keys(value).filter((key) => value[key] !== undefined);\n}\n\n/**\n * Whether two values are equal in their JSON form.\n *\n * Bounded by `depth` so a cyclic value (which cannot be persisted as JSON)\n * reports unequal instead of overflowing the stack.\n */\nexport function jsonValuesEqual(a: unknown, b: unknown, depth = 0): boolean {\n  if (a === b) return true;\n  if (depth > 256) return false;\n\n  if (a instanceof Date || b instanceof Date) {\n    if (a instanceof Date && b instanceof Date) {\n      const timeA = dateTime(a);\n      return timeA !== null && timeA === dateTime(b);\n    }\n    const [date, other] = a instanceof Date ? [a, b] : [b as Date, a];\n    return (\n      typeof other === 'string' &&\n      dateTime(date) !== null &&\n      date.toISOString() === other\n    );\n  }\n\n  if (Array.isArray(a) || Array.isArray(b)) {\n    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {\n      return false;\n    }\n    // Index loop, not `every()`: `every()` skips holes, so a sparse array\n    // would match any value at that index.\n    for (let index = 0; index < a.length; index += 1) {\n      if (!jsonValuesEqual(a[index], b[index], depth + 1)) return false;\n    }\n    return true;\n  }\n\n  if (isPlainObject(a) && isPlainObject(b)) {\n    const keysA = definedKeys(a);\n    const keysB = definedKeys(b);\n    if (keysA.length !== keysB.length) return false;\n    // Own properties only: `b[key]` alone would resolve `__proto__` (an own\n    // key of parsed JSON) through the prototype chain.\n    return keysA.every(\n      (key) =>\n        Object.hasOwn(b, key) &&\n        b[key] !== undefined &&\n        jsonValuesEqual(a[key], b[key], depth + 1),\n    );\n  }\n\n  return false;\n}\n\n/**\n * Parse `value` when it is JSON text for an object or array; otherwise\n * return it unchanged. Used to compare a JSON field hydrated (or supplied)\n * as text against the same value supplied as an object.\n */\nexport function parseJsonContainerText(value: unknown): unknown {\n  if (typeof value !== 'string') return value;\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) return value;\n  // Text whose numbers a double cannot hold exactly stays unparsed (unequal).\n  if (!jsonNumbersRoundTrip(trimmed)) return value;\n  try {\n    const parsed: unknown = JSON.parse(trimmed);\n    return parsed !== null && typeof parsed === 'object' ? parsed : value;\n  } catch {\n    return value;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-core",
-  "version": "0.57.51",
+  "version": "0.57.52",
   "description": "Core SMRT framework for business objects, persistence, and generated REST, CLI, MCP, and AI interfaces",
   "author": "HappyVertical",
   "type": "module",
@@ -199,9 +199,9 @@
     "@happyvertical/files": "^0.111.3",
     "@happyvertical/json": "^0.111.3",
     "@happyvertical/logger": "^0.111.3",
-    "@happyvertical/smrt-config": "0.57.51",
-    "@happyvertical/smrt-scanner": "0.57.51",
-    "@happyvertical/smrt-types": "0.57.51",
+    "@happyvertical/smrt-config": "0.57.52",
+    "@happyvertical/smrt-scanner": "0.57.52",
+    "@happyvertical/smrt-types": "0.57.52",
     "@happyvertical/sql": "^0.111.3",
     "@happyvertical/utils": "^0.111.3",
     "@noble/hashes": "^2.4.0",