@timeback/powerpath 0.2.2-beta.20260331191116 → 0.2.2

package/dist/public-types.d.ts

@@ -1,1184 +1,2 @@
-/**
- * PowerPath Base Types
- *
- * Common types and enums for PowerPath API responses.
- */
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ENUMS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Test assignment status values.
- */
-type TestAssignmentStatus =
-	| 'assigned'
-	| 'in_progress'
-	| 'completed'
-	| 'failed'
-	| 'expired'
-	| 'cancelled'
-
-/**
- * Lesson types for PowerPath assessments.
- */
-type PowerPathLessonType =
-	| 'powerpath-100'
-	| 'quiz'
-	| 'test-out'
-	| 'placement'
-	| 'unit-test'
-	| 'alpha-read-article'
-
-/**
- * Lesson types that behave like quizzes (static tests with finalization).
- *
- * These types can be finalized via `finalStudentAssessmentResponse`,
- * return score 0 while not finalized, and support both internal and external tests.
- */
-type QuizLikeLessonType = 'quiz' | 'test-out' | 'placement' | 'unit-test'
-
-/**
- * Lesson types that support external test assignment via third-party tools.
- *
- * These types can use `makeExternalTestAssignment` and
- * `importExternalTestAssignmentResults`.
- */
-type ExternalTestCapableLessonType = 'test-out' | 'placement' | 'unit-test'
-
-/**
- * Score status values for assessment attempts.
- */
-type ScoreStatus =
-	| 'exempt'
-	| 'fully graded'
-	| 'not submitted'
-	| 'partially graded'
-	| 'submitted'
-
-/**
- * Question difficulty levels.
- */
-type PowerPathQuestionDifficulty = 'easy' | 'medium' | 'hard'
-
-/**
- * Lesson plan operation types.
- */
-type LessonPlanOperationType =
-	| 'set-skipped'
-	| 'add-custom-resource'
-	| 'move-item-before'
-	| 'move-item-after'
-	| 'move-item-to-start'
-	| 'move-item-to-end'
-	| 'change-item-parent'
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// PAGINATION
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Pagination metadata from PowerPath list responses.
- */
-interface PaginationMeta {
-	/** Total items across all pages */
-	totalCount: number
-	/** Total number of pages */
-	pageCount: number
-	/** Current page number (1-indexed) */
-	pageNumber: number
-	/**
-	 * Offset for the next page of results.
-	 *
-	 * This API uses offset pagination: request `offset` is the number of items to skip.
-	 * List responses also include an `offset` field; treat it as the server-provided
-	 * next offset (and fall back to `currentOffset + limit` when implementing iterators).
-	 */
-	offset: number
-	/** Items per page (default 100, max 3000) */
-	limit: number
-}
-
-/**
- * PowerPath Response Types
- *
- * Entity types returned by PowerPath API endpoints.
- */
-
-
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// TEST ASSIGNMENTS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * A single test assignment entity.
- */
-interface TestAssignment {
-	sourcedId: string
-	studentSourcedId: string
-	studentEmail: string
-	assignedByUserSourcedId: string | null
-	subject: string
-	grade: string
-	assignmentStatus: TestAssignmentStatus
-	testName?: string | null
-	assignedAt?: string | null
-	expiresAt?: string | null
-	completedAt?: string | null
-	resourceSourcedId?: string | null
-	componentResourceSourcedId?: string | null
-}
-
-/**
- * List response for test assignments.
- */
-interface TestAssignmentsListResponse extends PaginationMeta {
-	testAssignments: TestAssignment[]
-}
-
-/**
- * Result from creating a test assignment.
- */
-interface AssignmentResult {
-	assignmentId: string
-	lessonId: string
-	resourceId: string
-}
-
-/**
- * Result from bulk operations.
- */
-interface BulkResult {
-	success: boolean
-	results: AssignmentResult[]
-	errors: Array<{ row: number; message: string }>
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// QUESTIONS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * QTI content associated with a question.
- */
-interface PowerPathQuestionContent {
-	/** The type of the question (e.g., choiceInteraction) */
-	type?: string
-	/** The raw XML question in QTI format */
-	rawXml: string
-}
-
-/**
- * Result of evaluating a student's response to a question.
- */
-interface PowerPathQuestionResult {
-	/** Score assigned considering the student's response */
-	score: number
-	/** Feedback — plain string from updateStudentQuestionResponse, structured object from progress/next-question responses */
-	feedback: string | { value: string; identifier: string }
-	/** Outcome variables from response processing (values may be strings or numbers) */
-	outcomes?: Record<string, string | number>
-}
-
-/**
- * A question in a PowerPath test.
- *
- * Represents a question with its metadata, optional QTI content,
- * and (when answered) the student's response and result.
- */
-interface PowerPathTestQuestion {
-	/** ID that represents the question in the test */
-	id: string
-	/** Index of the question in the test */
-	index: number
-	/** Title of the question */
-	title: string
-	/** URL of the QTI question */
-	url: string
-	/** Difficulty of the question */
-	difficulty: PowerPathQuestionDifficulty
-	/** Whether the question has been approved by a human */
-	humanApproved?: boolean | null
-	/** QTI content of the question */
-	content?: PowerPathQuestionContent
-	/** Student's response (single value or array) */
-	response?: string | string[]
-	/** Student's responses keyed by response identifier */
-	responses?: Record<string, string | string[]>
-	/** Whether the student's response is correct */
-	correct?: boolean
-	/** Result of evaluating the response */
-	result?: PowerPathQuestionResult
-	/** sourcedId of the AssessmentResult for this question attempt */
-	resultId?: string
-	/** Learning objective IDs associated with the question */
-	learningObjectives?: string[]
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ASSESSMENTS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from creating an external test (test-out or placement).
- */
-interface ExternalTestCreateResponse {
-	/** Type of lesson created. */
-	lessonType: PowerPathLessonType
-	/** The sourcedId of the created lesson (ComponentResource). */
-	lessonId: string
-	/** The sourcedId of the component (unit) containing the test. */
-	courseComponentId: string
-	/** The sourcedId of the resource representing the external test. */
-	resourceId: string
-	/** URL to the external test system. */
-	launchUrl?: string
-	/** The tool provider identifier (e.g. 'edulastic', 'mastery-track'). */
-	toolProvider: string
-	/** The ID of the test in the vendor's system. */
-	vendorId?: string
-	/** The courseId to enroll the student in on failure (placement tests). */
-	courseIdOnFail?: string | null
-	/** Grade levels for the resource. */
-	grades?: Array<number | string>
-}
-
-/**
- * Result from creating an internal test (QTI or assessment-bank).
- */
-interface InternalTestCreateResponse {
-	/** Type of lesson created. */
-	lessonType: PowerPathLessonType
-	/** The internal test type. */
-	testType: 'qti' | 'assessment-bank'
-	/** The sourcedId of the created lesson (ComponentResource). */
-	lessonId: string
-	/** The sourcedId of the component (unit) containing the test. */
-	courseComponentId: string
-	/** The sourcedId of the main resource (parent for assessment-bank). */
-	resourceId: string
-	/** Child resource IDs (only for assessment-bank type). */
-	childResourceIds?: string[]
-	/** The courseId to enroll the student in on failure (placement tests). */
-	courseIdOnFail?: string | null
-	/** Grade levels for the resource. */
-	grades?: Array<number | string>
-}
-
-/**
- * A single attempt record.
- *
- * Matches the backend `PowerPath100AttemptSchema` with full metadata
- * including XP, timestamps, and typed score status.
- */
-interface Attempt {
-	/** Attempt number, or null if not yet started. */
-	attempt: number | null
-	/** Current score for this attempt. */
-	score: number
-	/** Grading status of this attempt. */
-	scoreStatus: ScoreStatus
-	/** XP earned in this attempt. */
-	xp: number | null
-	/** When this attempt was started. */
-	startedAt: string | null
-	/** When this attempt was completed. */
-	completedAt: string | null
-}
-
-/**
- * Result from creating a new attempt.
- */
-interface CreateAttemptResponse {
-	attempt: Attempt
-}
-
-/**
- * Result from getting attempts for a lesson.
- */
-interface GetAttemptsResponse {
-	attempts: Attempt[]
-}
-
-/**
- * Result from resetting an attempt.
- */
-interface ResetAttemptResponse {
-	success: boolean
-	score: number
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ASSESSMENT PROGRESS (getAssessmentProgress)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Progress for a PowerPath 100 lesson.
- *
- * Uses `seenQuestions` (not `questions`) and includes remaining question counts
- * per difficulty level.
- */
-interface PowerPath100ProgressResponse {
-	lessonType: 'powerpath-100'
-	/** Remaining question counts per difficulty level */
-	remainingQuestionsPerDifficulty: {
-		easy: number
-		medium: number
-		hard: number
-	}
-	/** Current score for this attempt */
-	score: number
-	/** Questions the student has seen */
-	seenQuestions: PowerPathTestQuestion[]
-	/** sourcedId of the parent test AssessmentResult */
-	testResultId?: string
-	/** Attempt number */
-	attempt: number
-	/** XP earned in the lesson */
-	xp: number | null
-	/** Multiplier for XP */
-	multiplier: number | null
-	/** Accuracy of the student's attempted questions */
-	accuracy: number
-	/** Number of correct questions answered */
-	correctQuestions: number
-	/** Total number of questions in the lesson */
-	totalQuestions: number
-}
-
-/**
- * Progress for quiz, test-out, placement, or unit-test lessons.
- *
- * Uses `questions` (not `seenQuestions`). Includes `finalized` to indicate
- * whether the lesson has been completed.
- */
-interface StandardProgressResponse {
-	lessonType: 'quiz' | 'test-out' | 'placement' | 'unit-test'
-	/** Whether the lesson has been finalized in the current attempt */
-	finalized: boolean
-	/** Current score for this attempt */
-	score?: number
-	/** Questions in the test */
-	questions: PowerPathTestQuestion[]
-	/** Tool provider of the lesson if external */
-	toolProvider: string | null
-	/** Whether auto-enrollment failed (only for finalized external tests) */
-	enrollmentFailed?: boolean
-	/** sourcedId of the parent test AssessmentResult */
-	testResultId?: string
-	/** Attempt number */
-	attempt: number
-	/** XP earned in the lesson */
-	xp: number | null
-	/** Multiplier for XP */
-	multiplier: number | null
-	/** Accuracy of the student's attempted questions */
-	accuracy: number
-	/** Number of correct questions answered */
-	correctQuestions: number
-	/** Total number of questions in the lesson */
-	totalQuestions: number
-}
-
-/**
- * Result from getting assessment progress.
- *
- * Discriminated union on `lessonType`:
- * - `'powerpath-100'` — uses `seenQuestions` and `remainingQuestionsPerDifficulty`
- * - `'quiz' | 'test-out' | 'placement' | 'unit-test'` — uses `questions` and `finalized`
- */
-type GetAssessmentProgressResponse = PowerPath100ProgressResponse | StandardProgressResponse
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// GET NEXT QUESTION (getNextQuestion)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from getting the next question in a PowerPath 100 lesson.
- */
-interface GetNextQuestionResponse {
-	/** Current PowerPath score of the student in this lesson */
-	score: number
-	/** The next question to present */
-	question: PowerPathTestQuestion
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// UPDATE STUDENT QUESTION RESPONSE (updateStudentQuestionResponse)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Response feedback for a student's answer.
- */
-interface ResponseResultFeedback {
-	identifier?: string
-	value?: string
-}
-
-/**
- * Result of processing a student's response.
- */
-interface ResponseResult {
-	/** Whether the student's response is correct */
-	isCorrect: boolean
-	/** Score for this specific response (0 or 1) */
-	score: number
-	/** Optional feedback */
-	feedback?: ResponseResultFeedback
-}
-
-/**
- * Result from updating a student's response in a PowerPath 100 lesson.
- *
- * Includes the updated PowerPath score, response correctness, and accuracy stats.
- */
-interface PowerPath100UpdateResponseResult {
-	lessonType: 'powerpath-100'
-	/** Updated PowerPath score */
-	powerpathScore: number
-	/** Result of processing the response */
-	responseResult: ResponseResult
-	/** Assessment result for the question (for debugging) */
-	questionResult?: unknown
-	/** Assessment result for the test (for debugging) */
-	testResult?: unknown
-	/** Accuracy of the student's attempted questions */
-	accuracy: number
-	/** Number of correct questions answered */
-	correctQuestions: number
-	/** Total number of questions */
-	totalQuestions: number
-	/** XP earned */
-	xp: number | null
-	/** XP multiplier */
-	multiplier: number | null
-}
-
-/**
- * Result from updating a student's response in a quiz/test-out/placement/unit-test lesson.
- *
- * Minimal response — correctness is evaluated at finalization.
- */
-interface StandardUpdateResponseResult {
-	lessonType: 'quiz' | 'test-out' | 'placement' | 'unit-test'
-	/** Assessment result for the question (for debugging) */
-	questionResult?: unknown
-}
-
-/**
- * Result from updating a student question response.
- *
- * Discriminated union on `lessonType`:
- * - `'powerpath-100'` — includes score, accuracy, and response correctness
- * - Other lesson types — minimal, evaluated at finalization
- */
-type UpdateStudentQuestionResponseResult =
-	| PowerPath100UpdateResponseResult
-	| StandardUpdateResponseResult
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// FINALIZE ASSESSMENT (finalStudentAssessmentResponse)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from finalizing a test assessment.
- *
- * Returned after all questions have been answered and the lesson is
- * evaluated. Only applicable to quiz-like lesson types (quiz, test-out,
- * placement, unit-test). Not applicable to `powerpath-100`.
- */
-interface FinalizeAssessmentResponse {
-	/** Type of the lesson that was finalized (quiz-like only). */
-	lessonType: QuizLikeLessonType
-	/** Whether the lesson has been finalized. */
-	finalized: boolean
-	/** The attempt number. */
-	attempt: number
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// TEST OUT (testOut)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from getting the test-out lesson for a student/course.
- *
- * Returns the test-out lesson reference, finalization status,
- * and optional external tool credentials.
- */
-interface TestOutResponse {
-	lessonType: 'test-out'
-	/** ID of the test-out lesson, or null if none exists */
-	lessonId: string | null
-	/** Whether the test-out has been finalized in the current attempt */
-	finalized: boolean
-	/** Tool provider for the test-out lesson, or null if internal */
-	toolProvider: string | null
-	/** Attempt number */
-	attempt?: number
-	/** Credentials for accessing the assigned test on external tool */
-	credentials?: {
-		email: string
-		password: string
-	}
-	/** Assignment ID on external tool for results retrieval */
-	assignmentId?: string
-	/** Class ID on external tool for results retrieval */
-	classId?: string
-	/** URL of the test on external tool */
-	testUrl?: string
-	/** ID of the test on external tool */
-	testId?: string
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// IMPORT EXTERNAL RESULTS (importExternalTestAssignmentResults)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from importing external test assignment results.
- *
- * Contains the lesson reference, finalization status, and optional
- * external tool credentials/assignment data.
- */
-interface ImportExternalResultsResponse {
-	/** Lesson type (external-capable types only). */
-	lessonType: ExternalTestCapableLessonType
-	/** The sourcedId of the lesson (ComponentResource). */
-	lessonId: string | null
-	/** The tool provider for the lesson. */
-	toolProvider: string | null
-	/** Whether the test has been finalized in the current attempt. */
-	finalized: boolean
-	/** Attempt number. */
-	attempt: number
-	/** Credentials for accessing the assigned test on external tool. */
-	credentials?: {
-		email: string
-		password: string
-	}
-	/** Assignment ID on external tool for results retrieval. */
-	assignmentId?: string
-	/** Class ID on external tool for results retrieval. */
-	classId?: string
-	/** URL of the test on external tool. */
-	testUrl?: string
-	/** ID of the test on external tool. */
-	testId?: string
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// MAKE EXTERNAL TEST ASSIGNMENT (makeExternalTestAssignment)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from assigning an external test to a student.
- *
- * Contains the tool provider, lesson type, attempt number, and optional
- * external tool credentials/assignment data.
- */
-interface MakeExternalTestAssignmentResponse {
-	/** The tool provider (e.g. 'edulastic', 'mastery-track'). */
-	toolProvider: string
-	/** Lesson type (external-capable types only). */
-	lessonType: ExternalTestCapableLessonType
-	/** Attempt number. */
-	attempt: number
-	/** Credentials for accessing the assigned test on external tool. */
-	credentials?: {
-		email: string
-		password: string
-	}
-	/** Assignment ID on external tool for results retrieval. */
-	assignmentId?: string
-	/** Class ID on external tool for results retrieval. */
-	classId?: string
-	/** URL of the test on external tool. */
-	testUrl?: string
-	/** ID of the test on external tool. */
-	testId?: string
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// PLACEMENT
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from getting all placement tests.
- */
-interface GetAllPlacementTestsResponse {
-	placementTests: unknown[]
-}
-
-/**
- * Result from getting current placement level.
- */
-interface GetCurrentLevelResponse {
-	gradeLevel?: unknown
-	onboarded?: boolean
-	availableTests: number
-}
-
-/**
- * Result from getting the next placement test.
- */
-interface GetNextPlacementTestResponse {
-	availableTests: number
-	lesson: string
-}
-
-/**
- * Result from getting subject progress.
- */
-interface GetSubjectProgressResponse {
-	progress: unknown[]
-}
-
-/**
- * Result from resetting placement.
- */
-interface ResetPlacementResponse {
-	success: boolean
-	placementResultsDeleted: number
-	onboardingReset: boolean
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// SCREENING
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from screening getResults.
- * Response shape depends on MAP integration configuration.
- */
-interface ScreeningResultsResponse {
-	[key: string]: unknown
-}
-
-/**
- * Result from screening getSession.
- * Response shape depends on MAP integration configuration.
- */
-interface ScreeningSessionResponse {
-	[key: string]: unknown
-}
-
-/**
- * Result from resetting a screening session.
- */
-interface ScreeningResetSessionResponse {
-	success?: boolean
-	[key: string]: unknown
-}
-
-/**
- * Result from assigning a screening test.
- */
-interface ScreeningAssignTestResponse {
-	success?: boolean
-	[key: string]: unknown
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// LESSON PLANS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from creating a lesson plan.
- */
-interface LessonPlanCreateResponse {
-	lessonPlanId: string
-}
-
-/**
- * A lesson plan operation record.
- */
-interface LessonPlanOperation {
-	id: string
-	type: string
-	payload?: unknown
-	reason?: string
-	createdAt: string
-	sequenceNumber: number
-	createdBy?: string
-}
-
-/**
- * Response containing lesson plan operations.
- */
-interface LessonPlanOperationsResponse {
-	operations: LessonPlanOperation[]
-}
-
-/**
- * Result from a single lesson plan operation.
- */
-interface LessonPlanOperationResult {
-	success: boolean
-	message?: string
-	operationId?: string
-}
-
-/**
- * Result from syncing lesson plan operations.
- */
-interface LessonPlanSyncResult {
-	success: boolean
-	message?: string
-	operationCount: number
-	operationResults: Array<{ success: boolean; errors?: Array<{ message: string }> }>
-}
-
-/**
- * Result from syncing a course.
- */
-interface LessonPlanCourseSyncResult {
-	lessonPlansAffected: string[]
-}
-
-/**
- * Response containing a lesson plan.
- */
-interface LessonPlanResponse {
-	lessonPlan: Record<string, unknown>
-}
-
-/**
- * Response containing course progress.
- */
-interface CourseProgressResponse {
-	lineItems: Record<string, unknown>[]
-}
-
-/**
- * Result from updating student item response.
- */
-interface UpdateStudentItemResponseResult {
-	success?: boolean
-	[key: string]: unknown
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// TEST OUT (self-elected)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from checking test-out eligibility for a student/subject.
- */
-interface GetTestOutEligibilityResponse {
-	eligible: boolean
-	reason?: string
-}
-
-/**
- * Result from creating a self-elected test-out assignment.
- */
-interface MakeExternalStudentTestOutAssignmentResponse {
-	success: boolean
-	data?: Record<string, unknown>
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// RENDER CONFIG
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Result from upserting render configs for one or more courses.
- */
-interface RenderConfigUpsertResponse {
-	updated: string[]
-}
-
-/**
- * Render config for a single course.
- */
-interface RenderConfigGetResponse {
-	courseId: string
-	rendererId: string
-	rendererUrl: string
-	rendererVersion?: string | null
-	suppressFeedback: boolean
-	suppressCorrectResponse: boolean
-}
-
-/**
- * Result from deleting a render config.
- */
-interface RenderConfigDeleteResponse {
-	deleted: string
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// SYLLABUS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Response containing syllabus data.
- */
-interface SyllabusResponse {
-	syllabus?: unknown
-}
-
-type input<T> = T extends {
-    _zod: {
-        input: any;
-    };
-} ? T["_zod"]["input"] : unknown;
-
-/**
- * PowerPath Schemas
- *
- * Zod schemas for the PowerPath adaptive learning API.
- */
-
-
-
-declare const ExternalTestOut = ExternalTestBase.extend({
-	lessonType: z.literal('test-out'),
-	xp: z.number(),
-})
-
-declare const ExternalPlacement = ExternalTestBase.extend({
-	lessonType: z.literal('placement'),
-	courseIdOnFail: NonEmptyString.nullable().optional(),
-	xp: z.number().optional(),
-})
-
-declare const PowerPathCreateExternalPlacementTestInput = ExternalPlacement
-
-declare const PowerPathCreateExternalTestOutInput = ExternalTestOut
-
-declare const PowerPathCreateInternalTestInput = z.discriminatedUnion('testType', [
-	InternalTestBase.extend({
-		testType: z.literal('qti'),
-		qti: z.object({
-			url: z.url(),
-			title: NonEmptyString.optional(),
-			metadata: z.record(z.string(), z.unknown()).optional(),
-		}),
-	}),
-	InternalTestBase.extend({
-		testType: z.literal('assessment-bank'),
-		assessmentBank: z.object({
-			resources: z
-				.array(
-					z.object({
-						url: z.url(),
-						title: NonEmptyString.optional(),
-						metadata: z.record(z.string(), z.unknown()).optional(),
-					}),
-				)
-				.min(1),
-		}),
-	}),
-])
-
-declare const PowerPathCreateNewAttemptInput = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-})
-
-declare const PowerPathFinalStudentAssessmentResponseInput = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-})
-
-declare const PowerPathLessonPlansCreateInput = z.object({
-	courseId: NonEmptyString,
-	userId: NonEmptyString,
-	classId: NonEmptyString.optional(),
-})
-
-declare const PowerPathLessonPlanOperationInput = z.union([
-	z.object({
-		type: z.literal('set-skipped'),
-		payload: z.object({
-			target: LessonPlanTarget,
-			value: z.boolean(),
-		}),
-	}),
-	z.object({
-		type: z.literal('add-custom-resource'),
-		payload: z.object({
-			resource_id: NonEmptyString,
-			parent_component_id: NonEmptyString,
-			skipped: z.boolean().optional(),
-		}),
-	}),
-	z.object({
-		type: z.literal('move-item-before'),
-		payload: z.object({
-			target: LessonPlanTarget,
-			reference_id: NonEmptyString,
-		}),
-	}),
-	z.object({
-		type: z.literal('move-item-after'),
-		payload: z.object({
-			target: LessonPlanTarget,
-			reference_id: NonEmptyString,
-		}),
-	}),
-	z.object({
-		type: z.literal('move-item-to-start'),
-		payload: z.object({
-			target: LessonPlanTarget,
-		}),
-	}),
-	z.object({
-		type: z.literal('move-item-to-end'),
-		payload: z.object({
-			target: LessonPlanTarget,
-		}),
-	}),
-	z.object({
-		type: z.literal('change-item-parent'),
-		payload: z.object({
-			target: LessonPlanTarget,
-			new_parent_id: NonEmptyString,
-			position: z.enum(['start', 'end']).optional(),
-		}),
-	}),
-])
-
-declare const PowerPathLessonPlanOperationsInput = z.object({
-	operation: PowerPathLessonPlanOperationInput,
-	reason: NonEmptyString.optional(),
-})
-
-declare const PowerPathLessonPlanUpdateStudentItemResponseInput = z.object({
-	studentId: NonEmptyString,
-	componentResourceId: NonEmptyString,
-	result: z.object({
-		status: z.enum(['active', 'tobedeleted']),
-		metadata: z.record(z.string(), z.unknown()).optional(),
-		score: z.number().optional(),
-		textScore: NonEmptyString.optional(),
-		scoreDate: z.string().datetime(),
-		scorePercentile: z.number().optional(),
-		scoreStatus: ScoreStatus,
-		comment: NonEmptyString.optional(),
-		learningObjectiveSet: z
-			.array(
-				z.object({
-					source: NonEmptyString,
-					learningObjectiveResults: z.array(
-						z.object({
-							learningObjectiveId: NonEmptyString,
-							score: z.number().optional(),
-							textScore: NonEmptyString.optional(),
-						}),
-					),
-				}),
-			)
-			.optional(),
-		inProgress: NonEmptyString.optional(),
-		incomplete: NonEmptyString.optional(),
-		late: NonEmptyString.optional(),
-		missing: NonEmptyString.optional(),
-	}),
-})
-
-declare const PowerPathMakeExternalTestAssignmentInput = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-	applicationName: NonEmptyString.optional(),
-	testId: NonEmptyString.optional(),
-	skipCourseEnrollment: z.boolean().optional(),
-})
-
-declare const PowerPathPlacementResetUserPlacementInput = z.object({
-	student: NonEmptyString,
-	subject: TimebackSubject,
-})
-
-declare const PowerPathResetAttemptInput = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-})
-
-declare const PowerPathScreeningResetSessionInput = z.object({
-	userId: NonEmptyString,
-})
-
-declare const PowerPathScreeningAssignTestInput = z.object({
-	userId: NonEmptyString,
-	subject: z.enum(['Math', 'Reading', 'Language', 'Science']),
-})
-
-declare const PowerPathTestAssignmentsCreateInput = z.object({
-	student: NonEmptyString,
-	subject: TimebackSubject,
-	grade: TimebackGrade,
-	testName: NonEmptyString.optional(),
-})
-
-declare const PowerPathTestAssignmentsUpdateInput = z.object({
-	testName: NonEmptyString,
-})
-
-declare const PowerPathTestAssignmentsBulkInput = z.object({
-	items: z.array(PowerPathTestAssignmentItemInput),
-})
-
-declare const PowerPathTestAssignmentsImportInput = z.object({
-	spreadsheetUrl: z.url(),
-	sheet: NonEmptyString,
-})
-
-declare const PowerPathTestAssignmentsListParams = z.object({
-	student: NonEmptyString,
-	status: z
-		.enum(['assigned', 'in_progress', 'completed', 'failed', 'expired', 'cancelled'])
-		.optional(),
-	subject: NonEmptyString.optional(),
-	grade: TimebackGrade.optional(),
-	limit: z.number().int().positive().max(3000).optional(),
-	offset: z.number().int().nonnegative().optional(),
-})
-
-declare const PowerPathTestAssignmentsAdminParams = z.object({
-	student: NonEmptyString.optional(),
-	status: z
-		.enum(['assigned', 'in_progress', 'completed', 'failed', 'expired', 'cancelled'])
-		.optional(),
-	subject: NonEmptyString.optional(),
-	grade: TimebackGrade.optional(),
-	limit: z.number().int().positive().max(3000).optional(),
-	offset: z.number().int().nonnegative().optional(),
-})
-
-declare const PowerPathUpdateStudentQuestionResponseInput = z
-	.object({
-		student: NonEmptyString,
-		question: NonEmptyString,
-		response: z.union([NonEmptyString, z.array(NonEmptyString)]).optional(),
-		responses: z
-			.record(z.string(), z.union([NonEmptyString, z.array(NonEmptyString)]))
-			.optional(),
-		lesson: NonEmptyString,
-		rendererOutcomes: z
-			.object({
-				score: z.number(),
-				maxScore: z.number().min(0),
-				isCorrect: z.boolean(),
-			})
-			.optional(),
-		playerState: z.string().optional(),
-	})
-	.refine(data => data.response !== undefined || data.responses !== undefined, {
-		message: "Either 'response' or 'responses' must be provided",
-		path: ['response', 'responses'],
-	})
-	.transform(data => {
-		if (data.response !== undefined && data.responses === undefined) {
-			return { ...data, responses: { RESPONSE: data.response } }
-		}
-
-		return data
-	})
-
-declare const PowerPathGetAssessmentProgressParams = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-	attempt: z.number().int().positive().optional(),
-})
-
-declare const PowerPathGetNextQuestionParams = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-})
-
-declare const PowerPathGetAttemptsParams = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-})
-
-declare const PowerPathTestOutParams = z.object({
-	student: NonEmptyString,
-	course: NonEmptyString,
-})
-
-declare const PowerPathImportExternalTestAssignmentResultsParams = z.object({
-	student: NonEmptyString,
-	lesson: NonEmptyString,
-	applicationName: NonEmptyString.optional(),
-})
-
-declare const PowerPathPlacementQueryParams = z.object({
-	student: NonEmptyString,
-	subject: TimebackSubject,
-})
-
-declare const PowerPathMakeExternalStudentTestOutAssignmentInput = z.object({
-	oneRosterSourcedId: NonEmptyString,
-	subject: NonEmptyString,
-})
-
-declare const PowerPathRenderConfigUpsertInput = z.object({
-	courseIds: z.array(NonEmptyString).min(1),
-	rendererId: NonEmptyString,
-	rendererUrl: z.url(),
-	rendererVersion: NonEmptyString.optional(),
-	suppressFeedback: z.boolean().optional(),
-	suppressCorrectResponse: z.boolean().optional(),
-})
-
-declare const PowerPathSyllabusQueryParams = z.object({
-	status: z.enum(['active', 'tobedeleted']).optional(),
-})
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// TYPE EXPORTS (REQUEST INPUTS)
-// ═══════════════════════════════════════════════════════════════════════════════
-
-// Shorter type aliases (like OneRoster pattern: schema = OneRosterFoo, type = Foo)
-type CreateExternalPlacementTestInput = input<
-	typeof PowerPathCreateExternalPlacementTestInput
->
-type CreateExternalTestOutInput = input<typeof PowerPathCreateExternalTestOutInput>
-type CreateInternalTestInput = input<typeof PowerPathCreateInternalTestInput>
-type CreateNewAttemptInput = input<typeof PowerPathCreateNewAttemptInput>
-type FinalStudentAssessmentResponseInput = input<
-	typeof PowerPathFinalStudentAssessmentResponseInput
->
-type LessonPlansCreateInput = input<typeof PowerPathLessonPlansCreateInput>
-type LessonPlanOperationInput = input<typeof PowerPathLessonPlanOperationInput>
-type LessonPlanOperationsInput = input<typeof PowerPathLessonPlanOperationsInput>
-type LessonPlanUpdateStudentItemResponseInput = input<
-	typeof PowerPathLessonPlanUpdateStudentItemResponseInput
->
-type MakeExternalTestAssignmentInput = input<
-	typeof PowerPathMakeExternalTestAssignmentInput
->
-type PlacementResetUserPlacementInput = input<
-	typeof PowerPathPlacementResetUserPlacementInput
->
-type ResetAttemptInput = input<typeof PowerPathResetAttemptInput>
-type ScreeningResetSessionInput = input<typeof PowerPathScreeningResetSessionInput>
-type ScreeningAssignTestInput = input<typeof PowerPathScreeningAssignTestInput>
-type TestAssignmentsCreateInput = input<typeof PowerPathTestAssignmentsCreateInput>
-type TestAssignmentsUpdateInput = input<typeof PowerPathTestAssignmentsUpdateInput>
-type TestAssignmentsBulkInput = input<typeof PowerPathTestAssignmentsBulkInput>
-type TestAssignmentsImportInput = input<typeof PowerPathTestAssignmentsImportInput>
-type TestAssignmentsListParams = input<typeof PowerPathTestAssignmentsListParams>
-type TestAssignmentsAdminParams = input<typeof PowerPathTestAssignmentsAdminParams>
-type UpdateStudentQuestionResponseInput = input<
-	typeof PowerPathUpdateStudentQuestionResponseInput
->
-type GetAssessmentProgressParams = input<typeof PowerPathGetAssessmentProgressParams>
-type GetNextQuestionParams = input<typeof PowerPathGetNextQuestionParams>
-type GetAttemptsParams = input<typeof PowerPathGetAttemptsParams>
-type TestOutParams = input<typeof PowerPathTestOutParams>
-type ImportExternalTestAssignmentResultsParams = input<
-	typeof PowerPathImportExternalTestAssignmentResultsParams
->
-type MakeExternalStudentTestOutAssignmentInput = input<
-	typeof PowerPathMakeExternalStudentTestOutAssignmentInput
->
-type PlacementQueryParams = input<typeof PowerPathPlacementQueryParams>
-type RenderConfigUpsertInput = input<typeof PowerPathRenderConfigUpsertInput>
-type SyllabusQueryParams = input<typeof PowerPathSyllabusQueryParams>
-
-export type { AssignmentResult, Attempt, BulkResult, CourseProgressResponse, CreateAttemptResponse, CreateExternalPlacementTestInput, CreateExternalTestOutInput, CreateInternalTestInput, CreateNewAttemptInput, ExternalTestCapableLessonType, ExternalTestCreateResponse, FinalStudentAssessmentResponseInput, FinalizeAssessmentResponse, GetAllPlacementTestsResponse, GetAssessmentProgressParams, GetAssessmentProgressResponse, GetAttemptsParams, GetAttemptsResponse, GetCurrentLevelResponse, GetNextPlacementTestResponse, GetNextQuestionParams, GetNextQuestionResponse, GetSubjectProgressResponse, GetTestOutEligibilityResponse, ImportExternalResultsResponse, ImportExternalTestAssignmentResultsParams, InternalTestCreateResponse, LessonPlanCourseSyncResult, LessonPlanCreateResponse, LessonPlanOperation, LessonPlanOperationInput, LessonPlanOperationResult, LessonPlanOperationType, LessonPlanOperationsInput, LessonPlanOperationsResponse, LessonPlanResponse, LessonPlanSyncResult, LessonPlanUpdateStudentItemResponseInput, LessonPlansCreateInput, MakeExternalStudentTestOutAssignmentInput, MakeExternalStudentTestOutAssignmentResponse, MakeExternalTestAssignmentInput, MakeExternalTestAssignmentResponse, PaginationMeta, PlacementQueryParams, PlacementResetUserPlacementInput, PowerPath100ProgressResponse, PowerPath100UpdateResponseResult, PowerPathLessonType, PowerPathQuestionContent, PowerPathQuestionDifficulty, PowerPathQuestionResult, PowerPathTestQuestion, QuizLikeLessonType, RenderConfigDeleteResponse, RenderConfigGetResponse, RenderConfigUpsertInput, RenderConfigUpsertResponse, ResetAttemptInput, ResetAttemptResponse, ResetPlacementResponse, ResponseResult, ResponseResultFeedback, ScoreStatus, ScreeningAssignTestInput, ScreeningAssignTestResponse, ScreeningResetSessionInput, ScreeningResetSessionResponse, ScreeningResultsResponse, ScreeningSessionResponse, StandardProgressResponse, StandardUpdateResponseResult, SyllabusQueryParams, SyllabusResponse, TestAssignment, TestAssignmentStatus, TestAssignmentsAdminParams, TestAssignmentsBulkInput, TestAssignmentsCreateInput, TestAssignmentsImportInput, TestAssignmentsListParams, TestAssignmentsListResponse, TestAssignmentsUpdateInput, TestOutParams, TestOutResponse, UpdateStudentItemResponseResult, UpdateStudentQuestionResponseInput, UpdateStudentQuestionResponseResult };
+export * from '@timeback/types/protocols/powerpath';
+export { CreateExternalPlacementTestInput, CreateExternalTestOutInput, CreateInternalTestInput, CreateNewAttemptInput, FinalStudentAssessmentResponseInput, GetAssessmentProgressParams, GetAttemptsParams, GetNextQuestionParams, ImportExternalTestAssignmentResultsParams, LessonPlanOperationInput, LessonPlanOperationsInput, LessonPlanUpdateStudentItemResponseInput, LessonPlansCreateInput, MakeExternalStudentTestOutAssignmentInput, MakeExternalTestAssignmentInput, PlacementQueryParams, PlacementResetUserPlacementInput, RenderConfigUpsertInput, ResetAttemptInput, ScreeningAssignTestInput, ScreeningResetSessionInput, SyllabusQueryParams, TestAssignmentsAdminParams, TestAssignmentsBulkInput, TestAssignmentsCreateInput, TestAssignmentsImportInput, TestAssignmentsListParams, TestAssignmentsUpdateInput, TestOutParams, UpdateStudentQuestionResponseInput } from '@timeback/types/zod';