@crimson-education/sdk 0.2.0

package/dist/core/missions.js

@@ -0,0 +1,140 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissionsApi = void 0;
+class MissionsApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List missions for a user.
+     * Without pagination params (start/limit), returns MissionsCategory[] (grouped by category).
+     * With pagination params, returns PaginatedResult<Mission> (flat list with pagination metadata).
+     */
+    list(userId, filters) {
+        var _a;
+        const params = new URLSearchParams({ userId });
+        if ((_a = filters === null || filters === void 0 ? void 0 : filters.status) === null || _a === void 0 ? void 0 : _a.length) {
+            params.append("status", filters.status.join(","));
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.title) {
+            params.append("title", filters.title);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.roadmapId) {
+            params.append("roadmapId", filters.roadmapId);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.groupBy) {
+            params.append("groupBy", filters.groupBy);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.dueDateStart) {
+            params.append("dueDateStart", filters.dueDateStart);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.dueDateEnd) {
+            params.append("dueDateEnd", filters.dueDateEnd);
+        }
+        if ((filters === null || filters === void 0 ? void 0 : filters.start) !== undefined) {
+            params.append("start", String(filters.start));
+        }
+        if ((filters === null || filters === void 0 ? void 0 : filters.limit) !== undefined) {
+            params.append("limit", String(filters.limit));
+        }
+        // When pagination params are provided, return paginated result
+        if ((filters === null || filters === void 0 ? void 0 : filters.start) !== undefined || (filters === null || filters === void 0 ? void 0 : filters.limit) !== undefined) {
+            return this.client.fetch(`/roadmap/missions?${params.toString()}`);
+        }
+        // Otherwise return category-grouped result (backward compatible)
+        return this.client.fetch(`/roadmap/missions?${params.toString()}`);
+    }
+    /**
+     * List missions with pagination (always returns flat list with pagination metadata)
+     * Handles both new paginated response and legacy category-grouped response
+     */
+    listPaginated(userId, filters, pagination) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const start = (_a = pagination === null || pagination === void 0 ? void 0 : pagination.start) !== null && _a !== void 0 ? _a : 0;
+            const limit = (_b = pagination === null || pagination === void 0 ? void 0 : pagination.limit) !== null && _b !== void 0 ? _b : 20;
+            const result = yield this.list(userId, Object.assign(Object.assign({}, filters), { start,
+                limit }));
+            // Check if result is already paginated format
+            if (result &&
+                typeof result === "object" &&
+                "pagination" in result &&
+                "data" in result) {
+                return result;
+            }
+            // Legacy format: MissionsCategory[] - convert to paginated format
+            // This happens when backend hasn't been updated yet
+            const categories = result;
+            const allMissions = categories.flatMap((cat) => cat.missions || []);
+            const paginatedMissions = allMissions.slice(start, start + limit);
+            return {
+                data: paginatedMissions,
+                pagination: {
+                    total: allMissions.length,
+                    start,
+                    limit,
+                    hasMore: start + limit < allMissions.length,
+                },
+            };
+        });
+    }
+    create(data) {
+        return this.client.fetch("/roadmap/missions", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    update(linkId, data) {
+        return this.client.fetch(`/roadmap/missions/${linkId}`, {
+            method: "PUT",
+            body: JSON.stringify(data),
+        });
+    }
+    delete(linkId) {
+        return this.client.fetch(`/roadmap/missions/${linkId}`, {
+            method: "DELETE",
+        });
+    }
+    /**
+     * Batch edit missions (add, update, delete in a single request)
+     * @param userId - The user ID who owns the roadmap
+     * @param roadmapId - The roadmap ID
+     * @param missions - Array of mission operations
+     */
+    batchEdit(userId, roadmapId, missions) {
+        return this.client.fetch("/roadmap/missions/batch", {
+            method: "POST",
+            body: JSON.stringify({ userId, roadmapId, missions }),
+        });
+    }
+    /**
+     * Batch delete missions and their action items by link IDs
+     * @param linkIds - Array of mission link IDs to delete
+     */
+    batchDelete(linkIds) {
+        return this.client.fetch("/roadmap/missions/batch-delete", {
+            method: "POST",
+            body: JSON.stringify({ linkIds }),
+        });
+    }
+    /**
+     * Batch restore deleted missions and their action items by link IDs
+     * @param linkIds - Array of mission link IDs to restore
+     */
+    batchRestore(linkIds) {
+        return this.client.fetch("/roadmap/missions/batch-restore", {
+            method: "POST",
+            body: JSON.stringify({ linkIds }),
+        });
+    }
+}
+exports.MissionsApi = MissionsApi;

package/dist/core/roadmap.d.ts

@@ -0,0 +1,8 @@
+import type { CrimsonClient } from "./client";
+import type { RoadmapContext } from "./types";
+export declare class RoadmapApi {
+    private client;
+    constructor(client: CrimsonClient);
+    context(userId: string): Promise<RoadmapContext>;
+    createContext(userId: string): Promise<RoadmapContext>;
+}

package/dist/core/roadmap.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoadmapApi = void 0;
+class RoadmapApi {
+    constructor(client) {
+        this.client = client;
+    }
+    context(userId) {
+        return this.client.fetch(`/roadmap/context?userId=${userId}`);
+    }
+    createContext(userId) {
+        return this.client.fetch("/roadmap/context", {
+            method: "POST",
+            body: JSON.stringify({ userId }),
+        });
+    }
+}
+exports.RoadmapApi = RoadmapApi;

package/dist/core/studentProfile.d.ts

@@ -0,0 +1,21 @@
+import type { CrimsonClient } from "./client";
+import type { StudentPrefilledInfo, StudentProfile } from "./types";
+export declare class StudentProfileApi {
+    private client;
+    constructor(client: CrimsonClient);
+    /**
+     * Get student profile by student ID
+     *
+     * @param studentId - The student's user ID
+     * @returns Full student profile data
+     */
+    getProfile(studentId: string): Promise<StudentProfile>;
+    /**
+     * Get student prefilled information including application cycle, grade, school, etc.
+     * Data is aggregated from multiple sources (Salesforce, Student Center, etc.)
+     *
+     * @param studentId - The student's user ID
+     * @returns Prefilled info with source attribution
+     */
+    getPrefilledInfo(studentId: string): Promise<StudentPrefilledInfo>;
+}

package/dist/core/studentProfile.js

@@ -0,0 +1,41 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StudentProfileApi = void 0;
+class StudentProfileApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get student profile by student ID
+     *
+     * @param studentId - The student's user ID
+     * @returns Full student profile data
+     */
+    getProfile(studentId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/api/v1/student-profile?studentId=${encodeURIComponent(studentId)}`);
+        });
+    }
+    /**
+     * Get student prefilled information including application cycle, grade, school, etc.
+     * Data is aggregated from multiple sources (Salesforce, Student Center, etc.)
+     *
+     * @param studentId - The student's user ID
+     * @returns Prefilled info with source attribution
+     */
+    getPrefilledInfo(studentId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/api/v1/student-profile/get-prefilled-info?studentId=${encodeURIComponent(studentId)}`);
+        });
+    }
+}
+exports.StudentProfileApi = StudentProfileApi;

package/dist/core/tasks.d.ts

@@ -0,0 +1,117 @@
+import type { CrimsonClient } from "./client";
+import type { Task, PaginationParams, PaginatedResult, ActionItemResource, AddResourceInput, UploadUrlResponse, UpdateTaskResourceInput } from "./types";
+export type TaskOrderBy = "priority" | "dueDate" | "missionTitle" | "createdAt" | "description";
+export interface TaskFilters extends PaginationParams {
+    status?: string[];
+    description?: string;
+    creatorId?: string;
+    dueDateStart?: string;
+    dueDateEnd?: string;
+    orderBy?: TaskOrderBy;
+    order?: "asc" | "desc";
+}
+export declare class TasksApi {
+    private client;
+    constructor(client: CrimsonClient);
+    /**
+     * List tasks/action items.
+     * Without pagination params, returns Task[] (full list).
+     * With pagination params (via roadmapId query), returns PaginatedResult<Task>.
+     */
+    list(params: {
+        missionId?: string;
+        missionLinkIds?: string[];
+        roadmapId?: string;
+        userId?: string;
+    }, filters?: TaskFilters): Promise<PaginatedResult<Task>> | Promise<Task[]>;
+    /**
+     * List tasks with pagination (requires roadmapId, always returns paginated result)
+     */
+    listPaginated(roadmapId: string, userId: string, filters?: Omit<TaskFilters, "start" | "limit">, pagination?: PaginationParams): Promise<PaginatedResult<Task>>;
+    /**
+     * Create a new task/action item
+     *
+     * Two modes are supported:
+     * 1. Mission-associated task: Include roadmapMissionId (or missionId)
+     * 2. Standalone task: Include only roadmapId (no missionId)
+     *    - Standalone tasks are not associated with any mission
+     *
+     * @example
+     * // Create mission-associated task
+     * tasks.create({ name: "Task 1", roadmapMissionId: "mission-123" })
+     *
+     * // Create standalone task
+     * tasks.create({ name: "Standalone task", roadmapId: "roadmap-456" })
+     */
+    create(data: Partial<Task>): Promise<Task>;
+    /**
+     * Create a standalone task (not associated with any mission)
+     *
+     * @param roadmapId - The roadmap ID to associate the task with
+     * @param data - Task data (name/description, dueDate, etc.)
+     */
+    createStandalone(roadmapId: string, data: Omit<Partial<Task>, "roadmapMissionId" | "missionId">): Promise<Task>;
+    update(id: string, data: Partial<Task>): Promise<Task>;
+    delete(id: string): Promise<void>;
+    /**
+     * Add resources to an action item
+     * @param actionItemId - The ID of the action item
+     * @param resources - Array of resources to add, or a single resource
+     */
+    addResources(actionItemId: string, resources: AddResourceInput | AddResourceInput[]): Promise<ActionItemResource[]>;
+    /**
+     * Update task resources (create, update, delete)
+     *
+     * @param taskId - The ID of the task
+     * @param resources - Array of resources. Include id to update existing, omit id to create new.
+     *                   Resources not in the array will be deleted.
+     *
+     * @example
+     * // Update resources: keep existing with id, add new without id
+     * tasks.updateResources("task-123", [
+     *   { id: "existing-id", title: "Updated", type: "Link", url: "https://..." },
+     *   { title: "New Resource", type: "Upload", url: "https://..." }
+     * ])
+     */
+    updateResources(taskId: string, resources: UpdateTaskResourceInput[]): Promise<Task>;
+    /**
+     * Get a presigned URL for uploading a file to S3
+     *
+     * @param filename - The name of the file
+     * @param contentType - The MIME type of the file (e.g., "image/png", "application/pdf")
+     * @returns Promise with putUrl (for upload), url (final S3 URL), key, and bucket
+     *
+     * @example
+     * // Get upload URL
+     * const { putUrl, url } = await tasks.getUploadUrl("document.pdf", "application/pdf");
+     *
+     * // Upload file using PUT request
+     * await fetch(putUrl, { method: "PUT", body: file, headers: { "Content-Type": "application/pdf" } });
+     *
+     * // Use the url as the resource URL
+     * await tasks.updateResources(taskId, [{ title: "Document", type: "Upload", url }]);
+     */
+    getUploadUrl(filename: string, contentType: string): Promise<UploadUrlResponse>;
+    /**
+     * Upload a file and get the S3 URL
+     *
+     * This is a convenience method that:
+     * 1. Gets a presigned upload URL
+     * 2. Uploads the file
+     * 3. Returns the final S3 URL
+     *
+     * @param file - The File or Blob to upload
+     * @param filename - Optional filename (defaults to file.name if File)
+     * @returns Promise with the final S3 URL to use as resource URL
+     *
+     * @example
+     * const url = await tasks.uploadFile(file);
+     * await tasks.updateResources(taskId, [
+     *   { title: file.name, type: "Upload", url, mediaType: file.type }
+     * ]);
+     */
+    uploadFile(file: File | Blob, filename?: string): Promise<{
+        url: string;
+        key: string;
+    }>;
+}

package/dist/core/tasks.js

@@ -0,0 +1,288 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TasksApi = void 0;
+const normalizeTask = (raw) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    if (!raw) {
+        console.error("normalizeTask received null/undefined:", raw);
+        console.trace("Stack trace:");
+        throw new Error("Cannot normalize null or undefined task");
+    }
+    if (!raw.id) {
+        console.error("normalizeTask received object without id:", raw);
+        throw new Error("Task object missing required 'id' field");
+    }
+    const statusUpper = typeof raw.status === "string" ? raw.status.toUpperCase() : undefined;
+    const isComplete = raw.isComplete !== undefined
+        ? Boolean(raw.isComplete)
+        : statusUpper
+            ? statusUpper === "DONE"
+            : Boolean(raw.finishedAt);
+    return {
+        id: (_a = raw.id) !== null && _a !== void 0 ? _a : "",
+        name: (_c = (_b = raw.name) !== null && _b !== void 0 ? _b : raw.description) !== null && _c !== void 0 ? _c : "",
+        description: raw.description,
+        content: raw.content,
+        status: (_d = raw.status) !== null && _d !== void 0 ? _d : "",
+        date: (_f = (_e = raw.date) !== null && _e !== void 0 ? _e : raw.dueDate) !== null && _f !== void 0 ? _f : "",
+        roadmapMissionId: (_j = (_h = (_g = raw.roadmapMissionId) !== null && _g !== void 0 ? _g : raw.missionId) !== null && _h !== void 0 ? _h : raw.linkId) !== null && _j !== void 0 ? _j : "",
+        userId: (_l = (_k = raw.userId) !== null && _k !== void 0 ? _k : raw.creatorId) !== null && _l !== void 0 ? _l : "",
+        creatorId: raw.creatorId,
+        isComplete,
+        resources: raw.resources,
+        mission: raw.mission,
+    };
+};
+class TasksApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List tasks/action items.
+     * Without pagination params, returns Task[] (full list).
+     * With pagination params (via roadmapId query), returns PaginatedResult<Task>.
+     */
+    list(params, filters) {
+        var _a;
+        const searchParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.missionId) {
+            searchParams.append("missionId", params.missionId);
+        }
+        if ((params === null || params === void 0 ? void 0 : params.missionLinkIds) && params.missionLinkIds.length > 0) {
+            searchParams.append("missionLinkIds", params.missionLinkIds.join(","));
+        }
+        if (params === null || params === void 0 ? void 0 : params.roadmapId) {
+            searchParams.append("roadmapId", params.roadmapId);
+        }
+        if (params === null || params === void 0 ? void 0 : params.userId) {
+            searchParams.append("userId", params.userId);
+        }
+        // Add filter params
+        if ((_a = filters === null || filters === void 0 ? void 0 : filters.status) === null || _a === void 0 ? void 0 : _a.length) {
+            searchParams.append("status", filters.status.join(","));
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.description) {
+            searchParams.append("description", filters.description);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.creatorId) {
+            searchParams.append("creatorId", filters.creatorId);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.dueDateStart) {
+            searchParams.append("dueDateStart", filters.dueDateStart);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.dueDateEnd) {
+            searchParams.append("dueDateEnd", filters.dueDateEnd);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.orderBy) {
+            searchParams.append("orderBy", filters.orderBy);
+        }
+        if (filters === null || filters === void 0 ? void 0 : filters.order) {
+            searchParams.append("order", filters.order);
+        }
+        if ((filters === null || filters === void 0 ? void 0 : filters.start) !== undefined) {
+            searchParams.append("start", String(filters.start));
+        }
+        if ((filters === null || filters === void 0 ? void 0 : filters.limit) !== undefined) {
+            searchParams.append("limit", String(filters.limit));
+        }
+        const query = searchParams.toString();
+        const path = query
+            ? `/roadmap/action-items?${query}`
+            : "/roadmap/action-items";
+        // When pagination params are provided with roadmapId, return paginated result
+        if ((params === null || params === void 0 ? void 0 : params.roadmapId) &&
+            ((filters === null || filters === void 0 ? void 0 : filters.start) !== undefined || (filters === null || filters === void 0 ? void 0 : filters.limit) !== undefined)) {
+            return this.client
+                .fetch(path)
+                .then((result) => {
+                var _a, _b;
+                // Check if result is paginated format
+                if (result &&
+                    typeof result === "object" &&
+                    "pagination" in result &&
+                    "data" in result) {
+                    return {
+                        data: (result.data || [])
+                            .filter((item) => item != null)
+                            .map(normalizeTask),
+                        pagination: result.pagination,
+                    };
+                }
+                // Legacy format: RawTask[] - convert to paginated format
+                const allTasks = result || [];
+                const start = (_a = filters === null || filters === void 0 ? void 0 : filters.start) !== null && _a !== void 0 ? _a : 0;
+                const limit = (_b = filters === null || filters === void 0 ? void 0 : filters.limit) !== null && _b !== void 0 ? _b : 20;
+                const normalizedTasks = allTasks
+                    .filter((item) => item != null)
+                    .map(normalizeTask);
+                const paginatedTasks = normalizedTasks.slice(start, start + limit);
+                return {
+                    data: paginatedTasks,
+                    pagination: {
+                        total: normalizedTasks.length,
+                        start,
+                        limit,
+                        hasMore: start + limit < normalizedTasks.length,
+                    },
+                };
+            });
+        }
+        // Otherwise return flat array (backward compatible)
+        return this.client.fetch(path).then((items) => {
+            const filtered = (items || []).filter((item) => item != null);
+            return filtered.map(normalizeTask);
+        });
+    }
+    /**
+     * List tasks with pagination (requires roadmapId, always returns paginated result)
+     */
+    listPaginated(roadmapId, userId, filters, pagination) {
+        var _a, _b;
+        return this.list({ roadmapId, userId }, Object.assign(Object.assign({}, filters), { start: (_a = pagination === null || pagination === void 0 ? void 0 : pagination.start) !== null && _a !== void 0 ? _a : 0, limit: (_b = pagination === null || pagination === void 0 ? void 0 : pagination.limit) !== null && _b !== void 0 ? _b : 20 }));
+    }
+    /**
+     * Create a new task/action item
+     *
+     * Two modes are supported:
+     * 1. Mission-associated task: Include roadmapMissionId (or missionId)
+     * 2. Standalone task: Include only roadmapId (no missionId)
+     *    - Standalone tasks are not associated with any mission
+     *
+     * @example
+     * // Create mission-associated task
+     * tasks.create({ name: "Task 1", roadmapMissionId: "mission-123" })
+     *
+     * // Create standalone task
+     * tasks.create({ name: "Standalone task", roadmapId: "roadmap-456" })
+     */
+    create(data) {
+        return this.client
+            .fetch("/roadmap/action-items", {
+            method: "POST",
+            body: JSON.stringify(data),
+        })
+            .then((item) => normalizeTask(item));
+    }
+    /**
+     * Create a standalone task (not associated with any mission)
+     *
+     * @param roadmapId - The roadmap ID to associate the task with
+     * @param data - Task data (name/description, dueDate, etc.)
+     */
+    createStandalone(roadmapId, data) {
+        return this.create(Object.assign(Object.assign({}, data), { roadmapId }));
+    }
+    update(id, data) {
+        return this.client
+            .fetch(`/roadmap/action-items/${id}`, {
+            method: "PUT",
+            body: JSON.stringify(data),
+        })
+            .then((item) => normalizeTask(item));
+    }
+    delete(id) {
+        return this.client.fetch(`/roadmap/action-items/${id}`, {
+            method: "DELETE",
+        });
+    }
+    /**
+     * Add resources to an action item
+     * @param actionItemId - The ID of the action item
+     * @param resources - Array of resources to add, or a single resource
+     */
+    addResources(actionItemId, resources) {
+        const body = Array.isArray(resources) ? resources : [resources];
+        return this.client.fetch(`/roadmap/action-items/${actionItemId}/resources`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * Update task resources (create, update, delete)
+     *
+     * @param taskId - The ID of the task
+     * @param resources - Array of resources. Include id to update existing, omit id to create new.
+     *                   Resources not in the array will be deleted.
+     *
+     * @example
+     * // Update resources: keep existing with id, add new without id
+     * tasks.updateResources("task-123", [
+     *   { id: "existing-id", title: "Updated", type: "Link", url: "https://..." },
+     *   { title: "New Resource", type: "Upload", url: "https://..." }
+     * ])
+     */
+    updateResources(taskId, resources) {
+        return this.update(taskId, { resources });
+    }
+    /**
+     * Get a presigned URL for uploading a file to S3
+     *
+     * @param filename - The name of the file
+     * @param contentType - The MIME type of the file (e.g., "image/png", "application/pdf")
+     * @returns Promise with putUrl (for upload), url (final S3 URL), key, and bucket
+     *
+     * @example
+     * // Get upload URL
+     * const { putUrl, url } = await tasks.getUploadUrl("document.pdf", "application/pdf");
+     *
+     * // Upload file using PUT request
+     * await fetch(putUrl, { method: "PUT", body: file, headers: { "Content-Type": "application/pdf" } });
+     *
+     * // Use the url as the resource URL
+     * await tasks.updateResources(taskId, [{ title: "Document", type: "Upload", url }]);
+     */
+    getUploadUrl(filename, contentType) {
+        return this.client.fetch("/roadmap/upload", {
+            method: "POST",
+            body: JSON.stringify({ filename, contentType }),
+        });
+    }
+    /**
+     * Upload a file and get the S3 URL
+     *
+     * This is a convenience method that:
+     * 1. Gets a presigned upload URL
+     * 2. Uploads the file
+     * 3. Returns the final S3 URL
+     *
+     * @param file - The File or Blob to upload
+     * @param filename - Optional filename (defaults to file.name if File)
+     * @returns Promise with the final S3 URL to use as resource URL
+     *
+     * @example
+     * const url = await tasks.uploadFile(file);
+     * await tasks.updateResources(taskId, [
+     *   { title: file.name, type: "Upload", url, mediaType: file.type }
+     * ]);
+     */
+    uploadFile(file, filename) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const name = filename || (file instanceof File ? file.name : `upload-${Date.now()}`);
+            const contentType = file.type || "application/octet-stream";
+            // Get presigned URL
+            const { putUrl, url, key } = yield this.getUploadUrl(name, contentType);
+            // Upload file using PUT request
+            const response = yield fetch(putUrl, {
+                method: "PUT",
+                body: file,
+                headers: {
+                    "Content-Type": contentType,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+            }
+            return { url, key };
+        });
+    }
+}
+exports.TasksApi = TasksApi;