connectai/src/features/calendar/tasksApi.ts

/**
 * Google Tasks API v1 — task create 호출.
 *
 * Calendar / Sheets 와 같은 OAuth 토큰을 공유한다 (scope 에 `tasks` 포함).
 * Tasks 는 date-only 모델(시간 없음)이라 /meet 의 액션 아이템처럼 "시간 없이
 * 마감일만 있는 할 일" 에 자연스럽게 맞는다.
 *
 * 외부 라이브러리 안 씀 — Tasks API 도 REST 라 native fetch 면 충분.
 */

import * as vscode from 'vscode';
import { getFreshAccessToken } from './calendarApi';

const API_BASE = 'https://tasks.googleapis.com/tasks/v1';

export interface TaskInput {
    /** 작업 제목 (필수). */
    title: string;
    /**
     * 마감일 'YYYY-MM-DD' — Google Tasks 는 시간 무시, 날짜만 사용.
     * 생략 시 *날짜 없는* task 로 등록 (조건부 task: 선행 작업 완료 시 진행, D-Day 없음).
     */
    due?: string;
    /** 메모 (옵션) — Tasks UI 에서 작업 본문 아래 노트로 표시. */
    notes?: string;
    /**
     * 작업이 들어갈 task list ID. default `@default` — 기본 list ("내 할 일").
     * 사용자가 별도 list 를 만들었으면 그 ID 를 넣으면 됨.
     */
    taskListId?: string;
}

export interface CreatedTask {
    /** Google 이 발급한 task id. */
    id: string;
    title: string;
    due?: string;
    /** Google Tasks API 의 self link (API 용). 사용자용 deep link 는 별도로 없음. */
    selfLink?: string;
}

/**
 * Google Tasks 에 작업 생성. config 에 refresh token 있어야 함. access token 자동 갱신.
 *
 * 사용자가 Tasks 스코프 미동의(예전 OAuth 만 한 사용자) 면 Google 이 401/403 으로
 * 거부 → `error` 에 그 메시지가 친화적 형태로 전달되고, 사용자는 OAuth 재연결 안내를 본다.
 *
 * 반환값:
 *   ok: true → CreatedTask
 *   ok: false → 에러 메시지 (UI 표시용)
 */
export async function createTask(
    context: vscode.ExtensionContext,
    input: TaskInput,
): Promise<{ ok: true; task: CreatedTask } | { ok: false; error: string }> {
    if (!input.title?.trim()) return { ok: false, error: 'title 비어 있음' };
    if (input.due !== undefined && !/^\d{4}-\d{2}-\d{2}$/.test(input.due)) {
        return { ok: false, error: `due 는 'YYYY-MM-DD' 형식이어야 함 (받은 값: ${input.due})` };
    }

    const tokenResult = await getFreshAccessToken(context);
    if (!tokenResult.ok) return { ok: false, error: tokenResult.error };

    const taskListId = (input.taskListId || '@default').trim() || '@default';
    const url = `${API_BASE}/lists/${encodeURIComponent(taskListId)}/tasks`;
    const body = {
        title: input.title.trim(),
        // Tasks API 의 `due` 는 RFC3339 timestamp 인데 시간 부분은 서버에서 무시되고
        // 날짜만 사용. UTC midnight 으로 보내는 게 표준 패턴. due 생략 = 날짜 없는 task.
        ...(input.due ? { due: `${input.due}T00:00:00.000Z` } : {}),
        ...(input.notes ? { notes: input.notes } : {}),
    };

    try {
        const res = await fetch(url, {
            method: 'POST',
            headers: {
                Authorization: `Bearer ${tokenResult.accessToken}`,
                'Content-Type': 'application/json',
            },
            body: JSON.stringify(body),
            signal: AbortSignal.timeout(15000),
        });
        const json: any = await res.json().catch(() => ({}));
        if (!res.ok) {
            const msg: string = json?.error?.message || `HTTP ${res.status}`;
            // 스코프/권한 부족이면 사용자 친화 안내로 변환 — 어떤 명령을 다시 실행해야 하는지 명시.
            if (res.status === 401 || res.status === 403 || /insufficient|scope|disabled|enable/i.test(msg)) {
                return {
                    ok: false,
                    error: `Tasks API 권한 부족 — "Astra: Google Calendar OAuth 연결 (쓰기)" 명령을 다시 실행해 Tasks 스코프 동의가 필요합니다. (Google Cloud Console 에서 Tasks API 활성화도 함께 확인) 원인: ${msg}`,
                };
            }
            return { ok: false, error: msg };
        }
        return {
            ok: true,
            task: {
                id: json.id,
                title: json.title,
                due: input.due,
                selfLink: json.selfLink,
            },
        };
    } catch (e: any) {
        return { ok: false, error: e?.message || String(e) };
    }
}

export interface ListedTask {
    id: string;
    title: string;
    status: 'needsAction' | 'completed';
    /** 'YYYY-MM-DD' 형식. due 가 없는 task 는 undefined. */
    due?: string;
    /** 완료 시각 ISO timestamp. status 'completed' 일 때만 있음. */
    completed?: string;
    notes?: string;
}

/**
 * Google Tasks 목록 조회 — /onesie 1:1 카드 등에서 멤버별 필터링용.
 *
 * 기본 default list 의 task 들을 가져온다 (완료 포함). 호출자가 클라이언트 측에서
 * 제목 prefix `[멤버]` 나 notes 의 `@멤버` / `담당: 멤버` 패턴으로 필터하면 됨.
 */
export async function listTasks(
    context: vscode.ExtensionContext,
    options: { taskListId?: string; showCompleted?: boolean; maxResults?: number } = {},
): Promise<{ ok: true; tasks: ListedTask[] } | { ok: false; error: string }> {
    const tokenResult = await getFreshAccessToken(context);
    if (!tokenResult.ok) return { ok: false, error: tokenResult.error };

    const taskListId = (options.taskListId || '@default').trim() || '@default';
    const params = new URLSearchParams({
        maxResults: String(options.maxResults ?? 100),
        showCompleted: options.showCompleted !== false ? 'true' : 'false',
        showHidden: 'true', // 완료 후 숨김 처리된 것도 포함 — 1:1 회고에 최근 완료가 중요.
    });
    const url = `${API_BASE}/lists/${encodeURIComponent(taskListId)}/tasks?${params.toString()}`;

    try {
        const res = await fetch(url, {
            method: 'GET',
            headers: { Authorization: `Bearer ${tokenResult.accessToken}` },
            signal: AbortSignal.timeout(15000),
        });
        const json: any = await res.json().catch(() => ({}));
        if (!res.ok) {
            const msg: string = json?.error?.message || `HTTP ${res.status}`;
            if (res.status === 401 || res.status === 403 || /insufficient|scope/i.test(msg)) {
                return {
                    ok: false,
                    error: `Tasks API 권한 부족 — "Astra: Google Calendar OAuth 연결 (쓰기)" 명령 재실행 + Tasks 스코프 동의 필요. (원인: ${msg})`,
                };
            }
            return { ok: false, error: msg };
        }
        const items: any[] = Array.isArray(json.items) ? json.items : [];
        const tasks: ListedTask[] = items.map((item: any) => ({
            id: String(item.id || ''),
            title: String(item.title || ''),
            status: item.status === 'completed' ? 'completed' : 'needsAction',
            due: typeof item.due === 'string' ? item.due.slice(0, 10) : undefined,
            completed: typeof item.completed === 'string' ? item.completed : undefined,
            notes: typeof item.notes === 'string' ? item.notes : undefined,
        }));
        return { ok: true, tasks };
    } catch (e: any) {
        return { ok: false, error: e?.message || String(e) };
    }
}