@robert.tools/google 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 robert.tools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @robert.tools/google
+
+A package to access Google Workspace
+
+## Installation
+
+```bash
+npm install @robert.tools/google
+```
+
+## Usage
+
+```typescript
+
+```

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 🎯 parse the Google Visualization JSONP response
+ * @param {string} text the JSONP response text
+ * @returns {object} the parsed JSON object
+ */
+export declare const parseGoogleVisualizationJson: (text: string) => any;
+/**
+ * 🎯 get the value of a cell, handling null and undefined values
+ * @param {*} cell the cell object
+ * @returns {string} the cell value
+ */
+export declare const getCellValue: (cell: any) => any;
+export declare const rowToValues: (row: any) => any;
+export declare const detectColumnsFromHeader: (rows: any[]) => {
+    keyColumn: number;
+    contextColumn: number;
+};
+export declare const extractSheetData: (sheetJson: any) => {
+    matchers: {
+        key: string;
+        context: any;
+    }[];
+    keyColumn: number;
+    contextColumn: number;
+};
+export declare const getSheetData: (id: string, tab: string) => any;

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSheetData = exports.extractSheetData = exports.detectColumnsFromHeader = exports.rowToValues = exports.getCellValue = exports.parseGoogleVisualizationJson = void 0;
+const cmd_1 = require("@robert.tools/cmd");
+const convert_1 = require("@robert.tools/convert");
+const SHEET_URL = 'https://docs.google.com/spreadsheets/d/{id}/gviz/tq?tqx=out:json&sheet={tab}';
+/**
+ * 🎯 parse the Google Visualization JSONP response
+ * @param {string} text the JSONP response text
+ * @returns {object} the parsed JSON object
+ */
+const parseGoogleVisualizationJson = (text) => {
+    const match = String(text || '').match(/google\.visualization\.Query\.setResponse\((.*)\);?\s*$/s);
+    if (!match) {
+        throw new Error('Could not parse Google Sheets response');
+    }
+    return JSON.parse(match[1]);
+};
+exports.parseGoogleVisualizationJson = parseGoogleVisualizationJson;
+/**
+ * 🎯 get the value of a cell, handling null and undefined values
+ * @param {*} cell the cell object
+ * @returns {string} the cell value
+ */
+const getCellValue = (cell) => {
+    return cell?.v ?? '';
+};
+exports.getCellValue = getCellValue;
+const rowToValues = (row) => {
+    return (row?.c || []).map((cell) => String((0, exports.getCellValue)(cell) || '').trim());
+};
+exports.rowToValues = rowToValues;
+const detectColumnsFromHeader = (rows) => {
+    const firstRow = rows[0];
+    const values = (0, exports.rowToValues)(firstRow);
+    let keyColumn = -1;
+    let contextColumn = -1;
+    for (let index = 0; index < values.length; index += 1) {
+        const normalized = (0, convert_1.normalizeText)(values[index]);
+        if (normalized === 'key') {
+            keyColumn = index;
+        }
+        if (normalized === 'kontext') {
+            contextColumn = index;
+        }
+    }
+    return { keyColumn, contextColumn };
+};
+exports.detectColumnsFromHeader = detectColumnsFromHeader;
+const extractSheetData = (sheetJson) => {
+    const rows = sheetJson?.table?.rows || [];
+    const { keyColumn, contextColumn } = (0, exports.detectColumnsFromHeader)(rows);
+    if (keyColumn === -1 || contextColumn === -1) {
+        throw new Error('Could not detect KEY and Kontext columns from sheet header');
+    }
+    const matchers = [];
+    for (const row of rows.slice(1)) {
+        const values = (0, exports.rowToValues)(row);
+        const key = values[keyColumn] || '';
+        const context = values[contextColumn] || '';
+        if (!key || !context) {
+            continue;
+        }
+        matchers.push({
+            key: (0, convert_1.normalizeText)(key),
+            context,
+        });
+    }
+    return { matchers, keyColumn, contextColumn };
+};
+exports.extractSheetData = extractSheetData;
+const getSheetData = (id, tab) => {
+    const googleSheetUrl = SHEET_URL.replace('{id}', id).replace('{tab}', tab);
+    const text = (0, cmd_1.command)(`curl -s "${googleSheetUrl}"`);
+    return (0, exports.parseGoogleVisualizationJson)(text);
+};
+exports.getSheetData = getSheetData;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+    "name": "@robert.tools/google",
+    "version": "1.0.1",
+    "description": "A package to access Google Workspace",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": "./dist/index.js"
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "test": "jest --coverage --runInBand --verbose",
+        "lint": "eslint .",
+        "check": "npm run lint && npm test && npm run build",
+        "prepublishOnly": "npm run check"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/robert-tools/google.git"
+    },
+    "bugs": {
+        "url": "https://github.com/robert-tools/google/issues"
+    },
+    "homepage": "https://github.com/robert-tools/google#readme",
+    "keywords": [
+        "typescript",
+        "node",
+        "google",
+        "robert.tools"
+    ],
+    "author": "Robert Willemelis",
+    "license": "MIT",
+    "engines": {
+        "node": ">=22"
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    },
+    "devDependencies": {
+        "@types/jest": "^29.5.14",
+        "@types/node": "^24.0.0",
+        "@typescript-eslint/eslint-plugin": "^8.0.0",
+        "@typescript-eslint/parser": "^8.0.0",
+        "eslint": "^9.0.0",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-prettier": "^5.5.6",
+        "jest": "^29.7.0",
+        "jest-environment-jsdom": "^29.6.2",
+        "ts-jest": "^29.4.0",
+        "typescript": "^5.9.0"
+    },
+    "dependencies": {
+        "@robert.tools/cmd": "^1.0.0",
+        "@robert.tools/convert": "^1.0.0"
+    }
+}