import { DSVRowArray } from "d3-dsv";
/**
 * Returns the data from a Statistics Canada table as an array of objects. The first parameter is the pid value that can be found in the table url.
 *
 * @example
 * Basic usage
 * ```js
 * const data = await getStatCanTable('98100001')
 * ```
 *
 * @example
 * With options
 * ```js
 * const data = await getStatCanTable('98100001', {
 *   lang: 'fr',
 *   skipFirstCharacter: true,
 *   returnRawCSV: true,
 * })
 * ```
 *
 * @param pid The pid value that can be found in the table URL.
 * @param options Optional settings.
 * @param options.lang Language of the table, either 'en' or 'fr'. Defaults to 'en'.
 * @param options.skipFirstCharacter Whether to skip the first character of the CSV data. Defaults to false.
 * @param options.returnRawCSV Whether to return the raw CSV data as a string. Defaults to false.
 * @param options.debug Whether to enable debug logging. Defaults to false.
 *
 * @category Web scraping
 */
export default function getStatCanTable(pid: string, options?: {
    lang?: "en" | "fr";
    skipFirstCharacter?: boolean;
    returnRawCSV?: boolean;
    debug?: boolean;
}): Promise<string | DSVRowArray<string>>;