@lti-tool/core 0.9.0

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

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Schema for submitting grades via LTI Assignment and Grade Services (AGS).
+ * Validates score data according to LTI AGS v2.0 specification.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0/#score-publish-service
+ */
+export const ScoreSubmissionSchema = z.object({
+    /** Points awarded to the student (must be non-negative) */
+    scoreGiven: z.number().min(0),
+    /** Maximum possible points for this assignment (must be non-negative) */
+    scoreMaximum: z.number().min(0),
+    /** Optional feedback comment to display to the student */
+    comment: z.string().optional(),
+    /** User ID to submit score for (optional - defaults to session user if not provided) */
+    userId: z.string().optional(),
+    /** Timestamp when score was generated (optional - defaults to current time) */
+    timestamp: z.iso.datetime().optional(),
+    /**
+     * Student's progress on the activity itself.
+     * - Initialized: Student has started but not made progress
+     * - Started: Student has begun working
+     * - InProgress: Student is actively working
+     * - Submitted: Student has submitted work for review
+     * - Completed: Student has finished the activity
+     */
+    activityProgress: z
+        .enum(['Initialized', 'Started', 'InProgress', 'Submitted', 'Completed'])
+        .default('Completed'),
+    /**
+     * Instructor's progress on grading the submission.
+     * - NotReady: Submission not ready for grading
+     * - Failed: Grading failed due to error
+     * - Pending: Awaiting automatic grading
+     * - PendingManual: Awaiting manual grading
+     * - FullyGraded: Grading is complete
+     */
+    gradingProgress: z
+        .enum(['NotReady', 'Failed', 'Pending', 'PendingManual', 'FullyGraded'])
+        .default('FullyGraded'),
+});

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

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const BaseJwtClaimsSchema: z.ZodObject<{
+    iss: z.ZodString;
+    sub: z.ZodString;
+    aud: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    exp: z.ZodNumber;
+    iat: z.ZodNumber;
+    nbf: z.ZodOptional<z.ZodNumber>;
+    nonce: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=baseJwtClaims.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export const BaseJwtClaimsSchema = z.object({
+    iss: z.string(),
+    sub: z.string(),
+    aud: z.union([z.string(), z.array(z.string())]),
+    exp: z.number(),
+    iat: z.number(),
+    nbf: z.number().optional(),
+    nonce: z.string(),
+});

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

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const ResourceLinkSchema: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const ContextSchema: z.ZodOptional<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=contextClaims.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const ResourceLinkSchema = z
+    .object({
+    id: z.string(),
+    title: z.string().optional(),
+})
+    .optional();
+export const ContextSchema = z
+    .object({
+    id: z.string(),
+    label: z.string().optional(),
+    title: z.string().optional(),
+})
+    .optional();

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

@@ -0,0 +1,9 @@
+import { 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">;
+    'https://purl.imsglobal.org/spec/lti/claim/deployment_id': z.ZodString;
+    'https://purl.imsglobal.org/spec/lti/claim/target_link_uri': z.ZodString;
+    'https://purl.imsglobal.org/spec/lti/claim/roles': z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+//# sourceMappingURL=coreLtiClaims.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export const CoreLtiClaimsSchema = z.object({
+    'https://purl.imsglobal.org/spec/lti/claim/message_type': z.union([
+        z.literal('LtiResourceLinkRequest'),
+        z.literal('LtiDeepLinkingRequest'),
+    ]),
+    'https://purl.imsglobal.org/spec/lti/claim/version': z.literal('1.3.0'),
+    'https://purl.imsglobal.org/spec/lti/claim/deployment_id': z.string(),
+    'https://purl.imsglobal.org/spec/lti/claim/target_link_uri': z.string(),
+    'https://purl.imsglobal.org/spec/lti/claim/roles': z.array(z.string()).optional(),
+});

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

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const ToolPlatformSchema: z.ZodOptional<z.ZodObject<{
+    guid: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    product_family_code: z.ZodOptional<z.ZodString>;
+    contact_email: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const LaunchPresentationSchema: z.ZodOptional<z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const LisSchema: z.ZodOptional<z.ZodObject<{
+    person_sourcedid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=platformClaims.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const ToolPlatformSchema = z
+    .object({
+    guid: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    url: z.string().optional(),
+    product_family_code: z.string().optional(),
+    contact_email: z.string().optional(),
+    version: z.string().optional(),
+})
+    .optional();
+export const LaunchPresentationSchema = z
+    .object({
+    target: z.string().optional(),
+    url: z.string().optional(),
+    locale: z.string().optional(),
+})
+    .optional();
+export const LisSchema = z
+    .object({
+    person_sourcedid: z.string().optional(),
+})
+    .optional();

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

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const PrivacyClaimsSchema: z.ZodObject<{
+    given_name: z.ZodString;
+    family_name: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=privacyClaims.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const PrivacyClaimsSchema = z.object({
+    given_name: z.string(),
+    family_name: z.string(),
+    name: z.string(),
+    email: z.string(),
+});

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

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const AgsEndpointSchema: z.ZodOptional<z.ZodObject<{
+    scope: z.ZodArray<z.ZodString>;
+    lineitem: z.ZodOptional<z.ZodString>;
+    lineitems: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const NrpsServiceSchema: z.ZodOptional<z.ZodObject<{
+    context_memberships_url: z.ZodString;
+    service_versions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export declare const DeepLinkingSettingsSchema: z.ZodOptional<z.ZodObject<{
+    deep_link_return_url: z.ZodString;
+    accept_types: z.ZodArray<z.ZodString>;
+    accept_presentation_document_targets: z.ZodArray<z.ZodString>;
+    accept_media_types: z.ZodOptional<z.ZodString>;
+    accept_multiple: z.ZodOptional<z.ZodBoolean>;
+    auto_create: z.ZodOptional<z.ZodBoolean>;
+    data: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=serviceClaims.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export const AgsEndpointSchema = z
+    .object({
+    scope: z.array(z.string()),
+    lineitem: z.string().optional(),
+    lineitems: z.string().optional(),
+})
+    .optional();
+export const NrpsServiceSchema = z
+    .object({
+    context_memberships_url: z.string(),
+    service_versions: z.array(z.string()).optional(),
+})
+    .optional();
+export const DeepLinkingSettingsSchema = z
+    .object({
+    deep_link_return_url: z.string(),
+    accept_types: z.array(z.string()),
+    accept_presentation_document_targets: z.array(z.string()),
+    accept_media_types: z.string().optional(),
+    accept_multiple: z.boolean().optional(),
+    auto_create: z.boolean().optional(),
+    data: z.string().optional(),
+})
+    .optional();

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

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export declare const LTI13JwtPayloadSchema: z.ZodObject<{
+    iss: z.ZodString;
+    sub: z.ZodString;
+    aud: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    exp: z.ZodNumber;
+    iat: z.ZodNumber;
+    nbf: z.ZodOptional<z.ZodNumber>;
+    nonce: z.ZodString;
+    given_name: z.ZodString;
+    family_name: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+    '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">;
+    'https://purl.imsglobal.org/spec/lti/claim/deployment_id': z.ZodString;
+    'https://purl.imsglobal.org/spec/lti/claim/target_link_uri': z.ZodString;
+    'https://purl.imsglobal.org/spec/lti/claim/roles': z.ZodOptional<z.ZodArray<z.ZodString>>;
+    'https://purl.imsglobal.org/spec/lti/claim/resource_link': z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti/claim/context': z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti/claim/tool_platform': z.ZodOptional<z.ZodObject<{
+        guid: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        product_family_code: z.ZodOptional<z.ZodString>;
+        contact_email: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti/claim/lis': z.ZodOptional<z.ZodObject<{
+        person_sourcedid: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti/claim/launch_presentation': z.ZodOptional<z.ZodObject<{
+        target: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti/claim/custom': z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    'https://purl.imsglobal.org/spec/lti-ags/claim/endpoint': z.ZodOptional<z.ZodObject<{
+        scope: z.ZodArray<z.ZodString>;
+        lineitem: z.ZodOptional<z.ZodString>;
+        lineitems: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti-nrps/claim/namesroleservice': z.ZodOptional<z.ZodObject<{
+        context_memberships_url: z.ZodString;
+        service_versions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    'https://purl.imsglobal.org/spec/lti-dl/claim/deep_linking_settings': z.ZodOptional<z.ZodObject<{
+        deep_link_return_url: z.ZodString;
+        accept_types: z.ZodArray<z.ZodString>;
+        accept_presentation_document_targets: z.ZodArray<z.ZodString>;
+        accept_media_types: z.ZodOptional<z.ZodString>;
+        accept_multiple: z.ZodOptional<z.ZodBoolean>;
+        auto_create: z.ZodOptional<z.ZodBoolean>;
+        data: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LTI13JwtPayload = z.infer<typeof LTI13JwtPayloadSchema>;
+//# sourceMappingURL=lti13JwtPayload.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,22 @@
+import { 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';
+import { LaunchPresentationSchema, LisSchema, ToolPlatformSchema, } from './claims/platformClaims.schema.js';
+import { PrivacyClaimsSchema } from './claims/privacyClaims.schema.js';
+import { AgsEndpointSchema, DeepLinkingSettingsSchema, NrpsServiceSchema, } from './claims/serviceClaims.schema.js';
+export const LTI13JwtPayloadSchema = BaseJwtClaimsSchema.extend(PrivacyClaimsSchema.shape)
+    .extend(CoreLtiClaimsSchema.shape)
+    .extend({
+    'https://purl.imsglobal.org/spec/lti/claim/resource_link': ResourceLinkSchema,
+    'https://purl.imsglobal.org/spec/lti/claim/context': ContextSchema,
+    'https://purl.imsglobal.org/spec/lti/claim/tool_platform': ToolPlatformSchema,
+    'https://purl.imsglobal.org/spec/lti/claim/lis': LisSchema,
+    'https://purl.imsglobal.org/spec/lti/claim/launch_presentation': LaunchPresentationSchema,
+    'https://purl.imsglobal.org/spec/lti/claim/custom': z
+        .record(z.string(), z.string())
+        .optional(),
+    'https://purl.imsglobal.org/spec/lti-ags/claim/endpoint': AgsEndpointSchema,
+    'https://purl.imsglobal.org/spec/lti-nrps/claim/namesroleservice': NrpsServiceSchema,
+    'https://purl.imsglobal.org/spec/lti-dl/claim/deep_linking_settings': DeepLinkingSettingsSchema,
+});

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

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const LTI13LaunchSchema: z.ZodObject<{
+    id_token: z.ZodJWT;
+    state: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for verifyLaunch method parameters - uses consistent camelCase naming
+ * for method parameters while LTI13LaunchSchema uses spec-compliant snake_case
+ */
+export declare const VerifyLaunchParamsSchema: z.ZodObject<{
+    idToken: z.ZodString;
+    state: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=lti13Launch.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const LTI13LaunchSchema = z.object({
+    id_token: z.jwt(),
+    state: z.string(),
+});
+/**
+ * Schema for verifyLaunch method parameters - uses consistent camelCase naming
+ * for method parameters while LTI13LaunchSchema uses spec-compliant snake_case
+ */
+export const VerifyLaunchParamsSchema = z.object({
+    idToken: z.string().min(1, 'idToken is required'),
+    state: z.string().min(1, 'state is required'),
+});

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

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const LTI13LoginSchema: z.ZodObject<{
+    iss: z.ZodString;
+    login_hint: z.ZodString;
+    target_link_uri: z.ZodURL;
+    client_id: z.ZodString;
+    lti_deployment_id: z.ZodString;
+    lti_message_hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for handleLogin method parameters - extends LTI13LoginSchema
+ * with the additional launchUrl parameter needed for method calls
+ */
+export declare const HandleLoginParamsSchema: z.ZodObject<{
+    iss: z.ZodString;
+    login_hint: z.ZodString;
+    target_link_uri: z.ZodURL;
+    client_id: z.ZodString;
+    lti_deployment_id: z.ZodString;
+    lti_message_hint: z.ZodOptional<z.ZodString>;
+    launchUrl: z.ZodUnion<readonly [z.ZodURL, z.ZodCustom<URL, URL>]>;
+}, z.core.$strip>;
+//# sourceMappingURL=lti13Login.schema.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const LTI13LoginSchema = z.object({
+    iss: z.string().min(1),
+    login_hint: z.string().min(1),
+    target_link_uri: z.url(),
+    client_id: z.string().min(1),
+    lti_deployment_id: z.string().min(1),
+    lti_message_hint: z.string().optional(),
+});
+/**
+ * Schema for handleLogin method parameters - extends LTI13LoginSchema
+ * with the additional launchUrl parameter needed for method calls
+ */
+export const HandleLoginParamsSchema = LTI13LoginSchema.extend({
+    launchUrl: z.union([z.url(), z.instanceof(URL)]),
+});

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

@@ -0,0 +1,38 @@
+import type { BaseLogger } from 'pino';
+import type { LTISession } from '../interfaces/ltiSession.js';
+import type { LTIStorage } from '../interfaces/ltiStorage.js';
+import type { ScoreSubmission } from '../schemas/lti13/ags/scoreSubmission.schema.js';
+import type { TokenService } from './token.service.js';
+/**
+ * Assignment and Grade Services (AGS) implementation for LTI 1.3.
+ * Provides methods to submit grades and scores back to the platform.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0
+ */
+export declare class AGSService {
+    private tokenService;
+    private storage;
+    private logger;
+    constructor(tokenService: TokenService, storage: LTIStorage, logger: BaseLogger);
+    /**
+     * Submits a grade score to the platform using LTI Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS endpoint configuration
+     * @param score - Score submission data including grade value and metadata
+     * @returns Promise resolving to the HTTP response from the platform
+     * @throws {Error} When AGS is not available for the session or submission fails
+     *
+     * @example
+     * ```typescript
+     * await agsService.submitScore(session, {
+     *   scoreGiven: 85,
+     *   scoreMaximum: 100,
+     *   comment: 'Great work!',
+     *   activityProgress: 'Completed',
+     *   gradingProgress: 'FullyGraded'
+     * });
+     * ```
+     */
+    submitScore(session: LTISession, score: ScoreSubmission): Promise<Response>;
+}
+//# sourceMappingURL=ags.service.d.ts.map

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

@@ -0,0 +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"}

package/dist/services/ags.service.js

@@ -0,0 +1,69 @@
+import { getValidLaunchConfig } from '../utils/launchConfigValidation.js';
+/**
+ * Assignment and Grade Services (AGS) implementation for LTI 1.3.
+ * Provides methods to submit grades and scores back to the platform.
+ *
+ * @see https://www.imsglobal.org/spec/lti-ags/v2p0
+ */
+export class AGSService {
+    tokenService;
+    storage;
+    logger;
+    constructor(tokenService, storage, logger) {
+        this.tokenService = tokenService;
+        this.storage = storage;
+        this.logger = logger;
+    }
+    /**
+     * Submits a grade score to the platform using LTI Assignment and Grade Services.
+     *
+     * @param session - Active LTI session containing AGS endpoint configuration
+     * @param score - Score submission data including grade value and metadata
+     * @returns Promise resolving to the HTTP response from the platform
+     * @throws {Error} When AGS is not available for the session or submission fails
+     *
+     * @example
+     * ```typescript
+     * await agsService.submitScore(session, {
+     *   scoreGiven: 85,
+     *   scoreMaximum: 100,
+     *   comment: 'Great work!',
+     *   activityProgress: 'Completed',
+     *   gradingProgress: 'FullyGraded'
+     * });
+     * ```
+     */
+    async submitScore(session, score) {
+        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 scorePayload = {
+            userId: score.userId,
+            scoreGiven: score.scoreGiven,
+            scoreMaximum: score.scoreMaximum,
+            comment: score.comment,
+            timestamp: score.timestamp || new Date().toISOString(),
+            activityProgress: score.activityProgress,
+            gradingProgress: score.gradingProgress,
+        };
+        const response = await fetch(`${session.services.ags.lineitem}/scores`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/vnd.ims.lis.v1.score+json',
+            },
+            body: JSON.stringify(scorePayload),
+        });
+        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}`);
+        }
+        return response;
+    }
+}

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

@@ -0,0 +1,11 @@
+import type { LTISession } from '../interfaces/ltiSession.js';
+import type { LTI13JwtPayload } from '../schemas/index.js';
+/**
+ * Creates an LTI session object from a validated LTI 1.3 JWT payload.
+ * Extracts user information, context data, and available services into a structured session.
+ *
+ * @param lti13JwtPayload - Validated LTI 1.3 JWT payload from successful launch
+ * @returns Complete LTI session object with user, context, and service information
+ */
+export declare function createSession(lti13JwtPayload: LTI13JwtPayload): LTISession;
+//# sourceMappingURL=session.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.service.d.ts","sourceRoot":"","sources":["../../src/services/session.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;GAMG;AAEH,wBAAgB,aAAa,CAAC,eAAe,EAAE,eAAe,GAAG,UAAU,CAuG1E"}