@lti-tool/core 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @lti-tool/core
 
+## 0.10.0
+
+### Minor Changes
+
+- 9cdc0c7: Add AGS implementation and refactor Hono integration to simple handler pattern
+
 ## 0.9.0
 
 ### Minor Changes

package/dist/ltiTool.d.ts

@@ -4,7 +4,9 @@ import type { LTIConfig } from './interfaces/ltiConfig.js';
 import type { LTIDeployment } from './interfaces/ltiDeployment.js';
 import type { LTISession } from './interfaces/ltiSession.js';
 import { type LTI13JwtPayload } from './schemas/index.js';
-import type { ScoreSubmission } from './schemas/lti13/ags/scoreSubmission.schema.js';
+import { type CreateLineItem, type LineItem, type LineItems, type UpdateLineItem } from './schemas/lti13/ags/lineItem.schema.js';
+import { type Results } from './schemas/lti13/ags/result.schema.js';
+import { type ScoreSubmission } from './schemas/lti13/ags/scoreSubmission.schema.js';
 /**
  * Main LTI 1.3 Tool implementation providing secure authentication, launch verification,
  * and LTI Advantage services integration.
@@ -105,10 +107,75 @@ export declare class LTITool {
      *
      * @param session - Active LTI session containing AGS service endpoints
      * @param score - Score submission data including grade value and user ID
-     * @returns Result of the score submission
      * @throws {Error} When AGS is not available or submission fails
      */
-    submitScore(session: LTISession, score: ScoreSubmission): Promise<Response>;
+    submitScore(session: LTISession, score: ScoreSubmission): Promise<void>;
+    /**
+     * Retrieves all scores for a specific line item from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @returns Array of score submissions for the line item
+     * @throws {Error} When AGS is not available or request fails
+     *
+     * @example
+     * ```typescript
+     * const scores = await ltiTool.getScores(session);
+     * console.log('All scores:', scores.map(s => `${s.userId}: ${s.scoreGiven}`));
+     * ```
+     */
+    getScores(session: LTISession): Promise<Results>;
+    /**
+     * Retrieves line items (gradebook columns) from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @returns Array of line items from the platform
+     * @throws {Error} When AGS is not available or request fails
+     */
+    listLineItems(session: LTISession): Promise<LineItems>;
+    /**
+     * Retrieves a specific line item (gradebook column) from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @returns Line item data from the platform
+     * @throws {Error} When AGS is not available or request fails
+     */
+    getLineItem(session: LTISession): Promise<LineItem>;
+    /**
+     * Creates a new line item (gradebook column) on the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @param createLineItem - Line item data including label, scoreMaximum, and optional metadata
+     * @returns Created line item with platform-generated ID and validated data
+     * @throws {Error} When AGS is not available, input validation fails, or creation fails
+     *
+     * @example
+     * ```typescript
+     * const newLineItem = await ltiTool.createLineItem(session, {
+     *   label: 'Quiz 1',
+     *   scoreMaximum: 100,
+     *   tag: 'quiz',
+     *   resourceId: 'quiz-001'
+     * });
+     * console.log('Created line item:', newLineItem.id);
+     * ```
+     */
+    createLineItem(session: LTISession, createLineItem: CreateLineItem): Promise<LineItem>;
+    /**
+     * Updates an existing line item (gradebook column) on the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @param updateLineItem - Updated line item data including all required fields
+     * @returns Updated line item with validated data from the platform
+     * @throws {Error} When AGS is not available, input validation fails, or update fails
+     */
+    updateLineItem(session: LTISession, updateLineItem: UpdateLineItem): Promise<LineItem>;
+    /**
+     * Deletes a line item (gradebook column) from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @throws {Error} When AGS is not available or deletion fails
+     */
+    deleteLineItem(session: LTISession): Promise<void>;
     /**
      * Retrieves all configured LTI client platforms.
      *

package/dist/ltiTool.d.ts.map

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

package/dist/ltiTool.js

@@ -1,6 +1,8 @@
-import { SignJWT, createRemoteJWKSet, decodeJwt, exportJWK, jwtVerify } from 'jose';
+import { createRemoteJWKSet, decodeJwt, exportJWK, jwtVerify, SignJWT } from 'jose';
 import { AddClientSchema, UpdateClientSchema } from './schemas/client.schema.js';
 import { HandleLoginParamsSchema, LTI13JwtPayloadSchema, SessionIdSchema, VerifyLaunchParamsSchema, } from './schemas/index.js';
+import { LineItemSchema, LineItemsSchema, } from './schemas/lti13/ags/lineItem.schema.js';
+import { ResultsSchema } from './schemas/lti13/ags/result.schema.js';
 import { AGSService } from './services/ags.service.js';
 import { createSession } from './services/session.service.js';
 import { TokenService } from './services/token.service.js';
@@ -195,7 +197,6 @@ export class LTITool {
      *
      * @param session - Active LTI session containing AGS service endpoints
      * @param score - Score submission data including grade value and user ID
-     * @returns Result of the score submission
      * @throws {Error} When AGS is not available or submission fails
      */
     async submitScore(session, score) {
@@ -205,7 +206,119 @@ export class LTITool {
         if (!score) {
             throw new Error('score is required');
         }
-        return await this.agsService.submitScore(session, score);
+        await this.agsService.submitScore(session, score);
+    }
+    /**
+     * Retrieves all scores for a specific line item from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @returns Array of score submissions for the line item
+     * @throws {Error} When AGS is not available or request fails
+     *
+     * @example
+     * ```typescript
+     * const scores = await ltiTool.getScores(session);
+     * console.log('All scores:', scores.map(s => `${s.userId}: ${s.scoreGiven}`));
+     * ```
+     */
+    async getScores(session) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        const response = await this.agsService.getScores(session);
+        const data = await response.json();
+        return ResultsSchema.parse(data);
+    }
+    /**
+     * Retrieves line items (gradebook columns) from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @returns Array of line items from the platform
+     * @throws {Error} When AGS is not available or request fails
+     */
+    async listLineItems(session) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        const response = await this.agsService.listLineItems(session);
+        const data = await response.json();
+        return LineItemsSchema.parse(data);
+    }
+    /**
+     * Retrieves a specific line item (gradebook column) from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @returns Line item data from the platform
+     * @throws {Error} When AGS is not available or request fails
+     */
+    async getLineItem(session) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        const response = await this.agsService.getLineItem(session);
+        const data = await response.json();
+        return LineItemSchema.parse(data);
+    }
+    /**
+     * Creates a new line item (gradebook column) on the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @param createLineItem - Line item data including label, scoreMaximum, and optional metadata
+     * @returns Created line item with platform-generated ID and validated data
+     * @throws {Error} When AGS is not available, input validation fails, or creation fails
+     *
+     * @example
+     * ```typescript
+     * const newLineItem = await ltiTool.createLineItem(session, {
+     *   label: 'Quiz 1',
+     *   scoreMaximum: 100,
+     *   tag: 'quiz',
+     *   resourceId: 'quiz-001'
+     * });
+     * console.log('Created line item:', newLineItem.id);
+     * ```
+     */
+    async createLineItem(session, createLineItem) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        if (!createLineItem) {
+            throw new Error('createLineItem is required');
+        }
+        const response = await this.agsService.createLineItem(session, createLineItem);
+        const data = await response.json();
+        return LineItemSchema.parse(data);
+    }
+    /**
+     * Updates an existing line item (gradebook column) on the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @param updateLineItem - Updated line item data including all required fields
+     * @returns Updated line item with validated data from the platform
+     * @throws {Error} When AGS is not available, input validation fails, or update fails
+     */
+    async updateLineItem(session, updateLineItem) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        if (!updateLineItem) {
+            throw new Error('lineItem is required');
+        }
+        const response = await this.agsService.updateLineItem(session, updateLineItem);
+        const data = await response.json();
+        return LineItemSchema.parse(data);
+    }
+    /**
+     * Deletes a line item (gradebook column) from the platform using Assignment and Grade Services (AGS).
+     *
+     * @param session - Active LTI session containing AGS service endpoints
+     * @throws {Error} When AGS is not available or deletion fails
+     */
+    async deleteLineItem(session) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        await this.agsService.deleteLineItem(session);
     }
     // Client management
     /**

package/dist/schemas/client.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const ClientSchema: z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;

package/dist/schemas/client.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/client.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;iBASvB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;iBAAqD,CAAC;AAClF,eAAO,MAAM,kBAAkB;;;;;;;iBAAqD,CAAC"}
+{"version":3,"file":"client.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/client.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;iBASvB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;iBAAqD,CAAC;AAClF,eAAO,MAAM,kBAAkB;;;;;;;iBAAqD,CAAC"}

package/dist/schemas/client.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 import { DeploymentSchema } from './deployment.schema';
 export const ClientSchema = z.object({
     id: z.uuid().describe('Internal stable UUID for the client'),

package/dist/schemas/common.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 /**
  * Common validation schemas used across the LTI tool
  */

package/dist/schemas/common.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/common.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH,eAAO,MAAM,eAAe,aAA6C,CAAC"}
+{"version":3,"file":"common.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/common.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;GAEG;AAEH,eAAO,MAAM,eAAe,aAA6C,CAAC"}

package/dist/schemas/common.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 /**
  * Common validation schemas used across the LTI tool
  */

package/dist/schemas/deployment.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const DeploymentSchema: z.ZodObject<{
     id: z.ZodUUID;
     deploymentId: z.ZodString;

package/dist/schemas/deployment.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/deployment.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;iBAS3B,CAAC"}
+{"version":3,"file":"deployment.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/deployment.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,gBAAgB;;;;;iBAS3B,CAAC"}

package/dist/schemas/deployment.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export const DeploymentSchema = z.object({
     id: z.uuid().describe('Internal stable UUID for this deployment configuration'),
     deploymentId: z.string().min(1).describe('LMS-provided deployment identifier'),

package/dist/schemas/lti13/ags/lineItem.schema.d.ts

@@ -0,0 +1,80 @@
+import * as z from 'zod';
+/**
+ * Schema for LTI Assignment and Grade Services (AGS) Line Item.
+ * Represents a gradebook column/assignment according to LTI AGS v2.0 specification.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#line-item-service
+ */
+export declare const LineItemSchema: z.ZodObject<{
+    id: z.ZodURL;
+    scoreMaximum: z.ZodNumber;
+    label: z.ZodString;
+    resourceId: z.ZodOptional<z.ZodString>;
+    resourceLinkId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    startDateTime: z.ZodOptional<z.ZodISODateTime>;
+    endDateTime: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new LTI Assignment and Grade Services (AGS) Line Item.
+ * Omits the 'id' field since it's generated by the platform upon creation.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#line-item-service
+ */
+export declare const CreateLineItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    scoreMaximum: z.ZodNumber;
+    resourceId: z.ZodOptional<z.ZodString>;
+    resourceLinkId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    startDateTime: z.ZodOptional<z.ZodISODateTime>;
+    endDateTime: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing LTI Assignment and Grade Services (AGS) Line Item.
+ * Omits 'id' and 'resourceLinkId' fields as they are immutable per LTI AGS specification.
+ * Tools MUST NOT change these values during updates.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#line-item-service
+ */
+export declare const UpdateLineItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    scoreMaximum: z.ZodNumber;
+    resourceId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    startDateTime: z.ZodOptional<z.ZodISODateTime>;
+    endDateTime: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+/**
+ * Schema for an array of line items returned from the line items service.
+ */
+export declare const LineItemsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodURL;
+    scoreMaximum: z.ZodNumber;
+    label: z.ZodString;
+    resourceId: z.ZodOptional<z.ZodString>;
+    resourceLinkId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    startDateTime: z.ZodOptional<z.ZodISODateTime>;
+    endDateTime: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>>;
+/**
+ * Type representing a validated line item for LTI AGS.
+ * Represents a gradebook column or assignment.
+ */
+export type LineItem = z.infer<typeof LineItemSchema>;
+/**
+ * Type representing an array of line items.
+ */
+export type LineItems = z.infer<typeof LineItemsSchema>;
+/**
+ * Type representing data required to create a new line item for LTI AGS.
+ * Contains all LineItem fields except the platform-generated 'id'.
+ */
+export type CreateLineItem = z.infer<typeof CreateLineItemSchema>;
+/**
+ * Type representing data for updating an existing line item for LTI AGS.
+ * Contains all LineItem fields except immutable 'id' and 'resourceLinkId'.
+ */
+export type UpdateLineItem = z.infer<typeof UpdateLineItemSchema>;
+//# sourceMappingURL=lineItem.schema.d.ts.map

package/dist/schemas/lti13/ags/lineItem.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineItem.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/ags/lineItem.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;iBAwBzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAE/B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBAG/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;kBAA0B,CAAC;AAIvD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schemas/lti13/ags/lineItem.schema.js

@@ -0,0 +1,49 @@
+import * as z from 'zod';
+/**
+ * Schema for LTI Assignment and Grade Services (AGS) Line Item.
+ * Represents a gradebook column/assignment according to LTI AGS v2.0 specification.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#line-item-service
+ */
+export const LineItemSchema = z.object({
+    /** Unique identifier for the line item */
+    id: z.url(),
+    /** Maximum score possible for this line item */
+    scoreMaximum: z.number().min(0),
+    /** Human-readable label for the line item */
+    label: z.string(),
+    /** Optional resource identifier that this line item is associated with */
+    resourceId: z.string().optional(),
+    /** Optional resource link identifier */
+    resourceLinkId: z.string().optional(),
+    /** Optional tag to identify the line item */
+    tag: z.string().optional(),
+    /** Optional start date/time for the assignment */
+    startDateTime: z.iso.datetime().optional(),
+    /** Optional end date/time for the assignment */
+    endDateTime: z.iso.datetime().optional(),
+});
+/**
+ * Schema for creating a new LTI Assignment and Grade Services (AGS) Line Item.
+ * Omits the 'id' field since it's generated by the platform upon creation.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#line-item-service
+ */
+export const CreateLineItemSchema = LineItemSchema.omit({
+    id: true,
+});
+/**
+ * Schema for updating an existing LTI Assignment and Grade Services (AGS) Line Item.
+ * Omits 'id' and 'resourceLinkId' fields as they are immutable per LTI AGS specification.
+ * Tools MUST NOT change these values during updates.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#line-item-service
+ */
+export const UpdateLineItemSchema = LineItemSchema.omit({
+    id: true,
+    resourceLinkId: true,
+});
+/**
+ * Schema for an array of line items returned from the line items service.
+ */
+export const LineItemsSchema = z.array(LineItemSchema);

package/dist/schemas/lti13/ags/result.schema.d.ts

@@ -0,0 +1,65 @@
+import * as z from 'zod';
+/**
+ * Schema for LTI Assignment and Grade Services (AGS) Result.
+ * Results contain richer metadata than scores, including user info and timestamps.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#result-service
+ */
+export declare const ResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    scoreOf: z.ZodURL;
+    userId: z.ZodString;
+    resultScore: z.ZodOptional<z.ZodNumber>;
+    resultMaximum: z.ZodOptional<z.ZodNumber>;
+    comment: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodISODateTime>;
+    activityProgress: z.ZodOptional<z.ZodEnum<{
+        Initialized: "Initialized";
+        Started: "Started";
+        InProgress: "InProgress";
+        Submitted: "Submitted";
+        Completed: "Completed";
+    }>>;
+    gradingProgress: z.ZodOptional<z.ZodEnum<{
+        FullyGraded: "FullyGraded";
+        Pending: "Pending";
+        PendingManual: "PendingManual";
+        Failed: "Failed";
+        NotReady: "NotReady";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for an array of results returned from the results service.
+ */
+export declare const ResultsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    scoreOf: z.ZodURL;
+    userId: z.ZodString;
+    resultScore: z.ZodOptional<z.ZodNumber>;
+    resultMaximum: z.ZodOptional<z.ZodNumber>;
+    comment: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodISODateTime>;
+    activityProgress: z.ZodOptional<z.ZodEnum<{
+        Initialized: "Initialized";
+        Started: "Started";
+        InProgress: "InProgress";
+        Submitted: "Submitted";
+        Completed: "Completed";
+    }>>;
+    gradingProgress: z.ZodOptional<z.ZodEnum<{
+        FullyGraded: "FullyGraded";
+        Pending: "Pending";
+        PendingManual: "PendingManual";
+        Failed: "Failed";
+        NotReady: "NotReady";
+    }>>;
+}, z.core.$strip>>;
+/**
+ * Type representing a validated result for LTI AGS.
+ */
+export type Result = z.infer<typeof ResultSchema>;
+/**
+ * Type representing an array of results.
+ */
+export type Results = z.infer<typeof ResultsSchema>;
+//# sourceMappingURL=result.schema.d.ts.map

package/dist/schemas/lti13/ags/result.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/ags/result.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;iBA+BvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;kBAAwB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/lti13/ags/result.schema.js

@@ -0,0 +1,35 @@
+import * as z from 'zod';
+/**
+ * Schema for LTI Assignment and Grade Services (AGS) Result.
+ * Results contain richer metadata than scores, including user info and timestamps.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#result-service
+ */
+export const ResultSchema = z.object({
+    /** Unique identifier for the result */
+    id: z.string(),
+    /** Score of the result, represented as a URL */
+    scoreOf: z.url(),
+    /** URL identifying the Line Item to which this result belongs. */
+    userId: z.string(),
+    /** The score given to the user */
+    resultScore: z.number().optional(),
+    /** Maximum possible score */
+    resultMaximum: z.number().optional(),
+    /** Comment associated with the result */
+    comment: z.string().optional(),
+    /** Timestamp when the result was recorded */
+    timestamp: z.iso.datetime({ offset: true }).optional(),
+    /** Activity progress status */
+    activityProgress: z
+        .enum(['Initialized', 'Started', 'InProgress', 'Submitted', 'Completed'])
+        .optional(),
+    /** Grading progress status */
+    gradingProgress: z
+        .enum(['FullyGraded', 'Pending', 'PendingManual', 'Failed', 'NotReady'])
+        .optional(),
+});
+/**
+ * Schema for an array of results returned from the results service.
+ */
+export const ResultsSchema = z.array(ResultSchema);

package/dist/schemas/lti13/ags/scoreSubmission.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 /**
  * Schema for submitting grades via LTI Assignment and Grade Services (AGS).
  * Validates score data according to LTI AGS v2.0 specification.
@@ -19,13 +19,34 @@ export declare const ScoreSubmissionSchema: z.ZodObject<{
         Completed: "Completed";
     }>>;
     gradingProgress: z.ZodDefault<z.ZodEnum<{
-        NotReady: "NotReady";
-        Failed: "Failed";
+        FullyGraded: "FullyGraded";
         Pending: "Pending";
         PendingManual: "PendingManual";
-        FullyGraded: "FullyGraded";
+        Failed: "Failed";
+        NotReady: "NotReady";
     }>>;
 }, z.core.$strip>;
+export declare const ScoreSubmissionsSchema: z.ZodArray<z.ZodObject<{
+    scoreGiven: z.ZodNumber;
+    scoreMaximum: z.ZodNumber;
+    comment: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodISODateTime>;
+    activityProgress: z.ZodDefault<z.ZodEnum<{
+        Initialized: "Initialized";
+        Started: "Started";
+        InProgress: "InProgress";
+        Submitted: "Submitted";
+        Completed: "Completed";
+    }>>;
+    gradingProgress: z.ZodDefault<z.ZodEnum<{
+        FullyGraded: "FullyGraded";
+        Pending: "Pending";
+        PendingManual: "PendingManual";
+        Failed: "Failed";
+        NotReady: "NotReady";
+    }>>;
+}, z.core.$strip>>;
 /**
  * Type representing a validated score submission for LTI AGS.
  * Contains grade data and metadata to be sent to the platform.

package/dist/schemas/lti13/ags/scoreSubmission.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoreSubmission.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/ags/scoreSubmission.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;iBAuChC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"scoreSubmission.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/ags/scoreSubmission.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;iBAuChC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;kBAAiC,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/lti13/ags/scoreSubmission.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 /**
  * Schema for submitting grades via LTI Assignment and Grade Services (AGS).
  * Validates score data according to LTI AGS v2.0 specification.
@@ -39,3 +39,4 @@ export const ScoreSubmissionSchema = z.object({
         .enum(['NotReady', 'Failed', 'Pending', 'PendingManual', 'FullyGraded'])
         .default('FullyGraded'),
 });
+export const ScoreSubmissionsSchema = z.array(ScoreSubmissionSchema);

package/dist/schemas/lti13/claims/baseJwtClaims.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const BaseJwtClaimsSchema: z.ZodObject<{
     iss: z.ZodString;
     sub: z.ZodString;

package/dist/schemas/lti13/claims/baseJwtClaims.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseJwtClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/baseJwtClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;iBAQ9B,CAAC"}
+{"version":3,"file":"baseJwtClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/baseJwtClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,mBAAmB;;;;;;;;iBAQ9B,CAAC"}

package/dist/schemas/lti13/claims/baseJwtClaims.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export const BaseJwtClaimsSchema = z.object({
     iss: z.string(),
     sub: z.string(),

package/dist/schemas/lti13/claims/contextClaims.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const ResourceLinkSchema: z.ZodOptional<z.ZodObject<{
     id: z.ZodString;
     title: z.ZodOptional<z.ZodString>;

package/dist/schemas/lti13/claims/contextClaims.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/contextClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;kBAKlB,CAAC;AAEd,eAAO,MAAM,aAAa;;;;kBAMb,CAAC"}
+{"version":3,"file":"contextClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/contextClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,kBAAkB;;;kBAKlB,CAAC;AAEd,eAAO,MAAM,aAAa;;;;kBAMb,CAAC"}