type ReportsListItem = {
  _id: string, // report id
  Name: string, // report name
  IsCpl: boolean, // specifies whether report is RDL or FPL
  Type: 'PageReport', // RESERVED - for now only 'PageReport' is supported
  $effectivePermissions: 'All', // RESERVED - for now only 'All' is supported
}

type GetReportContentOptions {
  id: string, // report id
  version: null, // RESERVED - for now only null is supported
}

type GetReportRevisionsOptions {
id: string, // report id
}

type ReportRevision = {
_id: string, // report id
Name: string, // report name
IsCpl: boolean, // specifies whether report is RDL or FPL
Type: 'PageReport', // RESERVED - for now only 'PageReport' is supported
$effectivePermissions: 'All', // RESERVED - for now only 'All' is supported
}

type SaveNewReportOptions = {
  name: string, // report name
  content: object, // report JSON model
}

type SaveReportResponse = {
  Id: string, // saved report id
}

type SaveExistingReportOptions = {
  id: string, // report id
  content: object, // report JSON model
}

type SaveTemporaryReportOptions = {
  name: string, // report name
  content: object, // report JSON model
}

type DeleteTemporaryReportOptions = {
  id: string, // report id
}

type DeleteReportResponse = {
  Id: string, // deleted report id
}

type DataSetsListItem = {
  id: string, // data set id
  name: string, // data set name
  version: null, // RESERVED - for now only null is supported
}

type CanEditDataSourceOptions = {
    /** data source */
    dataSource: DataSource;
    /** data provider of data source */
    dataProvider: string;
};

type CanAddDataSetForDataSourceOptions = {
    /** data source */
    dataSource: DataSource;
    /** data provider of data source */
    dataProvider: string;
};

type CanEditDataSetOptions = {
    /** data set */
    dataSet: DataSet;
    /** data provider of data set's parent data source */
    dataProvider: string;
};

type InitDataSetForDataSourceOptions = {
    /** data source */
    dataSource: DataSource;
    /** data provider of data source */
    dataProvider: string;
    /** data set name to be initialized */
    dataSetName: string;
};

type GetDataSetPropertiesOptions = {
    /** data provider of data set's parent data source */
    dataProvider: string;
};

type DataSetProperty = 'name' | 'commandType' | 'query' | 'fields' | 'calculatedFields' | 'parameters' | 'filters'  | 'caseSensitivity' | 'collation' | 'kanatypeSensitivity' | 'widthSensitivity' | 'accentSensitivity';

type GetDataSetSchemaOptions = {
    /** data set */
    dataSet: DataSet;
    /** data set's parent data source */
    dataSource: DataSource;
};

type GetDataSetSchemaResponse = {
    /** data set fields */
    fields: Array<Field>;
    /** data set query parameters */
    parameters: Array<QueryParameter>;
};

type GetDataSourcesAndDataSetsOptions = {
  dataSetInfo: {
    id: string, // data set id
    name: string, // data set name
    version: null, // RESERVED - for now only null is supported
  },
  dataSourceInfo: object, // RESERVED
  reportDataSets: Array<DataSet>, // data sets used in report
  reportDataSources: Array<DataSource>, // data sources used in report
}

type GetDataSourcesAndDataSetsResponse = {
  dataSources: Array<DataSource>,
  dataSets: Array<DataSet>,
}

type GetDataSetContentOptions = {
  id: string, // data set id
}

type DataSource = {
  Name: string, // data source name
  ConnectionProperties: {
    ConnectString: string, // connection string
    DataProvider: string, // data provider - see AR Documentation
  },
  // ... more properties - see AR Documentation
}
type DataSet = {
  Name: string, // data set name
  Fields: Array<Field>, // data set fields
  Query: {
    DataSourceName: string, // parent data source name
    CommandType: 'Text' | 'StoredProcedure', // query command type
    CommandText: string, // query command text
    QueryParameters: Array<QueryParameter>,
  }
  // ... more properties - see AR Documentation
}
type Field = {
  Name: string, // field name
  // Either DataField or Value needs to be available.
  DataField?: string, // data field name - valid for bound fields
  Value?: string, // field value - valid for calculated fields
  /* Extra optional properties */
  // default field aggregate - see AR Documentation for more available aggregates
  Aggregate?: 'Count' | 'Sum' | 'Max' | 'Min' /* etc. */,
  // field data type
  DataType?: 'String' | 'Integer' | 'Float' | 'Number' | 'Boolean' | 'DateTime',
}
type QueryParameter = {
  Name: string, // query parameter name
  Value: string, // query parameter value
}

/* Optional: Add/Edit Data Sources using Data Source Editor */
var openDataSourceEditorImpl = function (options) {
        ARDataSourceEditor.open(makeOptions(options, {
                serverApi: {
                        testConnection: baseServerApi.testDataSourceConnection,
                },
        }));
};                        

export type CanEditDataSourceOptions = {
        /** data source */
        dataSource: DataSource;

        /** data provider of data source */
        dataProvider: string;
};

export type CanEditDataSetOptions = {
        /** data set */
        dataSet: DataSet;

        /** data provider of data set's parent data source */
        dataProvider: string;
};                  

export type InitDataSetForDataSourceOptions = {
/** data source */
dataSource: DataSource;

/** data provider of data source */
dataProvider: string;

/** data set name to be initialized */
dataSetName: string;
};    

export type GetDataSetPropertiesOptions = {
        /** data provider of data set's parent data source */
        dataProvider: string;
};

export type DataSetProperty = 'name' | 'commandType' | 'query' | 'fields' | 'calculatedFields' | 'parameters' | 'filters'
| 'caseSensitivity' | 'collation' | 'kanatypeSensitivity' | 'widthSensitivity' | 'accentSensitivity';

export type GetDataSetSchemaOptions = {
        /** data set */
        dataSet: DataSet;

        /** data set's parent data source */
        dataSource: DataSource;
};

export type GetDataSetSchemaResponse = {
        /** data set fields */
        fields: Array;

        /** data set query parameters */
        parameters: Array;
};

export type OpenDataSourceEditorBaseOptions = {
        /** locale passed by Designer */
        locale: 'en' | 'ja' | 'zh';


        /** **Non-null** if an existing data source edited, **null** - if a new one is created. */
        dataSource: DataSource | null;

        /** data sources used in report */
        reportDataSources: Array;


        /** callback on successful data source editing/creation */
        onSuccess: (options: DataSourceEditorOnSuccessOptions) => void;

        /** callback on closing Data Source Editor */
        onClose: () => void;
};

export type DataSourceEditorOnSuccessOptions = {
        /** successfully created or edited data source */
        dataSource: DataSource;
};

export type OpenDataSetPickerBaseOptions = {
        /** locale passed by Designer */
        locale: 'en' | 'ja' | 'zh';

        /** If mode is **Panel**, Data Set Picker is rendered within **Data** tab. */
        mode: DataSetPickerMode;

        /** If mode is not **Panel**, Data Set Picker is rendered to an element with this id. */
        elementId?: string;

        /** data sources used in report */
        reportDataSources: Array;

        /** data sets used in report */
        reportDataSets: Array;

        /** New data sources and data sets to be added are passed as parameters to this function. */
        addDataSourcesAndDataSets: (options: AddDataSourcesAndDataSetsOptions) => void;

        /** callback on closing Data Set Picker */
        onClose: () => void;
};

export type DataSetPickerMode = 'Panel' | 'Dialog';

export type AddDataSourcesAndDataSetsOptions = {
        /** data sources to-be-added */
        dataSources: Array;

        /** data sets to-be-added */
        dataSets: Array;
};

export type CanAddDataSetForDataSourceOptions = {
        /** data source */
        dataSource: DataSource;

        /** data provider of data source */
        dataProvider: string;
};                

                   /**
 * Type of **ARDataSourceEditor** object exported by **ar-datasource-editor.js** module.
 */
export type DataSourceEditorApi = {
        /* Initializes **Data Source Editor** using the specified **DataSourceEditorInitOptions** object and renders it to ** element with id **dataSourceEditorElementId**.
         * 
         * **Example:**
         * ```javascript
         * ARDataSourceEditor.init('data-source-editor-id', dataSourceEditorInitOptions);
         * ```
         * 
         * @param dataSourceEditorElementId string
         * @param options DataSourceEditorInitOptions object
         */
        init: (dataSourceEditorElementId: string, options?: DataSourceEditorInitOptions) => void;

        /**
         * Opens Data Source Editor.
         * 
         * **Example:**
         * ```javascript
         * ARDataSourceEditor.open(dataSourceEditorOptions);
         * ```
         * 
         * @param options DataSourceEditorOptions object
         */
        open: (options: DataSourceEditorOptions) => void;
};

export type CustomProviderDescriptor = {
        /**
         * key - data provider identifier\
         * This value is used for **DataSource.ConnectionProperties.DataProvider** property.
         */
        key: string;

        /**
         * name - data provider label\
         * This value is used as a friendly data provider label in UI.
         */
        name: string;
};

export type DataSourceEditorInitOptions = {
        /** predefined providers */
        predefinedProviders?: Array;

        /** OLE DB providers */
        oleDbProviders?: Array;

        /** custom providers */
        customProviders?: Array;
};

export type PredefinedProvider = 'SQL' | 'OLEDB' | 'ODBC' | 'JSON' | 'CSV' | 'XML';

export type OleDbProvider = PredefinedOleDbProvider | string;

export type PredefinedOleDbProvider = 'Microsoft.Jet.OLEDB.4.0' | 'SQLOLEDB.1' | 'MSDataShape.1' | 'MSDASQL.1';

export type DataSourceEditorOptions = OpenDataSourceEditorBaseOptions & {
        /** Specifies custom localization data. */
        localeData?: Array;
                        

/** **Data Source Editor** server API */
        serverApi: {
                /**
                 * Tests data source connection.
                 * 
                 * @param options TestConnectionOptions object
                 */
                testConnection: (options: TestConnectionOptions) => Promise;
        };
};

export type TestConnectionOptions = {
        /** data source */
        dataSource: DataSource;
};

export type TestConnectionResponse = {
        /** error code - 0 means success */
        Code: number;

        /** databases list available for test connection settings */
        Databases: Array | null,

        /** error message */
        Error: string | null,
};                

type ThemesListItem = {
  _id: string, // theme id
  Name: string, // theme name
  IsDefault: boolean, // specifies whether theme is default or not, only a single theme can be default
  Dark1: string, // Dark1 theme color
  Dark2: string, // Dark2 theme color
  Light1: string, // Light1 theme color
  Light2: string, // Light2 theme color
  Accent1: string, // Accent1 theme color
  Accent2: string, // Accent2 theme color
  Accent3: string, // Accent3 theme color
  Accent4: string, // Accent4 theme color
  Accent5: string, // Accent5 theme color
  Accent6: string, // Accent6 theme color
  MajorFontFamily: string, // Major text theme font family
  MinorFontFamily: string, // Minor text theme font family
}

type GetThemeContentOptions = {
  id: string, // theme id
}

type ThemeModel = {
  Colors: {
    Dark1: string, // Dark1 theme color
    Dark2: string, // Dark2 theme color
    Light1: string, // Light1 theme color
    Light2: string, // Light2 theme color
    Accent1: string, // Accent1 theme color
    Accent2: string, // Accent2 theme color
    Accent3: string, // Accent3 theme color
    Accent4: string, // Accent4 theme color
    Accent5: string, // Accent5 theme color
    Accent6: string, // Accent6 theme color
    Hyperlink: string, // Hyperlink theme color
    HyperlinkFollowed: string, // Followed hyperlink theme color
  },
  Fonts: {
    MajorFont: ThemeFont,
    MinorFont: ThemeFont,
  }
  Images: Array<ThemeImage>,
  Constants: Array<ThemeConstant>,
}
type ThemeFont = {
  Family: string, // font family
  Style: string, // font style
  Size: string, // font size
  Weight: string, // font weight
}
type ThemeImage = {
  Name: string, // image name
  MIMEType: string, // image MIME type
  ImageData: string, // Base64 image data
}
type ThemeConstant = {
  Key: string, // constant key
  Value: string, // constant value
}

type ImagesListItem = {
  _id: string, // image id
  Name: string, // image name
  MimeType: string, // image MIME type
  Thumbnail: null, // RESERVED - for now only null is supported
}

type GetImageUrlOptions = {
  id: string, // image id
}

type TemplatesListItem = {
  _id: string, // template id
  Name: string, // template name
}

type GetTemplateContentOptions = {
  id: string, // template id
}

type GetTemplateThumbnailOptions = {
  id: string, // template id
}

type ResourceLinkOptions = {
  id: string, // resource id
  type: 'report' | 'image' | 'theme' | null, // resource type
  version: null, // RESERVED - for now only null is supported
}

type UpdateRouteOptions = {
  id: string, // report id
  version: null, // RESERVED - for now only null is supported
}