@sanity/client 6.7.1-canary.4 → 6.7.1-canary.6

package/README.md

@@ -656,6 +656,12 @@ function useContentSourceMap(resultSourceMap: ContentSourceMapping): unknown {
 useContentSourceMap(resultSourceMap)
 ```
 
+#### Creating Studio edit intent links
+
+In general
+
+With arrays, and keyed array items.
+
 ### Listening to queries
 
 ```js

package/dist/csm.cjs

@@ -68,11 +68,115 @@ function parseJsonPath(path) {
   }
   return parsed;
 }
-function createEditIntentLink(studioUrl, _ref, path) {
+function resolveMapping(resultPath, csm) {
+  if (!(csm == null ? void 0 : csm.mappings)) {
+    return void 0;
+  }
+  const resultJsonPath = jsonPath(resultPath);
+  if (csm.mappings[resultJsonPath] !== void 0) {
+    return [csm.mappings[resultJsonPath], resultJsonPath, ""];
+  }
+  const mappings = Object.entries(csm.mappings).filter(_ref => {
+    let [key] = _ref;
+    return resultJsonPath.startsWith(key);
+  }).sort((_ref2, _ref3) => {
+    let [key1] = _ref2;
+    let [key2] = _ref3;
+    return key2.length - key1.length;
+  });
+  if (mappings.length == 0) {
+    return void 0;
+  }
+  const [matchedPath, mapping] = mappings[0];
+  const pathSuffix = resultJsonPath.substring(matchedPath.length);
+  return [mapping, matchedPath, pathSuffix];
+}
+function isArray(value) {
+  return value !== null && Array.isArray(value);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function walkMap(value, mappingFn) {
+  let path = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+  if (isArray(value)) {
+    return value.map((v, idx) => {
+      if (isRecord(v)) {
+        const key = v["_key"];
+        if (typeof key === "string") {
+          return walkMap(v, mappingFn, path.concat({
+            key,
+            index: idx
+          }));
+        }
+      }
+      return walkMap(v, mappingFn, path.concat(idx));
+    });
+  }
+  if (isRecord(value)) {
+    return Object.fromEntries(Object.entries(value).map(_ref4 => {
+      let [k, v] = _ref4;
+      return [k, walkMap(v, mappingFn, path.concat(k))];
+    }));
+  }
+  return mappingFn(value, path);
+}
+const defaultUpdateFunction = changed => changed;
+function applySourceDocuments(result, resultSourceMap, getCachedDocument) {
+  let updateFn = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : defaultUpdateFunction;
+  if (!resultSourceMap) return result;
+  return walkMap(result, (value, path) => {
+    var _a;
+    const resolveMappingResult = resolveMapping(path, resultSourceMap);
+    if (!resolveMappingResult) {
+      return value;
+    }
+    const [mapping,, pathSuffix] = resolveMappingResult;
+    if (mapping.type !== "value") {
+      return value;
+    }
+    if (mapping.source.type !== "documentValue") {
+      return value;
+    }
+    const sourceDocument = resultSourceMap.documents[mapping.source.document];
+    const sourcePath = resultSourceMap.paths[mapping.source.path];
+    if (sourceDocument) {
+      const cachedDocument = getCachedDocument(sourceDocument);
+      if (!cachedDocument) {
+        return value;
+      }
+      const parsedPath = parseJsonPath(sourcePath + pathSuffix);
+      const changedValue = cachedDocument ? (_a = getField(cachedDocument, parsedPath)) != null ? _a : value : value;
+      return value === changedValue ? value : updateFn(changedValue, {
+        cachedDocument,
+        previousValue: value,
+        sourceDocument,
+        sourcePath: parsedPath
+      });
+    }
+    return value;
+  });
+}
+function getField(obj, path) {
+  let value = obj;
+  for (const segment of path) {
+    if (typeof segment === "string") {
+      value = value[segment];
+    } else {
+      const match = typeof segment === "object" ? value.find(item => item._key === segment.key) : value[segment];
+      value = match || null;
+    }
+    if (value === null || value === void 0) {
+      break;
+    }
+  }
+  return value;
+}
+function createEditIntentLink(studioUrl, _ref5, path) {
   let {
     _id,
     _type
-  } = _ref;
+  } = _ref5;
   const _studioUrl = studioUrl.replace(/\/$/, "");
   const _path = encodeJsonPathToUriComponent(path);
   return "".concat(_studioUrl, "/intent/edit/id=").concat(_id, ";type=").concat(_type, ";path=").concat(_path);
@@ -81,15 +185,6 @@ function encodeJsonPathToUriComponent(path) {
   const sourcePath = Array.isArray(path) ? path : parseJsonPath(path);
   return encodeURIComponent(sourcePath.map((key, i) => typeof key === "number" ? "[".concat(key, "]") : i > 0 ? ".".concat(key) : key).join(""));
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function isArray(value) {
-  return value !== null && Array.isArray(value);
-}
-function encode(result, csm, encoder, options) {
-  return encodeIntoResult(result, csm, encoder, options);
-}
 function encodeIntoResult(result, csm, encoder, options) {
   return walkMap(result, (value, path) => {
     if (typeof value !== "string") {
@@ -117,50 +212,10 @@ function encodeIntoResult(result, csm, encoder, options) {
     return encoder(value, sourceDocument, parseJsonPath(sourcePath + pathSuffix));
   });
 }
-function walkMap(value, mappingFn) {
-  let path = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
-  if (isArray(value)) {
-    return value.map((v, idx) => {
-      if (isRecord(v)) {
-        const key = v["_key"];
-        if (typeof key === "string") {
-          return walkMap(v, mappingFn, path.concat({
-            key,
-            index: idx
-          }));
-        }
-      }
-      return walkMap(v, mappingFn, path.concat(idx));
-    });
-  }
-  if (isRecord(value)) {
-    return Object.fromEntries(Object.entries(value).map(_ref2 => {
-      let [k, v] = _ref2;
-      return [k, walkMap(v, mappingFn, path.concat(k))];
-    }));
-  }
-  return mappingFn(value, path);
-}
-function resolveMapping(resultPath, csm) {
-  const resultJsonPath = jsonPath(resultPath);
-  if (csm.mappings[resultJsonPath] !== void 0) {
-    return [csm.mappings[resultJsonPath], resultJsonPath, ""];
-  }
-  const mappings = Object.entries(csm.mappings).filter(_ref3 => {
-    let [key] = _ref3;
-    return resultJsonPath.startsWith(key);
-  }).sort((_ref4, _ref5) => {
-    let [key1] = _ref4;
-    let [key2] = _ref5;
-    return key2.length - key1.length;
-  });
-  if (mappings.length == 0) {
-    return void 0;
-  }
-  const [matchedPath, mapping] = mappings[0];
-  const pathSuffix = resultJsonPath.substring(matchedPath.length);
-  return [mapping, matchedPath, pathSuffix];
+function encode(result, csm, encoder, options) {
+  return encodeIntoResult(result, csm, encoder, options);
 }
+exports.applySourceDocuments = applySourceDocuments;
 exports.createEditIntentLink = createEditIntentLink;
 exports.encode = encode;
 exports.encodeIntoResult = encodeIntoResult;

package/dist/csm.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"csm.cjs","sources":["../src/csm/jsonpath.ts","../src/csm/editIntent.ts","../src/csm/sourcemap.ts"],"sourcesContent":["import type {PathSegment} from './types'\n\nconst ESCAPE: Record<string, string> = {\n  '\\f': '\\\\f',\n  '\\n': '\\\\n',\n  '\\r': '\\\\r',\n  '\\t': '\\\\t',\n  \"'\": \"\\\\'\",\n  '\\\\': '\\\\\\\\',\n}\n\nconst UNESCAPE: Record<string, string> = {\n  '\\\\f': '\\f',\n  '\\\\n': '\\n',\n  '\\\\r': '\\r',\n  '\\\\t': '\\t',\n  \"\\\\'\": \"'\",\n  '\\\\\\\\': '\\\\',\n}\n\n/** @internal */\nexport function jsonPath(\n  path: PathSegment[],\n  opts?: {\n    keyArraySelectors: boolean\n  },\n): string {\n  return `$${path\n    .map((segment) => {\n      if (typeof segment === 'string') {\n        const escapedKey = segment.replace(/[\\f\\n\\r\\t'\\\\]/g, (match) => {\n          return ESCAPE[match]\n        })\n        return `['${escapedKey}']`\n      }\n\n      if (typeof segment === 'number') {\n        return `[${segment}]`\n      }\n\n      if (opts?.keyArraySelectors && segment.key !== '') {\n        const escapedKey = segment.key.replace(/['\\\\]/g, (match) => {\n          return ESCAPE[match]\n        })\n        return `[?(@._key=='${escapedKey}')]`\n      }\n\n      return `[${segment.index}]`\n    })\n    .join('')}`\n}\n\n/** @internal */\nexport function parseJsonPath(path: string): PathSegment[] {\n  const parsed: PathSegment[] = []\n\n  const parseRe = /\\['(.*?)'\\]|\\[(\\d+)\\]|\\[\\?\\(@\\._key=='(.*?)'\\)\\]/g\n  let match: RegExpExecArray | null\n\n  while ((match = parseRe.exec(path)) !== null) {\n    if (match[1] !== undefined) {\n      const key = match[1].replace(/\\\\(\\\\|f|n|r|t|')/g, (m) => {\n        return UNESCAPE[m]\n      })\n\n      parsed.push(key)\n      continue\n    }\n\n    if (match[2] !== undefined) {\n      parsed.push(parseInt(match[2], 10))\n      continue\n    }\n\n    if (match[3] !== undefined) {\n      const key = match[3].replace(/\\\\(\\\\')/g, (m) => {\n        return UNESCAPE[m]\n      })\n\n      parsed.push({\n        key,\n        index: -1,\n      })\n      continue\n    }\n  }\n\n  return parsed\n}\n","import type {ContentSourceMapDocuments} from '../types'\nimport {parseJsonPath} from './jsonpath'\nimport type {PathSegment, StudioUrl} from './types'\n\n/** @public */\nexport type EditIntentLink = `/intent/edit/id=${string};type=${string};path=${string}`\n\n/** @public */\nexport function createEditIntentLink(\n  studioUrl: StudioUrl,\n  {_id, _type}: ContentSourceMapDocuments[number],\n  path: string | PathSegment[],\n): `${StudioUrl}${EditIntentLink}` {\n  const _studioUrl = studioUrl.replace(/\\/$/, '')\n  const _path = encodeJsonPathToUriComponent(path)\n  return `${_studioUrl}/intent/edit/id=${_id};type=${_type};path=${_path}`\n}\n\n/** @public */\nexport function encodeJsonPathToUriComponent(path: string | PathSegment[]): string {\n  const sourcePath = Array.isArray(path) ? path : parseJsonPath(path)\n  return encodeURIComponent(\n    sourcePath\n      .map((key, i) => (typeof key === 'number' ? `[${key}]` : i > 0 ? `.${key}` : key))\n      .join(''),\n  )\n}\n","import type {ContentSourceMap, ContentSourceMapDocuments, ContentSourceMapMapping} from '../types'\nimport {jsonPath, parseJsonPath} from './jsonpath'\nimport type {PathSegment} from './types'\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null\n}\n\nfunction isArray(value: unknown): value is Array<unknown> {\n  return value !== null && Array.isArray(value)\n}\n\n/** @alpha */\nexport type Encoder<E> = (\n  value: string,\n  sourceDocument: ContentSourceMapDocuments[number],\n  path: PathSegment[],\n) => E\n\n/** @alpha */\nexport function encode<R, E>(\n  result: R,\n  csm: ContentSourceMap,\n  encoder: Encoder<E>,\n  options?: {keyArraySelectors: boolean},\n): R {\n  return encodeIntoResult(result, csm, encoder, options) as R\n}\n\n/** @alpha */\nexport function encodeIntoResult<R>(\n  result: R,\n  csm: ContentSourceMap,\n  encoder: Encoder<unknown>,\n  options?: {keyArraySelectors: boolean},\n): ReturnType<Encoder<unknown>> {\n  return walkMap(result, (value, path) => {\n    // Only map strings, we could extend this in the future to support other types like integers...\n    if (typeof value !== 'string') {\n      return value\n    }\n\n    const resolveMappingResult = resolveMapping(path, csm)\n    if (!resolveMappingResult) {\n      return value\n    }\n\n    const [mapping, matchedPath, pathSuffix] = resolveMappingResult\n    if (mapping.type !== 'value') {\n      return value\n    }\n\n    if (mapping.source.type !== 'documentValue') {\n      return value\n    }\n\n    const sourceDocument = csm.documents[mapping.source.document!]\n    const sourcePath = csm.paths[mapping.source.path]\n\n    if (options?.keyArraySelectors) {\n      const matchPathSegments = parseJsonPath(matchedPath)\n      const sourcePathSegments = parseJsonPath(sourcePath)\n      const fullSourceSegments = sourcePathSegments.concat(path.slice(matchPathSegments.length))\n\n      return encoder(value, sourceDocument, fullSourceSegments)\n    }\n\n    return encoder(value, sourceDocument, parseJsonPath(sourcePath + pathSuffix))\n  })\n}\n\n/** @alpha */\nexport type WalkMapFn = (value: unknown, path: PathSegment[]) => unknown\n\n/** generic way to walk a nested object or array and apply a mapping function to each value\n * @alpha\n */\nexport function walkMap(value: unknown, mappingFn: WalkMapFn, path: PathSegment[] = []): unknown {\n  if (isArray(value)) {\n    return value.map((v, idx) => {\n      if (isRecord(v)) {\n        const key = v['_key']\n        if (typeof key === 'string') {\n          return walkMap(v, mappingFn, path.concat({key, index: idx}))\n        }\n      }\n\n      return walkMap(v, mappingFn, path.concat(idx))\n    })\n  }\n\n  if (isRecord(value)) {\n    return Object.fromEntries(\n      Object.entries(value).map(([k, v]) => [k, walkMap(v, mappingFn, path.concat(k))]),\n    )\n  }\n\n  return mappingFn(value, path)\n}\n\n/** @alpha */\nexport function resolveMapping(\n  resultPath: PathSegment[],\n  csm: ContentSourceMap,\n): [ContentSourceMapMapping, string, string] | undefined {\n  const resultJsonPath = jsonPath(resultPath)\n\n  if (csm.mappings[resultJsonPath] !== undefined) {\n    return [csm.mappings[resultJsonPath], resultJsonPath, '']\n  }\n\n  const mappings = Object.entries(csm.mappings)\n    .filter(([key]) => resultJsonPath.startsWith(key))\n    .sort(([key1], [key2]) => key2.length - key1.length)\n\n  if (mappings.length == 0) {\n    return undefined\n  }\n\n  const [matchedPath, mapping] = mappings[0]\n  const pathSuffix = resultJsonPath.substring(matchedPath.length)\n  return [mapping, matchedPath, pathSuffix]\n}\n"],"names":["ESCAPE","UNESCAPE","jsonPath","path","opts","concat","map","segment","escapedKey","replace","match","keyArraySelectors","key","index","join","parseJsonPath","parsed","parseRe","exec","m","push","parseInt","createEditIntentLink","studioUrl","_ref","_id","_type","_studioUrl","_path","encodeJsonPathToUriComponent","sourcePath","Array","isArray","encodeURIComponent","i","isRecord","value","encode","result","csm","encoder","options","encodeIntoResult","walkMap","resolveMappingResult","resolveMapping","mapping","matchedPath","pathSuffix","type","source","sourceDocument","documents","document","paths","matchPathSegments","sourcePathSegments","fullSourceSegments","slice","length","mappingFn","arguments","undefined","v","idx","Object","fromEntries","entries","_ref2","k","resultPath","resultJsonPath","mappings","filter","_ref3","startsWith","sort","_ref4","_ref5","key1","key2","substring"],"mappings":"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"}
+{"version":3,"file":"csm.cjs","sources":["../src/csm/jsonpath.ts","../src/csm/resolveMapping.ts","../src/csm/isArray.ts","../src/csm/isRecord.ts","../src/csm/walkMap.ts","../src/csm/applySourceDocuments.ts","../src/csm/editIntent.ts","../src/csm/encodeIntoResult.ts","../src/csm/encode.ts"],"sourcesContent":["import type {PathSegment} from './types'\n\nconst ESCAPE: Record<string, string> = {\n  '\\f': '\\\\f',\n  '\\n': '\\\\n',\n  '\\r': '\\\\r',\n  '\\t': '\\\\t',\n  \"'\": \"\\\\'\",\n  '\\\\': '\\\\\\\\',\n}\n\nconst UNESCAPE: Record<string, string> = {\n  '\\\\f': '\\f',\n  '\\\\n': '\\n',\n  '\\\\r': '\\r',\n  '\\\\t': '\\t',\n  \"\\\\'\": \"'\",\n  '\\\\\\\\': '\\\\',\n}\n\n/**\n * @internal\n */\nexport function jsonPath(\n  path: PathSegment[],\n  opts?: {\n    keyArraySelectors: boolean\n  },\n): string {\n  return `$${path\n    .map((segment) => {\n      if (typeof segment === 'string') {\n        const escapedKey = segment.replace(/[\\f\\n\\r\\t'\\\\]/g, (match) => {\n          return ESCAPE[match]\n        })\n        return `['${escapedKey}']`\n      }\n\n      if (typeof segment === 'number') {\n        return `[${segment}]`\n      }\n\n      if (opts?.keyArraySelectors && segment.key !== '') {\n        const escapedKey = segment.key.replace(/['\\\\]/g, (match) => {\n          return ESCAPE[match]\n        })\n        return `[?(@._key=='${escapedKey}')]`\n      }\n\n      return `[${segment.index}]`\n    })\n    .join('')}`\n}\n\n/**\n * @internal\n */\nexport function parseJsonPath(path: string): PathSegment[] {\n  const parsed: PathSegment[] = []\n\n  const parseRe = /\\['(.*?)'\\]|\\[(\\d+)\\]|\\[\\?\\(@\\._key=='(.*?)'\\)\\]/g\n  let match: RegExpExecArray | null\n\n  while ((match = parseRe.exec(path)) !== null) {\n    if (match[1] !== undefined) {\n      const key = match[1].replace(/\\\\(\\\\|f|n|r|t|')/g, (m) => {\n        return UNESCAPE[m]\n      })\n\n      parsed.push(key)\n      continue\n    }\n\n    if (match[2] !== undefined) {\n      parsed.push(parseInt(match[2], 10))\n      continue\n    }\n\n    if (match[3] !== undefined) {\n      const key = match[3].replace(/\\\\(\\\\')/g, (m) => {\n        return UNESCAPE[m]\n      })\n\n      parsed.push({\n        key,\n        index: -1,\n      })\n      continue\n    }\n  }\n\n  return parsed\n}\n","import {jsonPath} from './jsonpath'\nimport type {ContentSourceMap, ContentSourceMapMapping, PathSegment} from './types'\n\n/**\n * @alpha\n */\nexport function resolveMapping(\n  resultPath: PathSegment[],\n  csm?: ContentSourceMap,\n): [ContentSourceMapMapping, string, string] | undefined {\n  if (!csm?.mappings) {\n    return undefined\n  }\n  const resultJsonPath = jsonPath(resultPath)\n\n  if (csm.mappings[resultJsonPath] !== undefined) {\n    return [csm.mappings[resultJsonPath], resultJsonPath, '']\n  }\n\n  const mappings = Object.entries(csm.mappings)\n    .filter(([key]) => resultJsonPath.startsWith(key))\n    .sort(([key1], [key2]) => key2.length - key1.length)\n\n  if (mappings.length == 0) {\n    return undefined\n  }\n\n  const [matchedPath, mapping] = mappings[0]\n  const pathSuffix = resultJsonPath.substring(matchedPath.length)\n  return [mapping, matchedPath, pathSuffix]\n}\n","export function isArray(value: unknown): value is Array<unknown> {\n  return value !== null && Array.isArray(value)\n}\n","export function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null\n}\n","import {isArray} from './isArray'\nimport {isRecord} from './isRecord'\nimport type {PathSegment} from './types'\n\n/**\n * @alpha\n */\nexport type WalkMapFn = (value: unknown, path: PathSegment[]) => unknown\n\n/**\n * generic way to walk a nested object or array and apply a mapping function to each value\n * @alpha\n */\nexport function walkMap(value: unknown, mappingFn: WalkMapFn, path: PathSegment[] = []): unknown {\n  if (isArray(value)) {\n    return value.map((v, idx) => {\n      if (isRecord(v)) {\n        const key = v['_key']\n        if (typeof key === 'string') {\n          return walkMap(v, mappingFn, path.concat({key, index: idx}))\n        }\n      }\n\n      return walkMap(v, mappingFn, path.concat(idx))\n    })\n  }\n\n  if (isRecord(value)) {\n    return Object.fromEntries(\n      Object.entries(value).map(([k, v]) => [k, walkMap(v, mappingFn, path.concat(k))]),\n    )\n  }\n\n  return mappingFn(value, path)\n}\n","import {parseJsonPath} from './jsonpath'\nimport {resolveMapping} from './resolveMapping'\nimport type {\n  Any,\n  ContentSourceMap,\n  ContentSourceMapDocuments,\n  PathSegment,\n  SanityDocument,\n} from './types'\nimport {walkMap} from './walkMap'\n\n/**\n * @public\n */\nexport type ApplySourceDocumentsUpdateFunction = <T = unknown>(\n  changedValue: T,\n  context: {\n    cachedDocument: SanityDocument\n    previousValue: T\n    sourceDocument: ContentSourceMapDocuments[number]\n    sourcePath: PathSegment[]\n  },\n) => T\n\nconst defaultUpdateFunction = <T = unknown>(changed: T): T => changed\n\n/**\n * Optimistically applies source documents to a result, using the content source map to trace fields.\n * Can be used to apply mutations to documents being edited in a Studio, or any mutation on Content Lake, to a result with extremely low latency.\n * @public\n */\nexport function applySourceDocuments<Result = unknown>(\n  result: Result,\n  resultSourceMap: ContentSourceMap | undefined,\n  getCachedDocument: (\n    sourceDocument: ContentSourceMapDocuments[number],\n  ) => SanityDocument | undefined,\n  updateFn: ApplySourceDocumentsUpdateFunction = defaultUpdateFunction,\n): Result {\n  if (!resultSourceMap) return result\n\n  return walkMap(result, (value, path) => {\n    const resolveMappingResult = resolveMapping(path, resultSourceMap)\n    if (!resolveMappingResult) {\n      return value\n    }\n\n    const [mapping, , pathSuffix] = resolveMappingResult\n    if (mapping.type !== 'value') {\n      return value\n    }\n\n    if (mapping.source.type !== 'documentValue') {\n      return value\n    }\n\n    const sourceDocument = resultSourceMap.documents[mapping.source.document]\n    const sourcePath = resultSourceMap.paths[mapping.source.path]\n\n    if (sourceDocument) {\n      const cachedDocument = getCachedDocument(sourceDocument)\n      if (!cachedDocument) {\n        return value\n      }\n\n      const parsedPath = parseJsonPath(sourcePath + pathSuffix)\n      const changedValue = cachedDocument ? getField(cachedDocument, parsedPath) ?? value : value\n      return value === changedValue\n        ? value\n        : updateFn<Result[keyof Result]>(changedValue, {\n            cachedDocument,\n            previousValue: value as Result[keyof Result],\n            sourceDocument,\n            sourcePath: parsedPath,\n          })\n    }\n\n    return value\n  }) as Result\n}\n\nfunction getField(obj: SanityDocument, path: PathSegment[]): Any {\n  let value = obj as SanityDocument | SanityDocument[keyof SanityDocument]\n  for (const segment of path) {\n    if (typeof segment === 'string') {\n      value = value[segment]\n    } else {\n      const match =\n        typeof segment === 'object'\n          ? value.find((item: SanityDocument[keyof SanityDocument]) => item._key === segment.key)\n          : value[segment]\n      value = match || null\n    }\n    if (value === null || value === undefined) {\n      break\n    }\n  }\n  return value\n}\n","import type {ContentSourceMapDocuments} from '../types'\nimport {parseJsonPath} from './jsonpath'\nimport type {PathSegment, StudioUrl} from './types'\n\n/** @public */\nexport type EditIntentLink = `/intent/edit/id=${string};type=${string};path=${string}`\n\n/** @public */\nexport function createEditIntentLink(\n  studioUrl: StudioUrl,\n  {_id, _type}: ContentSourceMapDocuments[number],\n  path: string | PathSegment[],\n): `${StudioUrl}${EditIntentLink}` {\n  const _studioUrl = studioUrl.replace(/\\/$/, '')\n  const _path = encodeJsonPathToUriComponent(path)\n  return `${_studioUrl}/intent/edit/id=${_id};type=${_type};path=${_path}`\n}\n\n/** @public */\nexport function encodeJsonPathToUriComponent(path: string | PathSegment[]): string {\n  const sourcePath = Array.isArray(path) ? path : parseJsonPath(path)\n  return encodeURIComponent(\n    sourcePath\n      .map((key, i) => (typeof key === 'number' ? `[${key}]` : i > 0 ? `.${key}` : key))\n      .join(''),\n  )\n}\n","import {Encoder} from './encode'\nimport {parseJsonPath} from './jsonpath'\nimport {resolveMapping} from './resolveMapping'\nimport type {ContentSourceMap} from './types'\nimport {walkMap} from './walkMap'\n\n/**\n * @alpha\n */\nexport function encodeIntoResult<R>(\n  result: R,\n  csm: ContentSourceMap,\n  encoder: Encoder<unknown>,\n  options?: {keyArraySelectors: boolean},\n): ReturnType<Encoder<unknown>> {\n  return walkMap(result, (value, path) => {\n    // Only map strings, we could extend this in the future to support other types like integers...\n    if (typeof value !== 'string') {\n      return value\n    }\n\n    const resolveMappingResult = resolveMapping(path, csm)\n    if (!resolveMappingResult) {\n      return value\n    }\n\n    const [mapping, matchedPath, pathSuffix] = resolveMappingResult\n    if (mapping.type !== 'value') {\n      return value\n    }\n\n    if (mapping.source.type !== 'documentValue') {\n      return value\n    }\n\n    const sourceDocument = csm.documents[mapping.source.document!]\n    const sourcePath = csm.paths[mapping.source.path]\n\n    if (options?.keyArraySelectors) {\n      const matchPathSegments = parseJsonPath(matchedPath)\n      const sourcePathSegments = parseJsonPath(sourcePath)\n      const fullSourceSegments = sourcePathSegments.concat(path.slice(matchPathSegments.length))\n\n      return encoder(value, sourceDocument, fullSourceSegments)\n    }\n\n    return encoder(value, sourceDocument, parseJsonPath(sourcePath + pathSuffix))\n  })\n}\n","import {encodeIntoResult} from './encodeIntoResult'\nimport type {ContentSourceMap, ContentSourceMapDocuments, PathSegment} from './types'\n\n/**\n * @alpha\n */\nexport type Encoder<E> = (\n  value: string,\n  sourceDocument: ContentSourceMapDocuments[number],\n  path: PathSegment[],\n) => E\n\n/**\n * @alpha\n */\nexport function encode<R, E>(\n  result: R,\n  csm: ContentSourceMap,\n  encoder: Encoder<E>,\n  options?: {keyArraySelectors: boolean},\n): R {\n  return encodeIntoResult(result, csm, encoder, options) as R\n}\n"],"names":["ESCAPE","UNESCAPE","jsonPath","path","opts","concat","map","segment","escapedKey","replace","match","keyArraySelectors","key","index","join","parseJsonPath","parsed","parseRe","exec","m","push","parseInt","resolveMapping","resultPath","csm","mappings","resultJsonPath","Object","entries","filter","_ref","startsWith","sort","_ref2","_ref3","key1","key2","length","matchedPath","mapping","pathSuffix","substring","isArray","value","Array","isRecord","walkMap","mappingFn","arguments","undefined","v","idx","fromEntries","_ref4","k","defaultUpdateFunction","changed","applySourceDocuments","result","resultSourceMap","getCachedDocument","updateFn","_a","resolveMappingResult","type","source","sourceDocument","documents","document","sourcePath","paths","cachedDocument","parsedPath","changedValue","getField","previousValue","obj","find","item","_key","createEditIntentLink","studioUrl","_ref5","_id","_type","_studioUrl","_path","encodeJsonPathToUriComponent","encodeURIComponent","i","encodeIntoResult","encoder","options","matchPathSegments","sourcePathSegments","fullSourceSegments","slice","encode"],"mappings":"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"}

package/dist/csm.d.ts

@@ -1,5 +1,38 @@
 /// <reference types="node" />
 
+/**
+ * Used to tag types that is set to `any` as a temporary measure, but should be replaced with proper typings in the future
+ * @internal
+ */
+export declare type Any = any
+
+/**
+ * Optimistically applies source documents to a result, using the content source map to trace fields.
+ * Can be used to apply mutations to documents being edited in a Studio, or any mutation on Content Lake, to a result with extremely low latency.
+ * @public
+ */
+export declare function applySourceDocuments<Result = unknown>(
+  result: Result,
+  resultSourceMap: ContentSourceMap | undefined,
+  getCachedDocument: (
+    sourceDocument: ContentSourceMapDocuments[number],
+  ) => SanityDocument | undefined,
+  updateFn?: ApplySourceDocumentsUpdateFunction,
+): Result
+
+/**
+ * @public
+ */
+export declare type ApplySourceDocumentsUpdateFunction = <T = unknown>(
+  changedValue: T,
+  context: {
+    cachedDocument: SanityDocument
+    previousValue: T
+    sourceDocument: ContentSourceMapDocuments[number]
+    sourcePath: PathSegment[]
+  },
+) => T
+
 /** @public */
 export declare interface ContentSourceMap {
   mappings: ContentSourceMapMappings
@@ -92,7 +125,9 @@ export declare function createEditIntentLink(
 /** @public */
 export declare type EditIntentLink = `/intent/edit/id=${string};type=${string};path=${string}`
 
-/** @alpha */
+/**
+ * @alpha
+ */
 export declare function encode<R, E>(
   result: R,
   csm: ContentSourceMap,
@@ -102,7 +137,9 @@ export declare function encode<R, E>(
   },
 ): R
 
-/** @alpha */
+/**
+ * @alpha
+ */
 export declare function encodeIntoResult<R>(
   result: R,
   csm: ContentSourceMap,
@@ -115,14 +152,18 @@ export declare function encodeIntoResult<R>(
 /** @public */
 export declare function encodeJsonPathToUriComponent(path: string | PathSegment[]): string
 
-/** @alpha */
+/**
+ * @alpha
+ */
 export declare type Encoder<E> = (
   value: string,
   sourceDocument: ContentSourceMapDocuments[number],
   path: PathSegment[],
 ) => E
 
-/** @internal */
+/**
+ * @internal
+ */
 export declare function jsonPath(
   path: PathSegment[],
   opts?: {
@@ -136,18 +177,37 @@ export declare type KeyedSegment = {
   index: number
 }
 
-/** @internal */
+/**
+ * @internal
+ */
 export declare function parseJsonPath(path: string): PathSegment[]
 
 /** @public */
 export declare type PathSegment = string | number | KeyedSegment
 
-/** @alpha */
+/**
+ * @alpha
+ */
 export declare function resolveMapping(
   resultPath: PathSegment[],
-  csm: ContentSourceMap,
+  csm?: ContentSourceMap,
 ): [ContentSourceMapMapping, string, string] | undefined
 
+/** @internal */
+export declare type SanityDocument<T extends Record<string, Any> = Record<string, Any>> = {
+  [P in keyof T]: T[P]
+} & {
+  _id: string
+  _rev: string
+  _type: string
+  _createdAt: string
+  _updatedAt: string
+  /**
+   * Present when `perspective` is set to `previewDrafts`
+   */
+  _originalId?: string
+}
+
 /** @public */
 export declare type StudioUrl =
   | `/${string}`
@@ -155,12 +215,15 @@ export declare type StudioUrl =
   | `https://${string}`
   | string
 
-/** generic way to walk a nested object or array and apply a mapping function to each value
+/**
+ * generic way to walk a nested object or array and apply a mapping function to each value
  * @alpha
  */
 export declare function walkMap(value: unknown, mappingFn: WalkMapFn, path?: PathSegment[]): unknown
 
-/** @alpha */
+/**
+ * @alpha
+ */
 export declare type WalkMapFn = (value: unknown, path: PathSegment[]) => unknown
 
 export {}

package/dist/csm.js

@@ -63,11 +63,115 @@ function parseJsonPath(path) {
   }
   return parsed;
 }
-function createEditIntentLink(studioUrl, _ref, path) {
+function resolveMapping(resultPath, csm) {
+  if (!(csm == null ? void 0 : csm.mappings)) {
+    return void 0;
+  }
+  const resultJsonPath = jsonPath(resultPath);
+  if (csm.mappings[resultJsonPath] !== void 0) {
+    return [csm.mappings[resultJsonPath], resultJsonPath, ""];
+  }
+  const mappings = Object.entries(csm.mappings).filter(_ref => {
+    let [key] = _ref;
+    return resultJsonPath.startsWith(key);
+  }).sort((_ref2, _ref3) => {
+    let [key1] = _ref2;
+    let [key2] = _ref3;
+    return key2.length - key1.length;
+  });
+  if (mappings.length == 0) {
+    return void 0;
+  }
+  const [matchedPath, mapping] = mappings[0];
+  const pathSuffix = resultJsonPath.substring(matchedPath.length);
+  return [mapping, matchedPath, pathSuffix];
+}
+function isArray(value) {
+  return value !== null && Array.isArray(value);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function walkMap(value, mappingFn) {
+  let path = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+  if (isArray(value)) {
+    return value.map((v, idx) => {
+      if (isRecord(v)) {
+        const key = v["_key"];
+        if (typeof key === "string") {
+          return walkMap(v, mappingFn, path.concat({
+            key,
+            index: idx
+          }));
+        }
+      }
+      return walkMap(v, mappingFn, path.concat(idx));
+    });
+  }
+  if (isRecord(value)) {
+    return Object.fromEntries(Object.entries(value).map(_ref4 => {
+      let [k, v] = _ref4;
+      return [k, walkMap(v, mappingFn, path.concat(k))];
+    }));
+  }
+  return mappingFn(value, path);
+}
+const defaultUpdateFunction = changed => changed;
+function applySourceDocuments(result, resultSourceMap, getCachedDocument) {
+  let updateFn = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : defaultUpdateFunction;
+  if (!resultSourceMap) return result;
+  return walkMap(result, (value, path) => {
+    var _a;
+    const resolveMappingResult = resolveMapping(path, resultSourceMap);
+    if (!resolveMappingResult) {
+      return value;
+    }
+    const [mapping,, pathSuffix] = resolveMappingResult;
+    if (mapping.type !== "value") {
+      return value;
+    }
+    if (mapping.source.type !== "documentValue") {
+      return value;
+    }
+    const sourceDocument = resultSourceMap.documents[mapping.source.document];
+    const sourcePath = resultSourceMap.paths[mapping.source.path];
+    if (sourceDocument) {
+      const cachedDocument = getCachedDocument(sourceDocument);
+      if (!cachedDocument) {
+        return value;
+      }
+      const parsedPath = parseJsonPath(sourcePath + pathSuffix);
+      const changedValue = cachedDocument ? (_a = getField(cachedDocument, parsedPath)) != null ? _a : value : value;
+      return value === changedValue ? value : updateFn(changedValue, {
+        cachedDocument,
+        previousValue: value,
+        sourceDocument,
+        sourcePath: parsedPath
+      });
+    }
+    return value;
+  });
+}
+function getField(obj, path) {
+  let value = obj;
+  for (const segment of path) {
+    if (typeof segment === "string") {
+      value = value[segment];
+    } else {
+      const match = typeof segment === "object" ? value.find(item => item._key === segment.key) : value[segment];
+      value = match || null;
+    }
+    if (value === null || value === void 0) {
+      break;
+    }
+  }
+  return value;
+}
+function createEditIntentLink(studioUrl, _ref5, path) {
   let {
     _id,
     _type
-  } = _ref;
+  } = _ref5;
   const _studioUrl = studioUrl.replace(/\/$/, "");
   const _path = encodeJsonPathToUriComponent(path);
   return "".concat(_studioUrl, "/intent/edit/id=").concat(_id, ";type=").concat(_type, ";path=").concat(_path);
@@ -76,15 +180,6 @@ function encodeJsonPathToUriComponent(path) {
   const sourcePath = Array.isArray(path) ? path : parseJsonPath(path);
   return encodeURIComponent(sourcePath.map((key, i) => typeof key === "number" ? "[".concat(key, "]") : i > 0 ? ".".concat(key) : key).join(""));
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function isArray(value) {
-  return value !== null && Array.isArray(value);
-}
-function encode(result, csm, encoder, options) {
-  return encodeIntoResult(result, csm, encoder, options);
-}
 function encodeIntoResult(result, csm, encoder, options) {
   return walkMap(result, (value, path) => {
     if (typeof value !== "string") {
@@ -112,49 +207,8 @@ function encodeIntoResult(result, csm, encoder, options) {
     return encoder(value, sourceDocument, parseJsonPath(sourcePath + pathSuffix));
   });
 }
-function walkMap(value, mappingFn) {
-  let path = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
-  if (isArray(value)) {
-    return value.map((v, idx) => {
-      if (isRecord(v)) {
-        const key = v["_key"];
-        if (typeof key === "string") {
-          return walkMap(v, mappingFn, path.concat({
-            key,
-            index: idx
-          }));
-        }
-      }
-      return walkMap(v, mappingFn, path.concat(idx));
-    });
-  }
-  if (isRecord(value)) {
-    return Object.fromEntries(Object.entries(value).map(_ref2 => {
-      let [k, v] = _ref2;
-      return [k, walkMap(v, mappingFn, path.concat(k))];
-    }));
-  }
-  return mappingFn(value, path);
-}
-function resolveMapping(resultPath, csm) {
-  const resultJsonPath = jsonPath(resultPath);
-  if (csm.mappings[resultJsonPath] !== void 0) {
-    return [csm.mappings[resultJsonPath], resultJsonPath, ""];
-  }
-  const mappings = Object.entries(csm.mappings).filter(_ref3 => {
-    let [key] = _ref3;
-    return resultJsonPath.startsWith(key);
-  }).sort((_ref4, _ref5) => {
-    let [key1] = _ref4;
-    let [key2] = _ref5;
-    return key2.length - key1.length;
-  });
-  if (mappings.length == 0) {
-    return void 0;
-  }
-  const [matchedPath, mapping] = mappings[0];
-  const pathSuffix = resultJsonPath.substring(matchedPath.length);
-  return [mapping, matchedPath, pathSuffix];
+function encode(result, csm, encoder, options) {
+  return encodeIntoResult(result, csm, encoder, options);
 }
-export { createEditIntentLink, encode, encodeIntoResult, encodeJsonPathToUriComponent, jsonPath, parseJsonPath, resolveMapping, walkMap };
+export { applySourceDocuments, createEditIntentLink, encode, encodeIntoResult, encodeJsonPathToUriComponent, jsonPath, parseJsonPath, resolveMapping, walkMap };
 //# sourceMappingURL=csm.js.map