@botonic/plugin-flow-builder 0.50.2-alpha.0 → 0.51.0-alpha.0

package/src/content-fields/flow-custom-condition-v2.tsx

@@ -0,0 +1,133 @@
+import {
+  type BotContext,
+  EventAction,
+  type EventConditionalCustom,
+} from '@botonic/core'
+import {
+  getCommonFlowContentEventArgsForContentId,
+  trackEvent,
+} from '../tracking'
+import { ContentFieldsBase } from './content-fields-base'
+import {
+  evaluateBooleanCondition,
+  evaluateNumberCondition,
+  evaluateStringCondition,
+} from './custom-conditional-v2-evaluators'
+import {
+  type ConditionMatch,
+  findLastMatchingCondition,
+  resolveWithDefaultTarget,
+} from './custom-conditional-v2-resolver'
+import {
+  type HtBooleanCondition,
+  type HtCondition,
+  type HtCustomConditionalV2Node,
+  type HtNodeLink,
+  type HtNumberCondition,
+  type HtStringCondition,
+  VariableFormat,
+} from './hubtype-fields'
+
+export class FlowCustomConditionalV2 extends ContentFieldsBase {
+  public variableFormat: VariableFormat
+  public keyPath: string
+  public conditions: HtCondition[]
+  public defaultTarget: HtNodeLink
+  public customResult = ''
+
+  static fromHubtypeCMS(
+    component: HtCustomConditionalV2Node,
+    botContext: BotContext
+  ): FlowCustomConditionalV2 {
+    const newCustomConditionalV2 = new FlowCustomConditionalV2(component.id)
+    newCustomConditionalV2.code = component.code
+    newCustomConditionalV2.variableFormat = component.content.type
+    newCustomConditionalV2.keyPath = component.content.key_path
+    newCustomConditionalV2.conditions = component.content.conditions
+    newCustomConditionalV2.defaultTarget = component.content.default_target
+    newCustomConditionalV2.setFollowUp(botContext)
+
+    return newCustomConditionalV2
+  }
+
+  private setFollowUp(botContext: BotContext): void {
+    const botVariable = this.getValueFromKeyPath(botContext, this.keyPath)
+    const resolved = this.evaluateConditions(botVariable)
+
+    this.customResult = resolved.customResult
+    this.followUp = resolved.target
+  }
+
+  private evaluateConditions(botVariable: unknown): ConditionMatch {
+    switch (this.variableFormat) {
+      case VariableFormat.String: {
+        const match = findLastMatchingCondition(
+          this.conditions as HtStringCondition[],
+          botVariable,
+          this.variableFormat,
+          (variable, condition) =>
+            evaluateStringCondition(variable as string, condition)
+        )
+        return resolveWithDefaultTarget(match, this.defaultTarget, this.code)
+      }
+      case VariableFormat.Number: {
+        const match = findLastMatchingCondition(
+          this.conditions as HtNumberCondition[],
+          botVariable,
+          this.variableFormat,
+          (variable, condition) =>
+            evaluateNumberCondition(variable as number, condition)
+        )
+        return resolveWithDefaultTarget(match, this.defaultTarget, this.code)
+      }
+      case VariableFormat.Boolean: {
+        const match = findLastMatchingCondition(
+          this.conditions as HtBooleanCondition[],
+          botVariable,
+          this.variableFormat,
+          (variable, condition) =>
+            evaluateBooleanCondition(variable as boolean, condition)
+        )
+        return resolveWithDefaultTarget(
+          match,
+          this.defaultTarget,
+          this.code,
+          'false'
+        )
+      }
+      default:
+        throw new Error(
+          `Invalid variable format ${this.variableFormat} for custom condition node ${this.code}`
+        )
+    }
+  }
+
+  async trackFlow(botContext: BotContext): Promise<void> {
+    const { flowThreadId, flowId, flowName, flowNodeId, flowNodeContentId } =
+      getCommonFlowContentEventArgsForContentId(botContext, this.id)
+
+    const eventCustomConditional: EventConditionalCustom = {
+      action: EventAction.ConditionalCustom,
+      flowThreadId,
+      flowId,
+      flowName,
+      flowNodeId,
+      flowNodeContentId,
+      flowNodeIsMeaningful: false,
+      conditionalVariable: this.customResult,
+      variableFormat: this.variableFormat,
+    }
+    const { action, ...eventArgs } = eventCustomConditional
+    await trackEvent(botContext, action, eventArgs)
+  }
+
+  async processContent(botContext: BotContext): Promise<void> {
+    await this.filterContent(botContext, this)
+    await this.trackFlow(botContext)
+    return
+  }
+
+  toBotonic() {
+    return <></>
+  }
+}

package/src/content-fields/hubtype-fields/custom-conditional-v2.ts

@@ -0,0 +1,68 @@
+import type { HtBaseNode, HtNodeLink } from './common'
+import type { HtNodeWithContentType } from './node-types'
+
+export enum VariableFormat {
+  Boolean = 'boolean',
+  Number = 'number',
+  String = 'string',
+}
+
+export enum StringConditionOperator {
+  Contains = 'contains',
+  NotContains = 'notContains',
+  EqualsTo = 'equalsTo',
+  NotEqualsTo = 'notEqualsTo',
+  StartsWith = 'startsWith',
+  NotStartsWith = 'notStartsWith',
+  EndsWith = 'endsWith',
+  NotEndsWith = 'notEndsWith',
+}
+
+export interface HtStringCondition {
+  operator: StringConditionOperator
+  value?: string
+  target?: HtNodeLink
+}
+
+export enum NumberConditionOperator {
+  EqualsTo = 'equalsTo',
+  NotEqualsTo = 'notEqualsTo',
+  GreaterThan = 'greaterThan',
+  LessThan = 'lessThan',
+  GreaterThanOrEqualTo = 'greaterThanOrEqualTo',
+  LessThanOrEqualTo = 'lessThanOrEqualTo',
+  Between = 'between',
+  NotBetween = 'notBetween',
+}
+
+export interface HtNumberCondition {
+  operator: NumberConditionOperator
+  value?: number
+  min?: number
+  max?: number
+  target?: HtNodeLink
+}
+
+export enum BooleanConditionOperator {
+  IsTruthy = 'isTruthy',
+}
+
+export interface HtBooleanCondition {
+  operator: BooleanConditionOperator
+  target?: HtNodeLink
+}
+
+export type HtCondition =
+  | HtStringCondition
+  | HtNumberCondition
+  | HtBooleanCondition
+
+export interface HtCustomConditionalV2Node extends HtBaseNode {
+  type: HtNodeWithContentType.CUSTOM_CONDITION
+  content: {
+    type: VariableFormat
+    key_path: string
+    conditions: HtCondition[]
+    default_target: HtNodeLink
+  }
+}

package/src/content-fields/hubtype-fields/index.ts

@@ -5,6 +5,7 @@ export * from './button'
 export * from './capture-user-input'
 export * from './carousel'
 export * from './common'
+export * from './custom-conditional-v2'
 export * from './fallback'
 export * from './function'
 export * from './go-to-flow'

package/src/content-fields/hubtype-fields/node-types.ts

@@ -19,6 +19,7 @@ export enum HtNodeWithContentType {
   WEBVIEW = 'webview',
   GO_TO_FLOW = 'go-to-flow',
   CAPTURE_USER_INPUT = 'capture-user-input',
+  CUSTOM_CONDITION = 'custom-condition',
 }
 
 export enum HtNodeWithoutContentType {

package/src/content-fields/hubtype-fields/nodes.ts

@@ -3,6 +3,7 @@ import type { HtAiAgentRouterNode } from './ai-agent-router'
 import type { HtBotActionNode } from './bot-action'
 import type { HtCaptureUserInputNode } from './capture-user-input'
 import type { HtCarouselNode } from './carousel'
+import type { HtCustomConditionalV2Node } from './custom-conditional-v2'
 // import { HtChannelConditionalNode } from './channel-conditional'
 // import { HtCountryConditionalNode } from './country-conditional'
 // import { HtCustomConditionalNode } from './custom-conditional'
@@ -46,6 +47,7 @@ export type HtNodeWithContent =
   | HtGoToFlow
   | HtWhatsappTemplateNode
   | HtCaptureUserInputNode
+  | HtCustomConditionalV2Node
 // | HtChannelConditionalNode
 // | HtCountryConditionalNode
 // | HtCustomConditionalNode

package/src/content-fields/index.ts

@@ -5,6 +5,7 @@ import { FlowCaptureUserInput } from './flow-capture-user-input'
 import { FlowCarousel } from './flow-carousel'
 import { FlowChannelConditional } from './flow-channel-conditional'
 import { FlowCountryConditional } from './flow-country-conditional'
+import { FlowCustomConditionalV2 } from './flow-custom-condition-v2'
 import { FlowCustomConditional } from './flow-custom-conditional'
 import { FlowGoToFlow } from './flow-go-to-flow'
 import { FlowHandoff } from './flow-handoff'
@@ -44,6 +45,7 @@ export {
   FlowWhatsappButtonList,
   FlowWhatsappCtaUrlButtonNode,
   FlowWhatsappTemplate,
+  FlowCustomConditionalV2,
 }
 
 export type FlowContent =
@@ -66,5 +68,6 @@ export type FlowContent =
   | FlowGoToFlow
   | FlowCaptureUserInput
   | FlowAiAgentRouter
+  | FlowCustomConditionalV2
 
 export { DISABLED_MEMORY_LENGTH }

package/src/flow-factory.ts

@@ -10,6 +10,7 @@ import {
   type FlowContent,
   FlowCountryConditional,
   FlowCustomConditional,
+  FlowCustomConditionalV2,
   FlowGoToFlow,
   FlowHandoff,
   FlowImage,
@@ -102,6 +103,12 @@ export class FlowFactory {
       case HtNodeWithContentType.CAPTURE_USER_INPUT:
         return FlowCaptureUserInput.fromHubtypeCMS(hubtypeContent)
 
+      case HtNodeWithContentType.CUSTOM_CONDITION:
+        return FlowCustomConditionalV2.fromHubtypeCMS(
+          hubtypeContent,
+          this.botContext
+        )
+
       default:
         return undefined
     }