@lti-tool/core 0.11.1 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @lti-tool/core
 
+## 0.12.0
+
+### Minor Changes
+
+- 3426ca4: Implement dynamic registration
+
 ## 0.11.1
 
 ### Patch Changes

package/dist/interfaces/index.d.ts

@@ -1,6 +1,7 @@
 export type { LTIClient } from './ltiClient.js';
 export type { LTIConfig } from './ltiConfig.js';
 export type { LTIDeployment } from './ltiDeployment.js';
+export type { LTIDynamicRegistrationSession } from './ltiDynamicRegistrationSession.js';
 export type { LTILaunchConfig } from './ltiLaunchConfig.js';
 export type { LTISession } from './ltiSession.js';
 export type { LTIStorage } from './ltiStorage.js';

package/dist/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/interfaces/ltiConfig.d.ts

@@ -1,5 +1,26 @@
 import type { Logger } from 'pino';
 import type { LTIStorage } from './ltiStorage.js';
+/** Dynamic registration configuration for LTI 1.3 tool registration */
+export interface DynamicRegistrationConfig {
+    /** Base URL of the LTI tool (e.g., 'https://my-tool.com') */
+    url: string;
+    /** Display name shown to users in the LMS (e.g., 'My Learning Tool') */
+    name: string;
+    /** Optional description of the tool's functionality */
+    description?: string;
+    /** Optional URL to tool logo image for LMS display */
+    logo?: string;
+    /** Additional redirect URIs beyond the default /lti/launch endpoint */
+    redirectUris?: string[];
+    /** Optional custom deep linking content selection endpoint (defaults to {url}/lti/deep-linking) */
+    deepLinkingUri?: string;
+    /** Optional custom login endpoint (defaults to {url}/lti/login) */
+    loginUri?: string;
+    /** Optional custom launch endpoint (defaults to {url}/lti/launch) */
+    launchUri?: string;
+    /** Optional custom JWKS endpoint (defaults to {url}/lti/jwks) */
+    jwksUri?: string;
+}
 /**
  * Configuration object for initializing an LTI Tool instance.
  * Contains cryptographic keys, secrets, and storage adapter.
@@ -22,5 +43,7 @@ export interface LTIConfig {
         /** Nonce expiration time in seconds (defaults to 600 = 10 minutes) */
         nonceExpirationSeconds?: number;
     };
+    /** Dynamic registration configuration for LTI 1.3 tool registration */
+    dynamicRegistration?: DynamicRegistrationConfig;
 }
 //# sourceMappingURL=ltiConfig.d.ts.map

package/dist/interfaces/ltiConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ltiConfig.d.ts","sourceRoot":"","sources":["../../src/interfaces/ltiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,WAAW,EAAE,UAAU,CAAC;IAExB,gEAAgE;IAChE,OAAO,EAAE,aAAa,CAAC;IAEvB,qEAAqE;IACrE,OAAO,EAAE,UAAU,CAAC;IAEpB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QACT,2DAA2D;QAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,0EAA0E;QAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,sEAAsE;QACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH"}
+{"version":3,"file":"ltiConfig.d.ts","sourceRoot":"","sources":["../../src/interfaces/ltiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mGAAmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,WAAW,EAAE,UAAU,CAAC;IAExB,gEAAgE;IAChE,OAAO,EAAE,aAAa,CAAC;IAEvB,qEAAqE;IACrE,OAAO,EAAE,UAAU,CAAC;IAEpB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QACT,2DAA2D;QAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,0EAA0E;QAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,sEAAsE;QACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IAEF,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD"}

package/dist/interfaces/ltiDynamicRegistrationSession.d.ts

@@ -0,0 +1,14 @@
+import type { OpenIDConfiguration } from '../schemas/lti13/dynamicRegistration/openIDConfiguration.schema';
+/**
+ * Temporary session data stored during LTI 1.3 dynamic registration flow.
+ * Used to maintain state between the registration initiation and completion steps.
+ */
+export interface LTIDynamicRegistrationSession {
+    /** Platform's OpenID Connect configuration retrieved during registration initiation */
+    openIdConfiguration: OpenIDConfiguration;
+    /** Registration token provided by the platform for this registration attempt */
+    registrationToken?: string;
+    /** Unix timestamp (milliseconds) when this session expires and should be cleaned up */
+    expiresAt: number;
+}
+//# sourceMappingURL=ltiDynamicRegistrationSession.d.ts.map

package/dist/interfaces/ltiDynamicRegistrationSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltiDynamicRegistrationSession.d.ts","sourceRoot":"","sources":["../../src/interfaces/ltiDynamicRegistrationSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iEAAiE,CAAC;AAE3G;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,uFAAuF;IACvF,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/interfaces/ltiDynamicRegistrationSession.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ltiStorage.d.ts

@@ -1,5 +1,6 @@
 import type { LTIClient } from './ltiClient.js';
 import type { LTIDeployment } from './ltiDeployment.js';
+import type { LTIDynamicRegistrationSession } from './ltiDynamicRegistrationSession.js';
 import type { LTILaunchConfig } from './ltiLaunchConfig.js';
 import type { LTISession } from './ltiSession.js';
 /**
@@ -118,5 +119,26 @@ export interface LTIStorage {
      * @param launchConfig - Complete launch configuration with auth URLs and keys
      */
     saveLaunchConfig(launchConfig: LTILaunchConfig): Promise<void>;
+    /**
+     * Stores a temporary registration session during LTI 1.3 dynamic registration flow.
+     * Sessions have a TTL and are automatically cleaned up when expired.
+     *
+     * @param sessionId - Unique session identifier (typically a UUID)
+     * @param session - Registration session data including platform config and tokens
+     */
+    setRegistrationSession(sessionId: string, session: LTIDynamicRegistrationSession): Promise<void>;
+    /**
+     * Retrieves a registration session by its ID for validation during completion.
+     *
+     * @param sessionId - Unique session identifier
+     * @returns Registration session if found and not expired, undefined otherwise
+     */
+    getRegistrationSession(sessionId: string): Promise<LTIDynamicRegistrationSession | undefined>;
+    /**
+     * Removes a registration session from storage (cleanup after completion or expiration).
+     *
+     * @param sessionId - Unique session identifier to delete
+     */
+    deleteRegistrationSession(sessionId: string): Promise<void>;
 }
 //# sourceMappingURL=ltiStorage.d.ts.map

package/dist/interfaces/ltiStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ltiStorage.d.ts","sourceRoot":"","sources":["../../src/interfaces/ltiStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,UAAU;IAGzB;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAEhE;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,CAAC,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI9C;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5D;;;;;;OAMG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExF;;;;;OAKG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIxE;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAIjD;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAI/C;;;;;;;OAOG;IACH,eAAe,CACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAExC;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}
+{"version":3,"file":"ltiStorage.d.ts","sourceRoot":"","sources":["../../src/interfaces/ltiStorage.ts"],"names":[],"mappings":"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"}

package/dist/ltiTool.d.ts

@@ -2,11 +2,13 @@ import type { JWKS } from './interfaces/jwks.js';
 import type { LTIClient } from './interfaces/ltiClient.js';
 import type { LTIConfig } from './interfaces/ltiConfig.js';
 import type { LTIDeployment } from './interfaces/ltiDeployment.js';
+import type { LTIDynamicRegistrationSession } from './interfaces/ltiDynamicRegistrationSession.js';
 import type { LTISession } from './interfaces/ltiSession.js';
-import { type LTI13JwtPayload } from './schemas/index.js';
+import { type DynamicRegistrationForm, type LTI13JwtPayload, type RegistrationRequest } from './schemas/index.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 OpenIDConfiguration } from './schemas/lti13/dynamicRegistration/openIDConfiguration.schema.js';
 import { type Member } from './schemas/lti13/nrps/contextMembership.schema.js';
 /**
  * Main LTI 1.3 Tool implementation providing secure authentication, launch verification,
@@ -39,6 +41,7 @@ export declare class LTITool {
     private tokenService;
     private agsService;
     private nrpsService;
+    private dynamicRegistrationService?;
     /**
      * Creates a new LTI Tool instance.
      *
@@ -194,6 +197,43 @@ export declare class LTITool {
      * ```
      */
     getMembers(session: LTISession): Promise<Member[]>;
+    /**
+     * Fetches and validates the OpenID Connect configuration from an LTI platform during dynamic registration.
+     * Validates that the OIDC endpoint and issuer have matching hostnames for security.
+     *
+     * @param registrationRequest - Registration request containing openid_configuration URL and optional registration_token
+     * @returns Validated OpenID configuration with platform endpoints and supported features
+     * @throws {Error} When the configuration fetch fails, validation fails, or hostname mismatch detected
+     *
+     * @example
+     * ```typescript
+     * const config = await ltiTool.fetchPlatformConfiguration({
+     *   openid_configuration: 'https://platform.edu/.well-known/openid_configuration',
+     *   registration_token: 'optional-bearer-token'
+     * });
+     * console.log('Platform issuer:', config.issuer);
+     * ```
+     */
+    fetchPlatformConfiguration(registrationRequest: RegistrationRequest): Promise<OpenIDConfiguration>;
+    /**
+     * Initiates LTI 1.3 dynamic registration by fetching platform configuration and generating registration form.
+     * Creates a temporary session and returns vendor-specific HTML form for service selection.
+     *
+     * @param registrationRequest - Registration request containing openid_configuration URL and optional registration_token
+     * @param requestPath - Current request path used to build form action URLs
+     * @returns HTML form for service selection and registration completion
+     * @throws {Error} When dynamic registration service is not configured or platform configuration fails
+     */
+    initiateDynamicRegistration(registrationRequest: RegistrationRequest, requestPath: string): Promise<string>;
+    /**
+     * Completes LTI 1.3 dynamic registration by processing form submission and storing client configuration.
+     * Validates session, registers with platform, stores client/deployment data, and returns success page.
+     *
+     * @param dynamicRegistrationForm - Validated form data containing selected services and session token
+     * @returns HTML success page with registration details and close button
+     * @throws {Error} When dynamic registration service is not configured or registration process fails
+     */
+    completeDynamicRegistration(dynamicRegistrationForm: DynamicRegistrationForm): Promise<string>;
     /**
      * Retrieves all configured LTI client platforms.
      *
@@ -265,5 +305,28 @@ export declare class LTITool {
      * @param deploymentId - Deployment identifier to remove
      */
     deleteDeployment(clientId: string, deploymentId: string): Promise<void>;
+    /**
+     * Stores a temporary registration session during LTI 1.3 dynamic registration flow.
+     * Sessions automatically expire after the configured TTL period.
+     *
+     * @param sessionId - Unique session identifier (typically a UUID)
+     * @param session - Registration session data including platform config and tokens
+     */
+    setRegistrationSession(sessionId: string, session: LTIDynamicRegistrationSession): Promise<void>;
+    /**
+     * Retrieves a registration session by its ID for validation during completion.
+     * Returns undefined if the session is not found or has expired.
+     *
+     * @param sessionId - Unique session identifier
+     * @returns Registration session if found and not expired, undefined otherwise
+     */
+    getRegistrationSession(sessionId: string): Promise<LTIDynamicRegistrationSession | undefined>;
+    /**
+     * Removes a registration session from storage after completion or expiration.
+     * Used for cleanup to prevent session accumulation.
+     *
+     * @param sessionId - Unique session identifier to delete
+     */
+    deleteRegistrationSession(sessionId: string): Promise<void>;
 }
 //# sourceMappingURL=ltiTool.d.ts.map

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

@@ -5,6 +5,7 @@ import { LineItemSchema, LineItemsSchema, } from './schemas/lti13/ags/lineItem.s
 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 { DynamicRegistrationService } from './services/dynamicRegistration.service.js';
 import { NRPSService } from './services/nrps.service.js';
 import { createSession } from './services/session.service.js';
 import { TokenService } from './services/token.service.js';
@@ -40,6 +41,7 @@ export class LTITool {
     tokenService;
     agsService;
     nrpsService;
+    dynamicRegistrationService;
     /**
      * Creates a new LTI Tool instance.
      *
@@ -58,6 +60,9 @@ 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);
+        if (this.config.dynamicRegistration) {
+            this.dynamicRegistrationService = new DynamicRegistrationService(this.config.storage, this.config.dynamicRegistration, this.logger);
+        }
     }
     /**
      * Handles LTI 1.3 login initiation by generating state/nonce and redirecting to platform auth.
@@ -345,7 +350,6 @@ export class LTITool {
         }
         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) => ({
@@ -361,6 +365,58 @@ export class LTITool {
             roles: member.roles,
         }));
     }
+    /**
+     * Fetches and validates the OpenID Connect configuration from an LTI platform during dynamic registration.
+     * Validates that the OIDC endpoint and issuer have matching hostnames for security.
+     *
+     * @param registrationRequest - Registration request containing openid_configuration URL and optional registration_token
+     * @returns Validated OpenID configuration with platform endpoints and supported features
+     * @throws {Error} When the configuration fetch fails, validation fails, or hostname mismatch detected
+     *
+     * @example
+     * ```typescript
+     * const config = await ltiTool.fetchPlatformConfiguration({
+     *   openid_configuration: 'https://platform.edu/.well-known/openid_configuration',
+     *   registration_token: 'optional-bearer-token'
+     * });
+     * console.log('Platform issuer:', config.issuer);
+     * ```
+     */
+    async fetchPlatformConfiguration(registrationRequest) {
+        if (!this.dynamicRegistrationService) {
+            throw new Error('Dynamic registration service is not configured');
+        }
+        return await this.dynamicRegistrationService.fetchPlatformConfiguration(registrationRequest);
+    }
+    /**
+     * Initiates LTI 1.3 dynamic registration by fetching platform configuration and generating registration form.
+     * Creates a temporary session and returns vendor-specific HTML form for service selection.
+     *
+     * @param registrationRequest - Registration request containing openid_configuration URL and optional registration_token
+     * @param requestPath - Current request path used to build form action URLs
+     * @returns HTML form for service selection and registration completion
+     * @throws {Error} When dynamic registration service is not configured or platform configuration fails
+     */
+    async initiateDynamicRegistration(registrationRequest, requestPath) {
+        if (!this.dynamicRegistrationService) {
+            throw new Error('Dynamic registration service is not configured');
+        }
+        return await this.dynamicRegistrationService.initiateDynamicRegistration(registrationRequest, requestPath);
+    }
+    /**
+     * Completes LTI 1.3 dynamic registration by processing form submission and storing client configuration.
+     * Validates session, registers with platform, stores client/deployment data, and returns success page.
+     *
+     * @param dynamicRegistrationForm - Validated form data containing selected services and session token
+     * @returns HTML success page with registration details and close button
+     * @throws {Error} When dynamic registration service is not configured or registration process fails
+     */
+    async completeDynamicRegistration(dynamicRegistrationForm) {
+        if (!this.dynamicRegistrationService) {
+            throw new Error('Dynmaic registration service is not configured');
+        }
+        return await this.dynamicRegistrationService.completeDynamicRegistration(dynamicRegistrationForm);
+    }
     // Client management
     /**
      * Retrieves all configured LTI client platforms.
@@ -456,4 +512,34 @@ export class LTITool {
     async deleteDeployment(clientId, deploymentId) {
         return await this.config.storage.deleteDeployment(clientId, deploymentId);
     }
+    // Dynamic Registration Session Management
+    /**
+     * Stores a temporary registration session during LTI 1.3 dynamic registration flow.
+     * Sessions automatically expire after the configured TTL period.
+     *
+     * @param sessionId - Unique session identifier (typically a UUID)
+     * @param session - Registration session data including platform config and tokens
+     */
+    async setRegistrationSession(sessionId, session) {
+        return await this.config.storage.setRegistrationSession(sessionId, session);
+    }
+    /**
+     * Retrieves a registration session by its ID for validation during completion.
+     * Returns undefined if the session is not found or has expired.
+     *
+     * @param sessionId - Unique session identifier
+     * @returns Registration session if found and not expired, undefined otherwise
+     */
+    async getRegistrationSession(sessionId) {
+        return await this.config.storage.getRegistrationSession(sessionId);
+    }
+    /**
+     * Removes a registration session from storage after completion or expiration.
+     * Used for cleanup to prevent session accumulation.
+     *
+     * @param sessionId - Unique session identifier to delete
+     */
+    async deleteRegistrationSession(sessionId) {
+        return await this.config.storage.deleteRegistrationSession(sessionId);
+    }
 }

package/dist/schemas/index.d.ts

@@ -1,4 +1,9 @@
 export { SessionIdSchema } from './common.schema.js';
+export { DynamicRegistrationFormSchema, type DynamicRegistrationForm, } from './lti13/dynamicRegistration/ltiDynamicRegistration.schema.js';
+export { LTIMessagesArraySchema, type LTIMessage, } from './lti13/dynamicRegistration/ltiMessages.schema.js';
+export { type OpenIDConfiguration } from './lti13/dynamicRegistration/openIDConfiguration.schema.js';
+export { RegistrationRequestSchema, type RegistrationRequest, } from './lti13/dynamicRegistration/registrationRequest.schema.js';
+export { RegistrationResponseSchema, type RegistrationResponse, } from './lti13/dynamicRegistration/registrationResponse.schema.js';
 export { LTI13JwtPayloadSchema, type LTI13JwtPayload, } from './lti13/lti13JwtPayload.schema.js';
 export { LTI13LaunchSchema, VerifyLaunchParamsSchema, } from './lti13/lti13Launch.schema.js';
 export { HandleLoginParamsSchema, LTI13LoginSchema } from './lti13/lti13Login.schema.js';

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,8DAA8D,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,KAAK,UAAU,GAChB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,2DAA2D,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/schemas/index.js

@@ -1,4 +1,8 @@
 export { SessionIdSchema } from './common.schema.js';
+export { DynamicRegistrationFormSchema, } from './lti13/dynamicRegistration/ltiDynamicRegistration.schema.js';
+export { LTIMessagesArraySchema, } from './lti13/dynamicRegistration/ltiMessages.schema.js';
+export { RegistrationRequestSchema, } from './lti13/dynamicRegistration/registrationRequest.schema.js';
+export { RegistrationResponseSchema, } from './lti13/dynamicRegistration/registrationResponse.schema.js';
 export { LTI13JwtPayloadSchema, } from './lti13/lti13JwtPayload.schema.js';
 export { LTI13LaunchSchema, VerifyLaunchParamsSchema, } from './lti13/lti13Launch.schema.js';
 export { HandleLoginParamsSchema, LTI13LoginSchema } from './lti13/lti13Login.schema.js';

package/dist/schemas/lti13/dynamicRegistration/ltiDynamicRegistration.schema.d.ts

@@ -0,0 +1,34 @@
+import * as z from 'zod';
+/**
+ * Zod schema for validating LTI 1.3 dynamic registration form submissions.
+ * Represents the service selections and session data submitted by an administrator during tool registration.
+ *
+ * @property services - Optional array of LTI Advantage services the admin chooses to enable:
+ *   - 'ags': Assignment and Grade Services for grade passback
+ *   - 'nrps': Names and Role Provisioning Services for roster access
+ *   - 'deep_linking': Deep Linking for content selection
+ *   - 'tool_settings': Tool Settings service for configuration storage
+ *   - 'basic_outcome': Basic Outcome service for simple grade reporting
+ * @property sessionToken - Security token to validate the registration session and prevent CSRF attacks
+ *
+ * @example
+ * ```typescript
+ * const formData = {
+ *   services: ['ags', 'nrps', 'deep_linking'],
+ *   sessionToken: 'uuid-session-token'
+ * };
+ * const validated = DynamicRegistrationFormSchema.parse(formData);
+ * ```
+ */
+export declare const DynamicRegistrationFormSchema: z.ZodObject<{
+    services: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ags: "ags";
+        nrps: "nrps";
+        deep_linking: "deep_linking";
+        tool_settings: "tool_settings";
+        basic_outcome: "basic_outcome";
+    }>>>;
+    sessionToken: z.ZodString;
+}, z.core.$strip>;
+export type DynamicRegistrationForm = z.infer<typeof DynamicRegistrationFormSchema>;
+//# sourceMappingURL=ltiDynamicRegistration.schema.d.ts.map

package/dist/schemas/lti13/dynamicRegistration/ltiDynamicRegistration.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltiDynamicRegistration.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/dynamicRegistration/ltiDynamicRegistration.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;iBAKxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/schemas/lti13/dynamicRegistration/ltiDynamicRegistration.schema.js

@@ -0,0 +1,28 @@
+import * as z from 'zod';
+/**
+ * Zod schema for validating LTI 1.3 dynamic registration form submissions.
+ * Represents the service selections and session data submitted by an administrator during tool registration.
+ *
+ * @property services - Optional array of LTI Advantage services the admin chooses to enable:
+ *   - 'ags': Assignment and Grade Services for grade passback
+ *   - 'nrps': Names and Role Provisioning Services for roster access
+ *   - 'deep_linking': Deep Linking for content selection
+ *   - 'tool_settings': Tool Settings service for configuration storage
+ *   - 'basic_outcome': Basic Outcome service for simple grade reporting
+ * @property sessionToken - Security token to validate the registration session and prevent CSRF attacks
+ *
+ * @example
+ * ```typescript
+ * const formData = {
+ *   services: ['ags', 'nrps', 'deep_linking'],
+ *   sessionToken: 'uuid-session-token'
+ * };
+ * const validated = DynamicRegistrationFormSchema.parse(formData);
+ * ```
+ */
+export const DynamicRegistrationFormSchema = z.object({
+    services: z
+        .array(z.enum(['ags', 'nrps', 'deep_linking', 'tool_settings', 'basic_outcome']))
+        .optional(),
+    sessionToken: z.string(),
+});

package/dist/schemas/lti13/dynamicRegistration/ltiMessages.schema.d.ts

@@ -0,0 +1,101 @@
+import * as z from 'zod';
+/**
+ * Zod schema for LTI 1.3 Resource Link Request message configuration.
+ * Represents the standard tool launch message type for accessing tool content.
+ * This is the most common LTI message type for regular tool launches.
+ */
+declare const LTIResourceLinkMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"LtiResourceLinkRequest">;
+}, z.core.$strip>;
+/**
+ * Zod schema for LTI 1.3 Deep Linking Request message configuration.
+ * Represents the message type used when the tool supports content selection/authoring.
+ * Allows instructors to select or create content that will be linked back to the LMS.
+ *
+ * @property type - Always 'LtiDeepLinkingRequest' for deep linking messages
+ * @property target_link_uri - Optional URL where deep linking requests should be sent
+ * @property label - Optional human-readable label for the deep linking option
+ * @property placements - Optional array of where the tool can be placed in the LMS UI
+ * @property supported_types - Optional array of content types the tool can create/select
+ * @property supported_media_types - Optional array of MIME types the tool supports
+ * @property roles - Optional array of LIS role URIs that can access deep linking
+ * @property custom_parameters - Optional custom parameters for deep linking configuration
+ */
+declare const LTIDeepLinkingMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"LtiDeepLinkingRequest">;
+    target_link_uri: z.ZodOptional<z.ZodURL>;
+    label: z.ZodOptional<z.ZodString>;
+    placements: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ContentArea: "ContentArea";
+        RichTextEditor: "RichTextEditor";
+        CourseNavigation: "CourseNavigation";
+    }>>>;
+    supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        file: "file";
+        ltiResourceLink: "ltiResourceLink";
+        html: "html";
+        link: "link";
+        image: "image";
+    }>>>;
+    supported_media_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    custom_parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Discriminated union schema for all supported LTI 1.3 message types.
+ * Used during dynamic registration to declare which message types the tool supports.
+ * The platform uses this to determine what launch options to provide to users.
+ */
+export declare const LTIMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"LtiResourceLinkRequest">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"LtiDeepLinkingRequest">;
+    target_link_uri: z.ZodOptional<z.ZodURL>;
+    label: z.ZodOptional<z.ZodString>;
+    placements: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ContentArea: "ContentArea";
+        RichTextEditor: "RichTextEditor";
+        CourseNavigation: "CourseNavigation";
+    }>>>;
+    supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        file: "file";
+        ltiResourceLink: "ltiResourceLink";
+        html: "html";
+        link: "link";
+        image: "image";
+    }>>>;
+    supported_media_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    custom_parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>], "type">;
+/**
+ * Schema for validating arrays of LTI message configurations.
+ * Used in tool registration payloads to declare multiple supported message types.
+ */
+export declare const LTIMessagesArraySchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"LtiResourceLinkRequest">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"LtiDeepLinkingRequest">;
+    target_link_uri: z.ZodOptional<z.ZodURL>;
+    label: z.ZodOptional<z.ZodString>;
+    placements: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ContentArea: "ContentArea";
+        RichTextEditor: "RichTextEditor";
+        CourseNavigation: "CourseNavigation";
+    }>>>;
+    supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        file: "file";
+        ltiResourceLink: "ltiResourceLink";
+        html: "html";
+        link: "link";
+        image: "image";
+    }>>>;
+    supported_media_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    custom_parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>], "type">>;
+export type LTIMessage = z.infer<typeof LTIMessageSchema>;
+export type LTIResourceLinkMessage = z.infer<typeof LTIResourceLinkMessageSchema>;
+export type LTIDeepLinkingMessage = z.infer<typeof LTIDeepLinkingMessageSchema>;
+export {};
+//# sourceMappingURL=ltiMessages.schema.d.ts.map

package/dist/schemas/lti13/dynamicRegistration/ltiMessages.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltiMessages.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/dynamicRegistration/ltiMessages.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;GAIG;AACH,QAAA,MAAM,4BAA4B;;iBAEhC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;iBAa/B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;2BAG3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;4BAA4B,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/schemas/lti13/dynamicRegistration/ltiMessages.schema.js

@@ -0,0 +1,51 @@
+import * as z from 'zod';
+/**
+ * Zod schema for LTI 1.3 Resource Link Request message configuration.
+ * Represents the standard tool launch message type for accessing tool content.
+ * This is the most common LTI message type for regular tool launches.
+ */
+const LTIResourceLinkMessageSchema = z.object({
+    type: z.literal('LtiResourceLinkRequest'),
+});
+/**
+ * Zod schema for LTI 1.3 Deep Linking Request message configuration.
+ * Represents the message type used when the tool supports content selection/authoring.
+ * Allows instructors to select or create content that will be linked back to the LMS.
+ *
+ * @property type - Always 'LtiDeepLinkingRequest' for deep linking messages
+ * @property target_link_uri - Optional URL where deep linking requests should be sent
+ * @property label - Optional human-readable label for the deep linking option
+ * @property placements - Optional array of where the tool can be placed in the LMS UI
+ * @property supported_types - Optional array of content types the tool can create/select
+ * @property supported_media_types - Optional array of MIME types the tool supports
+ * @property roles - Optional array of LIS role URIs that can access deep linking
+ * @property custom_parameters - Optional custom parameters for deep linking configuration
+ */
+const LTIDeepLinkingMessageSchema = z.object({
+    type: z.literal('LtiDeepLinkingRequest'),
+    target_link_uri: z.url().optional(),
+    label: z.string().optional(),
+    placements: z
+        .array(z.enum(['ContentArea', 'RichTextEditor', 'CourseNavigation']))
+        .optional(),
+    supported_types: z
+        .array(z.enum(['ltiResourceLink', 'file', 'html', 'link', 'image']))
+        .optional(),
+    supported_media_types: z.array(z.string()).optional(), // e.g., ['image/*', 'video/*']
+    roles: z.array(z.string()).optional(), // LIS role URIs
+    custom_parameters: z.record(z.string(), z.string()).optional(),
+});
+/**
+ * Discriminated union schema for all supported LTI 1.3 message types.
+ * Used during dynamic registration to declare which message types the tool supports.
+ * The platform uses this to determine what launch options to provide to users.
+ */
+export const LTIMessageSchema = z.discriminatedUnion('type', [
+    LTIResourceLinkMessageSchema,
+    LTIDeepLinkingMessageSchema,
+]);
+/**
+ * Schema for validating arrays of LTI message configurations.
+ * Used in tool registration payloads to declare multiple supported message types.
+ */
+export const LTIMessagesArraySchema = z.array(LTIMessageSchema);