@hyperjump/json-pointer 1.0.1 → 1.1.0

package/README.md

@@ -1,24 +1,22 @@
-JSON Pointer
-============
+# JSON Pointer
 
 This is an implementation of RFC-6901 JSON Pointer. JSON Pointer is designed for
 referring to data values within a JSON document. It's designed to be URL
 friendly so it can be used as a URL fragment that points to a specific part of
 the JSON document.
 
-Installation
-------------
+## Installation
+
 Includes support for node.js (ES Modules, TypeScript) and browsers.
 
 ```bash
 npm install @hyperjump/json-pointer
 ```
 
-Usage
------
+## Usage
 
 ```javascript
-const JsonPointer = require("@hyperjump/json-pointer");
+import * as JsonPointer from "@hyperjump/json-pointer";
 
 const value = {
   "foo": {
@@ -27,7 +25,7 @@ const value = {
 };
 
 // Construct pointers
-const fooPointer = JsonPointer.append(JsonPointer.nil, "foo"); // "/foo"
+const fooPointer = JsonPointer.append("foo", JsonPointer.nil); // "/foo"
 const fooBarPointer = JsonPointer.append(fooPointer, "bar"); // "/foo/bar"
 
 // Get a value from a pointer
@@ -55,8 +53,40 @@ const deleteFooBar = JsonPointer.remove(fooBarPointer);
 deleteFooBar(value); // { "foo": {} }
 ```
 
-Contributing
-------------
+## API
+
+* **nil**: ""
+
+    The empty pointer.
+* **pointerSegments**: (pointer: string) => Generator\<string>
+
+    An iterator for the segments of a JSON Pointer that handles escaping.
+* **append**: (segment: string, pointer: string) => string
+
+    Append a segment to a JSON Pointer.
+* **get**: (pointer: string, subject: any) => any
+
+    Use a JSON Pointer to get a value. This function can be curried.
+* **set**: (pointer: string, subject: any, value: any) => any
+
+    Immutably set a value using a JSON Pointer. Returns a new version of
+    `subject` with the value set. The original `subject` is not changed, but the
+    value isn't entirely cloned. Values that aren't changed will point to
+    the same value as the original. This function can be curried.
+* **assign**: (pointer: string, subject: any, value: any) => void
+
+    Mutate a value using a JSON Pointer. This function can be curried.
+* **unset**: (pointer: string, subject: any) => any
+
+    Immutably delete a value using a JSON Pointer. Returns a new version of
+    `subject` without the value. The original `subject` is not changed, but the
+    value isn't entirely cloned. Values that aren't changed will point to the
+    same value as the original. This function can be curried.
+* **remove**: (pointer: string, subject: any) => void
+
+    Delete a value using a JSON Pointer. This function can be curried.
+
+## Contributing
 
 ### Tests
 

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 export const nil: "";
+export const pointerSegments: (pointer: string) => Generator<string>;
 export const append: (
     (segment: string, pointer: string) => string
   ) & (

package/lib/index.js

@@ -1,11 +1,6 @@
-import curry from "just-curry-it";
-
-
 export const nil = "";
 
-const EXISTS = Symbol("EXISTS");
-
-const segmentGenerator = (pointer) => {
+export const pointerSegments = function* (pointer) {
   if (pointer.length > 0 && pointer[0] !== "/") {
     throw Error("Invalid JSON Pointer");
   }
@@ -13,132 +8,147 @@ const segmentGenerator = (pointer) => {
   let segmentStart = 1;
   let segmentEnd = 0;
 
-  return (mode) => {
-    if (mode === EXISTS) {
-      return segmentEnd < pointer.length;
-    }
-
-    if (segmentEnd >= pointer.length) {
-      return;
-    }
-
+  while (segmentEnd < pointer.length) {
     const position = pointer.indexOf("/", segmentStart);
     segmentEnd = position === -1 ? pointer.length : position;
-    const segment = unescape(pointer.slice(segmentStart, segmentEnd));
+    const segment = pointer.slice(segmentStart, segmentEnd);
     segmentStart = segmentEnd + 1;
 
-    return segment;
-  };
+    yield unescape(segment);
+  }
 };
 
 export const get = (pointer, subject = undefined) => {
-  const nextSegment = segmentGenerator(pointer);
-  const fn = (subject) => _get(nextSegment, subject, nil);
-  return subject === undefined ? fn : fn(subject);
+  if (subject === undefined) {
+    const segments = [...pointerSegments(pointer)];
+    return (subject) => _get(segments, subject);
+  } else {
+    return _get(pointerSegments(pointer), subject);
+  }
 };
 
-const _get = (nextSegment, subject, cursor) => {
-  if (!nextSegment(EXISTS)) {
-    return subject;
-  } else {
-    const segment = nextSegment();
-    return _get(nextSegment, applySegment(subject, segment, cursor), append(segment, cursor));
+const _get = (segments, subject) => {
+  let cursor = nil;
+  for (const segment of segments) {
+    subject = applySegment(subject, segment, cursor);
+    cursor = append(segment, cursor);
   }
+
+  return subject;
 };
 
 export const set = (pointer, subject = undefined, value = undefined) => {
-  const nextSegment = segmentGenerator(pointer);
-  const fn = curry((subject, value) => _set(nextSegment, subject, value, nil));
-  return subject === undefined ? fn : fn(subject, value);
+  if (subject === undefined) {
+    const segments = [...pointerSegments(pointer)];
+    return (subject, value) => _set(segments.values(), subject, value);
+  } else {
+    return _set(pointerSegments(pointer), subject, value);
+  }
 };
 
-const _set = (nextSegment, subject, value, cursor) => {
-  const segment = nextSegment();
-  if (segment === undefined) {
+const _set = (segments, subject, value, cursor = nil) => {
+  const segment = segments.next();
+  if (segment.done) {
     return value;
-  } else if (nextSegment(EXISTS)) {
-    if (Array.isArray(subject)) {
-      const clonedSubject = [...subject];
-      clonedSubject[segment] = _set(nextSegment, applySegment(subject, segment, cursor), value, append(segment, cursor));
-      return clonedSubject;
-    } else {
-      return { ...subject, [segment]: _set(nextSegment, applySegment(subject, segment, cursor), value, append(segment, cursor)) };
-    }
-  } else if (Array.isArray(subject)) {
-    const clonedSubject = [...subject];
-    clonedSubject[computeSegment(subject, segment)] = value;
-    return clonedSubject;
+  }
+
+  if (Array.isArray(subject)) {
+    subject = [...subject];
   } else if (typeof subject === "object" && subject !== null) {
-    return { ...subject, [segment]: value };
+    subject = { ...subject };
   } else {
-    return applySegment(subject, segment, cursor);
+    applySegment(subject, segment.value, cursor);
   }
+  cursor = append(segment.value, cursor);
+
+  const computedSegment = computeSegment(subject, segment.value);
+  subject[computedSegment] = _set(segments, subject[computedSegment], value, cursor);
+  return subject;
 };
 
 export const assign = (pointer, subject = undefined, value = undefined) => {
-  const nextSegment = segmentGenerator(pointer);
-  const fn = curry((subject, value) => _assign(nextSegment, subject, value, nil));
-  return subject === undefined ? fn : fn(subject, value);
+  if (subject === undefined) {
+    const segments = [...pointerSegments(pointer)];
+    return (subject, value) => _assign(segments.values(), subject, value);
+  } else {
+    return _assign(pointerSegments(pointer), subject, value);
+  }
 };
 
-const _assign = (nextSegment, subject, value, cursor) => {
-  const segment = nextSegment();
-  if (segment === undefined) {
-    return;
-  } else if (!nextSegment(EXISTS) && !isScalar(subject)) {
-    subject[computeSegment(subject, segment)] = value;
-  } else {
-    _assign(nextSegment, applySegment(subject, segment, cursor), value, append(segment, cursor));
+const _assign = (segments, subject, value, cursor = nil) => {
+  let lastSegment;
+  let lastSubject;
+  for (let segment of segments) {
+    segment = computeSegment(subject, segment);
+    lastSegment = segment;
+    lastSubject = subject;
+    subject = applySegment(subject, segment, cursor);
+    cursor = append(segment, cursor);
+  }
+
+  if (lastSubject !== undefined) {
+    lastSubject[lastSegment] = value;
   }
 };
 
 export const unset = (pointer, subject = undefined) => {
-  const nextSegment = segmentGenerator(pointer);
-  const fn = (subject) => _unset(nextSegment, subject, nil);
-  return subject === undefined ? fn : fn(subject);
+  if (subject === undefined) {
+    const segments = [...pointerSegments(pointer)];
+    return (subject) => _unset(segments.values(), subject);
+  } else {
+    return _unset(pointerSegments(pointer), subject);
+  }
 };
 
-const _unset = (nextSegment, subject, cursor) => {
-  const segment = nextSegment();
-  if (segment === undefined) {
+const _unset = (segments, subject, cursor = nil) => {
+  const segment = segments.next();
+  if (segment.done) {
     return;
-  } else if (nextSegment(EXISTS)) {
-    const value = applySegment(subject, segment, cursor);
-    return { ...subject, [segment]: _unset(nextSegment, value, append(segment, cursor)) };
-  } else if (Array.isArray(subject)) {
-    const clonedSubject = [...subject];
-    delete clonedSubject[computeSegment(subject, segment)];
-    return clonedSubject;
+  }
+
+  if (Array.isArray(subject)) {
+    subject = [...subject];
   } else if (typeof subject === "object" && subject !== null) {
-    // eslint-disable-next-line no-unused-vars
-    const { [segment]: _, ...result } = subject;
-    return result;
+    subject = { ...subject };
   } else {
-    return applySegment(subject, segment, cursor);
+    applySegment(subject, segment.value, cursor);
   }
+  cursor = append(segment.value, cursor);
+
+  const computedSegment = computeSegment(subject, segment.value);
+  const unsetSubject = _unset(segments, subject[computedSegment], cursor);
+  if (computedSegment in subject) {
+    subject[computedSegment] = unsetSubject;
+  }
+  return subject;
 };
 
 export const remove = (pointer, subject = undefined) => {
-  const nextSegment = segmentGenerator(pointer);
-  const fn = (subject) => _remove(nextSegment, subject, nil);
-  return subject === undefined ? fn : fn(subject);
+  if (subject === undefined) {
+    const segments = [...pointerSegments(pointer)];
+    return (subject) => _remove(segments.values(), subject);
+  } else {
+    return _remove(pointerSegments(pointer), subject);
+  }
 };
 
-const _remove = (nextSegment, subject, cursor) => {
-  const segment = nextSegment();
-  if (segment === undefined) {
-    return;
-  } else if (nextSegment(EXISTS)) {
-    const value = applySegment(subject, segment, cursor);
-    _remove(nextSegment, value, append(segment, cursor));
-  } else if (!isScalar(subject)) {
-    delete subject[segment];
-  } else {
-    applySegment(subject, segment, cursor);
+const _remove = (segments, subject, cursor = nil) => {
+  let lastSegment;
+  let lastSubject;
+  for (let segment of segments) {
+    segment = computeSegment(subject, segment);
+    lastSegment = segment;
+    lastSubject = subject;
+    subject = applySegment(subject, segment, cursor);
+    cursor = append(segment, cursor);
+  }
+
+  if (lastSubject !== undefined) {
+    delete lastSubject[lastSegment];
   }
 };
 
-export const append = curry((segment, pointer) => pointer + "/" + escape(segment));
+export const append = (segment, pointer) => pointer + "/" + escape(segment);
 
 const escape = (segment) => segment.toString().replace(/~/g, "~0").replace(/\//g, "~1");
 const unescape = (segment) => segment.toString().replace(/~1/g, "/").replace(/~0/g, "~");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperjump/json-pointer",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "An RFC-6901 JSON Pointer implementation",
   "type": "module",
   "main": "./lib/index.js",
@@ -8,7 +8,7 @@
   "scripts": {
     "clean": "xargs -a .gitignore rm -rf",
     "lint": "eslint lib",
-    "test": "mocha 'lib/**/*.spec.ts'"
+    "test": "vitest --watch=false"
   },
   "repository": "github:hyperjump-io/json-pointer",
   "keywords": [
@@ -22,20 +22,13 @@
     "url": "https://github.com/sponsors/jdesrosiers"
   },
   "devDependencies": {
-    "@types/chai": "*",
-    "@types/mocha": "*",
     "@typescript-eslint/eslint-plugin": "*",
     "@typescript-eslint/parser": "*",
-    "chai": "*",
     "eslint": "*",
     "eslint-import-resolver-node": "*",
     "eslint-import-resolver-typescript": "*",
     "eslint-plugin-import": "*",
-    "mocha": "*",
-    "ts-node": "*",
-    "typescript": "*"
-  },
-  "dependencies": {
-    "just-curry-it": "^5.3.0"
+    "typescript": "*",
+    "vitest": "*"
   }
 }