@timeback/qti 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -642,7 +642,26 @@ declare const QtiPaginationParams = z
 // ASSESSMENT ITEMS (REQUEST INPUTS)
 // ═══════════════════════════════════════════════════════════════════════════════
 
-declare const QtiAssessmentItemCreateInput = z
+/**
+ * XML-format creation input.
+ *
+ * The preferred way to create assessment items — send raw QTI 3.0 XML and the
+ * server validates it against IMS QTI XSDs.
+ */
+declare const QtiAssessmentItemXmlCreateInput = z
+	.object({
+		format: z.string().pipe(z.literal('xml')),
+		xml: z.string().min(1),
+		metadata: QtiItemMetadata.optional(),
+	})
+	.strict()
+
+/**
+ * JSON-format creation input (experimental on the server side).
+ *
+ * Sends a structured/parsed representation of a QTI item.
+ */
+declare const QtiAssessmentItemJsonCreateInput = z
 	.object({
 		identifier: z.string().min(1),
 		title: z.string().min(1),
@@ -660,6 +679,17 @@ declare const QtiAssessmentItemCreateInput = z
 	})
 	.strict()
 
+/**
+ * Union of XML and JSON creation inputs for assessment items.
+ *
+ * Accepts either `{ format: 'xml', xml, metadata? }` or the structured JSON
+ * shape with `{ identifier, title, type, ... }`.
+ */
+declare const QtiAssessmentItemCreateInput = z.union([
+	QtiAssessmentItemXmlCreateInput,
+	QtiAssessmentItemJsonCreateInput,
+])
+
 declare const QtiAssessmentItemUpdateInput = z
 	.object({
 		identifier: z.string().min(1).optional(),
@@ -713,9 +743,9 @@ declare const QtiAssessmentSection = z
 declare const QtiTestPart = z
 	.object({
 		identifier: z.string().min(1),
-		navigationMode: QtiNavigationMode,
-		submissionMode: QtiSubmissionMode,
-		'qti-assessment-section': z.union([QtiAssessmentSection, z.array(QtiAssessmentSection)]),
+		navigationMode: z.string().pipe(QtiNavigationMode),
+		submissionMode: z.string().pipe(QtiSubmissionMode),
+		'qti-assessment-section': z.array(QtiAssessmentSection),
 	})
 	.strict()
 
@@ -742,7 +772,7 @@ declare const QtiAssessmentTestCreateInput = z
 		maxAttempts: z.number().optional(),
 		toolsEnabled: z.record(z.string(), z.boolean()).optional(),
 		metadata: z.record(z.string(), z.unknown()).optional(),
-		'qti-test-part': QtiTestPart,
+		'qti-test-part': z.array(QtiTestPart),
 		'qti-outcome-declaration': z.array(QtiTestOutcomeDeclaration).optional(),
 	})
 	.strict()
@@ -758,7 +788,7 @@ declare const QtiAssessmentTestUpdateInput = z
 		maxAttempts: z.number().optional(),
 		toolsEnabled: z.record(z.string(), z.boolean()).optional(),
 		metadata: z.record(z.string(), z.unknown()).optional(),
-		'qti-test-part': QtiTestPart,
+		'qti-test-part': z.array(QtiTestPart),
 		'qti-outcome-declaration': z.array(QtiTestOutcomeDeclaration).optional(),
 	})
 	.strict()
@@ -847,6 +877,8 @@ type UpdateSectionRequest = input<typeof QtiAssessmentSection>
 type AddItemRequest = input<typeof QtiAssessmentItemRef>
 type ReorderItemsRequest = input<typeof QtiReorderItemsInput>
 
+type CreateAssessmentItemXmlRequest = input<typeof QtiAssessmentItemXmlCreateInput>
+type CreateAssessmentItemJsonRequest = input<typeof QtiAssessmentItemJsonCreateInput>
 type CreateAssessmentItemRequest = input<typeof QtiAssessmentItemCreateInput>
 type UpdateAssessmentItemRequest = input<typeof QtiAssessmentItemUpdateInput>
 type ProcessResponseRequest = input<typeof QtiAssessmentItemProcessResponseInput>
@@ -933,6 +965,25 @@ declare class AssessmentItemsResource {
      * @returns Score and feedback
      */
     processResponse(identifier: string, body: Omit<ProcessResponseRequest, 'identifier'>): Promise<ProcessResponseResult>;
+    /**
+     * Create an assessment item from raw QTI 3.0 XML.
+     *
+     * This is the preferred creation method — the server validates the XML
+     * against IMS QTI XSDs. Optionally include metadata (subject, grade, etc.).
+     *
+     * @param body - XML string and optional metadata
+     * @returns The created assessment item
+     *
+     * @example
+     * ```typescript
+     * const item = await client.assessmentItems.createFromXml({
+     *   format: 'xml',
+     *   xml: '<qti-assessment-item ...>...</qti-assessment-item>',
+     *   metadata: { subject: 'Math', difficulty: 'easy' },
+     * })
+     * ```
+     */
+    createFromXml(body: CreateAssessmentItemXmlRequest): Promise<AssessmentItem>;
     /**
      * Create an assessment item from metadata.
      *
@@ -941,7 +992,7 @@ declare class AssessmentItemsResource {
      * @param body - Assessment item metadata
      * @returns The created assessment item
      */
-    createFromMetadata(body: CreateAssessmentItemRequest): Promise<AssessmentItem>;
+    createFromMetadata(body: CreateAssessmentItemJsonRequest): Promise<AssessmentItem>;
 }
 
 /**

package/dist/index.js

@@ -16667,7 +16667,7 @@ var QtiItemMetadata = exports_external.object({
   grade: TimebackGrade.optional(),
   difficulty: QtiDifficulty.optional(),
   learningObjectiveSet: exports_external.array(QtiLearningObjectiveSet).optional()
-}).strict();
+}).loose();
 var QtiModalFeedback = exports_external.object({
   outcomeIdentifier: exports_external.string().min(1),
   identifier: exports_external.string().min(1),
@@ -16704,7 +16704,12 @@ var QtiPaginationParams = exports_external.object({
   sort: exports_external.string().optional(),
   order: exports_external.enum(["asc", "desc"]).optional()
 }).strict();
-var QtiAssessmentItemCreateInput = exports_external.object({
+var QtiAssessmentItemXmlCreateInput = exports_external.object({
+  format: exports_external.string().pipe(exports_external.literal("xml")),
+  xml: exports_external.string().min(1),
+  metadata: QtiItemMetadata.optional()
+}).strict();
+var QtiAssessmentItemJsonCreateInput = exports_external.object({
   identifier: exports_external.string().min(1),
   title: exports_external.string().min(1),
   type: QtiAssessmentItemType,
@@ -16719,6 +16724,10 @@ var QtiAssessmentItemCreateInput = exports_external.object({
   feedbackInline: exports_external.array(QtiFeedbackInline).optional(),
   feedbackBlock: exports_external.array(QtiFeedbackBlock).optional()
 }).strict();
+var QtiAssessmentItemCreateInput = exports_external.union([
+  QtiAssessmentItemXmlCreateInput,
+  QtiAssessmentItemJsonCreateInput
+]);
 var QtiAssessmentItemUpdateInput = exports_external.object({
   identifier: exports_external.string().min(1).optional(),
   title: exports_external.string().min(1),
@@ -16755,9 +16764,9 @@ var QtiAssessmentSection = exports_external.object({
 }).strict();
 var QtiTestPart = exports_external.object({
   identifier: exports_external.string().min(1),
-  navigationMode: QtiNavigationMode,
-  submissionMode: QtiSubmissionMode,
-  "qti-assessment-section": exports_external.union([QtiAssessmentSection, exports_external.array(QtiAssessmentSection)])
+  navigationMode: exports_external.string().pipe(QtiNavigationMode),
+  submissionMode: exports_external.string().pipe(QtiSubmissionMode),
+  "qti-assessment-section": exports_external.array(QtiAssessmentSection)
 }).strict();
 var QtiReorderItemsInput = exports_external.object({
   items: exports_external.array(QtiAssessmentItemRef).min(1)
@@ -16775,7 +16784,7 @@ var QtiAssessmentTestCreateInput = exports_external.object({
   maxAttempts: exports_external.number().optional(),
   toolsEnabled: exports_external.record(exports_external.string(), exports_external.boolean()).optional(),
   metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
-  "qti-test-part": QtiTestPart,
+  "qti-test-part": exports_external.array(QtiTestPart),
   "qti-outcome-declaration": exports_external.array(QtiTestOutcomeDeclaration).optional()
 }).strict();
 var QtiAssessmentTestUpdateInput = exports_external.object({
@@ -16788,7 +16797,7 @@ var QtiAssessmentTestUpdateInput = exports_external.object({
   maxAttempts: exports_external.number().optional(),
   toolsEnabled: exports_external.record(exports_external.string(), exports_external.boolean()).optional(),
   metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
-  "qti-test-part": QtiTestPart,
+  "qti-test-part": exports_external.array(QtiTestPart),
   "qti-outcome-declaration": exports_external.array(QtiTestOutcomeDeclaration).optional()
 }).strict();
 var QtiStimulusCreateInput = exports_external.object({
@@ -16921,8 +16930,15 @@ class AssessmentItemsResource {
       body: { identifier, ...body }
     });
   }
+  createFromXml(body) {
+    validateWithSchema(QtiAssessmentItemXmlCreateInput, body, "assessment item XML");
+    return this.transport.request("/assessment-items", {
+      method: "POST",
+      body
+    });
+  }
   createFromMetadata(body) {
-    validateWithSchema(QtiAssessmentItemCreateInput, body, "assessment item metadata");
+    validateWithSchema(QtiAssessmentItemJsonCreateInput, body, "assessment item metadata");
     return this.transport.request("/assessment-items/metadata", {
       method: "POST",
       body

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

@@ -5,7 +5,7 @@
  */
 import { Paginator } from '../lib';
 import type { ListParams } from '@timeback/internal-client-infra';
-import type { CreateAssessmentItemRequest, ListAssessmentItemsParams, ProcessResponseRequest, UpdateAssessmentItemRequest } from '@timeback/types/zod';
+import type { CreateAssessmentItemJsonRequest, CreateAssessmentItemRequest, CreateAssessmentItemXmlRequest, ListAssessmentItemsParams, ProcessResponseRequest, UpdateAssessmentItemRequest } from '@timeback/types/zod';
 import type { Transport } from '../lib/transport';
 import type { AssessmentItem, DeleteResponse, ListResponse, ProcessResponseResult } from '../types';
 /**
@@ -75,6 +75,25 @@ export declare class AssessmentItemsResource {
      * @returns Score and feedback
      */
     processResponse(identifier: string, body: Omit<ProcessResponseRequest, 'identifier'>): Promise<ProcessResponseResult>;
+    /**
+     * Create an assessment item from raw QTI 3.0 XML.
+     *
+     * This is the preferred creation method — the server validates the XML
+     * against IMS QTI XSDs. Optionally include metadata (subject, grade, etc.).
+     *
+     * @param body - XML string and optional metadata
+     * @returns The created assessment item
+     *
+     * @example
+     * ```typescript
+     * const item = await client.assessmentItems.createFromXml({
+     *   format: 'xml',
+     *   xml: '<qti-assessment-item ...>...</qti-assessment-item>',
+     *   metadata: { subject: 'Math', difficulty: 'easy' },
+     * })
+     * ```
+     */
+    createFromXml(body: CreateAssessmentItemXmlRequest): Promise<AssessmentItem>;
     /**
      * Create an assessment item from metadata.
      *
@@ -83,6 +102,6 @@ export declare class AssessmentItemsResource {
      * @param body - Assessment item metadata
      * @returns The created assessment item
      */
-    createFromMetadata(body: CreateAssessmentItemRequest): Promise<AssessmentItem>;
+    createFromMetadata(body: CreateAssessmentItemJsonRequest): Promise<AssessmentItem>;
 }
 //# sourceMappingURL=assessment-items.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assessment-items.d.ts","sourceRoot":"","sources":["../../src/resources/assessment-items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EACX,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEnG;;;;;GAKG;AACH,qBAAa,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,SAAS,EAAI;IAErD;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,yBAA8B,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAYlF;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,GAAE,UAAU,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,SAAS,CAAC,cAAc,CAAC,CAG5E;IAED;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAK/C;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAMjE;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAUrF;IAED;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQlD;IAED;;;;;;;;OAQG;IACH,eAAe,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,GAC9C,OAAO,CAAC,qBAAqB,CAAC,CAUhC;IAED;;;;;;;OAOG;IACH,kBAAkB,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAM7E;CACD"}
+{"version":3,"file":"assessment-items.d.ts","sourceRoot":"","sources":["../../src/resources/assessment-items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EACX,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEnG;;;;;GAKG;AACH,qBAAa,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,SAAS,EAAI;IAErD;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,yBAA8B,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAYlF;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,GAAE,UAAU,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,SAAS,CAAC,cAAc,CAAC,CAG5E;IAED;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAK/C;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAMjE;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAUrF;IAED;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQlD;IAED;;;;;;;;OAQG;IACH,eAAe,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,GAC9C,OAAO,CAAC,qBAAqB,CAAC,CAUhC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAM3E;IAED;;;;;;;OAOG;IACH,kBAAkB,CAAC,IAAI,EAAE,+BAA+B,GAAG,OAAO,CAAC,cAAc,CAAC,CAMjF;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/qti",
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"type": "module",
 	"exports": {
 		".": {