@iobroker/dm-utils 0.2.1 → 0.3.0

package/README.md

@@ -6,7 +6,8 @@ Utility classes for ioBroker adapters to support [ioBroker.device-manager](https
 
 Add in your `io-package.json` the property `deviceManager: true` to `common.supportedMessages`.
 Note: If you don't have a `common.supportedMessages` property yet, you have to add it.
-Also, if you don't have a `common.messagebox: true` property yet, you have to add it.
+Also, if you don't have a `common.supportedMessages.messagebox: true` property yet, you have to add it. If common.messagebox exists, you can remove it. (see 
+https://github.com/ioBroker/ioBroker.js-controller/blob/274f9e8f84dbdaaba9830a6cc00ddf083e989090/schemas/io-package.json#L754C104-L754C178)
 
 In your ioBroker adapter, add a subclass of `DeviceManagement` and override the methods you need (see next chapters):
 
@@ -294,7 +295,11 @@ This method returns a promise that resolves to a `ProgressDialog` object.
 	### **WORK IN PROGRESS**
 -->
 ## Changelog
-### 0.2.1 (2024-06-26)
+### 0.3.0 (2024-07-17)
+* (bluefox) packages updated
+* (bluefox) Updated JSON config types
+
+### 0.2.2 (2024-06-26)
 * (bluefox) packages updated
 
 ### 0.2.0 (2024-05-29)

package/build/types/base.d.ts

@@ -8,15 +8,15 @@ export interface ActionBase<T extends ActionType> {
     /**
      * This can either be base64 or the URL to an icon.
      */
-    icon?: string;
+    icon?: "edit" | "rename" | "delete" | "refresh" | "newDevice" | "new" | "add" | "discover" | "search" | "unpairDevice" | "pairDevice" | "identify" | "play" | "stop" | "pause" | "forward" | "next" | "rewind" | "previous" | "lamp" | "light" | "backlight" | "dimmer" | "socket" | "settings" | "users" | "group" | "user" | string;
     description?: ioBroker.StringOrTranslated;
     disabled?: T extends "api" ? boolean : never;
     color?: Color;
     backgroundColor?: Color;
     /** If true, the user will be asked for confirmation before executing the action */
-    confirmation: boolean | ioBroker.StringOrTranslated;
+    confirmation?: boolean | ioBroker.StringOrTranslated;
     /** If defined, before the action is triggered, the non-empty text or number or checkbox will be asked */
-    inputBefore: {
+    inputBefore?: {
         /** This label will be shown for the text input */
         label: ioBroker.StringOrTranslated;
         /** This type of input will be shown. Default is type */

package/build/types/common.d.ts

@@ -20,7 +20,18 @@ export type ErrorResponse = {
     };
 };
 export type RetVal<T> = T | Promise<T>;
-export type ConfigItemType = 'tabs' | 'panel' | 'text' | 'number' | 'color' | 'checkbox' | 'slider' | 'ip' | 'user' | 'room' | 'func' | 'select' | 'autocomplete' | 'image' | 'objectId' | 'password' | 'instance' | 'chips' | 'alive' | 'pattern' | 'sendto' | 'setState' | 'staticText' | 'staticLink' | 'staticImage' | 'table' | 'accordion' | 'jsonEditor' | 'language' | 'certificate' | 'certificates' | 'certCollection' | 'custom' | 'datePicker' | 'timePicker' | 'divider' | 'header' | 'cron' | 'fileSelector' | 'file' | 'imageSendTo' | 'selectSendTo' | 'autocompleteSendTo' | 'textSendTo' | 'coordinates' | 'interface' | 'license' | 'checkLicense' | 'uuid' | 'port' | 'deviceManager';
+type CustomCSSProperties = Record<string, any>;
+interface ObjectBrowserCustomFilter {
+    type?: ioBroker.ObjectType | ioBroker.ObjectType[];
+    common?: {
+        type?: ioBroker.CommonType | ioBroker.CommonType[];
+        role?: string | string[];
+        custom?: '_' | '_dataSources' | true | string | string[];
+    };
+}
+export type ObjectBrowserType = 'state' | 'instance' | 'channel' | 'device' | 'chart';
+export type ConfigItemType = 'tabs' | 'panel' | 'text' | 'number' | 'color' | 'checkbox' | 'slider' | 'ip' | 'user' | 'room' | 'func' | 'select' | 'autocomplete' | 'image' | 'objectId' | 'password' | 'instance' | 'chips' | 'alive' | 'pattern' | 'sendto' | 'setState' | 'staticText' | 'staticLink' | 'staticImage' | 'table' | 'accordion' | 'jsonEditor' | 'language' | 'certificate' | 'certificates' | 'certCollection' | 'custom' | 'datePicker' | 'timePicker' | 'divider' | 'header' | 'cron' | 'fileSelector' | 'file' | 'imageSendTo' | 'selectSendTo' | 'autocompleteSendTo' | 'textSendTo' | 'coordinates' | 'interface' | 'license' | 'checkLicense' | 'uuid' | 'port' | 'deviceManager' | 'topic';
+type ConfigIconType = 'auth' | 'send' | 'web' | 'warning' | 'error' | 'info' | 'search' | 'book' | 'help' | 'upload' | 'user' | 'group' | string;
 export interface ConfigItemConfirmData {
     condition: string;
     text?: ioBroker.StringOrTranslated;
@@ -30,7 +41,6 @@ export interface ConfigItemConfirmData {
     type?: 'info' | 'warning' | 'error' | 'none';
     alsoDependsOn?: string[];
 }
-type CustomCSSProperties = Record<string, any>;
 export interface ConfigItem {
     type: ConfigItemType;
     sm?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
@@ -70,7 +80,7 @@ export interface ConfigItem {
     doNotSave?: boolean;
     noMultiEdit?: boolean;
     confirm?: ConfigItemConfirmData;
-    icon?: 'auth' | 'send' | 'web' | 'warning' | 'error' | 'info' | 'search' | 'book' | 'help' | 'upload' | string;
+    icon?: ConfigIconType;
     width?: string | number;
     confirmDependsOn?: ConfigItemIndexed[];
     onChangeDependsOn?: ConfigItemIndexed[];
@@ -81,15 +91,520 @@ export interface ConfigItem {
 interface ConfigItemIndexed extends ConfigItem {
     attr?: string;
 }
+interface ConfigItemTableIndexed extends ConfigItem {
+    attr?: string;
+    /** show filter options in the header of table */
+    filter?: boolean;
+    /** show sorting options in the header of table */
+    sort?: boolean;
+    /** tooltip in the header of table */
+    title?: string;
+}
+export interface ConfigItemAlive extends ConfigItem {
+    type: 'alive';
+    instance?: string;
+    textAlive?: string;
+    textNotAlive?: string;
+}
+export interface ConfigItemSelectOption {
+    label: ioBroker.StringOrTranslated;
+    value: number | string;
+    hidden?: string | boolean;
+}
 export interface ConfigItemPanel extends ConfigItem {
     type: 'panel' | never;
     label?: ioBroker.StringOrTranslated;
-    items: Record<string, ConfigItem>;
+    items: Record<string, ConfigItemAny>;
     collapsable?: boolean;
     color?: 'primary' | 'secondary';
     innerStyle?: CustomCSSProperties;
     i18n?: boolean | string | Record<string, Record<ioBroker.Languages, string>>;
 }
+export interface ConfigItemPattern extends ConfigItem {
+    type: 'pattern';
+    copyToClipboard?: boolean;
+    pattern: string;
+}
+export interface ConfigItemChip extends ConfigItem {
+    type: 'chips';
+    delimiter?: string;
+    pattern: string;
+}
+export interface ConfigItemTabs extends ConfigItem {
+    type: 'tabs';
+    items: Record<string, ConfigItemPanel>;
+    iconPosition?: 'bottom' | 'end' | 'start' | 'top';
+    tabsStyle?: CustomCSSProperties;
+    i18n?: boolean | string | Record<string, Record<ioBroker.Languages, string>>;
+}
+export interface ConfigItemText extends ConfigItem {
+    type: 'text';
+    maxLength?: number;
+    /** @deprecated use maxLength */
+    max?: number;
+    readOnly?: boolean;
+    trim?: boolean;
+    minRows?: number;
+    maxRows?: number;
+    noClearButton?: boolean;
+}
+export interface ConfigItemColor extends ConfigItem {
+    type: 'color';
+    noClearButton?: boolean;
+}
+export interface ConfigItemCheckbox extends ConfigItem {
+    type: 'checkbox';
+}
+export interface ConfigItemNumber extends ConfigItem {
+    type: 'number';
+    min?: number;
+    max?: number;
+    step?: number;
+    readOnly?: boolean;
+}
+export interface ConfigItemPassword extends ConfigItem {
+    type: 'password';
+    /** repeat password must be compared with password */
+    repeat?: boolean;
+    /** true if allow viewing the password by toggling the view button (only for a new password while entering) */
+    visible?: boolean;
+    /** max length of the text in field */
+    maxLength?: number;
+    /** @deprecated use maxLength */
+    max?: number;
+}
+export interface ConfigItemObjectId extends ConfigItem {
+    type: 'objectId';
+    /** Desired type: `channel`, `device`, ... (has only `state` by default). It is plural, because `type` is already occupied. */
+    types?: ObjectBrowserType | ObjectBrowserType[];
+    /** Show only this root object and its children */
+    root?: string;
+    /** Cannot be used together with `type` settings. It is an object and not a JSON string. Examples
+     *  - `{common: {custom: true}}` - show only objects with some custom settings
+     *  - `{common: {custom: 'sql.0'}}` - show only objects with sql.0 custom settings (only of the specific instance)
+     *  - `{common: {custom: '_dataSources'}}` - show only objects of adapters `influxdb` or `sql` or `history`
+     *  - `{common: {custom: 'adapterName.'}}` - show only objects of custom settings of specific adapter (all instances)
+     *  - `{type: 'channel'}` - show only channels
+     *  - `{type: ['channel', 'device']}` - show only channels and devices
+     *  - `{common: {type: 'number'}` - show only states of type 'number
+     *  - `{common: {type: ['number', 'string']}` - show only states of type 'number and string
+     *  - `{common: {role: 'switch'}` - show only states with roles starting from switch
+     *  - `{common: {role: ['switch', 'button']}` - show only states with roles starting from `switch` and `button`
+     */
+    customFilter?: ObjectBrowserCustomFilter;
+    /** some predefined search filters */
+    filters?: {
+        id?: string;
+        name?: string;
+        room?: string;
+        func?: string;
+        role?: string;
+        type?: string;
+        custom?: string;
+    };
+    /** Cannot be used together with `type` settings. It is a function that will be called for every object and must return true or false. Example: `obj.common.type === 'number'` */
+    filterFunc?: (obj: ioBroker.Object) => boolean;
+}
+export interface ConfigItemSlider extends ConfigItem {
+    type: 'slider';
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Unit of slider */
+    unit?: string;
+}
+export interface ConfigItemTopic extends ConfigItem {
+    type: 'topic';
+    maxLength?: number;
+    /** @deprecated use maxLength */
+    max?: number;
+}
+export interface ConfigItemIP extends ConfigItem {
+    type: 'ip';
+    listenOnAllPorts?: boolean;
+    onlyIp4?: boolean;
+    onlyIp6?: boolean;
+    noInternal?: boolean;
+}
+export interface ConfigItemUser extends ConfigItem {
+    type: 'user';
+    /** without "system.user." */
+    short?: boolean;
+}
+export interface ConfigItemStaticDivider extends ConfigItem {
+    type: 'divider';
+    color?: 'primary' | 'secondary' | string;
+    height?: string | number;
+}
+export interface ConfigItemStaticHeader extends ConfigItem {
+    type: 'header';
+    size?: 1 | 2 | 3 | 4 | 5;
+    text: ioBroker.StringOrTranslated;
+    noTranslation?: boolean;
+}
+export interface ConfigItemStaticImage extends ConfigItem {
+    type: 'staticImage';
+    /** name of picture (from admin directory) */
+    src: string;
+    /** optional HTTP link */
+    href?: string;
+}
+export interface ConfigItemStaticText extends Omit<ConfigItem, 'button'> {
+    type: 'staticText';
+    /** multi-language text */
+    text: string;
+    /** @deprecated use text */
+    label?: ioBroker.StringOrTranslated;
+    /** link. Link could be dynamic like `#tab-objects/customs/${data.parentId} */
+    href?: string;
+    /** show a link as button */
+    button?: boolean;
+    /** type of button (`outlined`, `contained`, `text`) */
+    variant?: 'contained' | 'outlined' | 'text';
+    /** color of button (e.g. `primary`) */
+    color?: 'primary' | 'secondary' | 'grey';
+    /** if icon should be shown: `auth`, `send`, `web`, `warning`, `error`, `info`, `search`, `book`, `help`, `upload`. You can use `base64` icons (it starts with `data:image/svg+xml;base64,...`) or `jpg/png` images (ends with `.png`) . (Request via issue if you need more icons) */
+    icon?: ConfigIconType;
+}
+export interface ConfigItemRoom extends ConfigItem {
+    type: 'room';
+    short?: boolean;
+    allowDeactivate?: boolean;
+}
+export interface ConfigItemFunc extends ConfigItem {
+    type: 'func';
+    short?: boolean;
+    allowDeactivate?: boolean;
+}
+export interface ConfigItemSelect extends ConfigItem {
+    type: 'select';
+    /** `[{label: {en: "option 1"}, value: 1}, ...]` or
+     `[{"items": [{"label": "Val1", "value": 1}, {"label": "Val2", value: "2}], "name": "group1"}, {"items": [{"label": "Val3", "value": 3}, {"label": "Val4", value: "4}], "name": "group2"}, {"label": "Val5", "value": 5}]`
+    */
+    options: (ConfigItemSelectOption | {
+        items: ConfigItemSelectOption[];
+        label: ioBroker.StringOrTranslated;
+        value?: number | string;
+        hidden?: string | boolean;
+    })[];
+    attr?: string;
+}
+export interface ConfigItemAutocomplete extends ConfigItem {
+    type: 'autocomplete';
+    options: (string | ConfigItemSelectOption)[];
+    freeSolo?: boolean;
+}
+export interface ConfigItemSetState extends ConfigItem {
+    type: 'setState';
+    /** `system.adapter.myAdapter.%INSTANCE%.test`, you can use the placeholder `%INSTANCE%` to replace it with the current instance name */
+    id: string;
+    /** false (default false) */
+    ack?: boolean;
+    /** '${data.myText}_test' or number. Type will be detected automatically from the state type and converting done too */
+    val: ioBroker.StateValue;
+    /** Alert which will be shown by pressing the button */
+    okText?: ioBroker.StringOrTranslated;
+    variant?: 'contained' | 'outlined';
+    color?: 'primary' | 'secondary' | 'grey';
+    /** Error translations */
+    error?: {
+        [error: string]: ioBroker.StringOrTranslated;
+    };
+}
+export interface ConfigItemAutocompleteSendTo extends Omit<ConfigItem, 'data'> {
+    type: 'autocompleteSendTo';
+    command?: string;
+    jsonData?: string;
+    options?: (string | ConfigItemSelectOption)[];
+    data?: Record<string, any>;
+    freeSolo?: boolean;
+    maxLength?: number;
+    /** @deprecated use maxLength */
+    max?: string;
+    alsoDependsOn?: string[];
+}
+export interface ConfigItemAccordion extends ConfigItem {
+    type: 'accordion';
+    titleAttr?: string;
+    noDelete?: boolean;
+    clone?: boolean | string;
+    items: ConfigItemIndexed[];
+}
+export interface ConfigItemDivider extends ConfigItem {
+    type: 'divider';
+    color?: 'primary' | 'secondary' | string;
+    height?: string | number;
+}
+export interface ConfigItemHeader extends ConfigItem {
+    type: 'header';
+    text?: ioBroker.StringOrTranslated;
+    size?: 1 | 2 | 3 | 4 | 5 | 6;
+}
+export interface ConfigItemCoordinates extends ConfigItem {
+    type: 'coordinates';
+    divider?: string;
+    autoInit?: boolean;
+    longitudeName?: string;
+    latitudeName?: string;
+    useSystemName?: string;
+    maxLength?: number;
+    max?: number;
+}
+export interface ConfigItemCustom extends ConfigItem {
+    type: 'custom';
+    /** location of Widget, like "custom/customComponents.js" */
+    url: string;
+    /** Component name, like "ConfigCustomBackItUpSet/Components/AdapterExist" */
+    name: string;
+    /** i18n */
+    i18n: boolean | Record<string, string>;
+    /** custom properties */
+    [prop: string]: any;
+}
+export interface ConfigItemDatePicker extends ConfigItem {
+    type: 'datePicker';
+    maxLength?: number;
+    /** @deprecated use maxLength */
+    max?: number;
+}
+export interface ConfigItemDeviceManager extends ConfigItem {
+    type: 'deviceManager';
+}
+export interface ConfigItemLanguage extends ConfigItem {
+    type: 'language';
+    system?: boolean;
+    changeGuiLanguage?: boolean;
+}
+export interface ConfigItemPort extends ConfigItem {
+    type: 'port';
+    min?: number;
+    max?: number;
+    readOnly?: boolean;
+}
+export interface ConfigItemImageSendTo extends Omit<ConfigItem, 'data'> {
+    type: 'imageSendTo';
+    command?: string;
+    alsoDependsOn?: string[];
+    height?: number | string;
+    data?: Record<string, any>;
+}
+export interface ConfigItemSendTo extends Omit<ConfigItem, 'data'> {
+    type: 'sendto';
+    command?: string;
+    jsonData?: string;
+    data?: Record<string, any>;
+    result?: string;
+    error?: string;
+    variant?: 'contained' | 'outlined';
+    openUrl?: boolean;
+    reloadBrowser?: boolean;
+    window?: string;
+    icon?: ConfigIconType;
+    useNative?: boolean;
+    showProcess?: boolean;
+    timeout?: number;
+    onLoaded?: boolean;
+    color?: 'primary' | 'secondary';
+    /** button tooltip */
+    title?: ioBroker.StringOrTranslated;
+    alsoDependsOn?: string[];
+    container?: 'text' | 'div';
+    copyToClipboard?: boolean;
+}
+export interface ConfigItemTextSendTo extends Omit<ConfigItem, 'data'> {
+    type: 'textSendTo';
+    container?: 'text' | 'div';
+    copyToClipboard?: boolean;
+    alsoDependsOn?: string[];
+    command?: string;
+    jsonData?: string;
+    data?: Record<string, any>;
+}
+export interface ConfigItemSelectSendTo extends Omit<ConfigItem, 'data'> {
+    type: 'selectSendTo';
+    manual?: boolean;
+    multiple?: boolean;
+    showAllValues?: boolean;
+    noClearButton?: boolean;
+    command?: string;
+    jsonData?: string;
+    data?: Record<string, any>;
+    alsoDependsOn?: string[];
+}
+export interface ConfigItemTable extends ConfigItem {
+    type: 'table';
+    items?: ConfigItemTableIndexed[];
+    noDelete?: boolean;
+    /** @deprecated don't use */
+    objKeyName?: string;
+    /** @deprecated don't use */
+    objValueName?: string;
+    allowAddByFilter?: boolean;
+    showSecondAddAt?: number;
+    showFirstAddOnTop?: boolean;
+    clone?: boolean | string;
+    export?: boolean;
+    import?: boolean;
+    uniqueColumns?: string[];
+    encryptedAttributes?: string[];
+}
+export interface ConfigItemTimePicker extends ConfigItem {
+    type: 'timePicker';
+    /** format passed to the date picker defaults to `HH:mm:ss` */
+    format?: string;
+    views?: ('hours' | 'minutes' | 'seconds')[];
+    /** Represent the available time steps for each view. Defaults to `{ hours: 1, minutes: 5, seconds: 5 }` */
+    timeSteps?: {
+        hours?: number;
+        minutes?: number;
+        seconds?: number;
+    };
+    /** @deprecated use timeSteps */
+    timesteps?: {
+        hours?: number;
+        minutes?: number;
+        seconds?: number;
+    };
+    /**  `fullDate` or `HH:mm:ss`. Defaults to full date for backward compatibility reasons */
+    returnFormat?: string;
+}
+export interface ConfigItemCertCollection extends ConfigItem {
+    type: 'certCollection';
+    leCollectionName?: string;
+}
+export interface ConfigItemCRON extends ConfigItem {
+    type: 'cron';
+    /** show CRON with "minutes", "seconds" and so on */
+    complex?: boolean;
+    /** show simple CRON settings */
+    simple?: boolean;
+}
+export interface ConfigItemCertificateSelect extends ConfigItem {
+    type: 'certificate';
+}
+export interface ConfigItemLicense extends ConfigItem {
+    type: 'license';
+    /** array of paragraphs with texts, which will be shown each as a separate paragraph */
+    texts?: string[];
+    /** URL to the license file (e.g. https://raw.githubusercontent.com/ioBroker/ioBroker.docs/master/LICENSE) */
+    licenseUrl?: string;
+    /** Title of the license dialog */
+    title?: string;
+    /** Text of the agreed button */
+    agreeText?: string;
+    /** If defined, the checkbox with the given name will be shown. If checked, the agreed button will be enabled. */
+    checkBox?: string;
+}
+export interface ConfigItemCertificates extends ConfigItem {
+    type: 'certificates';
+    leCollectionName?: string;
+    certPublicName?: string;
+    certPrivateName?: string;
+    certChainedName?: string;
+}
+export interface ConfigItemCheckLicense extends ConfigItem {
+    type: 'checkLicense';
+    /** Check UUID */
+    uuid?: boolean;
+    /** Check version */
+    version?: boolean;
+    variant?: 'text' | 'outlined' | 'contained';
+    color?: 'primary' | 'secondary';
+}
+export interface ConfigItemUUID extends ConfigItem {
+    type: 'uuid';
+}
+export interface ConfigItemJsonEditor extends ConfigItem {
+    type: 'jsonEditor';
+}
+export interface ConfigItemInterface extends ConfigItem {
+    type: 'interface';
+    /** do not show loopback interface (127.0.0.1) */
+    ignoreLoopback?: boolean;
+    /** do not show internal interfaces (normally it is 127.0.0.1 too) */
+    ignoreInternal?: boolean;
+}
+export interface ConfigItemImageUpload extends ConfigItem {
+    type: 'image';
+    /** name of file is structure name. In the below example `login-bg.png` is file name for `writeFile("myAdapter.INSTANCE", "login-bg.png")` */
+    filename?: string;
+    /** html accept attribute, like `{ 'image/**': [], 'application/pdf': ['.pdf'] }`, default `{ 'image/*': [] }` */
+    accept?: Record<string, string[]>;
+    /** maximal size of file to upload */
+    maxSize?: number;
+    /** if true, the image will be saved as data-url in attribute, elsewise as binary in file storage */
+    base64?: boolean;
+    /** if true, allow user to crop the image */
+    crop?: boolean;
+}
+export interface ConfigItemInstanceSelect extends ConfigItem {
+    type: 'instance';
+    /** name of adapter. With special name `_dataSources` you can get all adapters with flag `common.getHistory`. */
+    adapter?: string;
+    /** optional list of adapters, that should be shown. If not defined, all adapters will be shown. Only active if `adapter` attribute is not defined. */
+    adapters?: string[];
+    /** if true. Additional option "deactivate" is shown */
+    allowDeactivate?: boolean;
+    /** if true. Only enabled instances will be shown */
+    onlyEnabled?: boolean;
+    /** value will look like `system.adapter.ADAPTER.0` and not `ADAPTER.0` */
+    long?: boolean;
+    /** value will look like `0` and not `ADAPTER.0` */
+    short?: boolean;
+    /** Add to the options "all" option with value `*` */
+    all?: boolean;
+}
+export interface ConfigItemFile extends ConfigItem {
+    type: 'file';
+    /** if a user can manually enter the file name and not only through select dialog */
+    disableEdit?: boolean;
+    /** limit selection to one specific object of type `meta` and the following path (not mandatory) */
+    limitPath?: string;
+    /** like `['png', 'svg', 'bmp', 'jpg', 'jpeg', 'gif']` */
+    filterFiles?: string[];
+    /** allowed upload of files */
+    allowUpload?: boolean;
+    /** allowed download of files (default true) */
+    allowDownload?: boolean;
+    /** allowed creation of folders */
+    allowCreateFolder?: boolean;
+    /** allowed tile view (default true) */
+    allowView?: boolean;
+    /** show toolbar (default true) */
+    showToolbar?: boolean;
+    /** user can select only folders (e.g., for uploading path) */
+    selectOnlyFolders?: boolean;
+    /** trim the filename */
+    trim?: boolean;
+    /** max length of the file name */
+    maxLength?: number;
+    /** @deprecated use maxLength */
+    max?: number;
+}
+export interface ConfigItemFileSelector extends ConfigItem {
+    type: 'fileSelector';
+    /** File extension pattern. Allowed `**\/*.ext` to show all files from subfolders too, `*.ext` to show from root folder or `folderName\/*.ext` to show all files in sub-folder `folderName`. Default `**\/*.*`. */
+    pattern: string;
+    /** type of files: `audio`, `image`, `text` */
+    fileTypes?: 'audio' | 'image' | 'text';
+    /** Object ID of type `meta`. You can use special placeholder `%INSTANCE%`: like `myAdapter.%INSTANCE%.files` */
+    objectID?: string;
+    /** path, where the uploaded files will be stored. Like `folderName`. If not defined, no upload field will be shown. To upload in the root, set this field to `/`. */
+    upload?: string;
+    /** Show refresh button near the select. */
+    refresh?: boolean;
+    /** max file size (default 2MB) */
+    maxSize?: number;
+    /** show folder name even if all files in the same folder */
+    withFolder?: boolean;
+    /** Allow deletion of files */
+    delete?: boolean;
+    /** Do not show `none` option */
+    noNone?: boolean;
+    /** Do not show the size of files */
+    noSize?: boolean;
+}
+export type ConfigItemAny = ConfigItemAlive | ConfigItemAutocomplete | ConfigItemAutocompleteSendTo | ConfigItemPanel | ConfigItemTabs | ConfigItemText | ConfigItemNumber | ConfigItemColor | ConfigItemCheckbox | ConfigItemSlider | ConfigItemIP | ConfigItemUser | ConfigItemRoom | ConfigItemFunc | ConfigItemSelect | ConfigItemAccordion | ConfigItemCoordinates | ConfigItemDivider | ConfigItemHeader | ConfigItemCustom | ConfigItemDatePicker | ConfigItemDeviceManager | ConfigItemLanguage | ConfigItemPort | ConfigItemSendTo | ConfigItemTable | ConfigItemTimePicker | ConfigItemTextSendTo | ConfigItemSelectSendTo | ConfigItemCertCollection | ConfigItemCertificateSelect | ConfigItemCertificates | ConfigItemUUID | ConfigItemCheckLicense | ConfigItemPattern | ConfigItemChip | ConfigItemCRON | ConfigItemFile | ConfigItemFileSelector | ConfigItemImageSendTo | ConfigItemInstanceSelect | ConfigItemImageUpload | ConfigItemInterface | ConfigItemJsonEditor | ConfigItemLicense | ConfigItemPassword | ConfigItemSetState | ConfigItemStaticDivider | ConfigItemStaticHeader | ConfigItemStaticImage | ConfigItemStaticText | ConfigItemTopic | ConfigItemObjectId;
 export type JsonFormSchema = ConfigItemPanel;
 export type JsonFormData = Record<string, any>;
 export interface DeviceDetails {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iobroker/dm-utils",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "ioBroker Device Manager utilities for backend",
   "main": "build/index.js",
   "publishConfig": {
@@ -24,15 +24,15 @@
     "@iobroker/adapter-core": "^3.1.6"
   },
   "devDependencies": {
-    "@alcalzone/release-script": "^3.7.0",
+    "@alcalzone/release-script": "^3.7.3",
     "@alcalzone/release-script-plugin-license": "^3.7.0",
-    "@types/node": "^20.14.9",
-    "@typescript-eslint/eslint-plugin": "^7.14.1",
-    "@typescript-eslint/parser": "^7.14.1",
+    "@types/node": "^20.14.11",
+    "@typescript-eslint/eslint-plugin": "^7.16.1",
+    "@typescript-eslint/parser": "^7.16.1",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
-    "prettier": "^3.3.2",
-    "typescript": "^5.5.2"
+    "prettier": "^3.3.3",
+    "typescript": "^5.5.3"
   },
   "files": [
     "LICENSE",