@crimson-education/sdk 0.2.3 → 0.2.5

package/README.md

@@ -116,11 +116,13 @@ const page = await client.missions.listPaginated("student-uid", undefined, {
 涉及接口：
 
 - `GET /roadmap/action-items`
+- `GET /roadmap/action-items/creators`
 - `POST /roadmap/action-items`
 - `PUT /roadmap/action-items/:id`
 - `DELETE /roadmap/action-items/:id`
 - `POST /roadmap/action-items/:actionItemId/resources`
 - `POST /roadmap/upload`
+- `GET /roadmap/download`
 
 主要方法：
 
@@ -138,6 +140,10 @@ const page = await client.missions.listPaginated("student-uid", undefined, {
   - 当 **同时提供** `roadmapId` 且提供 `start/limit` 时：返回 `PaginatedResult<Task>`
 - `listPaginated(roadmapId, userId, filters?, pagination?)`
   - 始终返回 `PaginatedResult<Task>`（内部复用 `list`）
+- `getCreators(roadmapId)`
+  - 获取指定 roadmap 下所有任务的创建者列表
+- `getDownloadUrl(key)`
+  - 获取 S3 资源的预签名下载 URL
 - `create(data: Partial<Task>)`
   - 支持两种模式：
     - Mission 关联任务：提供 `roadmapMissionId`（或 `missionId`）
@@ -203,6 +209,8 @@ SDK 会将后端返回的 action item 做归一化，保证至少返回以下核
 涉及接口：
 
 - `GET /roadmap/library/missions`
+- `POST /roadmap/library/missions`
+- `PUT /roadmap/library/missions/:missionId`
 - `GET /roadmap/library/tasks`
 - `POST /roadmap/library/missions/copy`
 - `POST /roadmap/library/missions/assign-bulk`
@@ -213,6 +221,8 @@ SDK 会将后端返回的 action item 做归一化，保证至少返回以下核
 主要方法：
 
 - `listTemplateMissions(filters?: TemplateMissionFilters): Promise<PaginatedResult<TemplateMission>>`
+- `createTemplateMission(input: TemplateMissionCreateInput): Promise<TemplateMission>`
+- `updateTemplateMission(id: string, raw: TemplateMission, update: TemplateMissionUpdateInput): Promise<TemplateMission>`
 - `listTemplateTasks(filters?: TemplateTaskFilters): Promise<PaginatedResult<TemplateTask>>`
 - `copyTemplateMission(input: CopyTemplateMissionInput): Promise<TemplateMission[]>`
 - `assignBulkMission(input: AssignBulkMissionInput[]): Promise<{ code: number; msg?: string }>`
@@ -314,9 +324,16 @@ Props：
 - `useTasks(missionId, enabled)`：拉取某 mission 的 tasks
 - `useTasksInfinite(roadmapId, userId, filters?, options?)`：分页拉取 tasks
 - `useRoadmapContext(userId, enabled)`：拉取 roadmap context
+- `useTaskCreators(roadmapId, enabled)`：获取任务创建者列表
 - CRUD mutation：
   - `useCreateMission/useUpdateMission/useDeleteMission`
   - `useCreateTask/useUpdateTask/useDeleteTask`
+  - `useCreateTemplateMission/useUpdateTemplateMission`
+  - `useGetDownloadUrl`：获取文件下载地址
+- 模板库相关：
+  - `useTemplateMissions/useTemplateMissionsInfinite`
+  - `useTemplateTasks/useTemplateTasksInfinite`
+  - `useTemplateMissionDetail(missionId)`
 
 ---
 

package/dist/core/missionLibrary.d.ts

@@ -39,6 +39,17 @@ export interface CreateFromPredefinedInput {
     missionId: string;
     predefinedTaskIds: string[];
 }
+export interface TemplateMissionCreateInput {
+    title: string;
+    description: string;
+    category: string;
+    subcategory: string;
+    tasks: {
+        id?: string | null;
+        description: string;
+        content: string;
+    }[];
+}
 export declare class MissionLibraryApi {
     private client;
     constructor(client: CrimsonClient);
@@ -46,6 +57,14 @@ export declare class MissionLibraryApi {
      * List template missions with pagination
      */
     listTemplateMissions(filters?: TemplateMissionFilters): Promise<PaginatedResult<TemplateMission>>;
+    /**
+     * Create a new template mission
+     */
+    createTemplateMission(input: TemplateMissionCreateInput): Promise<TemplateMission>;
+    /**
+     * Delete a template mission
+     */
+    deleteTemplateMission(id: string): Promise<void>;
     /**
      * List template tasks with pagination
      */

package/dist/core/missionLibrary.js

@@ -49,6 +49,27 @@ class MissionLibraryApi {
             return this.client.fetch(path);
         });
     }
+    /**
+     * Create a new template mission
+     */
+    createTemplateMission(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/roadmap/library/missions", {
+                method: "POST",
+                body: JSON.stringify(Object.assign(Object.assign({}, input), { type: "custom" })),
+            });
+        });
+    }
+    /**
+     * Delete a template mission
+     */
+    deleteTemplateMission(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/library/missions/${id}`, {
+                method: "DELETE",
+            });
+        });
+    }
     /**
      * List template tasks with pagination
      */

package/dist/core/tasks.d.ts

@@ -1,5 +1,5 @@
 import type { CrimsonClient } from "./client";
-import type { Task, PaginationParams, PaginatedResult, ActionItemResource, AddResourceInput, UploadUrlResponse, UpdateTaskResourceInput } from "./types";
+import type { Task, PaginationParams, PaginatedResult, ActionItemResource, AddResourceInput, UploadUrlResponse, DownloadUrlResponse, UpdateTaskResourceInput, User } from "./types";
 export type TaskOrderBy = "priority" | "dueDate" | "missionTitle" | "createdAt" | "description";
 export interface TaskFilters extends PaginationParams {
     status?: string[];
@@ -28,6 +28,10 @@ export declare class TasksApi {
      * 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>>;
+    /**
+     * Get all creators of tasks in a roadmap
+     */
+    getCreators(roadmapId: string): Promise<User[]>;
     /**
      * Create a new task/action item
      *
@@ -53,6 +57,24 @@ export declare class TasksApi {
     createStandalone(roadmapId: string, data: Omit<Partial<Task>, "roadmapMissionId" | "missionId">): Promise<Task>;
     update(id: string, data: Partial<Task>): Promise<Task>;
     delete(id: string): Promise<void>;
+    /**
+     * Bulk delete tasks
+     * @param ids - Array of task IDs to delete
+     */
+    bulkDelete(ids: string[]): Promise<{
+        deleted: string[];
+    }>;
+    /**
+     * Bulk update tasks
+     * @param ids - Array of task IDs to update
+     * @param data - Update data (dueDate, status)
+     */
+    bulkUpdate(ids: string[], data: {
+        dueDate?: string | null;
+        status?: string;
+    }): Promise<{
+        updated: any[];
+    }>;
     /**
      * Add resources to an action item
      * @param actionItemId - The ID of the action item
@@ -92,6 +114,13 @@ export declare class TasksApi {
      * await tasks.updateResources(taskId, [{ title: "Document", type: "Upload", url }]);
      */
     getUploadUrl(filename: string, contentType: string): Promise<UploadUrlResponse>;
+    /**
+     * Get a presigned URL for downloading a file from S3
+     *
+     * @param key - The S3 object key
+     * @returns Promise with url (presigned download URL)
+     */
+    getDownloadUrl(key: string): Promise<DownloadUrlResponse>;
     /**
      * Upload a file and get the S3 URL
      *

package/dist/core/tasks.js

@@ -149,6 +149,12 @@ class TasksApi {
         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 }));
     }
+    /**
+     * Get all creators of tasks in a roadmap
+     */
+    getCreators(roadmapId) {
+        return this.client.fetch(`/roadmap/action-items/creators?roadmapId=${roadmapId}`);
+    }
     /**
      * Create a new task/action item
      *
@@ -194,6 +200,27 @@ class TasksApi {
             method: "DELETE",
         });
     }
+    /**
+     * Bulk delete tasks
+     * @param ids - Array of task IDs to delete
+     */
+    bulkDelete(ids) {
+        return this.client.fetch("/roadmap/action-items/bulk-delete", {
+            method: "POST",
+            body: JSON.stringify({ ids }),
+        });
+    }
+    /**
+     * Bulk update tasks
+     * @param ids - Array of task IDs to update
+     * @param data - Update data (dueDate, status)
+     */
+    bulkUpdate(ids, data) {
+        return this.client.fetch("/roadmap/action-items/bulk-update", {
+            method: "POST",
+            body: JSON.stringify({ ids, data }),
+        });
+    }
     /**
      * Add resources to an action item
      * @param actionItemId - The ID of the action item
@@ -246,6 +273,17 @@ class TasksApi {
             body: JSON.stringify({ filename, contentType }),
         });
     }
+    /**
+     * Get a presigned URL for downloading a file from S3
+     *
+     * @param key - The S3 object key
+     * @returns Promise with url (presigned download URL)
+     */
+    getDownloadUrl(key) {
+        return this.client.fetch(`/roadmap/download?key=${encodeURIComponent(key)}`, {
+            method: "GET",
+        });
+    }
     /**
      * Upload a file and get the S3 URL
      *

package/dist/core/types.d.ts

@@ -297,6 +297,10 @@ export interface UploadUrlResponse {
     /** S3 bucket name */
     bucket: string;
 }
+export interface DownloadUrlResponse {
+    /** Presigned URL for downloading the file */
+    url: string;
+}
 export interface UpdateTaskResourceInput {
     /** Resource ID - include to update existing, omit to create new */
     id?: string;

package/dist/react/hooks/index.d.ts

@@ -2,9 +2,9 @@ export { useAuthState } from "./useAuthState";
 export { useOAuth, useOAuthCallback } from "./useOAuth";
 export type { UseOAuthResult } from "./useOAuth";
 export { useMissions, useMissionsInfinite, useCreateMission, useUpdateMission, useDeleteMission, missionKeys, } from "./useMissions";
-export { useTasks, useAllUserTasks, useTasksByRoadmapId, useTasksInfinite, useCreateTask, useUpdateTask, useDeleteTask, taskKeys, } from "./useTasks";
+export { useTasks, useAllUserTasks, useTasksByRoadmapId, useTasksInfinite, useCreateTask, useUpdateTask, useDeleteTask, useBulkDeleteTasks, useBulkUpdateTasks, taskKeys, useGetDownloadUrl, useTaskCreators } from "./useTasks";
 export { useUsers, useUser, userKeys } from "./useUsers";
 export { useCurrentUserRoles, useMyStudents, accountKeys } from "./useAccount";
 export { useRoadmapContext } from "./useRoadmapContext";
-export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useUpdateTemplateMission, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, } from "./useMissionLibrary";
+export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useUpdateTemplateMission, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, useCreateTemplateMission, useDeleteTemplateMission, } from "./useMissionLibrary";
 export { useStudentProfile, useStudentPrefilledInfo, studentProfileKeys, } from "./useStudentProfile";

package/dist/react/hooks/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.studentProfileKeys = exports.useStudentPrefilledInfo = exports.useStudentProfile = exports.missionLibraryKeys = exports.useCreateFromPredefinedTasks = exports.useAssignBulkTask = exports.useAssignBulkMission = exports.useCopyTemplateMission = exports.useUpdateTemplateMission = exports.useTemplateMissionDetail = exports.useTemplateTasksInfinite = exports.useTemplateTasks = exports.useTemplateMissionsInfinite = exports.useTemplateMissions = exports.useRoadmapContext = exports.accountKeys = exports.useMyStudents = exports.useCurrentUserRoles = exports.userKeys = exports.useUser = exports.useUsers = exports.taskKeys = exports.useDeleteTask = exports.useUpdateTask = exports.useCreateTask = exports.useTasksInfinite = exports.useTasksByRoadmapId = exports.useAllUserTasks = exports.useTasks = exports.missionKeys = exports.useDeleteMission = exports.useUpdateMission = exports.useCreateMission = exports.useMissionsInfinite = exports.useMissions = exports.useOAuthCallback = exports.useOAuth = exports.useAuthState = void 0;
+exports.studentProfileKeys = exports.useStudentPrefilledInfo = exports.useStudentProfile = exports.useDeleteTemplateMission = exports.useCreateTemplateMission = exports.missionLibraryKeys = exports.useCreateFromPredefinedTasks = exports.useAssignBulkTask = exports.useAssignBulkMission = exports.useCopyTemplateMission = exports.useUpdateTemplateMission = exports.useTemplateMissionDetail = exports.useTemplateTasksInfinite = exports.useTemplateTasks = exports.useTemplateMissionsInfinite = exports.useTemplateMissions = exports.useRoadmapContext = exports.accountKeys = exports.useMyStudents = exports.useCurrentUserRoles = exports.userKeys = exports.useUser = exports.useUsers = exports.useTaskCreators = exports.useGetDownloadUrl = exports.taskKeys = exports.useBulkUpdateTasks = exports.useBulkDeleteTasks = exports.useDeleteTask = exports.useUpdateTask = exports.useCreateTask = exports.useTasksInfinite = exports.useTasksByRoadmapId = exports.useAllUserTasks = exports.useTasks = exports.missionKeys = exports.useDeleteMission = exports.useUpdateMission = exports.useCreateMission = exports.useMissionsInfinite = exports.useMissions = exports.useOAuthCallback = exports.useOAuth = exports.useAuthState = void 0;
 var useAuthState_1 = require("./useAuthState");
 Object.defineProperty(exports, "useAuthState", { enumerable: true, get: function () { return useAuthState_1.useAuthState; } });
 var useOAuth_1 = require("./useOAuth");
@@ -21,7 +21,11 @@ Object.defineProperty(exports, "useTasksInfinite", { enumerable: true, get: func
 Object.defineProperty(exports, "useCreateTask", { enumerable: true, get: function () { return useTasks_1.useCreateTask; } });
 Object.defineProperty(exports, "useUpdateTask", { enumerable: true, get: function () { return useTasks_1.useUpdateTask; } });
 Object.defineProperty(exports, "useDeleteTask", { enumerable: true, get: function () { return useTasks_1.useDeleteTask; } });
+Object.defineProperty(exports, "useBulkDeleteTasks", { enumerable: true, get: function () { return useTasks_1.useBulkDeleteTasks; } });
+Object.defineProperty(exports, "useBulkUpdateTasks", { enumerable: true, get: function () { return useTasks_1.useBulkUpdateTasks; } });
 Object.defineProperty(exports, "taskKeys", { enumerable: true, get: function () { return useTasks_1.taskKeys; } });
+Object.defineProperty(exports, "useGetDownloadUrl", { enumerable: true, get: function () { return useTasks_1.useGetDownloadUrl; } });
+Object.defineProperty(exports, "useTaskCreators", { enumerable: true, get: function () { return useTasks_1.useTaskCreators; } });
 var useUsers_1 = require("./useUsers");
 Object.defineProperty(exports, "useUsers", { enumerable: true, get: function () { return useUsers_1.useUsers; } });
 Object.defineProperty(exports, "useUser", { enumerable: true, get: function () { return useUsers_1.useUser; } });
@@ -44,6 +48,8 @@ Object.defineProperty(exports, "useAssignBulkMission", { enumerable: true, get:
 Object.defineProperty(exports, "useAssignBulkTask", { enumerable: true, get: function () { return useMissionLibrary_1.useAssignBulkTask; } });
 Object.defineProperty(exports, "useCreateFromPredefinedTasks", { enumerable: true, get: function () { return useMissionLibrary_1.useCreateFromPredefinedTasks; } });
 Object.defineProperty(exports, "missionLibraryKeys", { enumerable: true, get: function () { return useMissionLibrary_1.missionLibraryKeys; } });
+Object.defineProperty(exports, "useCreateTemplateMission", { enumerable: true, get: function () { return useMissionLibrary_1.useCreateTemplateMission; } });
+Object.defineProperty(exports, "useDeleteTemplateMission", { enumerable: true, get: function () { return useMissionLibrary_1.useDeleteTemplateMission; } });
 var useStudentProfile_1 = require("./useStudentProfile");
 Object.defineProperty(exports, "useStudentProfile", { enumerable: true, get: function () { return useStudentProfile_1.useStudentProfile; } });
 Object.defineProperty(exports, "useStudentPrefilledInfo", { enumerable: true, get: function () { return useStudentProfile_1.useStudentPrefilledInfo; } });

package/dist/react/hooks/useMissionLibrary.d.ts

@@ -1,5 +1,5 @@
 import type { TemplateMission, TemplateTask, MissionDetail, AssignBulkMissionInput, AssignBulkTaskInput } from "../../core/types";
-import type { TemplateMissionFilters, TemplateTaskFilters, CopyTemplateMissionInput, CreateFromPredefinedInput, TemplateMissionUpdateInput } from "../../core/missionLibrary";
+import type { TemplateMissionFilters, TemplateTaskFilters, CopyTemplateMissionInput, CreateFromPredefinedInput, TemplateMissionUpdateInput, TemplateMissionCreateInput } from "../../core/missionLibrary";
 export declare const missionLibraryKeys: {
     all: readonly ["missionLibrary"];
     missions: (filters?: TemplateMissionFilters) => readonly ["missionLibrary", "missions", TemplateMissionFilters | undefined];
@@ -24,6 +24,8 @@ export declare function useUpdateTemplateMission(): import("@tanstack/react-quer
     raw: TemplateMission;
     update: TemplateMissionUpdateInput;
 }, unknown>;
+export declare function useCreateTemplateMission(): import("@tanstack/react-query").UseMutationResult<TemplateMission, Error, TemplateMissionCreateInput, unknown>;
+export declare function useDeleteTemplateMission(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
 export declare function useCopyTemplateMission(): import("@tanstack/react-query").UseMutationResult<TemplateMission[], Error, CopyTemplateMissionInput, unknown>;
 export declare function useAssignBulkMission(): import("@tanstack/react-query").UseMutationResult<{
     code: number;

package/dist/react/hooks/useMissionLibrary.js

@@ -17,6 +17,8 @@ exports.useTemplateTasks = useTemplateTasks;
 exports.useTemplateTasksInfinite = useTemplateTasksInfinite;
 exports.useTemplateMissionDetail = useTemplateMissionDetail;
 exports.useUpdateTemplateMission = useUpdateTemplateMission;
+exports.useCreateTemplateMission = useCreateTemplateMission;
+exports.useDeleteTemplateMission = useDeleteTemplateMission;
 exports.useCopyTemplateMission = useCopyTemplateMission;
 exports.useAssignBulkMission = useAssignBulkMission;
 exports.useAssignBulkTask = useAssignBulkTask;
@@ -121,6 +123,35 @@ function useUpdateTemplateMission() {
         },
     });
 }
+function useCreateTemplateMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (input) => client.library.createTemplateMission(input),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: exports.missionLibraryKeys.missionsInfinite({
+                    groups: ["custom"],
+                }),
+            });
+        },
+    });
+}
+function useDeleteTemplateMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (id) => client.library.deleteTemplateMission(id),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: exports.missionLibraryKeys.missionsInfinite(),
+            });
+            queryClient.invalidateQueries({
+                queryKey: exports.missionLibraryKeys.missions(),
+            });
+        },
+    });
+}
 function useCopyTemplateMission() {
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();

package/dist/react/hooks/useMissions.d.ts

@@ -1,3 +1,4 @@
+import { InfiniteData } from "@tanstack/react-query";
 import type { Mission, PaginatedResult } from "../../core/types";
 import type { MissionFilters } from "../../core/missions";
 export declare const missionKeys: {
@@ -15,10 +16,19 @@ export declare function useMissions(userId: string | null, enabled: boolean): im
 export declare function useMissionsInfinite(userId: string | null, filters?: Omit<MissionFilters, "start" | "limit">, options?: {
     enabled?: boolean;
     pageSize?: number;
-}): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<PaginatedResult<Mission>, unknown>, Error>;
-export declare function useCreateMission(): import("@tanstack/react-query").UseMutationResult<Mission, Error, Partial<Mission>, unknown>;
-export declare function useUpdateMission(): import("@tanstack/react-query").UseMutationResult<Mission, Error, {
+}): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<PaginatedResult<Mission>, unknown>, Error>;
+export interface OptimisticOptions {
+    optimistic?: boolean;
+}
+export declare function useCreateMission(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<Mission, Error, Partial<Mission>, {
+    previousMissions: Mission[] | undefined;
+} | undefined>;
+export declare function useUpdateMission(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<Mission, Error, {
     id: string;
     data: Partial<Mission>;
-}, unknown>;
-export declare function useDeleteMission(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+}, {
+    previousMissionsMap: Map<string, unknown>;
+} | undefined>;
+export declare function useDeleteMission(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<void, Error, string, {
+    previousMissionsMap: Map<string, unknown>;
+} | undefined>;

package/dist/react/hooks/useMissions.js

@@ -72,32 +72,127 @@ function useMissionsInfinite(userId, filters, options) {
         enabled: !!userId && enabled,
     });
 }
-function useCreateMission() {
+function useCreateMission(options) {
+    var _a;
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
     return (0, react_query_1.useMutation)({
         mutationFn: (data) => client.missions.create(data),
-        onSuccess: () => {
+        onMutate: (newMission) => __awaiter(this, void 0, void 0, function* () {
+            if (!optimistic || !newMission.userId)
+                return;
+            const queryKey = exports.missionKeys.list(newMission.userId);
+            yield queryClient.cancelQueries({ queryKey });
+            const previousMissions = queryClient.getQueryData(queryKey);
+            if (previousMissions) {
+                const optimisticMission = Object.assign({ id: `temp-${Date.now()}`, title: "New Mission", status: "PLANNED", category: "General", roadmapId: "" }, newMission);
+                queryClient.setQueryData(queryKey, (old) => {
+                    return old ? [...old, optimisticMission] : [optimisticMission];
+                });
+            }
+            return { previousMissions };
+        }),
+        onError: (err, newMission, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousMissions) || !newMission.userId)
+                return;
+            queryClient.setQueryData(exports.missionKeys.list(newMission.userId), context.previousMissions);
+        },
+        onSettled: () => {
             queryClient.invalidateQueries({ queryKey: exports.missionKeys.all });
         },
     });
 }
-function useUpdateMission() {
+function useUpdateMission(options) {
+    var _a;
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
     return (0, react_query_1.useMutation)({
         mutationFn: ({ id, data }) => client.missions.update(id, data),
-        onSuccess: () => {
+        onMutate: (_a) => __awaiter(this, [_a], void 0, function* ({ id, data }) {
+            if (!optimistic)
+                return;
+            yield queryClient.cancelQueries({ queryKey: exports.missionKeys.all });
+            const previousMissionsMap = new Map();
+            queryClient
+                .getQueriesData({ queryKey: exports.missionKeys.all })
+                .forEach(([key, old]) => {
+                previousMissionsMap.set(JSON.stringify(key), old);
+                if (!old)
+                    return;
+                // Handle Infinite Query Support
+                if (typeof old === "object" &&
+                    "pages" in old &&
+                    Array.isArray(old.pages)) {
+                    queryClient.setQueryData(key, (oldData) => {
+                        if (!oldData)
+                            return oldData;
+                        return Object.assign(Object.assign({}, oldData), { pages: oldData.pages.map((page) => (Object.assign(Object.assign({}, page), { data: page.data.map((mission) => mission.id === id ? Object.assign(Object.assign({}, mission), data) : mission) }))) });
+                    });
+                }
+                // Handle Standard List Support
+                else if (Array.isArray(old)) {
+                    queryClient.setQueryData(key, (oldData) => oldData === null || oldData === void 0 ? void 0 : oldData.map((mission) => mission.id === id ? Object.assign(Object.assign({}, mission), data) : mission));
+                }
+            });
+            return { previousMissionsMap };
+        }),
+        onError: (err, { id }, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousMissionsMap))
+                return;
+            context.previousMissionsMap.forEach((old, keyStr) => {
+                queryClient.setQueryData(JSON.parse(keyStr), old);
+            });
+        },
+        onSettled: () => {
             queryClient.invalidateQueries({ queryKey: exports.missionKeys.all });
         },
     });
 }
-function useDeleteMission() {
+function useDeleteMission(options) {
+    var _a;
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
     return (0, react_query_1.useMutation)({
         mutationFn: (id) => client.missions.delete(id),
-        onSuccess: () => {
+        onMutate: (id) => __awaiter(this, void 0, void 0, function* () {
+            if (!optimistic)
+                return;
+            yield queryClient.cancelQueries({ queryKey: exports.missionKeys.all });
+            const previousMissionsMap = new Map();
+            queryClient
+                .getQueriesData({ queryKey: exports.missionKeys.all })
+                .forEach(([key, old]) => {
+                previousMissionsMap.set(JSON.stringify(key), old);
+                if (!old)
+                    return;
+                // Handle Infinite Query Support
+                if (typeof old === "object" &&
+                    "pages" in old &&
+                    Array.isArray(old.pages)) {
+                    queryClient.setQueryData(key, (oldData) => {
+                        if (!oldData)
+                            return oldData;
+                        return Object.assign(Object.assign({}, oldData), { pages: oldData.pages.map((page) => (Object.assign(Object.assign({}, page), { data: page.data.filter((mission) => mission.id !== id) }))) });
+                    });
+                }
+                // Handle Standard List Support
+                else if (Array.isArray(old)) {
+                    queryClient.setQueryData(key, (oldData) => oldData === null || oldData === void 0 ? void 0 : oldData.filter((mission) => mission.id !== id));
+                }
+            });
+            return { previousMissionsMap };
+        }),
+        onError: (err, id, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousMissionsMap))
+                return;
+            context.previousMissionsMap.forEach((old, keyStr) => {
+                queryClient.setQueryData(JSON.parse(keyStr), old);
+            });
+        },
+        onSettled: () => {
             queryClient.invalidateQueries({ queryKey: exports.missionKeys.all });
         },
     });

package/dist/react/hooks/useTasks.d.ts

@@ -1,4 +1,5 @@
-import type { Task, PaginatedResult } from "../../core/types";
+import { InfiniteData } from "@tanstack/react-query";
+import type { Task, PaginatedResult, User } from "../../core/types";
 import type { TaskFilters } from "../../core/tasks";
 export declare const taskKeys: {
     all: readonly ["tasks"];
@@ -7,8 +8,10 @@ export declare const taskKeys: {
     infinite: (roadmapId: string, userId: string, filters?: Omit<TaskFilters, "start" | "limit">) => readonly ["tasks", "infinite", string, string, Omit<TaskFilters, "start" | "limit"> | undefined];
     details: () => readonly ["tasks", "detail"];
     detail: (id: string) => readonly ["tasks", "detail", string];
+    creators: (roadmapId: string) => readonly ["tasks", "creators", string];
 };
 export declare function useTasks(missionId: string | null, enabled: boolean): import("@tanstack/react-query").UseQueryResult<Task[], Error>;
+export declare function useTaskCreators(roadmapId: string | null, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<User[], Error>;
 export declare function useAllUserTasks(missionLinkIds: string[], enabled: boolean): import("@tanstack/react-query").UseQueryResult<Task[], Error>;
 export declare function useTasksByRoadmapId(roadmapId: string | null, userId: string | null, enabled: boolean): import("@tanstack/react-query").UseQueryResult<Task[], Error>;
 /**
@@ -17,10 +20,36 @@ export declare function useTasksByRoadmapId(roadmapId: string | null, userId: st
 export declare function useTasksInfinite(roadmapId: string | null, userId: string | null, filters?: Omit<TaskFilters, "start" | "limit">, options?: {
     enabled?: boolean;
     pageSize?: number;
-}): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<PaginatedResult<Task>, unknown>, Error>;
-export declare function useCreateTask(): import("@tanstack/react-query").UseMutationResult<Task, Error, Partial<Task>, unknown>;
-export declare function useUpdateTask(): import("@tanstack/react-query").UseMutationResult<Task, Error, {
+}): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<PaginatedResult<Task>, unknown>, Error>;
+export interface OptimisticOptions {
+    optimistic?: boolean;
+}
+export declare function useCreateTask(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<Task, Error, Partial<Task>, {
+    previousTasks: Task[] | undefined;
+} | undefined>;
+export declare function useUpdateTask(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<Task, Error, {
     id: string;
     data: Partial<Task>;
-}, unknown>;
-export declare function useDeleteTask(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+}, {
+    previousTasksMap: Map<string, unknown>;
+} | undefined>;
+export declare function useDeleteTask(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<void, Error, string, {
+    previousTasksMap: Map<string, unknown>;
+} | undefined>;
+export declare function useBulkDeleteTasks(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<{
+    deleted: string[];
+}, Error, string[], {
+    previousTasksMap: Map<string, unknown>;
+} | undefined>;
+export declare function useBulkUpdateTasks(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<{
+    updated: any[];
+}, Error, {
+    ids: string[];
+    data: {
+        dueDate?: string | null;
+        status?: string;
+    };
+}, {
+    previousTasksMap: Map<string, unknown>;
+} | undefined>;
+export declare function useGetDownloadUrl(): import("@tanstack/react-query").UseMutationResult<import("../../core/types").DownloadUrlResponse, Error, string, unknown>;

package/dist/react/hooks/useTasks.js

@@ -12,12 +12,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.taskKeys = void 0;
 exports.useTasks = useTasks;
+exports.useTaskCreators = useTaskCreators;
 exports.useAllUserTasks = useAllUserTasks;
 exports.useTasksByRoadmapId = useTasksByRoadmapId;
 exports.useTasksInfinite = useTasksInfinite;
 exports.useCreateTask = useCreateTask;
 exports.useUpdateTask = useUpdateTask;
 exports.useDeleteTask = useDeleteTask;
+exports.useBulkDeleteTasks = useBulkDeleteTasks;
+exports.useBulkUpdateTasks = useBulkUpdateTasks;
+exports.useGetDownloadUrl = useGetDownloadUrl;
 const react_query_1 = require("@tanstack/react-query");
 const provider_1 = require("../provider");
 // Query keys
@@ -28,6 +32,7 @@ exports.taskKeys = {
     infinite: (roadmapId, userId, filters) => [...exports.taskKeys.all, "infinite", roadmapId, userId, filters],
     details: () => [...exports.taskKeys.all, "detail"],
     detail: (id) => [...exports.taskKeys.details(), id],
+    creators: (roadmapId) => [...exports.taskKeys.all, "creators", roadmapId],
 };
 function useTasks(missionId, enabled) {
     const client = (0, provider_1.useCrimsonClient)();
@@ -43,6 +48,19 @@ function useTasks(missionId, enabled) {
         enabled: !!missionId && enabled,
     });
 }
+function useTaskCreators(roadmapId, enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.taskKeys.creators(roadmapId || ""),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            if (!roadmapId) {
+                return [];
+            }
+            return client.tasks.getCreators(roadmapId);
+        }),
+        enabled: !!roadmapId && enabled,
+    });
+}
 function useAllUserTasks(missionLinkIds, enabled) {
     const client = (0, provider_1.useCrimsonClient)();
     return (0, react_query_1.useQuery)({
@@ -105,33 +123,229 @@ function useTasksInfinite(roadmapId, userId, filters, options) {
         enabled: !!roadmapId && !!userId && enabled,
     });
 }
-function useCreateTask() {
+function useCreateTask(options) {
+    var _a;
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
     return (0, react_query_1.useMutation)({
         mutationFn: (data) => client.tasks.create(data),
-        onSuccess: () => {
+        onMutate: (newTask) => __awaiter(this, void 0, void 0, function* () {
+            if (!optimistic || !newTask.missionId)
+                return;
+            const queryKey = exports.taskKeys.list(newTask.missionId);
+            yield queryClient.cancelQueries({ queryKey });
+            const previousTasks = queryClient.getQueryData(queryKey);
+            if (previousTasks) {
+                const optimisticTask = Object.assign({ id: `temp-${Date.now()}`, name: "New Task", status: "PLANNED", date: new Date().toISOString(), roadmapMissionId: "", userId: "" }, newTask);
+                queryClient.setQueryData(queryKey, (old) => {
+                    return old ? [...old, optimisticTask] : [optimisticTask];
+                });
+            }
+            return { previousTasks };
+        }),
+        onError: (err, newTodo, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousTasks) || !newTodo.missionId)
+                return;
+            queryClient.setQueryData(exports.taskKeys.list(newTodo.missionId), context.previousTasks);
+        },
+        onSettled: () => {
             queryClient.invalidateQueries({ queryKey: exports.taskKeys.all });
         },
     });
 }
-function useUpdateTask() {
+function useUpdateTask(options) {
+    var _a;
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
     return (0, react_query_1.useMutation)({
         mutationFn: ({ id, data }) => client.tasks.update(id, data),
-        onSuccess: () => {
+        onMutate: (_a) => __awaiter(this, [_a], void 0, function* ({ id, data }) {
+            if (!optimistic)
+                return;
+            yield queryClient.cancelQueries({ queryKey: exports.taskKeys.all });
+            const previousTasksMap = new Map();
+            // Update basic list and infinite queries
+            queryClient
+                .getQueriesData({ queryKey: exports.taskKeys.all })
+                .forEach(([key, old]) => {
+                previousTasksMap.set(JSON.stringify(key), old);
+                if (!old)
+                    return;
+                // Handle Infinite Query Support
+                if (typeof old === "object" &&
+                    "pages" in old &&
+                    Array.isArray(old.pages)) {
+                    queryClient.setQueryData(key, (oldData) => {
+                        if (!oldData)
+                            return oldData;
+                        return Object.assign(Object.assign({}, oldData), { pages: oldData.pages.map((page) => (Object.assign(Object.assign({}, page), { data: page.data.map((task) => task.id === id ? Object.assign(Object.assign({}, task), data) : task) }))) });
+                    });
+                }
+                // Handle Standard List Support
+                else if (Array.isArray(old)) {
+                    queryClient.setQueryData(key, (oldData) => oldData === null || oldData === void 0 ? void 0 : oldData.map((task) => task.id === id ? Object.assign(Object.assign({}, task), data) : task));
+                }
+            });
+            return { previousTasksMap };
+        }),
+        onError: (err, { id }, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousTasksMap))
+                return;
+            context.previousTasksMap.forEach((old, keyStr) => {
+                queryClient.setQueryData(JSON.parse(keyStr), old);
+            });
+        },
+        onSettled: () => {
             queryClient.invalidateQueries({ queryKey: exports.taskKeys.all });
         },
     });
 }
-function useDeleteTask() {
+function useDeleteTask(options) {
+    var _a;
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
     return (0, react_query_1.useMutation)({
         mutationFn: (id) => client.tasks.delete(id),
-        onSuccess: () => {
+        onMutate: (id) => __awaiter(this, void 0, void 0, function* () {
+            if (!optimistic)
+                return;
+            yield queryClient.cancelQueries({ queryKey: exports.taskKeys.all });
+            const previousTasksMap = new Map();
+            queryClient
+                .getQueriesData({ queryKey: exports.taskKeys.all })
+                .forEach(([key, old]) => {
+                previousTasksMap.set(JSON.stringify(key), old);
+                if (!old)
+                    return;
+                // Handle Infinite Query Support
+                if (typeof old === "object" &&
+                    "pages" in old &&
+                    Array.isArray(old.pages)) {
+                    queryClient.setQueryData(key, (oldData) => {
+                        if (!oldData)
+                            return oldData;
+                        return Object.assign(Object.assign({}, oldData), { pages: oldData.pages.map((page) => (Object.assign(Object.assign({}, page), { data: page.data.filter((task) => task.id !== id) }))) });
+                    });
+                }
+                // Handle Standard List Support
+                else if (Array.isArray(old)) {
+                    queryClient.setQueryData(key, (oldData) => oldData === null || oldData === void 0 ? void 0 : oldData.filter((task) => task.id !== id));
+                }
+            });
+            return { previousTasksMap };
+        }),
+        onError: (err, id, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousTasksMap))
+                return;
+            context.previousTasksMap.forEach((old, keyStr) => {
+                queryClient.setQueryData(JSON.parse(keyStr), old);
+            });
+        },
+        onSettled: () => {
             queryClient.invalidateQueries({ queryKey: exports.taskKeys.all });
         },
     });
 }
+function useBulkDeleteTasks(options) {
+    var _a;
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
+    return (0, react_query_1.useMutation)({
+        mutationFn: (ids) => client.tasks.bulkDelete(ids),
+        onMutate: (ids) => __awaiter(this, void 0, void 0, function* () {
+            if (!optimistic)
+                return;
+            yield queryClient.cancelQueries({ queryKey: exports.taskKeys.all });
+            const previousTasksMap = new Map();
+            queryClient
+                .getQueriesData({ queryKey: exports.taskKeys.all })
+                .forEach(([key, old]) => {
+                previousTasksMap.set(JSON.stringify(key), old);
+                if (!old)
+                    return;
+                // Handle Infinite Query Support
+                if (typeof old === "object" &&
+                    "pages" in old &&
+                    Array.isArray(old.pages)) {
+                    queryClient.setQueryData(key, (oldData) => {
+                        if (!oldData)
+                            return oldData;
+                        return Object.assign(Object.assign({}, oldData), { pages: oldData.pages.map((page) => (Object.assign(Object.assign({}, page), { data: page.data.filter((task) => !ids.includes(task.id)) }))) });
+                    });
+                }
+                // Handle Standard List Support
+                else if (Array.isArray(old)) {
+                    queryClient.setQueryData(key, (oldData) => oldData === null || oldData === void 0 ? void 0 : oldData.filter((task) => !ids.includes(task.id)));
+                }
+            });
+            return { previousTasksMap };
+        }),
+        onError: (err, ids, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousTasksMap))
+                return;
+            context.previousTasksMap.forEach((old, keyStr) => {
+                queryClient.setQueryData(JSON.parse(keyStr), old);
+            });
+        },
+        onSettled: () => {
+            queryClient.invalidateQueries({ queryKey: exports.taskKeys.all });
+        },
+    });
+}
+function useBulkUpdateTasks(options) {
+    var _a;
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    const optimistic = (_a = options === null || options === void 0 ? void 0 : options.optimistic) !== null && _a !== void 0 ? _a : true;
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ ids, data, }) => client.tasks.bulkUpdate(ids, data),
+        onMutate: (_a) => __awaiter(this, [_a], void 0, function* ({ ids, data }) {
+            if (!optimistic)
+                return;
+            yield queryClient.cancelQueries({ queryKey: exports.taskKeys.all });
+            const previousTasksMap = new Map();
+            queryClient
+                .getQueriesData({ queryKey: exports.taskKeys.all })
+                .forEach(([key, old]) => {
+                previousTasksMap.set(JSON.stringify(key), old);
+                if (!old)
+                    return;
+                // Handle Infinite Query Support
+                if (typeof old === "object" &&
+                    "pages" in old &&
+                    Array.isArray(old.pages)) {
+                    queryClient.setQueryData(key, (oldData) => {
+                        if (!oldData)
+                            return oldData;
+                        return Object.assign(Object.assign({}, oldData), { pages: oldData.pages.map((page) => (Object.assign(Object.assign({}, page), { data: page.data.map((task) => ids.includes(task.id) ? Object.assign(Object.assign({}, task), data) : task) }))) });
+                    });
+                }
+                // Handle Standard List Support
+                else if (Array.isArray(old)) {
+                    queryClient.setQueryData(key, (oldData) => oldData === null || oldData === void 0 ? void 0 : oldData.map((task) => ids.includes(task.id) ? Object.assign(Object.assign({}, task), data) : task));
+                }
+            });
+            return { previousTasksMap };
+        }),
+        onError: (err, variables, context) => {
+            if (!optimistic || !(context === null || context === void 0 ? void 0 : context.previousTasksMap))
+                return;
+            context.previousTasksMap.forEach((old, keyStr) => {
+                queryClient.setQueryData(JSON.parse(keyStr), old);
+            });
+        },
+        onSettled: () => {
+            queryClient.invalidateQueries({ queryKey: exports.taskKeys.all });
+        },
+    });
+}
+function useGetDownloadUrl() {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (key) => client.tasks.getDownloadUrl(key),
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crimson-education/sdk",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Crimson SDK for accessing Crimson App APIs",
   "main": "dist/index.js",
   "module": "dist/index.js",