@juppytt/fws 0.1.0

package/test/calendar.test.ts

@@ -0,0 +1,227 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { createTestHarness, type TestHarness } from './helpers/harness.js';
+
+describe('Calendar', () => {
+  let h: TestHarness;
+
+  beforeAll(async () => {
+    h = await createTestHarness();
+  });
+
+  afterAll(async () => {
+    await h.cleanup();
+  });
+
+  describe('calendarList', () => {
+    it('lists primary calendar', async () => {
+      const res = await h.fetch('/calendar/v3/users/me/calendarList');
+      const data = await res.json();
+      expect(data.items.length).toBeGreaterThan(0);
+      expect(data.items.some((c: any) => c.primary)).toBe(true);
+    });
+
+    it('lists via gws', async () => {
+      const { stdout, exitCode } = await h.gws('calendar calendarList list');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.items.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('calendars', () => {
+    it('creates a calendar', async () => {
+      const res = await h.fetch('/calendar/v3/calendars', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ summary: 'Work Calendar' }),
+      });
+      const cal = await res.json();
+      expect(cal.summary).toBe('Work Calendar');
+      expect(cal.id).toBeTruthy();
+    });
+
+    it('gets calendar by id', async () => {
+      const listRes = await h.fetch('/calendar/v3/users/me/calendarList');
+      const list = await listRes.json();
+      const calId = list.items[0].id;
+
+      const res = await h.fetch(`/calendar/v3/calendars/${calId}`);
+      const cal = await res.json();
+      expect(cal.id).toBe(calId);
+    });
+
+    it('patches calendar summary', async () => {
+      // Create then patch
+      const createRes = await h.fetch('/calendar/v3/calendars', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ summary: 'Old Name' }),
+      });
+      const cal = await createRes.json();
+
+      const patchRes = await h.fetch(`/calendar/v3/calendars/${cal.id}`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ summary: 'New Name' }),
+      });
+      const patched = await patchRes.json();
+      expect(patched.summary).toBe('New Name');
+    });
+
+    it('deletes calendar and its events', async () => {
+      const createRes = await h.fetch('/calendar/v3/calendars', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ summary: 'Delete Me' }),
+      });
+      const cal = await createRes.json();
+
+      const delRes = await h.fetch(`/calendar/v3/calendars/${cal.id}`, { method: 'DELETE' });
+      expect(delRes.status).toBe(204);
+
+      const getRes = await h.fetch(`/calendar/v3/calendars/${cal.id}`);
+      expect(getRes.status).toBe(404);
+    });
+  });
+
+  describe('events', () => {
+    it('lists seed events on primary calendar', async () => {
+      const res = await h.fetch('/calendar/v3/calendars/primary/events');
+      const data = await res.json();
+      expect(data.items.length).toBe(4);
+      expect(data.items.some((e: any) => e.id === 'evt001')).toBe(true);
+    });
+
+    it('lists events via gws', async () => {
+      const { stdout, exitCode } = await h.gws('calendar events list --params {"calendarId":"primary"}');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.items).toBeDefined();
+    });
+
+    it('creates an event', async () => {
+      const res = await h.fetch('/calendar/v3/calendars/primary/events', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'Team Meeting',
+          start: { dateTime: '2026-04-08T09:00:00Z' },
+          end: { dateTime: '2026-04-08T10:00:00Z' },
+        }),
+      });
+      const event = await res.json();
+      expect(event.summary).toBe('Team Meeting');
+      expect(event.id).toBeTruthy();
+    });
+
+    it('gets event by id', async () => {
+      // Create first
+      const createRes = await h.fetch('/calendar/v3/calendars/primary/events', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'Get Test',
+          start: { dateTime: '2026-04-09T14:00:00Z' },
+          end: { dateTime: '2026-04-09T15:00:00Z' },
+        }),
+      });
+      const event = await createRes.json();
+
+      const getRes = await h.fetch(`/calendar/v3/calendars/primary/events/${event.id}`);
+      const got = await getRes.json();
+      expect(got.summary).toBe('Get Test');
+    });
+
+    it('patches event', async () => {
+      const createRes = await h.fetch('/calendar/v3/calendars/primary/events', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'Before Patch',
+          start: { dateTime: '2026-04-10T10:00:00Z' },
+          end: { dateTime: '2026-04-10T11:00:00Z' },
+        }),
+      });
+      const event = await createRes.json();
+
+      const patchRes = await h.fetch(`/calendar/v3/calendars/primary/events/${event.id}`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ summary: 'After Patch' }),
+      });
+      const patched = await patchRes.json();
+      expect(patched.summary).toBe('After Patch');
+    });
+
+    it('deletes event', async () => {
+      const createRes = await h.fetch('/calendar/v3/calendars/primary/events', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'Delete Event',
+          start: { dateTime: '2026-04-11T10:00:00Z' },
+          end: { dateTime: '2026-04-11T11:00:00Z' },
+        }),
+      });
+      const event = await createRes.json();
+
+      const delRes = await h.fetch(`/calendar/v3/calendars/primary/events/${event.id}`, { method: 'DELETE' });
+      expect(delRes.status).toBe(204);
+    });
+
+    it('filters events by timeMin/timeMax', async () => {
+      // Add events at different times
+      await h.fetch('/calendar/v3/calendars/primary/events', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'Early Event',
+          start: { dateTime: '2026-01-01T10:00:00Z' },
+          end: { dateTime: '2026-01-01T11:00:00Z' },
+        }),
+      });
+      await h.fetch('/calendar/v3/calendars/primary/events', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'Late Event',
+          start: { dateTime: '2026-12-01T10:00:00Z' },
+          end: { dateTime: '2026-12-01T11:00:00Z' },
+        }),
+      });
+
+      // Query with timeMin that excludes Early
+      const res = await h.fetch('/calendar/v3/calendars/primary/events?timeMin=2026-06-01T00:00:00Z');
+      const data = await res.json();
+      const summaries = data.items.map((e: any) => e.summary);
+      expect(summaries).toContain('Late Event');
+      expect(summaries).not.toContain('Early Event');
+    });
+
+    it('searches events by q', async () => {
+      const res = await h.fetch('/calendar/v3/calendars/primary/events?q=Team');
+      const data = await res.json();
+      expect(data.items.some((e: any) => e.summary?.includes('Team'))).toBe(true);
+    });
+
+    it('creates and lists event via gws roundtrip', async () => {
+      // Setup event via control endpoint
+      const setup = await h.fetch('/__fws/setup/calendar/event', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          summary: 'GWS Roundtrip Event',
+          start: '2026-05-01T09:00:00Z',
+          duration: '1h',
+        }),
+      });
+      const { id } = await setup.json();
+
+      // List via gws
+      const { stdout, exitCode } = await h.gws('calendar events list --params {"calendarId":"primary"}');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.items.some((e: any) => e.id === id)).toBe(true);
+    });
+  });
+});

package/test/drive.test.ts

@@ -0,0 +1,153 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { createTestHarness, type TestHarness } from './helpers/harness.js';
+
+describe('Drive', () => {
+  let h: TestHarness;
+
+  beforeAll(async () => {
+    h = await createTestHarness();
+  });
+
+  afterAll(async () => {
+    await h.cleanup();
+  });
+
+  describe('about', () => {
+    it('returns about info', async () => {
+      const res = await h.fetch('/drive/v3/about?fields=*');
+      const data = await res.json();
+      expect(data.kind).toBe('drive#about');
+      expect(data.user.emailAddress).toBe('testuser@example.com');
+    });
+
+    it('returns about via gws', async () => {
+      const { stdout, exitCode } = await h.gws('drive about get --params {"fields":"*"}');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.kind).toBe('drive#about');
+    });
+  });
+
+  describe('files', () => {
+    it('lists seed files initially', async () => {
+      const res = await h.fetch('/drive/v3/files');
+      const data = await res.json();
+      expect(data.files.length).toBe(5);
+      expect(data.files.some((f: any) => f.id === 'file001')).toBe(true);
+    });
+
+    it('creates a file', async () => {
+      const res = await h.fetch('/drive/v3/files', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'report.pdf', mimeType: 'application/pdf' }),
+      });
+      const file = await res.json();
+      expect(file.name).toBe('report.pdf');
+      expect(file.id).toBeTruthy();
+    });
+
+    it('gets file by id', async () => {
+      const createRes = await h.fetch('/drive/v3/files', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'get-test.txt', mimeType: 'text/plain' }),
+      });
+      const file = await createRes.json();
+
+      const getRes = await h.fetch(`/drive/v3/files/${file.id}`);
+      const got = await getRes.json();
+      expect(got.name).toBe('get-test.txt');
+    });
+
+    it('patches file name', async () => {
+      const createRes = await h.fetch('/drive/v3/files', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'old-name.txt' }),
+      });
+      const file = await createRes.json();
+
+      const patchRes = await h.fetch(`/drive/v3/files/${file.id}`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'new-name.txt' }),
+      });
+      const patched = await patchRes.json();
+      expect(patched.name).toBe('new-name.txt');
+    });
+
+    it('deletes a file', async () => {
+      const createRes = await h.fetch('/drive/v3/files', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'delete-me.txt' }),
+      });
+      const file = await createRes.json();
+
+      const delRes = await h.fetch(`/drive/v3/files/${file.id}`, { method: 'DELETE' });
+      expect(delRes.status).toBe(204);
+
+      const getRes = await h.fetch(`/drive/v3/files/${file.id}`);
+      expect(getRes.status).toBe(404);
+    });
+
+    it('copies a file', async () => {
+      const createRes = await h.fetch('/drive/v3/files', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'original.txt', mimeType: 'text/plain' }),
+      });
+      const original = await createRes.json();
+
+      const copyRes = await h.fetch(`/drive/v3/files/${original.id}/copy`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'copied.txt' }),
+      });
+      const copy = await copyRes.json();
+      expect(copy.name).toBe('copied.txt');
+      expect(copy.id).not.toBe(original.id);
+      expect(copy.mimeType).toBe('text/plain');
+    });
+
+    it('filters by q name contains', async () => {
+      const res = await h.fetch("/drive/v3/files?q=name%20contains%20'report'");
+      const data = await res.json();
+      expect(data.files.every((f: any) => f.name.toLowerCase().includes('report'))).toBe(true);
+    });
+
+    it('filters by q mimeType', async () => {
+      const res = await h.fetch("/drive/v3/files?q=mimeType%20%3D%20'application/pdf'");
+      const data = await res.json();
+      expect(data.files.every((f: any) => f.mimeType === 'application/pdf')).toBe(true);
+    });
+
+    it('creates and lists file via gws roundtrip', async () => {
+      // Setup via control endpoint
+      const setup = await h.fetch('/__fws/setup/drive/file', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'gws-test.pdf', mimeType: 'application/pdf' }),
+      });
+      const { id } = await setup.json();
+
+      // List via gws
+      const { stdout, exitCode } = await h.gws('drive files list');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.files.some((f: any) => f.id === id)).toBe(true);
+    });
+
+    it('gets file via gws', async () => {
+      const listRes = await h.fetch('/drive/v3/files');
+      const list = await listRes.json();
+      const fileId = list.files[0].id;
+
+      const { stdout, exitCode } = await h.gws(`drive files get --params {"fileId":"${fileId}"}`);
+      expect(exitCode).toBe(0);
+      const file = JSON.parse(stdout);
+      expect(file.id).toBe(fileId);
+    });
+  });
+});

package/test/gmail.test.ts

@@ -0,0 +1,215 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { createTestHarness, type TestHarness } from './helpers/harness.js';
+
+describe('Gmail', () => {
+  let h: TestHarness;
+
+  beforeAll(async () => {
+    h = await createTestHarness();
+  });
+
+  afterAll(async () => {
+    await h.cleanup();
+  });
+
+  describe('profile', () => {
+    it('returns test user profile via HTTP', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/profile');
+      const data = await res.json();
+      expect(data.emailAddress).toBe('testuser@example.com');
+    });
+
+    it('returns profile via gws', async () => {
+      const { stdout, exitCode } = await h.gws('gmail users getProfile --params {"userId":"me"}');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.emailAddress).toBe('testuser@example.com');
+    });
+  });
+
+  describe('labels', () => {
+    it('lists system labels', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/labels');
+      const data = await res.json();
+      expect(data.labels.length).toBeGreaterThanOrEqual(8);
+      expect(data.labels.map((l: any) => l.id)).toContain('INBOX');
+    });
+
+    it('lists labels via gws', async () => {
+      const { stdout, exitCode } = await h.gws('gmail users labels list --params {"userId":"me"}');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.labels).toBeDefined();
+      expect(data.labels.map((l: any) => l.id)).toContain('INBOX');
+    });
+
+    it('creates a user label', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/labels', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name: 'TestLabel' }),
+      });
+      const data = await res.json();
+      expect(data.name).toBe('TestLabel');
+      expect(data.type).toBe('user');
+      expect(data.id).toBeTruthy();
+    });
+
+    it('refuses to delete system labels', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/labels/INBOX', { method: 'DELETE' });
+      expect(res.status).toBe(400);
+    });
+  });
+
+  describe('messages', () => {
+    it('lists seed messages initially', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/messages');
+      const data = await res.json();
+      expect(data.messages.length).toBe(5);
+      expect(data.messages.some((m: any) => m.id === 'msg001')).toBe(true);
+    });
+
+    it('setup adds a message then list returns it', async () => {
+      // Add via setup endpoint
+      const setup = await h.fetch('/__fws/setup/gmail/message', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          from: 'alice@example.com',
+          subject: 'Hello from Alice',
+          body: 'Test body content',
+          labels: ['INBOX', 'UNREAD'],
+        }),
+      });
+      const { id } = await setup.json();
+      expect(id).toBeTruthy();
+
+      // List via gws
+      const { stdout, exitCode } = await h.gws('gmail users messages list --params {"userId":"me"}');
+      expect(exitCode).toBe(0);
+      const data = JSON.parse(stdout);
+      expect(data.messages.length).toBeGreaterThan(0);
+      expect(data.messages.some((m: any) => m.id === id)).toBe(true);
+    });
+
+    it('gets message with full format', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/messages');
+      const list = await res.json();
+      const msgId = list.messages[0].id;
+
+      const res2 = await h.fetch(`/gmail/v1/users/me/messages/${msgId}`);
+      const msg = await res2.json();
+      expect(msg.id).toBe(msgId);
+      expect(msg.payload).toBeDefined();
+      expect(msg.payload.headers).toBeDefined();
+    });
+
+    it('gets message via gws', async () => {
+      const listRes = await h.fetch('/gmail/v1/users/me/messages');
+      const list = await listRes.json();
+      const msgId = list.messages[0].id;
+
+      const { stdout, exitCode } = await h.gws(`gmail users messages get --params {"userId":"me","id":"${msgId}"}`);
+      expect(exitCode).toBe(0);
+      const msg = JSON.parse(stdout);
+      expect(msg.id).toBe(msgId);
+    });
+
+    it('sends a message', async () => {
+      const raw = Buffer.from(
+        'From: testuser@example.com\r\nTo: bob@example.com\r\nSubject: Test Send\r\n\r\nHello Bob'
+      ).toString('base64url');
+
+      const res = await h.fetch('/gmail/v1/users/me/messages/send', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ raw }),
+      });
+      const data = await res.json();
+      expect(data.id).toBeTruthy();
+      expect(data.labelIds).toContain('SENT');
+    });
+
+    it('trashes and untrashes a message', async () => {
+      // Setup a message
+      const setup = await h.fetch('/__fws/setup/gmail/message', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ from: 'trash-test@example.com', subject: 'Trash me', body: 'x' }),
+      });
+      const { id } = await setup.json();
+
+      // Trash it
+      const trashRes = await h.fetch(`/gmail/v1/users/me/messages/${id}/trash`, { method: 'POST' });
+      const trashed = await trashRes.json();
+      expect(trashed.labelIds).toContain('TRASH');
+      expect(trashed.labelIds).not.toContain('INBOX');
+
+      // Untrash it
+      const untrashRes = await h.fetch(`/gmail/v1/users/me/messages/${id}/untrash`, { method: 'POST' });
+      const untrashed = await untrashRes.json();
+      expect(untrashed.labelIds).toContain('INBOX');
+      expect(untrashed.labelIds).not.toContain('TRASH');
+    });
+
+    it('modifies message labels', async () => {
+      const setup = await h.fetch('/__fws/setup/gmail/message', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ from: 'modify@example.com', subject: 'Modify', body: 'x', labels: ['INBOX', 'UNREAD'] }),
+      });
+      const { id } = await setup.json();
+
+      const res = await h.fetch(`/gmail/v1/users/me/messages/${id}/modify`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ addLabelIds: ['STARRED'], removeLabelIds: ['UNREAD'] }),
+      });
+      const msg = await res.json();
+      expect(msg.labelIds).toContain('STARRED');
+      expect(msg.labelIds).not.toContain('UNREAD');
+    });
+
+    it('deletes a message', async () => {
+      const setup = await h.fetch('/__fws/setup/gmail/message', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ from: 'del@example.com', subject: 'Delete me', body: 'x' }),
+      });
+      const { id } = await setup.json();
+
+      const res = await h.fetch(`/gmail/v1/users/me/messages/${id}`, { method: 'DELETE' });
+      expect(res.status).toBe(204);
+
+      // Verify gone
+      const getRes = await h.fetch(`/gmail/v1/users/me/messages/${id}`);
+      expect(getRes.status).toBe(404);
+    });
+
+    it('filters by q=from:alice', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/messages?q=from:alice');
+      const data = await res.json();
+      // At least the alice message from earlier
+      expect(data.messages.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('threads', () => {
+    it('lists threads', async () => {
+      const res = await h.fetch('/gmail/v1/users/me/threads');
+      const data = await res.json();
+      expect(data.threads.length).toBeGreaterThan(0);
+    });
+
+    it('gets a thread by id', async () => {
+      const listRes = await h.fetch('/gmail/v1/users/me/threads');
+      const list = await listRes.json();
+      const threadId = list.threads[0].id;
+
+      const res = await h.fetch(`/gmail/v1/users/me/threads/${threadId}`);
+      const thread = await res.json();
+      expect(thread.id).toBe(threadId);
+      expect(thread.messages.length).toBeGreaterThan(0);
+    });
+  });
+});