@crimson-education/sdk 0.2.5 → 0.3.0

package/README.md

@@ -231,6 +231,100 @@ SDK 会将后端返回的 action item 做归一化，保证至少返回以下核
 - `getMissionById(missionId: string): Promise<MissionDetail | null>`
   - 注意：当后端返回非 2xx（例如 404）时，SDK 会抛异常；建议使用 `try/catch` 处理。
 
+### 7) AccountApi（`client.account`）
+
+涉及接口：
+
+- `GET /api/v1/account/me/roles`
+- `GET /api/v1/account/me/students`
+- `GET /api/v1/account/me/profile`
+
+主要方法：
+
+- `getCurrentUserRoles(): Promise<CurrentUserRoles>`
+  - 获取当前用户的角色列表
+  - 返回 `{ userId, roles: [{ roleId, isPrimary }] }`
+- `getMyStudents(): Promise<StudentSummary[]>`
+  - 获取当前用户关联的学生列表（主要用于 Staff 用户）
+  - 返回学生基本信息：`userId`, `firstName`, `lastName`, `email`, `profileImageUrl`
+- `getMyProfile(): Promise<UserProfile>`
+  - 获取当前用户的完整 Profile 信息
+  - 返回字段：
+    - `userId`, `email`, `firstName`, `lastName`
+    - `nickname` - 首选名称
+    - `name` - 完整显示名
+    - `picture` - 头像 URL
+    - `status` - 用户状态
+    - `isMultiTenant` - 是否多租户用户
+    - `roles[]` - 角色数组（支持多角色），每个包含 `roleId`, `roleName`, `isPrimary`
+    - `tenant` - 租户信息 `{ id, name }`
+
+### 8) IndigoApi（`client.indigo`）
+
+Indigo 专用 API，提供用户身份识别和学生-Tutor 关系查询功能。
+
+涉及接口：
+
+- `GET /api/v1/indigo/me`
+- `GET /api/v1/indigo/student/tutors`
+- `GET /api/v1/indigo/tutor/students`
+
+> **注意**：所有 Indigo API 需要用户拥有 INDIGO 产品订阅才能访问。
+
+主要方法：
+
+- `getMe(): Promise<IndigoMe>`
+  - 获取当前用户的 Indigo 身份信息
+  - 返回字段：
+    - `userId`, `email`, `firstName`, `lastName`
+    - `role` - 用户角色：`"student"` 或 `"tutor"`
+    - `tenantId`, `tenantName` - 主租户信息
+    - `isMultiTenant` - 是否跨租户用户
+    - `relatedAccounts[]` - 关联账户列表（多租户场景）
+- `getStudentTutors(): Promise<IndigoTutor[]>`
+  - 获取当前学生的 Tutor 列表
+  - 支持跨租户聚合（多租户学生可看到所有租户的 Tutor）
+  - 返回字段：`userId`, `email`, `firstName`, `lastName`, `profileImageUrl`, `contractId`, `contractStatus`, `source`
+- `getTutorStudents(): Promise<IndigoStudent[]>`
+  - 获取当前 Tutor 的学生列表
+  - 支持跨租户聚合（多租户 Tutor 可看到所有租户的学生）
+  - 返回字段：`userId`, `email`, `firstName`, `lastName`, `profileImageUrl`, `contractId`, `contractStatus`, `source`
+
+示例：
+
+```ts
+const client = createCrimsonClient({
+  apiUrl: "https://api.crimson.io",
+  clientId: "indigo-website",
+  getToken: () => localStorage.getItem("token") || "",
+});
+
+// 获取用户身份
+const me = await client.indigo.getMe();
+console.log(`Role: ${me.role}, Multi-tenant: ${me.isMultiTenant}`);
+
+// 学生获取 Tutor 列表
+if (me.role === "student") {
+  const tutors = await client.indigo.getStudentTutors();
+  tutors.forEach((t) =>
+    console.log(`${t.firstName} ${t.lastName} (${t.source})`),
+  );
+}
+
+// Tutor 获取学生列表（按来源分组）
+if (me.role === "tutor") {
+  const students = await client.indigo.getTutorStudents();
+  const bySource = students.reduce(
+    (acc, s) => {
+      (acc[s.source] ||= []).push(s);
+      return acc;
+    },
+    {} as Record<string, typeof students>,
+  );
+  console.log(`Crimson App: ${bySource.crimsonapp?.length || 0} students`);
+}
+```
+
 ---
 
 ## iframe 层（嵌入/跨域场景）
@@ -334,6 +428,65 @@ Props：
   - `useTemplateMissions/useTemplateMissionsInfinite`
   - `useTemplateTasks/useTemplateTasksInfinite`
   - `useTemplateMissionDetail(missionId)`
+- Indigo 身份相关：
+  - `useIndigoMe(enabled?)` - 获取当前用户的 Indigo 身份
+  - `useStudentTutors(enabled?)` - 获取学生的 Tutor 列表
+  - `useTutorStudents(enabled?)` - 获取 Tutor 的学生列表
+
+### Indigo Hooks 示例
+
+```tsx
+import {
+  useIndigoMe,
+  useStudentTutors,
+  useTutorStudents,
+} from "@crimson-education/sdk/react";
+
+function IndigoProfile() {
+  const { data: me, isLoading: isMeLoading } = useIndigoMe();
+  // 仅当用户是 student 时才请求 tutors
+  const { data: tutors } = useStudentTutors(me?.role === "student");
+  // 仅当用户是 tutor 时才请求 students
+  const { data: students } = useTutorStudents(me?.role === "tutor");
+
+  if (isMeLoading) return <Spinner />;
+
+  return (
+    <div>
+      <h1>
+        {me?.firstName} {me?.lastName}
+      </h1>
+      <p>Role: {me?.role}</p>
+
+      {me?.role === "student" && tutors && (
+        <section>
+          <h2>My Tutors ({tutors.length})</h2>
+          <ul>
+            {tutors.map((t) => (
+              <li key={t.contractId}>
+                {t.firstName} {t.lastName}
+              </li>
+            ))}
+          </ul>
+        </section>
+      )}
+
+      {me?.role === "tutor" && students && (
+        <section>
+          <h2>My Students ({students.length})</h2>
+          <ul>
+            {students.map((s) => (
+              <li key={s.contractId}>
+                {s.firstName} {s.lastName} ({s.source})
+              </li>
+            ))}
+          </ul>
+        </section>
+      )}
+    </div>
+  );
+}
+```
 
 ---
 
@@ -362,7 +515,7 @@ SDK 支持向后端发送客户端标识信息，用于追踪 API 调用来源
 | Header              | 说明           | 示例值                    |
 | ------------------- | -------------- | ------------------------- |
 | `X-Client-ID`       | 客户端应用标识 | `new-roadmap`, `capstone` |
-| `X-Client-Version`  | SDK 版本       | `0.2.0`                   |
+| `X-Client-Version`  | SDK 版本       | `0.3.0`                   |
 | `X-Client-Platform` | 运行环境       | `browser`, `node`         |
 
 ### 后端日志
@@ -374,7 +527,7 @@ SDK 支持向后端发送客户端标识信息，用于追踪 API 调用来源
   "type": "api_request",
   "request_id": "uuid",
   "client_id": "new-roadmap",
-  "client_version": "0.2.0",
+  "client_version": "0.3.0",
   "client_platform": "browser",
   "auth_mode": "bearer",
   "user_id": "auth0-xxx",

package/dist/core/account.d.ts

@@ -1,5 +1,5 @@
 import type { CrimsonClient } from "./client";
-import type { CurrentUserRoles, StudentSummary } from "./types";
+import type { CurrentUserRoles, StudentSummary, UserProfile } from "./types";
 export declare class AccountApi {
     private client;
     constructor(client: CrimsonClient);
@@ -22,4 +22,19 @@ export declare class AccountApi {
      * @returns Array of student summaries with basic info for display
      */
     getMyStudents(): Promise<StudentSummary[]>;
+    /**
+     * Get the current logged-in user's profile information.
+     *
+     * This is a unified endpoint that returns comprehensive user profile data including:
+     * - Basic info (userId, email, name)
+     * - Nickname/preferred name
+     * - Profile picture URL
+     * - User status
+     * - Multi-tenant status
+     * - All user roles (with names)
+     * - Tenant information
+     *
+     * @returns User profile information
+     */
+    getMyProfile(): Promise<UserProfile>;
 }

package/dist/core/account.js

@@ -43,5 +43,24 @@ class AccountApi {
             return this.client.fetch("/api/v1/account/me/students");
         });
     }
+    /**
+     * Get the current logged-in user's profile information.
+     *
+     * This is a unified endpoint that returns comprehensive user profile data including:
+     * - Basic info (userId, email, name)
+     * - Nickname/preferred name
+     * - Profile picture URL
+     * - User status
+     * - Multi-tenant status
+     * - All user roles (with names)
+     * - Tenant information
+     *
+     * @returns User profile information
+     */
+    getMyProfile() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/api/v1/account/me/profile");
+        });
+    }
 }
 exports.AccountApi = AccountApi;

package/dist/core/client.d.ts

@@ -6,6 +6,8 @@ import { MissionLibraryApi } from "./missionLibrary";
 import { UsersApi } from "./users";
 import { AccountApi } from "./account";
 import { StudentProfileApi } from "./studentProfile";
+import { IndigoApi } from "./indigo";
+import { GradeTemplatesApi } from "./gradeTemplates";
 import { OAuthAdapter } from "./auth/oauth-adapter";
 import type { OAuthAuthState, OAuthAuthStateListener } from "./auth/types";
 export declare class CrimsonClient {
@@ -80,5 +82,7 @@ export declare class CrimsonClient {
     users: UsersApi;
     account: AccountApi;
     studentProfile: StudentProfileApi;
+    indigo: IndigoApi;
+    gradeTemplates: GradeTemplatesApi;
 }
 export declare function createCrimsonClient(config: CrimsonClientConfig): CrimsonClient;

package/dist/core/client.js

@@ -18,9 +18,11 @@ const missionLibrary_1 = require("./missionLibrary");
 const users_1 = require("./users");
 const account_1 = require("./account");
 const studentProfile_1 = require("./studentProfile");
+const indigo_1 = require("./indigo");
+const gradeTemplates_1 = require("./gradeTemplates");
 const oauth_adapter_1 = require("./auth/oauth-adapter");
 /** SDK version from package.json */
-const SDK_VERSION = "0.2.0";
+const SDK_VERSION = "0.3.0";
 const normalizeBase = (url) => url.replace(/\/+$/, "");
 const normalizeToken = (token) => token.replace(/^Bearer\s+/i, "");
 /**
@@ -50,6 +52,8 @@ class CrimsonClient {
         this.users = new users_1.UsersApi(this);
         this.account = new account_1.AccountApi(this);
         this.studentProfile = new studentProfile_1.StudentProfileApi(this);
+        this.indigo = new indigo_1.IndigoApi(this);
+        this.gradeTemplates = new gradeTemplates_1.GradeTemplatesApi(this);
         this.baseUrl = normalizeBase(config.apiUrl);
         this.clientId = config.clientId || "unknown";
         this.clientVersion = config.clientVersion || SDK_VERSION;

package/dist/core/gradeTemplates.d.ts

@@ -0,0 +1,117 @@
+import type { CrimsonClient } from "./client";
+export interface GradeTemplateMission {
+    id: string;
+    gradeTemplateId: string;
+    templateMissionId: string;
+    startYearOffset?: number;
+    startMonth: number;
+    startDay?: number;
+    endYearOffset?: number;
+    endMonth: number;
+    endDay?: number;
+    createdAt: string;
+    updatedAt: string;
+    title?: string;
+    category?: string;
+    description?: string;
+    subcategory?: string;
+    tasks?: GradeTemplateTask[];
+}
+export interface GradeTemplateTaskResource {
+    id: string;
+    title: string;
+    type: string;
+    url: string;
+    mediaType?: string;
+    orderIndex?: number;
+}
+export interface GradeTemplateTask {
+    id: string;
+    description: string;
+    content?: string;
+    resources?: GradeTemplateTaskResource[];
+}
+export interface CreateGradeTemplateMissionInput {
+    templateMissionId: string;
+    startYearOffset?: number;
+    startMonth: number;
+    startDay?: number;
+    endYearOffset?: number;
+    endMonth: number;
+    endDay?: number;
+}
+export interface GradeTemplateBrief {
+    id: string;
+    title: string;
+    gradeLevel: number;
+    startYearOffset?: number;
+    startMonth: number;
+    startDay?: number;
+    endYearOffset?: number;
+    endMonth: number;
+    endDay?: number;
+}
+export interface GradeTemplate extends GradeTemplateBrief {
+    missions: GradeTemplateMission[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateGradeTemplateInput {
+    title: string;
+    gradeLevel: number;
+    startYearOffset?: number;
+    startMonth: number;
+    startDay?: number;
+    endYearOffset?: number;
+    endMonth: number;
+    endDay?: number;
+}
+export interface GradeTemplateFilters {
+    ids?: string[];
+    startGrade?: number;
+    endGrade?: number;
+}
+export interface AddGradeTemplateToRoadmapInput {
+    studentId: string;
+    startYear: number;
+    missions?: {
+        gradeTemplateMissionId: string;
+        taskIds?: string[];
+        startDate?: string;
+        endDate?: string;
+    }[];
+}
+export declare class GradeTemplatesApi {
+    private client;
+    constructor(client: CrimsonClient);
+    /**
+     * List grade templates
+     */
+    listGradeTemplates(filters?: GradeTemplateFilters): Promise<GradeTemplate[]>;
+    /**
+     * Get grade template by ID
+     */
+    getGradeTemplateById(id: string): Promise<GradeTemplate>;
+    /**
+     * Create a new grade template
+     */
+    createGradeTemplate(input: CreateGradeTemplateInput): Promise<GradeTemplate>;
+    /**
+     * Delete a grade template
+     */
+    deleteGradeTemplate(id: string): Promise<void>;
+    /**
+     * Add mission to grade template
+     */
+    addMissionToGradeTemplate(id: string, input: CreateGradeTemplateMissionInput): Promise<GradeTemplateMission>;
+    /**
+     * Remove mission from grade template
+     */
+    removeMissionFromGradeTemplate(missionId: string): Promise<void>;
+    /**
+     * Add grade template to roadmap
+     */
+    addGradeTemplateToRoadmap(id: string, input: AddGradeTemplateToRoadmapInput): Promise<{
+        success: boolean;
+    }>;
+}

package/dist/core/gradeTemplates.js

@@ -0,0 +1,98 @@
+"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.GradeTemplatesApi = void 0;
+class GradeTemplatesApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List grade templates
+     */
+    listGradeTemplates(filters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = new URLSearchParams();
+            if ((filters === null || filters === void 0 ? void 0 : filters.startGrade) !== undefined) {
+                params.append("startgrade", String(filters.startGrade));
+            }
+            if ((filters === null || filters === void 0 ? void 0 : filters.endGrade) !== undefined) {
+                params.append("endgrade", String(filters.endGrade));
+            }
+            const query = params.toString();
+            const path = query
+                ? `/roadmap/grade-templates?${query}`
+                : "/roadmap/grade-templates";
+            return this.client.fetch(path);
+        });
+    }
+    /**
+     * Get grade template by ID
+     */
+    getGradeTemplateById(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/grade-templates/${id}`);
+        });
+    }
+    /**
+     * Create a new grade template
+     */
+    createGradeTemplate(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/roadmap/grade-templates", {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+    /**
+     * Delete a grade template
+     */
+    deleteGradeTemplate(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/grade-templates/${id}`, {
+                method: "DELETE",
+            });
+        });
+    }
+    /**
+     * Add mission to grade template
+     */
+    addMissionToGradeTemplate(id, input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/grade-templates/${id}/missions`, {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+    /**
+     * Remove mission from grade template
+     */
+    removeMissionFromGradeTemplate(missionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/grade-templates/missions/${missionId}`, {
+                method: "DELETE",
+            });
+        });
+    }
+    /**
+     * Add grade template to roadmap
+     */
+    addGradeTemplateToRoadmap(id, input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch(`/roadmap/grade-templates/${id}/add-to-roadmap`, {
+                method: "POST",
+                body: JSON.stringify(input),
+            });
+        });
+    }
+}
+exports.GradeTemplatesApi = GradeTemplatesApi;

package/dist/core/index.d.ts

@@ -6,6 +6,8 @@ export { MissionLibraryApi } from "./missionLibrary";
 export { UsersApi } from "./users";
 export { AccountApi } from "./account";
 export { StudentProfileApi } from "./studentProfile";
+export { IndigoApi } from "./indigo";
+export * from "./gradeTemplates";
 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

@@ -14,7 +14,7 @@ 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;
+exports.generateState = exports.generateCodeChallenge = exports.generateCodeVerifier = exports.createDefaultTokenStorage = exports.MemoryTokenStorage = exports.SessionStorageTokenStorage = exports.LocalStorageTokenStorage = exports.TokenManager = exports.createCrimsonOAuthAdapter = exports.OAuthAdapter = exports.IndigoApi = 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; } });
@@ -32,6 +32,9 @@ 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; } });
+var indigo_1 = require("./indigo");
+Object.defineProperty(exports, "IndigoApi", { enumerable: true, get: function () { return indigo_1.IndigoApi; } });
+__exportStar(require("./gradeTemplates"), exports);
 __exportStar(require("./types"), exports);
 // OAuth authentication
 var auth_1 = require("./auth");

package/dist/core/indigo.d.ts

@@ -0,0 +1,103 @@
+import type { CrimsonClient } from "./client";
+import type { IndigoMe, IndigoTutor, IndigoStudent } from "./types";
+/**
+ * Indigo API Module
+ *
+ * Provides methods for Indigo-specific functionality including:
+ * - User identity retrieval
+ * - Student-tutor relationships
+ * - Cross-tenant aggregation for multi-tenant users
+ *
+ * @example
+ * ```typescript
+ * const client = createCrimsonClient({
+ *   apiUrl: 'https://api.crimson.io',
+ *   clientId: 'indigo-website',
+ *   getToken: () => localStorage.getItem('token') || '',
+ * });
+ *
+ * // Get current user's Indigo identity
+ * const me = await client.indigo.getMe();
+ * console.log(`Role: ${me.role}, Multi-tenant: ${me.isMultiTenant}`);
+ *
+ * // For students: get tutors
+ * if (me.role === 'student') {
+ *   const tutors = await client.indigo.getStudentTutors();
+ * }
+ *
+ * // For tutors: get students (aggregated across tenants)
+ * if (me.role === 'tutor') {
+ *   const students = await client.indigo.getTutorStudents();
+ * }
+ * ```
+ */
+export declare class IndigoApi {
+    private client;
+    constructor(client: CrimsonClient);
+    /**
+     * Get the current user's Indigo identity information
+     *
+     * Returns the authenticated user's identity including:
+     * - Basic profile (userId, email, name)
+     * - Role (student or tutor)
+     * - Tenant information
+     * - Multi-tenant status and related accounts
+     *
+     * @returns Current user's Indigo identity
+     * @throws Error if user is not authenticated or doesn't have Indigo subscription
+     *
+     * @example
+     * ```typescript
+     * const me = await client.indigo.getMe();
+     * if (me.isMultiTenant) {
+     *   console.log(`User has ${me.relatedAccounts.length} related accounts`);
+     * }
+     * ```
+     */
+    getMe(): Promise<IndigoMe>;
+    /**
+     * Get the list of tutors for the current student
+     *
+     * Returns tutors associated with the authenticated student user.
+     * For multi-tenant students, this aggregates tutors across all
+     * related accounts.
+     *
+     * @returns Array of tutors with contract information
+     * @throws Error if user is not a student or not authenticated
+     *
+     * @example
+     * ```typescript
+     * const tutors = await client.indigo.getStudentTutors();
+     * tutors.forEach(tutor => {
+     *   console.log(`${tutor.firstName} ${tutor.lastName} (${tutor.source})`);
+     * });
+     * ```
+     */
+    getStudentTutors(): Promise<IndigoTutor[]>;
+    /**
+     * Get the list of students for the current tutor
+     *
+     * Returns students associated with the authenticated tutor user.
+     * For multi-tenant tutors (e.g., tutors working with both Crimson App
+     * and Collegewise students), this aggregates students across all
+     * related accounts, with source tracking.
+     *
+     * @returns Array of students with contract and source information
+     * @throws Error if user is not a tutor or not authenticated
+     *
+     * @example
+     * ```typescript
+     * const students = await client.indigo.getTutorStudents();
+     *
+     * // Group by source tenant
+     * const bySource = students.reduce((acc, s) => {
+     *   (acc[s.source] ||= []).push(s);
+     *   return acc;
+     * }, {} as Record<string, IndigoStudent[]>);
+     *
+     * console.log(`Crimson App: ${bySource.crimsonapp?.length || 0} students`);
+     * console.log(`Collegewise: ${bySource.collegewise?.length || 0} students`);
+     * ```
+     */
+    getTutorStudents(): Promise<IndigoStudent[]>;
+}

package/dist/core/indigo.js

@@ -0,0 +1,127 @@
+"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.IndigoApi = void 0;
+/**
+ * Indigo API Module
+ *
+ * Provides methods for Indigo-specific functionality including:
+ * - User identity retrieval
+ * - Student-tutor relationships
+ * - Cross-tenant aggregation for multi-tenant users
+ *
+ * @example
+ * ```typescript
+ * const client = createCrimsonClient({
+ *   apiUrl: 'https://api.crimson.io',
+ *   clientId: 'indigo-website',
+ *   getToken: () => localStorage.getItem('token') || '',
+ * });
+ *
+ * // Get current user's Indigo identity
+ * const me = await client.indigo.getMe();
+ * console.log(`Role: ${me.role}, Multi-tenant: ${me.isMultiTenant}`);
+ *
+ * // For students: get tutors
+ * if (me.role === 'student') {
+ *   const tutors = await client.indigo.getStudentTutors();
+ * }
+ *
+ * // For tutors: get students (aggregated across tenants)
+ * if (me.role === 'tutor') {
+ *   const students = await client.indigo.getTutorStudents();
+ * }
+ * ```
+ */
+class IndigoApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the current user's Indigo identity information
+     *
+     * Returns the authenticated user's identity including:
+     * - Basic profile (userId, email, name)
+     * - Role (student or tutor)
+     * - Tenant information
+     * - Multi-tenant status and related accounts
+     *
+     * @returns Current user's Indigo identity
+     * @throws Error if user is not authenticated or doesn't have Indigo subscription
+     *
+     * @example
+     * ```typescript
+     * const me = await client.indigo.getMe();
+     * if (me.isMultiTenant) {
+     *   console.log(`User has ${me.relatedAccounts.length} related accounts`);
+     * }
+     * ```
+     */
+    getMe() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/api/v1/indigo/me");
+        });
+    }
+    /**
+     * Get the list of tutors for the current student
+     *
+     * Returns tutors associated with the authenticated student user.
+     * For multi-tenant students, this aggregates tutors across all
+     * related accounts.
+     *
+     * @returns Array of tutors with contract information
+     * @throws Error if user is not a student or not authenticated
+     *
+     * @example
+     * ```typescript
+     * const tutors = await client.indigo.getStudentTutors();
+     * tutors.forEach(tutor => {
+     *   console.log(`${tutor.firstName} ${tutor.lastName} (${tutor.source})`);
+     * });
+     * ```
+     */
+    getStudentTutors() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/api/v1/indigo/student/tutors");
+        });
+    }
+    /**
+     * Get the list of students for the current tutor
+     *
+     * Returns students associated with the authenticated tutor user.
+     * For multi-tenant tutors (e.g., tutors working with both Crimson App
+     * and Collegewise students), this aggregates students across all
+     * related accounts, with source tracking.
+     *
+     * @returns Array of students with contract and source information
+     * @throws Error if user is not a tutor or not authenticated
+     *
+     * @example
+     * ```typescript
+     * const students = await client.indigo.getTutorStudents();
+     *
+     * // Group by source tenant
+     * const bySource = students.reduce((acc, s) => {
+     *   (acc[s.source] ||= []).push(s);
+     *   return acc;
+     * }, {} as Record<string, IndigoStudent[]>);
+     *
+     * console.log(`Crimson App: ${bySource.crimsonapp?.length || 0} students`);
+     * console.log(`Collegewise: ${bySource.collegewise?.length || 0} students`);
+     * ```
+     */
+    getTutorStudents() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.fetch("/api/v1/indigo/tutor/students");
+        });
+    }
+}
+exports.IndigoApi = IndigoApi;

package/dist/core/types.d.ts

@@ -383,6 +383,106 @@ export interface StudentSummary {
 export interface MyStudentsResponse {
     data: StudentSummary[];
 }
+/**
+ * Subscription source - matches production tenant names
+ */
+export type SubscriptionSource = "crimsonapp" | "collegewise" | "crimsonmoe" | "delta" | "indigo" | "kfs" | "mawhiba";
+/**
+ * Related account for multi-tenant users
+ */
+export interface IndigoRelatedAccount {
+    userId: string;
+    email: string;
+    tenantName: string;
+}
+/**
+ * Response from GET /api/v1/indigo/me
+ * Contains current user's Indigo identity information
+ */
+export interface IndigoMe {
+    userId: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    /** User role: student or tutor */
+    role: "student" | "tutor";
+    /** Primary tenant ID */
+    tenantId: string;
+    /** Primary tenant name */
+    tenantName: string;
+    /** Whether user has accounts across multiple tenants */
+    isMultiTenant: boolean;
+    /** Related accounts in other tenants (for multi-tenant users) */
+    relatedAccounts: IndigoRelatedAccount[];
+}
+/**
+ * Tutor information for students
+ * Response item from GET /api/v1/indigo/student/tutors
+ */
+export interface IndigoTutor {
+    userId: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    profileImageUrl?: string;
+    /** Contract ID linking student and tutor */
+    contractId: string;
+    /** Contract status (e.g., 'active', 'accepted') */
+    contractStatus: string;
+    /** Source tenant where this relationship exists */
+    source: string;
+}
+/**
+ * Student information for tutors
+ * Response item from GET /api/v1/indigo/tutor/students
+ */
+export interface IndigoStudent {
+    userId: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    profileImageUrl?: string;
+    /** Contract ID linking student and tutor */
+    contractId: string;
+    /** Contract status (e.g., 'active', 'accepted') */
+    contractStatus: string;
+    /** Source tenant where this relationship exists (e.g., 'crimsonapp', 'collegewise') */
+    source: string;
+}
+/**
+ * Role information in user profile
+ */
+export interface UserProfileRole {
+    roleId: string;
+    roleName: string;
+    isPrimary: boolean;
+}
+/**
+ * User profile response from GET /api/v1/account/me/profile
+ */
+export interface UserProfile {
+    userId: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    /** Preferred name / nickname */
+    nickname: string | null;
+    /** Full display name (firstName + lastName) */
+    name: string;
+    /** Profile picture URL */
+    picture: string | null;
+    /** User status */
+    status: string;
+    /** Whether user has accounts in multiple tenants */
+    isMultiTenant: boolean;
+    /** User roles (can have multiple) */
+    roles: UserProfileRole[];
+    /** Tenant information */
+    tenant: {
+        id: string;
+        name: string;
+    };
+}
 /**
  * Prefilled field with value and source information
  */

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

@@ -2,9 +2,11 @@ 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, useBulkDeleteTasks, useBulkUpdateTasks, taskKeys, useGetDownloadUrl, useTaskCreators } from "./useTasks";
+export { useTasks, useAllUserTasks, useTasksByRoadmapId, useTasksInfinite, useCreateTask, useUpdateTask, useDeleteTask, useBulkDeleteTasks, useBulkUpdateTasks, taskKeys, useGetDownloadUrl, useTaskCreators, } from "./useTasks";
 export { useUsers, useUser, userKeys } from "./useUsers";
 export { useCurrentUserRoles, useMyStudents, accountKeys } from "./useAccount";
 export { useRoadmapContext } from "./useRoadmapContext";
 export { useTemplateMissions, useTemplateMissionsInfinite, useTemplateTasks, useTemplateTasksInfinite, useTemplateMissionDetail, useUpdateTemplateMission, useCopyTemplateMission, useAssignBulkMission, useAssignBulkTask, useCreateFromPredefinedTasks, missionLibraryKeys, useCreateTemplateMission, useDeleteTemplateMission, } from "./useMissionLibrary";
 export { useStudentProfile, useStudentPrefilledInfo, studentProfileKeys, } from "./useStudentProfile";
+export { useIndigoMe, useStudentTutors, useTutorStudents, indigoKeys, } from "./useIndigo";
+export * from "./useGradeTemplates";

package/dist/react/hooks/index.js

@@ -1,6 +1,20 @@
 "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.studentProfileKeys = exports.useStudentPrefilledInfo = exports.useStudentProfile = exports.useDeleteTemplateMission = exports.useCreateTemplateMission = exports.missionLibraryKeys = exports.useCreateFromPredefinedTasks = exports.useAssignBulkTask = exports.useAssignBulkMission = exports.useCopyTemplateMission = exports.useUpdateTemplateMission = exports.useTemplateMissionDetail = exports.useTemplateTasksInfinite = exports.useTemplateTasks = exports.useTemplateMissionsInfinite = exports.useTemplateMissions = exports.useRoadmapContext = exports.accountKeys = exports.useMyStudents = exports.useCurrentUserRoles = exports.userKeys = exports.useUser = exports.useUsers = exports.useTaskCreators = exports.useGetDownloadUrl = exports.taskKeys = exports.useBulkUpdateTasks = exports.useBulkDeleteTasks = exports.useDeleteTask = exports.useUpdateTask = exports.useCreateTask = exports.useTasksInfinite = exports.useTasksByRoadmapId = exports.useAllUserTasks = exports.useTasks = exports.missionKeys = exports.useDeleteMission = exports.useUpdateMission = exports.useCreateMission = exports.useMissionsInfinite = exports.useMissions = exports.useOAuthCallback = exports.useOAuth = exports.useAuthState = void 0;
+exports.indigoKeys = exports.useTutorStudents = exports.useStudentTutors = exports.useIndigoMe = exports.studentProfileKeys = exports.useStudentPrefilledInfo = exports.useStudentProfile = exports.useDeleteTemplateMission = exports.useCreateTemplateMission = exports.missionLibraryKeys = exports.useCreateFromPredefinedTasks = exports.useAssignBulkTask = exports.useAssignBulkMission = exports.useCopyTemplateMission = exports.useUpdateTemplateMission = exports.useTemplateMissionDetail = exports.useTemplateTasksInfinite = exports.useTemplateTasks = exports.useTemplateMissionsInfinite = exports.useTemplateMissions = exports.useRoadmapContext = exports.accountKeys = exports.useMyStudents = exports.useCurrentUserRoles = exports.userKeys = exports.useUser = exports.useUsers = exports.useTaskCreators = exports.useGetDownloadUrl = exports.taskKeys = exports.useBulkUpdateTasks = exports.useBulkDeleteTasks = exports.useDeleteTask = exports.useUpdateTask = exports.useCreateTask = exports.useTasksInfinite = exports.useTasksByRoadmapId = exports.useAllUserTasks = exports.useTasks = exports.missionKeys = exports.useDeleteMission = exports.useUpdateMission = exports.useCreateMission = exports.useMissionsInfinite = exports.useMissions = exports.useOAuthCallback = exports.useOAuth = exports.useAuthState = void 0;
 var useAuthState_1 = require("./useAuthState");
 Object.defineProperty(exports, "useAuthState", { enumerable: true, get: function () { return useAuthState_1.useAuthState; } });
 var useOAuth_1 = require("./useOAuth");
@@ -54,3 +68,9 @@ 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; } });
+var useIndigo_1 = require("./useIndigo");
+Object.defineProperty(exports, "useIndigoMe", { enumerable: true, get: function () { return useIndigo_1.useIndigoMe; } });
+Object.defineProperty(exports, "useStudentTutors", { enumerable: true, get: function () { return useIndigo_1.useStudentTutors; } });
+Object.defineProperty(exports, "useTutorStudents", { enumerable: true, get: function () { return useIndigo_1.useTutorStudents; } });
+Object.defineProperty(exports, "indigoKeys", { enumerable: true, get: function () { return useIndigo_1.indigoKeys; } });
+__exportStar(require("./useGradeTemplates"), exports);

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

@@ -0,0 +1,24 @@
+import type { GradeTemplateFilters, CreateGradeTemplateInput, CreateGradeTemplateMissionInput, AddGradeTemplateToRoadmapInput } from "../../core/gradeTemplates";
+export declare const gradeTemplateKeys: {
+    all: readonly ["gradeTemplates"];
+    list: (filters?: GradeTemplateFilters) => readonly ["gradeTemplates", "list", GradeTemplateFilters | undefined];
+    detail: (id: string) => readonly ["gradeTemplates", "detail", string];
+};
+export declare function useGradeTemplates(filters?: GradeTemplateFilters, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<import("../../core/gradeTemplates").GradeTemplate[], Error>;
+export declare function useGradeTemplate(id: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<import("../../core/gradeTemplates").GradeTemplate, Error>;
+export declare function useCreateGradeTemplate(): import("@tanstack/react-query").UseMutationResult<import("../../core/gradeTemplates").GradeTemplate, Error, CreateGradeTemplateInput, unknown>;
+export declare function useDeleteGradeTemplate(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+export declare function useAddMissionToGradeTemplate(): import("@tanstack/react-query").UseMutationResult<import("../../core/gradeTemplates").GradeTemplateMission, Error, {
+    id: string;
+    input: CreateGradeTemplateMissionInput;
+}, unknown>;
+export declare function useRemoveMissionFromGradeTemplate(): import("@tanstack/react-query").UseMutationResult<void, Error, {
+    gradeTemplateId: string;
+    missionId: string;
+}, unknown>;
+export declare function useAddGradeTemplateToRoadmap(): import("@tanstack/react-query").UseMutationResult<{
+    success: boolean;
+}, Error, {
+    id: string;
+    input: AddGradeTemplateToRoadmapInput;
+}, unknown>;

package/dist/react/hooks/useGradeTemplates.js

@@ -0,0 +1,97 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gradeTemplateKeys = void 0;
+exports.useGradeTemplates = useGradeTemplates;
+exports.useGradeTemplate = useGradeTemplate;
+exports.useCreateGradeTemplate = useCreateGradeTemplate;
+exports.useDeleteGradeTemplate = useDeleteGradeTemplate;
+exports.useAddMissionToGradeTemplate = useAddMissionToGradeTemplate;
+exports.useRemoveMissionFromGradeTemplate = useRemoveMissionFromGradeTemplate;
+exports.useAddGradeTemplateToRoadmap = useAddGradeTemplateToRoadmap;
+const react_query_1 = require("@tanstack/react-query");
+const provider_1 = require("../provider");
+const useMissions_1 = require("./useMissions");
+const useTasks_1 = require("./useTasks");
+exports.gradeTemplateKeys = {
+    all: ["gradeTemplates"],
+    list: (filters) => [...exports.gradeTemplateKeys.all, "list", filters],
+    detail: (id) => [...exports.gradeTemplateKeys.all, "detail", id],
+};
+// --- Queries ---
+function useGradeTemplates(filters, enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.gradeTemplateKeys.list(filters),
+        queryFn: () => client.gradeTemplates.listGradeTemplates(filters),
+        enabled,
+    });
+}
+function useGradeTemplate(id, enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.gradeTemplateKeys.detail(id),
+        queryFn: () => client.gradeTemplates.getGradeTemplateById(id),
+        enabled: !!id && enabled,
+    });
+}
+// --- Mutations ---
+function useCreateGradeTemplate() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (input) => client.gradeTemplates.createGradeTemplate(input),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: exports.gradeTemplateKeys.list(),
+            });
+        },
+    });
+}
+function useDeleteGradeTemplate() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (id) => client.gradeTemplates.deleteGradeTemplate(id),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: exports.gradeTemplateKeys.list(),
+            });
+        },
+    });
+}
+function useAddMissionToGradeTemplate() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ id, input, }) => client.gradeTemplates.addMissionToGradeTemplate(id, input),
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({
+                queryKey: exports.gradeTemplateKeys.detail(variables.id),
+            });
+        },
+    });
+}
+function useRemoveMissionFromGradeTemplate() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ gradeTemplateId, missionId }) => client.gradeTemplates.removeMissionFromGradeTemplate(missionId),
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({
+                queryKey: exports.gradeTemplateKeys.detail(variables.gradeTemplateId),
+            });
+        },
+    });
+}
+function useAddGradeTemplateToRoadmap() {
+    const client = (0, provider_1.useCrimsonClient)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ id, input, }) => client.gradeTemplates.addGradeTemplateToRoadmap(id, input),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: useMissions_1.missionKeys.all });
+            queryClient.invalidateQueries({ queryKey: useTasks_1.taskKeys.all });
+        },
+    });
+}

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

@@ -0,0 +1,112 @@
+import type { IndigoMe, IndigoTutor, IndigoStudent } from "../../core/types";
+export declare const indigoKeys: {
+    all: readonly ["indigo"];
+    me: () => readonly ["indigo", "me"];
+    studentTutors: () => readonly ["indigo", "studentTutors"];
+    tutorStudents: () => readonly ["indigo", "tutorStudents"];
+};
+/**
+ * Hook to get current user's Indigo identity
+ *
+ * Returns the authenticated user's identity including:
+ * - Basic profile (userId, email, name)
+ * - Role (student or tutor)
+ * - Tenant information
+ * - Multi-tenant status and related accounts
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing IndigoMe data
+ *
+ * @example
+ * ```tsx
+ * function IndigoProfile() {
+ *   const { data: me, isLoading } = useIndigoMe();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{me.firstName} {me.lastName}</h1>
+ *       <p>Role: {me.role}</p>
+ *       {me.isMultiTenant && (
+ *         <p>Has {me.relatedAccounts.length} related accounts</p>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useIndigoMe(enabled?: boolean): import("@tanstack/react-query").UseQueryResult<IndigoMe, Error>;
+/**
+ * Hook to get tutors for the current student
+ *
+ * Returns tutors associated with the authenticated student user.
+ * For multi-tenant students, this aggregates tutors across all
+ * related accounts.
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing array of IndigoTutor
+ *
+ * @example
+ * ```tsx
+ * function StudentTutorList() {
+ *   const { data: me } = useIndigoMe();
+ *   const { data: tutors, isLoading } = useStudentTutors(me?.role === 'student');
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <ul>
+ *       {tutors?.map(tutor => (
+ *         <li key={tutor.contractId}>
+ *           {tutor.firstName} {tutor.lastName}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export declare function useStudentTutors(enabled?: boolean): import("@tanstack/react-query").UseQueryResult<IndigoTutor[], Error>;
+/**
+ * Hook to get students for the current tutor
+ *
+ * Returns students associated with the authenticated tutor user.
+ * For multi-tenant tutors, this aggregates students across all
+ * related accounts with source tracking.
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing array of IndigoStudent
+ *
+ * @example
+ * ```tsx
+ * function TutorStudentList() {
+ *   const { data: me } = useIndigoMe();
+ *   const { data: students, isLoading } = useTutorStudents(me?.role === 'tutor');
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   // Group by source tenant
+ *   const bySource = students?.reduce((acc, s) => {
+ *     (acc[s.source] ||= []).push(s);
+ *     return acc;
+ *   }, {} as Record<string, IndigoStudent[]>);
+ *
+ *   return (
+ *     <div>
+ *       {Object.entries(bySource || {}).map(([source, list]) => (
+ *         <section key={source}>
+ *           <h2>{source} ({list.length})</h2>
+ *           <ul>
+ *             {list.map(s => (
+ *               <li key={s.contractId}>{s.firstName} {s.lastName}</li>
+ *             ))}
+ *           </ul>
+ *         </section>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTutorStudents(enabled?: boolean): import("@tanstack/react-query").UseQueryResult<IndigoStudent[], Error>;

package/dist/react/hooks/useIndigo.js

@@ -0,0 +1,160 @@
+"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.indigoKeys = void 0;
+exports.useIndigoMe = useIndigoMe;
+exports.useStudentTutors = useStudentTutors;
+exports.useTutorStudents = useTutorStudents;
+const react_query_1 = require("@tanstack/react-query");
+const provider_1 = require("../provider");
+// Query keys for Indigo module
+exports.indigoKeys = {
+    all: ["indigo"],
+    me: () => [...exports.indigoKeys.all, "me"],
+    studentTutors: () => [...exports.indigoKeys.all, "studentTutors"],
+    tutorStudents: () => [...exports.indigoKeys.all, "tutorStudents"],
+};
+/**
+ * Hook to get current user's Indigo identity
+ *
+ * Returns the authenticated user's identity including:
+ * - Basic profile (userId, email, name)
+ * - Role (student or tutor)
+ * - Tenant information
+ * - Multi-tenant status and related accounts
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing IndigoMe data
+ *
+ * @example
+ * ```tsx
+ * function IndigoProfile() {
+ *   const { data: me, isLoading } = useIndigoMe();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{me.firstName} {me.lastName}</h1>
+ *       <p>Role: {me.role}</p>
+ *       {me.isMultiTenant && (
+ *         <p>Has {me.relatedAccounts.length} related accounts</p>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useIndigoMe(enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.indigoKeys.me(),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            return client.indigo.getMe();
+        }),
+        enabled,
+        staleTime: 1000 * 60 * 5, // 5 minutes - identity doesn't change often
+    });
+}
+/**
+ * Hook to get tutors for the current student
+ *
+ * Returns tutors associated with the authenticated student user.
+ * For multi-tenant students, this aggregates tutors across all
+ * related accounts.
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing array of IndigoTutor
+ *
+ * @example
+ * ```tsx
+ * function StudentTutorList() {
+ *   const { data: me } = useIndigoMe();
+ *   const { data: tutors, isLoading } = useStudentTutors(me?.role === 'student');
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <ul>
+ *       {tutors?.map(tutor => (
+ *         <li key={tutor.contractId}>
+ *           {tutor.firstName} {tutor.lastName}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+function useStudentTutors(enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.indigoKeys.studentTutors(),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            return client.indigo.getStudentTutors();
+        }),
+        enabled,
+        staleTime: 1000 * 60 * 5, // 5 minutes
+    });
+}
+/**
+ * Hook to get students for the current tutor
+ *
+ * Returns students associated with the authenticated tutor user.
+ * For multi-tenant tutors, this aggregates students across all
+ * related accounts with source tracking.
+ *
+ * @param enabled - Whether to enable the query (default: true)
+ * @returns Query result containing array of IndigoStudent
+ *
+ * @example
+ * ```tsx
+ * function TutorStudentList() {
+ *   const { data: me } = useIndigoMe();
+ *   const { data: students, isLoading } = useTutorStudents(me?.role === 'tutor');
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   // Group by source tenant
+ *   const bySource = students?.reduce((acc, s) => {
+ *     (acc[s.source] ||= []).push(s);
+ *     return acc;
+ *   }, {} as Record<string, IndigoStudent[]>);
+ *
+ *   return (
+ *     <div>
+ *       {Object.entries(bySource || {}).map(([source, list]) => (
+ *         <section key={source}>
+ *           <h2>{source} ({list.length})</h2>
+ *           <ul>
+ *             {list.map(s => (
+ *               <li key={s.contractId}>{s.firstName} {s.lastName}</li>
+ *             ))}
+ *           </ul>
+ *         </section>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useTutorStudents(enabled = true) {
+    const client = (0, provider_1.useCrimsonClient)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.indigoKeys.tutorStudents(),
+        queryFn: () => __awaiter(this, void 0, void 0, function* () {
+            return client.indigo.getTutorStudents();
+        }),
+        enabled,
+        staleTime: 1000 * 60 * 5, // 5 minutes
+    });
+}

package/package.json

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