elizaos--eliza/plugins/plugin-calendar/test/google-event-parser.test.ts

/**
 * External-API contract test for the plugin-owned Google -> LifeOps parser.
 *
 * `lifeOpsCalendarEventFromGoogle` / `lifeOpsCalendarAttendeeFromGoogle` /
 * `lifeOpsCalendarSummaryFromGoogle` (src/internal/google-delegates.ts) are the
 * genuine external-API boundary for the calendar view's data: they map the
 * `GoogleCalendarEvent` / `GoogleCalendarListEntry` shapes produced by
 * `@elizaos/plugin-google`'s `mapEvent` / list mapper (over the googleapis
 * `calendar_v3` JSON) into the `LifeOpsCalendarEvent` / `LifeOpsCalendarSummary`
 * the CalendarSection feed renders.
 *
 * The fixtures below are hand-built to match the EXACT shape `mapEvent` emits
 * (verified against plugins/plugin-google/src/calendar.ts `mapEvent`, ~205-243,
 * and `mapCalendarListEntry`, ~186-203):
 *   - timed event: start/end are ISO `new Date(dateTime).toISOString()` strings,
 *     `isAllDay: false`, `timeZone` populated, `htmlLink`, `meetLink` (from
 *     `hangoutLink` or `conferenceData.entryPoints[0].uri`), `attendees` mapped
 *     to `{ email, name? }`, `organizer` `{ email, name?, self }`, and a
 *     `metadata` object with `iCalUID`/`recurringEventId`/`createdAt`/`updatedAt`.
 *   - all-day event: `start`/`end` are `new Date("YYYY-MM-DDT00:00:00.000Z")`
 *     ISO strings, `isAllDay: true`.
 *   - minimal event: only `id`/`calendarId` (every other field undefined), to
 *     exercise the parser's `(untitled)` / `confirmed` / `false` / `null`
 *     defaults.
 *
 * This validates the parser against the real provider shape entirely within
 * plugin-calendar (no @elizaos/agent / connector graph needed).
 */

import type {
  GoogleCalendarEvent,
  GoogleCalendarListEntry,
} from "@elizaos/plugin-google";
import type { LifeOpsConnectorGrant } from "@elizaos/shared";
import { describe, expect, it } from "vitest";

import {
  lifeOpsCalendarEventFromGoogle,
  lifeOpsCalendarSummaryFromGoogle,
} from "../src/internal/google-delegates.js";

const AGENT_ID = "agent-7";

const ownerGrant: LifeOpsConnectorGrant = {
  id: "connector-account:acct-123",
  agentId: AGENT_ID,
  provider: "google",
  connectorAccountId: "acct-123",
  side: "owner",
  identity: { email: "owner@example.com" },
  identityEmail: "owner@example.com",
  grantedScopes: ["https://www.googleapis.com/auth/calendar.events"],
  capabilities: ["google.calendar.read", "google.calendar.write"],
  tokenRef: null,
  mode: "local",
  executionTarget: "local",
  sourceOfTruth: "connector_account",
  preferredByAgent: true,
  cloudConnectionId: null,
  metadata: {},
  lastRefreshAt: "2026-06-16T00:00:00.000Z",
  createdAt: "2026-06-01T00:00:00.000Z",
  updatedAt: "2026-06-16T00:00:00.000Z",
};

// Shape produced by plugin-google `mapEvent` for a normal timed event.
const timedGoogleEvent: GoogleCalendarEvent = {
  id: "evt_abc123",
  calendarId: "owner@example.com",
  title: "Design sync",
  status: "confirmed",
  start: new Date("2026-06-17T15:00:00.000Z").toISOString(),
  end: new Date("2026-06-17T16:00:00.000Z").toISOString(),
  isAllDay: false,
  timeZone: "America/New_York",
  htmlLink: "https://www.google.com/calendar/event?eid=evt_abc123",
  meetLink: "https://meet.google.com/abc-defg-hij",
  attendees: [
    { email: "owner@example.com", name: "Owner Person" },
    { email: "guest@elsewhere.com", name: "Guest" },
  ],
  location: "Room 4B",
  description: "Weekly design review",
  organizer: { email: "owner@example.com", name: "Owner Person", self: true },
  metadata: {
    iCalUID: "evt_abc123@google.com",
    recurringEventId: null,
    createdAt: "2026-06-10T09:00:00.000Z",
    updatedAt: "2026-06-15T12:00:00.000Z",
  },
};

// Shape produced by `mapEvent` for an all-day event (date-only start/end).
const allDayGoogleEvent: GoogleCalendarEvent = {
  id: "evt_holiday",
  calendarId: "owner@example.com",
  title: "Company holiday",
  status: "confirmed",
  start: new Date("2026-07-04T00:00:00.000Z").toISOString(),
  end: new Date("2026-07-05T00:00:00.000Z").toISOString(),
  isAllDay: true,
  timeZone: "America/New_York",
  htmlLink: "https://www.google.com/calendar/event?eid=evt_holiday",
  attendees: [],
  metadata: {
    iCalUID: "evt_holiday@google.com",
    recurringEventId: null,
    createdAt: null,
    updatedAt: null,
  },
};

// Minimal shape — `mapEvent` only guarantees id + calendarId; everything else
// can be undefined (e.g. a cancelled or sparse event row).
const minimalGoogleEvent: GoogleCalendarEvent = {
  id: "evt_min",
  calendarId: "primary",
};

describe("lifeOpsCalendarEventFromGoogle (Google -> LifeOps contract)", () => {
  it("maps a timed event to a contract-valid LifeOpsCalendarEvent", () => {
    const result = lifeOpsCalendarEventFromGoogle({
      event: timedGoogleEvent,
      grant: ownerGrant,
      agentId: AGENT_ID,
      syncedAt: "2026-06-16T08:00:00.000Z",
    });

    expect(result.id).toBe(
      "agent-7:google:owner:calendar:owner@example.com:evt_abc123",
    );
    expect(result.externalId).toBe("evt_abc123");
    expect(result.agentId).toBe(AGENT_ID);
    expect(result.provider).toBe("google");
    expect(result.side).toBe("owner");
    expect(result.calendarId).toBe("owner@example.com");
    expect(result.title).toBe("Design sync");
    expect(result.description).toBe("Weekly design review");
    expect(result.location).toBe("Room 4B");
    expect(result.status).toBe("confirmed");
    expect(result.startAt).toBe("2026-06-17T15:00:00.000Z");
    expect(result.endAt).toBe("2026-06-17T16:00:00.000Z");
    expect(result.isAllDay).toBe(false);
    expect(result.timezone).toBe("America/New_York");
    expect(result.htmlLink).toBe(
      "https://www.google.com/calendar/event?eid=evt_abc123",
    );
    // conferenceLink is sourced from the Google `meetLink` field.
    expect(result.conferenceLink).toBe("https://meet.google.com/abc-defg-hij");
    expect(result.organizer).toEqual({
      email: "owner@example.com",
      name: "Owner Person",
      self: true,
    });

    // attendees mapped to the LifeOps attendee shape (response/self/organizer
    // default false/null because Google's summary projection omits them).
    expect(result.attendees).toEqual([
      {
        email: "owner@example.com",
        displayName: "Owner Person",
        responseStatus: null,
        self: false,
        organizer: false,
        optional: false,
      },
      {
        email: "guest@elsewhere.com",
        displayName: "Guest",
        responseStatus: null,
        self: false,
        organizer: false,
        optional: false,
      },
    ]);

    // metadata is merged with googlePlugin:true plus the Google metadata block.
    expect(result.metadata.googlePlugin).toBe(true);
    expect(result.metadata.iCalUID).toBe("evt_abc123@google.com");
    expect(result.metadata.updatedAt).toBe("2026-06-15T12:00:00.000Z");

    expect(result.syncedAt).toBe("2026-06-16T08:00:00.000Z");
    expect(result.updatedAt).toBe("2026-06-16T08:00:00.000Z");
    expect(result.connectorAccountId).toBe("acct-123");
    expect(result.grantId).toBe("connector-account:acct-123");
    expect(result.accountEmail).toBe("owner@example.com");
  });

  it("maps an all-day event preserving date-only bounds and isAllDay", () => {
    const result = lifeOpsCalendarEventFromGoogle({
      event: allDayGoogleEvent,
      grant: ownerGrant,
      agentId: AGENT_ID,
      syncedAt: "2026-06-16T08:00:00.000Z",
    });

    expect(result.isAllDay).toBe(true);
    expect(result.startAt).toBe("2026-07-04T00:00:00.000Z");
    expect(result.endAt).toBe("2026-07-05T00:00:00.000Z");
    expect(result.title).toBe("Company holiday");
    // No conference / no attendees for this event.
    expect(result.conferenceLink).toBeNull();
    expect(result.attendees).toEqual([]);
  });

  it("applies (untitled)/confirmed/false/null defaults for a minimal event", () => {
    const result = lifeOpsCalendarEventFromGoogle({
      event: minimalGoogleEvent,
      grant: ownerGrant,
      agentId: AGENT_ID,
      syncedAt: "2026-06-16T08:00:00.000Z",
    });

    expect(result.title).toBe("(untitled)");
    expect(result.description).toBe("");
    expect(result.location).toBe("");
    expect(result.status).toBe("confirmed");
    expect(result.isAllDay).toBe(false);
    expect(result.timezone).toBeNull();
    expect(result.htmlLink).toBeNull();
    expect(result.conferenceLink).toBeNull();
    expect(result.organizer).toBeNull();
    expect(result.attendees).toEqual([]);
    // start falls back to syncedAt, end falls back to start when absent.
    expect(result.startAt).toBe("2026-06-16T08:00:00.000Z");
    expect(result.endAt).toBe("2026-06-16T08:00:00.000Z");
    expect(result.id).toBe("agent-7:google:owner:calendar:primary:evt_min");
  });
});

describe("lifeOpsCalendarSummaryFromGoogle (calendar list contract)", () => {
  const listEntry: GoogleCalendarListEntry = {
    calendarId: "owner@example.com",
    summary: "Owner Person",
    description: "Primary calendar",
    primary: true,
    accessRole: "owner",
    backgroundColor: "#0b8043",
    foregroundColor: "#ffffff",
    timeZone: "America/New_York",
    selected: true,
  };

  it("maps a calendar list entry to a LifeOpsCalendarSummary with feed defaults", () => {
    const summary = lifeOpsCalendarSummaryFromGoogle({
      entry: listEntry,
      grant: ownerGrant,
    });

    expect(summary).toEqual({
      provider: "google",
      side: "owner",
      grantId: "connector-account:acct-123",
      accountEmail: "owner@example.com",
      calendarId: "owner@example.com",
      summary: "Owner Person",
      description: "Primary calendar",
      primary: true,
      accessRole: "owner",
      backgroundColor: "#0b8043",
      foregroundColor: "#ffffff",
      timeZone: "America/New_York",
      selected: true,
      // includeInFeed defaults to true (opt-out, never opt-in).
      includeInFeed: true,
    });
  });

  it("honors an explicit includeInFeed=false override", () => {
    const summary = lifeOpsCalendarSummaryFromGoogle({
      entry: listEntry,
      grant: ownerGrant,
      includeInFeed: false,
    });
    expect(summary.includeInFeed).toBe(false);
  });
});