gworkspace 0.2.1

package/src/commands/gmail.ts

@@ -0,0 +1,80 @@
+import { google } from 'googleapis';
+import { optNumber, optString } from '../lib/args.js';
+import { fail, output } from '../lib/io.js';
+import type { AnyRecord, Options } from '../lib/types.js';
+
+function formatGmailDate(d: Date): string {
+  const year = d.getFullYear();
+  const month = `${d.getMonth() + 1}`.padStart(2, '0');
+  const day = `${d.getDate()}`.padStart(2, '0');
+  return `${year}/${month}/${day}`;
+}
+
+function getTodayGmailQuery(): string {
+  const start = new Date();
+  start.setHours(0, 0, 0, 0);
+  const end = new Date(start);
+  end.setDate(end.getDate() + 1);
+  return `after:${formatGmailDate(start)} before:${formatGmailDate(end)}`;
+}
+
+export async function commandGmailSearch(auth: any, options: Options) {
+  const gmail = google.gmail({ version: 'v1', auth });
+  const max = Math.max(1, Math.min(optNumber(options, 'max', 20), 100));
+  const baseQuery = optString(options, 'query') || '';
+  const useToday = options.today === true;
+  const query = useToday ? `${baseQuery} ${getTodayGmailQuery()}`.trim() : baseQuery;
+
+  const res = await gmail.users.messages.list({
+    userId: 'me',
+    q: query,
+    maxResults: max,
+    pageToken: optString(options, 'pageToken'),
+  });
+
+  const messages = res.data.messages || [];
+  output({
+    ok: true,
+    action: 'gmail.search',
+    today: useToday,
+    query,
+    count: messages.length,
+    nextPageToken: res.data.nextPageToken || null,
+    messages: messages.map((m: AnyRecord) => ({ id: m.id, threadId: m.threadId })),
+  });
+}
+
+export async function commandGmailGet(auth: any, options: Options) {
+  const id = optString(options, 'id');
+  if (!id) fail('Missing required --id for gmail get.');
+
+  const gmail = google.gmail({ version: 'v1', auth });
+  const res = await gmail.users.messages.get({
+    userId: 'me',
+    id,
+    format: 'metadata',
+    metadataHeaders: ['From', 'To', 'Subject', 'Date'],
+  });
+
+  const headers = res.data.payload?.headers || [];
+  const map = headers.reduce<Record<string, string>>((acc, h: AnyRecord) => {
+    if (h.name && h.value) acc[h.name.toLowerCase()] = h.value;
+    return acc;
+  }, {});
+
+  output({
+    ok: true,
+    action: 'gmail.get',
+    message: {
+      id: res.data.id,
+      threadId: res.data.threadId,
+      labelIds: res.data.labelIds || [],
+      snippet: res.data.snippet || '',
+      subject: map.subject || '',
+      from: map.from || '',
+      to: map.to || '',
+      date: map.date || '',
+      internalDate: res.data.internalDate || null,
+    },
+  });
+}

package/src/commands/time.ts

@@ -0,0 +1,34 @@
+import { output } from '../lib/io.js';
+
+export function commandTimeNow() {
+  const now = new Date();
+  const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  output({
+    ok: true,
+    action: 'time.now',
+    utc: now.toISOString(),
+    localDate: now.toLocaleDateString('en-CA', { timeZone }),
+    localTime: now.toLocaleTimeString('en-GB', { hour12: false, timeZone }),
+    timeZone,
+  });
+}
+
+export function commandTimeDate() {
+  const now = new Date();
+  const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  output({
+    ok: true,
+    action: 'time.date',
+    utc: now.toISOString().slice(0, 10),
+    local: now.toLocaleDateString('en-CA', { timeZone }),
+    timeZone,
+  });
+}
+
+export function commandTimeZone() {
+  output({
+    ok: true,
+    action: 'time.zone',
+    timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+  });
+}

package/src/config.ts

@@ -0,0 +1,32 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import type { Options } from './lib/types.js';
+import { optString } from './lib/args.js';
+
+export const SCOPES = [
+  'https://www.googleapis.com/auth/calendar.readonly',
+  'https://www.googleapis.com/auth/gmail.readonly',
+  'https://www.googleapis.com/auth/drive.readonly',
+  'https://www.googleapis.com/auth/chat.spaces.readonly',
+  'https://www.googleapis.com/auth/chat.messages.readonly',
+];
+
+export const CONFIG_DIR =
+  process.env.GWORKSPACE_CONFIG_DIR ||
+  path.join(os.homedir(), '.config', 'gworkspace');
+
+export const TOKEN_PATH = path.join(CONFIG_DIR, 'token.json');
+
+export const CREDENTIALS_PATH =
+  process.env.GOOGLE_OAUTH_CREDENTIALS ||
+  path.join(CONFIG_DIR, 'credentials.json');
+
+export function ensureConfigDir() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+}
+
+export function resolveCredentialsPath(options: Options): string {
+  const fromOption = optString(options, 'credentials');
+  return fromOption ? path.resolve(fromOption) : CREDENTIALS_PATH;
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { runCli } from './cli.js';
+import { fail } from './lib/io.js';
+
+runCli(process.argv.slice(2)).catch((error: unknown) => {
+  const msg = error instanceof Error ? error.message : String(error);
+  fail('Command failed.', msg);
+});

package/src/lib/args.ts

@@ -0,0 +1,73 @@
+import type { Options, Primitive } from './types.js';
+
+export function parseArgs(argv: string[]) {
+  const positional: string[] = [];
+  const options: Options = {};
+
+  const setOpt = (key: string, value: Primitive) => {
+    const current = options[key];
+    if (current === undefined) {
+      options[key] = value;
+      return;
+    }
+    if (Array.isArray(current)) {
+      options[key] = [...current, value];
+      return;
+    }
+    options[key] = [current, value];
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (!token) continue;
+
+    if (token === '--') {
+      positional.push(...argv.slice(i + 1));
+      break;
+    }
+
+    if (token === '-h') {
+      setOpt('help', true);
+      setOpt('h', true);
+      continue;
+    }
+
+    if (!token.startsWith('--')) {
+      positional.push(token);
+      continue;
+    }
+
+    const eq = token.indexOf('=');
+    if (eq > 2) {
+      setOpt(token.slice(2, eq), token.slice(eq + 1));
+      continue;
+    }
+
+    const key = token.slice(2);
+    const next = argv[i + 1];
+    if (!next || next.startsWith('--')) {
+      setOpt(key, true);
+      continue;
+    }
+
+    setOpt(key, next);
+    i += 1;
+  }
+
+  return { positional, options };
+}
+
+export function optString(options: Options, key: string): string | undefined {
+  const value = options[key];
+  if (value === undefined || typeof value === 'boolean') return undefined;
+  if (Array.isArray(value)) return String(value[value.length - 1]);
+  return String(value);
+}
+
+export function optNumber(options: Options, key: string, fallback: number): number {
+  const raw = optString(options, key);
+  if (!raw) return fallback;
+  const parsed = Number.parseInt(raw, 10);
+  if (Number.isNaN(parsed)) return fallback;
+  return parsed;
+}

package/src/lib/io.ts

@@ -0,0 +1,17 @@
+import type { JsonObject } from './types.js';
+
+export function output(payload: JsonObject, code = 0): never {
+  process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+  process.exit(code);
+}
+
+export function fail(message: string, details?: unknown): never {
+  output(
+    {
+      ok: false,
+      error: message,
+      details: details ?? null,
+    },
+    1,
+  );
+}

package/src/lib/types.ts

@@ -0,0 +1,5 @@
+export type Primitive = string | boolean;
+export type OptValue = Primitive | Primitive[];
+export type Options = Record<string, OptValue>;
+export type JsonObject = Record<string, unknown>;
+export type AnyRecord = Record<string, any>;

package/src/usage.ts

@@ -0,0 +1,104 @@
+import { CREDENTIALS_PATH, TOKEN_PATH } from './config.js';
+
+type Domain = {
+  summary: string;
+  commands: string[];
+};
+
+const HELP: Record<string, Domain> = {
+  auth: {
+    summary: 'Authenticate gw with Google Workspace',
+    commands: [
+      'gw auth login [--credentials path/to/credentials.json] [--no-open]',
+      'gw auth status',
+      'gw auth logout',
+    ],
+  },
+  calendar: {
+    summary: 'Read calendar events',
+    commands: [
+      'gw calendar list --from <ISO> --to <ISO> [--calendarId primary] [--max 20]',
+      'gw calendar list today [--calendarId primary] [--max 20]',
+      'gw calendar_getEvents --timeMin <ISO> --timeMax <ISO> [--calendarId primary]',
+    ],
+  },
+  gmail: {
+    summary: 'Search and read Gmail messages',
+    commands: [
+      'gw gmail search --query "newer_than:7d" [--max 20]',
+      'gw gmail list today [--max 20]',
+      'gw gmail get --id <messageId>',
+      'gw gmail_search --query "..." --max 20',
+    ],
+  },
+  drive: {
+    summary: 'Search and inspect Drive files',
+    commands: [
+      'gw drive search --query "trashed = false" [--max 20]',
+      'gw drive recent [--max 20]',
+      'gw drive get --id <fileId>',
+      'gw drive_search --query "..." --max 20',
+    ],
+  },
+  chat: {
+    summary: 'Read Google Chat spaces and messages',
+    commands: [
+      'gw chat spaces [--max 20] [--filter "spaceType = SPACE"]',
+      'gw chat messages --space spaces/<spaceId> [--max 20]',
+      'gw chat list today --space spaces/<spaceId> [--max 20]',
+    ],
+  },
+  time: {
+    summary: 'Print local time context',
+    commands: ['gw time now', 'gw time date', 'gw time zone'],
+  },
+};
+
+function printText(text: string): never {
+  process.stdout.write(`${text}\n`);
+  process.exit(0);
+}
+
+export function usage(topic?: string): never {
+  const normalized = topic?.trim().toLowerCase();
+  const selected = normalized ? HELP[normalized] : undefined;
+  if (selected) {
+    const topicName = normalized as string;
+    const commands = selected.commands.map((line) => `  ${line}`).join('\n');
+    printText(
+      [
+        `${topicName.toUpperCase()} COMMANDS`,
+        commands,
+        '',
+        'LEARN MORE',
+        `  Use \`gw ${topicName} --help\` for command usage.`,
+      ].join('\n'),
+    );
+  }
+
+  const core = Object.entries(HELP)
+    .map(([name, def]) => `  ${name.padEnd(14)}${def.summary}`)
+    .join('\n');
+
+  printText(
+    [
+      'Work seamlessly with Google Workspace from the command line.',
+      '',
+      'USAGE',
+      '  gw <command> <subcommand> [flags]',
+      '',
+      'CORE COMMANDS',
+      core,
+      '',
+      'FLAGS',
+      '  --help    Show help for command',
+      '',
+      'CONFIG FILES',
+      `  credentials: ${CREDENTIALS_PATH}`,
+      `  token:       ${TOKEN_PATH}`,
+      '',
+      'LEARN MORE',
+      '  Use `gw <command> --help` for more information about a command.',
+    ].join('\n'),
+  );
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["node"],
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"]
+}