@crimson-education/sdk 0.2.0 → 0.2.2

package/README.md

@@ -1,10 +1,10 @@
-# @crimson/sdk 使用文档
+# @crimson-education/sdk 使用文档
 
-`@crimson/sdk` 是一个用于访问 Crimson App（Roadmap 相关）后端接口的 TypeScript SDK，包含三层能力：
+`@crimson-education/sdk` 是一个用于访问 Crimson App（Roadmap 相关）后端接口的 TypeScript SDK，包含三层能力：
 
 - **Core（框架无关）**：`CrimsonClient` + 各业务 API（missions / tasks / roadmap / users / mission library）
 - **iframe（跨域/嵌入场景）**：通过 `postMessage` 初始化鉴权信息，并提供可订阅的鉴权状态
-- **React（可选）**：基于 `@tanstack/react-query` 的 Provider 与 Hooks（通过 `@crimson/sdk/react` 引入）
+- **React（可选）**：基于 `@tanstack/react-query` 的 Provider 与 Hooks（通过 `@crimson-education/sdk/react` 引入）
 
 > 说明：SDK 默认依赖运行时 `fetch`。在 Node.js 环境建议使用 Node 18+（内置 `fetch`），或自行注入/polyfill。
 
@@ -17,7 +17,7 @@
 如果已发布到 npm：
 
 ```bash
-npm i @crimson/sdk
+npm i @crimson-education/sdk
 ```
 
 ### 本地开发构建
@@ -36,7 +36,7 @@ npm run build
 ## 快速开始（Core）
 
 ```ts
-import { createCrimsonClient } from "@crimson/sdk";
+import { createCrimsonClient } from "@crimson-education/sdk";
 
 const client = createCrimsonClient({
   apiUrl: "https://api.example.com",
@@ -225,7 +225,7 @@ SDK 会将后端返回的 action item 做归一化，保证至少返回以下核
 
 ## iframe 层（嵌入/跨域场景）
 
-入口：`@crimson/sdk`（主入口会导出 iframe 层）
+入口：`@crimson-education/sdk`（主入口会导出 iframe 层）
 
 典型用法：
 
@@ -268,7 +268,7 @@ window.frames[0]?.postMessage(
 
 ---
 
-## React 层（`@crimson/sdk/react`）
+## React 层（`@crimson-education/sdk/react`）
 
 React 层通过 `peerDependencies` 声明依赖（不会强制安装）：
 
@@ -278,7 +278,7 @@ React 层通过 `peerDependencies` 声明依赖（不会强制安装）：
 ### CrimsonProvider
 
 ```tsx
-import { CrimsonProvider } from "@crimson/sdk/react";
+import { CrimsonProvider } from "@crimson-education/sdk/react";
 
 export function App() {
   return (

package/dist/core/account.d.ts

@@ -1,5 +1,5 @@
 import type { CrimsonClient } from "./client";
-import type { CurrentUserRoles } from "./types";
+import type { CurrentUserRoles, StudentSummary } from "./types";
 export declare class AccountApi {
     private client;
     constructor(client: CrimsonClient);
@@ -11,4 +11,15 @@ export declare class AccountApi {
      *   - roles: Array of role objects with roleId and isPrimary flag
      */
     getCurrentUserRoles(): Promise<CurrentUserRoles>;
+    /**
+     * Get the list of students associated with the current logged-in user.
+     *
+     * This is primarily used for staff users (Strategists, SSMs, etc.) to get
+     * their list of students for the student selection page after OAuth login.
+     *
+     * For student users, this will return an empty array.
+     *
+     * @returns Array of student summaries with basic info for display
+     */
+    getMyStudents(): Promise<StudentSummary[]>;
 }

package/dist/core/account.js

@@ -26,5 +26,21 @@ class AccountApi {
             return this.client.fetch("/api/v1/account/me/roles");
         });
     }
+    /**
+     * Get the list of students associated with the current logged-in user.
+     *
+     * This is primarily used for staff users (Strategists, SSMs, etc.) to get
+     * their list of students for the student selection page after OAuth login.
+     *
+     * For student users, this will return an empty array.
+     *
+     * @returns Array of student summaries with basic info for display
+     */
+    getMyStudents() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.client.fetch("/api/v1/account/me/students");
+            return response.data;
+        });
+    }
 }
 exports.AccountApi = AccountApi;

package/dist/core/missionLibrary.d.ts

@@ -15,6 +15,17 @@ export interface TemplateTaskFilters extends PaginationParams {
     keywordType?: string;
     userId?: string;
 }
+export interface TemplateTaskUpdateInput {
+    id?: string;
+    title?: string;
+    description?: string;
+    operation: string;
+}
+export interface TemplateMissionUpdateInput {
+    title?: string;
+    description?: string;
+    tasks?: TemplateTaskUpdateInput[];
+}
 export interface CopyTemplateMissionInput {
     linkId: string;
     userId: string;
@@ -39,6 +50,15 @@ export declare class MissionLibraryApi {
      * List template tasks with pagination
      */
     listTemplateTasks(filters?: TemplateTaskFilters): Promise<PaginatedResult<TemplateTask>>;
+    /**
+     * Update title/description/tasks of a template mission.
+     * Should ensure the mission is a 'custom' mission before calling this.
+     * @param id {string} missionId
+     * @param raw {TemplateMission} The original template mission
+     * @param data {TemplateMissionUpdateInput} Fields to be updated
+     * @returns {Promise<TemplateMission>} The updated template mission
+     */
+    updateTemplateMission(id: string, raw: TemplateMission, update: TemplateMissionUpdateInput): Promise<TemplateMission>;
     /**
      * Copy a template mission to a user's roadmap
      */

package/dist/core/missionLibrary.js

@@ -87,6 +87,32 @@ class MissionLibraryApi {
             return this.client.fetch(path);
         });
     }
+    /**
+     * Update title/description/tasks of a template mission.
+     * Should ensure the mission is a 'custom' mission before calling this.
+     * @param id {string} missionId
+     * @param raw {TemplateMission} The original template mission
+     * @param data {TemplateMissionUpdateInput} Fields to be updated
+     * @returns {Promise<TemplateMission>} The updated template mission
+     */
+    updateTemplateMission(id, raw, update) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const data = {
+                title: (_a = update.title) !== null && _a !== void 0 ? _a : raw.title,
+                description: (_b = update.description) !== null && _b !== void 0 ? _b : raw.description,
+                tasks: update.tasks || [],
+                // only allow updatecustom
+                type: 'custom',
+                category: raw.category,
+                subcategory: raw.subcategory,
+            };
+            return this.client.fetch(`/roadmap/library/missions/${id}`, {
+                method: "PUT",
+                body: JSON.stringify(data),
+            });
+        });
+    }
     /**
      * Copy a template mission to a user's roadmap
      */

package/dist/core/types.d.ts

@@ -362,6 +362,23 @@ export interface CurrentUserRoles {
     userId: string;
     roles: UserRoleInfo[];
 }
+/**
+ * Summary information for a student (used in student selection)
+ */
+export interface StudentSummary {
+    userId: string;
+    firstName: string;
+    lastName: string;
+    fullName: string;
+    email: string;
+    profileImageUrl: string | null;
+}
+/**
+ * Response from the /api/v1/account/me/students endpoint
+ */
+export interface MyStudentsResponse {
+    data: StudentSummary[];
+}
 /**
  * Prefilled field with value and source information
  */

package/dist/iframe/auth-state.d.ts

@@ -5,3 +5,23 @@ export declare function getUserId(): string | null;
 export declare function getAuthState(): AuthState;
 export declare function subscribeToAuthState(callback: () => void): () => void;
 export declare function persistStandaloneAuth(payload: ZoidProps): void;
+/**
+ * Check if the app is running in iframe mode (embedded in parent window)
+ */
+export declare function isIframeMode(): boolean;
+/**
+ * Set token in localStorage (used after OAuth callback)
+ */
+export declare function setToken(token: string): void;
+/**
+ * Set student ID in localStorage (used after student selection)
+ */
+export declare function setStudentId(studentId: string): void;
+/**
+ * Set user ID in localStorage (used after OAuth callback)
+ */
+export declare function setUserId(userId: string): void;
+/**
+ * Clear all auth data from localStorage (used for logout)
+ */
+export declare function clearAuth(): void;

package/dist/iframe/auth-state.js

@@ -6,6 +6,11 @@ exports.getUserId = getUserId;
 exports.getAuthState = getAuthState;
 exports.subscribeToAuthState = subscribeToAuthState;
 exports.persistStandaloneAuth = persistStandaloneAuth;
+exports.isIframeMode = isIframeMode;
+exports.setToken = setToken;
+exports.setStudentId = setStudentId;
+exports.setUserId = setUserId;
+exports.clearAuth = clearAuth;
 const constants_1 = require("./constants");
 const readFromLocalStorage = (key) => {
     if (typeof window === "undefined")
@@ -123,3 +128,69 @@ function persistStandaloneAuth(payload) {
     window.xprops = payload;
     window.dispatchEvent(new CustomEvent(constants_1.XPROPS_READY_EVENT));
 }
+// Helper to trigger auth state change notification
+function notifyAuthStateChange() {
+    if (typeof window === "undefined")
+        return;
+    // Invalidate cached state
+    cachedAuthState = null;
+    // Dispatch event to notify subscribers
+    window.dispatchEvent(new CustomEvent(constants_1.XPROPS_READY_EVENT));
+}
+/**
+ * Check if the app is running in iframe mode (embedded in parent window)
+ */
+function isIframeMode() {
+    if (typeof window === "undefined")
+        return false;
+    try {
+        return window.self !== window.top;
+    }
+    catch (_a) {
+        // If we can't access window.top due to cross-origin, we're in an iframe
+        return true;
+    }
+}
+/**
+ * Set token in localStorage (used after OAuth callback)
+ */
+function setToken(token) {
+    if (typeof window === "undefined")
+        return;
+    writeToLocalStorage(constants_1.STORAGE_KEYS.token, token);
+    notifyAuthStateChange();
+}
+/**
+ * Set student ID in localStorage (used after student selection)
+ */
+function setStudentId(studentId) {
+    if (typeof window === "undefined")
+        return;
+    writeToLocalStorage(constants_1.STORAGE_KEYS.studentId, studentId);
+    notifyAuthStateChange();
+}
+/**
+ * Set user ID in localStorage (used after OAuth callback)
+ */
+function setUserId(userId) {
+    if (typeof window === "undefined")
+        return;
+    writeToLocalStorage(constants_1.STORAGE_KEYS.userId, userId);
+    notifyAuthStateChange();
+}
+/**
+ * Clear all auth data from localStorage (used for logout)
+ */
+function clearAuth() {
+    if (typeof window === "undefined")
+        return;
+    try {
+        localStorage.removeItem(constants_1.STORAGE_KEYS.token);
+        localStorage.removeItem(constants_1.STORAGE_KEYS.userId);
+        localStorage.removeItem(constants_1.STORAGE_KEYS.studentId);
+    }
+    catch (_a) {
+        // Ignore storage errors
+    }
+    notifyAuthStateChange();
+}

package/dist/iframe/index.d.ts

@@ -1,5 +1,5 @@
 export { setupIframeListener } from "./listener";
 export type { CleanupFn } from "./listener";
-export { getToken, getUserId, getStudentId, getAuthState, subscribeToAuthState, persistStandaloneAuth, } from "./auth-state";
+export { getToken, getUserId, getStudentId, getAuthState, subscribeToAuthState, persistStandaloneAuth, isIframeMode, setToken, setStudentId, setUserId, clearAuth, } from "./auth-state";
 export { XPROPS_READY_EVENT, STORAGE_KEYS, VIRTUAL_MISSION_ID, getDefaultAllowedOrigins, } from "./constants";
 export type { ZoidProps, AuthState } from "./types";

package/dist/iframe/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDefaultAllowedOrigins = exports.VIRTUAL_MISSION_ID = exports.STORAGE_KEYS = exports.XPROPS_READY_EVENT = exports.persistStandaloneAuth = exports.subscribeToAuthState = exports.getAuthState = exports.getStudentId = exports.getUserId = exports.getToken = exports.setupIframeListener = void 0;
+exports.getDefaultAllowedOrigins = exports.VIRTUAL_MISSION_ID = exports.STORAGE_KEYS = exports.XPROPS_READY_EVENT = exports.clearAuth = exports.setUserId = exports.setStudentId = exports.setToken = exports.isIframeMode = exports.persistStandaloneAuth = exports.subscribeToAuthState = exports.getAuthState = exports.getStudentId = exports.getUserId = exports.getToken = exports.setupIframeListener = void 0;
 var listener_1 = require("./listener");
 Object.defineProperty(exports, "setupIframeListener", { enumerable: true, get: function () { return listener_1.setupIframeListener; } });
 var auth_state_1 = require("./auth-state");
@@ -10,6 +10,11 @@ Object.defineProperty(exports, "getStudentId", { enumerable: true, get: function
 Object.defineProperty(exports, "getAuthState", { enumerable: true, get: function () { return auth_state_1.getAuthState; } });
 Object.defineProperty(exports, "subscribeToAuthState", { enumerable: true, get: function () { return auth_state_1.subscribeToAuthState; } });
 Object.defineProperty(exports, "persistStandaloneAuth", { enumerable: true, get: function () { return auth_state_1.persistStandaloneAuth; } });
+Object.defineProperty(exports, "isIframeMode", { enumerable: true, get: function () { return auth_state_1.isIframeMode; } });
+Object.defineProperty(exports, "setToken", { enumerable: true, get: function () { return auth_state_1.setToken; } });
+Object.defineProperty(exports, "setStudentId", { enumerable: true, get: function () { return auth_state_1.setStudentId; } });
+Object.defineProperty(exports, "setUserId", { enumerable: true, get: function () { return auth_state_1.setUserId; } });
+Object.defineProperty(exports, "clearAuth", { enumerable: true, get: function () { return auth_state_1.clearAuth; } });
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "XPROPS_READY_EVENT", { enumerable: true, get: function () { return constants_1.XPROPS_READY_EVENT; } });
 Object.defineProperty(exports, "STORAGE_KEYS", { enumerable: true, get: function () { return constants_1.STORAGE_KEYS; } });

package/dist/index.js

@@ -18,5 +18,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./core"), exports);
 // iframe layer (postMessage communication)
 __exportStar(require("./iframe"), exports);
-// React layer is available via "@crimson/sdk/react" subpath
+// React layer is available via "@crimson-education/sdk/react" subpath
 // Do NOT export here to avoid forcing React dependency on non-React consumers

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

@@ -4,7 +4,7 @@ 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 { useUsers, useUser, userKeys } from "./useUsers";
-export { useCurrentUserRoles, accountKeys } from "./useAccount";
+export { useCurrentUserRoles, useMyStudents, accountKeys } from "./useAccount";
 export { useRoadmapContext } from "./useRoadmapContext";
-export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, } from "./useMissionLibrary";
+export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useUpdateTemplateMission, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, } 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.useTemplateMissionDetail = exports.useTemplateTasksInfinite = exports.useTemplateTasks = exports.useTemplateMissionsInfinite = exports.useTemplateMissions = exports.useRoadmapContext = exports.accountKeys = 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.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;
 var useAuthState_1 = require("./useAuthState");
 Object.defineProperty(exports, "useAuthState", { enumerable: true, get: function () { return useAuthState_1.useAuthState; } });
 var useOAuth_1 = require("./useOAuth");
@@ -28,6 +28,7 @@ Object.defineProperty(exports, "useUser", { enumerable: true, get: function () {
 Object.defineProperty(exports, "userKeys", { enumerable: true, get: function () { return useUsers_1.userKeys; } });
 var useAccount_1 = require("./useAccount");
 Object.defineProperty(exports, "useCurrentUserRoles", { enumerable: true, get: function () { return useAccount_1.useCurrentUserRoles; } });
+Object.defineProperty(exports, "useMyStudents", { enumerable: true, get: function () { return useAccount_1.useMyStudents; } });
 Object.defineProperty(exports, "accountKeys", { enumerable: true, get: function () { return useAccount_1.accountKeys; } });
 var useRoadmapContext_1 = require("./useRoadmapContext");
 Object.defineProperty(exports, "useRoadmapContext", { enumerable: true, get: function () { return useRoadmapContext_1.useRoadmapContext; } });
@@ -37,6 +38,7 @@ Object.defineProperty(exports, "useTemplateMissionsInfinite", { enumerable: true
 Object.defineProperty(exports, "useTemplateTasks", { enumerable: true, get: function () { return useMissionLibrary_1.useTemplateTasks; } });
 Object.defineProperty(exports, "useTemplateTasksInfinite", { enumerable: true, get: function () { return useMissionLibrary_1.useTemplateTasksInfinite; } });
 Object.defineProperty(exports, "useTemplateMissionDetail", { enumerable: true, get: function () { return useMissionLibrary_1.useTemplateMissionDetail; } });
+Object.defineProperty(exports, "useUpdateTemplateMission", { enumerable: true, get: function () { return useMissionLibrary_1.useUpdateTemplateMission; } });
 Object.defineProperty(exports, "useCopyTemplateMission", { enumerable: true, get: function () { return useMissionLibrary_1.useCopyTemplateMission; } });
 Object.defineProperty(exports, "useAssignBulkMission", { enumerable: true, get: function () { return useMissionLibrary_1.useAssignBulkMission; } });
 Object.defineProperty(exports, "useAssignBulkTask", { enumerable: true, get: function () { return useMissionLibrary_1.useAssignBulkTask; } });

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

@@ -1,7 +1,8 @@
-import type { CurrentUserRoles } from "../../core/types";
+import type { CurrentUserRoles, StudentSummary } from "../../core/types";
 export declare const accountKeys: {
     all: readonly ["account"];
     currentUserRoles: () => readonly ["account", "currentUserRoles"];
+    myStudents: () => readonly ["account", "myStudents"];
 };
 /**
  * Hook to get current user's roles
@@ -11,3 +12,15 @@ export declare const accountKeys: {
  *   - roles: Array of role objects with roleId and isPrimary flag
  */
 export declare function useCurrentUserRoles(enabled?: boolean): import("@tanstack/react-query").UseQueryResult<CurrentUserRoles, Error>;
+/**
+ * Hook to get the list of students associated with the current user.
+ *
+ * This is primarily used for staff users (Strategists, SSMs, etc.) to get
+ * their list of students for the student selection page after OAuth login.
+ *
+ * For student users, this will return an empty array.
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing array of student summaries
+ */
+export declare function useMyStudents(enabled?: boolean): import("@tanstack/react-query").UseQueryResult<StudentSummary[], Error>;

package/dist/react/hooks/useAccount.js

@@ -12,12 +12,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.accountKeys = void 0;
 exports.useCurrentUserRoles = useCurrentUserRoles;
+exports.useMyStudents = useMyStudents;
 const react_query_1 = require("@tanstack/react-query");
 const provider_1 = require("../provider");
 // Query keys
 exports.accountKeys = {
     all: ["account"],
     currentUserRoles: () => [...exports.accountKeys.all, "currentUserRoles"],
+    myStudents: () => [...exports.accountKeys.all, "myStudents"],
 };
 /**
  * Hook to get current user's roles
@@ -37,3 +39,25 @@ function useCurrentUserRoles(enabled = true) {
         staleTime: 1000 * 60 * 5, // 5 minutes - roles don't change often
     });
 }
+/**
+ * Hook to get the list of students associated with the current user.
+ *
+ * This is primarily used for staff users (Strategists, SSMs, etc.) to get
+ * their list of students for the student selection page after OAuth login.
+ *
+ * For student users, this will return an empty array.
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing array of student summaries
+ */
+function useMyStudents(enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.accountKeys.myStudents(),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            return client.account.getMyStudents();
+        }),
+        enabled,
+        staleTime: 1000 * 60 * 5, // 5 minutes - student list doesn't change often
+    });
+}

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 } from "../../core/missionLibrary";
+import type { TemplateMissionFilters, TemplateTaskFilters, CopyTemplateMissionInput, CreateFromPredefinedInput, TemplateMissionUpdateInput } from "../../core/missionLibrary";
 export declare const missionLibraryKeys: {
     all: readonly ["missionLibrary"];
     missions: (filters?: TemplateMissionFilters) => readonly ["missionLibrary", "missions", TemplateMissionFilters | undefined];
@@ -19,6 +19,11 @@ export declare function useTemplateTasksInfinite(filters?: Omit<TemplateTaskFilt
     pageSize?: number;
 }): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<import("../../core/types").PaginatedResult<TemplateTask>, unknown>, Error>;
 export declare function useTemplateMissionDetail(missionId: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<MissionDetail | null, Error>;
+export declare function useUpdateTemplateMission(): import("@tanstack/react-query").UseMutationResult<TemplateMission, Error, {
+    id: string;
+    raw: TemplateMission;
+    update: TemplateMissionUpdateInput;
+}, 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

@@ -16,6 +16,7 @@ exports.useTemplateMissionsInfinite = useTemplateMissionsInfinite;
 exports.useTemplateTasks = useTemplateTasks;
 exports.useTemplateTasksInfinite = useTemplateTasksInfinite;
 exports.useTemplateMissionDetail = useTemplateMissionDetail;
+exports.useUpdateTemplateMission = useUpdateTemplateMission;
 exports.useCopyTemplateMission = useCopyTemplateMission;
 exports.useAssignBulkMission = useAssignBulkMission;
 exports.useAssignBulkTask = useAssignBulkTask;
@@ -103,6 +104,23 @@ function useTemplateMissionDetail(missionId, enabled = true) {
     });
 }
 // --- Mutations ---
+function useUpdateTemplateMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ id, raw, update }) => client.library.updateTemplateMission(id, raw, update),
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({
+                queryKey: exports.missionLibraryKeys.missionDetail(variables.id),
+            });
+            queryClient.invalidateQueries({
+                queryKey: exports.missionLibraryKeys.missionsInfinite({
+                    groups: ['custom']
+                })
+            });
+        },
+    });
+}
 function useCopyTemplateMission() {
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crimson-education/sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Crimson SDK for accessing Crimson App APIs",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -41,8 +41,8 @@
   },
   "homepage": "https://github.com/crimson-education/crimson-sdk#readme",
   "peerDependencies": {
-    "react": ">=18.0.0",
-    "@tanstack/react-query": ">=5.0.0"
+    "@tanstack/react-query": ">=5.0.0",
+    "react": ">=18.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -53,9 +53,12 @@
     }
   },
   "devDependencies": {
+    "@tanstack/react-query": "^5.90.15",
     "@types/node": "^24.10.1",
+    "@types/react": "^19.2.7",
     "chai": "^6.2.1",
     "mocha": "^11.7.5",
+    "react": "^19.2.3",
     "typescript": "^5.0.0"
   }
 }