@crimson-education/sdk 0.2.0

package/dist/iframe/listener.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupIframeListener = setupIframeListener;
+const constants_1 = require("./constants");
+function setupIframeListener(allowedOrigins) {
+    if (typeof window === "undefined") {
+        return () => { };
+    }
+    const origins = allowedOrigins || (0, constants_1.getDefaultAllowedOrigins)();
+    // Notify parent that iframe is ready
+    if (window.self !== window.top && window.parent) {
+        try {
+            window.parent.postMessage({
+                type: "IFRAME_READY",
+                source: "new-roadmap-ui",
+                timestamp: Date.now(),
+            }, "*");
+        }
+        catch (_a) {
+            // Silently fail - parent notification is not critical
+        }
+    }
+    const messageHandler = (event) => {
+        if (!origins.includes(event.origin)) {
+            console.warn(`[iframe-listener] Rejected unauthorized origin: ${event.origin}`, `Allowed origins:`, origins);
+            return;
+        }
+        const isLocalhost = event.origin.includes("localhost") || event.origin.includes("127.0.0.1");
+        const isHttps = event.origin.startsWith("https://");
+        if (!isLocalhost && !isHttps) {
+            console.error(`[iframe-listener] Insecure HTTP connection from ${event.origin}`);
+            if (process.env.NODE_ENV === "production") {
+                return;
+            }
+        }
+        if (event.data && event.data.type === "INIT") {
+            const { token, userId, studentId, user } = event.data.payload || {};
+            if (token && studentId) {
+                window.xprops = {
+                    token,
+                    userId,
+                    studentId,
+                    user,
+                };
+                window.dispatchEvent(new CustomEvent(constants_1.XPROPS_READY_EVENT));
+            }
+            else {
+                console.warn("[iframe-listener] Missing token or studentId in INIT message");
+            }
+        }
+    };
+    window.addEventListener("message", messageHandler);
+    // Return cleanup function
+    return () => {
+        window.removeEventListener("message", messageHandler);
+    };
+}

package/dist/iframe/types.d.ts

@@ -0,0 +1,18 @@
+export interface ZoidProps {
+    token: string;
+    userId: string;
+    studentId: string;
+    user?: Record<string, unknown>;
+}
+export interface AuthState {
+    token: string | null;
+    userId: string | null;
+    studentId: string | null;
+    user?: Record<string, unknown>;
+    ready: boolean;
+}
+declare global {
+    interface Window {
+        xprops?: ZoidProps;
+    }
+}

package/dist/iframe/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core";
+export * from "./iframe";

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core layer (framework-agnostic) - backward compatible exports
+__exportStar(require("./core"), exports);
+// iframe layer (postMessage communication)
+__exportStar(require("./iframe"), exports);
+// React layer is available via "@crimson/sdk/react" subpath
+// Do NOT export here to avoid forcing React dependency on non-React consumers

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

@@ -0,0 +1,10 @@
+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 { useUsers, useUser, userKeys } from "./useUsers";
+export { useCurrentUserRoles, accountKeys } from "./useAccount";
+export { useRoadmapContext } from "./useRoadmapContext";
+export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, } from "./useMissionLibrary";
+export { useStudentProfile, useStudentPrefilledInfo, studentProfileKeys, } from "./useStudentProfile";

package/dist/react/hooks/index.js

@@ -0,0 +1,48 @@
+"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;
+var useAuthState_1 = require("./useAuthState");
+Object.defineProperty(exports, "useAuthState", { enumerable: true, get: function () { return useAuthState_1.useAuthState; } });
+var useOAuth_1 = require("./useOAuth");
+Object.defineProperty(exports, "useOAuth", { enumerable: true, get: function () { return useOAuth_1.useOAuth; } });
+Object.defineProperty(exports, "useOAuthCallback", { enumerable: true, get: function () { return useOAuth_1.useOAuthCallback; } });
+var useMissions_1 = require("./useMissions");
+Object.defineProperty(exports, "useMissions", { enumerable: true, get: function () { return useMissions_1.useMissions; } });
+Object.defineProperty(exports, "useMissionsInfinite", { enumerable: true, get: function () { return useMissions_1.useMissionsInfinite; } });
+Object.defineProperty(exports, "useCreateMission", { enumerable: true, get: function () { return useMissions_1.useCreateMission; } });
+Object.defineProperty(exports, "useUpdateMission", { enumerable: true, get: function () { return useMissions_1.useUpdateMission; } });
+Object.defineProperty(exports, "useDeleteMission", { enumerable: true, get: function () { return useMissions_1.useDeleteMission; } });
+Object.defineProperty(exports, "missionKeys", { enumerable: true, get: function () { return useMissions_1.missionKeys; } });
+var useTasks_1 = require("./useTasks");
+Object.defineProperty(exports, "useTasks", { enumerable: true, get: function () { return useTasks_1.useTasks; } });
+Object.defineProperty(exports, "useAllUserTasks", { enumerable: true, get: function () { return useTasks_1.useAllUserTasks; } });
+Object.defineProperty(exports, "useTasksByRoadmapId", { enumerable: true, get: function () { return useTasks_1.useTasksByRoadmapId; } });
+Object.defineProperty(exports, "useTasksInfinite", { enumerable: true, get: function () { return useTasks_1.useTasksInfinite; } });
+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, "taskKeys", { enumerable: true, get: function () { return useTasks_1.taskKeys; } });
+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; } });
+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, "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; } });
+var useMissionLibrary_1 = require("./useMissionLibrary");
+Object.defineProperty(exports, "useTemplateMissions", { enumerable: true, get: function () { return useMissionLibrary_1.useTemplateMissions; } });
+Object.defineProperty(exports, "useTemplateMissionsInfinite", { enumerable: true, get: function () { return useMissionLibrary_1.useTemplateMissionsInfinite; } });
+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, "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; } });
+Object.defineProperty(exports, "useCreateFromPredefinedTasks", { enumerable: true, get: function () { return useMissionLibrary_1.useCreateFromPredefinedTasks; } });
+Object.defineProperty(exports, "missionLibraryKeys", { enumerable: true, get: function () { return useMissionLibrary_1.missionLibraryKeys; } });
+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; } });
+Object.defineProperty(exports, "studentProfileKeys", { enumerable: true, get: function () { return useStudentProfile_1.studentProfileKeys; } });

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

@@ -0,0 +1,13 @@
+import type { CurrentUserRoles } from "../../core/types";
+export declare const accountKeys: {
+    all: readonly ["account"];
+    currentUserRoles: () => readonly ["account", "currentUserRoles"];
+};
+/**
+ * Hook to get current user's roles
+ *
+ * @returns Query result containing:
+ *   - userId: The user's ID
+ *   - roles: Array of role objects with roleId and isPrimary flag
+ */
+export declare function useCurrentUserRoles(enabled?: boolean): import("@tanstack/react-query").UseQueryResult<CurrentUserRoles, Error>;

package/dist/react/hooks/useAccount.js

@@ -0,0 +1,39 @@
+"use strict";
+"use client";
+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.accountKeys = void 0;
+exports.useCurrentUserRoles = useCurrentUserRoles;
+const react_query_1 = require("@tanstack/react-query");
+const provider_1 = require("../provider");
+// Query keys
+exports.accountKeys = {
+    all: ["account"],
+    currentUserRoles: () => [...exports.accountKeys.all, "currentUserRoles"],
+};
+/**
+ * Hook to get current user's roles
+ *
+ * @returns Query result containing:
+ *   - userId: The user's ID
+ *   - roles: Array of role objects with roleId and isPrimary flag
+ */
+function useCurrentUserRoles(enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.accountKeys.currentUserRoles(),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            return client.account.getCurrentUserRoles();
+        }),
+        enabled,
+        staleTime: 1000 * 60 * 5, // 5 minutes - roles don't change often
+    });
+}

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

@@ -0,0 +1,2 @@
+import { type AuthState } from "../../iframe";
+export declare function useAuthState(): AuthState;

package/dist/react/hooks/useAuthState.js

@@ -0,0 +1,18 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAuthState = useAuthState;
+const react_1 = require("react");
+const iframe_1 = require("../../iframe");
+const emptyState = {
+    token: null,
+    userId: null,
+    studentId: null,
+    user: undefined,
+    ready: false,
+};
+// Server snapshot always returns empty state to ensure consistent SSR
+const getServerSnapshot = () => emptyState;
+function useAuthState() {
+    return (0, react_1.useSyncExternalStore)(iframe_1.subscribeToAuthState, iframe_1.getAuthState, getServerSnapshot);
+}

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

@@ -0,0 +1,31 @@
+import type { TemplateMission, TemplateTask, MissionDetail, AssignBulkMissionInput, AssignBulkTaskInput } from "../../core/types";
+import type { TemplateMissionFilters, TemplateTaskFilters, CopyTemplateMissionInput, CreateFromPredefinedInput } from "../../core/missionLibrary";
+export declare const missionLibraryKeys: {
+    all: readonly ["missionLibrary"];
+    missions: (filters?: TemplateMissionFilters) => readonly ["missionLibrary", "missions", TemplateMissionFilters | undefined];
+    missionsInfinite: (filters?: Omit<TemplateMissionFilters, "start" | "limit">) => readonly ["missionLibrary", "missions", "infinite", Omit<TemplateMissionFilters, "start" | "limit"> | undefined];
+    tasks: (filters?: TemplateTaskFilters) => readonly ["missionLibrary", "tasks", TemplateTaskFilters | undefined];
+    tasksInfinite: (filters?: Omit<TemplateTaskFilters, "start" | "limit">) => readonly ["missionLibrary", "tasks", "infinite", Omit<TemplateTaskFilters, "start" | "limit"> | undefined];
+    missionDetail: (id: string) => readonly ["missionLibrary", "mission", string];
+};
+export declare function useTemplateMissions(filters?: TemplateMissionFilters, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<import("../../core/types").PaginatedResult<TemplateMission>, Error>;
+export declare function useTemplateMissionsInfinite(filters?: Omit<TemplateMissionFilters, "start" | "limit">, options?: {
+    enabled?: boolean;
+    pageSize?: number;
+}): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<import("../../core/types").PaginatedResult<TemplateMission>, unknown>, Error>;
+export declare function useTemplateTasks(filters?: TemplateTaskFilters, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<import("../../core/types").PaginatedResult<TemplateTask>, Error>;
+export declare function useTemplateTasksInfinite(filters?: Omit<TemplateTaskFilters, "start" | "limit">, options?: {
+    enabled?: boolean;
+    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 useCopyTemplateMission(): import("@tanstack/react-query").UseMutationResult<TemplateMission[], Error, CopyTemplateMissionInput, unknown>;
+export declare function useAssignBulkMission(): import("@tanstack/react-query").UseMutationResult<{
+    code: number;
+    msg?: string;
+}, Error, AssignBulkMissionInput[], unknown>;
+export declare function useAssignBulkTask(): import("@tanstack/react-query").UseMutationResult<{
+    code: number;
+    msg?: string;
+}, Error, AssignBulkTaskInput[], unknown>;
+export declare function useCreateFromPredefinedTasks(): import("@tanstack/react-query").UseMutationResult<TemplateTask[], Error, CreateFromPredefinedInput, unknown>;

package/dist/react/hooks/useMissionLibrary.js

@@ -0,0 +1,183 @@
+"use strict";
+"use client";
+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.missionLibraryKeys = void 0;
+exports.useTemplateMissions = useTemplateMissions;
+exports.useTemplateMissionsInfinite = useTemplateMissionsInfinite;
+exports.useTemplateTasks = useTemplateTasks;
+exports.useTemplateTasksInfinite = useTemplateTasksInfinite;
+exports.useTemplateMissionDetail = useTemplateMissionDetail;
+exports.useCopyTemplateMission = useCopyTemplateMission;
+exports.useAssignBulkMission = useAssignBulkMission;
+exports.useAssignBulkTask = useAssignBulkTask;
+exports.useCreateFromPredefinedTasks = useCreateFromPredefinedTasks;
+const react_query_1 = require("@tanstack/react-query");
+const provider_1 = require("../provider");
+const useMissions_1 = require("./useMissions");
+const useTasks_1 = require("./useTasks");
+// Query keys
+exports.missionLibraryKeys = {
+    all: ["missionLibrary"],
+    missions: (filters) => [...exports.missionLibraryKeys.all, "missions", filters],
+    missionsInfinite: (filters) => [...exports.missionLibraryKeys.all, "missions", "infinite", filters],
+    tasks: (filters) => [...exports.missionLibraryKeys.all, "tasks", filters],
+    tasksInfinite: (filters) => [...exports.missionLibraryKeys.all, "tasks", "infinite", filters],
+    missionDetail: (id) => [...exports.missionLibraryKeys.all, "mission", id],
+};
+// --- Template Missions ---
+function useTemplateMissions(filters, enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.missionLibraryKeys.missions(filters),
+        queryFn: () => client.library.listTemplateMissions(filters),
+        enabled,
+    });
+}
+function useTemplateMissionsInfinite(filters, options) {
+    var _a, _b;
+    const client = (0, provider_1.useCrimsonClient)();
+    const enabled = (_a = options === null || options === void 0 ? void 0 : options.enabled) !== null && _a !== void 0 ? _a : true;
+    const pageSize = (_b = options === null || options === void 0 ? void 0 : options.pageSize) !== null && _b !== void 0 ? _b : 20;
+    return (0, react_query_1.useInfiniteQuery)({
+        queryKey: exports.missionLibraryKeys.missionsInfinite(filters),
+        queryFn: (_a) => __awaiter(this, [_a], void 0, function* ({ pageParam = 0 }) {
+            return client.library.listTemplateMissions(Object.assign(Object.assign({}, filters), { start: pageParam, limit: pageSize }));
+        }),
+        initialPageParam: 0,
+        getNextPageParam: (lastPage) => {
+            if (!(lastPage === null || lastPage === void 0 ? void 0 : lastPage.pagination))
+                return undefined;
+            return lastPage.pagination.hasMore
+                ? lastPage.pagination.start + lastPage.pagination.limit
+                : undefined;
+        },
+        enabled,
+    });
+}
+// --- Template Tasks ---
+function useTemplateTasks(filters, enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.missionLibraryKeys.tasks(filters),
+        queryFn: () => client.library.listTemplateTasks(filters),
+        enabled,
+    });
+}
+function useTemplateTasksInfinite(filters, options) {
+    var _a, _b;
+    const client = (0, provider_1.useCrimsonClient)();
+    const enabled = (_a = options === null || options === void 0 ? void 0 : options.enabled) !== null && _a !== void 0 ? _a : true;
+    const pageSize = (_b = options === null || options === void 0 ? void 0 : options.pageSize) !== null && _b !== void 0 ? _b : 20;
+    return (0, react_query_1.useInfiniteQuery)({
+        queryKey: exports.missionLibraryKeys.tasksInfinite(filters),
+        queryFn: (_a) => __awaiter(this, [_a], void 0, function* ({ pageParam = 0 }) {
+            return client.library.listTemplateTasks(Object.assign(Object.assign({}, filters), { start: pageParam, limit: pageSize }));
+        }),
+        initialPageParam: 0,
+        getNextPageParam: (lastPage) => {
+            if (!(lastPage === null || lastPage === void 0 ? void 0 : lastPage.pagination))
+                return undefined;
+            return lastPage.pagination.hasMore
+                ? lastPage.pagination.start + lastPage.pagination.limit
+                : undefined;
+        },
+        enabled,
+    });
+}
+// --- Mission Detail ---
+function useTemplateMissionDetail(missionId, enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.missionLibraryKeys.missionDetail(missionId),
+        queryFn: () => client.library.getMissionById(missionId),
+        enabled: !!missionId && enabled,
+    });
+}
+// --- Mutations ---
+function useCopyTemplateMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (input) => client.library.copyTemplateMission(input),
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({
+                queryKey: useMissions_1.missionKeys.list(variables.userId),
+            });
+            queryClient.invalidateQueries({
+                queryKey: [...useMissions_1.missionKeys.all, "infinite", variables.userId],
+            });
+        },
+    });
+}
+function useAssignBulkMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (input) => client.library.assignBulkMission(input),
+        onSuccess: (_, variables) => {
+            const uniqueUsers = Array.from(new Set(variables.map((v) => v.studentUid)));
+            uniqueUsers.forEach((userId) => {
+                queryClient.invalidateQueries({
+                    queryKey: useMissions_1.missionKeys.list(userId),
+                });
+                queryClient.invalidateQueries({
+                    queryKey: [...useMissions_1.missionKeys.all, "infinite", userId],
+                });
+            });
+        },
+    });
+}
+function useAssignBulkTask() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (input) => client.library.assignBulkTask(input),
+        onSuccess: (_, variables) => {
+            const uniqueInfiniteKeys = new Set();
+            const uniqueMissionIds = new Set();
+            variables.forEach((input) => {
+                const userId = input.studentUid;
+                input.tasks.forEach((task) => {
+                    const roadmapId = task.mission.roadmapId;
+                    const missionId = task.mission.id;
+                    uniqueInfiniteKeys.add(`${roadmapId}|${userId}`);
+                    if (missionId) {
+                        uniqueMissionIds.add(missionId);
+                    }
+                });
+            });
+            uniqueInfiniteKeys.forEach((key) => {
+                const [roadmapId, userId] = key.split("|");
+                queryClient.invalidateQueries({
+                    queryKey: [...useTasks_1.taskKeys.all, "infinite", roadmapId, userId],
+                });
+            });
+            uniqueMissionIds.forEach((missionId) => {
+                queryClient.invalidateQueries({
+                    queryKey: useTasks_1.taskKeys.list(missionId),
+                });
+            });
+        },
+    });
+}
+function useCreateFromPredefinedTasks() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (input) => client.library.createFromPredefinedTasks(input),
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({
+                queryKey: useTasks_1.taskKeys.list(variables.missionId),
+            });
+        },
+    });
+}

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

@@ -0,0 +1,24 @@
+import type { Mission, PaginatedResult } from "../../core/types";
+import type { MissionFilters } from "../../core/missions";
+export declare const missionKeys: {
+    all: readonly ["missions"];
+    lists: () => readonly ["missions", "list"];
+    list: (userId: string) => readonly ["missions", "list", string];
+    infinite: (userId: string, filters?: Omit<MissionFilters, "start" | "limit">) => readonly ["missions", "infinite", string, Omit<MissionFilters, "start" | "limit"> | undefined];
+    details: () => readonly ["missions", "detail"];
+    detail: (id: string) => readonly ["missions", "detail", string];
+};
+export declare function useMissions(userId: string | null, enabled: boolean): import("@tanstack/react-query").UseQueryResult<Mission[], Error>;
+/**
+ * Infinite query hook for paginated mission loading
+ */
+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, {
+    id: string;
+    data: Partial<Mission>;
+}, unknown>;
+export declare function useDeleteMission(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;

package/dist/react/hooks/useMissions.js

@@ -0,0 +1,104 @@
+"use strict";
+"use client";
+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.missionKeys = void 0;
+exports.useMissions = useMissions;
+exports.useMissionsInfinite = useMissionsInfinite;
+exports.useCreateMission = useCreateMission;
+exports.useUpdateMission = useUpdateMission;
+exports.useDeleteMission = useDeleteMission;
+const react_query_1 = require("@tanstack/react-query");
+const provider_1 = require("../provider");
+// Query keys
+exports.missionKeys = {
+    all: ["missions"],
+    lists: () => [...exports.missionKeys.all, "list"],
+    list: (userId) => [...exports.missionKeys.lists(), userId],
+    infinite: (userId, filters) => [...exports.missionKeys.all, "infinite", userId, filters],
+    details: () => [...exports.missionKeys.all, "detail"],
+    detail: (id) => [...exports.missionKeys.details(), id],
+};
+function useMissions(userId, enabled) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.missionKeys.list(userId || ""),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            if (!userId) {
+                throw new Error("Missing userId");
+            }
+            // Without pagination params, list() returns MissionsCategory[]
+            const categories = (yield client.missions.list(userId));
+            return categories.flatMap((category) => category.missions || []);
+        }),
+        enabled: !!userId && enabled,
+    });
+}
+/**
+ * Infinite query hook for paginated mission loading
+ */
+function useMissionsInfinite(userId, filters, options) {
+    var _a, _b;
+    const client = (0, provider_1.useCrimsonClient)();
+    const enabled = (_a = options === null || options === void 0 ? void 0 : options.enabled) !== null && _a !== void 0 ? _a : true;
+    const pageSize = (_b = options === null || options === void 0 ? void 0 : options.pageSize) !== null && _b !== void 0 ? _b : 20;
+    return (0, react_query_1.useInfiniteQuery)({
+        queryKey: exports.missionKeys.infinite(userId || "", filters),
+        queryFn: (_a) => __awaiter(this, [_a], void 0, function* ({ pageParam = 0 }) {
+            if (!userId) {
+                throw new Error("Missing userId");
+            }
+            return client.missions.listPaginated(userId, filters, {
+                start: pageParam,
+                limit: pageSize,
+            });
+        }),
+        initialPageParam: 0,
+        getNextPageParam: (lastPage) => {
+            if (!(lastPage === null || lastPage === void 0 ? void 0 : lastPage.pagination))
+                return undefined;
+            return lastPage.pagination.hasMore
+                ? lastPage.pagination.start + lastPage.pagination.limit
+                : undefined;
+        },
+        enabled: !!userId && enabled,
+    });
+}
+function useCreateMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (data) => client.missions.create(data),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: exports.missionKeys.all });
+        },
+    });
+}
+function useUpdateMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ id, data }) => client.missions.update(id, data),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: exports.missionKeys.all });
+        },
+    });
+}
+function useDeleteMission() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (id) => client.missions.delete(id),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: exports.missionKeys.all });
+        },
+    });
+}