@crimson-education/sdk 0.3.4 → 0.3.5

package/dist/core/missionLibrary.d.ts

@@ -82,6 +82,10 @@ export declare class MissionLibraryApi {
      * List template tasks with pagination
      */
     listTemplateTasks(filters?: TemplateTaskFilters): Promise<PaginatedResult<TemplateTask>>;
+    /**
+     * List custom template tasks with pagination
+     */
+    listCustomTemplateTasks(filters?: TemplateTaskFilters): Promise<PaginatedResult<TemplateTask>>;
     /**
      * Update title/description/tasks of a template mission.
      * Should ensure the mission is a 'custom' mission before calling this.

package/dist/core/missionLibrary.js

@@ -132,6 +132,28 @@ class MissionLibraryApi {
             return this.client.fetch(path);
         });
     }
+    /**
+     * List custom template tasks with pagination
+     */
+    listCustomTemplateTasks(filters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = new URLSearchParams();
+            if (filters === null || filters === void 0 ? void 0 : filters.keyword) {
+                params.append("keyword", filters.keyword);
+            }
+            if ((filters === null || filters === void 0 ? void 0 : filters.start) !== undefined) {
+                params.append("start", String(filters.start));
+            }
+            if ((filters === null || filters === void 0 ? void 0 : filters.limit) !== undefined) {
+                params.append("limit", String(filters.limit));
+            }
+            const query = params.toString();
+            const path = query
+                ? `/roadmap/library/custom-tasks?${query}`
+                : "/roadmap/library/custom-tasks";
+            return this.client.fetch(path);
+        });
+    }
     /**
      * Update title/description/tasks of a template mission.
      * Should ensure the mission is a 'custom' mission before calling this.

package/dist/core/tasks.d.ts

@@ -1,5 +1,21 @@
 import type { CrimsonClient } from "./client";
 import type { Task, PaginationParams, PaginatedResult, ActionItemResource, AddResourceInput, UploadUrlResponse, DownloadUrlResponse, UpdateTaskResourceInput, User, ActionItemActivityBrief } from "./types";
+export interface BulkCreateActionItemPayload {
+    missionId?: string;
+    roadmapId?: string;
+    description: string;
+    content?: string;
+    dueDate?: string;
+    startAt?: string;
+    linkId?: string;
+    resources?: {
+        title: string;
+        type: string;
+        url: string;
+        mediaType?: string;
+        orderIndex?: number;
+    }[];
+}
 export type TaskOrderBy = "priority" | "dueDate" | "missionTitle" | "createdAt" | "description";
 export interface TaskFilters extends PaginationParams {
     status?: string[];
@@ -57,6 +73,10 @@ 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 create action items
+     */
+    bulkCreate(items: BulkCreateActionItemPayload[]): Promise<any>;
     /**
      * Bulk delete tasks
      * @param ids - Array of task IDs to delete

package/dist/core/tasks.js

@@ -40,6 +40,7 @@ const normalizeTask = (raw) => {
         isComplete,
         resources: raw.resources,
         mission: raw.mission,
+        linkId: raw.linkId,
     };
 };
 class TasksApi {
@@ -200,6 +201,15 @@ class TasksApi {
             method: "DELETE",
         });
     }
+    /**
+     * Bulk create action items
+     */
+    bulkCreate(items) {
+        return this.client.fetch('/roadmap/action-items/bulk-create', {
+            method: 'POST',
+            body: JSON.stringify({ items }),
+        }).then((res) => res === null || res === void 0 ? void 0 : res.map(normalizeTask));
+    }
     /**
      * Bulk delete tasks
      * @param ids - Array of task IDs to delete

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

@@ -3,11 +3,11 @@ export { useQueryClient } from "@tanstack/react-query";
 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, useBulkDeleteTasks, useBulkUpdateTasks, taskKeys, useGetDownloadUrl, useTaskCreators, useTaskActivities, } from "./useTasks";
+export { useTasks, useAllUserTasks, useTasksByRoadmapId, useTasksInfinite, useCreateTask, useUpdateTask, useDeleteTask, useBulkDeleteTasks, useBulkUpdateTasks, taskKeys, useGetDownloadUrl, useTaskCreators, useTaskActivities, useBulkCreateActionItems, } 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, useCreateTemplateMission, useDeleteTemplateMission, useTemplateMissionAddToRoadmap, useCustomTemplateMissionsInfinite, } from "./useMissionLibrary";
+export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useUpdateTemplateMission, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, useCreateTemplateMission, useDeleteTemplateMission, useTemplateMissionAddToRoadmap, useCustomTemplateMissionsInfinite, useCustomTemplateTasksInfinite, } from "./useMissionLibrary";
 export { useStudentProfile, useStudentPrefilledInfo, studentProfileKeys, } from "./useStudentProfile";
 export { useIndigoMe, useStudentTutors, useTutorStudents, indigoKeys, } from "./useIndigo";
 export * from "./useGradeTemplates";

package/dist/react/hooks/index.js

@@ -14,8 +14,8 @@ 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 });
-exports.useStudentTutors = exports.useIndigoMe = exports.studentProfileKeys = exports.useStudentPrefilledInfo = exports.useStudentProfile = exports.useCustomTemplateMissionsInfinite = exports.useTemplateMissionAddToRoadmap = 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.useTaskActivities = 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.useQueryClient = exports.useAuthState = void 0;
-exports.indigoKeys = exports.useTutorStudents = void 0;
+exports.studentProfileKeys = exports.useStudentPrefilledInfo = exports.useStudentProfile = exports.useCustomTemplateTasksInfinite = exports.useCustomTemplateMissionsInfinite = exports.useTemplateMissionAddToRoadmap = 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.useBulkCreateActionItems = exports.useTaskActivities = 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.useQueryClient = exports.useAuthState = void 0;
+exports.indigoKeys = exports.useTutorStudents = exports.useStudentTutors = exports.useIndigoMe = void 0;
 var useAuthState_1 = require("./useAuthState");
 Object.defineProperty(exports, "useAuthState", { enumerable: true, get: function () { return useAuthState_1.useAuthState; } });
 var react_query_1 = require("@tanstack/react-query");
@@ -44,6 +44,7 @@ Object.defineProperty(exports, "taskKeys", { enumerable: true, get: function ()
 Object.defineProperty(exports, "useGetDownloadUrl", { enumerable: true, get: function () { return useTasks_1.useGetDownloadUrl; } });
 Object.defineProperty(exports, "useTaskCreators", { enumerable: true, get: function () { return useTasks_1.useTaskCreators; } });
 Object.defineProperty(exports, "useTaskActivities", { enumerable: true, get: function () { return useTasks_1.useTaskActivities; } });
+Object.defineProperty(exports, "useBulkCreateActionItems", { enumerable: true, get: function () { return useTasks_1.useBulkCreateActionItems; } });
 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; } });
@@ -70,6 +71,7 @@ Object.defineProperty(exports, "useCreateTemplateMission", { enumerable: true, g
 Object.defineProperty(exports, "useDeleteTemplateMission", { enumerable: true, get: function () { return useMissionLibrary_1.useDeleteTemplateMission; } });
 Object.defineProperty(exports, "useTemplateMissionAddToRoadmap", { enumerable: true, get: function () { return useMissionLibrary_1.useTemplateMissionAddToRoadmap; } });
 Object.defineProperty(exports, "useCustomTemplateMissionsInfinite", { enumerable: true, get: function () { return useMissionLibrary_1.useCustomTemplateMissionsInfinite; } });
+Object.defineProperty(exports, "useCustomTemplateTasksInfinite", { enumerable: true, get: function () { return useMissionLibrary_1.useCustomTemplateTasksInfinite; } });
 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

@@ -21,6 +21,10 @@ export declare function useTemplateTasksInfinite(filters?: Omit<TemplateTaskFilt
     enabled?: boolean;
     pageSize?: number;
 }): import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<import("../../core/types").PaginatedResult<TemplateTask>, unknown>, Error>;
+export declare function useCustomTemplateTasksInfinite(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 useUpdateTemplateMission(): import("@tanstack/react-query").UseMutationResult<TemplateMission, Error, {
     id: string;

package/dist/react/hooks/useMissionLibrary.js

@@ -16,6 +16,7 @@ exports.useTemplateMissionsInfinite = useTemplateMissionsInfinite;
 exports.useCustomTemplateMissionsInfinite = useCustomTemplateMissionsInfinite;
 exports.useTemplateTasks = useTemplateTasks;
 exports.useTemplateTasksInfinite = useTemplateTasksInfinite;
+exports.useCustomTemplateTasksInfinite = useCustomTemplateTasksInfinite;
 exports.useTemplateMissionDetail = useTemplateMissionDetail;
 exports.useUpdateTemplateMission = useUpdateTemplateMission;
 exports.useCreateTemplateMission = useCreateTemplateMission;
@@ -118,6 +119,27 @@ function useTemplateTasksInfinite(filters, options) {
         enabled,
     });
 }
+function useCustomTemplateTasksInfinite(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.all, "custom-tasks", "infinite", filters],
+        queryFn: (_a) => __awaiter(this, [_a], void 0, function* ({ pageParam = 0 }) {
+            return client.library.listCustomTemplateTasks(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)();

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

@@ -30,6 +30,7 @@ export declare function useTasksInfinite(roadmapId: string | null, userId: strin
 export interface OptimisticOptions {
     optimistic?: boolean;
 }
+export declare function useBulkCreateActionItems(): import("@tanstack/react-query").UseMutationResult<any, Error, any[], unknown>;
 export declare function useCreateTask(options?: OptimisticOptions): import("@tanstack/react-query").UseMutationResult<Task, Error, Partial<Task>, {
     previousTasks: Task[] | undefined;
 } | undefined>;

package/dist/react/hooks/useTasks.js

@@ -17,6 +17,7 @@ exports.useTaskActivities = useTaskActivities;
 exports.useAllUserTasks = useAllUserTasks;
 exports.useTasksByRoadmapId = useTasksByRoadmapId;
 exports.useTasksInfinite = useTasksInfinite;
+exports.useBulkCreateActionItems = useBulkCreateActionItems;
 exports.useCreateTask = useCreateTask;
 exports.useUpdateTask = useUpdateTask;
 exports.useDeleteTask = useDeleteTask;
@@ -68,98 +69,64 @@ function useTaskCreators(roadmapId, enabled = true) {
 function useTaskActivities(actionItemIds, type = "duedate", enabled = true) {
     const client = (0, provider_1.useCrimsonClient)();
     const queryClient = (0, react_query_1.useQueryClient)();
-    // Track which IDs we know are in the cache (or have been fetched)
-    const [cachedIds, setCachedIds] = (0, react_1.useState)(() => {
-        const s = new Set();
-        // We only check for existence, not staleness. Stale data will be refetched by useQueries if needed,
-        // but we want to prevent the *initial* fetch of empty data which causes the waterfall/storm.
-        // However, checking queryCache synchronously here is good for hydration.
-        return s;
+    const STALE_TIME = 5 * 60 * 1000;
+    // 1. Use useQueries to READ from cache.
+    // We disable them so they never trigger individual fetches.
+    // They effectively act as observers of the cache.
+    const queries = (0, react_query_1.useQueries)({
+        queries: actionItemIds.map((id) => ({
+            queryKey: exports.taskKeys.activity(id, type),
+            // No queryFn needed because we never enable it to fetch
+            enabled: false,
+        })),
     });
-    // Sync effect to update cachedIds from props? 
-    // actually, we should just check the cache on render or effect.
-    // But doing it in effect allows the batch fetch to be the primary mechanism.
+    // 2. Manage fetching via side-effect
     (0, react_1.useEffect)(() => {
-        if (!enabled)
+        if (!enabled || actionItemIds.length === 0)
             return;
-        // Identify which IDs are missing from our "known cached" set
-        // AND missing from the actual query cache (double check to be safe)
-        const missing = actionItemIds.filter((id) => {
-            if (cachedIds.has(id))
-                return false;
-            const data = queryClient.getQueryData(exports.taskKeys.activity(id, type));
-            if (data) {
-                // If it's already there (maybe from another component), we can mark it as cached
-                // We'll update state later to avoid set-during-render warning if we did it synchronously above constantly
-                return false;
+        const now = Date.now();
+        const idsToFetch = actionItemIds.filter((id) => {
+            const state = queryClient.getQueryState(exports.taskKeys.activity(id, type));
+            // If no data, need fetch
+            if (!state || !state.data)
+                return true;
+            // If data exists but is stale, need fetch
+            if (state.dataUpdatedAt && (now - state.dataUpdatedAt > STALE_TIME)) {
+                return true;
             }
-            return true;
+            return false;
         });
-        if (missing.length === 0) {
-            // If we found some inconsistencies (e.g. they were in queryClient but not in our local state), align them
-            if (actionItemIds.length !== cachedIds.size) {
-                // This logic is tricky. Let's simplify: 
-                // Just fetch what we really need.
-            }
+        if (idsToFetch.length === 0)
             return;
-        }
-        const fetchActivities = () => __awaiter(this, void 0, void 0, function* () {
+        // Deduplicate IDs just in case
+        const uniqueIdsToFetch = [...new Set(idsToFetch)];
+        // Perform batch fetch
+        const fetchBatch = () => __awaiter(this, void 0, void 0, function* () {
             try {
-                const result = yield client.tasks.getActivities(missing, type);
-                // Populate Cache
-                Object.entries(result).forEach(([id, activities]) => {
+                const result = yield client.tasks.getActivities(uniqueIdsToFetch, type);
+                // Update cache for each ID
+                // Note: We update ALL requested IDs. If an ID is missing in result, 
+                // it implies no activities, so we set empty array to prevent infinite refetching.
+                uniqueIdsToFetch.forEach(id => {
+                    const activities = result[id] || [];
                     queryClient.setQueryData(exports.taskKeys.activity(id, type), activities);
                 });
-                // Also handling IDs that returned no result (empty array) to prevent infinite re-fetching?
-                // The API returns Record<string, ...>. If an ID is missing, we should probably set it to empty.
-                missing.forEach(id => {
-                    if (!result[id]) {
-                        queryClient.setQueryData(exports.taskKeys.activity(id, type), []);
-                    }
-                });
-                // Update local state to enable the queries
-                setCachedIds((prev) => {
-                    const next = new Set(prev);
-                    missing.forEach((id) => next.add(id));
-                    return next;
-                });
             }
-            catch (e) {
-                console.error("Failed to batch fetch activities", e);
+            catch (error) {
+                console.error("Failed to batch fetch activities", error);
             }
         });
-        fetchActivities();
-    }, [actionItemIds, type, enabled, client, queryClient, cachedIds]); // cachedIds dep is important
-    // Also, we need to make sure we "discover" items that are already cached 
-    // without fetching them. Use an effect to sync "initially present" items?
-    (0, react_1.useEffect)(() => {
-        if (!enabled)
-            return;
-        const present = actionItemIds.filter(id => !cachedIds.has(id) && queryClient.getQueryData(exports.taskKeys.activity(id, type)));
-        if (present.length > 0) {
-            setCachedIds(prev => {
-                const next = new Set(prev);
-                present.forEach(id => next.add(id));
-                return next;
-            });
-        }
-    }, [actionItemIds, type, enabled, queryClient, cachedIds]);
-    const queries = (0, react_query_1.useQueries)({
-        queries: actionItemIds.map((id) => ({
-            queryKey: exports.taskKeys.activity(id, type),
-            queryFn: () => __awaiter(this, void 0, void 0, function* () {
-                const result = yield client.tasks.getActivities([id], type);
-                return result[id] || [];
-            }),
-            // Only enable if we have "acknowledged" that the data is ready/cached.
-            // OR if it was already in the cache (optimization).
-            enabled: enabled && !!id && cachedIds.has(id),
-            staleTime: 5 * 60 * 1000,
-        })),
-    });
-    const isLoading = queries.some((q) => q.isLoading);
+        fetchBatch();
+        // We intentionally do not include queryClient deeply in deps if not needed, 
+        // but here it's stable. 
+        // We rely on actionItemIds changing (scroll) or enabled changing to trigger this.
+        // For periodic polling of staleness, one might need a timer, but for now 
+        // check-on-mount/update is sufficient.
+    }, [actionItemIds, type, enabled, client, queryClient]); // STALE_TIME constant
+    const isLoading = queries.some((q) => !q.data && enabled); // If enabled and no data, we are effectively loading
     const data = {};
     queries.forEach((q, index) => {
+        // q.data comes from cache
         if (q.data) {
             data[actionItemIds[index]] = q.data;
         }
@@ -228,6 +195,16 @@ function useTasksInfinite(roadmapId, userId, filters, options) {
         enabled: !!roadmapId && !!userId && enabled,
     });
 }
+function useBulkCreateActionItems() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (items) => client.tasks.bulkCreate(items),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: exports.taskKeys.all });
+        },
+    });
+}
 function useCreateTask(options) {
     var _a;
     const client = (0, provider_1.useCrimsonClient)();

package/package.json

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