@utilix-tech/sdk 0.79.0 → 0.80.0

package/dist/tools/json.cjs

@@ -1423,15 +1423,231 @@ function applyJsonMergePatch(targetJson, patchJson) {
   }
   return { result: mergeJsonPatch(target, patch) };
 }
+function _escapeJsonPointerToken(token) {
+  return token.replace(/~/g, "~0").replace(/\//g, "~1");
+}
+function _unescapeJsonPointerToken(token) {
+  return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function _parseJsonPointer(pointer) {
+  if (pointer === "") return [];
+  if (!pointer.startsWith("/")) throw new Error(`Invalid JSON Pointer "${pointer}": must start with "/"`);
+  return pointer.slice(1).split("/").map(_unescapeJsonPointerToken);
+}
+function _isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function _deepEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== typeof b) return false;
+  if (Array.isArray(a) || Array.isArray(b)) {
+    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+    return a.every((v, i) => _deepEqual(v, b[i]));
+  }
+  if (_isPlainObject(a) && _isPlainObject(b)) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) return false;
+    return aKeys.every((k) => k in b && _deepEqual(a[k], b[k]));
+  }
+  return false;
+}
+function _getByTokens(doc, tokens) {
+  let current = doc;
+  for (const token of tokens) {
+    if (Array.isArray(current)) {
+      const index = token === "-" ? current.length - 1 : parseInt(token, 10);
+      if (!Number.isInteger(index) || index < 0 || index >= current.length) return { found: false, value: void 0 };
+      current = current[index];
+    } else if (_isPlainObject(current)) {
+      if (!(token in current)) return { found: false, value: void 0 };
+      current = current[token];
+    } else {
+      return { found: false, value: void 0 };
+    }
+  }
+  return { found: true, value: current };
+}
+function diffJsonPatch(a, b) {
+  const ops = [];
+  _diffValue(a, b, "", ops);
+  return ops;
+}
+function _diffValue(a, b, path, ops) {
+  if (_deepEqual(a, b)) return;
+  if (_isPlainObject(a) && _isPlainObject(b)) {
+    for (const key of Object.keys(a)) {
+      if (!(key in b)) ops.push({ op: "remove", path: `${path}/${_escapeJsonPointerToken(key)}` });
+    }
+    for (const key of Object.keys(b)) {
+      const childPath = `${path}/${_escapeJsonPointerToken(key)}`;
+      if (!(key in a)) {
+        ops.push({ op: "add", path: childPath, value: b[key] });
+      } else {
+        _diffValue(a[key], b[key], childPath, ops);
+      }
+    }
+    return;
+  }
+  if (Array.isArray(a) && Array.isArray(b)) {
+    const minLen = Math.min(a.length, b.length);
+    for (let i = 0; i < minLen; i++) {
+      _diffValue(a[i], b[i], `${path}/${i}`, ops);
+    }
+    if (b.length > a.length) {
+      for (let i = a.length; i < b.length; i++) ops.push({ op: "add", path: `${path}/${i}`, value: b[i] });
+    } else if (a.length > b.length) {
+      for (let i = a.length - 1; i >= b.length; i--) ops.push({ op: "remove", path: `${path}/${i}` });
+    }
+    return;
+  }
+  ops.push({ op: "replace", path, value: b });
+}
+function applyJsonPatch(target, operations) {
+  let doc = JSON.parse(JSON.stringify(target ?? null));
+  const applyOne = (op, index) => {
+    if (op.path === void 0 || op.op === void 0) return `Operation ${index}: missing "op" or "path"`;
+    let tokens;
+    try {
+      tokens = _parseJsonPointer(op.path);
+    } catch (e) {
+      return `Operation ${index}: ${e.message}`;
+    }
+    const setAt = (tgtTokens, value) => {
+      if (tgtTokens.length === 0) {
+        doc = value;
+        return null;
+      }
+      const parentTokens = tgtTokens.slice(0, -1);
+      const lastToken = tgtTokens[tgtTokens.length - 1];
+      const { found, value: parent } = _getByTokens(doc, parentTokens);
+      if (!found) return `Operation ${index}: path "${op.path}" has no parent`;
+      if (Array.isArray(parent)) {
+        const idx = lastToken === "-" ? parent.length : parseInt(lastToken, 10);
+        if (!Number.isInteger(idx) || idx < 0 || idx > parent.length) return `Operation ${index}: array index "${lastToken}" out of bounds`;
+        parent.splice(idx, 0, value);
+      } else if (_isPlainObject(parent)) {
+        parent[lastToken] = value;
+      } else {
+        return `Operation ${index}: cannot add into a non-object, non-array value at "${op.path}"`;
+      }
+      return null;
+    };
+    const replaceAt = (tgtTokens, value) => {
+      if (tgtTokens.length === 0) {
+        doc = value;
+        return null;
+      }
+      const parentTokens = tgtTokens.slice(0, -1);
+      const lastToken = tgtTokens[tgtTokens.length - 1];
+      const { found, value: parent } = _getByTokens(doc, parentTokens);
+      if (!found) return `Operation ${index}: path "${op.path}" has no parent`;
+      if (Array.isArray(parent)) {
+        const idx = lastToken === "-" ? parent.length - 1 : parseInt(lastToken, 10);
+        if (!Number.isInteger(idx) || idx < 0 || idx >= parent.length) return `Operation ${index}: array index "${lastToken}" out of bounds`;
+        parent[idx] = value;
+      } else if (_isPlainObject(parent)) {
+        if (!(lastToken in parent)) return `Operation ${index}: path "${op.path}" does not exist`;
+        parent[lastToken] = value;
+      } else {
+        return `Operation ${index}: cannot replace into a non-object, non-array value at "${op.path}"`;
+      }
+      return null;
+    };
+    const removeAt = (tgtTokens) => {
+      if (tgtTokens.length === 0) return { error: `Operation ${index}: cannot remove the whole document (path "")` };
+      const parentTokens = tgtTokens.slice(0, -1);
+      const lastToken = tgtTokens[tgtTokens.length - 1];
+      const { found, value: parent } = _getByTokens(doc, parentTokens);
+      if (!found) return { error: `Operation ${index}: path "${op.path}" has no parent` };
+      if (Array.isArray(parent)) {
+        const idx = lastToken === "-" ? parent.length - 1 : parseInt(lastToken, 10);
+        if (!Number.isInteger(idx) || idx < 0 || idx >= parent.length) return { error: `Operation ${index}: array index "${lastToken}" out of bounds` };
+        const [removed] = parent.splice(idx, 1);
+        return { error: null, removed };
+      }
+      if (_isPlainObject(parent)) {
+        if (!(lastToken in parent)) return { error: `Operation ${index}: path "${op.path}" does not exist` };
+        const removed = parent[lastToken];
+        delete parent[lastToken];
+        return { error: null, removed };
+      }
+      return { error: `Operation ${index}: cannot remove from a non-object, non-array value at "${op.path}"` };
+    };
+    switch (op.op) {
+      case "add":
+        return setAt(tokens, op.value);
+      case "replace":
+        return replaceAt(tokens, op.value);
+      case "remove":
+        return removeAt(tokens).error;
+      case "test": {
+        const { found, value } = _getByTokens(doc, tokens);
+        if (!found) return `Operation ${index}: path "${op.path}" does not exist`;
+        if (!_deepEqual(value, op.value)) return `Operation ${index}: test failed at "${op.path}"`;
+        return null;
+      }
+      case "move": {
+        if (!op.from) return `Operation ${index}: "move" requires "from"`;
+        let fromTokens;
+        try {
+          fromTokens = _parseJsonPointer(op.from);
+        } catch (e) {
+          return `Operation ${index}: ${e.message}`;
+        }
+        const removal = removeAt(fromTokens);
+        if (removal.error) return removal.error;
+        return setAt(tokens, removal.removed);
+      }
+      case "copy": {
+        if (!op.from) return `Operation ${index}: "copy" requires "from"`;
+        let fromTokens;
+        try {
+          fromTokens = _parseJsonPointer(op.from);
+        } catch (e) {
+          return `Operation ${index}: ${e.message}`;
+        }
+        const { found, value } = _getByTokens(doc, fromTokens);
+        if (!found) return `Operation ${index}: "from" path "${op.from}" does not exist`;
+        return setAt(tokens, JSON.parse(JSON.stringify(value)));
+      }
+      default:
+        return `Operation ${index}: unknown op "${op.op}"`;
+    }
+  };
+  for (let i = 0; i < operations.length; i++) {
+    const err = applyOne(operations[i], i);
+    if (err) return { error: err };
+  }
+  return { result: doc };
+}
+function generateJsonPatch(aJson, bJson) {
+  let a;
+  try {
+    a = JSON.parse(aJson);
+  } catch {
+    return { error: "First document is not valid JSON" };
+  }
+  let b;
+  try {
+    b = JSON.parse(bJson);
+  } catch {
+    return { error: "Second document is not valid JSON" };
+  }
+  return { patch: diffJsonPatch(a, b) };
+}
 
 exports.applyJsonMergePatch = applyJsonMergePatch;
+exports.applyJsonPatch = applyJsonPatch;
 exports.csvToJson = csvToJson;
 exports.detectFormat = detectFormat;
 exports.diffJson = diffJson;
+exports.diffJsonPatch = diffJsonPatch;
 exports.evaluateJsonPath = evaluateJsonPath;
 exports.formatDiffLine = formatDiffLine;
 exports.formatJson = formatJson;
 exports.generateExample = generateExample;
+exports.generateJsonPatch = generateJsonPatch;
 exports.getJsonStats = getJsonStats;
 exports.inferGoType = inferGoType;
 exports.inferPythonType = inferPythonType;

package/dist/tools/json.d.cts

@@ -1 +1 @@
-export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, g as JsonSchemaLike, h as JsonSchemaToTsOptions, M as MergePatchResult, P as ParseStatus, i as PythonClass, k as PythonField, l as PythonMode, V as ValidationError, m as ValidationResult, Z as ZodOptions, n as applyJsonMergePatch, o as csvToJson, p as detectFormat, q as diffJson, r as evaluateJsonPath, s as formatDiffLine, t as formatJson, u as generateExample, v as getJsonStats, w as inferGoType, x as inferPythonType, y as inferType, z as jsonSchemaToTypescript, A as jsonToCsv, B as jsonToGo, E as jsonToPython, F as jsonToTypescript, H as jsonToYaml, I as jsonToZod, K as mergeJsonPatch, L as minifyJson, N as parseJson, O as parseStructs, Q as resolveJsonPointer, R as toPascalCase, S as toSnakeCase, T as validateJson, U as validateJsonPath, W as validateJsonString, X as yamlToJson } from '../json-CaiYsGDQ.cjs';
+export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPatchOp, f as JsonPatchOperation, g as JsonPathResult, h as JsonPointerResult, i as JsonSchemaLike, k as JsonSchemaToTsOptions, M as MergePatchResult, P as ParseStatus, l as PythonClass, m as PythonField, n as PythonMode, V as ValidationError, o as ValidationResult, Z as ZodOptions, p as applyJsonMergePatch, q as applyJsonPatch, r as csvToJson, s as detectFormat, t as diffJson, u as diffJsonPatch, v as evaluateJsonPath, w as formatDiffLine, x as formatJson, y as generateExample, z as generateJsonPatch, A as getJsonStats, B as inferGoType, E as inferPythonType, F as inferType, H as jsonSchemaToTypescript, I as jsonToCsv, K as jsonToGo, L as jsonToPython, N as jsonToTypescript, O as jsonToYaml, Q as jsonToZod, R as mergeJsonPatch, S as minifyJson, T as parseJson, U as parseStructs, W as resolveJsonPointer, X as toPascalCase, Y as toSnakeCase, _ as validateJson, $ as validateJsonPath, a0 as validateJsonString, a1 as yamlToJson } from '../json-Ca6gZCNB.cjs';

package/dist/tools/json.d.ts

@@ -1 +1 @@
-export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, g as JsonSchemaLike, h as JsonSchemaToTsOptions, M as MergePatchResult, P as ParseStatus, i as PythonClass, k as PythonField, l as PythonMode, V as ValidationError, m as ValidationResult, Z as ZodOptions, n as applyJsonMergePatch, o as csvToJson, p as detectFormat, q as diffJson, r as evaluateJsonPath, s as formatDiffLine, t as formatJson, u as generateExample, v as getJsonStats, w as inferGoType, x as inferPythonType, y as inferType, z as jsonSchemaToTypescript, A as jsonToCsv, B as jsonToGo, E as jsonToPython, F as jsonToTypescript, H as jsonToYaml, I as jsonToZod, K as mergeJsonPatch, L as minifyJson, N as parseJson, O as parseStructs, Q as resolveJsonPointer, R as toPascalCase, S as toSnakeCase, T as validateJson, U as validateJsonPath, W as validateJsonString, X as yamlToJson } from '../json-CaiYsGDQ.js';
+export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPatchOp, f as JsonPatchOperation, g as JsonPathResult, h as JsonPointerResult, i as JsonSchemaLike, k as JsonSchemaToTsOptions, M as MergePatchResult, P as ParseStatus, l as PythonClass, m as PythonField, n as PythonMode, V as ValidationError, o as ValidationResult, Z as ZodOptions, p as applyJsonMergePatch, q as applyJsonPatch, r as csvToJson, s as detectFormat, t as diffJson, u as diffJsonPatch, v as evaluateJsonPath, w as formatDiffLine, x as formatJson, y as generateExample, z as generateJsonPatch, A as getJsonStats, B as inferGoType, E as inferPythonType, F as inferType, H as jsonSchemaToTypescript, I as jsonToCsv, K as jsonToGo, L as jsonToPython, N as jsonToTypescript, O as jsonToYaml, Q as jsonToZod, R as mergeJsonPatch, S as minifyJson, T as parseJson, U as parseStructs, W as resolveJsonPointer, X as toPascalCase, Y as toSnakeCase, _ as validateJson, $ as validateJsonPath, a0 as validateJsonString, a1 as yamlToJson } from '../json-Ca6gZCNB.js';

package/dist/tools/json.js

@@ -1,2 +1,2 @@
-export { applyJsonMergePatch, csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonSchemaToTypescript, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, mergeJsonPatch, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson } from '../chunk-34C6GXCC.js';
+export { applyJsonMergePatch, applyJsonPatch, csvToJson, detectFormat, diffJson, diffJsonPatch, evaluateJsonPath, formatDiffLine, formatJson, generateExample, generateJsonPatch, getJsonStats, inferGoType, inferPythonType, inferType, jsonSchemaToTypescript, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, mergeJsonPatch, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson } from '../chunk-WUOZHCIC.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.79.0",
+  "version": "0.80.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",