@crimson-education/sdk 0.2.0

package/dist/core/client.d.ts

@@ -0,0 +1,84 @@
+import type { CrimsonClientConfig } from "./types";
+import { MissionsApi } from "./missions";
+import { TasksApi } from "./tasks";
+import { RoadmapApi } from "./roadmap";
+import { MissionLibraryApi } from "./missionLibrary";
+import { UsersApi } from "./users";
+import { AccountApi } from "./account";
+import { StudentProfileApi } from "./studentProfile";
+import { OAuthAdapter } from "./auth/oauth-adapter";
+import type { OAuthAuthState, OAuthAuthStateListener } from "./auth/types";
+export declare class CrimsonClient {
+    private config;
+    private baseUrl;
+    private clientId;
+    private clientVersion;
+    private clientPlatform;
+    private oauthAdapter?;
+    constructor(config: CrimsonClientConfig);
+    /**
+     * Initialize the client (required for OAuth mode)
+     * Call this after creating the client to load stored tokens
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the OAuth adapter (only available in OAuth mode)
+     */
+    getOAuthAdapter(): OAuthAdapter | undefined;
+    /**
+     * Check if using OAuth authentication
+     */
+    isOAuthMode(): boolean;
+    /**
+     * Get current authentication state (OAuth mode only)
+     */
+    getAuthState(): OAuthAuthState | null;
+    /**
+     * Subscribe to authentication state changes (OAuth mode only)
+     */
+    subscribeToAuthState(listener: OAuthAuthStateListener): (() => void) | null;
+    /**
+     * Start OAuth authorization flow (OAuth mode only)
+     * Redirects user to authorization page
+     */
+    authorize(options?: {
+        redirectUri?: string;
+        scope?: string[];
+    }): Promise<void>;
+    /**
+     * Handle OAuth callback (OAuth mode only)
+     * Call this on your callback page with URL parameters
+     */
+    handleOAuthCallback(params: {
+        code?: string;
+        state?: string;
+        error?: string;
+        errorDescription?: string;
+    }): Promise<void>;
+    /**
+     * Logout (OAuth mode only)
+     * Revokes tokens and clears storage
+     */
+    logout(): Promise<void>;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    fetch<T>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Get the current authentication token
+     */
+    private getToken;
+    /**
+     * Clean up resources (OAuth mode)
+     */
+    destroy(): void;
+    missions: MissionsApi;
+    tasks: TasksApi;
+    roadmap: RoadmapApi;
+    library: MissionLibraryApi;
+    users: UsersApi;
+    account: AccountApi;
+    studentProfile: StudentProfileApi;
+}
+export declare function createCrimsonClient(config: CrimsonClientConfig): CrimsonClient;

package/dist/core/client.js

@@ -0,0 +1,229 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrimsonClient = void 0;
+exports.createCrimsonClient = createCrimsonClient;
+const missions_1 = require("./missions");
+const tasks_1 = require("./tasks");
+const roadmap_1 = require("./roadmap");
+const missionLibrary_1 = require("./missionLibrary");
+const users_1 = require("./users");
+const account_1 = require("./account");
+const studentProfile_1 = require("./studentProfile");
+const oauth_adapter_1 = require("./auth/oauth-adapter");
+/** SDK version from package.json */
+const SDK_VERSION = "0.2.0";
+const normalizeBase = (url) => url.replace(/\/+$/, "");
+const normalizeToken = (token) => token.replace(/^Bearer\s+/i, "");
+/**
+ * Detect the runtime platform (browser or node)
+ */
+function detectPlatform() {
+    var _a;
+    if (typeof window !== "undefined")
+        return "browser";
+    if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node))
+        return "node";
+    return "unknown";
+}
+/**
+ * Check if config uses OAuth
+ */
+function isOAuthConfig(config) {
+    return "oauth" in config && config.oauth !== undefined;
+}
+class CrimsonClient {
+    constructor(config) {
+        this.config = config;
+        this.missions = new missions_1.MissionsApi(this);
+        this.tasks = new tasks_1.TasksApi(this);
+        this.roadmap = new roadmap_1.RoadmapApi(this);
+        this.library = new missionLibrary_1.MissionLibraryApi(this);
+        this.users = new users_1.UsersApi(this);
+        this.account = new account_1.AccountApi(this);
+        this.studentProfile = new studentProfile_1.StudentProfileApi(this);
+        this.baseUrl = normalizeBase(config.apiUrl);
+        this.clientId = config.clientId || "unknown";
+        this.clientVersion = config.clientVersion || SDK_VERSION;
+        this.clientPlatform = detectPlatform();
+        // Warn if clientId is not set
+        if (!config.clientId) {
+            console.warn("[CrimsonSDK] clientId not set. Consider setting it for better API tracking.");
+        }
+        // Initialize OAuth adapter if OAuth config is provided
+        if (isOAuthConfig(config)) {
+            const oauthConfig = {
+                clientId: config.oauth.clientId,
+                clientSecret: config.oauth.clientSecret,
+                redirectUri: config.oauth.redirectUri,
+                scope: config.oauth.scope,
+                authorizationEndpoint: `${this.baseUrl}/oauth/authorize`,
+                tokenEndpoint: `${this.baseUrl}/oauth/token`,
+                revocationEndpoint: `${this.baseUrl}/oauth/revoke`,
+                storage: config.oauth.storage,
+                autoRefresh: config.oauth.autoRefresh,
+            };
+            this.oauthAdapter = new oauth_adapter_1.OAuthAdapter(oauthConfig);
+        }
+    }
+    /**
+     * Initialize the client (required for OAuth mode)
+     * Call this after creating the client to load stored tokens
+     */
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.oauthAdapter) {
+                yield this.oauthAdapter.initialize();
+            }
+        });
+    }
+    /**
+     * Get the OAuth adapter (only available in OAuth mode)
+     */
+    getOAuthAdapter() {
+        return this.oauthAdapter;
+    }
+    /**
+     * Check if using OAuth authentication
+     */
+    isOAuthMode() {
+        return this.oauthAdapter !== undefined;
+    }
+    /**
+     * Get current authentication state (OAuth mode only)
+     */
+    getAuthState() {
+        var _a, _b;
+        return (_b = (_a = this.oauthAdapter) === null || _a === void 0 ? void 0 : _a.getAuthState()) !== null && _b !== void 0 ? _b : null;
+    }
+    /**
+     * Subscribe to authentication state changes (OAuth mode only)
+     */
+    subscribeToAuthState(listener) {
+        var _a, _b;
+        return (_b = (_a = this.oauthAdapter) === null || _a === void 0 ? void 0 : _a.subscribe(listener)) !== null && _b !== void 0 ? _b : null;
+    }
+    /**
+     * Start OAuth authorization flow (OAuth mode only)
+     * Redirects user to authorization page
+     */
+    authorize(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.oauthAdapter) {
+                throw new Error("OAuth is not configured. Use oauth config option.");
+            }
+            yield this.oauthAdapter.authorize(options);
+        });
+    }
+    /**
+     * Handle OAuth callback (OAuth mode only)
+     * Call this on your callback page with URL parameters
+     */
+    handleOAuthCallback(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.oauthAdapter) {
+                throw new Error("OAuth is not configured. Use oauth config option.");
+            }
+            yield this.oauthAdapter.handleCallback(params);
+        });
+    }
+    /**
+     * Logout (OAuth mode only)
+     * Revokes tokens and clears storage
+     */
+    logout() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.oauthAdapter) {
+                throw new Error("OAuth is not configured. Use oauth config option.");
+            }
+            yield this.oauthAdapter.logout();
+        });
+    }
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated() {
+        if (this.oauthAdapter) {
+            return this.oauthAdapter.isAuthenticated();
+        }
+        // For token mode, assume authenticated (token provider handles this)
+        return true;
+    }
+    fetch(path_1) {
+        return __awaiter(this, arguments, void 0, function* (path, options = {}) {
+            const token = yield this.getToken();
+            if (!token) {
+                throw new Error("No authentication token available");
+            }
+            const scheme = this.config.authScheme || "Bearer";
+            const headers = Object.assign({ "Content-Type": "application/json", Authorization: `${scheme} ${token}`, 
+                // Client identification headers for API tracking
+                "X-Client-ID": this.clientId, "X-Client-Version": this.clientVersion, "X-Client-Platform": this.clientPlatform }, options.headers);
+            const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+            const response = yield fetch(url, Object.assign(Object.assign({}, options), { headers }));
+            if (!response.ok) {
+                const errorText = yield response.text();
+                throw new Error(`Crimson SDK Error: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            const rawText = yield response.text();
+            if (!rawText) {
+                // 204 No Content or empty response
+                return undefined;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(rawText);
+            }
+            catch (_a) {
+                throw new Error(`Crimson SDK Error: invalid JSON response for ${path} - ${rawText}`);
+            }
+            if (typeof parsed === "object" &&
+                parsed !== null &&
+                Object.prototype.hasOwnProperty.call(parsed, "data")) {
+                // If response has pagination field, return full object (paginated response)
+                if (Object.prototype.hasOwnProperty.call(parsed, "pagination")) {
+                    return parsed;
+                }
+                // Otherwise unwrap data field (standard response)
+                const { data } = parsed;
+                return data;
+            }
+            return parsed;
+        });
+    }
+    /**
+     * Get the current authentication token
+     */
+    getToken() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.oauthAdapter) {
+                return this.oauthAdapter.getAccessToken();
+            }
+            // Use token provider function
+            if ("getToken" in this.config && this.config.getToken) {
+                const token = yield this.config.getToken();
+                return normalizeToken(token);
+            }
+            return null;
+        });
+    }
+    /**
+     * Clean up resources (OAuth mode)
+     */
+    destroy() {
+        var _a;
+        (_a = this.oauthAdapter) === null || _a === void 0 ? void 0 : _a.destroy();
+    }
+}
+exports.CrimsonClient = CrimsonClient;
+function createCrimsonClient(config) {
+    return new CrimsonClient(config);
+}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+export { CrimsonClient, createCrimsonClient } from "./client";
+export { MissionsApi } from "./missions";
+export { TasksApi, type TaskFilters, type TaskOrderBy } from "./tasks";
+export { RoadmapApi } from "./roadmap";
+export { MissionLibraryApi } from "./missionLibrary";
+export { UsersApi } from "./users";
+export { AccountApi } from "./account";
+export { StudentProfileApi } from "./studentProfile";
+export * from "./types";
+export { OAuthAdapter, createCrimsonOAuthAdapter, TokenManager, LocalStorageTokenStorage, SessionStorageTokenStorage, MemoryTokenStorage, createDefaultTokenStorage, generateCodeVerifier, generateCodeChallenge, generateState, } from "./auth";
+export type { OAuthConfig, OAuthTokens, TokenStorage, OAuthAuthState, OAuthAuthStateListener, AuthorizeOptions, CallbackParams, OAuthError, OAuthAdapterConfig, TokenManagerConfig, } from "./auth";

package/dist/core/index.js

@@ -0,0 +1,47 @@
+"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 });
+exports.generateState = exports.generateCodeChallenge = exports.generateCodeVerifier = exports.createDefaultTokenStorage = exports.MemoryTokenStorage = exports.SessionStorageTokenStorage = exports.LocalStorageTokenStorage = exports.TokenManager = exports.createCrimsonOAuthAdapter = exports.OAuthAdapter = exports.StudentProfileApi = exports.AccountApi = exports.UsersApi = exports.MissionLibraryApi = exports.RoadmapApi = exports.TasksApi = exports.MissionsApi = exports.createCrimsonClient = exports.CrimsonClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "CrimsonClient", { enumerable: true, get: function () { return client_1.CrimsonClient; } });
+Object.defineProperty(exports, "createCrimsonClient", { enumerable: true, get: function () { return client_1.createCrimsonClient; } });
+var missions_1 = require("./missions");
+Object.defineProperty(exports, "MissionsApi", { enumerable: true, get: function () { return missions_1.MissionsApi; } });
+var tasks_1 = require("./tasks");
+Object.defineProperty(exports, "TasksApi", { enumerable: true, get: function () { return tasks_1.TasksApi; } });
+var roadmap_1 = require("./roadmap");
+Object.defineProperty(exports, "RoadmapApi", { enumerable: true, get: function () { return roadmap_1.RoadmapApi; } });
+var missionLibrary_1 = require("./missionLibrary");
+Object.defineProperty(exports, "MissionLibraryApi", { enumerable: true, get: function () { return missionLibrary_1.MissionLibraryApi; } });
+var users_1 = require("./users");
+Object.defineProperty(exports, "UsersApi", { enumerable: true, get: function () { return users_1.UsersApi; } });
+var account_1 = require("./account");
+Object.defineProperty(exports, "AccountApi", { enumerable: true, get: function () { return account_1.AccountApi; } });
+var studentProfile_1 = require("./studentProfile");
+Object.defineProperty(exports, "StudentProfileApi", { enumerable: true, get: function () { return studentProfile_1.StudentProfileApi; } });
+__exportStar(require("./types"), exports);
+// OAuth authentication
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "OAuthAdapter", { enumerable: true, get: function () { return auth_1.OAuthAdapter; } });
+Object.defineProperty(exports, "createCrimsonOAuthAdapter", { enumerable: true, get: function () { return auth_1.createCrimsonOAuthAdapter; } });
+Object.defineProperty(exports, "TokenManager", { enumerable: true, get: function () { return auth_1.TokenManager; } });
+Object.defineProperty(exports, "LocalStorageTokenStorage", { enumerable: true, get: function () { return auth_1.LocalStorageTokenStorage; } });
+Object.defineProperty(exports, "SessionStorageTokenStorage", { enumerable: true, get: function () { return auth_1.SessionStorageTokenStorage; } });
+Object.defineProperty(exports, "MemoryTokenStorage", { enumerable: true, get: function () { return auth_1.MemoryTokenStorage; } });
+Object.defineProperty(exports, "createDefaultTokenStorage", { enumerable: true, get: function () { return auth_1.createDefaultTokenStorage; } });
+Object.defineProperty(exports, "generateCodeVerifier", { enumerable: true, get: function () { return auth_1.generateCodeVerifier; } });
+Object.defineProperty(exports, "generateCodeChallenge", { enumerable: true, get: function () { return auth_1.generateCodeChallenge; } });
+Object.defineProperty(exports, "generateState", { enumerable: true, get: function () { return auth_1.generateState; } });

package/dist/core/missionLibrary.d.ts

@@ -0,0 +1,68 @@
+import type { CrimsonClient } from "./client";
+import type { TemplateMission, TemplateTask, MissionDetail, PaginationParams, PaginatedResult, AssignBulkMissionInput, AssignBulkTaskInput } from "./types";
+export interface TemplateMissionFilters extends PaginationParams {
+    categories?: string[];
+    subcategories?: string[];
+    groups?: string[];
+    keyword?: string;
+    userId?: string;
+}
+export interface TemplateTaskFilters extends PaginationParams {
+    categories?: string[];
+    subcategories?: string[];
+    groups?: string[];
+    keyword?: string;
+    keywordType?: string;
+    userId?: string;
+}
+export interface CopyTemplateMissionInput {
+    linkId: string;
+    userId: string;
+    division?: string;
+    force?: boolean;
+    extra?: {
+        data?: Record<string, unknown>;
+    };
+}
+export interface CreateFromPredefinedInput {
+    missionId: string;
+    predefinedTaskIds: string[];
+}
+export declare class MissionLibraryApi {
+    private client;
+    constructor(client: CrimsonClient);
+    /**
+     * List template missions with pagination
+     */
+    listTemplateMissions(filters?: TemplateMissionFilters): Promise<PaginatedResult<TemplateMission>>;
+    /**
+     * List template tasks with pagination
+     */
+    listTemplateTasks(filters?: TemplateTaskFilters): Promise<PaginatedResult<TemplateTask>>;
+    /**
+     * Copy a template mission to a user's roadmap
+     */
+    copyTemplateMission(input: CopyTemplateMissionInput): Promise<TemplateMission[]>;
+    /**
+     * Bulk assign missions from templates
+     */
+    assignBulkMission(input: AssignBulkMissionInput[]): Promise<{
+        code: number;
+        msg?: string;
+    }>;
+    /**
+     * Bulk assign tasks from templates
+     */
+    assignBulkTask(input: AssignBulkTaskInput[]): Promise<{
+        code: number;
+        msg?: string;
+    }>;
+    /**
+     * Create action items from predefined tasks
+     */
+    createFromPredefinedTasks(input: CreateFromPredefinedInput): Promise<TemplateTask[]>;
+    /**
+     * Get mission detail by ID
+     */
+    getMissionById(missionId: string): Promise<MissionDetail | null>;
+}

package/dist/core/missionLibrary.js

@@ -0,0 +1,143 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissionLibraryApi = void 0;
+class MissionLibraryApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List template missions with pagination
+     */
+    listTemplateMissions(filters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const params = new URLSearchParams();
+            if ((_a = filters === null || filters === void 0 ? void 0 : filters.categories) === null || _a === void 0 ? void 0 : _a.length) {
+                params.append("categories", filters.categories.join(","));
+            }
+            if ((_b = filters === null || filters === void 0 ? void 0 : filters.subcategories) === null || _b === void 0 ? void 0 : _b.length) {
+                params.append("subcategories", filters.subcategories.join(","));
+            }
+            if ((_c = filters === null || filters === void 0 ? void 0 : filters.groups) === null || _c === void 0 ? void 0 : _c.length) {
+                params.append("groups", filters.groups.join(","));
+            }
+            if (filters === null || filters === void 0 ? void 0 : filters.keyword) {
+                params.append("keyword", filters.keyword);
+            }
+            if (filters === null || filters === void 0 ? void 0 : filters.userId) {
+                params.append("userId", filters.userId);
+            }
+            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/missions?${query}`
+                : "/roadmap/library/missions";
+            return this.client.fetch(path);
+        });
+    }
+    /**
+     * List template tasks with pagination
+     */
+    listTemplateTasks(filters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const params = new URLSearchParams();
+            if ((_a = filters === null || filters === void 0 ? void 0 : filters.categories) === null || _a === void 0 ? void 0 : _a.length) {
+                params.append("categories", filters.categories.join(","));
+            }
+            if ((_b = filters === null || filters === void 0 ? void 0 : filters.subcategories) === null || _b === void 0 ? void 0 : _b.length) {
+                params.append("subcategories", filters.subcategories.join(","));
+            }
+            if ((_c = filters === null || filters === void 0 ? void 0 : filters.groups) === null || _c === void 0 ? void 0 : _c.length) {
+                params.append("groups", filters.groups.join(","));
+            }
+            if (filters === null || filters === void 0 ? void 0 : filters.keyword) {
+                params.append("keyword", filters.keyword);
+            }
+            if (filters === null || filters === void 0 ? void 0 : filters.keywordType) {
+                params.append("keywordType", filters.keywordType);
+            }
+            if (filters === null || filters === void 0 ? void 0 : filters.userId) {
+                params.append("userId", filters.userId);
+            }
+            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/tasks?${query}`
+                : "/roadmap/library/tasks";
+            return this.client.fetch(path);
+        });
+    }
+    /**
+     * Copy a template mission to a user's roadmap
+     */
+    copyTemplateMission(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/roadmap/library/missions/copy", {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+    /**
+     * Bulk assign missions from templates
+     */
+    assignBulkMission(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/roadmap/library/missions/assign-bulk", {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+    /**
+     * Bulk assign tasks from templates
+     */
+    assignBulkTask(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/roadmap/library/tasks/assign-bulk", {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+    /**
+     * Create action items from predefined tasks
+     */
+    createFromPredefinedTasks(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/roadmap/library/tasks/create-from-predefined", {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+    /**
+     * Get mission detail by ID
+     */
+    getMissionById(missionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/missions/${missionId}/detail`);
+        });
+    }
+}
+exports.MissionLibraryApi = MissionLibraryApi;

package/dist/core/missions.d.ts

@@ -0,0 +1,45 @@
+import type { CrimsonClient } from "./client";
+import type { Mission, MissionsCategory, PaginationParams, PaginatedResult, BatchMissionOperation, BatchEditMissionsResult, BatchDeleteRestoreResult } from "./types";
+export interface MissionFilters extends PaginationParams {
+    status?: string[];
+    title?: string;
+    roadmapId?: string;
+    groupBy?: string;
+    dueDateStart?: string;
+    dueDateEnd?: string;
+}
+export declare class MissionsApi {
+    private client;
+    constructor(client: CrimsonClient);
+    /**
+     * List missions for a user.
+     * Without pagination params (start/limit), returns MissionsCategory[] (grouped by category).
+     * With pagination params, returns PaginatedResult<Mission> (flat list with pagination metadata).
+     */
+    list(userId: string, filters?: MissionFilters): Promise<PaginatedResult<Mission>> | Promise<MissionsCategory[]>;
+    /**
+     * List missions with pagination (always returns flat list with pagination metadata)
+     * Handles both new paginated response and legacy category-grouped response
+     */
+    listPaginated(userId: string, filters?: Omit<MissionFilters, "start" | "limit">, pagination?: PaginationParams): Promise<PaginatedResult<Mission>>;
+    create(data: Partial<Mission>): Promise<Mission>;
+    update(linkId: string, data: Partial<Mission>): Promise<Mission>;
+    delete(linkId: string): Promise<void>;
+    /**
+     * Batch edit missions (add, update, delete in a single request)
+     * @param userId - The user ID who owns the roadmap
+     * @param roadmapId - The roadmap ID
+     * @param missions - Array of mission operations
+     */
+    batchEdit(userId: string, roadmapId: string, missions: BatchMissionOperation[]): Promise<BatchEditMissionsResult[]>;
+    /**
+     * Batch delete missions and their action items by link IDs
+     * @param linkIds - Array of mission link IDs to delete
+     */
+    batchDelete(linkIds: string[]): Promise<BatchDeleteRestoreResult>;
+    /**
+     * Batch restore deleted missions and their action items by link IDs
+     * @param linkIds - Array of mission link IDs to restore
+     */
+    batchRestore(linkIds: string[]): Promise<BatchDeleteRestoreResult>;
+}