@sanity/client 6.7.0 → 6.7.1-canary.1

package/dist/csm.cjs

@@ -0,0 +1,131 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+const ESCAPE = {
+  "\f": "\\f",
+  "\n": "\\n",
+  "\r": "\\r",
+  "	": "\\t",
+  "'": "\\'",
+  "\\": "\\\\"
+};
+const UNESCAPE = {
+  "\\f": "\f",
+  "\\n": "\n",
+  "\\r": "\r",
+  "\\t": "	",
+  "\\'": "'",
+  "\\\\": "\\"
+};
+function jsonPath(path, opts) {
+  return "$".concat(path.map(segment => {
+    if (typeof segment === "string") {
+      const escapedKey = segment.replace(/[\f\n\r\t'\\]/g, match => {
+        return ESCAPE[match];
+      });
+      return "['".concat(escapedKey, "']");
+    }
+    if (typeof segment === "number") {
+      return "[".concat(segment, "]");
+    }
+    if ((opts == null ? void 0 : opts.keyArraySelectors) && segment.key !== "") {
+      const escapedKey = segment.key.replace(/['\\]/g, match => {
+        return ESCAPE[match];
+      });
+      return "[?(@._key=='".concat(escapedKey, "')]");
+    }
+    return "[".concat(segment.index, "]");
+  }).join(""));
+}
+function parseJsonPath(path) {
+  const parsed = [];
+  const parseRe = /\['(.*?)'\]|\[(\d+)\]|\[\?\(@\._key=='(.*?)'\)\]/g;
+  let match;
+  while ((match = parseRe.exec(path)) !== null) {
+    if (match[1] !== void 0) {
+      const key = match[1].replace(/\\(\\|f|n|r|t|')/g, m => {
+        return UNESCAPE[m];
+      });
+      parsed.push(key);
+      continue;
+    }
+    if (match[2] !== void 0) {
+      parsed.push(parseInt(match[2], 10));
+      continue;
+    }
+    if (match[3] !== void 0) {
+      const key = match[3].replace(/\\(\\')/g, m => {
+        return UNESCAPE[m];
+      });
+      parsed.push({
+        key,
+        index: -1
+      });
+      continue;
+    }
+  }
+  return parsed;
+}
+function encodeJsonPathToUriComponent(path) {
+  const sourcePath = Array.isArray(path) ? path : parseJsonPath(path);
+  return encodeURIComponent(sourcePath.map((key, i) =>
+  // eslint-disable-next-line no-nested-ternary
+  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 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(_ref => {
+      let [k, v] = _ref;
+      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(_ref2 => {
+    let [key] = _ref2;
+    return resultJsonPath.startsWith(key);
+  }).sort((_ref3, _ref4) => {
+    let [key1] = _ref3;
+    let [key2] = _ref4;
+    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];
+}
+exports.encodeJsonPathToUriComponent = encodeJsonPathToUriComponent;
+exports.jsonPath = jsonPath;
+exports.resolveMapping = resolveMapping;
+exports.walkMap = walkMap;
+//# sourceMappingURL=csm.cjs.map

package/dist/csm.cjs.map

@@ -0,0 +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 {ContentSourceMapDocument, ContentSourceMapDocuments} from '../types'\nimport {parseJsonPath} from './jsonpath'\nimport type {PathSegment, StudioUrl} from './types'\n\n/** @alpha */\nexport type EditLink = `/intent/edit/id=${string};type=${string};path=${string}`\n\n/** @alpha */\nexport interface EditLinkProps {\n  studioUrl: StudioUrl\n  document: ContentSourceMapDocument\n}\n\n/** @alpha */\nexport type DefineEditLink = (\n  studioUrl: StudioUrl,\n) => (sourceDocument: ContentSourceMapDocuments[number]) => `${StudioUrl}${EditLink}`\n\n/** @alpha */\nexport function defineEditLink(\n  _studioUrl: StudioUrl,\n): (\n  sourceDocument: ContentSourceMapDocuments[number],\n  path: string | PathSegment[],\n) => `${StudioUrl}${EditLink}` {\n  const studioUrl = _studioUrl.replace(/\\/$/, '')\n  return ({_id, _type}, path) =>\n    `${studioUrl}/intent/edit/id=${_id};type=${_type};path=${encodeJsonPathToUriComponent(path)}`\n}\n\n/** @alpha */\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) =>\n        // eslint-disable-next-line no-nested-ternary\n        typeof key === 'number' ? `[${key}]` : i > 0 ? `.${key}` : key,\n      )\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    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\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 =\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n      csm.documents[mapping.source.document!]\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\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","encodeJsonPathToUriComponent","sourcePath","Array","isArray","encodeURIComponent","i","isRecord","value","walkMap","mappingFn","arguments","length","undefined","v","idx","Object","fromEntries","entries","_ref","k","resolveMapping","resultPath","csm","resultJsonPath","mappings","filter","_ref2","startsWith","sort","_ref3","_ref4","key1","key2","matchedPath","mapping","pathSuffix","substring"],"mappings":"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"}

package/dist/csm.d.ts

@@ -0,0 +1,126 @@
+/// <reference types="node" />
+
+/** @public */
+export declare interface ContentSourceMap {
+  mappings: ContentSourceMapMappings
+  documents: ContentSourceMapDocuments
+  paths: ContentSourceMapPaths
+}
+
+/** @public */
+export declare interface ContentSourceMapDocument extends ContentSourceMapDocumentBase {
+  _projectId?: undefined
+  _dataset?: undefined
+}
+
+/** @public */
+export declare interface ContentSourceMapDocumentBase {
+  _id: string
+  _type: string
+}
+
+/** @public */
+export declare type ContentSourceMapDocuments = (
+  | ContentSourceMapDocument
+  | ContentSourceMapRemoteDocument
+)[]
+
+/**
+ * DocumentValueSource is a path to a value within a document
+ * @public
+ */
+export declare interface ContentSourceMapDocumentValueSource {
+  type: 'documentValue'
+  document: number
+  path: number
+}
+
+/**
+ * When a value is not from a source, its a literal
+ * @public
+ */
+export declare interface ContentSourceMapLiteralSource {
+  type: 'literal'
+}
+
+/** @public */
+export declare type ContentSourceMapMapping = ContentSourceMapValueMapping
+
+/** @public */
+export declare type ContentSourceMapMappings = Record<string, ContentSourceMapMapping>
+
+/** @public */
+export declare type ContentSourceMapPaths = string[]
+
+/** @public */
+export declare interface ContentSourceMapRemoteDocument extends ContentSourceMapDocumentBase {
+  _projectId: string
+  _dataset: string
+}
+
+/** @public */
+export declare type ContentSourceMapSource =
+  | ContentSourceMapDocumentValueSource
+  | ContentSourceMapLiteralSource
+  | ContentSourceMapUnknownSource
+
+/**
+ * When a field source is unknown
+ * @public
+ */
+export declare interface ContentSourceMapUnknownSource {
+  type: 'unknown'
+}
+
+/**
+ * ValueMapping is a mapping when for value that is from a single source value
+ * It may refer to a field within a document or a literal value
+ * @public
+ */
+export declare interface ContentSourceMapValueMapping {
+  type: 'value'
+  source: ContentSourceMapSource
+}
+
+/** @alpha */
+export declare function encodeJsonPathToUriComponent(path: string | PathSegment[]): string
+
+/** @internal */
+export declare function jsonPath(
+  path: PathSegment[],
+  opts?: {
+    keyArraySelectors: boolean
+  },
+): string
+
+/** @public */
+export declare type KeyedSegment = {
+  key: string
+  index: number
+}
+
+/** @public */
+export declare type PathSegment = string | number | KeyedSegment
+
+/** @alpha */
+export declare function resolveMapping(
+  resultPath: PathSegment[],
+  csm: ContentSourceMap,
+): [ContentSourceMapMapping, string, string] | undefined
+
+/** @public */
+export declare type StudioUrl =
+  | `/${string}`
+  | `${string}.sanity.studio`
+  | `https://${string}`
+  | string
+
+/** 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 */
+export declare type WalkMapFn = (value: unknown, path: PathSegment[]) => unknown
+
+export {}

package/dist/csm.js

@@ -0,0 +1,123 @@
+const ESCAPE = {
+  "\f": "\\f",
+  "\n": "\\n",
+  "\r": "\\r",
+  "	": "\\t",
+  "'": "\\'",
+  "\\": "\\\\"
+};
+const UNESCAPE = {
+  "\\f": "\f",
+  "\\n": "\n",
+  "\\r": "\r",
+  "\\t": "	",
+  "\\'": "'",
+  "\\\\": "\\"
+};
+function jsonPath(path, opts) {
+  return "$".concat(path.map(segment => {
+    if (typeof segment === "string") {
+      const escapedKey = segment.replace(/[\f\n\r\t'\\]/g, match => {
+        return ESCAPE[match];
+      });
+      return "['".concat(escapedKey, "']");
+    }
+    if (typeof segment === "number") {
+      return "[".concat(segment, "]");
+    }
+    if ((opts == null ? void 0 : opts.keyArraySelectors) && segment.key !== "") {
+      const escapedKey = segment.key.replace(/['\\]/g, match => {
+        return ESCAPE[match];
+      });
+      return "[?(@._key=='".concat(escapedKey, "')]");
+    }
+    return "[".concat(segment.index, "]");
+  }).join(""));
+}
+function parseJsonPath(path) {
+  const parsed = [];
+  const parseRe = /\['(.*?)'\]|\[(\d+)\]|\[\?\(@\._key=='(.*?)'\)\]/g;
+  let match;
+  while ((match = parseRe.exec(path)) !== null) {
+    if (match[1] !== void 0) {
+      const key = match[1].replace(/\\(\\|f|n|r|t|')/g, m => {
+        return UNESCAPE[m];
+      });
+      parsed.push(key);
+      continue;
+    }
+    if (match[2] !== void 0) {
+      parsed.push(parseInt(match[2], 10));
+      continue;
+    }
+    if (match[3] !== void 0) {
+      const key = match[3].replace(/\\(\\')/g, m => {
+        return UNESCAPE[m];
+      });
+      parsed.push({
+        key,
+        index: -1
+      });
+      continue;
+    }
+  }
+  return parsed;
+}
+function encodeJsonPathToUriComponent(path) {
+  const sourcePath = Array.isArray(path) ? path : parseJsonPath(path);
+  return encodeURIComponent(sourcePath.map((key, i) =>
+  // eslint-disable-next-line no-nested-ternary
+  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 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(_ref => {
+      let [k, v] = _ref;
+      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(_ref2 => {
+    let [key] = _ref2;
+    return resultJsonPath.startsWith(key);
+  }).sort((_ref3, _ref4) => {
+    let [key1] = _ref3;
+    let [key2] = _ref4;
+    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];
+}
+export { encodeJsonPathToUriComponent, jsonPath, resolveMapping, walkMap };
+//# sourceMappingURL=csm.js.map

package/dist/csm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csm.js","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 {ContentSourceMapDocument, ContentSourceMapDocuments} from '../types'\nimport {parseJsonPath} from './jsonpath'\nimport type {PathSegment, StudioUrl} from './types'\n\n/** @alpha */\nexport type EditLink = `/intent/edit/id=${string};type=${string};path=${string}`\n\n/** @alpha */\nexport interface EditLinkProps {\n  studioUrl: StudioUrl\n  document: ContentSourceMapDocument\n}\n\n/** @alpha */\nexport type DefineEditLink = (\n  studioUrl: StudioUrl,\n) => (sourceDocument: ContentSourceMapDocuments[number]) => `${StudioUrl}${EditLink}`\n\n/** @alpha */\nexport function defineEditLink(\n  _studioUrl: StudioUrl,\n): (\n  sourceDocument: ContentSourceMapDocuments[number],\n  path: string | PathSegment[],\n) => `${StudioUrl}${EditLink}` {\n  const studioUrl = _studioUrl.replace(/\\/$/, '')\n  return ({_id, _type}, path) =>\n    `${studioUrl}/intent/edit/id=${_id};type=${_type};path=${encodeJsonPathToUriComponent(path)}`\n}\n\n/** @alpha */\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) =>\n        // eslint-disable-next-line no-nested-ternary\n        typeof key === 'number' ? `[${key}]` : i > 0 ? `.${key}` : key,\n      )\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    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\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 =\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n      csm.documents[mapping.source.document!]\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\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","encodeJsonPathToUriComponent","sourcePath","Array","isArray","encodeURIComponent","i","isRecord","value","walkMap","mappingFn","arguments","length","undefined","v","idx","Object","fromEntries","entries","_ref","k","resolveMapping","resultPath","csm","resultJsonPath","mappings","filter","_ref2","startsWith","sort","_ref3","_ref4","key1","key2","matchedPath","mapping","pathSuffix","substring"],"mappings":"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"}

package/dist/index.cjs

@@ -8,7 +8,7 @@ var getIt = require('get-it');
 var rxjs = require('rxjs');
 var operators = require('rxjs/operators');
 var name = "@sanity/client";
-var version = "6.7.0";
+var version = "6.7.1-canary.1";
 const middleware = [middleware$1.debug({
   verbose: true,
   namespace: "sanity:client"

package/dist/index.js

@@ -4,7 +4,7 @@ export { adapter as unstable__adapter, environment as unstable__environment } fr
 import { Observable, lastValueFrom } from 'rxjs';
 import { map, filter } from 'rxjs/operators';
 var name = "@sanity/client";
-var version = "6.7.0";
+var version = "6.7.1-canary.1";
 const middleware = [debug({
   verbose: true,
   namespace: "sanity:client"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/client",
-  "version": "6.7.0",
+  "version": "6.7.1-canary.1",
   "description": "Client for retrieving, creating and patching data from Sanity.io",
   "keywords": [
     "sanity",
@@ -44,6 +44,13 @@
       },
       "default": "./dist/index.js"
     },
+    "./csm": {
+      "types": "./dist/csm.d.ts",
+      "source": "./src/csm/index.ts",
+      "import": "./dist/csm.js",
+      "require": "./dist/csm.cjs",
+      "default": "./dist/csm.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",
@@ -55,6 +62,13 @@
     "./dist/index.js": "./dist/index.browser.js"
   },
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "csm": [
+        "./dist/csm.d.ts"
+      ]
+    }
+  },
   "files": [
     "dist",
     "src",
@@ -91,33 +105,33 @@
   },
   "dependencies": {
     "@sanity/eventsource": "^5.0.0",
-    "get-it": "^8.4.3",
+    "get-it": "^8.4.4",
     "rxjs": "^7.0.0"
   },
   "devDependencies": {
-    "@edge-runtime/types": "^2.2.4",
-    "@edge-runtime/vm": "^3.1.4",
-    "@rollup/plugin-commonjs": "^25.0.5",
+    "@edge-runtime/types": "^2.2.6",
+    "@edge-runtime/vm": "^3.1.6",
+    "@rollup/plugin-commonjs": "^25.0.7",
     "@rollup/plugin-node-resolve": "^15.2.3",
-    "@sanity/pkg-utils": "^3.0.0",
-    "@types/node": "^20.8.4",
-    "@typescript-eslint/eslint-plugin": "^6.7.5",
-    "@typescript-eslint/parser": "^6.7.5",
+    "@sanity/pkg-utils": "^3.2.1",
+    "@types/node": "^20.8.8",
+    "@typescript-eslint/eslint-plugin": "^6.9.0",
+    "@typescript-eslint/parser": "^6.9.0",
     "@vitest/coverage-v8": "^0.34.6",
-    "eslint": "^8.51.0",
+    "eslint": "^8.52.0",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-prettier": "^5.0.1",
     "eslint-plugin-simple-import-sort": "^10.0.0",
     "faucet": "^0.0.4",
-    "happy-dom": "^12.9.1",
+    "happy-dom": "^12.10.1",
     "ls-engines": "^0.9.0",
-    "nock": "^13.3.4",
+    "nock": "^13.3.6",
     "prettier": "^3.0.3",
     "prettier-plugin-packagejson": "^2.4.6",
     "rimraf": "^5.0.1",
-    "rollup": "^4.0.2",
+    "rollup": "^4.1.4",
     "sse-channel": "^4.0.0",
-    "terser": "^5.21.0",
+    "terser": "^5.22.0",
     "typescript": "^5.2.2",
     "vitest": "^0.34.6",
     "vitest-github-actions-reporter": "^0.10.0"

package/src/csm/editIntent.ts

@@ -0,0 +1,42 @@
+import {ContentSourceMapDocument, ContentSourceMapDocuments} from '../types'
+import {parseJsonPath} from './jsonpath'
+import type {PathSegment, StudioUrl} from './types'
+
+/** @alpha */
+export type EditLink = `/intent/edit/id=${string};type=${string};path=${string}`
+
+/** @alpha */
+export interface EditLinkProps {
+  studioUrl: StudioUrl
+  document: ContentSourceMapDocument
+}
+
+/** @alpha */
+export type DefineEditLink = (
+  studioUrl: StudioUrl,
+) => (sourceDocument: ContentSourceMapDocuments[number]) => `${StudioUrl}${EditLink}`
+
+/** @alpha */
+export function defineEditLink(
+  _studioUrl: StudioUrl,
+): (
+  sourceDocument: ContentSourceMapDocuments[number],
+  path: string | PathSegment[],
+) => `${StudioUrl}${EditLink}` {
+  const studioUrl = _studioUrl.replace(/\/$/, '')
+  return ({_id, _type}, path) =>
+    `${studioUrl}/intent/edit/id=${_id};type=${_type};path=${encodeJsonPathToUriComponent(path)}`
+}
+
+/** @alpha */
+export function encodeJsonPathToUriComponent(path: string | PathSegment[]): string {
+  const sourcePath = Array.isArray(path) ? path : parseJsonPath(path)
+  return encodeURIComponent(
+    sourcePath
+      .map((key, i) =>
+        // eslint-disable-next-line no-nested-ternary
+        typeof key === 'number' ? `[${key}]` : i > 0 ? `.${key}` : key,
+      )
+      .join(''),
+  )
+}

package/src/csm/index.ts

@@ -0,0 +1,19 @@
+export type {
+  ContentSourceMap,
+  ContentSourceMapDocument,
+  ContentSourceMapDocumentBase,
+  ContentSourceMapDocuments,
+  ContentSourceMapDocumentValueSource,
+  ContentSourceMapLiteralSource,
+  ContentSourceMapMapping,
+  ContentSourceMapMappings,
+  ContentSourceMapPaths,
+  ContentSourceMapRemoteDocument,
+  ContentSourceMapSource,
+  ContentSourceMapUnknownSource,
+  ContentSourceMapValueMapping,
+} from '../types'
+export {encodeJsonPathToUriComponent} from './editIntent'
+export {jsonPath} from './jsonpath'
+export {resolveMapping, walkMap, type WalkMapFn} from './sourcemap'
+export type * from './types'

package/src/csm/jsonpath.test.ts

@@ -0,0 +1,40 @@
+import { expect, test } from 'vitest'
+
+import { jsonPath, parseJsonPath } from './jsonpath'
+
+test('formats normalised JSON Paths', () => {
+  expect(jsonPath(['foo', 'bar', 0, 'baz'])).toBe(
+    "$['foo']['bar'][0]['baz']",
+  )
+})
+
+test('formats normalised JSON Paths with escaped characters', () => {
+  expect(jsonPath(['foo', 'bar', 0, 'baz', "it's a 'test'"])).toBe(
+    "$['foo']['bar'][0]['baz']['it\\'s a \\'test\\'']",
+  )
+})
+
+test('parses normalised JSON Paths', () => {
+  expect(parseJsonPath("$['foo']['bar'][0]['baz']")).toEqual([
+    'foo',
+    'bar',
+    0,
+    'baz',
+  ])
+})
+
+test('parses normalised JSON Paths with escaped characters', () => {
+  expect(
+    parseJsonPath("$['foo']['bar'][0]['baz']['it\\'s a \\'test\\'']"),
+  ).toEqual(['foo', 'bar', 0, 'baz', "it's a 'test'"])
+})
+
+test('parses normalised JSON Paths with key array filter selectors', () => {
+  expect(parseJsonPath("$['foo'][?(@._key=='section-1')][0]['baz'][?(@._key=='section-2')]")).toEqual([
+    'foo',
+    { key: 'section-1', index: -1 },
+    0,
+    'baz',
+    { key: 'section-2', index: -1},
+  ])
+})