@nshiab/simple-data-analysis 5.21.1 → 6.0.1

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/getSheetData.js

@@ -0,0 +1,74 @@
+import logToSheet from "./helpers/logToSheet.js";
+import parseCsv from "./helpers/parseCsv.js";
+/**
+ * Retrieves data from a Google Sheet.
+ *
+ * By default, this function attempts to authenticate using environment variables (`GOOGLE_PRIVATE_KEY` for the API key and `GOOGLE_SERVICE_ACCOUNT_EMAIL` for the service account email). Alternatively, you can use `GOOGLE_APPLICATION_CREDENTIALS` pointing to a service account JSON file. For detailed instructions on setting up credentials, 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 sheetUrl - The URL of the Google Sheet from which to retrieve data. This URL should point to a specific sheet (e.g., ending with `#gid=0`).
+ * @param options - An optional object with configuration options:
+ *   @param options.skip - The number of rows to skip from the beginning of the sheet before parsing the data. This is useful for sheets that have metadata at the top. Defaults to `0`.
+ *   @param options.csv - If `true`, the function will return the raw data as a CSV string. If `false` or omitted, it will return an array of objects, where each object represents a row and keys correspond to column headers. 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 to either an array of objects (`Record<string, string>[]`) if `options.csv` is `false`, or a CSV string (`string`) if `options.csv` is `true`.
+ *
+ * @example
+ * ```ts
+ * // Fake URL used as an example.
+ * const sheetUrl = "https://docs.google.com/spreadsheets/d/nrqo3oP4KMWYbELScQa8W1nHZPfIrA7LIz9UmcRE4GyJN/edit#gid=0";
+ *
+ * // Returning the data as an array of objects.
+ * const data = await getSheetData(sheetUrl);
+ * console.log(data);
+ * // Expected output (example):
+ * // [
+ * //   { Header1: 'Value1', Header2: 'Value2' },
+ * //   { Header1: 'Value3', Header2: 'Value4' }
+ * // ]
+ * ```
+ * @example
+ * ```ts
+ * // Retrieve data, skipping the first row (e.g., if it contains metadata).
+ * const dataSkippingFirstRow = await getSheetData(sheetUrl, { skip: 1 });
+ * console.log(dataSkippingFirstRow);
+ * // Expected output (example, assuming first row was metadata):
+ * // [
+ * //   { Header1: 'Value1', Header2: 'Value2' },
+ * //   { Header1: 'Value3', Header2: 'Value4' }
+ * // ]
+ * ```
+ * @example
+ * ```ts
+ * // Return the data as a raw CSV string, useful for direct writing to files or other systems.
+ * const csvString = await getSheetData(sheetUrl, { csv: true });
+ * console.log(csvString);
+ * // Expected output (example):
+ * // "Header1,Header2\nValue1,Value2\nValue3,Value4"
+ * ```
+ * @example
+ * ```ts
+ * // Use custom environment variable names for API email and key.
+ * const dataWithCustomCredentials = await getSheetData(sheetUrl, {
+ *   apiEmail: "GG_EMAIL",
+ *   apiKey: "GG_KEY"
+ * });
+ * console.log(dataWithCustomCredentials);
+ * ```
+ * @category Google
+ */
+export default async function getSheetData(sheetUrl, options = {}) {
+    const sheet = await logToSheet(sheetUrl, options);
+    const buffer = await sheet.downloadAsCSV();
+    const enc = new TextDecoder("utf-8");
+    let csv = enc.decode(buffer);
+    if (typeof options.skip === "number") {
+        csv = csv.split("\n").slice(options.skip).join("\n");
+    }
+    if (options.csv) {
+        return csv;
+    }
+    else {
+        return parseCsv(csv);
+    }
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/appendRowsToTab.d.ts

@@ -0,0 +1,8 @@
+import type { GoogleSpreadsheetWorksheet } from "google-spreadsheet";
+export default function appendRowsToTab(data: {
+    [key: string]: string | number | boolean | Date | null;
+}[], sheet: GoogleSpreadsheetWorksheet, options: {
+    raw: boolean;
+}): Promise<void>;
+export declare function findHeaderRow(rows: unknown[][], headers: string[]): number | undefined;
+//# sourceMappingURL=appendRowsToTab.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/appendRowsToTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appendRowsToTab.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/appendRowsToTab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAMrE,wBAA8B,eAAe,CAC3C,IAAI,EAAE;IACJ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;CACxD,EAAE,EACH,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EAAE,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,SAAS,CAepB"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/appendRowsToTab.js

@@ -0,0 +1,35 @@
+import cleanData from "./cleanData.js";
+const MAX_HEADER_SEARCH_ROWS = 100;
+export default async function appendRowsToTab(data, sheet, options) {
+    if (data.length === 0) {
+        return;
+    }
+    const headers = Object.keys(data[0]);
+    if (headers.length === 0) {
+        throw new Error("Data rows must contain at least one column.");
+    }
+    const lastHeaderSearchRow = Math.max(1, Math.min(sheet.rowCount, MAX_HEADER_SEARCH_ROWS));
+    const rows = (await sheet.getCellsInRange(`A1:${sheet.lastColumnLetter}${lastHeaderSearchRow}`) ?? []);
+    const headerRow = findHeaderRow(rows, headers);
+    const isBlank = rows.every((row) => row.every((value) => String(value ?? "") === ""));
+    if (headerRow === undefined && !isBlank) {
+        throw new Error(`Could not find a header row containing ${headers.join(", ")} within the first ${lastHeaderSearchRow} rows.`);
+    }
+    if (headerRow === undefined) {
+        await sheet.setHeaderRow(headers, 1);
+    }
+    else {
+        await sheet.loadHeaderRow(headerRow);
+    }
+    await sheet.addRows(cleanData(data), { raw: options.raw });
+}
+export function findHeaderRow(rows, headers) {
+    const matches = rows.flatMap((row, index) => {
+        const values = new Set(row.map((value) => String(value ?? "").trim()));
+        return headers.every((header) => values.has(header)) ? [index + 1] : [];
+    });
+    if (matches.length > 1) {
+        throw new Error(`Multiple possible header rows found (${matches.join(", ")}).`);
+    }
+    return matches[0];
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/cleanData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanData.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/cleanData.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,IAAI,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAA;CAAE,EAAE,GACjE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,EAAE,CAYvD"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/formatLastUpdate.d.ts

@@ -0,0 +1,3 @@
+export type CanadianTimeZone = "Canada/Atlantic" | "Canada/Central" | "Canada/Eastern" | "Canada/Mountain" | "Canada/Newfoundland" | "Canada/Pacific" | "Canada/Saskatchewan" | "Canada/Yukon";
+export default function formatLastUpdate(date: Date, timeZone?: CanadianTimeZone | "UTC"): string;
+//# sourceMappingURL=formatLastUpdate.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/formatLastUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatLastUpdate.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/formatLastUpdate.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,CAAC;AAkBnB,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,IAAI,EAAE,IAAI,EACV,QAAQ,GAAE,gBAAgB,GAAG,KAAa,GACzC,MAAM,CA+BR"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/formatLastUpdate.js

@@ -0,0 +1,39 @@
+const timeZoneLabels = {
+    UTC: "UTC",
+    "Canada/Atlantic": "AT",
+    "Canada/Central": "CT",
+    "Canada/Eastern": "ET",
+    "Canada/Mountain": "MT",
+    "Canada/Pacific": "PT",
+    "Canada/Saskatchewan": "CT",
+    "Canada/Yukon": "GMT-7",
+};
+export default function formatLastUpdate(date, timeZone = "UTC") {
+    const parts = Object.fromEntries(new Intl.DateTimeFormat("en-CA", {
+        calendar: "gregory",
+        numberingSystem: "latn",
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hourCycle: "h23",
+    }).formatToParts(date).map(({ type, value }) => [type, value]));
+    let timeZoneLabel;
+    if (timeZone === "Canada/Newfoundland") {
+        const offsetPart = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            timeZoneName: "shortOffset",
+        }).formatToParts(date).find(({ type }) => type === "timeZoneName");
+        if (offsetPart === undefined) {
+            throw new Error(`Could not format the ${timeZone} offset.`);
+        }
+        timeZoneLabel = offsetPart.value;
+    }
+    else {
+        timeZoneLabel = timeZoneLabels[timeZone];
+    }
+    return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}:${parts.second} ${timeZoneLabel}`;
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/logToSheet.d.ts

@@ -0,0 +1,12 @@
+import type { GoogleSpreadsheetWorksheet } from "google-spreadsheet";
+/**
+ * Authenticates with Google Sheets and returns a worksheet object.
+ * @param sheetUrl The URL of the Google Sheet.
+ * @param options Optional authentication options.
+ * @returns A GoogleSpreadsheetWorksheet object.
+ */
+export default function logToSheet(sheetUrl: string, options?: {
+    apiEmail?: string;
+    apiKey?: string;
+}): Promise<GoogleSpreadsheetWorksheet>;
+//# sourceMappingURL=logToSheet.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/logToSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logToSheet.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/logToSheet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGrE;;;;;GAKG;AACH,wBAA8B,UAAU,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,uCAerD"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/logToSheet.js

@@ -0,0 +1,18 @@
+import openSpreadsheet from "../openSpreadsheet.js";
+/**
+ * Authenticates with Google Sheets and returns a worksheet object.
+ * @param sheetUrl The URL of the Google Sheet.
+ * @param options Optional authentication options.
+ * @returns A GoogleSpreadsheetWorksheet object.
+ */
+export default async function logToSheet(sheetUrl, options = {}) {
+    const { spreadsheet, sheetId } = await openSpreadsheet(sheetUrl, options);
+    if (sheetId === undefined) {
+        throw new Error("The Google Sheets URL must include a gid.");
+    }
+    const sheet = spreadsheet.sheetsById[sheetId];
+    if (sheet === undefined) {
+        throw new Error(`Sheet with ID ${sheetId} not found.`);
+    }
+    return sheet;
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/overwriteTabData.d.ts

@@ -0,0 +1,9 @@
+import type { GoogleSpreadsheetWorksheet } from "google-spreadsheet";
+export default function overwriteTabData(data: {
+    [key: string]: string | number | boolean | Date | null;
+}[], sheet: GoogleSpreadsheetWorksheet, options: {
+    prepend?: string;
+    lastUpdate?: boolean | "Canada/Atlantic" | "Canada/Central" | "Canada/Eastern" | "Canada/Mountain" | "Canada/Newfoundland" | "Canada/Pacific" | "Canada/Saskatchewan" | "Canada/Yukon";
+    raw?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=overwriteTabData.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/overwriteTabData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overwriteTabData.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/overwriteTabData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAKrE,wBAA8B,gBAAgB,CAC5C,IAAI,EAAE;IACJ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;CACxD,EAAE,EACH,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE;IACP,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;CACf,GACA,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/overwriteTabData.js

@@ -0,0 +1,32 @@
+import cleanData from "./cleanData.js";
+import formatLastUpdate from "./formatLastUpdate.js";
+export default async function overwriteTabData(data, sheet, options) {
+    const headers = data.length === 0 ? [] : Object.keys(data[0]);
+    if (data.length > 0 && headers.length === 0) {
+        throw new Error("Data rows must contain at least one column.");
+    }
+    await sheet.clear();
+    if (data.length === 0)
+        return;
+    let headerRow = 1;
+    if (typeof options.prepend === "string" || options.lastUpdate) {
+        await sheet.loadCells("A1:B2");
+    }
+    if (typeof options.prepend === "string") {
+        sheet.getCellByA1(`A${headerRow}`).value = options.prepend;
+        headerRow += 1;
+    }
+    if (options.lastUpdate) {
+        sheet.getCellByA1(`A${headerRow}`).value = "Last update:";
+        sheet.getCellByA1(`B${headerRow}`).value = typeof options.lastUpdate ===
+            "string"
+            ? formatLastUpdate(new Date(), options.lastUpdate)
+            : formatLastUpdate(new Date());
+        headerRow += 1;
+    }
+    if (typeof options.prepend === "string" || options.lastUpdate) {
+        await sheet.saveUpdatedCells();
+    }
+    await sheet.setHeaderRow(headers, headerRow);
+    await sheet.addRows(cleanData(data), { raw: options.raw ?? true });
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseCsv.d.ts

@@ -0,0 +1,2 @@
+export default function parseCsv(text: string): Record<string, string>[];
+//# sourceMappingURL=parseCsv.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseCsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseCsv.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseCsv.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAevE"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseCsv.js

@@ -0,0 +1,108 @@
+/*
+ * Adapted from d3-dsv 3.0.1: https://github.com/d3/d3-dsv
+ *
+ * Copyright 2013-2021 Mike Bostock
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+ * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
+ * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+ * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+const EOL = Symbol("EOL");
+const EOF = Symbol("EOF");
+const QUOTE = 34;
+const NEWLINE = 10;
+const RETURN = 13;
+const DELIMITER = 44;
+export default function parseCsv(text) {
+    let columns = [];
+    return parseRows(text, (row, index) => {
+        if (index === 0) {
+            columns = row;
+            return undefined;
+        }
+        const record = {};
+        for (let i = 0; i < columns.length; i += 1) {
+            record[columns[i]] = row[i] || "";
+        }
+        return record;
+    });
+}
+function parseRows(text, convert) {
+    const rows = [];
+    let length = text.length;
+    let index = 0;
+    let rowIndex = 0;
+    let eof = length <= 0;
+    let eol = false;
+    if (text.charCodeAt(length - 1) === NEWLINE)
+        length -= 1;
+    if (text.charCodeAt(length - 1) === RETURN)
+        length -= 1;
+    function token() {
+        if (eof)
+            return EOF;
+        if (eol) {
+            eol = false;
+            return EOL;
+        }
+        let end;
+        const start = index;
+        let character;
+        if (text.charCodeAt(start) === QUOTE) {
+            while ((index++ < length && text.charCodeAt(index) !== QUOTE) ||
+                text.charCodeAt(++index) === QUOTE)
+                ;
+            if ((end = index) >= length) {
+                eof = true;
+            }
+            else if ((character = text.charCodeAt(index++)) === NEWLINE) {
+                eol = true;
+            }
+            else if (character === RETURN) {
+                eol = true;
+                if (text.charCodeAt(index) === NEWLINE)
+                    index += 1;
+            }
+            return text.slice(start + 1, end - 1).replaceAll('""', '"');
+        }
+        while (index < length) {
+            character = text.charCodeAt(end = index++);
+            if (character === NEWLINE) {
+                eol = true;
+            }
+            else if (character === RETURN) {
+                eol = true;
+                if (text.charCodeAt(index) === NEWLINE)
+                    index += 1;
+            }
+            else if (character !== DELIMITER) {
+                continue;
+            }
+            return text.slice(start, end);
+        }
+        eof = true;
+        return text.slice(start, length);
+    }
+    let value = token();
+    while (value !== EOF) {
+        const row = [];
+        while (value !== EOL && value !== EOF) {
+            row.push(value);
+            value = token();
+        }
+        const converted = convert(row, rowIndex++);
+        if (converted !== undefined)
+            rows.push(converted);
+        if (value === EOL)
+            value = token();
+    }
+    return rows;
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseSheetUrl.d.ts

@@ -0,0 +1,5 @@
+export default function parseSheetUrl(sheetUrl: string): {
+    spreadsheetId: string;
+    sheetId?: number;
+};
+//# sourceMappingURL=parseSheetUrl.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseSheetUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSheetUrl.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseSheetUrl.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAmCA"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/parseSheetUrl.js

@@ -0,0 +1,28 @@
+export default function parseSheetUrl(sheetUrl) {
+    let url;
+    try {
+        url = new URL(sheetUrl);
+    }
+    catch {
+        throw new Error(`Invalid Google Sheets URL: ${sheetUrl}`);
+    }
+    const match = url.pathname.match(/\/spreadsheets\/d\/([^/]+)/);
+    const spreadsheetId = match?.[1];
+    if (spreadsheetId === undefined || spreadsheetId === "") {
+        throw new Error(`Could not find a spreadsheet ID in URL: ${sheetUrl}`);
+    }
+    const querySheetId = url.searchParams.get("gid");
+    const hashSheetId = new URLSearchParams(url.hash.slice(1)).get("gid");
+    if (querySheetId !== null && hashSheetId !== null &&
+        querySheetId !== hashSheetId) {
+        throw new Error(`Ambiguous Google Sheets URL: query gid=${querySheetId} does not match fragment gid=${hashSheetId}.`);
+    }
+    const rawSheetId = hashSheetId ?? querySheetId;
+    if (rawSheetId === null) {
+        return { spreadsheetId };
+    }
+    if (!/^\d+$/.test(rawSheetId)) {
+        throw new Error(`Invalid sheet ID in URL: gid=${rawSheetId}`);
+    }
+    return { spreadsheetId, sheetId: Number(rawSheetId) };
+}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/warnDeprecated.d.ts

@@ -0,0 +1,2 @@
+export default function warnDeprecated(oldFunction: string, replacement: string, writeWarning?: (message: string) => void): void;
+//# sourceMappingURL=warnDeprecated.d.ts.map

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/warnDeprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnDeprecated.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/warnDeprecated.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAmB,GACrD,IAAI,CAQN"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/helpers/warnDeprecated.js

@@ -0,0 +1,8 @@
+const warnedFunctions = new Set();
+export default function warnDeprecated(oldFunction, replacement, writeWarning = console.warn) {
+    if (warnedFunctions.has(oldFunction)) {
+        return;
+    }
+    warnedFunctions.add(oldFunction);
+    writeWarning(`[journalism-google] ${oldFunction}() is deprecated. Use ${replacement} instead. It may be removed in the next major release.`);
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"inBucket.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/inBucket.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAA8B,QAAQ,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/openSpreadsheet.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Opens a Google spreadsheet and returns its loaded representation. When the
+ * URL identifies a specific tab with a `gid`, that ID is also returned as
+ * `sheetId`; otherwise, `sheetId` is undefined.
+ *
+ * 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.
+ * The service account must have access to the spreadsheet.
+ *
+ * To learn what you can do with the returned `spreadsheet`, refer to the
+ * `node-google-spreadsheet` documentation:
+ * [https://theoephraim.github.io/node-google-spreadsheet/#/](https://theoephraim.github.io/node-google-spreadsheet/#/).
+ *
+ * @param spreadsheetUrl A Google Sheets URL. It may identify a spreadsheet or
+ * a specific tab.
+ * @param options Controls authentication. The standard Google environment
+ * variables are used when omitted.
+ * @param options.credentials Explicit Google service-account credentials.
+ * @param options.apiEmail Name of the environment variable containing the
+ * service-account email. Defaults to `GOOGLE_SERVICE_ACCOUNT_EMAIL`.
+ * @param options.apiKey Name of the environment variable containing the
+ * service-account private key. Defaults to `GOOGLE_PRIVATE_KEY`.
+ * @returns The loaded spreadsheet and the tab ID found in the URL, if any.
+ *
+ * @example Open a spreadsheet using credentials from the environment.
+ * ```ts
+ * const { spreadsheet } = await openSpreadsheet(spreadsheetUrl);
+ * console.log(spreadsheet.title);
+ * ```
+ *
+ * @example Open a spreadsheet with explicit credentials.
+ * ```ts
+ * const { spreadsheet } = await openSpreadsheet(spreadsheetUrl, {
+ *   credentials: {
+ *     email: "service-account@project.iam.gserviceaccount.com",
+ *     privateKey: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
+ *   },
+ * });
+ * ```
+ *
+ * @example Access the tab selected by a URL containing a `gid`.
+ * ```ts
+ * const { spreadsheet, sheetId } = await openSpreadsheet(sheetUrl);
+ * const sheet = sheetId === undefined
+ *   ? spreadsheet.sheetsByIndex[0]
+ *   : spreadsheet.sheetsById[sheetId];
+ * ```
+ *
+ * @category Google
+ */
+export default function openSpreadsheet(spreadsheetUrl: string, options?: {
+    credentials?: {
+        email: string;
+        privateKey: string;
+    };
+    apiEmail?: string;
+    apiKey?: string;
+}): Promise<{
+    spreadsheet: InstanceType<(typeof import("google-spreadsheet"))["GoogleSpreadsheet"]>;
+    sheetId?: number;
+}>;
+//# sourceMappingURL=openSpreadsheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openSpreadsheet.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/openSpreadsheet.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAA8B,eAAe,CAC3C,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC;IACT,WAAW,EAAE,YAAY,CACvB,CAAC,cAAc,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAC3D,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CA4CD"}

package/esm/deps/jsr.io/@nshiab/journalism-google/1.1.2/src/google/openSpreadsheet.js

@@ -0,0 +1,93 @@
+import process from "node:process";
+import { existsSync, readFileSync } from "node:fs";
+import { JWT } from "google-auth-library";
+import { GoogleSpreadsheet } from "google-spreadsheet";
+import parseSheetUrl from "./helpers/parseSheetUrl.js";
+/**
+ * Opens a Google spreadsheet and returns its loaded representation. When the
+ * URL identifies a specific tab with a `gid`, that ID is also returned as
+ * `sheetId`; otherwise, `sheetId` is undefined.
+ *
+ * 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.
+ * The service account must have access to the spreadsheet.
+ *
+ * To learn what you can do with the returned `spreadsheet`, refer to the
+ * `node-google-spreadsheet` documentation:
+ * [https://theoephraim.github.io/node-google-spreadsheet/#/](https://theoephraim.github.io/node-google-spreadsheet/#/).
+ *
+ * @param spreadsheetUrl A Google Sheets URL. It may identify a spreadsheet or
+ * a specific tab.
+ * @param options Controls authentication. The standard Google environment
+ * variables are used when omitted.
+ * @param options.credentials Explicit Google service-account credentials.
+ * @param options.apiEmail Name of the environment variable containing the
+ * service-account email. Defaults to `GOOGLE_SERVICE_ACCOUNT_EMAIL`.
+ * @param options.apiKey Name of the environment variable containing the
+ * service-account private key. Defaults to `GOOGLE_PRIVATE_KEY`.
+ * @returns The loaded spreadsheet and the tab ID found in the URL, if any.
+ *
+ * @example Open a spreadsheet using credentials from the environment.
+ * ```ts
+ * const { spreadsheet } = await openSpreadsheet(spreadsheetUrl);
+ * console.log(spreadsheet.title);
+ * ```
+ *
+ * @example Open a spreadsheet with explicit credentials.
+ * ```ts
+ * const { spreadsheet } = await openSpreadsheet(spreadsheetUrl, {
+ *   credentials: {
+ *     email: "service-account@project.iam.gserviceaccount.com",
+ *     privateKey: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
+ *   },
+ * });
+ * ```
+ *
+ * @example Access the tab selected by a URL containing a `gid`.
+ * ```ts
+ * const { spreadsheet, sheetId } = await openSpreadsheet(sheetUrl);
+ * const sheet = sheetId === undefined
+ *   ? spreadsheet.sheetsByIndex[0]
+ *   : spreadsheet.sheetsById[sheetId];
+ * ```
+ *
+ * @category Google
+ */
+export default async function openSpreadsheet(spreadsheetUrl, options = {}) {
+    const { spreadsheetId, sheetId } = parseSheetUrl(spreadsheetUrl);
+    let email;
+    let privateKey;
+    if (options.credentials !== undefined) {
+        email = options.credentials.email;
+        privateKey = options.credentials.privateKey;
+    }
+    else if (process.env.GOOGLE_APPLICATION_CREDENTIALS !== undefined &&
+        process.env.GOOGLE_APPLICATION_CREDENTIALS !== "" &&
+        existsSync(process.env.GOOGLE_APPLICATION_CREDENTIALS)) {
+        const credentials = JSON.parse(readFileSync(process.env.GOOGLE_APPLICATION_CREDENTIALS, "utf-8"));
+        email = credentials.client_email;
+        privateKey = credentials.private_key;
+    }
+    else {
+        const emailVariable = options.apiEmail ?? "GOOGLE_SERVICE_ACCOUNT_EMAIL";
+        const keyVariable = options.apiKey ?? "GOOGLE_PRIVATE_KEY";
+        email = process.env[emailVariable];
+        privateKey = process.env[keyVariable];
+    }
+    if (email === undefined || email === "") {
+        throw new Error("Google service account email is undefined or empty.");
+    }
+    if (privateKey === undefined || privateKey === "") {
+        throw new Error("Google service account private key is undefined or empty.");
+    }
+    const jwt = new JWT({
+        email,
+        key: privateKey,
+        scopes: ["https://www.googleapis.com/auth/spreadsheets"],
+    });
+    const spreadsheet = new GoogleSpreadsheet(spreadsheetId, jwt);
+    await spreadsheet.loadInfo();
+    return { spreadsheet, sheetId };
+}