@lti-tool/core 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @lti-tool/core
 
+## 0.11.0
+
+### Minor Changes
+
+- 7c87338: Add NRPS implementation for retrieving course membership and user roles
+
+## 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,10 @@ 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';
+import { type Member } from './schemas/lti13/nrps/contextMembership.schema.js';
 /**
  * Main LTI 1.3 Tool implementation providing secure authentication, launch verification,
  * and LTI Advantage services integration.
@@ -35,6 +38,7 @@ export declare class LTITool {
     private logger;
     private tokenService;
     private agsService;
+    private nrpsService;
     /**
      * Creates a new LTI Tool instance.
      *
@@ -105,10 +109,91 @@ 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 course/context members using Names and Role Provisioning Services (NRPS).
+     *
+     * @param session - Active LTI session containing NRPS service endpoints
+     * @returns Array of members with clean camelCase properties
+     * @throws {Error} When NRPS is not available or request fails
+     *
+     * @example
+     * ```typescript
+     * const members = await ltiTool.getMembers(session);
+     * const instructors = members.filter(m =>
+     *   m.roles.some(role => role.includes('Instructor'))
+     * );
+     * ```
+     */
+    getMembers(session: LTISession): Promise<Member[]>;
     /**
      * 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":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAEL,KAAK,eAAe,EAIrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,SAAS,EAGd,KAAK,cAAc,EACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EACL,KAAK,MAAM,EAEZ,MAAM,kDAAkD,CAAC;AAO1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,OAAO;IAaN,OAAO,CAAC,MAAM;IAZ1B,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAA4D;IAC7E,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAc;IAEjC;;;;OAIG;gBACiB,MAAM,EAAE,SAAS;IAsBrC;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDnB;;;;;;;;;;;;;;OAcG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuD5E;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;;;;OAKG;IACG,aAAa,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAM1E;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAKpE;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtD;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAU5D;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUzD;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,CAClB,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAapB;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAapB;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD;;;;;;;;;;;;;;OAcG;IACG,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BxD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC;IAI9D;;;;;OAKG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,CAAC,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIrE;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/E;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIjE;;;;;;OAMG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAIrC;;;;;;OAMG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;OAMG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9E"}

package/dist/ltiTool.js

@@ -1,7 +1,11 @@
-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 { NRPSContextMembershipResponseSchema, } from './schemas/lti13/nrps/contextMembership.schema.js';
 import { AGSService } from './services/ags.service.js';
+import { NRPSService } from './services/nrps.service.js';
 import { createSession } from './services/session.service.js';
 import { TokenService } from './services/token.service.js';
 import { getValidLaunchConfig } from './utils/launchConfigValidation.js';
@@ -35,6 +39,7 @@ export class LTITool {
     logger;
     tokenService;
     agsService;
+    nrpsService;
     /**
      * Creates a new LTI Tool instance.
      *
@@ -52,6 +57,7 @@ export class LTITool {
                 };
         this.tokenService = new TokenService(this.config.keyPair, this.config.security?.keyId ?? 'main');
         this.agsService = new AGSService(this.tokenService, this.config.storage, this.logger);
+        this.nrpsService = new NRPSService(this.tokenService, this.config.storage, this.logger);
     }
     /**
      * Handles LTI 1.3 login initiation by generating state/nonce and redirecting to platform auth.
@@ -195,7 +201,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 +210,156 @@ 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);
+    }
+    /**
+     * Retrieves course/context members using Names and Role Provisioning Services (NRPS).
+     *
+     * @param session - Active LTI session containing NRPS service endpoints
+     * @returns Array of members with clean camelCase properties
+     * @throws {Error} When NRPS is not available or request fails
+     *
+     * @example
+     * ```typescript
+     * const members = await ltiTool.getMembers(session);
+     * const instructors = members.filter(m =>
+     *   m.roles.some(role => role.includes('Instructor'))
+     * );
+     * ```
+     */
+    async getMembers(session) {
+        if (!session) {
+            throw new Error('session is required');
+        }
+        const response = await this.nrpsService.getMembers(session);
+        const data = await response.json();
+        console.log(data);
+        const validated = NRPSContextMembershipResponseSchema.parse(data);
+        // Transform to clean camelCase format
+        return validated.members.map((member) => ({
+            status: member.status,
+            name: member.name,
+            picture: member.picture,
+            givenName: member.given_name,
+            familyName: member.family_name,
+            middleName: member.middle_name,
+            email: member.email,
+            userId: member.user_id,
+            lisPersonSourcedId: member.lis_person_sourcedid,
+            roles: member.roles,
+        }));
     }
     // 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);