@theholocron/google-client 1.32.0 → 1.33.0

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { JWT, OAuth2Client } from "google-auth-library";
+//#region ../../../../../src/types.d.ts
+type Return<T> = [Error, null, number] | [null, T, number];
+//#endregion
+//#region ../../../../../src/authentication.d.ts
+declare const oauth: (scopes: string[]) => Promise<OAuth2Client | null>;
+declare function googleAuth(scopes: string[]): Promise<JWT>;
+//#endregion
+//#region ../../../../../src/index.d.ts
+declare const google: {
+  documents: {
+    get: (id: string) => Promise<Return<import("googleapis").docs_v1.Schema$Document>>;
+  };
+  spreadsheets: {
+    get: (id: string) => Promise<Return<import("googleapis").sheets_v4.Schema$Spreadsheet>>;
+  };
+};
+//#endregion
+export { type Return, google, googleAuth, oauth };

package/dist/index.mjs

@@ -0,0 +1,144 @@
+import { google as google$1 } from "googleapis";
+import http from "node:http";
+import url from "node:url";
+import open from "open";
+import destroyer from "server-destroy";
+//#region ../../../../../src/key.ts
+/**
+* Load service account credentials from environment variables.
+* Set GOOGLE_SERVICE_ACCOUNT_JSON to the full JSON key file content,
+* or set individual GOOGLE_* variables for each field.
+*/
+function loadServiceAccountKey() {
+	const raw = process.env.GOOGLE_SERVICE_ACCOUNT_JSON;
+	if (raw) return JSON.parse(raw);
+	for (const key of [
+		"GOOGLE_TYPE",
+		"GOOGLE_PROJECT_ID",
+		"GOOGLE_PRIVATE_KEY_ID",
+		"GOOGLE_PRIVATE_KEY",
+		"GOOGLE_CLIENT_EMAIL",
+		"GOOGLE_CLIENT_ID"
+	]) if (!process.env[key]) throw new Error(`Missing required environment variable: ${key}`);
+	return {
+		type: process.env.GOOGLE_TYPE,
+		project_id: process.env.GOOGLE_PROJECT_ID,
+		private_key_id: process.env.GOOGLE_PRIVATE_KEY_ID,
+		private_key: process.env.GOOGLE_PRIVATE_KEY.replace(/\\n/g, "\n"),
+		client_email: process.env.GOOGLE_CLIENT_EMAIL,
+		client_id: process.env.GOOGLE_CLIENT_ID,
+		auth_uri: "https://accounts.google.com/o/oauth2/auth",
+		token_uri: "https://oauth2.googleapis.com/token",
+		auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs",
+		client_x509_cert_url: `https://www.googleapis.com/robot/v1/metadata/x509/${encodeURIComponent(process.env.GOOGLE_CLIENT_EMAIL)}`,
+		universe_domain: "googleapis.com"
+	};
+}
+//#endregion
+//#region ../../../../../src/authentication.ts
+function buildOAuth2Client() {
+	const clientID = process.env.GOOGLE_CLIENT_ID;
+	const clientSecret = process.env.GOOGLE_CLIENT_SECRET;
+	const redirectURI = process.env.GOOGLE_REDIRECT_URI ?? "http://localhost:4000/oauth2callback";
+	if (!clientID || !clientSecret) throw new Error("GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET environment variables are required for OAuth");
+	return new google$1.auth.OAuth2(clientID, clientSecret, redirectURI);
+}
+const oauth = async (scopes) => {
+	const oauth2Client = buildOAuth2Client();
+	const port = parseInt(process.env.GOOGLE_REDIRECT_PORT ?? "4000", 10);
+	return new Promise((resolve, reject) => {
+		const authorizeUrl = oauth2Client.generateAuthUrl({
+			access_type: "offline",
+			scope: scopes.join(" ")
+		});
+		const server = http.createServer(async (req, res) => {
+			try {
+				if (req.url && req.url.indexOf("/oauth2callback") > -1) {
+					const qs = new url.URL(req.url, `http://localhost:${port}`).searchParams;
+					res.end("Authentication successful! Please return to the console.");
+					server.destroy();
+					const { tokens } = await oauth2Client.getToken(qs.get("code") ?? "");
+					oauth2Client.credentials = tokens;
+					resolve(oauth2Client);
+				}
+			} catch (e) {
+				reject(e);
+			}
+		}).listen(port, () => {
+			open(authorizeUrl, { wait: false }).then((cp) => cp.unref());
+		});
+		destroyer(server);
+	});
+};
+async function googleAuth(scopes) {
+	return await new google$1.auth.GoogleAuth({
+		credentials: loadServiceAccountKey(),
+		scopes
+	}).getClient();
+}
+//#endregion
+//#region ../../../../../src/documents.ts
+const docs = google$1.docs("v1");
+async function getDocument(id) {
+	if (!id) return [
+		/* @__PURE__ */ new Error("No ID was provided!"),
+		null,
+		0
+	];
+	const start = performance.now();
+	const authClient = await googleAuth(["https://www.googleapis.com/auth/documents.readonly"]);
+	try {
+		return [
+			null,
+			(await docs.documents.get({
+				auth: authClient,
+				documentId: id
+			})).data,
+			performance.now() - start
+		];
+	} catch (error) {
+		return [
+			error,
+			null,
+			performance.now() - start
+		];
+	}
+}
+const documents = { get: getDocument };
+//#endregion
+//#region ../../../../../src/spreadsheets.ts
+const sheets = google$1.sheets("v4");
+async function getSpreadsheet(id) {
+	if (!id) return [
+		/* @__PURE__ */ new Error("No ID was provided!"),
+		null,
+		0
+	];
+	const start = performance.now();
+	const authClient = await googleAuth(["https://www.googleapis.com/auth/spreadsheets.readonly"]);
+	try {
+		return [
+			null,
+			(await sheets.spreadsheets.get({
+				auth: authClient,
+				spreadsheetId: id,
+				includeGridData: true
+			})).data,
+			performance.now() - start
+		];
+	} catch (error) {
+		return [
+			error,
+			null,
+			performance.now() - start
+		];
+	}
+}
+//#endregion
+//#region ../../../../../src/index.ts
+const google = {
+	documents,
+	spreadsheets: { get: getSpreadsheet }
+};
+//#endregion
+export { google, googleAuth, oauth };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/google-client",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "description": "A TypeScript client for Google Workspace APIs (Docs, Sheets)",
   "keywords": [
     "google",
@@ -41,7 +41,7 @@
     "@theholocron/cli": "5.0.0-alpha.79",
     "@theholocron/eslint-config": "^8.4.3",
     "@theholocron/tsconfig": "^8.2.0",
-    "@theholocron/tsdown-config": "^8.5.2",
+    "@theholocron/tsdown-config": "^8.6.1",
     "@theholocron/vitest-config": "^8.2.0",
     "@types/node": "^26.4.1",
     "@types/server-destroy": "^1.0.4",