@procedures/json 0.0.0-stage → 0.2.3

package/dist/diff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The diff of two JSON values: a JSON Patch (RFC 6902) that changes the first value into the
+ * second value. `applyPatch(a, diffJson(a, b))` gives a value equal to `b`.
+ *
+ * - Two objects: a `remove` for each key that only the first has, a diff of each shared key, and
+ *   an `add` for each key that only the second has.
+ * - Two arrays: the items of the shared start and end stay. The items between them get a diff
+ *   for each shared position, then a `remove` or an `add` for each other item.
+ * - Other values: one `replace`.
+ *
+ * The patch never names `__proto__`, `constructor` or `prototype`, because `applyPatch` refuses
+ * them. When a difference is under such a key, the patch replaces the object that holds the key.
+ */
+import type { PatchOperation } from "./patch.js";
+import { type JsonValue } from "./value.js";
+/** This function gives a JSON Patch that changes `a` into `b`. Equal values give an empty patch. */
+export declare function diffJson(a: JsonValue, b: JsonValue): PatchOperation[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAA+D,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAqCzG,oGAAoG;AACpG,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,cAAc,EAAE,CAIrE"}

package/dist/diff.js

@@ -0,0 +1,66 @@
+/**
+ * The diff of two JSON values: a JSON Patch (RFC 6902) that changes the first value into the
+ * second value. `applyPatch(a, diffJson(a, b))` gives a value equal to `b`.
+ *
+ * - Two objects: a `remove` for each key that only the first has, a diff of each shared key, and
+ *   an `add` for each key that only the second has.
+ * - Two arrays: the items of the shared start and end stay. The items between them get a diff
+ *   for each shared position, then a `remove` or an `add` for each other item.
+ * - Other values: one `replace`.
+ *
+ * The patch never names `__proto__`, `constructor` or `prototype`, because `applyPatch` refuses
+ * them. When a difference is under such a key, the patch replaces the object that holds the key.
+ */
+import { cloneJson, formatPointer, hasOwn, jsonEqual, PROTOTYPE_KEYS } from "./value.js";
+function diffAt(a, b, tokens, out) {
+    if (jsonEqual(a, b))
+        return;
+    const path = formatPointer(tokens);
+    if (Array.isArray(a) && Array.isArray(b)) {
+        diffArrays(a, b, tokens, out);
+        return;
+    }
+    if (a !== null && b !== null && typeof a === "object" && typeof b === "object" && !Array.isArray(a) && !Array.isArray(b)) {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        const named = [...keysA, ...keysB].some((key) => PROTOTYPE_KEYS.has(key) && !(hasOwn(a, key) && hasOwn(b, key) && jsonEqual(a[key], b[key])));
+        if (!named) {
+            for (const key of keysA)
+                if (!hasOwn(b, key))
+                    out.push({ op: "remove", path: formatPointer([...tokens, key]) });
+            for (const key of keysA)
+                if (hasOwn(b, key))
+                    diffAt(a[key], b[key], [...tokens, key], out);
+            for (const key of keysB)
+                if (!hasOwn(a, key))
+                    out.push({ op: "add", path: formatPointer([...tokens, key]), value: cloneJson(b[key]) });
+            return;
+        }
+    }
+    out.push({ op: "replace", path, value: cloneJson(b) });
+}
+function diffArrays(a, b, tokens, out) {
+    let start = 0;
+    while (start < a.length && start < b.length && jsonEqual(a[start], b[start]))
+        start++;
+    let end = 0;
+    while (end < a.length - start && end < b.length - start && jsonEqual(a[a.length - 1 - end], b[b.length - 1 - end]))
+        end++;
+    const middleA = a.length - start - end;
+    const middleB = b.length - start - end;
+    const shared = Math.min(middleA, middleB);
+    for (let i = 0; i < shared; i++)
+        diffAt(a[start + i], b[start + i], [...tokens, start + i], out);
+    // The items after the shared positions: remove from the last one, so each index stays valid
+    for (let i = middleA - 1; i >= shared; i--)
+        out.push({ op: "remove", path: formatPointer([...tokens, start + i]) });
+    for (let i = shared; i < middleB; i++)
+        out.push({ op: "add", path: formatPointer([...tokens, start + i]), value: cloneJson(b[start + i]) });
+}
+/** This function gives a JSON Patch that changes `a` into `b`. Equal values give an empty patch. */
+export function diffJson(a, b) {
+    const out = [];
+    diffAt(a, b, [], out);
+    return out;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./module.js";
+export * from "./types.js";
+export { jsonQuery, jsonPatch, jsonDiff, jsonMerge, jsonValidate } from "./procedures/json/index.js";
+export { yamlParse, yamlStringify } from "./procedures/yaml/index.js";
+export { assertJson, cloneJson, jsonEqual, JsonError, PROTOTYPE_KEYS, formatPointer, escapeToken, type JsonErrorCode } from "./value.js";
+export { parsePointer, lookup, arrayIndex, type Lookup } from "./pointer.js";
+export { parsePath, queryPath, type PathMatch, type PathStep } from "./path.js";
+export { applyPatch } from "./patch.js";
+export { diffJson } from "./diff.js";
+export { mergePatch } from "./merge.js";
+export { validateJson, NOT_EXAMINED, type ValidationIssue, type ValidationResult } from "./schema.js";
+export { parseYaml, stringifyYaml, type YamlParseOptions, type YamlStringifyOptions } from "./yaml.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACzI,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// The root registers nothing: import "<package>/register", or give the module to createRegistry()
+export * from "./module.js";
+export * from "./types.js";
+export { jsonQuery, jsonPatch, jsonDiff, jsonMerge, jsonValidate } from "./procedures/json/index.js";
+export { yamlParse, yamlStringify } from "./procedures/yaml/index.js";
+// The functions behind the procedures, for a program in the same process
+export { assertJson, cloneJson, jsonEqual, JsonError, PROTOTYPE_KEYS, formatPointer, escapeToken } from "./value.js";
+export { parsePointer, lookup, arrayIndex } from "./pointer.js";
+export { parsePath, queryPath } from "./path.js";
+export { applyPatch } from "./patch.js";
+export { diffJson } from "./diff.js";
+export { mergePatch } from "./merge.js";
+export { validateJson, NOT_EXAMINED } from "./schema.js";
+export { parseYaml, stringifyYaml } from "./yaml.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,yEAAyE;AACzE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAsB,MAAM,YAAY,CAAC;AACzI,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAiC,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,YAAY,EAA+C,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAoD,MAAM,WAAW,CAAC"}

package/dist/merge.d.ts

@@ -0,0 +1,14 @@
+/**
+ * JSON Merge Patch (RFC 7386): a patch is a JSON value of the same form as the target.
+ *
+ * - A patch that is an object changes the target member by member. A member with the value null
+ *   removes the key. Another member merges into the key.
+ * - A patch that is not an object replaces the target.
+ *
+ * The merge applies to a copy of the target. A key `__proto__`, `constructor` or `prototype` in
+ * an object of the patch is refused (roadmap R6).
+ */
+import { type JsonValue } from "./value.js";
+/** This function applies a JSON merge patch to a copy of the target and gives the result. */
+export declare function mergePatch(target: JsonValue, patch: JsonValue): JsonValue;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmF,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAmB7H,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CAEzE"}

package/dist/merge.js

@@ -0,0 +1,34 @@
+/**
+ * JSON Merge Patch (RFC 7386): a patch is a JSON value of the same form as the target.
+ *
+ * - A patch that is an object changes the target member by member. A member with the value null
+ *   removes the key. Another member merges into the key.
+ * - A patch that is not an object replaces the target.
+ *
+ * The merge applies to a copy of the target. A key `__proto__`, `constructor` or `prototype` in
+ * an object of the patch is refused (roadmap R6).
+ */
+import { cloneJson, formatPointer, hasOwn, isPlainObject, JsonError, PROTOTYPE_KEYS, put } from "./value.js";
+function mergeAt(target, patch, tokens) {
+    if (!isPlainObject(patch))
+        return cloneJson(patch);
+    const result = isPlainObject(target) ? cloneJson(target) : {};
+    for (const key of Object.keys(patch)) {
+        if (PROTOTYPE_KEYS.has(key)) {
+            throw new JsonError("PROTOTYPE_KEY", `The merge patch has the key "${key}" at "${formatPointer([...tokens, key])}", which reaches a prototype`);
+        }
+        const value = patch[key];
+        if (value === null) {
+            delete result[key];
+        }
+        else {
+            put(result, key, mergeAt(hasOwn(result, key) ? result[key] : undefined, value, [...tokens, key]));
+        }
+    }
+    return result;
+}
+/** This function applies a JSON merge patch to a copy of the target and gives the result. */
+export function mergePatch(target, patch) {
+    return mergeAt(target, patch, []);
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAkB,MAAM,YAAY,CAAC;AAE7H,SAAS,OAAO,CAAC,MAA6B,EAAE,KAAgB,EAAE,MAAgB;IAChF,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,MAAM,GAA8B,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAmC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,eAAe,EAAE,gCAAgC,GAAG,SAAS,aAAa,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;QAClJ,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAc,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,KAAgB;IAC5D,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The procedures of @procedures/json as data. Importing this file registers nothing.
+ *
+ * Scaffold a procedure with: mark procedure new <name> --path packages/json
+ *
+ * Each procedure is pure (`PURE_EFFECTS`): its output comes from its input, and it reads and
+ * changes nothing else (roadmap R39).
+ */
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing.
+ */
+export declare const jsonModule: ProcedureModule;
+export default jsonModule;
+/**
+ * This function registers the procedures of @procedures/json in a registry. The default is the
+ * global registry.
+ */
+export declare function registerJsonProcedures(registry?: ProcedureRegistry): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAmE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAA+B,MAAM,oBAAoB,CAAC;AA2MhL;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,eAQvB,CAAC;eAEY,UAAU;AAEzB;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE7F"}

package/dist/module.js

@@ -0,0 +1,192 @@
+/**
+ * The procedures of @procedures/json as data. Importing this file registers nothing.
+ *
+ * Scaffold a procedure with: mark procedure new <name> --path packages/json
+ *
+ * Each procedure is pure (`PURE_EFFECTS`): its output comes from its input, and it reads and
+ * changes nothing else (roadmap R39).
+ */
+import { z } from "zod";
+import { defineModule, registerModules, PROCEDURE_REGISTRY, PURE_EFFECTS, createProcedure, zodAdapter } from "@procedures/client";
+import { jsonQuery } from "./procedures/json/query.js";
+import { jsonPatch } from "./procedures/json/patch.js";
+import { jsonDiff } from "./procedures/json/diff.js";
+import { jsonMerge } from "./procedures/json/merge.js";
+import { jsonValidate } from "./procedures/json/validate.js";
+import { yamlParse } from "./procedures/yaml/parse.js";
+import { yamlStringify } from "./procedures/yaml/stringify.js";
+// =============================================================================
+// Schemas
+// =============================================================================
+/** A JSON value. The handler examines it, so a key `__proto__` of the data reaches the check. */
+const json = (description) => z.unknown().describe(description);
+const operation = z.object({
+    op: z.enum(["add", "remove", "replace", "move", "copy", "test"]).describe("The operation"),
+    path: z.string().describe("The JSON Pointer of the location"),
+    from: z.string().optional().describe("The JSON Pointer of the source of move and copy"),
+    value: json("The value of add, replace and test").optional(),
+});
+const JsonQueryInputSchema = z.object({
+    value: json("The JSON value to search"),
+    pointer: z.string().optional().describe("A JSON Pointer (RFC 6901), for example /items/0/name. Give pointer or path"),
+    path: z.string().optional().describe("A path query, for example items[*].name or $..id. Give pointer or path"),
+});
+const JsonQueryOutputSchema = z.object({
+    found: z.boolean().describe("True when one or more values match"),
+    value: json("The value of the first match").optional(),
+    matches: z.array(z.object({ pointer: z.string().describe("The JSON Pointer of the match"), value: json("The value of the match") })).describe("Each match, in document order"),
+});
+const JsonPatchInputSchema = z.object({
+    value: json("The JSON value to change"),
+    patch: z.array(operation).describe("The operations of the JSON Patch (RFC 6902), in order"),
+});
+const JsonPatchOutputSchema = z.object({ value: json("The value after the patch") });
+const JsonDiffInputSchema = z.object({
+    from: json("The first JSON value"),
+    to: json("The second JSON value"),
+});
+const JsonDiffOutputSchema = z.object({
+    patch: z.array(operation).describe("The JSON Patch (RFC 6902) that changes from into to"),
+});
+const JsonMergeInputSchema = z.object({
+    target: json("The JSON value to change"),
+    patch: json("The merge patch (RFC 7386): an object of changes, where null removes a key"),
+});
+const JsonMergeOutputSchema = z.object({ value: json("The value after the merge") });
+const JsonValidateInputSchema = z.object({
+    value: json("The JSON value to examine"),
+    schema: json("The JSON Schema: an object or a boolean"),
+});
+const JsonValidateOutputSchema = z.object({
+    valid: z.boolean().describe("True when the check found no problem"),
+    errors: z.array(z.object({ pointer: z.string().describe("The JSON Pointer of the part"), message: z.string().describe("The problem") })).describe("Each problem"),
+    unchecked: z.array(z.string()).describe("The keywords of the schema that the check does not examine. Empty: the verdict is complete"),
+});
+const YamlParseInputSchema = z.object({
+    text: z.string().describe("The YAML text"),
+    all: z.boolean().optional().describe("True: the text can have more than one document, and value is the list of documents"),
+});
+const YamlParseOutputSchema = z.object({ value: json("The JSON value of the text") });
+const YamlStringifyInputSchema = z.object({
+    value: json("The JSON value to write"),
+    indent: z.number().int().min(1).max(8).optional().describe("The spaces of one level of indentation (default: 2)"),
+    lineWidth: z.number().int().min(0).optional().describe("The longest line before a fold. 0: no fold (default: 80)"),
+    sortKeys: z.boolean().optional().describe("True: the keys of each map in alphabetical order"),
+});
+const YamlStringifyOutputSchema = z.object({ text: z.string().describe("The YAML text") });
+// =============================================================================
+// Procedures
+// =============================================================================
+const jsonQueryProcedure = createProcedure()
+    .path(["json", "query"])
+    .input(zodAdapter(JsonQueryInputSchema))
+    .output(zodAdapter(JsonQueryOutputSchema))
+    .meta({
+    description: "Find the values at a JSON Pointer or a path in a JSON value",
+    args: [],
+    shorts: { pointer: "p" },
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => jsonQuery(input))
+    .build();
+const jsonPatchProcedure = createProcedure()
+    .path(["json", "patch"])
+    .input(zodAdapter(JsonPatchInputSchema))
+    .output(zodAdapter(JsonPatchOutputSchema))
+    .meta({
+    description: "Apply an RFC 6902 JSON Patch to a JSON value",
+    args: [],
+    shorts: {},
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => jsonPatch(input))
+    .build();
+const jsonDiffProcedure = createProcedure()
+    .path(["json", "diff"])
+    .input(zodAdapter(JsonDiffInputSchema))
+    .output(zodAdapter(JsonDiffOutputSchema))
+    .meta({
+    description: "Give the RFC 6902 JSON Patch that changes one JSON value into another",
+    args: [],
+    shorts: {},
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => jsonDiff(input))
+    .build();
+const jsonMergeProcedure = createProcedure()
+    .path(["json", "merge"])
+    .input(zodAdapter(JsonMergeInputSchema))
+    .output(zodAdapter(JsonMergeOutputSchema))
+    .meta({
+    description: "Apply an RFC 7386 JSON merge patch to a JSON value",
+    args: [],
+    shorts: {},
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => jsonMerge(input))
+    .build();
+const jsonValidateProcedure = createProcedure()
+    .path(["json", "validate"])
+    .input(zodAdapter(JsonValidateInputSchema))
+    .output(zodAdapter(JsonValidateOutputSchema))
+    .meta({
+    description: "Examine a JSON value against a JSON Schema",
+    args: [],
+    shorts: {},
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => jsonValidate(input))
+    .build();
+const yamlParseProcedure = createProcedure()
+    .path(["yaml", "parse"])
+    .input(zodAdapter(YamlParseInputSchema))
+    .output(zodAdapter(YamlParseOutputSchema))
+    .meta({
+    description: "Parse YAML text into a JSON value",
+    args: ["text"],
+    shorts: { all: "a" },
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => yamlParse(input))
+    .build();
+const yamlStringifyProcedure = createProcedure()
+    .path(["yaml", "stringify"])
+    .input(zodAdapter(YamlStringifyInputSchema))
+    .output(zodAdapter(YamlStringifyOutputSchema))
+    .meta({
+    description: "Write a JSON value as YAML text",
+    args: [],
+    shorts: { indent: "i", sortKeys: "s" },
+    output: "json",
+    effects: PURE_EFFECTS,
+})
+    .handler(async (input) => yamlStringify(input))
+    .build();
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing.
+ */
+export const jsonModule = defineModule("@procedures/json", [
+    jsonQueryProcedure,
+    jsonPatchProcedure,
+    jsonDiffProcedure,
+    jsonMergeProcedure,
+    jsonValidateProcedure,
+    yamlParseProcedure,
+    yamlStringifyProcedure,
+]);
+export default jsonModule;
+/**
+ * This function registers the procedures of @procedures/json in a registry. The default is the
+ * global registry.
+ */
+export function registerJsonProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [jsonModule]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"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"}

package/dist/patch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JSON Patch (RFC 6902): apply a list of operations to a JSON value.
+ *
+ * The operations are `add`, `remove`, `replace`, `move`, `copy` and `test`. The patch applies to
+ * a copy of the value, and all operations apply or none: the first failure throws, and the input
+ * value does not change. A `path` or a `from` that names `__proto__`, `constructor` or
+ * `prototype` is refused (roadmap R6).
+ */
+import { type JsonValue } from "./value.js";
+/** One operation of a JSON Patch. */
+export interface PatchOperation {
+    op: "add" | "remove" | "replace" | "move" | "copy" | "test";
+    path: string;
+    from?: string | undefined;
+    value?: unknown;
+}
+/**
+ * This function applies a JSON Patch to a copy of a value and gives the result. A bad operation,
+ * a location that does not exist and a failed `test` throw a `JsonError` that names the index of
+ * the operation.
+ */
+export declare function applyPatch(value: JsonValue, operations: readonly PatchOperation[]): JsonValue;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAgF,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1H,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2DD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,CAiD7F"}

package/dist/patch.js

@@ -0,0 +1,137 @@
+/**
+ * JSON Patch (RFC 6902): apply a list of operations to a JSON value.
+ *
+ * The operations are `add`, `remove`, `replace`, `move`, `copy` and `test`. The patch applies to
+ * a copy of the value, and all operations apply or none: the first failure throws, and the input
+ * value does not change. A `path` or a `from` that names `__proto__`, `constructor` or
+ * `prototype` is refused (roadmap R6).
+ */
+import { arrayIndex, lookup, parsePointer } from "./pointer.js";
+import { cloneJson, formatPointer, isPlainObject, jsonEqual, JsonError, put, typeName } from "./value.js";
+/** The parent of a location: the container and the last token. */
+function parentOf(document, tokens, fail) {
+    const parentTokens = tokens.slice(0, -1);
+    const found = lookup(document, parentTokens);
+    if (!found.found)
+        fail(`the location ${formatPointer(parentTokens)} does not exist`);
+    const container = found.value;
+    if (container === null || typeof container !== "object")
+        fail(`the location ${formatPointer(parentTokens)} is ${typeName(container)}, not an object or an array`);
+    return { container: container, token: tokens[tokens.length - 1] };
+}
+function add(document, tokens, value, fail) {
+    if (tokens.length === 0)
+        return value;
+    const { container, token } = parentOf(document, tokens, fail);
+    if (Array.isArray(container)) {
+        if (token === "-") {
+            container.push(value);
+            return document;
+        }
+        const index = arrayIndex(token);
+        if (index === undefined || index > container.length)
+            fail(`the array index "${token}" is not 0 to ${container.length} or "-"`);
+        container.splice(index, 0, value);
+        return document;
+    }
+    put(container, token, value);
+    return document;
+}
+function remove(document, tokens, fail) {
+    if (tokens.length === 0)
+        fail("a patch cannot remove the whole value");
+    const { container, token } = parentOf(document, tokens, fail);
+    if (Array.isArray(container)) {
+        const index = arrayIndex(token);
+        if (index === undefined || index >= container.length)
+            fail(`the array index "${token}" does not exist`);
+        const [removed] = container.splice(index, 1);
+        return { document, removed: removed };
+    }
+    if (!Object.prototype.hasOwnProperty.call(container, token))
+        fail(`the location ${formatPointer(tokens)} does not exist`);
+    const removed = container[token];
+    delete container[token];
+    return { document, removed };
+}
+function replace(document, tokens, value, fail) {
+    if (tokens.length === 0)
+        return value;
+    if (!lookup(document, tokens).found)
+        fail(`the location ${formatPointer(tokens)} does not exist`);
+    const { container, token } = parentOf(document, tokens, fail);
+    if (Array.isArray(container))
+        container[arrayIndex(token)] = value;
+    else
+        put(container, token, value);
+    return document;
+}
+/** The value of an operation: present, and JSON. */
+function valueOf(operation, fail) {
+    if (!("value" in operation) || operation.value === undefined)
+        fail(`the operation ${operation.op} needs a value`);
+    return cloneJson(operation.value);
+}
+/**
+ * This function applies a JSON Patch to a copy of a value and gives the result. A bad operation,
+ * a location that does not exist and a failed `test` throw a `JsonError` that names the index of
+ * the operation.
+ */
+export function applyPatch(value, operations) {
+    let document = cloneJson(value);
+    operations.forEach((operation, index) => {
+        const fail = (message, code = "INVALID_PATCH") => {
+            throw new JsonError(code, `Operation ${index} (${operation.op} ${operation.path}): ${message}`);
+        };
+        if (!isPlainObject(operation) || typeof operation.path !== "string")
+            fail("an operation is an object with op and path");
+        const tokens = parsePointer(operation.path, `path of operation ${index}`);
+        const fromTokens = () => {
+            if (typeof operation.from !== "string")
+                fail(`the operation ${operation.op} needs from`);
+            return parsePointer(operation.from, `from of operation ${index}`);
+        };
+        switch (operation.op) {
+            case "add":
+                document = add(document, tokens, valueOf(operation, fail), fail);
+                break;
+            case "remove":
+                document = remove(document, tokens, fail).document;
+                break;
+            case "replace":
+                document = replace(document, tokens, valueOf(operation, fail), fail);
+                break;
+            case "move": {
+                const from = fromTokens();
+                if (from.length === tokens.length && from.every((token, at) => token === tokens[at]))
+                    break;
+                if (from.length < tokens.length && from.every((token, at) => token === tokens[at]))
+                    fail("a value cannot move into itself");
+                const removed = remove(document, from, fail);
+                document = add(removed.document, tokens, removed.removed, fail);
+                break;
+            }
+            case "copy": {
+                const from = fromTokens();
+                const found = lookup(document, from);
+                if (!found.found)
+                    fail(`the location ${formatPointer(from)} does not exist`);
+                document = add(document, tokens, cloneJson(found.value), fail);
+                break;
+            }
+            case "test": {
+                const expected = valueOf(operation, fail);
+                const found = lookup(document, tokens);
+                if (!found.found)
+                    fail(`the location ${operation.path} does not exist`, "TEST_FAILED");
+                if (!jsonEqual(found.value, expected))
+                    fail(`the value is not ${JSON.stringify(expected)}`, "TEST_FAILED");
+                break;
+            }
+            default:
+                fail(`the operation ${JSON.stringify(operation.op)} is not add, remove, replace, move, copy or test`);
+        }
+    });
+    return document;
+}
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"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"}