@screeb/sdk-browser 0.1.18 → 0.2.1

package/dist/cjs/hooks.types.d.ts

@@ -16,6 +16,10 @@ export type Survey = {
     survey_format: SurveyFormat;
     survey_size: 100;
 };
+export type Message = {
+    id: string;
+    messagey_size: 100;
+};
 export type ResponseStatus = "displayed" | "started" | "ended" | "closed" | "interrupted";
 export type ResponseItemQuestion = {
     id: string;
@@ -40,42 +44,110 @@ export type ResponseItem = {
 export type HookCommonProperties = {
     channel: Channel;
     user: User;
+};
+export type HookCommonPropertiesSurvey = HookCommonProperties & {
     survey: Survey;
 };
+export type HookCommonPropertiesMessage = HookCommonProperties & {
+    message: Message;
+};
 export type HookOnReady = (data: {
     channel: Channel;
     user: User;
 }) => void;
-export type HookOnSurveyShowed = (data: HookCommonProperties & {
+export type HookOnSurveyDisplayAllowed = (data: HookCommonPropertiesSurvey) => boolean;
+export type HookOnMessageDisplayAllowed = (data: HookCommonPropertiesSurvey) => boolean;
+export type HookOnSurveyShowed = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
         items: ResponseItem[];
     };
 }) => void;
-export type HookOnSurveyStarted = (data: HookCommonProperties & {
+export type HookOnSurveyStarted = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
     };
 }) => void;
-export type HookOnQuestionReplied = (data: HookCommonProperties & {
+export type HookOnSurveyCompleted = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
-        status: null;
-        question: ResponseItemQuestion;
-        answer: ResponseItemAnswer;
         items: ResponseItem[];
     };
 }) => void;
-export type HookOnSurveyCompleted = (data: HookCommonProperties & {
+export type HookOnSurveyHidden = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
         items: ResponseItem[];
+        hide_reason: ResponseStatus;
+    };
+}) => void;
+export type HookOnMessageShowed = (data: HookCommonPropertiesMessage & {
+    response: {
+        id: string;
+        items: ResponseItem[];
+    };
+}) => void;
+export type HookOnMessageStarted = (data: HookCommonPropertiesMessage & {
+    response: {
+        id: string;
     };
 }) => void;
-export type HookOnSurveyHidden = (data: HookCommonProperties & {
+export type HookOnMessageCompleted = (data: HookCommonPropertiesMessage & {
+    response: {
+        id: string;
+        items: ResponseItem[];
+    };
+}) => void;
+export type HookOnMessageHidden = (data: HookCommonPropertiesMessage & {
     response: {
         id: string;
         items: ResponseItem[];
         hide_reason: ResponseStatus;
     };
 }) => void;
+export type HookOnQuestionReplied = (data: HookCommonPropertiesSurvey & {
+    response: {
+        id: string;
+        status: null;
+        question: ResponseItemQuestion;
+        answer: ResponseItemAnswer;
+        items: ResponseItem[];
+    };
+}) => void;
+/** This is the Screeb tag hooks object available on `survey.start` command. */
+export type HooksSurveyStart = {
+    /** This hook is triggered when a survey is displayed on screen (also triggered when page is reloaded) */
+    onSurveyShowed?: HookOnSurveyShowed;
+    /** This hook is triggered when a survey is started */
+    onSurveyStarted?: HookOnSurveyStarted;
+    /** This hook is triggered when a survey is completed */
+    onSurveyCompleted?: HookOnSurveyCompleted;
+    /** This hook is triggered when a survey is hidden */
+    onSurveyHidden?: HookOnSurveyHidden;
+    /** This hook is triggered when a question is answered */
+    onQuestionReplied?: HookOnQuestionReplied;
+};
+/** This is the Screeb tag hooks object available on `message.start` command. */
+export type HooksMessageStart = {
+    /** This hook is triggered when a message is displayed on screen (also triggered when page is reloaded) */
+    onMessageShowed?: HookOnMessageShowed;
+    /** This hook is triggered when a message is started */
+    onMessageStarted?: HookOnMessageStarted;
+    /** This hook is triggered when a message is completed */
+    onMessageCompleted?: HookOnMessageCompleted;
+    /** This hook is triggered when a message is hidden */
+    onMessageHidden?: HookOnMessageHidden;
+    /** This hook is triggered when a question is answered */
+    onQuestionReplied?: HookOnQuestionReplied;
+};
+/** This is the Screeb tag hooks object available on `init` command. */
+export type HooksInit = HooksSurveyStart & HooksMessageStart & {
+    /** This defines the version of hooks and their data */
+    version: string;
+    /** This hook is triggered when Screeb SD is loaded, initialized and ready to rock */
+    onReady?: HookOnReady;
+    /** This hook is triggered before a survey displays to allow it or not. */
+    onSurveyDisplayAllowed?: HookOnSurveyDisplayAllowed;
+    /** This hook is triggered before a message displays to allow it or not. */
+    onMessageDisplayAllowed?: HookOnMessageDisplayAllowed;
+};

package/dist/cjs/index.cjs

@@ -412,6 +412,7 @@ var surveyClose = function () { return callScreebCommand("survey.close"); };
  *
  * Screeb.surveyStart(
  *   '<UUID>',
+ *   '<UUID>',
  *   false,
  *   {
  *     color: "green",
@@ -425,10 +426,11 @@ var surveyClose = function () { return callScreebCommand("survey.close"); };
  * );
  * ```
  */
-var surveyStart = function (surveyId, allowMultipleResponses, hiddenFields, hooks, language) {
+var surveyStart = function (surveyId, distributionId, allowMultipleResponses, hiddenFields, hooks, language) {
     if (allowMultipleResponses === void 0) { allowMultipleResponses = true; }
     if (hiddenFields === void 0) { hiddenFields = {}; }
     return callScreebCommand("survey.start", surveyId, {
+        distribution_id: distributionId,
         allow_multiple_responses: allowMultipleResponses,
         language: language,
         hidden_fields: hiddenFields,
@@ -531,4 +533,4 @@ exports.surveyClose = surveyClose;
 exports.surveyStart = surveyStart;
 exports.targetingCheck = targetingCheck;
 exports.targetingDebug = targetingDebug;
-CONSTANTS.version = '0.1.18'
+CONSTANTS.version = '0.2.1'

package/dist/cjs/index.d.ts

@@ -1,4 +1,5 @@
-import { Hooks, PropertyRecord, ScreebIdentityGetReturn, ScreebOptions } from "./types";
+import { HooksInit, HooksMessageStart, HooksSurveyStart } from "./hooks.types";
+import { PropertyRecord, ScreebIdentityGetReturn, ScreebOptions } from "./types";
 export * from "./types";
 export * from "./hooks.types";
 /**
@@ -54,7 +55,7 @@ export declare const load: (options?: ScreebOptions) => Promise<undefined>;
  * );
  * ```
  */
-export declare const init: (websiteId: string, userId?: string, userProperties?: PropertyRecord, hooks?: Hooks, language?: string) => void | Promise<unknown>;
+export declare const init: (websiteId: string, userId?: string, userProperties?: PropertyRecord, hooks?: HooksInit, language?: string) => void | Promise<unknown>;
 /**
  * Checks if Screeb tag has been loaded.
  *
@@ -301,6 +302,7 @@ export declare const surveyClose: () => void | Promise<unknown>;
  *
  * Screeb.surveyStart(
  *   '<UUID>',
+ *   '<UUID>',
  *   false,
  *   {
  *     color: "green",
@@ -314,7 +316,7 @@ export declare const surveyClose: () => void | Promise<unknown>;
  * );
  * ```
  */
-export declare const surveyStart: (surveyId: string, allowMultipleResponses?: boolean, hiddenFields?: PropertyRecord, hooks?: Hooks, language?: string) => void | Promise<unknown>;
+export declare const surveyStart: (surveyId: string, distributionId: string, allowMultipleResponses?: boolean, hiddenFields?: PropertyRecord, hooks?: HooksSurveyStart, language?: string) => void | Promise<unknown>;
 /**
  * Interrupts a running message.
  *
@@ -348,7 +350,7 @@ export declare const messageClose: () => void | Promise<unknown>;
  * );
  * ```
  */
-export declare const messageStart: (messageId: string, hiddenFields?: PropertyRecord, hooks?: Hooks, language?: string) => void | Promise<unknown>;
+export declare const messageStart: (messageId: string, hiddenFields?: PropertyRecord, hooks?: HooksMessageStart, language?: string) => void | Promise<unknown>;
 /**
  * Forces a targeting check.
  *

package/dist/cjs/types.d.ts

@@ -1,4 +1,3 @@
-import { HookOnQuestionReplied, HookOnReady, HookOnSurveyCompleted, HookOnSurveyHidden, HookOnSurveyShowed, HookOnSurveyStarted } from "./hooks.types";
 /** This is property types that are supported by Screeb. */
 export type PropertyType = number | boolean | string | Date | PropertyRecord;
 /** This is a property object that are supported by Screeb. */
@@ -45,20 +44,3 @@ export type ScreebIdentityGetReturn = {
     /** `true` if the tag is loaded, initialized and ready to rock */
     is_ready: boolean;
 };
-/** This is the Screeb tag hooks object. */
-export type Hooks = {
-    /** This defines the version of hooks and their data */
-    version: string;
-    /** This hook is triggered when Screeb SD is loaded, initialized and ready to rock */
-    onReady?: HookOnReady;
-    /** This hook is triggered when a survey is displayed on screen (also triggered when page is reloaded) */
-    onSurveyShowed?: HookOnSurveyShowed;
-    /** This hook is triggered when a survey is started */
-    onSurveyStarted?: HookOnSurveyStarted;
-    /** This hook is triggered when a question is answered */
-    onQuestionReplied?: HookOnQuestionReplied;
-    /** This hook is triggered when a survey is completed */
-    onSurveyCompleted?: HookOnSurveyCompleted;
-    /** This hook is triggered when a survey is hidden */
-    onSurveyHidden?: HookOnSurveyHidden;
-};

package/dist/es/hooks.types.d.ts

@@ -16,6 +16,10 @@ export type Survey = {
     survey_format: SurveyFormat;
     survey_size: 100;
 };
+export type Message = {
+    id: string;
+    messagey_size: 100;
+};
 export type ResponseStatus = "displayed" | "started" | "ended" | "closed" | "interrupted";
 export type ResponseItemQuestion = {
     id: string;
@@ -40,42 +44,110 @@ export type ResponseItem = {
 export type HookCommonProperties = {
     channel: Channel;
     user: User;
+};
+export type HookCommonPropertiesSurvey = HookCommonProperties & {
     survey: Survey;
 };
+export type HookCommonPropertiesMessage = HookCommonProperties & {
+    message: Message;
+};
 export type HookOnReady = (data: {
     channel: Channel;
     user: User;
 }) => void;
-export type HookOnSurveyShowed = (data: HookCommonProperties & {
+export type HookOnSurveyDisplayAllowed = (data: HookCommonPropertiesSurvey) => boolean;
+export type HookOnMessageDisplayAllowed = (data: HookCommonPropertiesSurvey) => boolean;
+export type HookOnSurveyShowed = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
         items: ResponseItem[];
     };
 }) => void;
-export type HookOnSurveyStarted = (data: HookCommonProperties & {
+export type HookOnSurveyStarted = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
     };
 }) => void;
-export type HookOnQuestionReplied = (data: HookCommonProperties & {
+export type HookOnSurveyCompleted = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
-        status: null;
-        question: ResponseItemQuestion;
-        answer: ResponseItemAnswer;
         items: ResponseItem[];
     };
 }) => void;
-export type HookOnSurveyCompleted = (data: HookCommonProperties & {
+export type HookOnSurveyHidden = (data: HookCommonPropertiesSurvey & {
     response: {
         id: string;
         items: ResponseItem[];
+        hide_reason: ResponseStatus;
+    };
+}) => void;
+export type HookOnMessageShowed = (data: HookCommonPropertiesMessage & {
+    response: {
+        id: string;
+        items: ResponseItem[];
+    };
+}) => void;
+export type HookOnMessageStarted = (data: HookCommonPropertiesMessage & {
+    response: {
+        id: string;
     };
 }) => void;
-export type HookOnSurveyHidden = (data: HookCommonProperties & {
+export type HookOnMessageCompleted = (data: HookCommonPropertiesMessage & {
+    response: {
+        id: string;
+        items: ResponseItem[];
+    };
+}) => void;
+export type HookOnMessageHidden = (data: HookCommonPropertiesMessage & {
     response: {
         id: string;
         items: ResponseItem[];
         hide_reason: ResponseStatus;
     };
 }) => void;
+export type HookOnQuestionReplied = (data: HookCommonPropertiesSurvey & {
+    response: {
+        id: string;
+        status: null;
+        question: ResponseItemQuestion;
+        answer: ResponseItemAnswer;
+        items: ResponseItem[];
+    };
+}) => void;
+/** This is the Screeb tag hooks object available on `survey.start` command. */
+export type HooksSurveyStart = {
+    /** This hook is triggered when a survey is displayed on screen (also triggered when page is reloaded) */
+    onSurveyShowed?: HookOnSurveyShowed;
+    /** This hook is triggered when a survey is started */
+    onSurveyStarted?: HookOnSurveyStarted;
+    /** This hook is triggered when a survey is completed */
+    onSurveyCompleted?: HookOnSurveyCompleted;
+    /** This hook is triggered when a survey is hidden */
+    onSurveyHidden?: HookOnSurveyHidden;
+    /** This hook is triggered when a question is answered */
+    onQuestionReplied?: HookOnQuestionReplied;
+};
+/** This is the Screeb tag hooks object available on `message.start` command. */
+export type HooksMessageStart = {
+    /** This hook is triggered when a message is displayed on screen (also triggered when page is reloaded) */
+    onMessageShowed?: HookOnMessageShowed;
+    /** This hook is triggered when a message is started */
+    onMessageStarted?: HookOnMessageStarted;
+    /** This hook is triggered when a message is completed */
+    onMessageCompleted?: HookOnMessageCompleted;
+    /** This hook is triggered when a message is hidden */
+    onMessageHidden?: HookOnMessageHidden;
+    /** This hook is triggered when a question is answered */
+    onQuestionReplied?: HookOnQuestionReplied;
+};
+/** This is the Screeb tag hooks object available on `init` command. */
+export type HooksInit = HooksSurveyStart & HooksMessageStart & {
+    /** This defines the version of hooks and their data */
+    version: string;
+    /** This hook is triggered when Screeb SD is loaded, initialized and ready to rock */
+    onReady?: HookOnReady;
+    /** This hook is triggered before a survey displays to allow it or not. */
+    onSurveyDisplayAllowed?: HookOnSurveyDisplayAllowed;
+    /** This hook is triggered before a message displays to allow it or not. */
+    onMessageDisplayAllowed?: HookOnMessageDisplayAllowed;
+};

package/dist/es/index.d.ts

@@ -1,4 +1,5 @@
-import { Hooks, PropertyRecord, ScreebIdentityGetReturn, ScreebOptions } from "./types";
+import { HooksInit, HooksMessageStart, HooksSurveyStart } from "./hooks.types";
+import { PropertyRecord, ScreebIdentityGetReturn, ScreebOptions } from "./types";
 export * from "./types";
 export * from "./hooks.types";
 /**
@@ -54,7 +55,7 @@ export declare const load: (options?: ScreebOptions) => Promise<undefined>;
  * );
  * ```
  */
-export declare const init: (websiteId: string, userId?: string, userProperties?: PropertyRecord, hooks?: Hooks, language?: string) => void | Promise<unknown>;
+export declare const init: (websiteId: string, userId?: string, userProperties?: PropertyRecord, hooks?: HooksInit, language?: string) => void | Promise<unknown>;
 /**
  * Checks if Screeb tag has been loaded.
  *
@@ -301,6 +302,7 @@ export declare const surveyClose: () => void | Promise<unknown>;
  *
  * Screeb.surveyStart(
  *   '<UUID>',
+ *   '<UUID>',
  *   false,
  *   {
  *     color: "green",
@@ -314,7 +316,7 @@ export declare const surveyClose: () => void | Promise<unknown>;
  * );
  * ```
  */
-export declare const surveyStart: (surveyId: string, allowMultipleResponses?: boolean, hiddenFields?: PropertyRecord, hooks?: Hooks, language?: string) => void | Promise<unknown>;
+export declare const surveyStart: (surveyId: string, distributionId: string, allowMultipleResponses?: boolean, hiddenFields?: PropertyRecord, hooks?: HooksSurveyStart, language?: string) => void | Promise<unknown>;
 /**
  * Interrupts a running message.
  *
@@ -348,7 +350,7 @@ export declare const messageClose: () => void | Promise<unknown>;
  * );
  * ```
  */
-export declare const messageStart: (messageId: string, hiddenFields?: PropertyRecord, hooks?: Hooks, language?: string) => void | Promise<unknown>;
+export declare const messageStart: (messageId: string, hiddenFields?: PropertyRecord, hooks?: HooksMessageStart, language?: string) => void | Promise<unknown>;
 /**
  * Forces a targeting check.
  *

package/dist/es/index.mjs

@@ -410,6 +410,7 @@ var surveyClose = function () { return callScreebCommand("survey.close"); };
  *
  * Screeb.surveyStart(
  *   '<UUID>',
+ *   '<UUID>',
  *   false,
  *   {
  *     color: "green",
@@ -423,10 +424,11 @@ var surveyClose = function () { return callScreebCommand("survey.close"); };
  * );
  * ```
  */
-var surveyStart = function (surveyId, allowMultipleResponses, hiddenFields, hooks, language) {
+var surveyStart = function (surveyId, distributionId, allowMultipleResponses, hiddenFields, hooks, language) {
     if (allowMultipleResponses === void 0) { allowMultipleResponses = true; }
     if (hiddenFields === void 0) { hiddenFields = {}; }
     return callScreebCommand("survey.start", surveyId, {
+        distribution_id: distributionId,
         allow_multiple_responses: allowMultipleResponses,
         language: language,
         hidden_fields: hiddenFields,
@@ -512,4 +514,4 @@ var targetingCheck = function () { return callScreebCommand("targeting.check");
 var targetingDebug = function () { return callScreebCommand("targeting.debug"); };
 
 export { close, debug, eventTrack, identity, identityGet, identityGroupAssign, identityGroupUnassign, identityProperties, identityReset, init, isLoaded, load, messageClose, messageStart, surveyClose, surveyStart, targetingCheck, targetingDebug };
-CONSTANTS.version = '0.1.18'
+CONSTANTS.version = '0.2.1'

package/dist/es/types.d.ts

@@ -1,4 +1,3 @@
-import { HookOnQuestionReplied, HookOnReady, HookOnSurveyCompleted, HookOnSurveyHidden, HookOnSurveyShowed, HookOnSurveyStarted } from "./hooks.types";
 /** This is property types that are supported by Screeb. */
 export type PropertyType = number | boolean | string | Date | PropertyRecord;
 /** This is a property object that are supported by Screeb. */
@@ -45,20 +44,3 @@ export type ScreebIdentityGetReturn = {
     /** `true` if the tag is loaded, initialized and ready to rock */
     is_ready: boolean;
 };
-/** This is the Screeb tag hooks object. */
-export type Hooks = {
-    /** This defines the version of hooks and their data */
-    version: string;
-    /** This hook is triggered when Screeb SD is loaded, initialized and ready to rock */
-    onReady?: HookOnReady;
-    /** This hook is triggered when a survey is displayed on screen (also triggered when page is reloaded) */
-    onSurveyShowed?: HookOnSurveyShowed;
-    /** This hook is triggered when a survey is started */
-    onSurveyStarted?: HookOnSurveyStarted;
-    /** This hook is triggered when a question is answered */
-    onQuestionReplied?: HookOnQuestionReplied;
-    /** This hook is triggered when a survey is completed */
-    onSurveyCompleted?: HookOnSurveyCompleted;
-    /** This hook is triggered when a survey is hidden */
-    onSurveyHidden?: HookOnSurveyHidden;
-};

package/docs/README.md

@@ -9,13 +9,24 @@
 - [Channel](README.md#channel)
 - [ChannelType](README.md#channeltype)
 - [HookCommonProperties](README.md#hookcommonproperties)
+- [HookCommonPropertiesMessage](README.md#hookcommonpropertiesmessage)
+- [HookCommonPropertiesSurvey](README.md#hookcommonpropertiessurvey)
+- [HookOnMessageCompleted](README.md#hookonmessagecompleted)
+- [HookOnMessageDisplayAllowed](README.md#hookonmessagedisplayallowed)
+- [HookOnMessageHidden](README.md#hookonmessagehidden)
+- [HookOnMessageShowed](README.md#hookonmessageshowed)
+- [HookOnMessageStarted](README.md#hookonmessagestarted)
 - [HookOnQuestionReplied](README.md#hookonquestionreplied)
 - [HookOnReady](README.md#hookonready)
 - [HookOnSurveyCompleted](README.md#hookonsurveycompleted)
+- [HookOnSurveyDisplayAllowed](README.md#hookonsurveydisplayallowed)
 - [HookOnSurveyHidden](README.md#hookonsurveyhidden)
 - [HookOnSurveyShowed](README.md#hookonsurveyshowed)
 - [HookOnSurveyStarted](README.md#hookonsurveystarted)
-- [Hooks](README.md#hooks)
+- [HooksInit](README.md#hooksinit)
+- [HooksMessageStart](README.md#hooksmessagestart)
+- [HooksSurveyStart](README.md#hookssurveystart)
+- [Message](README.md#message)
 - [PropertyRecord](README.md#propertyrecord)
 - [PropertyType](README.md#propertytype)
 - [ResponseItem](README.md#responseitem)
@@ -83,14 +94,125 @@ ___
 | Name | Type |
 | :------ | :------ |
 | `channel` | [`Channel`](README.md#channel) |
-| `survey` | [`Survey`](README.md#survey) |
 | `user` | [`User`](README.md#user) |
 
 ___
 
+### HookCommonPropertiesMessage
+
+Ƭ **HookCommonPropertiesMessage**: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `message`: [`Message`](README.md#message)  }
+
+___
+
+### HookCommonPropertiesSurvey
+
+Ƭ **HookCommonPropertiesSurvey**: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `survey`: [`Survey`](README.md#survey)  }
+
+___
+
+### HookOnMessageCompleted
+
+Ƭ **HookOnMessageCompleted**: (`data`: [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
+
+#### Type declaration
+
+▸ (`data`): `void`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
+
+##### Returns
+
+`void`
+
+___
+
+### HookOnMessageDisplayAllowed
+
+Ƭ **HookOnMessageDisplayAllowed**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey)) => `boolean`
+
+#### Type declaration
+
+▸ (`data`): `boolean`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) |
+
+##### Returns
+
+`boolean`
+
+___
+
+### HookOnMessageHidden
+
+Ƭ **HookOnMessageHidden**: (`data`: [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `hide_reason`: [`ResponseStatus`](README.md#responsestatus) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
+
+#### Type declaration
+
+▸ (`data`): `void`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `hide_reason`: [`ResponseStatus`](README.md#responsestatus) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
+
+##### Returns
+
+`void`
+
+___
+
+### HookOnMessageShowed
+
+Ƭ **HookOnMessageShowed**: (`data`: [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
+
+#### Type declaration
+
+▸ (`data`): `void`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
+
+##### Returns
+
+`void`
+
+___
+
+### HookOnMessageStarted
+
+Ƭ **HookOnMessageStarted**: (`data`: [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `id`: `string`  }  }) => `void`
+
+#### Type declaration
+
+▸ (`data`): `void`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | [`HookCommonPropertiesMessage`](README.md#hookcommonpropertiesmessage) & \{ `response`: \{ `id`: `string`  }  } |
+
+##### Returns
+
+`void`
+
+___
+
 ### HookOnQuestionReplied
 
-Ƭ **HookOnQuestionReplied**: (`data`: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `answer`: [`ResponseItemAnswer`](README.md#responseitemanswer) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[] ; `question`: [`ResponseItemQuestion`](README.md#responseitemquestion) ; `status`: ``null``  }  }) => `void`
+Ƭ **HookOnQuestionReplied**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `answer`: [`ResponseItemAnswer`](README.md#responseitemanswer) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[] ; `question`: [`ResponseItemQuestion`](README.md#responseitemquestion) ; `status`: ``null``  }  }) => `void`
 
 #### Type declaration
 
@@ -100,7 +222,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `data` | [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `answer`: [`ResponseItemAnswer`](README.md#responseitemanswer) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[] ; `question`: [`ResponseItemQuestion`](README.md#responseitemquestion) ; `status`: ``null``  }  } |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `answer`: [`ResponseItemAnswer`](README.md#responseitemanswer) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[] ; `question`: [`ResponseItemQuestion`](README.md#responseitemquestion) ; `status`: ``null``  }  } |
 
 ##### Returns
 
@@ -132,7 +254,7 @@ ___
 
 ### HookOnSurveyCompleted
 
-Ƭ **HookOnSurveyCompleted**: (`data`: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
+Ƭ **HookOnSurveyCompleted**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
 
 #### Type declaration
 
@@ -142,7 +264,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `data` | [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
 
 ##### Returns
 
@@ -150,9 +272,29 @@ ___
 
 ___
 
+### HookOnSurveyDisplayAllowed
+
+Ƭ **HookOnSurveyDisplayAllowed**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey)) => `boolean`
+
+#### Type declaration
+
+▸ (`data`): `boolean`
+
+##### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) |
+
+##### Returns
+
+`boolean`
+
+___
+
 ### HookOnSurveyHidden
 
-Ƭ **HookOnSurveyHidden**: (`data`: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `hide_reason`: [`ResponseStatus`](README.md#responsestatus) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
+Ƭ **HookOnSurveyHidden**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `hide_reason`: [`ResponseStatus`](README.md#responsestatus) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
 
 #### Type declaration
 
@@ -162,7 +304,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `data` | [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `hide_reason`: [`ResponseStatus`](README.md#responsestatus) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `hide_reason`: [`ResponseStatus`](README.md#responsestatus) ; `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
 
 ##### Returns
 
@@ -172,7 +314,7 @@ ___
 
 ### HookOnSurveyShowed
 
-Ƭ **HookOnSurveyShowed**: (`data`: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
+Ƭ **HookOnSurveyShowed**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  }) => `void`
 
 #### Type declaration
 
@@ -182,7 +324,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `data` | [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `id`: `string` ; `items`: [`ResponseItem`](README.md#responseitem)[]  }  } |
 
 ##### Returns
 
@@ -192,7 +334,7 @@ ___
 
 ### HookOnSurveyStarted
 
-Ƭ **HookOnSurveyStarted**: (`data`: [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `id`: `string`  }  }) => `void`
+Ƭ **HookOnSurveyStarted**: (`data`: [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `id`: `string`  }  }) => `void`
 
 #### Type declaration
 
@@ -202,7 +344,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `data` | [`HookCommonProperties`](README.md#hookcommonproperties) & \{ `response`: \{ `id`: `string`  }  } |
+| `data` | [`HookCommonPropertiesSurvey`](README.md#hookcommonpropertiessurvey) & \{ `response`: \{ `id`: `string`  }  } |
 
 ##### Returns
 
@@ -210,23 +352,60 @@ ___
 
 ___
 
-### Hooks
+### HooksInit
+
+Ƭ **HooksInit**: [`HooksSurveyStart`](README.md#hookssurveystart) & [`HooksMessageStart`](README.md#hooksmessagestart) & \{ `onMessageDisplayAllowed?`: [`HookOnMessageDisplayAllowed`](README.md#hookonmessagedisplayallowed) ; `onReady?`: [`HookOnReady`](README.md#hookonready) ; `onSurveyDisplayAllowed?`: [`HookOnSurveyDisplayAllowed`](README.md#hookonsurveydisplayallowed) ; `version`: `string`  }
 
-Ƭ **Hooks**: `Object`
+This is the Screeb tag hooks object available on `init` command.
+
+___
 
-This is the Screeb tag hooks object.
+### HooksMessageStart
+
+Ƭ **HooksMessageStart**: `Object`
+
+This is the Screeb tag hooks object available on `message.start` command.
+
+#### Type declaration
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `onMessageCompleted?` | [`HookOnMessageCompleted`](README.md#hookonmessagecompleted) | This hook is triggered when a message is completed |
+| `onMessageHidden?` | [`HookOnMessageHidden`](README.md#hookonmessagehidden) | This hook is triggered when a message is hidden |
+| `onMessageShowed?` | [`HookOnMessageShowed`](README.md#hookonmessageshowed) | This hook is triggered when a message is displayed on screen (also triggered when page is reloaded) |
+| `onMessageStarted?` | [`HookOnMessageStarted`](README.md#hookonmessagestarted) | This hook is triggered when a message is started |
+| `onQuestionReplied?` | [`HookOnQuestionReplied`](README.md#hookonquestionreplied) | This hook is triggered when a question is answered |
+
+___
+
+### HooksSurveyStart
+
+Ƭ **HooksSurveyStart**: `Object`
+
+This is the Screeb tag hooks object available on `survey.start` command.
 
 #### Type declaration
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `onQuestionReplied?` | [`HookOnQuestionReplied`](README.md#hookonquestionreplied) | This hook is triggered when a question is answered |
-| `onReady?` | [`HookOnReady`](README.md#hookonready) | This hook is triggered when Screeb SD is loaded, initialized and ready to rock |
 | `onSurveyCompleted?` | [`HookOnSurveyCompleted`](README.md#hookonsurveycompleted) | This hook is triggered when a survey is completed |
 | `onSurveyHidden?` | [`HookOnSurveyHidden`](README.md#hookonsurveyhidden) | This hook is triggered when a survey is hidden |
 | `onSurveyShowed?` | [`HookOnSurveyShowed`](README.md#hookonsurveyshowed) | This hook is triggered when a survey is displayed on screen (also triggered when page is reloaded) |
 | `onSurveyStarted?` | [`HookOnSurveyStarted`](README.md#hookonsurveystarted) | This hook is triggered when a survey is started |
-| `version` | `string` | This defines the version of hooks and their data |
+
+___
+
+### Message
+
+Ƭ **Message**: `Object`
+
+#### Type declaration
+
+| Name | Type |
+| :------ | :------ |
+| `id` | `string` |
+| `messagey_size` | ``100`` |
 
 ___
 
@@ -715,7 +894,7 @@ Initializes Screeb tag.
 | `websiteId` | `string` | Your website/channel id. |
 | `userId?` | `string` | The unique identifier of your user. |
 | `userProperties?` | [`PropertyRecord`](README.md#propertyrecord) | The properties of your user. ```text Requirements: - Property names must be limited to 128 characters - No more than 1000 attributes - Supported types for values: string, number, boolean and Date ``` |
-| `hooks?` | [`Hooks`](README.md#hooks) | Hooks to be called when SDK is ready or a survey is showed, started, completed, hidden or when a question is replied. |
+| `hooks?` | [`HooksInit`](README.md#hooksinit) | Hooks to be called when SDK is ready or a survey is showed, started, completed, hidden or when a question is replied. |
 | `language?` | `string` | Force a specific language for the tag. eg: 'en'. default: browser language. |
 
 #### Returns
@@ -827,7 +1006,7 @@ Starts a message by its ID.
 | :------ | :------ |
 | `messageId` | `string` |
 | `hiddenFields` | [`PropertyRecord`](README.md#propertyrecord) |
-| `hooks?` | [`Hooks`](README.md#hooks) |
+| `hooks?` | [`HooksMessageStart`](README.md#hooksmessagestart) |
 | `language?` | `string` |
 
 #### Returns
@@ -878,7 +1057,7 @@ ___
 
 ### surveyStart
 
-▸ **surveyStart**(`surveyId`, `allowMultipleResponses?`, `hiddenFields?`, `hooks?`, `language?`): `void` \| `Promise`\<`unknown`\>
+▸ **surveyStart**(`surveyId`, `distributionId`, `allowMultipleResponses?`, `hiddenFields?`, `hooks?`, `language?`): `void` \| `Promise`\<`unknown`\>
 
 Starts a survey by its ID.
 
@@ -887,9 +1066,10 @@ Starts a survey by its ID.
 | Name | Type | Default value |
 | :------ | :------ | :------ |
 | `surveyId` | `string` | `undefined` |
+| `distributionId` | `string` | `undefined` |
 | `allowMultipleResponses` | `boolean` | `true` |
 | `hiddenFields` | [`PropertyRecord`](README.md#propertyrecord) | `{}` |
-| `hooks?` | [`Hooks`](README.md#hooks) | `undefined` |
+| `hooks?` | [`HooksSurveyStart`](README.md#hookssurveystart) | `undefined` |
 | `language?` | `string` | `undefined` |
 
 #### Returns
@@ -902,6 +1082,7 @@ Starts a survey by its ID.
 import * as Screeb from "@screeb/sdk-browser";
 
 Screeb.surveyStart(
+  '<UUID>',
   '<UUID>',
   false,
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@screeb/sdk-browser",
-  "version": "0.1.18",
+  "version": "0.2.1",
   "description": "Screeb's browser sdk.",
   "keywords": [
     "product discovery",