SurfSense/surfsense_web/tests/helpers/canary.ts

import { randomUUID } from "node:crypto";

/**
 * Canary tokens & deterministic test data.
 *
 * Embedded by the backend Composio fake into fake Drive file contents
 * (see surfsense_backend/tests/e2e/fakes/fixtures/drive_files.json).
 * Specs assert these strings appear in the resulting Document rows to
 * prove the indexing pipeline ran end-to-end.
 *
 * Each token is a stable string keyed by file id so multi-test runs
 * remain deterministic and the resulting Document.content is greppable
 * in failure traces.
 */
export const CANARY_TOKENS = {
	driveCanaryFile: "SURFSENSE_E2E_CANARY_TOKEN_DRIVE_001",
	drivePdfCanary: "SURFSENSE_E2E_CANARY_TOKEN_DRIVE_PDF_001",
	composioDrivePdfCanary: "SURFSENSE_E2E_CANARY_TOKEN_COMPOSIO_DRIVE_PDF_001",
	driveReadme: "SURFSENSE_E2E_README_MARKER",
	driveBudget: "SURFSENSE_E2E_BUDGET_MARKER",
	driveRoadmap: "SURFSENSE_E2E_ROADMAP_MARKER",
	driveArchive: "SURFSENSE_E2E_ARCHIVE_MARKER",
	gmailCanary: "SURFSENSE_E2E_CANARY_TOKEN_GMAIL_001",
	calendarCanary: "SURFSENSE_E2E_CANARY_TOKEN_CALENDAR_001",
	onedriveCanary: "SURFSENSE_E2E_CANARY_TOKEN_ONEDRIVE_001",
	onedrivePdfCanary: "SURFSENSE_E2E_CANARY_TOKEN_ONEDRIVE_PDF_001",
	dropboxCanary: "SURFSENSE_E2E_CANARY_TOKEN_DROPBOX_001",
	dropboxPdfCanary: "SURFSENSE_E2E_CANARY_TOKEN_DROPBOX_PDF_001",
	notionCanary: "SURFSENSE_E2E_CANARY_TOKEN_NOTION_001",
	confluenceCanary: "SURFSENSE_E2E_CANARY_TOKEN_CONFLUENCE_001",
	linearCanary: "SURFSENSE_E2E_CANARY_TOKEN_LINEAR_001",
	jiraCanary: "SURFSENSE_E2E_CANARY_TOKEN_JIRA_001",
	slackCanary: "SURFSENSE_E2E_CANARY_TOKEN_SLACK_001",
	clickupCanary: "SURFSENSE_E2E_CANARY_TOKEN_CLICKUP_001",
	manualUploadMdCanary: "E2E-MANUAL-UPLOAD-MD-CANARY-7f3a",
	manualUploadPdfCanary: "E2E-MANUAL-UPLOAD-PDF-CANARY-9d2b",
} as const;

/**
 * Fake Drive file IDs that match what the backend fake returns from
 * GOOGLEDRIVE_LIST_FILES. Keep in sync with drive_files.json.
 */
export const FAKE_DRIVE_FILES = {
	canary: { id: "fake-file-canary", name: "e2e-canary.txt", mimeType: "text/plain" },
	pdfNative: {
		id: "fake-file-pdf-native",
		name: "e2e-canary.pdf",
		mimeType: "application/pdf",
	},
	pdfComposio: {
		id: "fake-file-pdf-composio",
		name: "e2e-composio-canary.pdf",
		mimeType: "application/pdf",
	},
	readme: { id: "fake-file-readme", name: "README.md", mimeType: "text/markdown" },
	budget: { id: "fake-file-budget", name: "Q1-Budget.csv", mimeType: "text/csv" },
} as const;

export const FAKE_DRIVE_FOLDERS = {
	projects: {
		id: "fake-folder-projects",
		name: "Projects",
		mimeType: "application/vnd.google-apps.folder",
	},
	archive: {
		id: "fake-folder-archive",
		name: "Archive",
		mimeType: "application/vnd.google-apps.folder",
	},
} as const;

/**
 * Fake OneDrive file IDs that match the Microsoft Graph-shaped backend
 * fake in onedrive_files.json.
 */
export const FAKE_ONEDRIVE_FILES = {
	canary: {
		id: "fake-onedrive-canary",
		name: "e2e-onedrive-canary.txt",
		mimeType: "text/plain",
	},
	pdf: {
		id: "fake-onedrive-pdf-canary",
		name: "e2e-onedrive-canary.pdf",
		mimeType: "application/pdf",
	},
} as const;

/**
 * Fake Dropbox file paths that match the Dropbox-shaped backend fake in
 * dropbox_files.json. Dropbox selected-file indexing accepts path_lower via id.
 */
export const FAKE_DROPBOX_FILES = {
	canary: {
		id: "/e2e-dropbox-canary.txt",
		name: "e2e-dropbox-canary.txt",
		mimeType: "text/plain",
	},
	pdf: {
		id: "/e2e-dropbox-canary.pdf",
		name: "e2e-dropbox-canary.pdf",
		mimeType: "application/pdf",
	},
} as const;

/**
 * Fake Gmail message IDs that match what the backend fake returns from
 * GMAIL_FETCH_EMAILS / GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID.
 */
export const FAKE_GMAIL_MESSAGES = {
	canary: {
		id: "fake-msg-canary-001",
		threadId: "fake-thread-canary-001",
		subject: "E2E Canary Email",
		from: "sender@surfsense.example",
		to: "e2e-fake@surfsense.example",
	},
	planning: {
		id: "fake-msg-planning-001",
		threadId: "fake-thread-planning-001",
		subject: "E2E Planning Notes",
		from: "planner@surfsense.example",
		to: "e2e-fake@surfsense.example",
	},
} as const;

/**
 * Fake Calendar event IDs that match what the backend fake returns from
 * GOOGLECALENDAR_EVENTS_LIST.
 */
export const FAKE_CALENDAR_EVENTS = {
	canary: {
		id: "fake-calendar-event-canary-001",
		summary: "E2E Canary Calendar Event",
		location: "SurfSense E2E Room",
	},
	planning: {
		id: "fake-calendar-event-planning-001",
		summary: "E2E Planning Sync",
		location: "SurfSense Planning Room",
	},
} as const;

/**
 * Fake Notion page IDs that match what the backend fake returns from
 * notion_client.AsyncClient.search.
 */
export const FAKE_NOTION_PAGES = {
	canary: {
		id: "fake-notion-page-canary-001",
		title: "E2E Canary Notion Page",
		workspaceId: "fake-notion-workspace-001",
		workspaceName: "SurfSense E2E Notion Workspace",
		botId: "fake-notion-bot-001",
	},
} as const;

/**
 * Fake Confluence page IDs that match what the backend fake returns from
 * ConfluenceHistoryConnector.get_pages_by_date_range.
 */
export const FAKE_CONFLUENCE_PAGES = {
	canary: {
		id: "fake-confluence-page-canary-001",
		title: "E2E Canary Confluence Page",
		spaceId: "fake-confluence-space-001",
		cloudId: "fake-confluence-cloud-001",
		baseUrl: "https://surfsense-e2e-confluence.atlassian.net",
	},
} as const;

/**
 * Fake Linear issue IDs that match what the backend MCP fake returns from
 * list_issues / get_issue.
 */
export const FAKE_LINEAR_ISSUES = {
	canary: {
		id: "fake-linear-issue-canary-001",
		identifier: "E2E-101",
		title: "E2E Canary Linear Issue",
		organizationName: "SurfSense E2E Linear Org",
		organizationUrlKey: "surfsense-e2e",
	},
} as const;

/**
 * Fake Jira issue IDs that match what the backend MCP fake returns from
 * searchJiraIssuesUsingJql.
 */
export const FAKE_JIRA_ISSUES = {
	canary: {
		id: "fake-jira-issue-canary-001",
		key: "E2E-101",
		summary: "E2E Canary Jira Issue",
		cloudId: "fake-jira-cloud-001",
		siteUrl: "https://surfsense-e2e.atlassian.net",
	},
} as const;

/**
 * Fake Slack channel IDs that match what the backend MCP fake returns from
 * slack_search_channels.
 */
export const FAKE_SLACK_CHANNELS = {
	canary: {
		id: "C_FAKE_SLACK_CANARY",
		name: "slack-e2e-canary",
		teamId: "T_FAKE_SLACK_TEAM",
		teamName: "SurfSense E2E Slack Workspace",
	},
} as const;

/**
 * Fake ClickUp task IDs that match what the backend MCP fake returns from
 * clickup_search / clickup_get_task.
 */
export const FAKE_CLICKUP_TASKS = {
	canary: {
		id: "fake-clickup-task-canary-001",
		name: "E2E Canary ClickUp Task",
		workspaceId: "fake-clickup-workspace-001",
		workspaceName: "SurfSense E2E ClickUp Workspace",
	},
} as const;

/** Generate a unique-per-run search space name. Keeps parallel tests isolated. */
export function uniqueSearchSpaceName(prefix = "e2e"): string {
	return `${prefix}-${randomUUID().slice(0, 8)}`;
}