@kizenapps/engine 0.0.1-b1f3597

package/README.md

@@ -0,0 +1,160 @@
+## Kizen Plugin Engine
+
+The core plugin engine for the Kizen developer platform for running plugin apps in web workers.
+
+### Installation
+
+```
+yarn add @kizenapps/plugin-engine
+```
+
+### Usage
+
+Your app needs to be wrapped in the `PluginEngineProvider`. This provider gives the internal components access to the worker runner, network requests, and other consumer-specific features, and adapts your application's common UI components like modals and toasts to a common API that plugins can use.
+
+#### Context Provider
+
+```tsx
+import { PluginEngineProvider } from '@kizenapps/plugin-engine/react';
+import { useHistory } from 'react-router-dom';
+import PluginContext from 'contexts/Plugins';
+
+const AppProvider = ({ user, teamMember, business, clientObject }) => {
+  const history = useHistory();
+
+  const onNavigate = useCallback(
+    (path: string, args?: { replace?: boolean }) => {
+      if (args?.replace) {
+        history.replace(path);
+      } else {
+        history.push(path);
+      }
+    },
+    [history],
+  );
+
+  const [showToast, , clearToasts] = useToast();
+
+  const [integrationModalProps, , integrationModalTriggerProps] = useModal({});
+
+  const { onConfirm, show, onHide } = integrationModalProps;
+  const { show: showPrompt, showing } = integrationModalTriggerProps;
+
+  return (
+    <PluginEngineProvider
+      user={user}
+      teamMember={teamMember}
+      business={business}
+      clientObject={clientObject}
+      onNavigate={onNavigate}
+      monitoringExceptionHelper={onError}
+      showToast={showToast}
+      clearToasts={clearToasts}
+      modal={{
+        showing,
+        show,
+        onConfirm,
+        onHide,
+        showPrompt,
+      }}
+      performRequest={performKizenRequest}
+      appPath={import.meta.env.VITE_API_BASE_PATH}
+      bootstrapPlugins={pluginApps}
+      performFileUpload={FileService.upload}
+      getPendingCacheCount={getPendingCacheCount}
+      invalidateCache={invalidateCache}
+    >
+      {({
+        handleCreateRecordComplete,
+        handleCreateRelatedRecordComplete,
+        showCreateRecordModal,
+        showCreateRelatedRecordModal,
+        createRecordModalObjectId,
+        createRelatedRecordModalObjectId,
+        createRelatedRecordModalRelatedEntityId,
+        showLoadingIndicator,
+        hasFinishedBootstrapping,
+        derivedModalState,
+        showPluginModal,
+        pluginApiName,
+        ...rest
+      }) => {
+        return (
+          <PluginContext.Provider
+            value={{
+              isFetched: hasFetchedBootstrap,
+              isLoading,
+              pluginNames,
+              floatingFrames: isLoading ? [] : floatingFrames,
+              routablePages,
+              dataAdornments,
+              calendarSources,
+              refetch,
+              fullRefetch,
+              installedPluginAPINamesToIds,
+              plugins: data,
+              toolbarItems,
+              toolbarItemsByFullId,
+              routeScripts,
+              automationSteps: isLoading ? [] : automationSteps,
+              objectSettingsMenuItems,
+              userConfigsByApiName,
+              featureFlags,
+              refetchFeatureFlags,
+              featureFlagsLoading: !hasCalculatedFeatureFlags && !hasFinishedBootstrapping,
+              businessPluginAppsByApiName,
+              ...rest,
+            }}
+          >
+            {showLoadingIndicator ? <StyledLoader loading /> : null}
+            {children}
+            {showPluginModal ? (
+              <PluginModal modalState={derivedModalState} pluginApiName={pluginApiName} />
+            ) : null}
+            {showCreateRecordModal ? (
+              <Suspense fallback={null}>
+                <CreateRecordModal
+                  objectId={createRecordModalObjectId}
+                  onComplete={handleCreateRecordComplete}
+                />
+              </Suspense>
+            ) : null}
+            {showCreateRelatedRecordModal ? (
+              <Suspense fallback={null}>
+                <CreateRelatedRecordModal
+                  objectId={createRelatedRecordModalObjectId}
+                  relatedEntityId={createRelatedRecordModalRelatedEntityId}
+                  onComplete={handleCreateRelatedRecordComplete}
+                />
+              </Suspense>
+            ) : null}
+          </PluginContext.Provider>
+        );
+      }}
+    </PluginEngineProvider>
+  );
+};
+```
+
+#### Running Scripts
+
+```tsx
+import { useGenericPluginCustomScript } from '@kizenapps/plugin-engine/react';
+import { useToast } from 'components/ToastProvider';
+
+const ScriptButton = ({ pluginScript }: { pluginScript: string }) => {
+  const [showToast] = useToast();
+
+  const [executeInline, { pending: inlinePending }] = useGenericPluginCustomScript({
+    onError: (e) => {
+      showToast({
+        message: `Script could not be executed: ${e?.message}`,
+        variant: 'failure',
+      });
+    },
+    plugin: item,
+  });
+
+  return <button onClick={() => executeInline(pluginScript)} disabled={inlinePending} />;
+};
+```

package/dist/ThirdPartyScript-DdrF7zh7.d.ts

@@ -0,0 +1,459 @@
+import { RefObject } from 'react';
+
+interface PartialUser {
+    id: string;
+    crm_client_id: string;
+}
+interface PartialTeamMember {
+    id: string;
+    full_name: string;
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    created: string;
+}
+type Profile = PartialTeamMember & PartialUser;
+interface CurrentUser {
+    profile: Profile;
+}
+interface PartialBusiness {
+    id: string;
+}
+interface PartialRelatedObject {
+    field_id: string;
+    related_object: string;
+}
+interface PartialCustomObject {
+    object_type: 'pipeline' | 'standard';
+    fetch_url: string;
+    related_objects?: PartialRelatedObject[];
+}
+interface PartialEntity {
+    fields?: Record<string, {
+        id: string;
+        value: {
+            id?: string;
+        }[];
+    }>;
+}
+interface PartialClientObject {
+    id: string;
+    objectName: string;
+}
+interface SelectOption {
+    label: string;
+    value: string;
+}
+interface PartialLocation {
+    host: string;
+    hash: string;
+    href: string;
+    origin: string;
+    pathname: string;
+    search: string;
+    port: string;
+    protocol: string;
+}
+type ErrorHandler = (error: unknown) => void;
+type ReleaseBlockingScriptHandler = (executionPlugin?: unknown) => void;
+type JSONPrimitive = string | number | boolean | null;
+type JSONValue = JSONPrimitive | JSONArray | JSONObject;
+type JSONArray = JSONValue[];
+interface JSONObject {
+    [key: string]: JSONValue | undefined;
+}
+type UnknownJSON = JSONObject;
+interface AppPlugin {
+    business_config: unknown;
+    name: string;
+    employee_config: unknown;
+}
+type AppPlugins = Record<string, AppPlugin>;
+type MaybeMessageError = {
+    message?: string;
+} | undefined;
+type EmployeeConfig<T = unknown> = Record<string, T>;
+
+type PromiseResolve = (value: unknown) => void;
+type PromiseReject = (reason?: unknown) => void;
+interface PromiseState {
+    resolve: PromiseResolve;
+    reject: PromiseReject;
+}
+type PromiseMap = Map<string, PromiseState>;
+
+declare class WorkerPromise {
+    private promises;
+    private isDebug;
+    constructor({ isDebug }: {
+        isDebug?: boolean;
+    });
+    private delete;
+    private get;
+    private set;
+    private id;
+    register(resolve: PromiseResolve, reject: PromiseReject): string;
+    resolve(id: string, data?: unknown): void;
+    reject(id: string, reason?: unknown): void;
+}
+
+interface ButtonConfig {
+    label: string;
+    variant?: 'text' | 'standard';
+    color?: string;
+}
+interface ModalDescription {
+    type: 'description';
+    content: string;
+    widthPercent: 50 | 100;
+    when?: string | undefined;
+    key: string;
+}
+interface ModalTextInput {
+    type: 'text';
+    label: string;
+    placeholder: string;
+    widthPercent: 50 | 100;
+    id: string;
+    defaultValue?: string;
+    when?: string | undefined;
+    key: string;
+}
+interface ModalSpacer {
+    type: 'spacer';
+    height: number;
+    widthPercent: 50 | 100;
+    when?: string | undefined;
+    key: string;
+}
+interface ModalDropdown {
+    type: 'dropdown';
+    label: string;
+    placeholder: string;
+    widthPercent: 50 | 100;
+    id: string;
+    multiselect?: boolean;
+    options: SelectOption[];
+    defaultValue?: string;
+    optionMapper?: UnknownFunction;
+    getFetchUrl?: UnknownFunction;
+    getHeaders?: UnknownFunction;
+    getBody?: UnknownFunction;
+    args?: UnknownJSON;
+    when?: string | undefined;
+    key: string;
+}
+interface ModalContainer {
+    type: 'container';
+    fields: ModalBlock[];
+    when?: string | undefined;
+    key: string;
+}
+type ModalBlock = ModalDescription | ModalTextInput | ModalSpacer | ModalDropdown | ModalContainer;
+interface ModalConfig {
+    title?: string;
+    confirmButton?: ButtonConfig;
+    cancelButton?: ButtonConfig;
+    content?: ModalBlock[];
+    dynamic?: boolean;
+    pluginApiName?: string;
+}
+interface DynamicPromptConfig {
+    title?: string;
+    confirmButton?: ButtonConfig;
+    cancelButton?: ButtonConfig;
+    content?: ModalBlock[];
+    registerUtils?: Record<string, (...args: unknown[]) => unknown>;
+}
+type PromptState = Record<string, unknown>;
+type DynamicPromptFn = (config: DynamicPromptConfig) => Promise<{
+    values: Record<string, ValueStore>;
+}>;
+type CurriedDynamicPromptFn = (instance: Instance, promises: WorkerPromise) => DynamicPromptFn;
+type UnknownFunction = (...args: unknown[]) => unknown;
+type SetupAssistantField = ModalBlock | AssistantField;
+type MatchSetupAssistantField = AssistantField & {
+    match_hint?: string;
+};
+interface SetupAssistantConfig {
+    fields?: SetupAssistantField[] | undefined;
+    actions?: AssistantConfigAction[] | undefined;
+    services?: ConfigService[] | undefined;
+}
+interface AssistantConfigAction {
+    api_name: string;
+    name: string;
+    hint_object_name?: string;
+}
+interface AssistantField {
+    key: string;
+    type: 'custom_object' | 'description' | 'container' | 'field' | 'text' | 'number' | 'select' | 'boolean';
+    columns?: number;
+    fields?: AssistantField[];
+    content?: string;
+    label?: string;
+    object_id?: string;
+    default?: string;
+    options?: SelectOption[];
+    allow_multiple?: boolean;
+    placeholder?: string;
+    when?: string;
+    getFetchUrl?: string;
+    typeahead?: boolean;
+    optionMapper?: string;
+    fetchMethod?: 'GET' | 'POST';
+    getHeaders?: string;
+    getBody?: string;
+    getContextUrl?: string;
+    autoSelect?: boolean;
+    required?: boolean;
+    tooltip?: string;
+    dependencies?: string[];
+    validation_pattern?: string;
+    match_hint?: string;
+}
+type BooleanCleanValue = boolean;
+interface BooleanValueStore {
+    value: boolean;
+}
+interface CustomObjectCleanValue {
+    objectId: string;
+    objectName: string;
+}
+interface CustomObjectValueStore {
+    value?: {
+        id: string;
+        objectName: string;
+    };
+}
+interface FieldCleanValueSingle {
+    fieldId: string;
+    fieldName: string;
+    objectId?: string;
+    objectName?: string;
+}
+type FieldCleanValue = FieldCleanValueSingle | FieldCleanValueSingle[];
+interface FieldValueStore {
+    value: SelectOption | SelectOption[];
+    associatedObject?: {
+        id: string;
+        name: string;
+    };
+}
+type NumberCleanValue = number;
+interface NumberValueStore {
+    value: number | string;
+}
+type SelectCleanValue = SelectOption | SelectOption[];
+interface SelectValueStore {
+    value: SelectOption | SelectOption[];
+}
+type TextCleanValue = string;
+interface TextValueStore {
+    value: string;
+}
+type ValueStore = BooleanValueStore | CustomObjectValueStore | FieldValueStore | NumberValueStore | SelectValueStore | TextValueStore;
+type CleanValueStoreType = BooleanCleanValue | CustomObjectCleanValue | FieldCleanValue | NumberCleanValue | SelectCleanValue | TextCleanValue;
+type CleanValueStore = Record<string, CleanValueStoreType>;
+type OnShowModalFn = (config: ModalConfig, cb: () => void) => void;
+type OnShowCreateRecordModalFn = (objectId: string, cb: (result: UnknownJSON) => void) => void;
+type OnShowCreateRelatedRecordModalFn = (objectId: string, relatedEntityId: string, cb: (result: UnknownJSON) => void) => void;
+type ModalQueue = {
+    config: ModalConfig;
+    cb: (...args: unknown[]) => void;
+}[];
+type CreateRecordModalQueue = {
+    objectId: string;
+    cb: (result: UnknownJSON) => void;
+}[];
+type CreateRelatedRecordModalQueue = {
+    objectId: string;
+    relatedEntityId: string;
+    cb: (result: UnknownJSON) => void;
+}[];
+type ModalCancelEventSource = 'button' | 'close';
+interface ConfigService {
+    api_name: string;
+    prerequisite: boolean;
+    required: boolean;
+}
+
+type KizenRequestFnHandler<T = unknown> = (url: string, payload: unknown, options?: unknown) => Promise<T>;
+type KizenRequestFn = <T>(method: string) => KizenRequestFnHandler<T>;
+type CurriedKizenRequestFn = (instance: Instance, promises: WorkerPromise) => KizenRequestFn;
+interface RequestOptions {
+    headers?: Record<string, string>;
+    returnErrors?: boolean;
+    credentials?: 'include';
+}
+type GetOptions = RequestOptions & {
+    ignoreCache?: boolean;
+};
+interface GetReturnValue {
+    data: UnknownJSON;
+}
+interface PostReturnValue {
+    data: UnknownJSON;
+}
+interface PatchReturnValue {
+    data: UnknownJSON;
+}
+interface PutReturnValue {
+    data: UnknownJSON;
+}
+interface DeleteReturnValue {
+    data: UnknownJSON;
+}
+type RequestWithErrorsResponse = [UnknownJSON | null, UnknownJSON | null];
+type OnNetworkErrorFn = (error: unknown) => void;
+
+declare const ACTIONS: {
+    QUERY_REQUEST: string;
+    UI_OUTPUT: string;
+    IFRAME_OUTPUT: string;
+    POSTFORMDATA_REQUEST: string;
+    SETSTATE: string;
+    DONE: string;
+    RUN: string;
+    OPEN_WINDOW: string;
+    COMMUNICATE: string;
+    HIDE: string;
+    SHOW: string;
+    EXPAND: string;
+    COLLAPSE: string;
+    HIDE_HEADER: string;
+    SHOW_HEADER: string;
+    OPEN_CREATE_RECORD_MODAL_REQUEST: string;
+    OPEN_CREATE_RELATED_RECORD_MODAL_REQUEST: string;
+    SHOW_TOAST: string;
+    CLEAR_TOASTS: string;
+    REFRESH_TIMELINE: string;
+    REFRESH_ENTITY: string;
+    UPLOADFILE_REQUEST: string;
+    UPDATE_SESSION_DATA: string;
+    INSTALL_THIRD_PARTY_SCRIPT_REQUEST: string;
+    PROMPT_REQUEST: string;
+    DYNAMIC_PROMPT_REQUEST: string;
+    RELEASE_BLOCKING_SCRIPT: string;
+    AUTHORIZE: string;
+    COPY_TO_CLIPBOARD: string;
+};
+declare enum INDICATOR_TYPE {
+    NONE = "none",
+    BLOCK = "block",
+    BUTTON = "button",
+    SPINNER = "spinner"
+}
+declare const IFRAME_PREFIX = "kzn-integration-frame";
+
+interface ErrorResponse {
+    status: number;
+    statusText: string;
+    body?: unknown;
+}
+interface DataCacheEntry<T> {
+    ts: number;
+    data: T;
+}
+type DataCache<T> = Map<string, DataCacheEntry<T>>;
+interface BaseAPI {
+    get: KizenRequestFnHandler<GetReturnValue>;
+    post: KizenRequestFnHandler<PostReturnValue>;
+    put: KizenRequestFnHandler<PutReturnValue>;
+    delete: KizenRequestFnHandler<DeleteReturnValue>;
+    patch: KizenRequestFnHandler<PatchReturnValue>;
+}
+type PostFormDataPayload = Record<string, unknown>;
+type PostFormDataFn = (url: string, data: PostFormDataPayload, createNewTab?: boolean) => Promise<unknown>;
+type CurriedPostFormDataFn = (instance: Instance, promises: WorkerPromise) => PostFormDataFn;
+interface StateChangePayload {
+    indicator?: INDICATOR_TYPE;
+    hidden?: boolean;
+    minimized?: boolean;
+    triggerHidden?: boolean;
+    hideHeader?: boolean;
+    createObjectRecordId?: string;
+}
+type Instance = Window & typeof globalThis;
+interface UploadFileData {
+    file: string;
+    isPublic?: boolean;
+    fileName?: string;
+}
+type UploadFileFn = (data: UploadFileData) => Promise<unknown>;
+type CurriedUploadFileFn = (instance: Instance, promises: WorkerPromise) => UploadFileFn;
+type InternalSessionData = Record<string, unknown>;
+type SetInternalSessionDataFn = (pluginId: string, state: InternalSessionData) => void;
+type InstallThirdPartyScriptFn = (url: string, args: Record<string, unknown>) => Promise<{
+    url: string;
+}>;
+type CurriedInstallThirdPartyScriptFn = (instance: Instance, promises: WorkerPromise) => InstallThirdPartyScriptFn;
+type PromptFn = (config: ModalConfig) => Promise<unknown>;
+type CurriedPromptFn = (instance: Instance, promises: WorkerPromise) => PromptFn;
+type RefreshEntityFn = (entityId: string) => Promise<unknown>;
+type CurriedRefreshEntityFn = (instance: Instance, promises: WorkerPromise) => RefreshEntityFn;
+type OpenCreateRecordFn = (objectId: string) => Promise<unknown>;
+type CurriedOpenCreateRecordFn = (instance: Instance, promises: WorkerPromise) => OpenCreateRecordFn;
+type OpenCreateRelatedRecordFn = (objectId: string, relatedEntityId: string) => Promise<unknown>;
+type CurriedOpenCreateRelatedRecordFn = (instance: Instance, promises: WorkerPromise) => OpenCreateRelatedRecordFn;
+interface WorkerContextArgs {
+    user: PartialUser;
+    teamMember: PartialTeamMember;
+    business: PartialBusiness;
+    clientObject?: PartialClientObject | undefined;
+    appPath: string;
+    onStateChange?: (options: StateChangePayload) => void;
+    scriptUIRef?: RefObject<HTMLDivElement | null>;
+    isDebug?: boolean;
+    scriptBody: string;
+    functionBody: string;
+    instance: Instance;
+    kizenRequest: KizenRequestFn;
+    postFormData: PostFormDataFn;
+    onError?: ErrorHandler;
+    onReleaseBlockingScript?: ReleaseBlockingScriptHandler;
+    args?: string;
+    uploadFile: UploadFileFn;
+    sessionData?: InternalSessionData;
+    pluginComponentId?: string;
+    installThirdPartyScript: InstallThirdPartyScriptFn;
+    prompt: PromptFn;
+    dynamicPrompt: DynamicPromptFn;
+    refreshEntity: RefreshEntityFn;
+    openCreateRecord: OpenCreateRecordFn;
+    openCreateRelatedRecord: OpenCreateRelatedRecordFn;
+    pluginApiName: string;
+    location: PartialLocation;
+}
+type KizenConfig = Record<string, unknown>;
+interface KnownArgs {
+    __kizen_clean_config?: KizenConfig;
+    __kizen_user_config?: {
+        __kizen_clean_config?: KizenConfig;
+    };
+    pluginId?: string;
+}
+interface UserConfig {
+    config?: Record<string, UnknownJSON>;
+}
+type Args = KnownArgs & Record<string, unknown>;
+interface ShowToastOptions {
+    variant?: 'alert' | 'failure' | 'success';
+    autohide?: boolean;
+}
+
+declare const ALLOWED_INTEGRATIONS: {
+    readonly FRESHWORKS: "freshworks";
+    readonly INTERCOM: "intercom";
+};
+declare class ThirdPartyScript {
+    private instance;
+    private scriptUrl;
+    private integration;
+    constructor(instance: Instance, scriptUrl: string);
+    get type(): (typeof ALLOWED_INTEGRATIONS)[keyof typeof ALLOWED_INTEGRATIONS];
+    call(...params: unknown[]): void;
+}
+
+export { type ErrorHandler as $, type Args as A, type BaseAPI as B, type CurrentUser as C, type DataCache as D, type CurriedInstallThirdPartyScriptFn as E, type CurriedKizenRequestFn as F, type GetOptions as G, type CurriedOpenCreateRecordFn as H, type Instance as I, type CurriedOpenCreateRelatedRecordFn as J, type CurriedPostFormDataFn as K, type CurriedPromptFn as L, type ModalConfig as M, type CurriedRefreshEntityFn as N, type CurriedUploadFileFn as O, type PartialEntity as P, type CustomObjectCleanValue as Q, type RequestWithErrorsResponse as R, type StateChangePayload as S, ThirdPartyScript as T, type UnknownJSON as U, type CustomObjectValueStore as V, type WorkerContextArgs as W, type DataCacheEntry as X, type DeleteReturnValue as Y, type DynamicPromptFn as Z, type EmployeeConfig as _, type PartialCustomObject as a, type ErrorResponse as a0, type FieldCleanValue as a1, type FieldValueStore as a2, type GetReturnValue as a3, type InstallThirdPartyScriptFn as a4, type JSONArray as a5, type JSONObject as a6, type JSONPrimitive as a7, type JSONValue as a8, type KizenConfig as a9, type PromptFn as aA, type PutReturnValue as aB, type RefreshEntityFn as aC, type ReleaseBlockingScriptHandler as aD, type SelectCleanValue as aE, type SelectValueStore as aF, type SetInternalSessionDataFn as aG, type SetupAssistantConfig as aH, type SetupAssistantField as aI, type TextValueStore as aJ, type UnknownFunction as aK, type UploadFileData as aL, type UploadFileFn as aM, type UserConfig as aN, type ValueStore as aO, ACTIONS as aP, ALLOWED_INTEGRATIONS as aQ, IFRAME_PREFIX as aR, INDICATOR_TYPE as aS, type KizenRequestFn as aa, type KizenRequestFnHandler as ab, type KnownArgs as ac, type MatchSetupAssistantField as ad, type MaybeMessageError as ae, type ModalBlock as af, type ModalCancelEventSource as ag, type ModalContainer as ah, type ModalQueue as ai, type NumberCleanValue as aj, type NumberValueStore as ak, type OnNetworkErrorFn as al, type OnShowCreateRecordModalFn as am, type OnShowCreateRelatedRecordModalFn as an, type OnShowModalFn as ao, type OpenCreateRecordFn as ap, type OpenCreateRelatedRecordFn as aq, type PartialRelatedObject as ar, type PatchReturnValue as as, type PostFormDataPayload as at, type PostReturnValue as au, type Profile as av, type PromiseMap as aw, type PromiseReject as ax, type PromiseResolve as ay, type PromiseState as az, type PartialUser as b, type PartialTeamMember as c, type PartialBusiness as d, type PartialClientObject as e, type PostFormDataFn as f, type PromptState as g, type InternalSessionData as h, type PartialLocation as i, type RequestOptions as j, type ShowToastOptions as k, type DynamicPromptConfig as l, type SelectOption as m, type AppPlugin as n, type AppPlugins as o, type AssistantConfigAction as p, type AssistantField as q, type BooleanCleanValue as r, type BooleanValueStore as s, type ButtonConfig as t, type CleanValueStore as u, type CleanValueStoreType as v, type ConfigService as w, type CreateRecordModalQueue as x, type CreateRelatedRecordModalQueue as y, type CurriedDynamicPromptFn as z };

package/dist/automation-C8hsM_Rc.d.ts

@@ -0,0 +1,36 @@
+import { a as CommonPluginDefinition } from './routeScript-kttY2YZh.js';
+
+interface DataAdornmentConfig extends CommonPluginDefinition {
+    id?: string;
+    field_type: 'phonenumber' | 'date' | 'datetime';
+    script: string;
+    config: {
+        icon: string;
+        color: string;
+        tooltip: string;
+        customIcon?: string;
+    };
+    when?: string;
+    plugin_name?: string;
+}
+
+interface ToolbarItemConfig extends CommonPluginDefinition {
+    api_name: string;
+    color?: string;
+    icon?: string;
+    label: string;
+    script: string;
+    when?: string;
+}
+
+interface AutomationStepConfig<T = unknown> {
+    name: string;
+    overallDescription: string;
+    actions: Record<string, T>;
+    thumbnail?: string;
+    when?: string;
+    action_step_api_name?: string;
+    plugin_api_name?: string;
+}
+
+export type { AutomationStepConfig as A, DataAdornmentConfig as D, ToolbarItemConfig as T };