@m6d/cortex-cli 0.14.0 → 0.16.0

package/src/contracts/json/index.ts

@@ -21,6 +21,50 @@ export function escapePointerToken(token: string) {
     return token.replaceAll("~", "~0").replaceAll("/", "~1");
 }
 
-export function unescapePointerToken(token: string) {
+function unescapePointerToken(token: string) {
     return token.replaceAll("~1", "/").replaceAll("~0", "~");
 }
+
+/**
+ * The reference tokens of a JSON Pointer, bare (`/a/b`) or as a URI fragment (`#/a/b`, which
+ * is percent-decoded before it splits, as RFC 6901 section 6 has it); `[]` names the whole
+ * document. Undefined for text that is neither, or a fragment whose percent-encoding is
+ * malformed.
+ */
+export function pointerTokens(pointer: string) {
+    let path = pointer;
+    if (pointer.startsWith("#")) {
+        try {
+            path = decodeURIComponent(pointer.slice(1));
+        } catch {
+            return undefined;
+        }
+    }
+    if (path === "") return [];
+    if (!path.startsWith("/")) return undefined;
+    return path.slice(1).split("/").map(unescapePointerToken);
+}
+
+/** A JSON Pointer token that names an array index: digits with no leading zero. */
+export const ARRAY_INDEX = /^(?:0|[1-9]\d*)$/;
+
+/** A number spelled as JSON writes one: decimal, in ASCII digits so every regex engine reads the pattern alike. */
+export const JSON_NUMBER_PATTERN = /^-?(0|[1-9][0-9]*)(\.[0-9]+)?([eE][+-]?[0-9]+)?$/;
+
+/**
+ * The value one reference token names under `container`: an own key of an object, or an
+ * `ARRAY_INDEX` of an array; undefined when there is none, so an inherited key such as
+ * `constructor` never resolves.
+ */
+export function pointerChild(container: unknown, token: string) {
+    if (Array.isArray(container)) {
+        const items: unknown[] = container;
+        return ARRAY_INDEX.test(token) ? items[Number(token)] : undefined;
+    }
+    return isRecord(container) && Object.hasOwn(container, token) ? container[token] : undefined;
+}
+
+/** The value a JSON Pointer names in `document`, one `pointerChild` per token; undefined when it names nothing. */
+export function readJsonPointer(document: unknown, pointer: string) {
+    return pointerTokens(pointer)?.reduce<unknown>(pointerChild, document);
+}