@lti-tool/core 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @lti-tool/core
 
+## 1.0.3
+
+### Patch Changes
+
+- adf5f88: Add link to documentation site for all packages
+
+## 1.0.2
+
+### Patch Changes
+
+- 96f0075: Package updates
+
 ## 1.0.1
 
 ### Patch Changes

package/README.md

@@ -47,7 +47,7 @@ const session = await ltiTool.createSession(payload);
 
 ## Documentation
 
-- [API Reference](https://lti-tool.dev/docs) - (Coming soon) Complete API documentation
+- [API Reference](https://docs.lti-tool.dev) - Complete API documentation
 - [Examples](https://github.com/lti-tool/lti-tool-examples) - (Coming soon) Working examples
 
 ## Security

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

@@ -1 +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,CA4G1E"}
+{"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;AAU3D;;;;;;GAMG;AAEH,wBAAgB,aAAa,CAAC,eAAe,EAAE,eAAe,GAAG,UAAU,CAkG1E"}

package/dist/services/session.service.js

@@ -1,3 +1,10 @@
+const ROLE_MAPPINGS = {
+    Instructor: 'instructor',
+    Learner: 'student',
+    Administrator: 'admin',
+    ContentDeveloper: 'content-developer',
+    Member: 'member',
+};
 /**
  * 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.
@@ -5,7 +12,7 @@
  * @param lti13JwtPayload - Validated LTI 1.3 JWT payload from successful launch
  * @returns Complete LTI session object with user, context, and service information
  */
-// oxlint-disable-next-line max-lines-per-function
+// oxlint-disable-next-line max-lines-per-function complexity -- flat data mapping
 export function createSession(lti13JwtPayload) {
     const roles = lti13JwtPayload['https://purl.imsglobal.org/spec/lti/claim/roles'] || [];
     const context = lti13JwtPayload['https://purl.imsglobal.org/spec/lti/claim/context'];
@@ -15,9 +22,9 @@ export function createSession(lti13JwtPayload) {
     const agsEndpoint = lti13JwtPayload['https://purl.imsglobal.org/spec/lti-ags/claim/endpoint'];
     const nrpsService = lti13JwtPayload['https://purl.imsglobal.org/spec/lti-nrps/claim/namesroleservice'];
     const deepLinkingSettings = lti13JwtPayload['https://purl.imsglobal.org/spec/lti-dl/claim/deep_linking_settings'];
-    const isInstructor = roles.some((role) => role.includes('Instructor'));
-    const isStudent = roles.some((role) => role.includes('Learner'));
-    const isAdmin = roles.some((role) => role.includes('Administrator'));
+    const isInstructor = hasRole(roles, 'Instructor');
+    const isStudent = hasRole(roles, 'Learner');
+    const isAdmin = hasRole(roles, 'Administrator');
     const services = {};
     if (agsEndpoint) {
         let lineItemUrl;
@@ -48,21 +55,7 @@ export function createSession(lti13JwtPayload) {
         };
     }
     // Extract simplified roles
-    const simplifiedRoles = [];
-    for (const role of roles) {
-        if (role.includes('Instructor'))
-            simplifiedRoles.push('instructor');
-        if (role.includes('Learner'))
-            simplifiedRoles.push('student');
-        if (role.includes('Administrator'))
-            simplifiedRoles.push('admin');
-        if (role.includes('ContentDeveloper'))
-            simplifiedRoles.push('content-developer');
-        if (role.includes('Member'))
-            simplifiedRoles.push('member');
-    }
-    // Remove duplicates
-    const uniqueRoles = [...new Set(simplifiedRoles)];
+    const simplifiedRoles = simplifyRoles(roles);
     return {
         jwtPayload: lti13JwtPayload,
         id: crypto.randomUUID(),
@@ -72,7 +65,7 @@ export function createSession(lti13JwtPayload) {
             email: lti13JwtPayload.email,
             familyName: lti13JwtPayload.family_name,
             givenName: lti13JwtPayload.given_name,
-            roles: uniqueRoles,
+            roles: simplifiedRoles,
         },
         context: {
             id: context?.id || '',
@@ -106,3 +99,17 @@ export function createSession(lti13JwtPayload) {
         isNameAndRolesAvailable: !!nrpsService,
     };
 }
+function simplifyRoles(roles) {
+    const simplified = new Set();
+    for (const role of roles) {
+        for (const [key, value] of Object.entries(ROLE_MAPPINGS)) {
+            if (role.includes(key)) {
+                simplified.add(value);
+            }
+        }
+    }
+    return [...simplified];
+}
+function hasRole(roles, pattern) {
+    return roles.some((role) => role.includes(pattern));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lti-tool/core",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "LTI 1.3 implementation for Node.js",
   "keywords": [
     "lti",
@@ -36,8 +36,8 @@
     "test": "vitest"
   },
   "dependencies": {
-    "jose": "^6.1.2",
-    "zod": "^4.1.12"
+    "jose": "^6.1.3",
+    "zod": "^4.3.5"
   },
   "peerDependencies": {
     "pino": "^9.11.0"
@@ -48,6 +48,6 @@
     }
   },
   "devDependencies": {
-    "pino": "^10.1.0"
+    "pino": "^10.2.0"
   }
 }

package/src/services/session.service.ts

@@ -1,6 +1,14 @@
 import type { LTISession } from '../interfaces/ltiSession.js';
 import type { LTI13JwtPayload } from '../schemas/index.js';
 
+const ROLE_MAPPINGS: Record<string, string> = {
+  Instructor: 'instructor',
+  Learner: 'student',
+  Administrator: 'admin',
+  ContentDeveloper: 'content-developer',
+  Member: 'member',
+};
+
 /**
  * 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.
@@ -8,7 +16,7 @@ import type { LTI13JwtPayload } from '../schemas/index.js';
  * @param lti13JwtPayload - Validated LTI 1.3 JWT payload from successful launch
  * @returns Complete LTI session object with user, context, and service information
  */
-// oxlint-disable-next-line max-lines-per-function
+// oxlint-disable-next-line max-lines-per-function complexity -- flat data mapping
 export function createSession(lti13JwtPayload: LTI13JwtPayload): LTISession {
   const roles = lti13JwtPayload['https://purl.imsglobal.org/spec/lti/claim/roles'] || [];
   const context = lti13JwtPayload['https://purl.imsglobal.org/spec/lti/claim/context'];
@@ -25,9 +33,9 @@ export function createSession(lti13JwtPayload: LTI13JwtPayload): LTISession {
   const deepLinkingSettings =
     lti13JwtPayload['https://purl.imsglobal.org/spec/lti-dl/claim/deep_linking_settings'];
 
-  const isInstructor = roles.some((role) => role.includes('Instructor'));
-  const isStudent = roles.some((role) => role.includes('Learner'));
-  const isAdmin = roles.some((role) => role.includes('Administrator'));
+  const isInstructor = hasRole(roles, 'Instructor');
+  const isStudent = hasRole(roles, 'Learner');
+  const isAdmin = hasRole(roles, 'Administrator');
 
   const services: Record<string, unknown> = {};
   if (agsEndpoint) {
@@ -61,17 +69,7 @@ export function createSession(lti13JwtPayload: LTI13JwtPayload): LTISession {
   }
 
   // Extract simplified roles
-  const simplifiedRoles: string[] = [];
-  for (const role of roles) {
-    if (role.includes('Instructor')) simplifiedRoles.push('instructor');
-    if (role.includes('Learner')) simplifiedRoles.push('student');
-    if (role.includes('Administrator')) simplifiedRoles.push('admin');
-    if (role.includes('ContentDeveloper')) simplifiedRoles.push('content-developer');
-    if (role.includes('Member')) simplifiedRoles.push('member');
-  }
-
-  // Remove duplicates
-  const uniqueRoles = [...new Set(simplifiedRoles)];
+  const simplifiedRoles = simplifyRoles(roles);
 
   return {
     jwtPayload: lti13JwtPayload,
@@ -82,7 +80,7 @@ export function createSession(lti13JwtPayload: LTI13JwtPayload): LTISession {
       email: lti13JwtPayload.email,
       familyName: lti13JwtPayload.family_name,
       givenName: lti13JwtPayload.given_name,
-      roles: uniqueRoles,
+      roles: simplifiedRoles,
     },
     context: {
       id: context?.id || '',
@@ -118,3 +116,19 @@ export function createSession(lti13JwtPayload: LTI13JwtPayload): LTISession {
     isNameAndRolesAvailable: !!nrpsService,
   };
 }
+
+function simplifyRoles(roles: string[]): string[] {
+  const simplified = new Set<string>();
+  for (const role of roles) {
+    for (const [key, value] of Object.entries(ROLE_MAPPINGS)) {
+      if (role.includes(key)) {
+        simplified.add(value);
+      }
+    }
+  }
+  return [...simplified];
+}
+
+function hasRole(roles: string[], pattern: string): boolean {
+  return roles.some((role) => role.includes(pattern));
+}