@sanity/cli 6.3.1 → 6.4.0

package/dist/util/validateProjection.js

@@ -0,0 +1,121 @@
+import { parse } from 'groq-js';
+/**
+ * Validates that a string is a syntactically valid GROQ object projection
+ * suitable for embeddings indexing.
+ *
+ * Rejects:
+ * - Invalid GROQ syntax
+ * - Non-object expressions (filters, function calls, literals, etc.)
+ * - Dereferences (`->`) -- the indexer cannot resolve cross-document references
+ * - Full queries (`*[...]`) -- dataset scans are not supported
+ * - `user::` namespace functions -- user-defined functions are not available
+ */ export function validateProjection(projection) {
+    const tree = parse(projection);
+    if (tree.type !== 'Object') {
+        throw new Error(`Expected a GROQ projection (e.g. "{ title, body }"), but received a ${tree.type} expression`);
+    }
+    walk(tree);
+}
+function walk(node) {
+    if (!node) return;
+    switch(node.type){
+        case 'AccessAttribute':
+        case 'AccessElement':
+        case 'ArrayCoerce':
+        case 'Asc':
+        case 'Desc':
+        case 'Group':
+        case 'Neg':
+        case 'Not':
+        case 'Pos':
+        case 'Slice':
+            {
+                walk(node.base);
+                break;
+            }
+        case 'And':
+        case 'OpCall':
+        case 'Or':
+            {
+                walk(node.left);
+                walk(node.right);
+                break;
+            }
+        case 'Array':
+            {
+                for (const el of node.elements)walk(el.value);
+                break;
+            }
+        case 'Everything':
+            {
+                throw new Error('Projection must not contain full queries (*[...])');
+            }
+        case 'Deref':
+            {
+                throw new Error('Projection must not contain dereferences (->)');
+            }
+        case 'FuncCall':
+            {
+                if (node.namespace === 'user') {
+                    throw new Error('Projection must not contain user:: functions');
+                }
+                for (const arg of node.args)walk(arg);
+                break;
+            }
+        case 'Filter':
+        case 'FlatMap':
+        case 'Map':
+        case 'Projection':
+            {
+                walk(node.base);
+                walk(node.expr);
+                break;
+            }
+        case 'InRange':
+            {
+                walk(node.base);
+                walk(node.left);
+                walk(node.right);
+                break;
+            }
+        case 'Object':
+            {
+                for (const attr of node.attributes){
+                    switch(attr.type){
+                        case 'ObjectAttributeValue':
+                        case 'ObjectSplat':
+                            {
+                                walk(attr.value);
+                                break;
+                            }
+                        case 'ObjectConditionalSplat':
+                            {
+                                walk(attr.condition);
+                                walk(attr.value);
+                                break;
+                            }
+                        default:
+                    }
+                }
+                break;
+            }
+        case 'PipeFuncCall':
+            {
+                walk(node.base);
+                for (const arg of node.args)walk(arg);
+                break;
+            }
+        case 'Select':
+            {
+                for (const alt of node.alternatives){
+                    walk(alt.condition);
+                    walk(alt.value);
+                }
+                walk(node.fallback);
+                break;
+            }
+        default:
+    }
+}
+
+//# sourceMappingURL=validateProjection.js.map

package/dist/util/validateProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/validateProjection.ts"],"sourcesContent":["import {type ExprNode, parse} from 'groq-js'\n\n/**\n * Validates that a string is a syntactically valid GROQ object projection\n * suitable for embeddings indexing.\n *\n * Rejects:\n * - Invalid GROQ syntax\n * - Non-object expressions (filters, function calls, literals, etc.)\n * - Dereferences (`->`) -- the indexer cannot resolve cross-document references\n * - Full queries (`*[...]`) -- dataset scans are not supported\n * - `user::` namespace functions -- user-defined functions are not available\n */\nexport function validateProjection(projection: string): void {\n  const tree = parse(projection)\n  if (tree.type !== 'Object') {\n    throw new Error(\n      `Expected a GROQ projection (e.g. \"{ title, body }\"), but received a ${tree.type} expression`,\n    )\n  }\n  walk(tree)\n}\n\nfunction walk(node: ExprNode | undefined): void {\n  if (!node) return\n\n  switch (node.type) {\n    case 'AccessAttribute':\n    case 'AccessElement':\n    case 'ArrayCoerce':\n    case 'Asc':\n    case 'Desc':\n    case 'Group':\n    case 'Neg':\n    case 'Not':\n    case 'Pos':\n    case 'Slice': {\n      walk(node.base)\n      break\n    }\n    case 'And':\n    case 'OpCall':\n    case 'Or': {\n      walk(node.left)\n      walk(node.right)\n      break\n    }\n    case 'Array': {\n      for (const el of node.elements) walk(el.value)\n      break\n    }\n    case 'Everything': {\n      throw new Error('Projection must not contain full queries (*[...])')\n    }\n    case 'Deref': {\n      throw new Error('Projection must not contain dereferences (->)')\n    }\n    case 'FuncCall': {\n      if (node.namespace === 'user') {\n        throw new Error('Projection must not contain user:: functions')\n      }\n      for (const arg of node.args) walk(arg)\n      break\n    }\n    case 'Filter':\n    case 'FlatMap':\n    case 'Map':\n    case 'Projection': {\n      walk(node.base)\n      walk(node.expr)\n      break\n    }\n    case 'InRange': {\n      walk(node.base)\n      walk(node.left)\n      walk(node.right)\n      break\n    }\n    case 'Object': {\n      for (const attr of node.attributes) {\n        switch (attr.type) {\n          case 'ObjectAttributeValue':\n          case 'ObjectSplat': {\n            walk(attr.value)\n            break\n          }\n          case 'ObjectConditionalSplat': {\n            walk(attr.condition)\n            walk(attr.value)\n            break\n          }\n          default:\n        }\n      }\n      break\n    }\n    case 'PipeFuncCall': {\n      walk(node.base)\n      for (const arg of node.args) walk(arg)\n      break\n    }\n    case 'Select': {\n      for (const alt of node.alternatives) {\n        walk(alt.condition)\n        walk(alt.value)\n      }\n      walk(node.fallback)\n      break\n    }\n    default:\n  }\n}\n"],"names":["parse","validateProjection","projection","tree","type","Error","walk","node","base","left","right","el","elements","value","namespace","arg","args","expr","attr","attributes","condition","alt","alternatives","fallback"],"mappings":"AAAA,SAAuBA,KAAK,QAAO,UAAS;AAE5C;;;;;;;;;;CAUC,GACD,OAAO,SAASC,mBAAmBC,UAAkB;IACnD,MAAMC,OAAOH,MAAME;IACnB,IAAIC,KAAKC,IAAI,KAAK,UAAU;QAC1B,MAAM,IAAIC,MACR,CAAC,oEAAoE,EAAEF,KAAKC,IAAI,CAAC,WAAW,CAAC;IAEjG;IACAE,KAAKH;AACP;AAEA,SAASG,KAAKC,IAA0B;IACtC,IAAI,CAACA,MAAM;IAEX,OAAQA,KAAKH,IAAI;QACf,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;YAAS;gBACZE,KAAKC,KAAKC,IAAI;gBACd;YACF;QACA,KAAK;QACL,KAAK;QACL,KAAK;YAAM;gBACTF,KAAKC,KAAKE,IAAI;gBACdH,KAAKC,KAAKG,KAAK;gBACf;YACF;QACA,KAAK;YAAS;gBACZ,KAAK,MAAMC,MAAMJ,KAAKK,QAAQ,CAAEN,KAAKK,GAAGE,KAAK;gBAC7C;YACF;QACA,KAAK;YAAc;gBACjB,MAAM,IAAIR,MAAM;YAClB;QACA,KAAK;YAAS;gBACZ,MAAM,IAAIA,MAAM;YAClB;QACA,KAAK;YAAY;gBACf,IAAIE,KAAKO,SAAS,KAAK,QAAQ;oBAC7B,MAAM,IAAIT,MAAM;gBAClB;gBACA,KAAK,MAAMU,OAAOR,KAAKS,IAAI,CAAEV,KAAKS;gBAClC;YACF;QACA,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;YAAc;gBACjBT,KAAKC,KAAKC,IAAI;gBACdF,KAAKC,KAAKU,IAAI;gBACd;YACF;QACA,KAAK;YAAW;gBACdX,KAAKC,KAAKC,IAAI;gBACdF,KAAKC,KAAKE,IAAI;gBACdH,KAAKC,KAAKG,KAAK;gBACf;YACF;QACA,KAAK;YAAU;gBACb,KAAK,MAAMQ,QAAQX,KAAKY,UAAU,CAAE;oBAClC,OAAQD,KAAKd,IAAI;wBACf,KAAK;wBACL,KAAK;4BAAe;gCAClBE,KAAKY,KAAKL,KAAK;gCACf;4BACF;wBACA,KAAK;4BAA0B;gCAC7BP,KAAKY,KAAKE,SAAS;gCACnBd,KAAKY,KAAKL,KAAK;gCACf;4BACF;wBACA;oBACF;gBACF;gBACA;YACF;QACA,KAAK;YAAgB;gBACnBP,KAAKC,KAAKC,IAAI;gBACd,KAAK,MAAMO,OAAOR,KAAKS,IAAI,CAAEV,KAAKS;gBAClC;YACF;QACA,KAAK;YAAU;gBACb,KAAK,MAAMM,OAAOd,KAAKe,YAAY,CAAE;oBACnChB,KAAKe,IAAID,SAAS;oBAClBd,KAAKe,IAAIR,KAAK;gBAChB;gBACAP,KAAKC,KAAKgB,QAAQ;gBAClB;YACF;QACA;IACF;AACF"}