@botpress/sdk 3.4.0 → 3.5.1

package/dist/package.d.ts

@@ -40,6 +40,7 @@ type PluginPackageDefinition = NameVersion & {
     recurringEvents?: Record<string, plugin.RecurringEventDefinition>;
     actions?: Record<string, plugin.ActionDefinition>;
     tables?: Record<string, plugin.TableDefinition>;
+    workflows?: Record<string, plugin.WorkflowDefinition>;
 };
 export type IntegrationPackage = PackageReference & {
     type: 'integration';

package/dist/plugin/common/generic.d.ts

@@ -6,114 +6,18 @@ export type BaseAction = {
     output: any;
 };
 export type BaseTable = {
-    /**
-     * Required. This name is used to identify your table.
-     */
-    name: string;
-    /**
-     * The 'factor' multiplies the row's data storage limit by 4KB and its quota count, but can only be set at table creation and not modified later. For instance, a factor of 2 increases storage to 8KB but counts as 2 rows in your quota. The default factor is 1.
-     */
-    factor?: number;
-    /**
-     * A table designated as "frozen" is immutable in terms of its name and schema structure; modifications to its schema or a renaming operation are not permitted. The only action that can be taken on such a table is deletion. The schema established at the time of creation is locked in as the final structure. To implement any changes, the table must be duplicated with the desired alterations.
-     */
-    frozen?: boolean;
-    schema: {
-        $schema?: string;
-        /**
-         * List of keys/columns in the table.
-         */
-        properties: {
-            [k: string]: {
-                type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
-                format?: 'date-time';
-                description?: string;
-                /**
-                 * String properties must match this pattern
-                 */
-                pattern?: string;
-                /**
-                 * String properties must be one of these values
-                 */
-                enum?: string[];
-                /**
-                 * Defines the shape of items in an array
-                 */
-                items?: {
-                    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
-                    [k: string]: any;
-                };
-                nullable?: boolean;
-                properties?: {
-                    [k: string]: {
-                        type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
-                        [k: string]: any;
-                    };
-                };
-                'x-zui': {
-                    index: number;
-                    /**
-                     * Indicates if the column is vectorized and searchable.
-                     */
-                    searchable?: boolean;
-                    /**
-                     * Indicates if the field is hidden in the UI
-                     */
-                    hidden?: boolean;
-                    /**
-                     * Order of the column in the UI
-                     */
-                    order?: number;
-                    /**
-                     * Width of the column in the UI
-                     */
-                    width?: number;
-                    computed?: {
-                        action: 'ai' | 'code' | 'workflow';
-                        dependencies?: string[];
-                        /**
-                         * Prompt when action is "ai"
-                         */
-                        prompt?: string;
-                        /**
-                         * Code to execute when action is "code"
-                         */
-                        code?: string;
-                        /**
-                         * Model to use when action is "ai"
-                         */
-                        model?: string;
-                        /**
-                         * ID of Workflow to execute when action is "workflow"
-                         */
-                        workflowId?: string;
-                        enabled?: boolean;
-                    };
-                };
-            };
-        };
-        /**
-         * Additional properties can be provided, but they will be ignored if no column matches.
-         */
-        additionalProperties: true;
-        /**
-         * Array of required properties.
-         */
-        required?: string[];
-        type: 'object';
-    };
-    /**
-     * Optional tags to help organize your tables. These should be passed here as an object representing key/value pairs.
-     */
+    [k: string]: any;
+};
+export type BaseWorkflow = {
+    input: any;
+    output: any;
     tags?: {
         [k: string]: string;
     };
-    /**
-     * Indicates if the table is enabled for computation.
-     */
-    isComputeEnabled?: boolean;
 };
 export type BasePlugin = {
+    name: string;
+    version: string;
     configuration: any;
     integrations: Record<string, BaseIntegration>;
     interfaces: Record<string, BaseInterface>;
@@ -121,14 +25,18 @@ export type BasePlugin = {
     states: Record<string, any>;
     actions: Record<string, BaseAction>;
     tables: Record<string, BaseTable>;
+    workflows: Record<string, BaseWorkflow>;
 };
 export type InputBasePlugin = utils.DeepPartial<BasePlugin>;
 export type DefaultPlugin<B extends utils.DeepPartial<BasePlugin>> = {
+    name: utils.Default<B['name'], BasePlugin['name']>;
+    version: utils.Default<B['version'], BasePlugin['version']>;
     configuration: utils.Default<B['configuration'], BasePlugin['configuration']>;
     events: utils.Default<B['events'], BasePlugin['events']>;
     states: utils.Default<B['states'], BasePlugin['states']>;
     actions: utils.Default<B['actions'], BasePlugin['actions']>;
     tables: utils.Default<B['tables'], BasePlugin['tables']>;
+    workflows: utils.Default<B['workflows'], BasePlugin['workflows']>;
     integrations: undefined extends B['integrations'] ? BasePlugin['integrations'] : {
         [K in keyof B['integrations']]: DefaultIntegration<utils.Cast<B['integrations'][K], InputBaseIntegration>>;
     };

package/dist/plugin/definition.d.ts

@@ -1,7 +1,7 @@
-import { StateDefinition, RecurringEventDefinition, EventDefinition, ConfigurationDefinition, UserDefinition, ConversationDefinition, MessageDefinition, ActionDefinition, TableDefinition } from '../bot/definition';
+import { StateDefinition, RecurringEventDefinition, EventDefinition, ConfigurationDefinition, UserDefinition, ConversationDefinition, MessageDefinition, ActionDefinition, TableDefinition, WorkflowDefinition } from '../bot/definition';
 import { IntegrationPackage, InterfacePackage } from '../package';
 import { ZuiObjectSchema } from '../zui';
-export { StateDefinition, RecurringEventDefinition, EventDefinition, ConfigurationDefinition, UserDefinition, ConversationDefinition, MessageDefinition, ActionDefinition, TableDefinition, IntegrationConfigInstance, } from '../bot/definition';
+export { StateDefinition, RecurringEventDefinition, EventDefinition, ConfigurationDefinition, UserDefinition, ConversationDefinition, MessageDefinition, ActionDefinition, TableDefinition, IntegrationConfigInstance, WorkflowDefinition, } from '../bot/definition';
 type BaseConfig = ZuiObjectSchema;
 type BaseStates = Record<string, ZuiObjectSchema>;
 type BaseEvents = Record<string, ZuiObjectSchema>;
@@ -9,7 +9,8 @@ type BaseActions = Record<string, ZuiObjectSchema>;
 type BaseInterfaces = Record<string, any>;
 type BaseIntegrations = Record<string, any>;
 type BaseTables = Record<string, ZuiObjectSchema>;
-export type PluginDefinitionProps<TName extends string = string, TVersion extends string = string, TConfig extends BaseConfig = BaseConfig, TStates extends BaseStates = BaseStates, TEvents extends BaseEvents = BaseEvents, TActions extends BaseActions = BaseActions, TInterfaces extends BaseInterfaces = BaseInterfaces, TIntegrations extends BaseIntegrations = BaseIntegrations, TTables extends BaseTables = BaseTables> = {
+type BaseWorkflows = Record<string, ZuiObjectSchema>;
+export type PluginDefinitionProps<TName extends string = string, TVersion extends string = string, TConfig extends BaseConfig = BaseConfig, TStates extends BaseStates = BaseStates, TEvents extends BaseEvents = BaseEvents, TActions extends BaseActions = BaseActions, TInterfaces extends BaseInterfaces = BaseInterfaces, TIntegrations extends BaseIntegrations = BaseIntegrations, TTables extends BaseTables = BaseTables, TWorkflows extends BaseWorkflows = BaseWorkflows> = {
     name: TName;
     version: TVersion;
     title?: string;
@@ -39,9 +40,16 @@ export type PluginDefinitionProps<TName extends string = string, TVersion extend
     tables?: {
         [K in keyof TTables]: TableDefinition<TTables[K]>;
     };
+    /**
+     * # EXPERIMENTAL
+     * This API is experimental and may change in the future.
+     */
+    workflows?: {
+        [K in keyof TWorkflows]: WorkflowDefinition<TWorkflows[K]>;
+    };
 };
-export declare class PluginDefinition<TName extends string = string, TVersion extends string = string, TConfig extends BaseConfig = BaseConfig, TStates extends BaseStates = BaseStates, TEvents extends BaseEvents = BaseEvents, TActions extends BaseActions = BaseActions, TInterfaces extends BaseInterfaces = BaseInterfaces, TIntegrations extends BaseIntegrations = BaseIntegrations, TTables extends BaseTables = BaseTables> {
-    readonly props: PluginDefinitionProps<TName, TVersion, TConfig, TStates, TEvents, TActions, TInterfaces, TIntegrations, TTables>;
+export declare class PluginDefinition<TName extends string = string, TVersion extends string = string, TConfig extends BaseConfig = BaseConfig, TStates extends BaseStates = BaseStates, TEvents extends BaseEvents = BaseEvents, TActions extends BaseActions = BaseActions, TInterfaces extends BaseInterfaces = BaseInterfaces, TIntegrations extends BaseIntegrations = BaseIntegrations, TTables extends BaseTables = BaseTables, TWorkflows extends BaseWorkflows = BaseWorkflows> {
+    readonly props: PluginDefinitionProps<TName, TVersion, TConfig, TStates, TEvents, TActions, TInterfaces, TIntegrations, TTables, TWorkflows>;
     readonly name: this['props']['name'];
     readonly version: this['props']['version'];
     readonly title: this['props']['title'];
@@ -59,5 +67,6 @@ export declare class PluginDefinition<TName extends string = string, TVersion ex
     readonly recurringEvents: this['props']['recurringEvents'];
     readonly actions: this['props']['actions'];
     readonly tables: this['props']['tables'];
-    constructor(props: PluginDefinitionProps<TName, TVersion, TConfig, TStates, TEvents, TActions, TInterfaces, TIntegrations, TTables>);
+    readonly workflows: this['props']['workflows'];
+    constructor(props: PluginDefinitionProps<TName, TVersion, TConfig, TStates, TEvents, TActions, TInterfaces, TIntegrations, TTables, TWorkflows>);
 }

package/dist/plugin/implementation.d.ts

@@ -1,10 +1,12 @@
-import { MessageHandlersMap as BotMessageHandlersMap, EventHandlersMap as BotEventHandlersMap, StateExpiredHandlersMap as BotStateExpiredHandlersMap, HookHandlersMap as BotHookHandlersMap, ActionHandlers as BotActionHandlers, BotHandlers } from '../bot';
+import type { MessageHandlersMap as BotMessageHandlersMap, EventHandlersMap as BotEventHandlersMap, StateExpiredHandlersMap as BotStateExpiredHandlersMap, HookHandlersMap as BotHookHandlersMap, WorkflowHandlersMap as BotWorkflowHandlersMap, ActionHandlers as BotActionHandlers, BotHandlers } from '../bot';
+import * as utils from '../utils';
 import { BasePlugin, PluginInterfaceExtensions } from './common';
-import { MessageHandlersMap, MessageHandlers, EventHandlersMap, EventHandlers, StateExpiredHandlersMap, StateExpiredHandlers, HookData, HookHandlers, ActionHandlers, PluginConfiguration } from './server/types';
+import { ActionHandlers, MessageHandlers, EventHandlers, StateExpiredHandlers, HookHandlers, WorkflowHandlers, MessageHandlersMap, EventHandlersMap, StateExpiredHandlersMap, HookHandlersMap, WorkflowHandlersMap, PluginConfiguration } from './server/types';
 export type PluginImplementationProps<TPlugin extends BasePlugin = BasePlugin> = {
     actions: ActionHandlers<TPlugin>;
 };
 export type PluginRuntimeProps<TPlugin extends BasePlugin = BasePlugin> = {
+    alias?: string;
     configuration: PluginConfiguration<TPlugin>;
     interfaces: PluginInterfaceExtensions<TPlugin>;
 };
@@ -16,8 +18,10 @@ export declare class PluginImplementation<TPlugin extends BasePlugin = BasePlugi
     private _eventHandlers;
     private _stateExpiredHandlers;
     private _hookHandlers;
+    private _workflowHandlers;
+    private _registerOrder;
     constructor(props: PluginImplementationProps<TPlugin>);
-    initialize(config: PluginRuntimeProps<TPlugin>): this;
+    initialize(props: PluginRuntimeProps<TPlugin>): this;
     private get _runtime();
     private _getTools;
     get actionHandlers(): BotActionHandlers<TPlugin>;
@@ -25,21 +29,38 @@ export declare class PluginImplementation<TPlugin extends BasePlugin = BasePlugi
     get eventHandlers(): BotEventHandlersMap<TPlugin>;
     get stateExpiredHandlers(): BotStateExpiredHandlersMap<TPlugin>;
     get hookHandlers(): BotHookHandlersMap<TPlugin>;
+    get workflowHandlers(): BotWorkflowHandlersMap<TPlugin>;
     readonly on: {
-        message: <T extends keyof MessageHandlersMap<TPlugin>>(type: T, handler: MessageHandlers<TPlugin>[T]) => void;
-        event: <T extends keyof EventHandlersMap<TPlugin>>(type: T, handler: EventHandlers<TPlugin>[T]) => void;
-        stateExpired: <T extends keyof StateExpiredHandlersMap<TPlugin>>(type: T, handler: StateExpiredHandlers<TPlugin>[T]) => void;
-        beforeIncomingEvent: <T extends keyof HookData<TPlugin>["before_incoming_event"]>(type: T, handler: HookHandlers<TPlugin>["before_incoming_event"][T]) => void;
-        beforeIncomingMessage: <T extends keyof HookData<TPlugin>["before_incoming_message"]>(type: T, handler: HookHandlers<TPlugin>["before_incoming_message"][T]) => void;
-        beforeOutgoingMessage: <T extends keyof HookData<TPlugin>["before_outgoing_message"]>(type: T, handler: HookHandlers<TPlugin>["before_outgoing_message"][T]) => void;
-        beforeOutgoingCallAction: <T extends keyof HookData<TPlugin>["before_outgoing_call_action"]>(type: T, handler: HookHandlers<TPlugin>["before_outgoing_call_action"][T]) => void;
-        afterIncomingEvent: <T extends keyof HookData<TPlugin>["after_incoming_event"]>(type: T, handler: HookHandlers<TPlugin>["after_incoming_event"][T]) => void;
-        afterIncomingMessage: <T extends keyof HookData<TPlugin>["after_incoming_message"]>(type: T, handler: HookHandlers<TPlugin>["after_incoming_message"][T]) => void;
-        afterOutgoingMessage: <T extends keyof HookData<TPlugin>["after_outgoing_message"]>(type: T, handler: HookHandlers<TPlugin>["after_outgoing_message"][T]) => void;
-        afterOutgoingCallAction: <T extends keyof HookData<TPlugin>["after_outgoing_call_action"]>(type: T, handler: HookHandlers<TPlugin>["after_outgoing_call_action"][T]) => void;
+        message: <T extends utils.types.StringKeys<MessageHandlersMap<TPlugin>>>(type: T, handler: MessageHandlers<TPlugin>[T]) => void;
+        event: <T extends utils.types.StringKeys<EventHandlersMap<TPlugin>>>(type: T, handler: EventHandlers<TPlugin>[T]) => void;
+        stateExpired: <T extends utils.types.StringKeys<StateExpiredHandlersMap<TPlugin>>>(type: T, handler: StateExpiredHandlers<TPlugin>[T]) => void;
+        beforeIncomingEvent: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["before_incoming_event"]>>(type: T, handler: HookHandlers<TPlugin>["before_incoming_event"][T]) => void;
+        beforeIncomingMessage: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["before_incoming_message"]>>(type: T, handler: HookHandlers<TPlugin>["before_incoming_message"][T]) => void;
+        beforeOutgoingMessage: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["before_outgoing_message"]>>(type: T, handler: HookHandlers<TPlugin>["before_outgoing_message"][T]) => void;
+        beforeOutgoingCallAction: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["before_outgoing_call_action"]>>(type: T, handler: HookHandlers<TPlugin>["before_outgoing_call_action"][T]) => void;
+        afterIncomingEvent: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["after_incoming_event"]>>(type: T, handler: HookHandlers<TPlugin>["after_incoming_event"][T]) => void;
+        afterIncomingMessage: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["after_incoming_message"]>>(type: T, handler: HookHandlers<TPlugin>["after_incoming_message"][T]) => void;
+        afterOutgoingMessage: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["after_outgoing_message"]>>(type: T, handler: HookHandlers<TPlugin>["after_outgoing_message"][T]) => void;
+        afterOutgoingCallAction: <T extends utils.types.StringKeys<HookHandlersMap<TPlugin>["after_outgoing_call_action"]>>(type: T, handler: HookHandlers<TPlugin>["after_outgoing_call_action"][T]) => void;
+        /**
+         * # EXPERIMENTAL
+         * This API is experimental and may change in the future.
+         */
+        workflowStart: <T extends utils.types.StringKeys<WorkflowHandlersMap<TPlugin>["started"]>>(type: T, handler: WorkflowHandlers<TPlugin>[T]) => void;
+        /**
+         * # EXPERIMENTAL
+         * This API is experimental and may change in the future.
+         */
+        workflowContinue: <T extends utils.types.StringKeys<WorkflowHandlersMap<TPlugin>["continued"]>>(type: T, handler: WorkflowHandlers<TPlugin>[T]) => void;
+        /**
+         * # EXPERIMENTAL
+         * This API is experimental and may change in the future.
+         */
+        workflowTimeout: <T extends utils.types.StringKeys<WorkflowHandlersMap<TPlugin>["timed_out"]>>(type: T, handler: WorkflowHandlers<TPlugin>[T]) => void;
     };
     /**
      * checks if the actual event resolves to the target event
      */
     private _eventResolvesTo;
+    private _stripAliasPrefix;
 }

package/dist/plugin/server/types.d.ts

@@ -1,35 +1,36 @@
 import * as client from '@botpress/client';
 import * as bot from '../../bot';
+import * as workflowProxy from '../../bot/workflow-proxy';
 import * as utils from '../../utils/type-utils';
-import * as proxy from '../action-proxy';
+import * as actionProxy from '../action-proxy';
 import * as common from '../common';
 type EnumeratePluginEvents<TPlugin extends common.BasePlugin> = bot.EnumerateEvents<TPlugin> & common.EnumerateInterfaceEvents<TPlugin>;
 type _IncomingEvents<TPlugin extends common.BasePlugin> = {
-    [K in keyof EnumeratePluginEvents<TPlugin>]: utils.Merge<client.Event, {
+    [K in utils.StringKeys<EnumeratePluginEvents<TPlugin>>]: utils.Merge<client.Event, {
         type: K;
         payload: EnumeratePluginEvents<TPlugin>[K];
     }>;
 };
 type _IncomingMessages<TPlugin extends common.BasePlugin> = {
-    [K in keyof bot.GetMessages<TPlugin>]: utils.Merge<client.Message, {
+    [K in utils.StringKeys<bot.GetMessages<TPlugin>>]: utils.Merge<client.Message, {
         type: K;
         payload: bot.GetMessages<TPlugin>[K];
     }>;
 };
 type _IncomingStates<TPlugin extends common.BasePlugin> = {
-    [K in keyof bot.EnumerateStates<TPlugin>]: utils.Merge<client.State, {
+    [K in utils.StringKeys<bot.EnumerateStates<TPlugin>>]: utils.Merge<client.State, {
         name: K;
         payload: bot.EnumerateStates<TPlugin>[K];
     }>;
 };
 type _OutgoingMessageRequests<TPlugin extends common.BasePlugin> = {
-    [K in keyof bot.GetMessages<TPlugin>]: utils.Merge<client.ClientInputs['createMessage'], {
+    [K in utils.StringKeys<bot.GetMessages<TPlugin>>]: utils.Merge<client.ClientInputs['createMessage'], {
         type: K;
         payload: bot.GetMessages<TPlugin>[K];
     }>;
 };
 type _OutgoingMessageResponses<TPlugin extends common.BasePlugin> = {
-    [K in keyof bot.GetMessages<TPlugin>]: utils.Merge<client.ClientOutputs['createMessage'], {
+    [K in utils.StringKeys<bot.GetMessages<TPlugin>>]: utils.Merge<client.ClientOutputs['createMessage'], {
         message: utils.Merge<client.Message, {
             type: K;
             payload: bot.GetMessages<TPlugin>[K];
@@ -37,13 +38,13 @@ type _OutgoingMessageResponses<TPlugin extends common.BasePlugin> = {
     }>;
 };
 type _OutgoingCallActionRequests<TPlugin extends common.BasePlugin> = {
-    [K in keyof bot.EnumerateActionInputs<TPlugin>]: utils.Merge<client.ClientInputs['callAction'], {
+    [K in utils.StringKeys<bot.EnumerateActionInputs<TPlugin>>]: utils.Merge<client.ClientInputs['callAction'], {
         type: K;
         input: bot.EnumerateActionInputs<TPlugin>[K];
     }>;
 };
 type _OutgoingCallActionResponses<TPlugin extends common.BasePlugin> = {
-    [K in keyof bot.EnumerateActionOutputs<TPlugin>]: utils.Merge<client.ClientOutputs['callAction'], {
+    [K in utils.StringKeys<bot.EnumerateActionOutputs<TPlugin>>]: utils.Merge<client.ClientOutputs['callAction'], {
         output: bot.EnumerateActionOutputs<TPlugin>[K];
     }>;
 };
@@ -82,16 +83,21 @@ export type CommonHandlerProps<TPlugin extends common.BasePlugin> = {
     client: PluginClient<TPlugin>;
     configuration: PluginConfiguration<TPlugin>;
     interfaces: common.PluginInterfaceExtensions<TPlugin>;
-    actions: proxy.ActionProxy<TPlugin>;
+    actions: actionProxy.ActionProxy<TPlugin>;
+    /**
+     * # EXPERIMENTAL
+     * This API is experimental and may change in the future.
+     */
+    workflows: workflowProxy.WorkflowProxy<TPlugin>;
 };
 export type MessagePayloads<TPlugin extends common.BasePlugin> = {
-    [K in keyof IncomingMessages<TPlugin>]: CommonHandlerProps<TPlugin> & {
-        message: IncomingMessages<TPlugin>[K];
+    [TMessageName in utils.StringKeys<IncomingMessages<TPlugin>>]: CommonHandlerProps<TPlugin> & {
+        message: IncomingMessages<TPlugin>[TMessageName];
         user: client.User;
         conversation: client.Conversation;
         event: client.Event;
         states: {
-            [TState in keyof TPlugin['states']]: {
+            [TState in utils.StringKeys<TPlugin['states']>]: {
                 type: 'user' | 'conversation' | 'bot';
                 payload: TPlugin['states'][TState];
             };
@@ -99,32 +105,46 @@ export type MessagePayloads<TPlugin extends common.BasePlugin> = {
     };
 };
 export type MessageHandlers<TPlugin extends common.BasePlugin> = {
-    [K in keyof IncomingMessages<TPlugin>]: (args: MessagePayloads<TPlugin>[K]) => Promise<void>;
+    [TMessageName in utils.StringKeys<IncomingMessages<TPlugin>>]: (args: MessagePayloads<TPlugin>[TMessageName]) => Promise<void>;
 };
 export type EventPayloads<TPlugin extends common.BasePlugin> = {
-    [K in keyof IncomingEvents<TPlugin>]: CommonHandlerProps<TPlugin> & {
-        event: IncomingEvents<TPlugin>[K];
+    [TEventName in utils.StringKeys<IncomingEvents<TPlugin>>]: CommonHandlerProps<TPlugin> & {
+        event: IncomingEvents<TPlugin>[TEventName];
     };
 };
 export type EventHandlers<TPlugin extends common.BasePlugin> = {
-    [K in keyof IncomingEvents<TPlugin>]: (args: EventPayloads<TPlugin>[K]) => Promise<void>;
+    [TEventName in utils.StringKeys<IncomingEvents<TPlugin>>]: (args: EventPayloads<TPlugin>[TEventName]) => Promise<void>;
 };
 export type StateExpiredPayloads<TPlugin extends common.BasePlugin> = {
-    [K in keyof IncomingStates<TPlugin>]: CommonHandlerProps<TPlugin> & {
-        state: IncomingStates<TPlugin>[K];
+    [TSateName in utils.StringKeys<IncomingStates<TPlugin>>]: CommonHandlerProps<TPlugin> & {
+        state: IncomingStates<TPlugin>[TSateName];
     };
 };
 export type StateExpiredHandlers<TPlugin extends common.BasePlugin> = {
-    [K in keyof IncomingStates<TPlugin>]: (args: StateExpiredPayloads<TPlugin>[K]) => Promise<void>;
+    [TSateName in utils.StringKeys<IncomingStates<TPlugin>>]: (args: StateExpiredPayloads<TPlugin>[TSateName]) => Promise<void>;
 };
 export type ActionHandlerPayloads<TPlugin extends common.BasePlugin> = {
-    [K in keyof TPlugin['actions']]: CommonHandlerProps<TPlugin> & {
-        type?: K;
-        input: TPlugin['actions'][K]['input'];
+    [TActionName in utils.StringKeys<TPlugin['actions']>]: CommonHandlerProps<TPlugin> & {
+        type?: TActionName;
+        input: TPlugin['actions'][TActionName]['input'];
     };
 };
 export type ActionHandlers<TPlugin extends common.BasePlugin> = {
-    [K in keyof TPlugin['actions']]: (props: ActionHandlerPayloads<TPlugin>[K]) => Promise<TPlugin['actions'][K]['output']>;
+    [TActionName in utils.StringKeys<TPlugin['actions']>]: (props: ActionHandlerPayloads<TPlugin>[TActionName]) => Promise<TPlugin['actions'][TActionName]['output']>;
+};
+export type WorkflowPayloads<TPlugin extends common.BasePlugin> = {
+    [TWorkflowName in utils.StringKeys<TPlugin['workflows']>]: CommonHandlerProps<TPlugin> & {
+        conversation?: client.Conversation;
+        user?: client.User;
+        /**
+         * # EXPERIMENTAL
+         * This API is experimental and may change in the future.
+         */
+        workflow: workflowProxy.WorkflowWithUtilities<TPlugin, TWorkflowName>;
+    };
+};
+export type WorkflowHandlers<TPlugin extends common.BasePlugin> = {
+    [TWorkflowName in utils.StringKeys<TPlugin['workflows']>]: (props: WorkflowPayloads<TPlugin>[TWorkflowName]) => Promise<void>;
 };
 type BaseHookDefinition = {
     stoppable?: boolean;
@@ -192,43 +212,85 @@ export type HookDefinitions<TPlugin extends common.BasePlugin> = {
     }>;
 };
 export type HookData<TPlugin extends common.BasePlugin> = {
-    [H in keyof HookDefinitions<TPlugin>]: {
-        [T in keyof HookDefinitions<TPlugin>[H]['data']]: HookDefinitions<TPlugin>[H]['data'][T];
+    [THookType in utils.StringKeys<HookDefinitions<TPlugin>>]: {
+        [THookDataName in utils.StringKeys<HookDefinitions<TPlugin>[THookType]['data']>]: HookDefinitions<TPlugin>[THookType]['data'][THookDataName];
     };
 };
 export type HookInputs<TPlugin extends common.BasePlugin> = {
-    [H in keyof HookData<TPlugin>]: {
-        [T in keyof HookData<TPlugin>[H]]: CommonHandlerProps<TPlugin> & {
-            data: HookData<TPlugin>[H][T];
+    [THookType in utils.StringKeys<HookData<TPlugin>>]: {
+        [THookDataName in utils.StringKeys<HookData<TPlugin>[THookType]>]: CommonHandlerProps<TPlugin> & {
+            data: HookData<TPlugin>[THookType][THookDataName];
         };
     };
 };
 export type HookOutputs<TPlugin extends common.BasePlugin> = {
-    [H in keyof HookData<TPlugin>]: {
-        [T in keyof HookData<TPlugin>[H]]: {
-            data?: HookData<TPlugin>[H][T];
-        } & (HookDefinitions<TPlugin>[H]['stoppable'] extends true ? {
+    [THookType in utils.StringKeys<HookData<TPlugin>>]: {
+        [THookDataName in utils.StringKeys<HookData<TPlugin>[THookType]>]: {
+            data?: HookData<TPlugin>[THookType][THookDataName];
+        } & (HookDefinitions<TPlugin>[THookType]['stoppable'] extends true ? {
             stop?: boolean;
         } : {});
     };
 };
 export type HookHandlers<TPlugin extends common.BasePlugin> = {
-    [H in keyof HookData<TPlugin>]: {
-        [T in keyof HookData<TPlugin>[H]]: (input: HookInputs<TPlugin>[H][T]) => Promise<HookOutputs<TPlugin>[H][T] | undefined>;
+    [THookType in utils.StringKeys<HookData<TPlugin>>]: {
+        [THookDataName in utils.StringKeys<HookData<TPlugin>[THookType]>]: (input: HookInputs<TPlugin>[THookType][THookDataName]) => Promise<HookOutputs<TPlugin>[THookType][THookDataName] | undefined>;
     };
 };
 export type MessageHandlersMap<TPlugin extends common.BasePlugin> = {
-    [T in keyof IncomingMessages<TPlugin>]?: MessageHandlers<TPlugin>[T][];
+    [TMessageName in utils.StringKeys<IncomingMessages<TPlugin>>]?: MessageHandlers<TPlugin>[TMessageName][];
 };
 export type EventHandlersMap<TPlugin extends common.BasePlugin> = {
-    [T in keyof IncomingEvents<TPlugin>]?: EventHandlers<TPlugin>[T][];
+    [TEventName in utils.StringKeys<IncomingEvents<TPlugin>>]?: EventHandlers<TPlugin>[TEventName][];
 };
 export type StateExpiredHandlersMap<TPlugin extends common.BasePlugin> = {
-    [T in keyof IncomingStates<TPlugin>]?: StateExpiredHandlers<TPlugin>[T][];
+    [TStateName in utils.StringKeys<IncomingStates<TPlugin>>]?: StateExpiredHandlers<TPlugin>[TStateName][];
 };
 export type HookHandlersMap<TPlugin extends common.BasePlugin> = {
-    [H in keyof HookData<TPlugin>]: {
-        [T in keyof HookData<TPlugin>[H]]?: HookHandlers<TPlugin>[H][T][];
+    [THookType in utils.StringKeys<HookData<TPlugin>>]: {
+        [THookDataName in utils.StringKeys<HookData<TPlugin>[THookType]>]?: HookHandlers<TPlugin>[THookType][THookDataName][];
+    };
+};
+export type WorkflowHandlersMap<TPlugin extends common.BasePlugin> = {
+    [TWorkflowUpdateType in bot.WorkflowUpdateType]: {
+        [TWorkflowName in utils.StringKeys<TPlugin['workflows']>]?: {
+            handler: WorkflowHandlers<TPlugin>[TWorkflowName];
+            order: number;
+        }[];
+    };
+};
+export type OrderedMessageHandlersMap<TPlugin extends common.BasePlugin> = {
+    [TMessageName in utils.StringKeys<IncomingMessages<TPlugin>>]?: {
+        handler: MessageHandlers<TPlugin>[TMessageName];
+        order: number;
+    }[];
+};
+export type OrderedEventHandlersMap<TPlugin extends common.BasePlugin> = {
+    [TEventName in utils.StringKeys<IncomingEvents<TPlugin>>]?: {
+        handler: EventHandlers<TPlugin>[TEventName];
+        order: number;
+    }[];
+};
+export type OrderedStateExpiredHandlersMap<TPlugin extends common.BasePlugin> = {
+    [TStateName in utils.StringKeys<IncomingStates<TPlugin>>]?: {
+        handler: StateExpiredHandlers<TPlugin>[TStateName];
+        order: number;
+    }[];
+};
+export type OrderedHookHandlersMap<TPlugin extends common.BasePlugin> = {
+    [THookType in utils.StringKeys<HookData<TPlugin>>]: {
+        [THookDataName in utils.StringKeys<HookData<TPlugin>[THookType]>]?: {
+            handler: HookHandlers<TPlugin>[THookType][THookDataName];
+            order: number;
+        }[];
+    };
+};
+export type OrderedWorkflowHandlersMap<TPlugin extends common.BasePlugin> = {
+    [TWorkflowUpdateType in bot.WorkflowUpdateType]: {
+        [TWorkflowName in utils.StringKeys<TPlugin['workflows']>]?: {
+            handler: WorkflowHandlers<TPlugin>[TWorkflowName];
+            order: number;
+        }[];
     };
 };
 export type PluginHandlers<TPlugin extends common.BasePlugin> = {
@@ -237,5 +299,6 @@ export type PluginHandlers<TPlugin extends common.BasePlugin> = {
     eventHandlers: EventHandlersMap<TPlugin>;
     stateExpiredHandlers: StateExpiredHandlersMap<TPlugin>;
     hookHandlers: HookHandlersMap<TPlugin>;
+    workflowHandlers: WorkflowHandlersMap<TPlugin>;
 };
 export {};

package/dist/utils/record-utils.d.ts

@@ -1,5 +1,6 @@
 export declare const pairs: <K extends string, V>(obj: Record<K, V>) => [K, V][];
 export declare const values: <K extends string, V>(obj: Record<K, V>) => V[];
 export declare const mapValues: <K extends string, V, R>(obj: Record<K, V>, fn: (value: V, key: K) => R) => Record<K, R>;
+export declare const mapKeys: <K1 extends string, K2 extends string, V>(obj: Record<K1, V>, fn: (key: K1) => K2) => Record<K2, V>;
 export declare const stripUndefinedProps: <K extends string, V>(obj: Record<K, V | undefined>) => Record<K, V>;
 export declare const mergeRecords: <K extends string, V>(a: Record<K, V>, b: Record<K, V>, merge: (v1: V, v2: V) => V) => Record<K, V>;

package/dist/utils/type-utils.d.ts

@@ -7,12 +7,12 @@ export type Writable<T> = {
 };
 export type Default<T, U> = undefined extends T ? U : T;
 export type AtLeastOne<T> = [T, ...T[]];
-export type AtLeastOneProperty<T> = {
+export type AtLeastOneProperty<T> = T extends undefined ? {} : {
     [K in keyof T]?: T[K];
 } & {
     [K in keyof T]: Pick<T, K>;
 }[keyof T];
-export type ExactlyOneProperty<T> = {
+export type ExactlyOneProperty<T> = T extends undefined ? {} : {
     [K in keyof T]: {
         [P in K]: T[P];
     } & {
@@ -45,4 +45,5 @@ type DeepPartialObject<T extends object> = T extends infer O ? {
 } : never;
 export type DeepPartial<T> = T extends (...args: infer A) => infer R ? (...args: DeepPartial<A>) => DeepPartial<R> : T extends Array<infer E> ? Array<DeepPartial<E>> : T extends ReadonlyArray<infer E> ? ReadonlyArray<DeepPartial<E>> : T extends Promise<infer R> ? Promise<DeepPartial<R>> : T extends Buffer ? Buffer : T extends object ? DeepPartialObject<T> : T;
 export type SafeOmit<T, K extends keyof T> = Omit<T, K>;
+export type StringKeys<T> = Extract<keyof T, string>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/sdk",
-  "version": "3.4.0",
+  "version": "3.5.1",
   "description": "Botpress SDK",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -16,7 +16,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@botpress/client": "0.47.0",
+    "@botpress/client": "0.48.0",
     "browser-or-node": "^2.1.1"
   },
   "devDependencies": {