@timeback/qti 0.1.0

package/dist/types/api.d.ts

@@ -0,0 +1,37 @@
+/**
+ * API Response Types
+ *
+ * Types for QTI API responses.
+ */
+/**
+ * Paginated list response from QTI API.
+ *
+ * QTI returns pagination metadata directly in the response body alongside items.
+ */
+export interface ListResponse<T> {
+    /** Array of items in this page */
+    items: T[];
+    /** Total items across all pages */
+    total: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Total number of pages */
+    pages: number;
+    /** Items per page */
+    limit: number;
+    /** Sort field */
+    sort: string;
+    /** Sort order */
+    order: 'asc' | 'desc';
+}
+/**
+ * Raw paginated response shape from QTI API (alias for internal use).
+ */
+export type RawPaginatedResponse<T> = ListResponse<T>;
+/**
+ * Response from DELETE operations.
+ */
+export interface DeleteResponse {
+    message: string;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,kCAAkC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAA;AAMrD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAA;CACf"}

package/dist/types/assessment-items.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Assessment Items Types
+ *
+ * Types for QTI assessment item resources.
+ */
+import type { AssessmentItemType, FeedbackBlock, FeedbackInline, ItemMetadata, ModalFeedback, OutcomeDeclaration, PaginationParams, ResponseDeclaration, ResponseProcessing } from './base';
+/**
+ * Assessment item entity.
+ */
+export interface AssessmentItem {
+    identifier: string;
+    title: string;
+    type: AssessmentItemType;
+    qtiVersion: string;
+    timeDependent: boolean;
+    adaptive: boolean;
+    responseDeclarations?: ResponseDeclaration[];
+    outcomeDeclarations?: OutcomeDeclaration[];
+    responseProcessing?: ResponseProcessing;
+    metadata?: ItemMetadata;
+    /** Raw QTI XML string */
+    rawXml: string;
+    /**
+     * Parsed XML→JSON content.
+     * Structure varies by item type.
+     */
+    content: Record<string, unknown>;
+    modalFeedback?: ModalFeedback[];
+    feedbackInline?: FeedbackInline[];
+    feedbackBlock?: FeedbackBlock[];
+    createdAt: string;
+    updatedAt: string;
+    __v?: number;
+}
+/**
+ * Parameters for listing assessment items.
+ */
+export interface ListAssessmentItemsParams extends PaginationParams {
+}
+/**
+ * Request body for creating an assessment item.
+ */
+export interface CreateAssessmentItemRequest {
+    identifier: string;
+    title: string;
+    type: AssessmentItemType;
+    qtiVersion?: string;
+    timeDependent?: boolean;
+    adaptive?: boolean;
+    responseDeclarations?: ResponseDeclaration[];
+    outcomeDeclarations?: OutcomeDeclaration[];
+    responseProcessing?: ResponseProcessing;
+    metadata?: ItemMetadata;
+    modalFeedback?: ModalFeedback[];
+    feedbackInline?: FeedbackInline[];
+    feedbackBlock?: FeedbackBlock[];
+}
+/**
+ * Request body for updating an assessment item.
+ */
+export interface UpdateAssessmentItemRequest extends CreateAssessmentItemRequest {
+    rawXml: string;
+    content: Record<string, unknown>;
+}
+/**
+ * Request body for processing a response.
+ */
+export interface ProcessResponseRequest {
+    identifier: string;
+    response: string | string[];
+}
+/**
+ * Result of processing a response.
+ */
+export interface ProcessResponseResult {
+    score: number;
+    feedback: {
+        identifier: string;
+        value: string;
+    };
+}
+//# sourceMappingURL=assessment-items.d.ts.map

package/dist/types/assessment-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-items.d.ts","sourceRoot":"","sources":["../../src/types/assessment-items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,QAAQ,CAAA;AAMf;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,kBAAkB,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,OAAO,CAAA;IACtB,QAAQ,EAAE,OAAO,CAAA;IACjB,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC5C,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC1C,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,cAAc,CAAC,EAAE,cAAc,EAAE,CAAA;IACjC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAMD;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;CAElE;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,kBAAkB,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC5C,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC1C,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,cAAc,CAAC,EAAE,cAAc,EAAE,CAAA;IACjC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE;QACT,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,MAAM,CAAA;KACb,CAAA;CACD"}

package/dist/types/assessment-tests.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Assessment Tests Types
+ *
+ * Types for QTI assessment test resources including test parts and sections.
+ */
+import type { NavigationMode, PaginationParams, SubmissionMode, TestOutcomeDeclaration } from './base';
+/**
+ * Reference to an assessment item within a section.
+ */
+export interface AssessmentItemRef {
+    identifier: string;
+    /**
+     * Item reference href.
+     *
+     * The QTI docs show this field as `string` in most responses, but it can also
+     * appear as an array (and in one place, a nested array) in request/response
+     * examples for test-part payloads.
+     */
+    href?: string | string[] | string[][];
+    sequence?: number;
+}
+/**
+ * Assessment section within a test part.
+ */
+export interface AssessmentSection {
+    identifier: string;
+    title: string;
+    visible: boolean;
+    required?: boolean;
+    fixed?: boolean;
+    sequence?: number;
+    'qti-assessment-item-ref'?: AssessmentItemRef[];
+}
+/**
+ * Test part within an assessment test.
+ */
+export interface TestPart {
+    identifier: string;
+    navigationMode: NavigationMode;
+    submissionMode: SubmissionMode;
+    'qti-assessment-section': AssessmentSection | AssessmentSection[];
+}
+/**
+ * Assessment test entity.
+ */
+export interface AssessmentTest {
+    identifier: string;
+    title: string;
+    qtiVersion: string;
+    'qti-test-part': TestPart[];
+    'qti-outcome-declaration': TestOutcomeDeclaration[];
+    timeLimit?: number;
+    maxAttempts?: number;
+    toolsEnabled?: Record<string, boolean>;
+    metadata?: Record<string, unknown>;
+    /** Raw QTI XML string */
+    rawXml: string;
+    /**
+     * Parsed XML→JSON content.
+     * Structure varies by test.
+     */
+    content: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    __v?: number;
+    isValidXml?: boolean;
+}
+/**
+ * Parameters for listing assessment tests.
+ */
+export interface ListAssessmentTestsParams extends PaginationParams {
+}
+/**
+ * Request body for creating an assessment test.
+ */
+export interface CreateAssessmentTestRequest {
+    identifier: string;
+    title: string;
+    qtiVersion?: string;
+    toolName?: string;
+    toolVersion?: string;
+    timeLimit?: number;
+    maxAttempts?: number;
+    toolsEnabled?: Record<string, boolean>;
+    metadata?: Record<string, unknown>;
+    'qti-test-part': TestPart;
+    'qti-outcome-declaration'?: TestOutcomeDeclaration[];
+}
+/**
+ * Request body for updating an assessment test.
+ */
+export interface UpdateAssessmentTestRequest extends CreateAssessmentTestRequest {
+}
+/**
+ * Request body for updating test metadata.
+ */
+export interface UpdateTestMetadataRequest {
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for listing test parts.
+ */
+export interface ListTestPartsParams extends PaginationParams {
+}
+/**
+ * Request body for creating a test part.
+ */
+export interface CreateTestPartRequest {
+    identifier: string;
+    navigationMode: NavigationMode;
+    submissionMode: SubmissionMode;
+    'qti-assessment-section': AssessmentSection;
+}
+/**
+ * Request body for updating a test part.
+ */
+export interface UpdateTestPartRequest extends CreateTestPartRequest {
+}
+/**
+ * Parameters for listing sections.
+ */
+export interface ListSectionsParams extends PaginationParams {
+}
+/**
+ * Request body for creating a section.
+ */
+export interface CreateSectionRequest {
+    identifier: string;
+    title: string;
+    visible: boolean;
+    required?: boolean;
+    fixed?: boolean;
+    sequence?: number;
+    'qti-assessment-item-ref'?: AssessmentItemRef[];
+}
+/**
+ * Request body for updating a section.
+ */
+export interface UpdateSectionRequest extends CreateSectionRequest {
+}
+/**
+ * Request body for adding an item to a section.
+ */
+export interface AddItemRequest {
+    identifier: string;
+    href?: string;
+    sequence?: number;
+}
+/**
+ * Request body for reordering items in a section.
+ */
+export interface ReorderItemsRequest {
+    items: AddItemRequest[];
+}
+/**
+ * Question reference within a test.
+ */
+export interface QuestionReference {
+    identifier: string;
+    href: string;
+    testPart: string;
+    section: string;
+}
+/**
+ * Question with full item details.
+ */
+export interface QuestionWithItem {
+    reference: QuestionReference;
+    question: import('./assessment-items').AssessmentItem;
+}
+/**
+ * Response from GET /assessment-tests/{identifier}/questions.
+ */
+export interface QuestionsResponse {
+    assessmentTest: string;
+    title: string;
+    totalQuestions: number;
+    questions: QuestionWithItem[];
+}
+//# sourceMappingURL=assessment-tests.d.ts.map

package/dist/types/assessment-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-tests.d.ts","sourceRoot":"","sources":["../../src/types/assessment-tests.ts"],"names":[],"mappings":"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"}

package/dist/types/base.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Base Types
+ *
+ * Common types shared across QTI resources.
+ */
+/**
+ * Assessment item interaction types.
+ */
+export type AssessmentItemType = 'choice' | 'text-entry' | 'extended-text' | 'inline-choice' | 'match' | 'order' | 'associate' | 'select-point' | 'graphic-order' | 'graphic-associate' | 'graphic-gap-match' | 'hotspot' | 'hottext' | 'slider' | 'drawing' | 'media' | 'upload';
+/**
+ * Cardinality of a response or outcome variable.
+ */
+export type Cardinality = 'single' | 'multiple' | 'ordered' | 'record';
+/**
+ * Base type of a response or outcome variable.
+ */
+export type BaseType = 'identifier' | 'boolean' | 'integer' | 'float' | 'string' | 'point' | 'pair' | 'directedPair' | 'duration' | 'file' | 'uri';
+/**
+ * Difficulty level for assessment items.
+ */
+export type Difficulty = 'easy' | 'medium' | 'hard';
+/**
+ * Grade level (K-12 + pre-K as -1).
+ */
+export type Grade = -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13;
+/**
+ * Navigation mode for test parts.
+ */
+export type NavigationMode = 'linear' | 'nonlinear';
+/**
+ * Submission mode for test parts.
+ */
+export type SubmissionMode = 'individual' | 'simultaneous';
+/**
+ * Show/hide indicator for feedback.
+ */
+export type ShowHide = 'show' | 'hide';
+/**
+ * Schema type for validation.
+ */
+export type ValidationSchema = 'test' | 'item' | 'stimulus';
+/**
+ * Sort order for list responses.
+ */
+export type SortOrder = 'asc' | 'desc';
+/**
+ * Feedback type.
+ */
+export type FeedbackType = 'QUESTION' | 'LESSON';
+/**
+ * Correct response value.
+ */
+export interface CorrectResponse {
+    value: string[];
+}
+/**
+ * Response declaration for assessment items.
+ */
+export interface ResponseDeclaration {
+    identifier: string;
+    cardinality: Cardinality;
+    baseType?: BaseType;
+    correctResponse: CorrectResponse;
+}
+/**
+ * Outcome declaration for items and tests.
+ */
+export interface OutcomeDeclaration {
+    identifier: string;
+    cardinality: Cardinality;
+    baseType?: BaseType;
+}
+/**
+ * Test outcome declaration with additional properties.
+ */
+export interface TestOutcomeDeclaration {
+    identifier: string;
+    cardinality?: Cardinality;
+    baseType: BaseType;
+    normalMaximum?: number;
+    normalMinimum?: number;
+    defaultValue?: {
+        value?: unknown;
+    };
+}
+/**
+ * Inline feedback configuration.
+ */
+export interface InlineFeedback {
+    outcomeIdentifier: string;
+    variableIdentifier: string;
+}
+/**
+ * Response processing configuration.
+ */
+export interface ResponseProcessing {
+    templateType: 'match_correct' | 'map_response';
+    responseDeclarationIdentifier: string;
+    outcomeIdentifier: string;
+    correctResponseIdentifier: string;
+    incorrectResponseIdentifier: string;
+    inlineFeedback?: InlineFeedback;
+}
+/**
+ * Learning objective set for metadata.
+ */
+export interface LearningObjectiveSet {
+    source: string;
+    learningObjectiveIds: string[];
+}
+/**
+ * Item metadata.
+ */
+export interface ItemMetadata {
+    subject?: string;
+    grade?: Grade;
+    difficulty?: Difficulty;
+    learningObjectiveSet?: LearningObjectiveSet[];
+}
+/**
+ * Modal feedback element.
+ */
+export interface ModalFeedback {
+    outcomeIdentifier: string;
+    identifier: string;
+    showHide: ShowHide;
+    content: string;
+    title: string;
+}
+/**
+ * Inline feedback element.
+ */
+export interface FeedbackInline {
+    outcomeIdentifier: string;
+    identifier: string;
+    showHide: ShowHide;
+    content: string;
+    class: string[];
+}
+/**
+ * Block feedback element.
+ */
+export interface FeedbackBlock {
+    outcomeIdentifier: string;
+    identifier: string;
+    showHide: ShowHide;
+    content: string;
+    class: string[];
+}
+/**
+ * Stylesheet reference.
+ */
+export interface Stylesheet {
+    href: string;
+    type: string;
+}
+/**
+ * Catalog info entry.
+ */
+export interface CatalogInfo {
+    id: string;
+    support: string;
+    content: string;
+}
+/**
+ * Standard QTI pagination parameters.
+ */
+export interface PaginationParams {
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Items per page */
+    limit?: number;
+    /** Field to sort by */
+    sort?: string;
+    /** Sort order */
+    order?: SortOrder;
+}
+/**
+ * Pagination metadata from QTI list responses.
+ */
+export interface PaginationMeta {
+    /** Total items across all pages */
+    total: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Total number of pages */
+    pages: number;
+    /** Items per page */
+    limit: number;
+    /** Sort field */
+    sort: string;
+    /** Sort order */
+    order: SortOrder;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":"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"}

package/dist/types/client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Client Configuration Types
+ */
+import type { ClientConfig, PaginatedResponse, ProviderClientConfig, RequestOptions, ResolvedProvider, TransportOnlyConfig } from '@timeback/internal-client-infra';
+/**
+ * Re-export vital config types for SDK users.
+ */
+export type { Environment, EnvAuth, ExplicitAuth, Platform } from '@timeback/internal-client-infra';
+/**
+ * Transport interface for QTI client.
+ *
+ * Required when using transport mode with QtiClient.
+ */
+export interface QtiTransportLike {
+    /** Base URL of the API */
+    baseUrl: string;
+    /** Make an authenticated request */
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+    /** Make a paginated request */
+    requestPaginated<T>(path: string, options?: RequestOptions): Promise<PaginatedResponse<T>>;
+}
+/**
+ * All supported QTI client configuration types.
+ *
+ * Supports four modes:
+ * - **Provider mode**: `{ provider: TimebackProvider }` — pre-built provider with token sharing
+ * - **Environment mode**: `{ platform?, env, auth }` — Timeback hosted APIs
+ * - **Explicit mode**: `{ baseUrl, auth: { authUrl } }` — custom API URLs
+ * - **Transport mode**: `{ transport }` — custom transport
+ *
+ * The `platform` field (in env mode) selects which Timeback implementation to use:
+ * - `'BEYOND_AI'` (default): BeyondAI's Timeback platform
+ * - `'LEARNWITH_AI'`: Samy's LearnWith.AI platform
+ */
+export type QtiClientConfig = ClientConfig | TransportOnlyConfig<QtiTransportLike> | ProviderClientConfig;
+/**
+ * Resolved provider type for QTI client.
+ */
+export type QtiResolvedProvider = ResolvedProvider<QtiTransportLike>;
+/**
+ * Instance type of QtiClient.
+ */
+export type QtiClientInstance = InstanceType<typeof import('../client').QtiClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,MAAM,iCAAiC,CAAA;AAExC;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAEnG;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,+BAA+B;IAC/B,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;CAC1F;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GACxB,YAAY,GACZ,mBAAmB,CAAC,gBAAgB,CAAC,GACrC,oBAAoB,CAAA;AAEvB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;AAEpE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,cAAc,WAAW,EAAE,SAAS,CAAC,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * QTI Types
+ *
+ * All entity and domain types for `@timeback/qti`.
+ */
+export * from './api';
+export * from './assessment-items';
+export * from './assessment-tests';
+export * from './base';
+export * from './client';
+export * from './lesson';
+export * from './stimuli';
+export * from './validate';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,OAAO,CAAA;AACrB,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/dist/types/lesson.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Lesson Types
+ *
+ * Types for QTI lesson and question feedback resources.
+ */
+import type { FeedbackType } from './base';
+/**
+ * Lesson feedback entity.
+ */
+export interface LessonFeedback {
+    questionId?: string;
+    userId: string;
+    feedback: string;
+    type: FeedbackType;
+    lessonId: string;
+    humanApproved?: boolean | boolean[];
+}
+/**
+ * Request body for submitting lesson feedback.
+ */
+export interface SubmitLessonRequest {
+    questionId?: string;
+    userId: string;
+    feedback: string;
+    lessonId: string;
+    humanApproved?: boolean;
+}
+/**
+ * Request body for submitting question feedback.
+ */
+export interface SubmitQuestionRequest {
+    questionId?: string;
+    userId: string;
+    feedback: string;
+    lessonId: string;
+    humanApproved?: boolean;
+}
+//# sourceMappingURL=lesson.d.ts.map

package/dist/types/lesson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lesson.d.ts","sourceRoot":"","sources":["../../src/types/lesson.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAM1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAA;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB"}

package/dist/types/stimuli.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Stimuli Types
+ *
+ * Types for QTI stimulus resources.
+ */
+import type { CatalogInfo, PaginationParams, Stylesheet } from './base';
+/**
+ * Stimulus entity.
+ */
+export interface Stimulus {
+    identifier: string;
+    title: string;
+    label?: string;
+    language?: string;
+    stylesheet?: Stylesheet;
+    catalogInfo: CatalogInfo[];
+    toolName?: string;
+    toolVersion?: string;
+    metadata?: Record<string, unknown>;
+    /** Raw QTI XML string */
+    rawXml: string;
+    /**
+     * Parsed XML→JSON content.
+     * Structure varies.
+     */
+    content: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    __v?: number;
+}
+/**
+ * Parameters for listing stimuli.
+ */
+export interface ListStimuliParams extends PaginationParams {
+}
+/**
+ * Request body for creating a stimulus.
+ */
+export interface CreateStimulusRequest {
+    identifier: string;
+    title: string;
+    label?: string;
+    language?: string;
+    stylesheet?: Stylesheet;
+    content: string;
+    catalogInfo?: CatalogInfo[];
+    toolName?: string;
+    toolVersion?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Request body for updating a stimulus.
+ */
+export interface UpdateStimulusRequest extends CreateStimulusRequest {
+}
+//# sourceMappingURL=stimuli.d.ts.map