@nshiab/simple-data-analysis 5.21.1 → 6.0.1

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/overwriteSheetData.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Clears the content of a Google Sheet and then populates it with new data. This function is useful for regularly updating datasets in Google Sheets, ensuring that the sheet always reflects the latest information without manual intervention.
+ *
+ * The function automatically infers column headers from the keys of the first object in your `data` array. It supports various options for customizing the update process, including adding a timestamp of the last update, prepending custom text, and controlling how Google Sheets interprets the data types.
+ *
+ * By default, authentication is handled via environment variables (`GOOGLE_PRIVATE_KEY` and `GOOGLE_SERVICE_ACCOUNT_EMAIL`). Alternatively, you can use `GOOGLE_APPLICATION_CREDENTIALS` pointing to a service account JSON file. For detailed setup instructions, refer to the `node-google-spreadsheet` authentication guide: [https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication](https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication).
+ *
+ * @param data - An array of objects to be written to the Google Sheet. The keys of the first object in this array will be used as column headers.
+ * @param sheetUrl - The URL of the Google Sheet to be updated. This URL should point to a specific sheet (e.g., ending with `#gid=0`).
+ * @param options - An optional object with configuration options:
+ *   @param options.prepend - A string to be added as a new row at the very top of the sheet, before any data or `lastUpdate` information. Useful for adding notes or disclaimers.
+ *   @param options.lastUpdate - If `true`, a row indicating the date and time of the update will be added before the data. Defaults to `false`.
+ *   @param options.timeZone - If `lastUpdate` is `true`, this option allows you to specify a time zone for the timestamp (e.g., `"Canada/Eastern"`). If omitted, the date will be formatted in UTC.
+ *   @param options.raw - If `true`, data will be written as raw values, preventing Google Sheets from automatically guessing data types or applying formatting. This can be useful for preserving exact string representations. Defaults to `false`.
+ *   @param options.apiEmail - Optional. Your Google Service Account email. If provided, this will override the `GOOGLE_SERVICE_ACCOUNT_EMAIL` environment variable.
+ *   @param options.apiKey - Optional. Your Google Service Account private key. If provided, this will override the `GOOGLE_PRIVATE_KEY` environment variable.
+ * @returns A Promise that resolves when the sheet has been successfully cleared and populated with new data.
+ *
+ * @example
+ * ```ts
+ * // The data needs to be an array of objects. The keys of the first object will be used to create the header row.
+ * const data = [
+ *   { first: "Nael", last: "Shiab" },
+ *   { first: "Andrew", last: "Ryan" }
+ * ];
+ * // Fake URL used as an example.
+ * const sheetUrl = "https://docs.google.com/spreadsheets/d/nrqo3oP4KMWYbELScQa8W1nHZPfIrA7LIz9UmcRE4GyJN/edit#gid=0";
+ *
+ * // Clearing the sheet and then populating it.
+ * await overwriteSheetData(data, sheetUrl);
+ * console.log("Sheet updated successfully with data.");
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Write data as raw values to prevent Google Sheets from interpreting them.
+ * const rawData = [
+ *   { id: '001', value: '05' }, // '05' might be interpreted as 5 without raw: true
+ *   { id: '002', value: '10' }
+ * ];
+ * await overwriteSheetData(rawData, sheetUrl, { raw: true });
+ * console.log("Sheet updated successfully with raw data.");
+ * ```
+ * @example
+ * ```ts
+ * // Add a timestamp of the update in UTC.
+ * await overwriteSheetData(data, sheetUrl, { lastUpdate: true });
+ * console.log("Sheet updated with UTC timestamp.");
+ *
+ * // Add a timestamp formatted to a specific time zone.
+ * await overwriteSheetData(data, sheetUrl, { lastUpdate: true, timeZone: "Canada/Eastern" });
+ * console.log("Sheet updated with Eastern Time timestamp.");
+ * ```
+ * @example
+ * ```ts
+ * // Add a custom message at the top of the sheet.
+ * await overwriteSheetData(data, sheetUrl, { prepend: "For inquiries, contact data.team@example.com" });
+ * console.log("Sheet updated with prepended text.");
+ *
+ * // Combine prepend with last update and time zone.
+ * await overwriteSheetData(data, sheetUrl, {
+ *   prepend: "For inquiries, contact data.team@example.com",
+ *   lastUpdate: true,
+ *   timeZone: "Canada/Eastern"
+ * });
+ * console.log("Sheet updated with prepended text and timestamp.");
+ * ```
+ * @example
+ * ```ts
+ * // Use explicitly provided API credentials instead of environment variables.
+ * await overwriteSheetData(data, sheetUrl, {
+ *   apiEmail: "your-service-account@project-id.iam.gserviceaccount.com",
+ *   apiKey: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+ * });
+ * console.log("Sheet updated using custom API credentials.");
+ * ```
+ * @deprecated Use `pushToSheet(data, sheetUrl, { mode: "overwrite" })` instead.
+ * This function may be removed in the next major release.
+ * @category Google
+ */
+export default function overwriteSheetData(data: {
+    [key: string]: string | number | boolean | Date | null;
+}[], sheetUrl: string, options?: {
+    prepend?: string;
+    lastUpdate?: boolean;
+    timeZone?: "Canada/Atlantic" | "Canada/Central" | "Canada/Eastern" | "Canada/Mountain" | "Canada/Newfoundland" | "Canada/Pacific" | "Canada/Saskatchewan" | "Canada/Yukon";
+    raw?: boolean;
+    apiEmail?: string;
+    apiKey?: string;
+}): Promise<void>;
+//# sourceMappingURL=overwriteSheetData.d.ts.map

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/overwriteSheetData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overwriteSheetData.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/overwriteSheetData.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AAEH,wBAA8B,kBAAkB,CAC9C,IAAI,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAA;CAAE,EAAE,EAClE,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EACL,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/overwriteSheetData.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = overwriteSheetData;
+const cleanData_js_1 = __importDefault(require("./helpers/cleanData.js"));
+const formatLastUpdate_js_1 = __importDefault(require("./helpers/formatLastUpdate.js"));
+const logToSheet_js_1 = __importDefault(require("./helpers/logToSheet.js"));
+const warnDeprecated_js_1 = __importDefault(require("./helpers/warnDeprecated.js"));
+/**
+ * Clears the content of a Google Sheet and then populates it with new data. This function is useful for regularly updating datasets in Google Sheets, ensuring that the sheet always reflects the latest information without manual intervention.
+ *
+ * The function automatically infers column headers from the keys of the first object in your `data` array. It supports various options for customizing the update process, including adding a timestamp of the last update, prepending custom text, and controlling how Google Sheets interprets the data types.
+ *
+ * By default, authentication is handled via environment variables (`GOOGLE_PRIVATE_KEY` and `GOOGLE_SERVICE_ACCOUNT_EMAIL`). Alternatively, you can use `GOOGLE_APPLICATION_CREDENTIALS` pointing to a service account JSON file. For detailed setup instructions, refer to the `node-google-spreadsheet` authentication guide: [https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication](https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication).
+ *
+ * @param data - An array of objects to be written to the Google Sheet. The keys of the first object in this array will be used as column headers.
+ * @param sheetUrl - The URL of the Google Sheet to be updated. This URL should point to a specific sheet (e.g., ending with `#gid=0`).
+ * @param options - An optional object with configuration options:
+ *   @param options.prepend - A string to be added as a new row at the very top of the sheet, before any data or `lastUpdate` information. Useful for adding notes or disclaimers.
+ *   @param options.lastUpdate - If `true`, a row indicating the date and time of the update will be added before the data. Defaults to `false`.
+ *   @param options.timeZone - If `lastUpdate` is `true`, this option allows you to specify a time zone for the timestamp (e.g., `"Canada/Eastern"`). If omitted, the date will be formatted in UTC.
+ *   @param options.raw - If `true`, data will be written as raw values, preventing Google Sheets from automatically guessing data types or applying formatting. This can be useful for preserving exact string representations. Defaults to `false`.
+ *   @param options.apiEmail - Optional. Your Google Service Account email. If provided, this will override the `GOOGLE_SERVICE_ACCOUNT_EMAIL` environment variable.
+ *   @param options.apiKey - Optional. Your Google Service Account private key. If provided, this will override the `GOOGLE_PRIVATE_KEY` environment variable.
+ * @returns A Promise that resolves when the sheet has been successfully cleared and populated with new data.
+ *
+ * @example
+ * ```ts
+ * // The data needs to be an array of objects. The keys of the first object will be used to create the header row.
+ * const data = [
+ *   { first: "Nael", last: "Shiab" },
+ *   { first: "Andrew", last: "Ryan" }
+ * ];
+ * // Fake URL used as an example.
+ * const sheetUrl = "https://docs.google.com/spreadsheets/d/nrqo3oP4KMWYbELScQa8W1nHZPfIrA7LIz9UmcRE4GyJN/edit#gid=0";
+ *
+ * // Clearing the sheet and then populating it.
+ * await overwriteSheetData(data, sheetUrl);
+ * console.log("Sheet updated successfully with data.");
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Write data as raw values to prevent Google Sheets from interpreting them.
+ * const rawData = [
+ *   { id: '001', value: '05' }, // '05' might be interpreted as 5 without raw: true
+ *   { id: '002', value: '10' }
+ * ];
+ * await overwriteSheetData(rawData, sheetUrl, { raw: true });
+ * console.log("Sheet updated successfully with raw data.");
+ * ```
+ * @example
+ * ```ts
+ * // Add a timestamp of the update in UTC.
+ * await overwriteSheetData(data, sheetUrl, { lastUpdate: true });
+ * console.log("Sheet updated with UTC timestamp.");
+ *
+ * // Add a timestamp formatted to a specific time zone.
+ * await overwriteSheetData(data, sheetUrl, { lastUpdate: true, timeZone: "Canada/Eastern" });
+ * console.log("Sheet updated with Eastern Time timestamp.");
+ * ```
+ * @example
+ * ```ts
+ * // Add a custom message at the top of the sheet.
+ * await overwriteSheetData(data, sheetUrl, { prepend: "For inquiries, contact data.team@example.com" });
+ * console.log("Sheet updated with prepended text.");
+ *
+ * // Combine prepend with last update and time zone.
+ * await overwriteSheetData(data, sheetUrl, {
+ *   prepend: "For inquiries, contact data.team@example.com",
+ *   lastUpdate: true,
+ *   timeZone: "Canada/Eastern"
+ * });
+ * console.log("Sheet updated with prepended text and timestamp.");
+ * ```
+ * @example
+ * ```ts
+ * // Use explicitly provided API credentials instead of environment variables.
+ * await overwriteSheetData(data, sheetUrl, {
+ *   apiEmail: "your-service-account@project-id.iam.gserviceaccount.com",
+ *   apiKey: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+ * });
+ * console.log("Sheet updated using custom API credentials.");
+ * ```
+ * @deprecated Use `pushToSheet(data, sheetUrl, { mode: "overwrite" })` instead.
+ * This function may be removed in the next major release.
+ * @category Google
+ */
+async function overwriteSheetData(data, sheetUrl, options = {}) {
+    (0, warnDeprecated_js_1.default)("overwriteSheetData", 'pushToSheet() with mode: "overwrite"');
+    const sheet = await (0, logToSheet_js_1.default)(sheetUrl, options);
+    await sheet.clear();
+    let startIndex = 1;
+    if (typeof options.prepend === "string" || options.lastUpdate) {
+        await sheet.loadCells("A1:B2");
+    }
+    if (typeof options.prepend === "string") {
+        const cellPrepend = sheet.getCellByA1(`A${startIndex}`);
+        cellPrepend.value = options.prepend;
+        startIndex += 1;
+    }
+    if (options.lastUpdate) {
+        const cellLastUpdate = sheet.getCellByA1(`A${startIndex}`);
+        cellLastUpdate.value = "Last update:";
+        const cellDate = sheet.getCellByA1(`B${startIndex}`);
+        if (typeof options.timeZone === "string") {
+            cellDate.value = (0, formatLastUpdate_js_1.default)(new Date(), options.timeZone);
+        }
+        else {
+            cellDate.value = (0, formatLastUpdate_js_1.default)(new Date());
+        }
+        startIndex += 1;
+    }
+    if (typeof options.prepend === "string" || options.lastUpdate) {
+        await sheet.saveUpdatedCells();
+    }
+    const headerRow = Object.keys(data[0]);
+    await sheet.setHeaderRow(headerRow, startIndex);
+    await sheet.addRows((0, cleanData_js_1.default)(data), { raw: options.raw });
+}

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/pushToSheet.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Writes data to a Google Sheets tab, either replacing its contents or
+ * appending rows. The tab can be selected by the URL's `gid` or by title.
+ * If a titled tab does not exist, creation must be explicitly enabled with
+ * `create: true`. In append mode, column headers are detected automatically
+ * within the first 100 rows of the tab.
+ *
+ * By default, authentication uses `GOOGLE_SERVICE_ACCOUNT_EMAIL` and
+ * `GOOGLE_PRIVATE_KEY`. Alternatively, `GOOGLE_APPLICATION_CREDENTIALS` can
+ * point to a service-account JSON file. Credentials passed through
+ * `options.credentials` take precedence over both environment-based methods.
+ * For detailed setup instructions, refer to the `node-google-spreadsheet`
+ * authentication guide:
+ * [https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication](https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication).
+ *
+ * @param data Rows of data. Object keys are used as column headers.
+ * @param sheetUrl A Google Sheets URL. It may identify a spreadsheet or a
+ * specific tab.
+ * @param options Controls tab selection, writing, metadata, value parsing, and
+ * authentication.
+ * @param options.mode Whether to overwrite the tab or append rows. Defaults to
+ * `"overwrite"`.
+ * @param options.tabTitle Selects a tab by title instead of using the URL's
+ * `gid`.
+ * @param options.create Creates a missing titled tab. Requires `tabTitle` and
+ * defaults to `false`.
+ * @param options.prepend Adds text above the header row in overwrite mode.
+ * @param options.lastUpdate Adds a UTC timestamp when `true`, or a timestamp in
+ * the specified Canadian time zone. Available only in overwrite mode.
+ * @param options.raw Writes values without Google Sheets interpretation.
+ * Defaults to `true`.
+ * @param options.credentials Explicit Google service-account credentials.
+ * These values override `GOOGLE_APPLICATION_CREDENTIALS`,
+ * `GOOGLE_SERVICE_ACCOUNT_EMAIL`, and `GOOGLE_PRIVATE_KEY`.
+ * @returns A promise that resolves when the data has been written.
+ *
+ * @example Overwrite the tab selected by the URL.
+ * ```ts
+ * await pushToSheet(data, sheetUrl);
+ * ```
+ *
+ * @example Append rows to a tab selected by title.
+ * ```ts
+ * await pushToSheet(data, sheetUrl, {
+ *   mode: "append",
+ *   tabTitle: "Election results",
+ * });
+ * ```
+ *
+ * @example Create a missing tab and write a timestamp in Eastern time.
+ * ```ts
+ * await pushToSheet(data, sheetUrl, {
+ *   tabTitle: "Election results",
+ *   create: true,
+ *   lastUpdate: "Canada/Eastern",
+ * });
+ * ```
+ *
+ * @category Google
+ */
+export default function pushToSheet(data: {
+    [key: string]: string | number | boolean | Date | null;
+}[], sheetUrl: string, options?: {
+    mode?: "overwrite" | "append";
+    tabTitle?: string;
+    create?: boolean;
+    prepend?: string;
+    lastUpdate?: boolean | "Canada/Atlantic" | "Canada/Central" | "Canada/Eastern" | "Canada/Mountain" | "Canada/Newfoundland" | "Canada/Pacific" | "Canada/Saskatchewan" | "Canada/Yukon";
+    raw?: boolean;
+    credentials?: {
+        email: string;
+        privateKey: string;
+    };
+}): Promise<void>;
+//# sourceMappingURL=pushToSheet.d.ts.map

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/pushToSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushToSheet.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/pushToSheet.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAA8B,WAAW,CACvC,IAAI,EAAE;IACJ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;CACxD,EAAE,EACH,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EACP,OAAO,GACP,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACE,GACL,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/pushToSheet.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = pushToSheet;
+const appendRowsToTab_js_1 = __importDefault(require("./helpers/appendRowsToTab.js"));
+const openSpreadsheet_js_1 = __importDefault(require("./openSpreadsheet.js"));
+const overwriteTabData_js_1 = __importDefault(require("./helpers/overwriteTabData.js"));
+/**
+ * Writes data to a Google Sheets tab, either replacing its contents or
+ * appending rows. The tab can be selected by the URL's `gid` or by title.
+ * If a titled tab does not exist, creation must be explicitly enabled with
+ * `create: true`. In append mode, column headers are detected automatically
+ * within the first 100 rows of the tab.
+ *
+ * By default, authentication uses `GOOGLE_SERVICE_ACCOUNT_EMAIL` and
+ * `GOOGLE_PRIVATE_KEY`. Alternatively, `GOOGLE_APPLICATION_CREDENTIALS` can
+ * point to a service-account JSON file. Credentials passed through
+ * `options.credentials` take precedence over both environment-based methods.
+ * For detailed setup instructions, refer to the `node-google-spreadsheet`
+ * authentication guide:
+ * [https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication](https://theoephraim.github.io/node-google-spreadsheet/#/guides/authentication).
+ *
+ * @param data Rows of data. Object keys are used as column headers.
+ * @param sheetUrl A Google Sheets URL. It may identify a spreadsheet or a
+ * specific tab.
+ * @param options Controls tab selection, writing, metadata, value parsing, and
+ * authentication.
+ * @param options.mode Whether to overwrite the tab or append rows. Defaults to
+ * `"overwrite"`.
+ * @param options.tabTitle Selects a tab by title instead of using the URL's
+ * `gid`.
+ * @param options.create Creates a missing titled tab. Requires `tabTitle` and
+ * defaults to `false`.
+ * @param options.prepend Adds text above the header row in overwrite mode.
+ * @param options.lastUpdate Adds a UTC timestamp when `true`, or a timestamp in
+ * the specified Canadian time zone. Available only in overwrite mode.
+ * @param options.raw Writes values without Google Sheets interpretation.
+ * Defaults to `true`.
+ * @param options.credentials Explicit Google service-account credentials.
+ * These values override `GOOGLE_APPLICATION_CREDENTIALS`,
+ * `GOOGLE_SERVICE_ACCOUNT_EMAIL`, and `GOOGLE_PRIVATE_KEY`.
+ * @returns A promise that resolves when the data has been written.
+ *
+ * @example Overwrite the tab selected by the URL.
+ * ```ts
+ * await pushToSheet(data, sheetUrl);
+ * ```
+ *
+ * @example Append rows to a tab selected by title.
+ * ```ts
+ * await pushToSheet(data, sheetUrl, {
+ *   mode: "append",
+ *   tabTitle: "Election results",
+ * });
+ * ```
+ *
+ * @example Create a missing tab and write a timestamp in Eastern time.
+ * ```ts
+ * await pushToSheet(data, sheetUrl, {
+ *   tabTitle: "Election results",
+ *   create: true,
+ *   lastUpdate: "Canada/Eastern",
+ * });
+ * ```
+ *
+ * @category Google
+ */
+async function pushToSheet(data, sheetUrl, options = {}) {
+    const mode = options.mode ?? "overwrite";
+    if (mode !== "overwrite" && mode !== "append") {
+        throw new Error(`Invalid mode: ${mode}. Expected "overwrite" or "append".`);
+    }
+    if (options.tabTitle !== undefined && options.tabTitle.trim() === "") {
+        throw new Error("tabTitle cannot be empty.");
+    }
+    if (options.create && options.tabTitle === undefined) {
+        throw new Error("The create option requires tabTitle.");
+    }
+    if (mode === "append" &&
+        (typeof options.prepend === "string" || options.lastUpdate)) {
+        throw new Error("prepend and lastUpdate are only available in overwrite mode.");
+    }
+    const { spreadsheet, sheetId } = await (0, openSpreadsheet_js_1.default)(sheetUrl, {
+        credentials: options.credentials,
+    });
+    let sheet;
+    if (options.tabTitle !== undefined) {
+        sheet = spreadsheet.sheetsByTitle[options.tabTitle];
+        if (sheet === undefined && options.create) {
+            sheet = await spreadsheet.addSheet({ title: options.tabTitle });
+        }
+        else if (sheet === undefined) {
+            throw new Error(`Tab titled "${options.tabTitle}" not found. Pass create: true to create it.`);
+        }
+    }
+    else {
+        if (sheetId === undefined) {
+            throw new Error("The Google Sheets URL must include a gid when tabTitle is not provided.");
+        }
+        sheet = spreadsheet.sheetsById[sheetId];
+        if (sheet === undefined) {
+            throw new Error(`Sheet with ID ${sheetId} not found.`);
+        }
+    }
+    if (mode === "overwrite") {
+        await (0, overwriteTabData_js_1.default)(data, sheet, options);
+    }
+    else {
+        await (0, appendRowsToTab_js_1.default)(data, sheet, { raw: options.raw ?? true });
+    }
+}

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/toBucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toBucket.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/toBucket.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAA8B,QAAQ,CACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CACX,GACL,OAAO,CAAC,MAAM,CAAC,CAqDjB"}

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module
+ *
+ * The Journalism library (Google services functions)
+ *
+ * To install the library with Deno, use:
+ * ```bash
+ * deno add jsr:@nshiab/journalism-google
+ * ```
+ *
+ * To install the library with Node.js, use:
+ * ```bash
+ * npm i @nshiab/journalism-google
+ * ```
+ *
+ * To import a function, use:
+ * ```ts
+ * import { functionName } from "@nshiab/journalism-google";
+ * ```
+ */
+import addSheetRows from "./google/addSheetRows.js";
+import overwriteSheetData from "./google/overwriteSheetData.js";
+import getSheetData from "./google/getSheetData.js";
+import toBucket from "./google/toBucket.js";
+import deleteFromBucket from "./google/deleteFromBucket.js";
+import inBucket from "./google/inBucket.js";
+import downloadFromBucket from "./google/downloadFromBucket.js";
+import filesInBucket from "./google/filesInBucket.js";
+import pushToSheet from "./google/pushToSheet.js";
+import openSpreadsheet from "./google/openSpreadsheet.js";
+export { addSheetRows, deleteFromBucket, downloadFromBucket, filesInBucket, getSheetData, inBucket, openSpreadsheet, overwriteSheetData, pushToSheet, toBucket, };
+//# sourceMappingURL=index.d.ts.map

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,OAAO,kBAAkB,MAAM,gCAAgC,CAAC;AAChE,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,gBAAgB,MAAM,8BAA8B,CAAC;AAC5D,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,kBAAkB,MAAM,gCAAgC,CAAC;AAChE,OAAO,aAAa,MAAM,2BAA2B,CAAC;AACtD,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAClD,OAAO,eAAe,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,QAAQ,GACT,CAAC"}

package/script/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @module
+ *
+ * The Journalism library (Google services functions)
+ *
+ * To install the library with Deno, use:
+ * ```bash
+ * deno add jsr:@nshiab/journalism-google
+ * ```
+ *
+ * To install the library with Node.js, use:
+ * ```bash
+ * npm i @nshiab/journalism-google
+ * ```
+ *
+ * To import a function, use:
+ * ```ts
+ * import { functionName } from "@nshiab/journalism-google";
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBucket = exports.pushToSheet = exports.overwriteSheetData = exports.openSpreadsheet = exports.inBucket = exports.getSheetData = exports.filesInBucket = exports.downloadFromBucket = exports.deleteFromBucket = exports.addSheetRows = void 0;
+const addSheetRows_js_1 = __importDefault(require("./google/addSheetRows.js"));
+exports.addSheetRows = addSheetRows_js_1.default;
+const overwriteSheetData_js_1 = __importDefault(require("./google/overwriteSheetData.js"));
+exports.overwriteSheetData = overwriteSheetData_js_1.default;
+const getSheetData_js_1 = __importDefault(require("./google/getSheetData.js"));
+exports.getSheetData = getSheetData_js_1.default;
+const toBucket_js_1 = __importDefault(require("./google/toBucket.js"));
+exports.toBucket = toBucket_js_1.default;
+const deleteFromBucket_js_1 = __importDefault(require("./google/deleteFromBucket.js"));
+exports.deleteFromBucket = deleteFromBucket_js_1.default;
+const inBucket_js_1 = __importDefault(require("./google/inBucket.js"));
+exports.inBucket = inBucket_js_1.default;
+const downloadFromBucket_js_1 = __importDefault(require("./google/downloadFromBucket.js"));
+exports.downloadFromBucket = downloadFromBucket_js_1.default;
+const filesInBucket_js_1 = __importDefault(require("./google/filesInBucket.js"));
+exports.filesInBucket = filesInBucket_js_1.default;
+const pushToSheet_js_1 = __importDefault(require("./google/pushToSheet.js"));
+exports.pushToSheet = pushToSheet_js_1.default;
+const openSpreadsheet_js_1 = __importDefault(require("./google/openSpreadsheet.js"));
+exports.openSpreadsheet = openSpreadsheet_js_1.default;

package/script/deps/jsr.io/@nshiab/simple-data-analysis-core/2.0.2/src/class/SDAError.d.ts

@@ -0,0 +1,63 @@
+/**
+ * An error thrown when a SQL query fails. It carries the SDA method that
+ * triggered the query, the parameters passed to it, the SQL query itself,
+ * and the original error as `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await table.selectColumns("aColumnThatDoesNotExist").run();
+ * } catch (error) {
+ *   if (error instanceof SDAError) {
+ *     console.log(error.method); // "selectColumns()"
+ *     console.log(error.query); // The SQL query that failed
+ *     console.log(error.cause); // The original DuckDB error
+ *   }
+ * }
+ * ```
+ */
+export default class SDAError extends Error {
+    /**
+     * The SDA method that triggered the failing query.
+     */
+    method: string | null;
+    /**
+     * The parameters passed to the method.
+     */
+    parameters: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The SQL query that failed.
+     */
+    query: string;
+    /**
+     * Creates an error that preserves the failing query and its original cause.
+     *
+     * @param options - Details of the failed query.
+     * @param options.method - The SDA method that triggered the query, or `null`.
+     * @param options.parameters - The method's arguments, or `null`.
+     * @param options.query - The SQL statement that failed.
+     * @param options.cause - The original error thrown while executing the query.
+     *
+     * @example
+     * ```ts
+     * const error = new SDAError({
+     *   method: "example()",
+     *   parameters: { column: "missing" },
+     *   query: "SELECT missing FROM data",
+     *   cause: new Error("Column not found"),
+     * });
+     * console.log(error.method, error.cause);
+     * ```
+     */
+    constructor(options: {
+        method: string | null;
+        parameters: {
+            [key: string]: unknown;
+        } | null;
+        query: string;
+        cause: unknown;
+    });
+}
+//# sourceMappingURL=SDAError.d.ts.map

package/script/deps/jsr.io/@nshiab/simple-data-analysis-core/2.0.2/src/class/SDAError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDAError.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@nshiab/simple-data-analysis-core/2.0.2/src/class/SDAError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,KAAK;IACzC;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;;;;;;;;;OAmBG;gBAED,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;KAChB;CAoBJ"}

package/script/deps/jsr.io/@nshiab/simple-data-analysis-core/2.0.2/src/class/SDAError.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * An error thrown when a SQL query fails. It carries the SDA method that
+ * triggered the query, the parameters passed to it, the SQL query itself,
+ * and the original error as `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await table.selectColumns("aColumnThatDoesNotExist").run();
+ * } catch (error) {
+ *   if (error instanceof SDAError) {
+ *     console.log(error.method); // "selectColumns()"
+ *     console.log(error.query); // The SQL query that failed
+ *     console.log(error.cause); // The original DuckDB error
+ *   }
+ * }
+ * ```
+ */
+class SDAError extends Error {
+    /**
+     * Creates an error that preserves the failing query and its original cause.
+     *
+     * @param options - Details of the failed query.
+     * @param options.method - The SDA method that triggered the query, or `null`.
+     * @param options.parameters - The method's arguments, or `null`.
+     * @param options.query - The SQL statement that failed.
+     * @param options.cause - The original error thrown while executing the query.
+     *
+     * @example
+     * ```ts
+     * const error = new SDAError({
+     *   method: "example()",
+     *   parameters: { column: "missing" },
+     *   query: "SELECT missing FROM data",
+     *   cause: new Error("Column not found"),
+     * });
+     * console.log(error.method, error.cause);
+     * ```
+     */
+    constructor(options) {
+        let causeMessage = options.cause instanceof Error
+            ? options.cause.message
+            : String(options.cause);
+        if (causeMessage.includes("connection disconnected")) {
+            causeMessage =
+                "Database connection closed before all operations finished. Did you forget to add `await`?";
+        }
+        super(options.method === null
+            ? causeMessage
+            : `${causeMessage}\nSDA method: ${options.method}`, { cause: options.cause });
+        /**
+         * The SDA method that triggered the failing query.
+         */
+        Object.defineProperty(this, "method", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * The parameters passed to the method.
+         */
+        Object.defineProperty(this, "parameters", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * The SQL query that failed.
+         */
+        Object.defineProperty(this, "query", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "SDAError";
+        this.method = options.method;
+        this.parameters = options.parameters;
+        this.query = options.query;
+    }
+}
+exports.default = SDAError;