@lti-tool/core 0.9.0 → 0.10.0

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

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

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

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const CoreLtiClaimsSchema: z.ZodObject<{
     'https://purl.imsglobal.org/spec/lti/claim/message_type': z.ZodUnion<readonly [z.ZodLiteral<"LtiResourceLinkRequest">, z.ZodLiteral<"LtiDeepLinkingRequest">]>;
     'https://purl.imsglobal.org/spec/lti/claim/version': z.ZodLiteral<"1.3.0">;

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

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

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

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export const CoreLtiClaimsSchema = z.object({
     'https://purl.imsglobal.org/spec/lti/claim/message_type': z.union([
         z.literal('LtiResourceLinkRequest'),

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"platformClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/platformClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;kBAUlB,CAAC;AAEd,eAAO,MAAM,wBAAwB;;;;kBAMxB,CAAC;AAEd,eAAO,MAAM,SAAS;;kBAIT,CAAC"}
+{"version":3,"file":"platformClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/platformClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,kBAAkB;;;;;;;;kBAUlB,CAAC;AAEd,eAAO,MAAM,wBAAwB;;;;kBAMxB,CAAC;AAEd,eAAO,MAAM,SAAS;;kBAIT,CAAC"}

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const AgsEndpointSchema: z.ZodOptional<z.ZodObject<{
     scope: z.ZodArray<z.ZodString>;
     lineitem: z.ZodOptional<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"serviceClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/serviceClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;kBAMjB,CAAC;AAEd,eAAO,MAAM,iBAAiB;;;kBAKjB,CAAC;AAEd,eAAO,MAAM,yBAAyB;;;;;;;;kBAUzB,CAAC"}
+{"version":3,"file":"serviceClaims.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/claims/serviceClaims.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,iBAAiB;;;;kBAMjB,CAAC;AAEd,eAAO,MAAM,iBAAiB;;;kBAKjB,CAAC;AAEd,eAAO,MAAM,yBAAyB;;;;;;;;kBAUzB,CAAC"}

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

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

package/dist/schemas/lti13/lti13JwtPayload.schema.d.ts

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

package/dist/schemas/lti13/lti13JwtPayload.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lti13JwtPayload.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/lti13/lti13JwtPayload.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgB9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"lti13JwtPayload.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/lti13/lti13JwtPayload.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAiBzB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgB9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/lti13/lti13JwtPayload.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 import { BaseJwtClaimsSchema } from './claims/baseJwtClaims.schema.js';
 import { ContextSchema, ResourceLinkSchema } from './claims/contextClaims.schema.js';
 import { CoreLtiClaimsSchema } from './claims/coreLtiClaims.schema.js';

package/dist/schemas/lti13/lti13Launch.schema.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export declare const LTI13LaunchSchema: z.ZodObject<{
     id_token: z.ZodJWT;
     state: z.ZodString;

package/dist/schemas/lti13/lti13Launch.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lti13Launch.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/lti13/lti13Launch.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC"}
+{"version":3,"file":"lti13Launch.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/lti13/lti13Launch.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC"}

package/dist/schemas/lti13/lti13Launch.schema.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod';
 export const LTI13LaunchSchema = z.object({
     id_token: z.jwt(),
     state: z.string(),

package/dist/schemas/lti13/lti13Login.schema.d.ts

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

package/dist/schemas/lti13/lti13Login.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lti13Login.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/lti13/lti13Login.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;iBAElC,CAAC"}
+{"version":3,"file":"lti13Login.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/lti13/lti13Login.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;iBAElC,CAAC"}

package/dist/schemas/lti13/lti13Login.schema.js

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

package/dist/services/ags.service.d.ts

@@ -1,6 +1,7 @@
 import type { BaseLogger } from 'pino';
 import type { LTISession } from '../interfaces/ltiSession.js';
 import type { LTIStorage } from '../interfaces/ltiStorage.js';
+import type { CreateLineItem, UpdateLineItem } from '../schemas/lti13/ags/lineItem.schema.js';
 import type { ScoreSubmission } from '../schemas/lti13/ags/scoreSubmission.schema.js';
 import type { TokenService } from './token.service.js';
 /**
@@ -34,5 +35,90 @@ export declare class AGSService {
      * ```
      */
     submitScore(session: LTISession, score: ScoreSubmission): Promise<Response>;
+    /**
+     * Retrieves all scores for a specific line item from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @returns Promise resolving to the HTTP response containing scores data for the line item
+     * @throws {Error} When AGS line item service is not available for the session or request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.getScores(session);
+     * const scores = await response.json();
+     * console.log('All scores for this line item:', scores);
+     * ```
+     */
+    getScores(session: LTISession): Promise<Response>;
+    /**
+     * Retrieves line items (gradebook columns) from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line items endpoint configuration
+     * @returns Promise resolving to the HTTP response containing line items data
+     * @throws {Error} When AGS line items service is not available for the session or request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.listLineItems(session);
+     * const lineItems = await response.json();
+     * console.log('Available gradebook columns:', lineItems);
+     * ```
+     */
+    listLineItems(session: LTISession): Promise<Response>;
+    /**
+     * Retrieves a specific line item (gradebook column) from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @returns Promise resolving to the HTTP response containing the line item data
+     * @throws {Error} When AGS line item service is not available for the session or request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.getLineItem(session);
+     * const lineItem = await response.json();
+     * console.log('Line item details:', lineItem);
+     * ```
+     */
+    getLineItem(session: LTISession): Promise<Response>;
+    /**
+     * Creates a new line item (gradebook column) on the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line items endpoint configuration
+     * @param createLineItem - Line item data including label, scoreMaximum, and optional metadata
+     * @returns Promise resolving to the HTTP response containing the created line item with generated ID
+     * @throws {Error} When AGS line item creation service is not available for the session or creation fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.createLineItem(session, {
+     *   label: 'Quiz 1',
+     *   scoreMaximum: 100,
+     *   tag: 'quiz',
+     *   resourceId: 'quiz-001'
+     * });
+     * const newLineItem = await response.json();
+     * console.log('Created line item:', newLineItem.id);
+     * ```
+     */
+    createLineItem(session: LTISession, createLineItem: CreateLineItem): Promise<Response>;
+    /**
+     * Updates an existing line item (gradebook column) on the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @param updateLineItem - Updated line item data including all required fields
+     * @returns Promise resolving to the HTTP response containing the updated line item
+     * @throws {Error} When AGS line item service is not available for the session or update fails
+     */
+    updateLineItem(session: LTISession, updateLineItem: UpdateLineItem): Promise<Response>;
+    /**
+     * Deletes a line item (gradebook column) from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @returns Promise resolving to the HTTP response (typically 204 No Content on success)
+     * @throws {Error} When AGS line item service is not available for the session or deletion fails
+     */
+    deleteLineItem(session: LTISession): Promise<Response>;
+    private getAGSToken;
+    private validateAGSResponse;
 }
 //# sourceMappingURL=ags.service.d.ts.map

package/dist/services/ags.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ags.service.d.ts","sourceRoot":"","sources":["../../src/services/ags.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBAFN,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU;IAG5B;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;CAkDlF"}
+{"version":3,"file":"ags.service.d.ts","sourceRoot":"","sources":["../../src/services/ags.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBAFN,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU;IAG5B;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiCjF;;;;;;;;;;;;;OAaG;IACG,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4BvD;;;;;;;;;;;;;OAaG;IACG,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsB3D;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBzD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,cAAc,CAClB,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAuBpB;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAuBpB;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;YAqB9C,WAAW;YAeX,mBAAmB;CAalC"}

package/dist/services/ags.service.js

@@ -37,11 +37,7 @@ export class AGSService {
         if (!session.services?.ags?.lineitem) {
             throw new Error('AGS not available for this session');
         }
-        // Get launch config to access token URL
-        const launchConfig = await getValidLaunchConfig(this.storage, session.platform.issuer, session.platform.clientId, session.platform.deploymentId);
-        const token = await this.tokenService.getBearerToken(session.platform.clientId, 
-        // Need to get token URL from platform storage
-        launchConfig.tokenUrl, 'https://purl.imsglobal.org/spec/lti-ags/scope/score');
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/score');
         const scorePayload = {
             userId: score.userId,
             scoreGiven: score.scoreGiven,
@@ -59,11 +55,191 @@ export class AGSService {
             },
             body: JSON.stringify(scorePayload),
         });
+        await this.validateAGSResponse(response, 'score submission');
+        return response;
+    }
+    /**
+     * Retrieves all scores for a specific line item from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @returns Promise resolving to the HTTP response containing scores data for the line item
+     * @throws {Error} When AGS line item service is not available for the session or request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.getScores(session);
+     * const scores = await response.json();
+     * console.log('All scores for this line item:', scores);
+     * ```
+     */
+    async getScores(session) {
+        if (!session.services?.ags?.lineitem) {
+            throw new Error('AGS line item not available for this session');
+        }
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly');
+        // cleanse the results URL
+        // we cannot include a search / query param
+        const lineItemUrl = new URL(session.services.ags.lineitem);
+        lineItemUrl.search = '';
+        const resultsUrl = `${lineItemUrl.toString()}/results`;
+        const response = await fetch(resultsUrl, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/vnd.ims.lis.v2.resultcontainer+json',
+            },
+        });
+        await this.validateAGSResponse(response, 'get scores');
+        return response;
+    }
+    /**
+     * Retrieves line items (gradebook columns) from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line items endpoint configuration
+     * @returns Promise resolving to the HTTP response containing line items data
+     * @throws {Error} When AGS line items service is not available for the session or request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.listLineItems(session);
+     * const lineItems = await response.json();
+     * console.log('Available gradebook columns:', lineItems);
+     * ```
+     */
+    async listLineItems(session) {
+        if (!session.services?.ags?.lineitems) {
+            throw new Error('AGS list line items not available for this session');
+        }
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly');
+        const response = await fetch(`${session.services.ags.lineitems}`, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/vnd.ims.lis.v2.lineitemcontainer+json',
+            },
+        });
+        await this.validateAGSResponse(response, 'list line items');
+        return response;
+    }
+    /**
+     * Retrieves a specific line item (gradebook column) from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @returns Promise resolving to the HTTP response containing the line item data
+     * @throws {Error} When AGS line item service is not available for the session or request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.getLineItem(session);
+     * const lineItem = await response.json();
+     * console.log('Line item details:', lineItem);
+     * ```
+     */
+    async getLineItem(session) {
+        if (!session.services?.ags?.lineitem) {
+            throw new Error('AGS line item not available for this session');
+        }
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly');
+        const response = await fetch(`${session.services.ags.lineitem}`, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/vnd.ims.lis.v2.lineitem+json',
+            },
+        });
+        await this.validateAGSResponse(response, 'get line item');
+        return response;
+    }
+    /**
+     * Creates a new line item (gradebook column) on the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line items endpoint configuration
+     * @param createLineItem - Line item data including label, scoreMaximum, and optional metadata
+     * @returns Promise resolving to the HTTP response containing the created line item with generated ID
+     * @throws {Error} When AGS line item creation service is not available for the session or creation fails
+     *
+     * @example
+     * ```typescript
+     * const response = await agsService.createLineItem(session, {
+     *   label: 'Quiz 1',
+     *   scoreMaximum: 100,
+     *   tag: 'quiz',
+     *   resourceId: 'quiz-001'
+     * });
+     * const newLineItem = await response.json();
+     * console.log('Created line item:', newLineItem.id);
+     * ```
+     */
+    async createLineItem(session, createLineItem) {
+        if (!session.services?.ags?.lineitems) {
+            throw new Error('AGS create line items not available for this session');
+        }
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/lineitem');
+        const response = await fetch(`${session.services.ags.lineitems}`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/vnd.ims.lis.v2.lineitem+json',
+            },
+            body: JSON.stringify(createLineItem),
+        });
+        await this.validateAGSResponse(response, 'create line item');
+        return response;
+    }
+    /**
+     * Updates an existing line item (gradebook column) on the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @param updateLineItem - Updated line item data including all required fields
+     * @returns Promise resolving to the HTTP response containing the updated line item
+     * @throws {Error} When AGS line item service is not available for the session or update fails
+     */
+    async updateLineItem(session, updateLineItem) {
+        if (!session.services?.ags?.lineitem) {
+            throw new Error('AGS line item not available for this session');
+        }
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/lineitem');
+        const response = await fetch(session.services.ags.lineitem, {
+            method: 'PUT',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/vnd.ims.lis.v2.lineitem+json',
+            },
+            body: JSON.stringify(updateLineItem),
+        });
+        await this.validateAGSResponse(response, 'update line item');
+        return response;
+    }
+    /**
+     * Deletes a line item (gradebook column) from the platform using Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS line item endpoint configuration
+     * @returns Promise resolving to the HTTP response (typically 204 No Content on success)
+     * @throws {Error} When AGS line item service is not available for the session or deletion fails
+     */
+    async deleteLineItem(session) {
+        if (!session.services?.ags?.lineitem) {
+            throw new Error('AGS line item not available for this session');
+        }
+        const token = await this.getAGSToken(session, 'https://purl.imsglobal.org/spec/lti-ags/scope/lineitem');
+        const response = await fetch(session.services.ags.lineitem, {
+            method: 'DELETE',
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        await this.validateAGSResponse(response, 'delete line item');
+        return response;
+    }
+    async getAGSToken(session, scope) {
+        const launchConfig = await getValidLaunchConfig(this.storage, session.platform.issuer, session.platform.clientId, session.platform.deploymentId);
+        return this.tokenService.getBearerToken(session.platform.clientId, launchConfig.tokenUrl, scope);
+    }
+    async validateAGSResponse(response, operation) {
         if (!response.ok) {
             const error = await response.json();
-            this.logger.error({ error, status: response.status, statusText: response.statusText }, 'AGS score submission failed');
-            throw new Error(`AGS score submission failed: ${response.statusText}`);
+            this.logger.error({ error, status: response.status, statusText: response.statusText }, `AGS ${operation} failed`);
+            throw new Error(`AGS ${operation} failed: ${response.statusText} ${error}`);
         }
-        return response;
     }
 }

package/dist/services/token.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.service.d.ts","sourceRoot":"","sources":["../../src/services/token.service.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,YAAY;IAQrB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;IARf;;;;;OAKG;gBAEO,OAAO,EAAE,aAAa,EACtB,KAAK,SAAS;IAGxB;;;;;;OAMG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBhF;;;;;;;OAOG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;CA0BnB"}
+{"version":3,"file":"token.service.d.ts","sourceRoot":"","sources":["../../src/services/token.service.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,YAAY;IAQrB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;IARf;;;;;OAKG;gBAEO,OAAO,EAAE,aAAa,EACtB,KAAK,SAAS;IAGxB;;;;;;OAMG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBhF;;;;;;;OAOG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;CA6BnB"}

package/dist/services/token.service.js

@@ -63,7 +63,8 @@ export class TokenService {
             }),
         });
         if (!response.ok) {
-            throw new Error(`Token request failed: ${response.status} ${response.statusText}`);
+            const errorDetail = await response.json();
+            throw new Error(`Token request failed: ${response.status} ${response.statusText} ${errorDetail}`);
         }
         const tokenData = await response.json();
         if (!tokenData.access_token) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lti-tool/core",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "LTI 1.3 implementation for Node.js",
   "keywords": [
     "lti",