/** * Updates the data of a specified Datawrapper chart, table or map. By default, this function looks for the API key in process.env.DATAWRAPPER_KEY. * * @example * Basic usage * ```js * import { updateDataDW, dataAsCsv } from "journalism" * * const chartID = "myChartId" * * const data = [ * { salary: 75000, hireDate: new Date("2022-12-15") }, * ... * ] * const dataForChart = dataAsCsv(data) * * await updateDataDW(chartID, dataForChart) * * // If your API key is stored under a different name in process.env, use the options. * await updateDataDW(chartID, dataForChart, { apiKey: "DW_KEY" }) * ``` * * Example for a locator map. * ```js * import { updateDataDW } from "journalism" * * const mapID = "myMapId" * * const geojson = { * "type": "FeatureCollection", * "features": [ * { * "type": "Feature", * "properties": {}, * "geometry": { * "coordinates": [ * [ * [ * 11.127454320325711, * 20.34856592751224 * ], * [ * 11.127454320325711, * -13.781306861158996 * ], * [ * 55.68071875381875, * -13.781306861158996 * ], * [ * 55.68071875381875, * 20.34856592751224 * ], * [ * 11.127454320325711, * 20.34856592751224 * ] * ] * ], * "type": "Polygon" * } * } * ] * } * * const dataForMap = { * "markers": [ * { * "id": "m1", * "type": "area", * "visible": true, * "exactShape": true, * "fill": true, * "stroke": true, * "properties": { * "fill": "#15607a", * "fill-opacity": 0.2, * "stroke": "#15607a", * "stroke-width": 1, * "stroke-opacity": 1, * "stroke-dasharray": "100000", * "pattern": "solid", * "pattern-line-width": 2, * "pattern-line-gap": 2 * }, * "feature": geojson * } * ] * } * * await updateDataDW(mapID, JSON.stringify(dataForMap)) * * // If your API key is stored under a different name in process.env, use the options. * await updateDataDW(mapID, JSON.stringify(dataForMap), { apiKey: "DW_KEY" }) * ``` * * @param chartId - The ID of the chart, table, or map to update. * @param data - The data to update the chart, table, or map with, in CSV format for charts or JSON format for maps. * @param options - Optional parameters. * @param options.apiKey - The process.env API key name to use for authentication. If not provided, the function will look for the key in process.env.DATAWRAPPER_KEY. * @param options.returnResponse - If true, the function will return the response object from the fetch call. * * @category Dataviz */ export default function updateDataDW(chartId: string, data: string, options?: { apiKey?: string; returnResponse?: boolean; }): Promise;