@lti-tool/core 0.13.1 → 0.14.0

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

@@ -26,9 +26,11 @@ declare const LTIDeepLinkingMessageSchema: z.ZodObject<{
     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";
+        editor_button: "editor_button";
+        assignment_selection: "assignment_selection";
+        link_selection: "link_selection";
+        module_index_menu_modal: "module_index_menu_modal";
+        module_menu_modal: "module_menu_modal";
     }>>>;
     supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         file: "file";
@@ -53,9 +55,11 @@ export declare const LTIMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     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";
+        editor_button: "editor_button";
+        assignment_selection: "assignment_selection";
+        link_selection: "link_selection";
+        module_index_menu_modal: "module_index_menu_modal";
+        module_menu_modal: "module_menu_modal";
     }>>>;
     supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         file: "file";
@@ -79,9 +83,11 @@ export declare const LTIMessagesArraySchema: z.ZodArray<z.ZodDiscriminatedUnion<
     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";
+        editor_button: "editor_button";
+        assignment_selection: "assignment_selection";
+        link_selection: "link_selection";
+        module_index_menu_modal: "module_index_menu_modal";
+        module_menu_modal: "module_menu_modal";
     }>>>;
     supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         file: "file";

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;iBAqB/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

@@ -26,7 +26,13 @@ const LTIDeepLinkingMessageSchema = z.object({
     target_link_uri: z.url().optional(),
     label: z.string().optional(),
     placements: z
-        .array(z.enum(['ContentArea', 'RichTextEditor', 'CourseNavigation']))
+        .array(z.enum([
+        'editor_button',
+        'assignment_selection',
+        'link_selection',
+        'module_index_menu_modal',
+        'module_menu_modal',
+    ]))
         .optional(),
     supported_types: z
         .array(z.enum(['ltiResourceLink', 'file', 'html', 'link', 'image']))

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

@@ -50,9 +50,11 @@ export declare const RegistrationResponseSchema: z.ZodObject<{
             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";
+                editor_button: "editor_button";
+                assignment_selection: "assignment_selection";
+                link_selection: "link_selection";
+                module_index_menu_modal: "module_index_menu_modal";
+                module_menu_modal: "module_menu_modal";
             }>>>;
             supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 file: "file";

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

@@ -1 +1 @@
-{"version":3,"file":"registrationResponse.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/dynamicRegistration/registrationResponse.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA0BzB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"registrationResponse.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/dynamicRegistration/registrationResponse.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA0BzB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

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

@@ -21,9 +21,11 @@ declare const LTIToolConfigurationSchema: z.ZodObject<{
         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";
+            editor_button: "editor_button";
+            assignment_selection: "assignment_selection";
+            link_selection: "link_selection";
+            module_index_menu_modal: "module_index_menu_modal";
+            module_menu_modal: "module_menu_modal";
         }>>>;
         supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             file: "file";
@@ -80,9 +82,11 @@ export declare const ToolRegistrationPayloadSchema: z.ZodObject<{
             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";
+                editor_button: "editor_button";
+                assignment_selection: "assignment_selection";
+                link_selection: "link_selection";
+                module_index_menu_modal: "module_index_menu_modal";
+                module_menu_modal: "module_menu_modal";
             }>>>;
             supported_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 file: "file";

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

@@ -1 +1 @@
-{"version":3,"file":"toolRegistrationPayload.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/dynamicRegistration/toolRegistrationPayload.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB;;;;;;;;;GASG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"toolRegistrationPayload.schema.d.ts","sourceRoot":"","sources":["../../../../src/schemas/lti13/dynamicRegistration/toolRegistrationPayload.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB;;;;;;;;;GASG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

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

@@ -97,12 +97,23 @@ export declare class DynamicRegistrationService {
      * @returns Session data if valid and not expired, undefined otherwise
      */
     verifyRegistrationSession(sessionToken: string): Promise<LTIDynamicRegistrationSession | undefined>;
+    /**
+     * Builds Canvas-specific deep linking messages for the 5 common placements.
+     * Creates separate messages for editor, module menu, assignments, modules page, and link selection.
+     *
+     * @param deepLinkingUri - URI where deep linking requests should be sent
+     * @param toolName - Display name of the tool
+     * @returns Array of Canvas deep linking message configurations
+     */
+    private buildCanvasDeepLinkingMessages;
     /**
      * Builds array of LTI message types based on selected services during registration.
      * Always includes ResourceLinkRequest, conditionally adds DeepLinkingRequest.
      *
      * @param selectedServices - Array of service names selected by administrator
      * @param deepLinkingUri - URI where deep linking requests should be sent
+     * @param platformFamily - Platform family code (e.g., 'canvas', 'moodle')
+     * @param toolName - Display name of the tool
      * @returns Array of LTI message configurations for the registration payload
      */
     private buildMessages;
@@ -119,6 +130,7 @@ export declare class DynamicRegistrationService {
      * Combines tool configuration, selected services, and OAuth parameters into LTI 1.3 registration format.
      *
      * @param selectedServices - Array of service names selected by administrator
+     * @param platformFamily - Platform family code (e.g., 'canvas', 'moodle')
      * @returns Complete registration payload ready for platform submission
      */
     private buildRegistrationPayload;

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

@@ -1 +1 @@
-{"version":3,"file":"dynamicRegistration.service.d.ts","sourceRoot":"","sources":["../../src/services/dynamicRegistration.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AACpG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uEAAuE,CAAC;AAErH,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,oEAAoE,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oEAAoE,CAAC;AAS9G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,0BAA0B;IASnC,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,yBAAyB;IACjC,OAAO,CAAC,MAAM;IAVhB;;;;;;OAMG;gBAEO,OAAO,EAAE,UAAU,EACnB,yBAAyB,EAAE,yBAAyB,EACpD,MAAM,EAAE,UAAU;IAG5B;;;;;;;OAOG;IACG,0BAA0B,CAC9B,mBAAmB,EAAE,mBAAmB,GACvC,OAAO,CAAC,mBAAmB,CAAC;IAkC/B;;;;;;;;OAQG;IACG,2BAA2B,CAC/B,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAsClB;;;;;;;OAOG;IACG,2BAA2B,CAC/B,uBAAuB,EAAE,uBAAuB,GAC/C,OAAO,CAAC,MAAM,CAAC;IAoDlB;;;;;;OAMG;IACG,yBAAyB,CAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC;IAQrD;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAoBnB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;YAkClB,mCAAmC;IAgBjD,OAAO,CAAC,0BAA0B;CAiDnC"}
+{"version":3,"file":"dynamicRegistration.service.d.ts","sourceRoot":"","sources":["../../src/services/dynamicRegistration.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AACpG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uEAAuE,CAAC;AAErH,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,oEAAoE,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oEAAoE,CAAC;AAS9G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,0BAA0B;IASnC,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,yBAAyB;IACjC,OAAO,CAAC,MAAM;IAVhB;;;;;;OAMG;gBAEO,OAAO,EAAE,UAAU,EACnB,yBAAyB,EAAE,yBAAyB,EACpD,MAAM,EAAE,UAAU;IAG5B;;;;;;;OAOG;IACG,0BAA0B,CAC9B,mBAAmB,EAAE,mBAAmB,GACvC,OAAO,CAAC,mBAAmB,CAAC;IAkC/B;;;;;;;;OAQG;IACG,2BAA2B,CAC/B,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAsClB;;;;;;;OAOG;IACG,2BAA2B,CAC/B,uBAAuB,EAAE,uBAAuB,GAC/C,OAAO,CAAC,MAAM,CAAC;IA2DlB;;;;;;OAMG;IACG,yBAAyB,CAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC;IAQrD;;;;;;;OAOG;IACH,OAAO,CAAC,8BAA8B;IA2CtC;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IA0BrB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAoBnB;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;YA0ClB,mCAAmC;IAgBjD,OAAO,CAAC,0BAA0B;CAiDnC"}

package/dist/services/dynamicRegistration.service.js

@@ -140,8 +140,10 @@ export class DynamicRegistrationService {
         if (!session) {
             throw new Error('Invalid or expired session');
         }
+        // Extract platform family from session
+        const platformFamily = session.openIdConfiguration['https://purl.imsglobal.org/spec/lti-platform-configuration'].product_family_code;
         // 1. build payload
-        const toolRegistrationPayload = this.buildRegistrationPayload(dynamicRegistrationForm.services ?? []);
+        const toolRegistrationPayload = this.buildRegistrationPayload(dynamicRegistrationForm.services ?? [], platformFamily);
         // 2. Post request to Moodle
         const registrationResponse = await postRegistrationToMoodle(session.openIdConfiguration.registration_endpoint, toolRegistrationPayload, this.logger, session.registrationToken);
         // 3. save to storage
@@ -185,25 +187,79 @@ export class DynamicRegistrationService {
         }
         return session;
     }
+    /**
+     * Builds Canvas-specific deep linking messages for the 5 common placements.
+     * Creates separate messages for editor, module menu, assignments, modules page, and link selection.
+     *
+     * @param deepLinkingUri - URI where deep linking requests should be sent
+     * @param toolName - Display name of the tool
+     * @returns Array of Canvas deep linking message configurations
+     */
+    buildCanvasDeepLinkingMessages(deepLinkingUri, toolName) {
+        return [
+            {
+                type: 'LtiDeepLinkingRequest',
+                target_link_uri: deepLinkingUri,
+                label: toolName,
+                placements: ['editor_button'],
+                supported_types: ['ltiResourceLink'],
+            },
+            {
+                type: 'LtiDeepLinkingRequest',
+                target_link_uri: deepLinkingUri,
+                label: toolName,
+                placements: ['module_menu_modal'],
+                supported_types: ['ltiResourceLink'],
+            },
+            {
+                type: 'LtiDeepLinkingRequest',
+                target_link_uri: deepLinkingUri,
+                label: toolName,
+                placements: ['assignment_selection'],
+                supported_types: ['ltiResourceLink'],
+            },
+            {
+                type: 'LtiDeepLinkingRequest',
+                target_link_uri: deepLinkingUri,
+                label: toolName,
+                placements: ['module_index_menu_modal'],
+                supported_types: ['ltiResourceLink'],
+            },
+            {
+                type: 'LtiDeepLinkingRequest',
+                target_link_uri: deepLinkingUri,
+                label: toolName,
+                placements: ['link_selection'],
+                supported_types: ['ltiResourceLink'],
+            },
+        ];
+    }
     /**
      * Builds array of LTI message types based on selected services during registration.
      * Always includes ResourceLinkRequest, conditionally adds DeepLinkingRequest.
      *
      * @param selectedServices - Array of service names selected by administrator
      * @param deepLinkingUri - URI where deep linking requests should be sent
+     * @param platformFamily - Platform family code (e.g., 'canvas', 'moodle')
+     * @param toolName - Display name of the tool
      * @returns Array of LTI message configurations for the registration payload
      */
-    buildMessages(selectedServices, deepLinkingUri) {
+    buildMessages(selectedServices, deepLinkingUri, platformFamily, toolName) {
         const messages = [];
         messages.push({ type: 'LtiResourceLinkRequest' });
         if (selectedServices?.includes('deep_linking')) {
-            messages.push({
-                type: 'LtiDeepLinkingRequest',
-                target_link_uri: deepLinkingUri,
-                label: 'Content Selection',
-                placements: ['ContentArea'], // Focus on content area only
-                supported_types: ['ltiResourceLink'], // Standard content selection
-            });
+            if (platformFamily.toLowerCase() === 'canvas') {
+                messages.push(...this.buildCanvasDeepLinkingMessages(deepLinkingUri, toolName));
+            }
+            else {
+                messages.push({
+                    type: 'LtiDeepLinkingRequest',
+                    target_link_uri: deepLinkingUri,
+                    label: toolName,
+                    placements: ['editor_button'],
+                    supported_types: ['ltiResourceLink'],
+                });
+            }
         }
         return messages;
     }
@@ -229,15 +285,16 @@ export class DynamicRegistrationService {
      * Combines tool configuration, selected services, and OAuth parameters into LTI 1.3 registration format.
      *
      * @param selectedServices - Array of service names selected by administrator
+     * @param platformFamily - Platform family code (e.g., 'canvas', 'moodle')
      * @returns Complete registration payload ready for platform submission
      */
-    buildRegistrationPayload(selectedServices) {
+    buildRegistrationPayload(selectedServices, platformFamily) {
         const config = this.dynamicRegistrationConfig;
         const deepLinkingUri = config.deepLinkingUri || `${config.url}/lti/deep-linking`;
         const jwksUri = config.jwksUri || `${config.url}/lti/jwks`;
         const launchUri = config.launchUri || `${config.url}/lti/launch`;
         const loginUri = config.loginUri || `${config.url}/lti/login`;
-        const messages = this.buildMessages(selectedServices, deepLinkingUri);
+        const messages = this.buildMessages(selectedServices, deepLinkingUri, platformFamily, config.name);
         const scopes = this.buildScopes(selectedServices);
         const toolRegistrationPayload = {
             application_type: 'web',

package/dist/services/dynamicRegistrationHandlers/moodle.js

@@ -142,7 +142,7 @@ export async function postRegistrationToMoodle(registrationEndpoint, registratio
     if (!response.ok) {
         const errorText = await response.json();
         logger.error({ errorText }, 'lti dynamic registration error');
-        throw new Error(errorText);
+        throw new Error(JSON.stringify(errorText));
     }
     const data = await response.json();
     logger.debug({ data }, 'Registration response');

package/dist/utils/errorFormatting.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Formats an unknown error into a readable string message.
+ * Handles Error objects, strings, and other types safely.
+ *
+ * @param error - The error to format (can be Error, string, or any other type)
+ * @returns Formatted error message string
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (error) {
+ *   throw new Error(`Operation failed: ${formatError(error)}`);
+ * }
+ * ```
+ */
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=errorFormatting.d.ts.map

package/dist/utils/errorFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorFormatting.d.ts","sourceRoot":"","sources":["../../src/utils/errorFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKlD"}

package/dist/utils/errorFormatting.js

@@ -0,0 +1,22 @@
+/**
+ * Formats an unknown error into a readable string message.
+ * Handles Error objects, strings, and other types safely.
+ *
+ * @param error - The error to format (can be Error, string, or any other type)
+ * @returns Formatted error message string
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (error) {
+ *   throw new Error(`Operation failed: ${formatError(error)}`);
+ * }
+ * ```
+ */
+export function formatError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}

package/package.json

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