@valbuild/core 0.18.0 → 0.20.0

package/dist/valbuild-core.esm.js

@@ -1,7 +1,8 @@
-import { _ as _inherits, a as _createSuper, b as _classCallCheck, c as _createClass, d as _defineProperty, e as _typeof, S as Schema, G as GetSchema, g as getValPath, f as _slicedToArray, h as _objectSpread2, i as image, V as VAL_EXTENSION, j as file, k as isFile, F as FILE_REF_PROP, P as Path, l as GetSource, m as isSerializedVal, n as convertFileSource, o as getSchema, p as isVal } from './index-a9235737.esm.js';
-export { F as FILE_REF_PROP, q as GenericSelector, S as Schema, V as VAL_EXTENSION } from './index-a9235737.esm.js';
-import { c as createValPathOfItem, a as array, o as object, u as union, r as richtext$1, b as content, P as PatchError, n as newSelectorProxy, i as isSelector, g as getSource, d as resolvePath, s as splitModuleIdAndModulePath } from './ops-a2a295f8.esm.js';
-export { i as expr } from './index-4abf3a1f.esm.js';
+import { _ as _inherits, a as _createSuper, b as _classCallCheck, c as _createClass, d as _defineProperty, e as _typeof, S as Schema, G as GetSchema, g as getValPath, i as image, V as VAL_EXTENSION, f as convertFileSource, h as file, j as _objectSpread2, k as _slicedToArray, l as isFile, F as FILE_REF_PROP, P as Path, m as GetSource, n as isSerializedVal, o as getSchema, p as isVal } from './index-bccf1907.esm.js';
+export { F as FILE_REF_PROP, q as GenericSelector, S as Schema, V as VAL_EXTENSION } from './index-bccf1907.esm.js';
+import { a as array, o as object, u as union, r as richtext$1, b as record, c as content, P as PatchError, n as newSelectorProxy, d as createValPathOfItem, i as isSelector, g as getSource, e as resolvePath, s as splitModuleIdAndModulePath } from './ops-22b624eb.esm.js';
+import * as marked from 'marked';
+export { i as expr } from './index-5d1ab97c.esm.js';
 import { _ as _createForOfIteratorHelper, i as isErr, a as isOk, e as err, o as ok, r as result } from './result-b96df128.esm.js';
 
 var NumberSchema = /*#__PURE__*/function (_Schema) {
@@ -65,10 +66,12 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   function StringSchema(options) {
     var _this;
     var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var isRaw = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
     _classCallCheck(this, StringSchema);
     _this = _super.call(this);
     _this.options = options;
     _this.opt = opt;
+    _this.isRaw = isRaw;
     return _this;
   }
   _createClass(StringSchema, [{
@@ -96,7 +99,12 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
   }, {
     key: "optional",
     value: function optional() {
-      return new StringSchema(this.options, true);
+      return new StringSchema(this.options, true, this.isRaw);
+    }
+  }, {
+    key: "raw",
+    value: function raw() {
+      return new StringSchema(this.options, this.opt, true);
     }
   }, {
     key: "serialize",
@@ -104,7 +112,8 @@ var StringSchema = /*#__PURE__*/function (_Schema) {
       return {
         type: "string",
         options: this.options,
-        opt: this.opt
+        opt: this.opt,
+        raw: this.isRaw
       };
     }
   }]);
@@ -337,95 +346,6 @@ var keyOf = function keyOf(valModule) {
   return new KeyOfSchema(valModule);
 };
 
-var RecordSchema = /*#__PURE__*/function (_Schema) {
-  _inherits(RecordSchema, _Schema);
-  var _super = _createSuper(RecordSchema);
-  function RecordSchema(item) {
-    var _this;
-    var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-    _classCallCheck(this, RecordSchema);
-    _this = _super.call(this);
-    _this.item = item;
-    _this.opt = opt;
-    return _this;
-  }
-  _createClass(RecordSchema, [{
-    key: "validate",
-    value: function validate(path, src) {
-      var _this2 = this;
-      var error = false;
-      if (this.opt && (src === null || src === undefined)) {
-        return false;
-      }
-      if (_typeof(src) !== "object") {
-        return _defineProperty({}, path, [{
-          message: "Expected 'object', got '".concat(_typeof(src), "'")
-        }]);
-      }
-      if (Array.isArray(src)) {
-        return _defineProperty({}, path, [{
-          message: "Expected 'object', got 'array'"
-        }]);
-      }
-      Object.entries(src).forEach(function (_ref3) {
-        var _ref4 = _slicedToArray(_ref3, 2),
-          key = _ref4[0],
-          elem = _ref4[1];
-        var subPath = createValPathOfItem(path, key);
-        if (!subPath) {
-          error = _this2.appendValidationError(error, path, "Internal error: could not create path at ".concat(!path && typeof path === "string" ? "<empty string>" : path, " at key ").concat(elem),
-          // Should! never happen
-          src);
-        } else {
-          var subError = _this2.item.validate(subPath, elem);
-          if (subError && error) {
-            error = _objectSpread2(_objectSpread2({}, subError), error);
-          } else if (subError) {
-            error = subError;
-          }
-        }
-      });
-      return error;
-    }
-  }, {
-    key: "assert",
-    value: function assert(src) {
-      if (this.opt && (src === null || src === undefined)) {
-        return true;
-      }
-      if (!src) {
-        return false;
-      }
-      for (var _i = 0, _Object$entries = Object.entries(src); _i < _Object$entries.length; _i++) {
-        var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-          _item = _Object$entries$_i[1];
-        if (!this.item.assert(_item)) {
-          return false;
-        }
-      }
-      return _typeof(src) === "object" && !Array.isArray(src);
-    }
-  }, {
-    key: "optional",
-    value: function optional() {
-      return new RecordSchema(this.item, true);
-    }
-  }, {
-    key: "serialize",
-    value: function serialize() {
-      return {
-        type: "record",
-        item: this.item.serialize(),
-        opt: this.opt
-      };
-    }
-  }]);
-  return RecordSchema;
-}(Schema);
-var record = function record(schema) {
-  return new RecordSchema(schema);
-};
-
 // import type { F } from "ts-toolbelt";
 // import { i18n, I18n } from "./schema/future/i18n";
 // import { oneOf } from "./schema/future/oneOf";
@@ -451,18 +371,140 @@ function initSchema() {
   };
 }
 
-function richtext(data) {
-  if (typeof data === "string") {
-    var _ref;
-    return _ref = {}, _defineProperty(_ref, VAL_EXTENSION, "richtext"), _defineProperty(_ref, "type", "root"), _defineProperty(_ref, "children", [{
-      type: "paragraph",
-      children: [{
-        type: "text",
-        text: data
-      }]
-    }]), _ref;
+// export type FontFamily<O extends RichTextOptions> =
+//   O["fontFamily"] extends Record<string, unknown>
+//     ? `font-${keyof O["fontFamily"] & string}`
+//     : never;
+// export type FontSize<O extends RichTextOptions> = O["fontSize"] extends Record<
+//   string,
+//   unknown
+// >
+//   ? `text-${keyof O["fontSize"] & string}`
+//   : never;
+// | FontFamily<O>
+// | FontSize<O>;
+// export type AnchorNode<O extends RichTextOptions> = never; // TODO:
+// O["link"] extends true
+//   ? {
+//       tag: "a";
+//       href: string;
+//       children: [string];
+//     }
+//   : never;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// export type BlockQuoteNode<O extends RichTextOptions> =
+//   O["blockQuote"] extends true
+//     ? { tag: "blockquote"; children: [string] }
+//     : never;
+// TODO: rename to RichTextSelector?
+function parseTokens(tokens) {
+  return tokens.flatMap(function (token) {
+    if (token.type === "heading") {
+      return [{
+        tag: "h".concat(token.depth),
+        children: parseTokens(token.tokens ? token.tokens : [])
+      }];
+    }
+    if (token.type === "paragraph") {
+      return [{
+        tag: "p",
+        children: parseTokens(token.tokens ? token.tokens : [])
+      }];
+    }
+    if (token.type === "strong") {
+      return [{
+        tag: "span",
+        classes: ["bold"],
+        children: parseTokens(token.tokens ? token.tokens : [])
+      }];
+    }
+    if (token.type === "em") {
+      return [{
+        tag: "span",
+        classes: ["italic"],
+        children: parseTokens(token.tokens ? token.tokens : [])
+      }];
+    }
+    if (token.type === "del") {
+      return [{
+        tag: "span",
+        classes: ["line-through"],
+        children: parseTokens(token.tokens ? token.tokens : [])
+      }];
+    }
+    if (token.type === "text") {
+      return [token.text];
+    }
+    if (token.type === "list") {
+      return [{
+        tag: token.ordered ? "ol" : "ul",
+        children: parseTokens(token.items)
+      }];
+    }
+    if (token.type === "list_item") {
+      return [{
+        tag: "li",
+        children: parseTokens(token.tokens ? token.tokens : [])
+      }];
+    }
+    if (token.type === "space") {
+      return [];
+    }
+    if (token.type === "code") {
+      return [{
+        tag: "span",
+        classes: [],
+        children: [token.text]
+      }];
+    }
+    // console.error(
+    //   `Could not parse markdown: unsupported token type: ${token.type}. Found: ${token.raw}`
+    // );
+    return [token.raw];
+  });
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function nodeToTag(node) {
+  if (node[VAL_EXTENSION] === "file") {
+    return node;
   }
-  return _objectSpread2(_objectSpread2({}, data), {}, _defineProperty({}, VAL_EXTENSION, "richtext"));
+  throw Error("Unexpected node: ".concat(JSON.stringify(node)));
+}
+function imgSrcToImgTag(imageSrc) {
+  var _imageSrc$metadata, _imageSrc$metadata2;
+  var converted = convertFileSource(imageSrc);
+  return {
+    tag: "img",
+    src: converted.url,
+    width: (_imageSrc$metadata = imageSrc.metadata) === null || _imageSrc$metadata === void 0 ? void 0 : _imageSrc$metadata.width,
+    height: (_imageSrc$metadata2 = imageSrc.metadata) === null || _imageSrc$metadata2 === void 0 ? void 0 : _imageSrc$metadata2.height
+  };
+}
+function convertRichTextSource(src) {
+  var _ref;
+  return _ref = {}, _defineProperty(_ref, VAL_EXTENSION, "richtext"), _defineProperty(_ref, "children", src.children.map(function (source) {
+    if (VAL_EXTENSION in source && source[VAL_EXTENSION] === "file") {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      return imgSrcToImgTag(source);
+    }
+    return source;
+  })), _ref;
+}
+function richtext(templateStrings) {
+  var _ref2;
+  for (var _len = arguments.length, expr = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    expr[_key - 1] = arguments[_key];
+  }
+  return _ref2 = {}, _defineProperty(_ref2, VAL_EXTENSION, "richtext"), _defineProperty(_ref2, "children", templateStrings.flatMap(function (templateString, i) {
+    var lex = marked.lexer(templateString, {
+      gfm: true
+    });
+    if (expr[i]) {
+      return parseTokens(lex).concat(nodeToTag(expr[i]));
+    }
+    return parseTokens(lex);
+  })), _ref2;
 }
 
 // import { i18n, I18n } from "./source/future/i18n";
@@ -600,6 +642,14 @@ function derefPatch(patch, document, ops) {
         } else {
           dereferencedPatch.push(op);
         }
+      } else if (op.op === "file") {
+        if (op.path[0] !== "public") {
+          return err(new PatchError("Path must start with public"));
+        }
+        if (typeof op.value !== "string") {
+          return err(new PatchError("File operation must have a value that is typeof string. Found: ".concat(_typeof(op.value))));
+        }
+        fileUpdates["/".concat(op.path.join("/"))] = op.value;
       } else {
         var _maybeDerefRes = derefPath(op.path);
         if (isErr(_maybeDerefRes)) {
@@ -1093,6 +1143,32 @@ function _asyncToGenerator(fn) {
   };
 }
 
+var getSHA256Hash = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(bits) {
+    var hashBuffer, hashArray, hash;
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _context.next = 2;
+          return crypto.subtle.digest("SHA-256", bits);
+        case 2:
+          hashBuffer = _context.sent;
+          hashArray = Array.from(new Uint8Array(hashBuffer));
+          hash = hashArray.map(function (item) {
+            return item.toString(16).padStart(2, "0");
+          }).join("");
+          return _context.abrupt("return", hash);
+        case 6:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getSHA256Hash(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+
 // TODO: move this to internal, only reason this is here is that react, ui and server all depend on it
 var ValApi = /*#__PURE__*/function () {
   function ValApi(host) {
@@ -1202,6 +1278,7 @@ function _parse() {
 
 var Internal = {
   convertFileSource: convertFileSource,
+  convertRichTextSource: convertRichTextSource,
   getSchema: getSchema,
   getValPath: getValPath,
   getVal: getVal,
@@ -1210,6 +1287,7 @@ var Internal = {
   splitModuleIdAndModulePath: splitModuleIdAndModulePath,
   isVal: isVal,
   createValPathOfItem: createValPathOfItem,
+  getSHA256Hash: getSHA256Hash,
   createPatchJSONPath: function createPatchJSONPath(modulePath) {
     return "/".concat(modulePath.split(".").map(function (segment) {
       return JSON.parse(segment);

package/expr/dist/valbuild-core-expr.esm.js

@@ -1,3 +1,3 @@
-export { e as evaluate, p as parse } from '../../dist/index-4abf3a1f.esm.js';
-export { C as Call, E as Expr, N as NilSym, s as StringLiteral, t as StringTemplate, r as Sym } from '../../dist/index-a9235737.esm.js';
+export { e as evaluate, p as parse } from '../../dist/index-5d1ab97c.esm.js';
+export { C as Call, E as Expr, N as NilSym, s as StringLiteral, t as StringTemplate, r as Sym } from '../../dist/index-bccf1907.esm.js';
 import '../../dist/result-b96df128.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/core",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "private": false,
   "description": "Val - supercharged hard-coded content",
   "scripts": {
@@ -41,5 +41,8 @@
   },
   "devDependencies": {
     "ts-toolbelt": "^9.6.0"
+  },
+  "dependencies": {
+    "marked": "^9.0.3"
   }
 }

package/patch/dist/valbuild-core-patch.cjs.dev.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var index = require('../../dist/index-a6e642dd.cjs.dev.js');
 var result = require('../../dist/result-48320acd.cjs.dev.js');
 var util = require('../../dist/util-b213092b.cjs.dev.js');
-var ops = require('../../dist/ops-f3015423.cjs.dev.js');
+var ops = require('../../dist/ops-b0a33248.cjs.dev.js');
 
 function isNotRoot(path) {
   return result.isNonEmpty(path);
@@ -350,6 +350,7 @@ function isProperPathPrefix(prefix, path) {
 function parseOperation(operation) {
   var path = parseJSONPointer(operation.path);
   switch (operation.op) {
+    case "file":
     case "add":
     case "replace":
     case "test":
@@ -431,6 +432,10 @@ function apply(document, ops$1, op) {
         }
         return result.ok(document);
       }
+    case "file":
+      {
+        return result.err(new ops.PatchError("Cannot apply a file patch here"));
+      }
   }
 }
 function applyPatch(document, ops, patch) {

package/patch/dist/valbuild-core-patch.cjs.prod.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var index = require('../../dist/index-8706c87e.cjs.prod.js');
 var result = require('../../dist/result-26f67b40.cjs.prod.js');
 var util = require('../../dist/util-030d8a1f.cjs.prod.js');
-var ops = require('../../dist/ops-0d09f8ee.cjs.prod.js');
+var ops = require('../../dist/ops-def81fc3.cjs.prod.js');
 
 function isNotRoot(path) {
   return result.isNonEmpty(path);
@@ -350,6 +350,7 @@ function isProperPathPrefix(prefix, path) {
 function parseOperation(operation) {
   var path = parseJSONPointer(operation.path);
   switch (operation.op) {
+    case "file":
     case "add":
     case "replace":
     case "test":
@@ -431,6 +432,10 @@ function apply(document, ops$1, op) {
         }
         return result.ok(document);
       }
+    case "file":
+      {
+        return result.err(new ops.PatchError("Cannot apply a file patch here"));
+      }
   }
 }
 function applyPatch(document, ops, patch) {

package/patch/dist/valbuild-core-patch.esm.js

@@ -1,8 +1,8 @@
-import { e as _typeof, f as _slicedToArray, c as _createClass, b as _classCallCheck, u as _toConsumableArray } from '../../dist/index-a9235737.esm.js';
+import { e as _typeof, k as _slicedToArray, c as _createClass, b as _classCallCheck, u as _toConsumableArray } from '../../dist/index-bccf1907.esm.js';
 import { f as isNonEmpty, e as err, o as ok, m as map, g as flatMap, i as isErr, h as flatMapReduce, j as filterOrElse, k as mapErr, l as map$1, n as all, p as flatten, q as allT } from '../../dist/result-b96df128.esm.js';
 import { p as pipe } from '../../dist/util-18613e99.esm.js';
-import { P as PatchError, s as splitModuleIdAndModulePath } from '../../dist/ops-a2a295f8.esm.js';
-export { P as PatchError } from '../../dist/ops-a2a295f8.esm.js';
+import { P as PatchError, s as splitModuleIdAndModulePath } from '../../dist/ops-22b624eb.esm.js';
+export { P as PatchError } from '../../dist/ops-22b624eb.esm.js';
 
 function isNotRoot(path) {
   return isNonEmpty(path);
@@ -347,6 +347,7 @@ function isProperPathPrefix(prefix, path) {
 function parseOperation(operation) {
   var path = parseJSONPointer(operation.path);
   switch (operation.op) {
+    case "file":
     case "add":
     case "replace":
     case "test":
@@ -428,6 +429,10 @@ function apply(document, ops, op) {
         }
         return ok(document);
       }
+    case "file":
+      {
+        return err(new PatchError("Cannot apply a file patch here"));
+      }
   }
 }
 function applyPatch(document, ops, patch) {

package/src/getSha256.ts

@@ -0,0 +1,8 @@
+export const getSHA256Hash = async (bits: Uint8Array) => {
+  const hashBuffer = await crypto.subtle.digest("SHA-256", bits);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  const hash = hashArray
+    .map((item) => item.toString(16).padStart(2, "0"))
+    .join("");
+  return hash;
+};

package/src/index.ts

@@ -5,13 +5,25 @@ export type { ValModule, SerializedModule } from "./module";
 export type { SourceObject, SourcePrimitive, Source } from "./source";
 export type { FileSource } from "./source/file";
 export type {
-  RichTextSource,
-  RichText,
-  TextNode,
-  ParagraphNode,
+  AnyRichTextOptions,
+  Bold,
+  Classes,
   HeadingNode,
+  ImageNode,
+  Italic,
+  LineThrough,
   ListItemNode,
-  ListNode,
+  OrderedListNode,
+  ParagraphNode,
+  RichText,
+  RichTextNode,
+  RichTextOptions,
+  RichTextSource,
+  RichTextSourceNode,
+  RootNode,
+  SourceNode,
+  SpanNode,
+  UnorderedListNode,
 } from "./source/richtext";
 export {
   type Val,
@@ -44,6 +56,8 @@ import { createValPathOfItem } from "./selector/SelectorProxy";
 import { getVal } from "./future/fetchVal";
 import { Json } from "./Json";
 import { SerializedSchema } from "./schema";
+import { convertRichTextSource } from "./source/richtext";
+import { getSHA256Hash } from "./getSha256";
 export { ValApi } from "./ValApi";
 
 export type ApiTreeResponse = {
@@ -68,6 +82,7 @@ export type ApiPatchResponse = Record<ModuleId, string[]>;
 
 const Internal = {
   convertFileSource,
+  convertRichTextSource,
   getSchema,
   getValPath,
   getVal,
@@ -76,6 +91,7 @@ const Internal = {
   splitModuleIdAndModulePath,
   isVal,
   createValPathOfItem,
+  getSHA256Hash,
   createPatchJSONPath: (modulePath: ModulePath) =>
     `/${modulePath
       .split(".")

package/src/module.ts

@@ -21,7 +21,8 @@ import {
   SerializedImageSchema,
 } from "./schema/image";
 import { FileSource } from "./source/file";
-import { RichText } from "./source/richtext";
+import { AnyRichTextOptions, RichText } from "./source/richtext";
+import { RecordSchema, SerializedRecordSchema } from "./schema/record";
 
 const brand = Symbol("ValModule");
 export type ValModule<T extends SelectorSource> = SelectorOf<T> &
@@ -94,6 +95,15 @@ function isObjectSchema(
   );
 }
 
+function isRecordSchema(
+  schema: Schema<SelectorSource> | SerializedSchema
+): schema is RecordSchema<Schema<SelectorSource>> | SerializedRecordSchema {
+  return (
+    schema instanceof RecordSchema ||
+    (typeof schema === "object" && "type" in schema && schema.type === "record")
+  );
+}
+
 function isArraySchema(
   schema: Schema<SelectorSource> | SerializedSchema
 ): schema is ArraySchema<Schema<SelectorSource>> | SerializedArraySchema {
@@ -126,7 +136,7 @@ function isUnionSchema(
 function isRichTextSchema(
   schema: Schema<SelectorSource> | SerializedSchema
 ): schema is
-  | Schema<RichText> // TODO: RichTextSchema
+  | Schema<RichText<AnyRichTextOptions>> // TODO: RichTextSchema
   | SerializedRichTextSchema {
   return (
     schema instanceof RichTextSchema ||
@@ -192,6 +202,27 @@ export function resolvePath(
       }
       resolvedSource = resolvedSource[part];
       resolvedSchema = resolvedSchema.item;
+    } else if (isRecordSchema(resolvedSchema)) {
+      if (typeof part !== "string") {
+        throw Error(
+          `Invalid path: record schema ${resolvedSchema} must have path: ${part} as string`
+        );
+      }
+      if (
+        typeof resolvedSource !== "object" &&
+        !Array.isArray(resolvedSource)
+      ) {
+        throw Error(
+          `Schema type error: expected source to be type of record, but got ${typeof resolvedSource}`
+        );
+      }
+      if (!resolvedSource[part]) {
+        throw Error(
+          `Invalid path: record source did not have key ${part} from path: ${path}`
+        );
+      }
+      resolvedSource = resolvedSource[part];
+      resolvedSchema = resolvedSchema.item;
     } else if (isObjectSchema(resolvedSchema)) {
       if (typeof resolvedSource !== "object") {
         throw Error(

package/src/patch/deref.ts

@@ -3,6 +3,7 @@ import { result } from "../fp";
 import { isRemote, REMOTE_REF_PROP } from "../source/future/remote";
 import { Ops, PatchError } from "./ops";
 import { Patch } from "./patch";
+import { Operation } from "./operation";
 
 function derefPath(
   path: string[]
@@ -41,7 +42,7 @@ export type DerefPatchResult = {
 };
 
 export function derefPatch<D, E>(
-  patch: Patch,
+  patch: Operation[],
   document: D,
   ops: Ops<D, E>
 ): result.Result<DerefPatchResult, E | PatchError> {
@@ -107,6 +108,18 @@ export function derefPatch<D, E>(
       } else {
         dereferencedPatch.push(op);
       }
+    } else if (op.op === "file") {
+      if (op.path[0] !== "public") {
+        return result.err(new PatchError(`Path must start with public`));
+      }
+      if (typeof op.value !== "string") {
+        return result.err(
+          new PatchError(
+            `File operation must have a value that is typeof string. Found: ${typeof op.value}`
+          )
+        );
+      }
+      fileUpdates[`/${op.path.join("/")}`] = op.value;
     } else {
       const maybeDerefRes = derefPath(op.path);
       if (result.isErr(maybeDerefRes)) {

package/src/patch/operation.ts

@@ -33,6 +33,11 @@ export type OperationJSON =
       op: "test";
       path: string;
       value: JSONValue;
+    }
+  | {
+      op: "file";
+      path: string;
+      value: JSONValue;
     };
 
 /**
@@ -71,4 +76,9 @@ export type Operation =
       op: "test";
       path: string[];
       value: JSONValue;
+    }
+  | {
+      op: "file";
+      path: string[];
+      value: JSONValue;
     };

package/src/patch/parse.ts

@@ -95,6 +95,7 @@ export function parseOperation(
   const path = parseJSONPointer(operation.path);
 
   switch (operation.op) {
+    case "file":
     case "add":
     case "replace":
     case "test":

package/src/patch/patch.ts

@@ -27,6 +27,9 @@ function apply<T, E>(
       }
       return result.ok(document);
     }
+    case "file": {
+      return result.err(new PatchError("Cannot apply a file patch here"));
+    }
   }
 }