@uniformdev/mesh-sdk 19.62.0 → 19.62.1-alpha.127

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { ApiClient, ClientOptions, ExceptProject } from '@uniformdev/context/api';
 import { ProjectMapNode } from '@uniformdev/project-map';
-import { DataType, DataSource, DataResourceVariables, RootComponentInstance, ComponentInstance, ComponentDefinition, ComponentDefinitionParameter, DataVariableDefinition } from '@uniformdev/canvas';
+import { AssetParamValue, DataType, DataSource, DataResourceVariables, RootComponentInstance, ComponentInstance, ComponentDefinition, ComponentDefinitionParameter, DataVariableDefinition } from '@uniformdev/canvas';
+export { AssetParamValue, AssetParamValueItem } from '@uniformdev/canvas';
 import { Emitter } from 'mitt';
 
 /**
@@ -31,6 +32,7 @@ interface paths$1 {
                                 /** @enum {string} */
                                 category?: "analytics" | "cdn" | "classic" | "commerce" | "content" | "comingSoon" | "data" | "deprecated" | "email" | "framework" | "search" | "starters" | "uniform" | "ai" | "unknown";
                                 public?: boolean;
+                                scopes?: string[];
                                 baseLocationUrl?: string;
                                 locations: {
                                     install?: {
@@ -63,6 +65,8 @@ interface paths$1 {
                                                 };
                                             };
                                             renderableInPropertyPanel?: boolean;
+                                            /** @enum {string} */
+                                            localizable?: "default-yes" | "default-no" | "yes" | "no";
                                         }[];
                                     };
                                     dataConnectors?: {
@@ -93,10 +97,68 @@ interface paths$1 {
                                         };
                                         badgeIconUrl?: string;
                                     }[];
+                                    assetLibrary?: {
+                                        assetLibraryUrl: string;
+                                        assetParameterUrl: string;
+                                        unstable_dynamicAssets?: {
+                                            dataConnectorId: string;
+                                            assetsListArchetypeId: string;
+                                            singleAssetArchetypeId: string;
+                                        };
+                                    };
+                                    unstable_assetLibrary?: {
+                                        url: string;
+                                        dynamicAssets?: {
+                                            dataConnectorId: string;
+                                            assetsListArchetypeId: string;
+                                            singleAssetArchetypeId: string;
+                                        };
+                                    };
+                                    ai?: {
+                                        generateUrl: string;
+                                        metadataUrl?: string;
+                                        prompts?: {
+                                            /** Format: uuid */
+                                            id: string;
+                                            name: string;
+                                            text: string;
+                                            data?: {
+                                                arguments?: {
+                                                    [key: string]: {
+                                                        type: string;
+                                                        displayName?: string | null;
+                                                        helpText?: string | null;
+                                                        default?: string | null;
+                                                    };
+                                                } | null;
+                                                metadata?: unknown | null;
+                                            } | null;
+                                            parameterTypes: string[];
+                                        }[];
+                                    };
                                     unstable_ai?: {
                                         generateUrl: string;
+                                        metadataUrl?: string;
                                     };
                                 };
+                                unstable_prompts?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    name: string;
+                                    text: string;
+                                    data?: {
+                                        arguments?: {
+                                            [key: string]: {
+                                                type: string;
+                                                displayName?: string | null;
+                                                helpText?: string | null;
+                                                default?: string | null;
+                                            };
+                                        } | null;
+                                        metadata?: unknown | null;
+                                    } | null;
+                                    parameterTypes: string[];
+                                }[];
                             }[];
                         };
                     };
@@ -122,6 +184,7 @@ interface paths$1 {
                             /** @enum {string} */
                             category?: "analytics" | "cdn" | "classic" | "commerce" | "content" | "comingSoon" | "data" | "deprecated" | "email" | "framework" | "search" | "starters" | "uniform" | "ai" | "unknown";
                             public?: boolean;
+                            scopes?: string[];
                             baseLocationUrl?: string;
                             locations: {
                                 install?: {
@@ -154,6 +217,8 @@ interface paths$1 {
                                             };
                                         };
                                         renderableInPropertyPanel?: boolean;
+                                        /** @enum {string} */
+                                        localizable?: "default-yes" | "default-no" | "yes" | "no";
                                     }[];
                                 };
                                 dataConnectors?: {
@@ -184,10 +249,68 @@ interface paths$1 {
                                     };
                                     badgeIconUrl?: string;
                                 }[];
+                                assetLibrary?: {
+                                    assetLibraryUrl: string;
+                                    assetParameterUrl: string;
+                                    unstable_dynamicAssets?: {
+                                        dataConnectorId: string;
+                                        assetsListArchetypeId: string;
+                                        singleAssetArchetypeId: string;
+                                    };
+                                };
+                                unstable_assetLibrary?: {
+                                    url: string;
+                                    dynamicAssets?: {
+                                        dataConnectorId: string;
+                                        assetsListArchetypeId: string;
+                                        singleAssetArchetypeId: string;
+                                    };
+                                };
+                                ai?: {
+                                    generateUrl: string;
+                                    metadataUrl?: string;
+                                    prompts?: {
+                                        /** Format: uuid */
+                                        id: string;
+                                        name: string;
+                                        text: string;
+                                        data?: {
+                                            arguments?: {
+                                                [key: string]: {
+                                                    type: string;
+                                                    displayName?: string | null;
+                                                    helpText?: string | null;
+                                                    default?: string | null;
+                                                };
+                                            } | null;
+                                            metadata?: unknown | null;
+                                        } | null;
+                                        parameterTypes: string[];
+                                    }[];
+                                };
                                 unstable_ai?: {
                                     generateUrl: string;
+                                    metadataUrl?: string;
                                 };
                             };
+                            unstable_prompts?: {
+                                /** Format: uuid */
+                                id: string;
+                                name: string;
+                                text: string;
+                                data?: {
+                                    arguments?: {
+                                        [key: string]: {
+                                            type: string;
+                                            displayName?: string | null;
+                                            helpText?: string | null;
+                                            default?: string | null;
+                                        };
+                                    } | null;
+                                    metadata?: unknown | null;
+                                } | null;
+                                parameterTypes: string[];
+                            }[];
                         };
                     };
                 };
@@ -212,6 +335,7 @@ interface paths$1 {
                             badgeIconUrl?: string;
                             /** @enum {string} */
                             category?: "analytics" | "cdn" | "classic" | "commerce" | "content" | "comingSoon" | "data" | "deprecated" | "email" | "framework" | "search" | "starters" | "uniform" | "ai" | "unknown";
+                            scopes?: string[];
                             baseLocationUrl?: string;
                             locations: {
                                 install?: {
@@ -244,6 +368,8 @@ interface paths$1 {
                                             };
                                         };
                                         renderableInPropertyPanel?: boolean;
+                                        /** @enum {string} */
+                                        localizable?: "default-yes" | "default-no" | "yes" | "no";
                                     }[];
                                 };
                                 dataConnectors?: {
@@ -274,10 +400,68 @@ interface paths$1 {
                                     };
                                     badgeIconUrl?: string;
                                 }[];
+                                assetLibrary?: {
+                                    assetLibraryUrl: string;
+                                    assetParameterUrl: string;
+                                    unstable_dynamicAssets?: {
+                                        dataConnectorId: string;
+                                        assetsListArchetypeId: string;
+                                        singleAssetArchetypeId: string;
+                                    };
+                                };
+                                unstable_assetLibrary?: {
+                                    url: string;
+                                    dynamicAssets?: {
+                                        dataConnectorId: string;
+                                        assetsListArchetypeId: string;
+                                        singleAssetArchetypeId: string;
+                                    };
+                                };
+                                ai?: {
+                                    generateUrl: string;
+                                    metadataUrl?: string;
+                                    prompts?: {
+                                        /** Format: uuid */
+                                        id: string;
+                                        name: string;
+                                        text: string;
+                                        data?: {
+                                            arguments?: {
+                                                [key: string]: {
+                                                    type: string;
+                                                    displayName?: string | null;
+                                                    helpText?: string | null;
+                                                    default?: string | null;
+                                                };
+                                            } | null;
+                                            metadata?: unknown | null;
+                                        } | null;
+                                        parameterTypes: string[];
+                                    }[];
+                                };
                                 unstable_ai?: {
                                     generateUrl: string;
+                                    metadataUrl?: string;
                                 };
                             };
+                            unstable_prompts?: {
+                                /** Format: uuid */
+                                id: string;
+                                name: string;
+                                text: string;
+                                data?: {
+                                    arguments?: {
+                                        [key: string]: {
+                                            type: string;
+                                            displayName?: string | null;
+                                            helpText?: string | null;
+                                            default?: string | null;
+                                        };
+                                    } | null;
+                                    metadata?: unknown | null;
+                                } | null;
+                                parameterTypes: string[];
+                            }[];
                         };
                     };
                 };
@@ -551,6 +735,7 @@ declare class IntegrationDefinitionClient extends ApiClient<DefClientOptions> {
         badgeIconUrl?: string | undefined;
         category?: "analytics" | "cdn" | "classic" | "commerce" | "content" | "comingSoon" | "data" | "deprecated" | "email" | "framework" | "search" | "starters" | "uniform" | "ai" | "unknown" | undefined;
         public?: boolean | undefined;
+        scopes?: string[] | undefined;
         baseLocationUrl?: string | undefined;
         locations: {
             install?: {
@@ -583,6 +768,7 @@ declare class IntegrationDefinitionClient extends ApiClient<DefClientOptions> {
                         };
                     } | undefined;
                     renderableInPropertyPanel?: boolean | undefined;
+                    localizable?: "default-yes" | "default-no" | "yes" | "no" | undefined;
                 }[];
             } | undefined;
             dataConnectors?: {
@@ -613,10 +799,66 @@ declare class IntegrationDefinitionClient extends ApiClient<DefClientOptions> {
                 } | undefined;
                 badgeIconUrl?: string | undefined;
             }[] | undefined;
+            assetLibrary?: {
+                assetLibraryUrl: string;
+                assetParameterUrl: string;
+                unstable_dynamicAssets?: {
+                    dataConnectorId: string;
+                    assetsListArchetypeId: string;
+                    singleAssetArchetypeId: string;
+                } | undefined;
+            } | undefined;
+            unstable_assetLibrary?: {
+                url: string;
+                dynamicAssets?: {
+                    dataConnectorId: string;
+                    assetsListArchetypeId: string;
+                    singleAssetArchetypeId: string;
+                } | undefined;
+            } | undefined;
+            ai?: {
+                generateUrl: string;
+                metadataUrl?: string | undefined;
+                prompts?: {
+                    id: string;
+                    name: string;
+                    text: string;
+                    data?: {
+                        arguments?: {
+                            [key: string]: {
+                                type: string;
+                                displayName?: string | null | undefined;
+                                helpText?: string | null | undefined;
+                                default?: string | null | undefined;
+                            };
+                        } | null | undefined;
+                        metadata?: unknown;
+                    } | null | undefined;
+                    parameterTypes: string[];
+                }[] | undefined;
+            } | undefined;
             unstable_ai?: {
                 generateUrl: string;
+                metadataUrl?: string | undefined;
             } | undefined;
         };
+        unstable_prompts?: {
+            id: string;
+            name: string;
+            text: string;
+            data?: {
+                arguments?: {
+                    [key: string]: {
+                        type: string;
+                        displayName?: string | null | undefined;
+                        helpText?: string | null | undefined;
+                        default?: string | null | undefined;
+                    };
+                } | null | undefined;
+                metadata?: unknown;
+            } | null | undefined;
+            parameterTypes: string[];
+        }[] | undefined;
     }>;
     /** Deletes a mesh app from a team */
     remove(body: Omit<IntegrationDefinitionDeleteParameters, 'teamId'>): Promise<void>;
@@ -638,16 +880,31 @@ declare class IntegrationInstallationClient extends ApiClient {
     remove(body: ExceptProject<IntegrationInstallationDeleteParameters>): Promise<void>;
 }
 
+type AssetLibraryLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** The current Uniform integration source ID */
+    sourceId: string;
+}, TIntegrationConfiguration>;
+type AssetParameterLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** The current Uniform integration source ID */
+    sourceId: string;
+    /** The resolved data if this source is connected to a data resource */
+    dataResourceData?: unknown;
+    /**
+     * The maximum number of assets that can be selected in the Asset Library.
+     *
+     * Default: 1
+     */
+    maxAssets?: number;
+}, TIntegrationConfiguration>;
+type AssetLibraryLocation = MeshLocationCore<unknown, AssetLibraryLocationMetadata, unknown, 'assetLibrary'> & GetDataResourceLocation;
+type AssetParameterLocation = MeshLocationCore<AssetParamValue, AssetParameterLocationMetadata, AssetParamValue, 'assetParameter'> & GetDataResourceLocation;
+
 type DataTypeLocationValue = Pick<DataType, 'body' | 'method' | 'path' | 'custom' | 'headers' | 'parameters' | 'variables'>;
 type DataConnectorInfo = {
     type: string;
     displayName: string;
 };
-type DataTypeLocationMetadata<TIntegrationConfiguration = unknown> = {
-    /** Settings defined at the integration level (arbitrary type used on settings location) */
-    settings: TIntegrationConfiguration;
-    /** The Uniform project ID */
-    projectId: string;
+type DataTypeLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     /**
      * The current data type's data source. NOTE: param and header values are not available in this context.
      */
@@ -656,13 +913,10 @@ type DataTypeLocationMetadata<TIntegrationConfiguration = unknown> = {
     dataConnector: DataConnectorInfo;
     /** The data type's archetype value. */
     archetype: string;
-};
+}, TIntegrationConfiguration>;
 type DataTypeLocation = MeshLocationCore<DataTypeLocationValue, DataTypeLocationMetadata, DataTypeLocationValue, 'dataType'> & GetDataResourceLocation;
 
-type DataResourceLocationMetadata<TIntegrationConfiguration = unknown> = {
-    /** Settings defined at the integration level (arbitrary type used on settings location) */
-    settings: TIntegrationConfiguration;
-    /** The current data resource's data type */
+type DataResourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     dataType: DataType;
     /** The data type's archetype value. */
     archetype: string;
@@ -672,32 +926,21 @@ type DataResourceLocationMetadata<TIntegrationConfiguration = unknown> = {
     dataSource: DataSource;
     /** The data connector type of the current data resource's data source */
     dataConnector: DataConnectorInfo;
-    /** The Uniform project ID */
-    projectId: string;
     /** Current dynamic inputs that are configured on the composition (if any). */
     dynamicInputs: DynamicInputs;
-};
+}, TIntegrationConfiguration>;
 type DataResourceLocation = MeshLocationCore<DataResourceVariables, DataResourceLocationMetadata, DataResourceVariables, 'dataResource'> & GetDataResourceLocation;
 
-type DataSourceLocationValue = Pick<DataSource, 'baseUrl' | 'custom' | 'headers' | 'parameters' | 'variables'>;
-type DataSourceLocationMetadata<TIntegrationConfiguration = unknown> = {
-    /** Settings defined at the integration level (arbitrary type used on settings location) */
-    settings: TIntegrationConfiguration;
-    /** The Uniform project ID */
-    projectId: string;
-};
+type DataSourceLocationValue = Pick<DataSource, 'baseUrl' | 'custom' | 'customPublic' | 'headers' | 'parameters' | 'variables'>;
+type DataSourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<unknown, TIntegrationConfiguration>;
 type DataSourceLocation = MeshLocationCore<DataSourceLocationValue, DataSourceLocationMetadata, DataSourceLocationValue, 'dataSource'>;
 
-type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfiguration = unknown> = {
+type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfiguration = unknown> = CommonMetadata<{
     rootNode: Omit<RootComponentInstance, 'slots' | '_data'>;
     parameterConfiguration: TParamConfiguration;
     component: Omit<ComponentInstance, 'slots'>;
     componentDefinitions: Record<string, ComponentDefinition | undefined>;
     parameterDefinition: ComponentDefinitionParameter;
-    /** Settings defined at the integration level (arbitrary type used on settings location) */
-    settings: TIntegrationConfiguration;
-    /** The Uniform project ID */
-    projectId: string;
     /**
      * Current dynamic inputs that are configured on the composition (if any).
      * Use the <ParamTypeDynamicDataProvider> to wire up dynamic data in your parameter.
@@ -712,7 +955,14 @@ type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfig
      * Use the <ParamTypeDynamicDataProvider> to wire up dynamic data in your parameter.
      */
     connectedData: Record<string, unknown>;
-};
+    /**
+     * The target locale being edited.
+     * If the parameter is not defined as localizable, then this is always undefined.
+     * If the parameter is localizable, then this is the current editor language.
+     * Note that setValue() always sets the target language automatically.
+     */
+    targetLocale: string | undefined;
+}, TIntegrationConfiguration>;
 type ParamTypeLocation<TParamValue = unknown, TParamConfiguration = unknown, TParamSetValue = TParamValue, TIntegrationConfiguration = unknown> = MeshLocationCore<TParamValue | undefined, ParamTypeLocationMetadata<TParamConfiguration, TIntegrationConfiguration>, TParamSetValue, 'paramType'> & {
     /**
      * Opens a dialog on the Uniform platform to edit or select a dynamic token to connect to.
@@ -721,16 +971,14 @@ type ParamTypeLocation<TParamValue = unknown, TParamConfiguration = unknown, TPa
     editConnectedData: Awaited<ReturnType<typeof connectToParent>>['parent']['editConnectedData'];
 };
 
-type SettingsLocationMetadata = {
-    projectId: string;
-};
+type SettingsLocationMetadata = CommonMetadata;
 type SettingsLocation<TSettingsType> = MeshLocationCore<TSettingsType, SettingsLocationMetadata, TSettingsType, 'settings'>;
 
 /**
  * Defines methods used for interacting with a Mesh location
  * To receive useful typings, check the `type` property of the location to narrow the typing.
  */
-type MeshLocation<TValue = unknown, TSetValue = TValue> = ParamTypeLocation<TValue, unknown, TSetValue> | ParamTypeConfigLocation<TValue> | SettingsLocation<TValue> | DataSourceLocation | DataTypeLocation | DataResourceLocation | AIGenerateLocation<TValue>;
+type MeshLocation<TValue = unknown, TSetValue = TValue> = ParamTypeLocation<TValue, unknown, TSetValue> | ParamTypeConfigLocation<TValue> | SettingsLocation<TValue> | AssetLibraryLocation | AssetParameterLocation | DataSourceLocation | DataTypeLocation | DataResourceLocation | AIGenerateLocation<TValue> | AIPromptMetadataLocation;
 interface MeshContextData {
     locationKey: string;
     locationType: MeshLocationTypes;
@@ -769,6 +1017,12 @@ type OpenDialogResult = {
     dialogLocation?: string;
 };
 type DialogSizes = 'narrow' | 'medium' | 'wide';
+/**
+ * Here we are using a trick to allow arbitrary max width values, also prioritizing enum from maxWidth.
+ */
+type ArbitraryMaxWidth = string & {
+    neverEverLetYouGo?: never;
+};
 interface DialogOptions<TDialogParams = DialogParams> {
     /**
      * By default, dialogs will be closed when they set a value.
@@ -780,9 +1034,12 @@ interface DialogOptions<TDialogParams = DialogParams> {
     disableCloseDialogOnSetValue?: boolean;
     /**
      * Options for setting the max width of the dialog.
+     *
+     * Custom string can be used for specific custom width .e.g "clamp(300px, 50%, 600px)"
+     *
      * @deprecated Use `width` instead. This property will become ignored in a future release.
      */
-    maxWidth?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | 'full';
+    maxWidth?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | 'full' | ArbitraryMaxWidth;
     /**
      * Options for setting the width of the dialog.
      */
@@ -792,6 +1049,10 @@ interface DialogOptions<TDialogParams = DialogParams> {
      * the `metadata` object for the dialog location, e.g. `metadata.dialogParams`.
      * Parameters should be simple (serializable) types, not functions or DOM
      * elements or similar non-serializable objects.
+     *
+     * Best practice is to keep size of the params as small as possible.
+     *
+     * @see https://surma.dev/things/is-postmessage-slow/
      */
     params?: TDialogParams;
     /**
@@ -829,7 +1090,7 @@ type CloseDialogMessage = {
     dialogType: DialogType;
     dialogData?: unknown;
 };
-type GetDataResourceMessage = Pick<DataType, 'path' | 'headers' | 'parameters' | 'body' | 'method'>;
+type GetDataResourceMessage = Pick<DataType, 'path' | 'archetype' | 'headers' | 'parameters' | 'body' | 'method'>;
 /** Primitive data types that a parameter type accepts to be bound to composition data */
 type BindableTypes = 'string' | 'number' | 'boolean' | 'object' | 'array';
 /** Message to parent to create a data connection expression to insert in a param type */
@@ -854,6 +1115,22 @@ type EditConnectedDataResponse = {
     canceled: true;
     editorCancelledContext: EditConnectedDataResponseCancellationContext;
 };
+type UniformUser = {
+    /** Permissions the user has as per Team Admin assigned, can be used to do conditional rendering */
+    permissions: MeshLocationUserPermissions[];
+    /** Permissions the user has as per Team Admin created and assigned, can be used to do conditional rendering */
+    roles: {
+        id: string;
+        name: string;
+    }[];
+    /** Name of the user assigned by Team Admin. Unless your Mesh integration was given permissions to expose User Name - it is not available */
+    name?: string;
+    /** Email of the user used to sign in. Unless your Mesh integration was given permissions to expose User Name - it is not available */
+    email?: string;
+    /** Unique ID of the user */
+    id: string;
+    isAdmin: boolean;
+};
 
 type MeshSDKEventInterface = Awaited<ReturnType<typeof connectToParent>>['parent'] & {
     initialize: () => Promise<MeshContextData>;
@@ -916,10 +1193,96 @@ interface MeshLocationCore<TValue = unknown, TMetadata = unknown, TSetValue = TV
         returnDialogValue: (value: unknown) => Promise<void>;
     };
 }
+/** Common metadata for all mesh locations */
+type CommonMetadata<ExtendedMetadata = unknown, TIntegrationConfiguration = unknown> = {
+    /** The current Uniform user context. Contains name, email and context to check for permissions */
+    user: UniformUser;
+    /** Current Uniform Project ID */
+    projectId: string;
+    /** Settings defined at the integration level (arbitrary type used on settings location) */
+    settings: TIntegrationConfiguration;
+} & ExtendedMetadata;
+type MeshLocationUserPermissions = 
+/** Uniform Context:Enrichments:Create */
+'ENRICHMENTS_CREATE'
+/** Uniform Context:Enrichments:Update */
+ | 'ENRICHMENTS_UPDATE'
+/** Uniform Context:Enrichments:Delete */
+ | 'ENRICHMENTS_DELETE'
+/** Uniform Context:Intents & Audiences:Create */
+ | 'INTENTS_CREATE'
+/** Uniform Context:Intents & Audiences:Update */
+ | 'INTENTS_UPDATE'
+/** Uniform Context:Intents & Audiences:Delete */
+ | 'INTENTS_DELETE'
+/** Uniform Context:Quirks:Create */
+ | 'QUIRKS_CREATE'
+/** Uniform Context:Quirks:Update| */
+ | 'QUIRKS_UPDATE'
+/** Uniform Context:Quirks:Delete */
+ | 'QUIRKS_DELETE'
+/** Uniform Context:Signals:Create */
+ | 'SIGNALS_CREATE'
+/** Uniform Context:Signals:Update */
+ | 'SIGNALS_UPDATE'
+/** Uniform Context:Signals:Delete */
+ | 'SIGNALS_DELETE'
+/** Uniform Context:Tests:Create */
+ | 'TESTS_CREATE'
+/** Uniform Context:Tests:Update|Declare winners and close existing tests. */
+ | 'TESTS_UPDATE'
+/** Uniform Context:Tests:Delete */
+ | 'TESTS_DELETE'
+/** Uniform Context:Manifest:Read|Read the published manifest */
+ | 'MANIFEST_READ'
+/** Uniform Context:Manifest:Publish|Publish the manifest */
+ | 'MANIFEST_PUBLISH'
+/** Uniform Context:Read Drafts|Read all drafts and preview manifest */
+ | 'MANIFEST_READ_DRAFT'
+/** Uniform Canvas:Project Map:Manage|Create, update, and delete Project Maps and nodes in Project Map trees. */
+ | 'PROJECT_MAP_MANAGE'
+/** General:Read Project|See the project in the team dashboard. */
+ | 'PROJECT_READ'
+/** Uniform Canvas:Redirects:Advanced|Grants access to advanced redirect features and options. */
+ | 'REDIRECTS_ADVANCED'
+/** Uniform Canvas:Redirects:Create */
+ | 'REDIRECTS_CREATE'
+/** Uniform Canvas:Redirects:Update */
+ | 'REDIRECTS_UPDATE'
+/** Uniform Canvas:Redirects:Delete */
+ | 'REDIRECTS_DELETE'
+/** Uniform Canvas:Data Sources:Manage|Create, update, and delete data sources. */
+ | 'DATA_SOURCES_MANAGE'
+/** Uniform Canvas:Data Types:Manage|Create, update, and delete data types. */
+ | 'DATA_TYPES_MANAGE'
+/** Uniform Canvas:Compositions:Create */
+ | 'COMPOSITIONS_CREATE'
+/** Uniform Canvas:Compositions:Update */
+ | 'COMPOSITIONS_WRITE'
+/** Uniform Canvas:Compositions:Delete */
+ | 'COMPOSITIONS_DELETE'
+/** Uniform Canvas:Compositions:Read Published */
+ | 'COMPOSITIONS_READ'
+/** Uniform Canvas:Compositions:Publish */
+ | 'COMPOSITIONS_PUBLISH'
+/** Uniform Canvas::Read|Includes read access to all canvas assets */
+ | 'COMPOSITIONS_READ_DRAFT'
+/** Uniform Canvas:Component Library:Manage|Create, update, and delete component library data */
+ | 'COMPOSITIONS_MANAGE_SCHEMA'
+/** UTM Mapper:Read|Read UTM mapper configuration */
+ | 'UTM_MAPPER_READ'
+/** Uniform Canvas:Releases:Launch|Launch a release */
+ | 'RELEASES_LAUNCH'
+/** Uniform Canvas:Releases:Create */
+ | 'RELEASES_CREATE'
+/** Uniform Canvas:Releases:Delete */
+ | 'RELEASES_DELETE'
+/** Uniform Canvas:Releases:Update */
+ | 'RELEASES_UPDATE';
 /**
  * Known location types that can be passed to a mesh location
  */
-type MeshLocationTypes = 'paramType' | 'paramTypeConfig' | 'settings' | 'dataSource' | 'dataType' | 'dataResource' | 'unstable_ai';
+type MeshLocationTypes = 'paramType' | 'paramTypeConfig' | 'assetLibrary' | 'assetParameter' | 'settings' | 'dataSource' | 'dataType' | 'dataResource' | 'aiGenerate' | 'aiMetadata';
 type SetValueOptions = ValidationResult;
 type SetValueMessage = {
     uniformMeshLocationValue: unknown;
@@ -945,23 +1308,23 @@ type DynamicInput = {
 /** Record of dynamic inputs keyed by the input name */
 type DynamicInputs = Record<string, DynamicInput>;
 
-type AIGenerateLocationMetadata<TIntegrationConfiguration = unknown> = {
-    /** Settings defined at the integration level (arbitrary type used on settings location) */
-    settings: TIntegrationConfiguration;
-    /** The Uniform project ID */
-    projectId: string;
+type AIGenerateLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     prompt: string;
     promptMetadata: Record<string, unknown>;
-};
-type AIGenerateLocation<TType> = MeshLocationCore<TType, AIGenerateLocationMetadata, TType, 'unstable_ai'>;
+    /** Useful to differentiate AI Generate UI between text and image */
+    promptOutputType: 'text' | 'image' | 'json';
+}, TIntegrationConfiguration>;
+type PromptSettingsLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** Useful to differentiate metadata settings between text and image generation */
+    promptOutputType: 'text' | 'image' | 'json';
+}, TIntegrationConfiguration>;
+type AIGenerateLocation<TType> = MeshLocationCore<TType, AIGenerateLocationMetadata, TType, 'aiGenerate'>;
+type AIPromptMetadataLocation = MeshLocationCore<Record<string, unknown>, PromptSettingsLocationMetadata, Record<string, unknown>, 'aiMetadata'>;
 
-type ParamTypeConfigLocationMetadata<TIntegrationConfiguration = unknown> = {
-    /** Settings defined at the integration level (arbitrary type used on settings location) */
-    settings: TIntegrationConfiguration;
+type ParamTypeConfigLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     /** The Uniform project ID */
-    projectId: string;
     componentDefinition: ComponentDefinition;
-};
+}, TIntegrationConfiguration>;
 type ParamTypeConfigLocation<TParamValue = unknown, TIntegrationConfiguration = unknown> = MeshLocationCore<TParamValue | undefined, ParamTypeConfigLocationMetadata<TIntegrationConfiguration>, TParamValue, 'paramTypeConfig'>;
 
 interface SdkWindow {
@@ -1061,4 +1424,10 @@ declare function initializeUniformMeshSDK({ autoResizingDisabled, }?: {
     autoResizingDisabled?: boolean;
 }): Promise<UniformMeshSDK | undefined>;
 
-export { AIGenerateLocation, AIGenerateLocationMetadata, BindableTypes, CSSHeight, CloseDialogMessage, CloseLocationDialogOptions, DataConnectorInfo, DataResourceLocation, DataResourceLocationMetadata, DataSourceLocation, DataSourceLocationMetadata, DataSourceLocationValue, DataTypeLocation, DataTypeLocationMetadata, DataTypeLocationValue, DialogContext, DialogOptions, DialogParamValue, DialogParams, DialogResponseData, DialogResponseHandler, DialogResponseHandlers, DialogType, DynamicInput, DynamicInputs, EditConnectedDataMessage, EditConnectedDataResponse, EditConnectedDataResponseCancellationContext, GetDataResourceLocation, GetDataResourceMessage, IntegrationDefinitionClient, IntegrationDefinitionDeleteParameters, IntegrationDefinitionGetParameters, IntegrationDefinitionGetResponse, IntegrationDefinitionPutParameters, IntegrationDefinitionPutResponse, IntegrationInstallationClient, IntegrationInstallationDeleteParameters, IntegrationInstallationGetParameters, IntegrationInstallationGetResponse, IntegrationInstallationPutParameters, LocationDialogResponse, MeshContextData, MeshLocation, MeshLocationCore, MeshLocationTypes, MeshSDKEventInterface, OpenConfirmationDialogOptions, OpenConfirmationDialogResult, OpenDialogMessage, OpenDialogResult, OpenLocationDialogOptions, ParamTypeConfigLocation, ParamTypeConfigLocationMetadata, ParamTypeLocation, ParamTypeLocationMetadata, SdkWindow, SetLocationFunction, SetValueMessage, SetValueOptions, SettingsLocation, SettingsLocationMetadata, UniformMeshSDK, UniformMeshSDKEvents, ValidationResult, initializeUniformMeshSDK };
+declare const hasPermissions: (permissions: MeshLocationUserPermissions | MeshLocationUserPermissions[], user: UniformUser) => boolean;
+/**
+ * Check if user has a role by both name and id
+ */
+declare const hasRole: (role: string, user: UniformUser) => boolean;
+
+export { type AIGenerateLocation, type AIGenerateLocationMetadata, type AIPromptMetadataLocation, type AssetLibraryLocation, type AssetLibraryLocationMetadata, type AssetParameterLocation, type AssetParameterLocationMetadata, type BindableTypes, type CSSHeight, type CloseDialogMessage, type CloseLocationDialogOptions, type CommonMetadata, type DataConnectorInfo, type DataResourceLocation, type DataResourceLocationMetadata, type DataSourceLocation, type DataSourceLocationMetadata, type DataSourceLocationValue, type DataTypeLocation, type DataTypeLocationMetadata, type DataTypeLocationValue, type DialogContext, type DialogOptions, type DialogParamValue, type DialogParams, type DialogResponseData, type DialogResponseHandler, type DialogResponseHandlers, type DialogType, type DynamicInput, type DynamicInputs, type EditConnectedDataMessage, type EditConnectedDataResponse, type EditConnectedDataResponseCancellationContext, type GetDataResourceLocation, type GetDataResourceMessage, IntegrationDefinitionClient, type IntegrationDefinitionDeleteParameters, type IntegrationDefinitionGetParameters, type IntegrationDefinitionGetResponse, type IntegrationDefinitionPutParameters, type IntegrationDefinitionPutResponse, IntegrationInstallationClient, type IntegrationInstallationDeleteParameters, type IntegrationInstallationGetParameters, type IntegrationInstallationGetResponse, type IntegrationInstallationPutParameters, type LocationDialogResponse, type MeshContextData, type MeshLocation, type MeshLocationCore, type MeshLocationTypes, type MeshLocationUserPermissions, type MeshSDKEventInterface, type OpenConfirmationDialogOptions, type OpenConfirmationDialogResult, type OpenDialogMessage, type OpenDialogResult, type OpenLocationDialogOptions, type ParamTypeConfigLocation, type ParamTypeConfigLocationMetadata, type ParamTypeLocation, type ParamTypeLocationMetadata, type PromptSettingsLocationMetadata, type SdkWindow, type SetLocationFunction, type SetValueMessage, type SetValueOptions, type SettingsLocation, type SettingsLocationMetadata, type UniformMeshSDK, type UniformMeshSDKEvents, type UniformUser, type ValidationResult, hasPermissions, hasRole, initializeUniformMeshSDK };