@sendbird/actionbook-core 0.10.1 → 0.10.3

package/dist/index.d.ts

@@ -222,6 +222,15 @@ declare function collectAllVariables(structures: JinjaIfStructure[]): Variable[]
  * @returns true/false if evaluation succeeded, null if parsing/evaluation failed
  */
 declare function evaluateCondition(condition: string, variables: Map<string, VariableValue>): boolean | null;
+interface ConditionValidationResult {
+    readonly valid: boolean;
+    readonly error?: string;
+}
+/**
+ * Validate a Jinja conditional expression without evaluating it.
+ * Returns a structured result with an error message on failure.
+ */
+declare function validateCondition(condition: string): ConditionValidationResult;
 
 type HighlightCategory = 'variable' | 'operator' | 'value' | 'punctuation';
 interface ConditionToken {
@@ -424,4 +433,4 @@ declare function actionbookToAST(manual: {
     logic: LogicV2;
 }): DocumentNode;
 
-export { ActionbookConversionError, type ActionbookJSON, AstNode, BlockNode, BlockquoteNode, BoldMark, type BranchDecision, BulletListNode, CodeMark, type ConditionToken, type DecisionTree, type DeleteOp, DeserializationError, DocumentNode, type DocumentTreeNode, type DocumentTreeNodeType, type EnumeratePathsIterOptions, type GotoEdge, type GotoEntryResolution, HardBreakNode, HeadingNode, type HighlightCategory, HorizontalRuleNode, InlineNode, type InsertOp, ItalicMark, type JinjaBlock, JinjaIfBlockNode, JinjaIfBranch, JinjaIfInlineNode, type JinjaIfStructure, type JinjaVisualBranch, type JinjaVisualStructure, JumpPointNode, LinkMark, type LintAsyncOptions, LintContext, LintResult, LintRule, LintSection, ListItemNode, LlmCompletionEndpoint, LlmLintRule, Mark, NodePath, NoteBlockNode, type Operation, OperationError, OrderedListNode, ParagraphNode, type ParseMarkdownOptions, type ReplaceOp, ResourceTagNode, ResourceTagType, StrikethroughMark, TableCellNode, TableNode, TableRowNode, TextNode, type Transaction, type TreeNode, type TreeNodeClassification, type TreeNodeLine, type TreeNodeType, type TreePath, type TreeSection, UnderlineMark, type ValidationError, type Variable, type VariableValue, type VisitOptions, actionbookToAST, analyzeJinjaBlocks, applyOperation, applyTransaction, blockquote, bold, buildDocumentTree, bulletList, chunkByHeading, code, collectAllVariables, comparePaths, defaultLlmRules, defaultRules, deserializeFromJSON, doc, enumeratePaths, enumeratePathsBySection, enumeratePathsIter, evaluateCondition, evaluateJinjaNodes, extractResourceTags, extractVariables, findAll, findDuplicateJumpPoints, fromMdast, generateDecisionTree, hardBreak, heading, horizontalRule, invertOperation, isBlock, isDocument, isInline, isTextNode, italic, jinjaBranch, jinjaIfBlock, jinjaIfInline, jumpPoint, link, lint, lintAsync, listItem, map, nodeAtPath, noteBlock, orderedList, paragraph, parentPath, parseFragment, parseMarkdown, pathFromString, pathToString, resolveGotoEntryPath, resourceTag, scanJinjaBlocks, serializeFragment, serializeToJSON, serializeToMarkdown, strikethrough, structureJinjaBlocks, table, tableCell, tableRow, text, textContent, toMdast, todoItem, tokenizeCondition, underline, validate, visit };
+export { ActionbookConversionError, type ActionbookJSON, AstNode, BlockNode, BlockquoteNode, BoldMark, type BranchDecision, BulletListNode, CodeMark, type ConditionToken, type ConditionValidationResult, type DecisionTree, type DeleteOp, DeserializationError, DocumentNode, type DocumentTreeNode, type DocumentTreeNodeType, type EnumeratePathsIterOptions, type GotoEdge, type GotoEntryResolution, HardBreakNode, HeadingNode, type HighlightCategory, HorizontalRuleNode, InlineNode, type InsertOp, ItalicMark, type JinjaBlock, JinjaIfBlockNode, JinjaIfBranch, JinjaIfInlineNode, type JinjaIfStructure, type JinjaVisualBranch, type JinjaVisualStructure, JumpPointNode, LinkMark, type LintAsyncOptions, LintContext, LintResult, LintRule, LintSection, ListItemNode, LlmCompletionEndpoint, LlmLintRule, Mark, NodePath, NoteBlockNode, type Operation, OperationError, OrderedListNode, ParagraphNode, type ParseMarkdownOptions, type ReplaceOp, ResourceTagNode, ResourceTagType, StrikethroughMark, TableCellNode, TableNode, TableRowNode, TextNode, type Transaction, type TreeNode, type TreeNodeClassification, type TreeNodeLine, type TreeNodeType, type TreePath, type TreeSection, UnderlineMark, type ValidationError, type Variable, type VariableValue, type VisitOptions, actionbookToAST, analyzeJinjaBlocks, applyOperation, applyTransaction, blockquote, bold, buildDocumentTree, bulletList, chunkByHeading, code, collectAllVariables, comparePaths, defaultLlmRules, defaultRules, deserializeFromJSON, doc, enumeratePaths, enumeratePathsBySection, enumeratePathsIter, evaluateCondition, evaluateJinjaNodes, extractResourceTags, extractVariables, findAll, findDuplicateJumpPoints, fromMdast, generateDecisionTree, hardBreak, heading, horizontalRule, invertOperation, isBlock, isDocument, isInline, isTextNode, italic, jinjaBranch, jinjaIfBlock, jinjaIfInline, jumpPoint, link, lint, lintAsync, listItem, map, nodeAtPath, noteBlock, orderedList, paragraph, parentPath, parseFragment, parseMarkdown, pathFromString, pathToString, resolveGotoEntryPath, resourceTag, scanJinjaBlocks, serializeFragment, serializeToJSON, serializeToMarkdown, strikethrough, structureJinjaBlocks, table, tableCell, tableRow, text, textContent, toMdast, todoItem, tokenizeCondition, underline, validate, validateCondition, visit };

package/dist/index.js

@@ -3627,7 +3627,7 @@ function tokenize(input) {
           i++;
         }
       }
-      if (i >= input.length) return [];
+      if (i >= input.length) return { tokens: [], error: "Unterminated string literal" };
       i++;
       tokens.push({ type: "STRING", value: str });
       continue;
@@ -3710,10 +3710,10 @@ function tokenize(input) {
       i++;
       continue;
     }
-    return [];
+    return { tokens: [], error: `Unexpected character: ${input[i]}` };
   }
   tokens.push({ type: "EOF", value: "" });
-  return tokens;
+  return { tokens };
 }
 var Parser = class {
   pos = 0;
@@ -3892,8 +3892,8 @@ function toNumber(v) {
 }
 function evaluateCondition(condition, variables) {
   try {
-    const tokens = tokenize(condition.trim());
-    if (tokens.length === 0) return null;
+    const { tokens, error } = tokenize(condition.trim());
+    if (error || tokens.length === 0) return null;
     const parser = new Parser(tokens, variables);
     const result = parser.evaluate();
     return isTruthy(result);
@@ -3901,6 +3901,21 @@ function evaluateCondition(condition, variables) {
     return null;
   }
 }
+function validateCondition(condition) {
+  const trimmed = condition.trim();
+  if (trimmed === "") return { valid: true };
+  const { tokens, error: tokenError } = tokenize(trimmed);
+  if (tokenError) return { valid: false, error: tokenError };
+  if (tokens.length === 0) return { valid: false, error: "Empty expression" };
+  try {
+    const parser = new Parser(tokens, /* @__PURE__ */ new Map());
+    parser.evaluate();
+    return { valid: true };
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : "Invalid expression";
+    return { valid: false, error: msg };
+  }
+}
 
 // src/jinja/conditionHighlighter.ts
 var KEYWORDS3 = {
@@ -5795,6 +5810,7 @@ export {
   tokenizeCondition,
   underline,
   validate,
+  validateCondition,
   visit
 };
 //# sourceMappingURL=index.js.map