@sendbird/actionbook-core 0.10.0 → 0.10.2

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

@@ -1,6 +1,6 @@
 // src/ast/types.ts
 var RESOURCE_TAG_TYPES = ["tool", "manual", "agent_message_template", "handoff", "time_diff", "time_difference"];
-var JUMP_POINT_ID_PATTERN = /^[A-Za-z_]+$/;
+var JUMP_POINT_ID_PATTERN = /^[\p{L}\p{N}_-]+$/u;
 
 // src/ast/builders.ts
 var bold = () => ({ type: "bold" });
@@ -18,7 +18,7 @@ var resourceTag = (tagType, resourceId, displayText) => ({
 });
 var jumpPoint = (id) => {
   if (!JUMP_POINT_ID_PATTERN.test(id)) {
-    throw new Error(`Invalid jump point ID: "${id}". Must match /^[A-Za-z_]+$/.`);
+    throw new Error(`Invalid jump point ID: "${id}". Letters, numbers, underscore, and hyphen only.`);
   }
   return { type: "jumpPoint", id };
 };
@@ -2134,7 +2134,7 @@ function resourceTagToMarkdown() {
 }
 
 // src/markdown/plugins/jumpPoint.ts
-var JUMP_POINT_RE = /\^([A-Za-z_]+)\^/g;
+var JUMP_POINT_RE = /\^([\p{L}\p{N}_-]+)\^/gu;
 function splitTextWithJumpPoints(text2) {
   const results = [];
   let lastIndex = 0;
@@ -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 = {
@@ -4325,7 +4340,7 @@ var duplicateJumpPoints = {
 };
 
 // src/lint/rules/jumpPointRefValidity.ts
-var JUMP_REF_PATTERN = /#([A-Za-z_]+)/g;
+var JUMP_REF_PATTERN = /#([\p{L}\p{N}_-]+)/gu;
 var jumpPointRefValidity = {
   id: "jump-point-ref-validity",
   description: "Detects references to non-existent jump point IDs",
@@ -4349,7 +4364,7 @@ var jumpPointRefValidity = {
           const t = node;
           const linkMark = t.marks?.find((m2) => m2.type === "link");
           if (linkMark && linkMark.type === "link") {
-            const match = /^#([A-Za-z_]+)$/.exec(linkMark.href);
+            const match = /^#([\p{L}\p{N}_-]+)$/u.exec(linkMark.href);
             if (match) {
               refs.push({ id: match[1] });
             }
@@ -4848,7 +4863,7 @@ function classifyNode(node) {
 }
 function hasSpeechContent(node) {
   for (const line of node.lines) {
-    const stripped = line.content.replace(/\{\{[^}]+\}\}/g, "").replace(/\^[A-Za-z_]+\^/g, "").replace(/\[[^\]]*\]\(#[^)]+\)/g, "").trim();
+    const stripped = line.content.replace(/\{\{[^}]+\}\}/g, "").replace(/\^[\p{L}\p{N}_-]+\^/gu, "").replace(/\[[^\]]*\]\(#[^)]+\)/g, "").trim();
     if (stripped.length > 0) return true;
   }
   return false;
@@ -5795,6 +5810,7 @@ export {
   tokenizeCondition,
   underline,
   validate,
+  validateCondition,
   visit
 };
 //# sourceMappingURL=index.js.map