@builder.io/sdk-svelte 5.1.0 → 5.1.1

package/lib/browser/components/block/components/block-wrapper.svelte

@@ -24,5 +24,11 @@ export let context;
     localState: $context.localState,
     context: $context.context,
     stripPrefix: true,
+    trackingContext: {
+      apiKey: $context.apiKey,
+      canTrack: $context.canTrack ?? true,
+      contentId: $context.content?.id,
+      variationId: $context.content?.testVariationId,
+    },
   })}><slot /></DynamicRenderer
 >

package/lib/browser/components/block/components/interactive-element.svelte

@@ -24,6 +24,12 @@ $: attributes = () => {
                 rootSetState: $context.rootSetState,
                 localState: $context.localState,
                 context: $context.context,
+                trackingContext: {
+                    apiKey: $context.apiKey,
+                    canTrack: $context.canTrack ?? true,
+                    contentId: $context.content?.id,
+                    variationId: $context.content?.testVariationId,
+                },
             }),
         }
         : {};

package/lib/browser/constants/sdk-version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.0";
+export declare const SDK_VERSION = "5.1.1";

package/lib/browser/constants/sdk-version.js

@@ -1 +1 @@
-export const SDK_VERSION = "5.1.0";
+export const SDK_VERSION = "5.1.1";

package/lib/browser/functions/evaluate/evaluate.d.ts

@@ -1,5 +1,5 @@
 import type { EvaluatorArgs } from './helpers';
 type EvalValue = unknown;
 export declare const getSimpleExpressionGetPath: (code: string) => string | undefined;
-export declare function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression }: EvaluatorArgs): EvalValue;
+export declare function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression, trackingContext }: EvaluatorArgs): EvalValue;
 export {};

package/lib/browser/functions/evaluate/evaluate.js

@@ -16,7 +16,7 @@ const VIRTUAL_INDEX_REGEX = /(\s)*var(\s)+_virtual_index(\s)*=(\s)*state(?<getPa
 export const getSimpleExpressionGetPath = (code) => {
     return STATE_GETTER_REGEX.exec(code.trim())?.groups?.getPath?.slice(1) || VIRTUAL_INDEX_REGEX.exec(code.trim())?.groups?.getPath?.slice(1);
 };
-export function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression = true }) {
+export function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression = true, trackingContext }) {
     if (code.trim() === '') {
         return undefined;
     }
@@ -37,7 +37,7 @@ export function evaluate({ code, context, localState, rootState, rootSetState, e
         code: parseCode(code, {
             isExpression
         }),
-        builder: getBuilderGlobals(),
+        builder: getBuilderGlobals(trackingContext),
         context,
         event,
         rootSetState,

package/lib/browser/functions/evaluate/helpers.d.ts

@@ -1,14 +1,22 @@
 import type { BuilderContextInterface, BuilderRenderState } from '../../context/types';
 import { getUserAttributes } from '../track/helpers';
+export type TrackingContext = {
+    apiKey: string | null;
+    canTrack?: boolean;
+    contentId?: string;
+    variationId?: string;
+};
 export type EvaluatorArgs = Omit<ExecutorArgs, 'builder' | 'event'> & {
     event?: Event;
     isExpression?: boolean;
+    trackingContext?: TrackingContext;
 };
 export type BuilderGlobals = {
     isEditing: boolean | undefined;
     isBrowser: boolean | undefined;
     isServer: boolean | undefined;
     getUserAttributes: typeof getUserAttributes;
+    trackConversion: (amount?: number, customProperties?: Record<string, any>) => void;
 };
 export type ExecutorArgs = Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'> & {
     code: string;
@@ -20,7 +28,7 @@ export type FunctionArguments = ReturnType<typeof getFunctionArguments>;
 export declare const getFunctionArguments: ({ builder, context, event, state }: Pick<ExecutorArgs, "context" | "builder" | "event"> & {
     state: BuilderRenderState;
 }) => [string, Event | BuilderRenderState | import("../../context/types").BuilderRenderContext | BuilderGlobals | undefined][];
-export declare const getBuilderGlobals: () => BuilderGlobals;
+export declare const getBuilderGlobals: (trackingContext?: TrackingContext) => BuilderGlobals;
 export declare const parseCode: (code: string, { isExpression }: Pick<EvaluatorArgs, 'isExpression'>) => string;
 export declare function flattenState({ rootState, localState, rootSetState }: {
     rootState: Record<string | symbol, any>;

package/lib/browser/functions/evaluate/helpers.js

@@ -1,6 +1,7 @@
 import { isBrowser } from '../is-browser';
 import { isEditing } from '../is-editing';
 import { getUserAttributes } from '../track/helpers';
+import { _track } from '../track/index';
 export const getFunctionArguments = ({ builder, context, event, state }) => {
     return Object.entries({
         state,
@@ -11,11 +12,29 @@ export const getFunctionArguments = ({ builder, context, event, state }) => {
         event
     });
 };
-export const getBuilderGlobals = () => ({
+export const getBuilderGlobals = (trackingContext) => ({
     isEditing: isEditing(),
     isBrowser: isBrowser(),
     isServer: !isBrowser(),
-    getUserAttributes: () => getUserAttributes()
+    getUserAttributes: () => getUserAttributes(),
+    trackConversion: (amount, customProperties) => {
+        if (!trackingContext?.apiKey || trackingContext?.canTrack === false) {
+            return;
+        }
+        _track({
+            type: 'conversion',
+            apiKey: trackingContext.apiKey,
+            canTrack: trackingContext.canTrack ?? true,
+            contentId: trackingContext.contentId,
+            variationId: trackingContext.variationId !== trackingContext.contentId ? trackingContext.variationId : undefined,
+            metadata: {
+                ...(customProperties || {}),
+                ...(amount !== undefined ? {
+                    amount
+                } : {})
+            }
+        });
+    }
 });
 export const parseCode = (code, { isExpression = true }) => {
     // Be able to handle simple expressions like "state.foo" or "1 + 1"

package/lib/browser/functions/get-block-actions-handler.d.ts

@@ -1,7 +1,9 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 type Options = {
     block: BuilderBlock;
+    trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>;
 type EventHandler = (event: Event) => any;
 export declare const createEventHandler: (value: string, options: Options) => EventHandler;

package/lib/browser/functions/get-block-actions-handler.js

@@ -6,5 +6,6 @@ export const createEventHandler = (value, options) => event => evaluate({
     rootState: options.rootState,
     rootSetState: options.rootSetState,
     event,
-    isExpression: false
+    isExpression: false,
+    trackingContext: options.trackingContext
 });

package/lib/browser/functions/get-block-actions.d.ts

@@ -1,10 +1,12 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 type Actions = {
     [index: string]: (event: Event) => any;
 };
 export declare function getBlockActions(options: {
     block: BuilderBlock;
     stripPrefix?: boolean;
+    trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>): Actions;
 export {};

package/lib/edge/components/block/components/block-wrapper.svelte

@@ -24,5 +24,11 @@ export let context;
     localState: $context.localState,
     context: $context.context,
     stripPrefix: true,
+    trackingContext: {
+      apiKey: $context.apiKey,
+      canTrack: $context.canTrack ?? true,
+      contentId: $context.content?.id,
+      variationId: $context.content?.testVariationId,
+    },
   })}><slot /></DynamicRenderer
 >

package/lib/edge/components/block/components/interactive-element.svelte

@@ -24,6 +24,12 @@ $: attributes = () => {
                 rootSetState: $context.rootSetState,
                 localState: $context.localState,
                 context: $context.context,
+                trackingContext: {
+                    apiKey: $context.apiKey,
+                    canTrack: $context.canTrack ?? true,
+                    contentId: $context.content?.id,
+                    variationId: $context.content?.testVariationId,
+                },
             }),
         }
         : {};

package/lib/edge/constants/sdk-version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.0";
+export declare const SDK_VERSION = "5.1.1";

package/lib/edge/constants/sdk-version.js

@@ -1 +1 @@
-export const SDK_VERSION = "5.1.0";
+export const SDK_VERSION = "5.1.1";

package/lib/edge/functions/evaluate/evaluate.d.ts

@@ -1,5 +1,5 @@
 import type { EvaluatorArgs } from './helpers';
 type EvalValue = unknown;
 export declare const getSimpleExpressionGetPath: (code: string) => string | undefined;
-export declare function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression }: EvaluatorArgs): EvalValue;
+export declare function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression, trackingContext }: EvaluatorArgs): EvalValue;
 export {};

package/lib/edge/functions/evaluate/evaluate.js

@@ -16,7 +16,7 @@ const VIRTUAL_INDEX_REGEX = /(\s)*var(\s)+_virtual_index(\s)*=(\s)*state(?<getPa
 export const getSimpleExpressionGetPath = (code) => {
     return STATE_GETTER_REGEX.exec(code.trim())?.groups?.getPath?.slice(1) || VIRTUAL_INDEX_REGEX.exec(code.trim())?.groups?.getPath?.slice(1);
 };
-export function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression = true }) {
+export function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression = true, trackingContext }) {
     if (code.trim() === '') {
         return undefined;
     }
@@ -37,7 +37,7 @@ export function evaluate({ code, context, localState, rootState, rootSetState, e
         code: parseCode(code, {
             isExpression
         }),
-        builder: getBuilderGlobals(),
+        builder: getBuilderGlobals(trackingContext),
         context,
         event,
         rootSetState,

package/lib/edge/functions/evaluate/helpers.d.ts

@@ -1,14 +1,22 @@
 import type { BuilderContextInterface, BuilderRenderState } from '../../context/types';
 import { getUserAttributes } from '../track/helpers';
+export type TrackingContext = {
+    apiKey: string | null;
+    canTrack?: boolean;
+    contentId?: string;
+    variationId?: string;
+};
 export type EvaluatorArgs = Omit<ExecutorArgs, 'builder' | 'event'> & {
     event?: Event;
     isExpression?: boolean;
+    trackingContext?: TrackingContext;
 };
 export type BuilderGlobals = {
     isEditing: boolean | undefined;
     isBrowser: boolean | undefined;
     isServer: boolean | undefined;
     getUserAttributes: typeof getUserAttributes;
+    trackConversion: (amount?: number, customProperties?: Record<string, any>) => void;
 };
 export type ExecutorArgs = Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'> & {
     code: string;
@@ -20,7 +28,7 @@ export type FunctionArguments = ReturnType<typeof getFunctionArguments>;
 export declare const getFunctionArguments: ({ builder, context, event, state }: Pick<ExecutorArgs, "context" | "builder" | "event"> & {
     state: BuilderRenderState;
 }) => [string, Event | BuilderRenderState | import("../../context/types").BuilderRenderContext | BuilderGlobals | undefined][];
-export declare const getBuilderGlobals: () => BuilderGlobals;
+export declare const getBuilderGlobals: (trackingContext?: TrackingContext) => BuilderGlobals;
 export declare const parseCode: (code: string, { isExpression }: Pick<EvaluatorArgs, 'isExpression'>) => string;
 export declare function flattenState({ rootState, localState, rootSetState }: {
     rootState: Record<string | symbol, any>;

package/lib/edge/functions/evaluate/helpers.js

@@ -1,6 +1,7 @@
 import { isBrowser } from '../is-browser';
 import { isEditing } from '../is-editing';
 import { getUserAttributes } from '../track/helpers';
+import { _track } from '../track/index';
 export const getFunctionArguments = ({ builder, context, event, state }) => {
     return Object.entries({
         state,
@@ -11,11 +12,29 @@ export const getFunctionArguments = ({ builder, context, event, state }) => {
         event
     });
 };
-export const getBuilderGlobals = () => ({
+export const getBuilderGlobals = (trackingContext) => ({
     isEditing: isEditing(),
     isBrowser: isBrowser(),
     isServer: !isBrowser(),
-    getUserAttributes: () => getUserAttributes()
+    getUserAttributes: () => getUserAttributes(),
+    trackConversion: (amount, customProperties) => {
+        if (!trackingContext?.apiKey || trackingContext?.canTrack === false) {
+            return;
+        }
+        _track({
+            type: 'conversion',
+            apiKey: trackingContext.apiKey,
+            canTrack: trackingContext.canTrack ?? true,
+            contentId: trackingContext.contentId,
+            variationId: trackingContext.variationId !== trackingContext.contentId ? trackingContext.variationId : undefined,
+            metadata: {
+                ...(customProperties || {}),
+                ...(amount !== undefined ? {
+                    amount
+                } : {})
+            }
+        });
+    }
 });
 export const parseCode = (code, { isExpression = true }) => {
     // Be able to handle simple expressions like "state.foo" or "1 + 1"

package/lib/edge/functions/get-block-actions-handler.d.ts

@@ -1,7 +1,9 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 type Options = {
     block: BuilderBlock;
+    trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>;
 type EventHandler = (event: Event) => any;
 export declare const createEventHandler: (value: string, options: Options) => EventHandler;

package/lib/edge/functions/get-block-actions-handler.js

@@ -6,5 +6,6 @@ export const createEventHandler = (value, options) => event => evaluate({
     rootState: options.rootState,
     rootSetState: options.rootSetState,
     event,
-    isExpression: false
+    isExpression: false,
+    trackingContext: options.trackingContext
 });

package/lib/edge/functions/get-block-actions.d.ts

@@ -1,10 +1,12 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 type Actions = {
     [index: string]: (event: Event) => any;
 };
 export declare function getBlockActions(options: {
     block: BuilderBlock;
     stripPrefix?: boolean;
+    trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>): Actions;
 export {};

package/lib/node/components/block/components/block-wrapper.svelte

@@ -24,5 +24,11 @@ export let context;
     localState: $context.localState,
     context: $context.context,
     stripPrefix: true,
+    trackingContext: {
+      apiKey: $context.apiKey,
+      canTrack: $context.canTrack ?? true,
+      contentId: $context.content?.id,
+      variationId: $context.content?.testVariationId,
+    },
   })}><slot /></DynamicRenderer
 >

package/lib/node/components/block/components/interactive-element.svelte

@@ -24,6 +24,12 @@ $: attributes = () => {
                 rootSetState: $context.rootSetState,
                 localState: $context.localState,
                 context: $context.context,
+                trackingContext: {
+                    apiKey: $context.apiKey,
+                    canTrack: $context.canTrack ?? true,
+                    contentId: $context.content?.id,
+                    variationId: $context.content?.testVariationId,
+                },
             }),
         }
         : {};

package/lib/node/constants/sdk-version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.0";
+export declare const SDK_VERSION = "5.1.1";

package/lib/node/constants/sdk-version.js

@@ -1 +1 @@
-export const SDK_VERSION = "5.1.0";
+export const SDK_VERSION = "5.1.1";

package/lib/node/functions/evaluate/evaluate.d.ts

@@ -1,5 +1,5 @@
 import type { EvaluatorArgs } from './helpers';
 type EvalValue = unknown;
 export declare const getSimpleExpressionGetPath: (code: string) => string | undefined;
-export declare function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression }: EvaluatorArgs): EvalValue;
+export declare function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression, trackingContext }: EvaluatorArgs): EvalValue;
 export {};

package/lib/node/functions/evaluate/evaluate.js

@@ -16,7 +16,7 @@ const VIRTUAL_INDEX_REGEX = /(\s)*var(\s)+_virtual_index(\s)*=(\s)*state(?<getPa
 export const getSimpleExpressionGetPath = (code) => {
     return STATE_GETTER_REGEX.exec(code.trim())?.groups?.getPath?.slice(1) || VIRTUAL_INDEX_REGEX.exec(code.trim())?.groups?.getPath?.slice(1);
 };
-export function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression = true }) {
+export function evaluate({ code, context, localState, rootState, rootSetState, event, isExpression = true, trackingContext }) {
     if (code.trim() === '') {
         return undefined;
     }
@@ -37,7 +37,7 @@ export function evaluate({ code, context, localState, rootState, rootSetState, e
         code: parseCode(code, {
             isExpression
         }),
-        builder: getBuilderGlobals(),
+        builder: getBuilderGlobals(trackingContext),
         context,
         event,
         rootSetState,

package/lib/node/functions/evaluate/helpers.d.ts

@@ -1,14 +1,22 @@
 import type { BuilderContextInterface, BuilderRenderState } from '../../context/types';
 import { getUserAttributes } from '../track/helpers';
+export type TrackingContext = {
+    apiKey: string | null;
+    canTrack?: boolean;
+    contentId?: string;
+    variationId?: string;
+};
 export type EvaluatorArgs = Omit<ExecutorArgs, 'builder' | 'event'> & {
     event?: Event;
     isExpression?: boolean;
+    trackingContext?: TrackingContext;
 };
 export type BuilderGlobals = {
     isEditing: boolean | undefined;
     isBrowser: boolean | undefined;
     isServer: boolean | undefined;
     getUserAttributes: typeof getUserAttributes;
+    trackConversion: (amount?: number, customProperties?: Record<string, any>) => void;
 };
 export type ExecutorArgs = Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'> & {
     code: string;
@@ -20,7 +28,7 @@ export type FunctionArguments = ReturnType<typeof getFunctionArguments>;
 export declare const getFunctionArguments: ({ builder, context, event, state }: Pick<ExecutorArgs, "context" | "builder" | "event"> & {
     state: BuilderRenderState;
 }) => [string, Event | BuilderRenderState | import("../../context/types").BuilderRenderContext | BuilderGlobals | undefined][];
-export declare const getBuilderGlobals: () => BuilderGlobals;
+export declare const getBuilderGlobals: (trackingContext?: TrackingContext) => BuilderGlobals;
 export declare const parseCode: (code: string, { isExpression }: Pick<EvaluatorArgs, 'isExpression'>) => string;
 export declare function flattenState({ rootState, localState, rootSetState }: {
     rootState: Record<string | symbol, any>;

package/lib/node/functions/evaluate/helpers.js

@@ -1,6 +1,7 @@
 import { isBrowser } from '../is-browser';
 import { isEditing } from '../is-editing';
 import { getUserAttributes } from '../track/helpers';
+import { _track } from '../track/index';
 export const getFunctionArguments = ({ builder, context, event, state }) => {
     return Object.entries({
         state,
@@ -11,11 +12,29 @@ export const getFunctionArguments = ({ builder, context, event, state }) => {
         event
     });
 };
-export const getBuilderGlobals = () => ({
+export const getBuilderGlobals = (trackingContext) => ({
     isEditing: isEditing(),
     isBrowser: isBrowser(),
     isServer: !isBrowser(),
-    getUserAttributes: () => getUserAttributes()
+    getUserAttributes: () => getUserAttributes(),
+    trackConversion: (amount, customProperties) => {
+        if (!trackingContext?.apiKey || trackingContext?.canTrack === false) {
+            return;
+        }
+        _track({
+            type: 'conversion',
+            apiKey: trackingContext.apiKey,
+            canTrack: trackingContext.canTrack ?? true,
+            contentId: trackingContext.contentId,
+            variationId: trackingContext.variationId !== trackingContext.contentId ? trackingContext.variationId : undefined,
+            metadata: {
+                ...(customProperties || {}),
+                ...(amount !== undefined ? {
+                    amount
+                } : {})
+            }
+        });
+    }
 });
 export const parseCode = (code, { isExpression = true }) => {
     // Be able to handle simple expressions like "state.foo" or "1 + 1"

package/lib/node/functions/get-block-actions-handler.d.ts

@@ -1,7 +1,9 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 type Options = {
     block: BuilderBlock;
+    trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>;
 type EventHandler = (event: Event) => any;
 export declare const createEventHandler: (value: string, options: Options) => EventHandler;

package/lib/node/functions/get-block-actions-handler.js

@@ -6,5 +6,6 @@ export const createEventHandler = (value, options) => event => evaluate({
     rootState: options.rootState,
     rootSetState: options.rootSetState,
     event,
-    isExpression: false
+    isExpression: false,
+    trackingContext: options.trackingContext
 });

package/lib/node/functions/get-block-actions.d.ts

@@ -1,10 +1,12 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 type Actions = {
     [index: string]: (event: Event) => any;
 };
 export declare function getBlockActions(options: {
     block: BuilderBlock;
     stripPrefix?: boolean;
+    trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>): Actions;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@builder.io/sdk-svelte",
   "description": "Builder.io SDK for Svelte",
-  "version": "5.1.0",
+  "version": "5.1.1",
   "type": "module",
   "files": [
     "lib",

package/src/components/block/components/block-wrapper.svelte

@@ -37,5 +37,11 @@
     localState: $context.localState,
     context: $context.context,
     stripPrefix: true,
+    trackingContext: {
+      apiKey: $context.apiKey,
+      canTrack: $context.canTrack ?? true,
+      contentId: $context.content?.id,
+      variationId: $context.content?.testVariationId,
+    },
   })}><slot /></DynamicRenderer
 >

package/src/components/block/components/interactive-element.svelte

@@ -40,6 +40,12 @@
             rootSetState: $context.rootSetState,
             localState: $context.localState,
             context: $context.context,
+            trackingContext: {
+              apiKey: $context.apiKey,
+              canTrack: $context.canTrack ?? true,
+              contentId: $context.content?.id,
+              variationId: $context.content?.testVariationId,
+            },
           }),
         }
       : {};

package/src/constants/sdk-version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "5.1.0"
+export const SDK_VERSION = "5.1.1"

package/src/functions/evaluate/evaluate.ts

@@ -27,7 +27,8 @@ export function evaluate({
   rootState,
   rootSetState,
   event,
-  isExpression = true
+  isExpression = true,
+  trackingContext
 }: EvaluatorArgs): EvalValue {
   if (code.trim() === '') {
     return undefined;
@@ -50,7 +51,7 @@ export function evaluate({
     code: parseCode(code, {
       isExpression
     }),
-    builder: getBuilderGlobals(),
+    builder: getBuilderGlobals(trackingContext),
     context,
     event,
     rootSetState,

package/src/functions/evaluate/helpers.ts

@@ -2,15 +2,24 @@ import type { BuilderContextInterface, BuilderRenderState } from '../../context/
 import { isBrowser } from '../is-browser';
 import { isEditing } from '../is-editing';
 import { getUserAttributes } from '../track/helpers';
+import { _track } from '../track/index';
+export type TrackingContext = {
+  apiKey: string | null;
+  canTrack?: boolean;
+  contentId?: string;
+  variationId?: string;
+};
 export type EvaluatorArgs = Omit<ExecutorArgs, 'builder' | 'event'> & {
   event?: Event;
   isExpression?: boolean;
+  trackingContext?: TrackingContext;
 };
 export type BuilderGlobals = {
   isEditing: boolean | undefined;
   isBrowser: boolean | undefined;
   isServer: boolean | undefined;
   getUserAttributes: typeof getUserAttributes;
+  trackConversion: (amount?: number, customProperties?: Record<string, any>) => void;
 };
 export type ExecutorArgs = Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'> & {
   code: string;
@@ -36,11 +45,29 @@ export const getFunctionArguments = ({
     event
   });
 };
-export const getBuilderGlobals = (): BuilderGlobals => ({
+export const getBuilderGlobals = (trackingContext?: TrackingContext): BuilderGlobals => ({
   isEditing: isEditing(),
   isBrowser: isBrowser(),
   isServer: !isBrowser(),
-  getUserAttributes: () => getUserAttributes()
+  getUserAttributes: () => getUserAttributes(),
+  trackConversion: (amount?: number, customProperties?: Record<string, any>) => {
+    if (!trackingContext?.apiKey || trackingContext?.canTrack === false) {
+      return;
+    }
+    _track({
+      type: 'conversion',
+      apiKey: trackingContext.apiKey,
+      canTrack: trackingContext.canTrack ?? true,
+      contentId: trackingContext.contentId,
+      variationId: trackingContext.variationId !== trackingContext.contentId ? trackingContext.variationId : undefined,
+      metadata: {
+        ...(customProperties || {}),
+        ...(amount !== undefined ? {
+          amount
+        } : {})
+      }
+    });
+  }
 });
 export const parseCode = (code: string, {
   isExpression = true

package/src/functions/get-block-actions-handler.ts

@@ -1,8 +1,10 @@
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 import { evaluate } from './evaluate/index';
 type Options = {
   block: BuilderBlock;
+  trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>;
 type EventHandler = (event: Event) => any;
 export const createEventHandler = (value: string, options: Options): EventHandler => event => evaluate({
@@ -12,5 +14,6 @@ export const createEventHandler = (value: string, options: Options): EventHandle
   rootState: options.rootState,
   rootSetState: options.rootSetState,
   event,
-  isExpression: false
+  isExpression: false,
+  trackingContext: options.trackingContext
 })

package/src/functions/get-block-actions.ts

@@ -1,6 +1,7 @@
 import { TARGET } from '../constants/target';
 import type { BuilderContextInterface } from '../context/types';
 import type { BuilderBlock } from '../types/builder-block';
+import type { TrackingContext } from './evaluate/helpers';
 import { getEventHandlerName } from './event-handler-name';
 import { createEventHandler } from './get-block-actions-handler';
 type Actions = {
@@ -9,6 +10,7 @@ type Actions = {
 export function getBlockActions(options: {
   block: BuilderBlock;
   stripPrefix?: boolean;
+  trackingContext?: TrackingContext;
 } & Pick<BuilderContextInterface, 'localState' | 'context' | 'rootState' | 'rootSetState'>): Actions {
   const obj: Actions = {};
   const optionActions = options.block.actions ?? {};