gcal-service 1.1.0

package/gcal-service.js

@@ -0,0 +1,188 @@
+// just-gcal.js
+import { google } from 'googleapis';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+/**
+ * Simple Google Calendar client using Service Account (read-only by default)
+ */
+class JustGcal {
+  #calendar = null;
+  #initialized = false;
+
+  constructor({
+    keyFile = path.join(process.cwd(), 'service-account.json'),
+    scopes = ['https://www.googleapis.com/auth/calendar.readonly'],
+    calendarId = 'primary',
+  } = {}) {
+    this.keyFile = keyFile;
+    this.scopes = scopes;
+    this.calendarId = calendarId;
+  }
+
+  async initialize() {
+    if (this.#initialized) return;
+
+    try {
+      const keyContent = await fs.readFile(this.keyFile, 'utf8');
+      const credentials = JSON.parse(keyContent);
+
+      const auth = new google.auth.GoogleAuth({
+        credentials,
+        scopes: this.scopes,
+      });
+
+      const client = await auth.getClient();
+      this.#calendar = google.calendar({ version: 'v3', auth: client });
+
+      this.#initialized = true;
+    } catch (err) {
+      throw new Error(`JustGcal init failed: ${err.message}`);
+    }
+  }
+
+  get calendar() {
+    if (!this.#initialized) {
+      throw new Error('JustGcal not initialized. Call .initialize() or use a method first.');
+    }
+    return this.#calendar;
+  }
+
+  /**
+   * Fetch upcoming events (from now onward)
+   * @param {Object} options
+   * @param {number} [options.max=50]
+   * @param {Date|string} [options.timeMin]    - defaults to now
+   * @param {Date|string} [options.timeMax]
+   * @param {boolean} [options.singleEvents=true]
+   * @param {string} [options.orderBy='startTime']
+   */
+  async listUpcoming({
+    max = 10,
+    timeMin = new Date(),
+    timeMax,
+    singleEvents = true,
+    orderBy = 'startTime',
+  } = {}) {
+    await this.initialize();
+
+    const params = {
+      calendarId: this.calendarId,
+      timeMin: timeMin instanceof Date ? timeMin.toISOString() : timeMin,
+      maxResults: max,
+      singleEvents,
+      orderBy,
+    };
+
+    if (timeMax) params.timeMax = timeMax instanceof Date ? timeMax.toISOString() : timeMax;
+
+    const res = await this.#calendar.events.list(params);
+    return res.data.items || [];
+  }
+
+  async printUpcoming(max = 10) {
+    try {
+      const events = await this.listUpcoming({ max });
+      if (events.length === 0) {
+        console.log('No upcoming events.');
+        return;
+      }
+      console.log(`\nNext ${events.length} event${events.length === 1 ? '' : 's'}:`);
+      events.forEach((e, i) => {
+        const start = e.start?.dateTime || e.start?.date || '—';
+        const title = e.summary || '(untitled)';
+        console.log(`${i + 1}. ${start}  ${title}`);
+      });
+    } catch (err) {
+      console.error('Error:', err.message);
+    }
+  }
+
+  /**
+   * Fetch all events that occur (at least partially) on a given day
+   * @param {Date|string} date - Date to query (can be Date object or ISO string YYYY-MM-DD)
+   * @param {Object} [options]
+   * @param {number} [options.max=100] - safety limit
+   * @returns {Promise<Array<import('googleapis').calendar_v3.Schema$Event>>}
+   */
+  async listEventsForDay(date, { max = 50 } = {}) {
+    await this.initialize();
+
+    const target = typeof date === 'string' ? new Date(date) : date;
+    if (isNaN(target)) throw new Error('Invalid date format');
+
+    // Start of day (00:00:00 local time)
+    const startOfDay = new Date(target);
+    startOfDay.setHours(0, 0, 0, 0);
+
+    // End of day (23:59:59.999 local time)
+    const endOfDay = new Date(startOfDay);
+    endOfDay.setDate(endOfDay.getDate() + 1);
+    endOfDay.setMilliseconds(-1);
+
+    const res = await this.#calendar.events.list({
+      calendarId: this.calendarId,
+      timeMin: startOfDay.toISOString(),
+      timeMax: endOfDay.toISOString(),
+      singleEvents: true,
+      orderBy: 'startTime',
+      maxResults: max,
+    });
+
+    return res.data.items || [];
+  }
+
+  /**
+   * Print events for a specific day in a readable format
+   * @param {Date|string} date
+   */
+  async printEventsForDay(date) {
+    try {
+      const events = await this.listEventsForDay(date);
+
+      const dateStr = (typeof date === 'string' ? new Date(date) : date)
+        .toLocaleDateString('en-SG', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' });
+
+      if (events.length === 0) {
+        console.log(`\nNo events on ${dateStr}`);
+        return;
+      }
+
+      console.log(`\nEvents on ${dateStr} (${events.length}):`);
+      events.forEach((e, i) => {
+        let timeStr = 'All day';
+
+        if (e.start.dateTime) {
+          const start = new Date(e.start.dateTime);
+          const end = e.end.dateTime ? new Date(e.end.dateTime) : null;
+          timeStr = start.toLocaleTimeString('en-SG', { hour: 'numeric', minute: '2-digit', hour12: true });
+          if (end) {
+            timeStr += ` – ${end.toLocaleTimeString('en-SG', { hour: 'numeric', minute: '2-digit', hour12: true })}`;
+          }
+        }
+
+        const title = e.summary || '(untitled)';
+        console.log(`${i + 1}. ${timeStr}  ${title}`);
+      });
+    } catch (err) {
+      console.error('Error fetching day events:', err.message);
+    }
+  }
+
+  static async quickShow(calendarId = 'primary', max = 50) {
+    const gcal = new JustGcal({ calendarId });
+    await gcal.printUpcoming(max);
+  }
+
+  /**
+   * Quick helper: show events for one day
+   * @param {Date|string} date
+   * @param {string} [calendarId='primary']
+   */
+  static async quickShowDay(date, calendarId = 'primary') {
+    const gcal = new JustGcal({ calendarId });
+    await gcal.printEventsForDay(date);
+  }
+}
+
+export { JustGcal };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "gcal-service",
+  "version": "1.1.0",
+  "description": "Minimal Google Calendar client using service account – list upcoming events, day-specific events, read-only by default",
+  "main": "./gcal-service.js",
+  "type": "module",
+  "exports": {
+    "default": "./gcal-service.js"
+  },
+  "files": [
+    "gcal-service.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "google-calendar",
+    "gcal",
+    "calendar",
+    "events",
+    "googleapis",
+    "service-account",
+	"gcal-service"
+  ],
+  "author": "Dan <littlejustnode@gmail.com>[](https://github.com/littlejustnode)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/littlejustnode/gcal-service.git"
+  },
+  "bugs": {
+    "url": "https://github.com/littlejustnode/gcal-service/issues"
+  },
+  "homepage": "https://github.com/littlejustnode/gcal-service#readme",
+  "dependencies": {
+    "googleapis": "^144.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}