@lti-tool/core 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @lti-tool/core
 
+## 1.0.2
+
+### Patch Changes
+
+- 96f0075: Package updates
+
+## 1.0.1
+
+### Patch Changes
+
+- 162f5e0: Initial commit of production MySql storage adapter.
+
 ## 1.0.0
 
 ### Major Changes

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './interfaces/index.js';
 export * from './schemas/index.js';
+export { isServerlessEnvironment } from './utils/environment.js';
 export { LTITool } from './ltiTool.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export * from './interfaces/index.js';
 export * from './schemas/index.js';
+export { isServerlessEnvironment } from './utils/environment.js';
 export { LTITool } from './ltiTool.js';

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/dist/utils/environment.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Detects if the application is running in a serverless environment.
+ *
+ * Checks for environment variables commonly set by serverless platforms:
+ * - AWS Lambda: AWS_LAMBDA_FUNCTION_NAME, AWS_EXECUTION_ENV, LAMBDA_TASK_ROOT
+ * - Google Cloud Functions/Run: FUNCTION_NAME, FUNCTION_TARGET, K_SERVICE
+ * - Azure Functions: FUNCTIONS_WORKER_RUNTIME, AZURE_FUNCTIONS_ENVIRONMENT
+ * - Vercel: VERCEL, VERCEL_ENV
+ * - Netlify Functions: NETLIFY
+ *
+ * @returns true if serverless environment detected, false otherwise
+ */
+export declare function isServerlessEnvironment(): boolean;
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/utils/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAoBjD"}

package/dist/utils/environment.js

@@ -0,0 +1,30 @@
+/**
+ * Detects if the application is running in a serverless environment.
+ *
+ * Checks for environment variables commonly set by serverless platforms:
+ * - AWS Lambda: AWS_LAMBDA_FUNCTION_NAME, AWS_EXECUTION_ENV, LAMBDA_TASK_ROOT
+ * - Google Cloud Functions/Run: FUNCTION_NAME, FUNCTION_TARGET, K_SERVICE
+ * - Azure Functions: FUNCTIONS_WORKER_RUNTIME, AZURE_FUNCTIONS_ENVIRONMENT
+ * - Vercel: VERCEL, VERCEL_ENV
+ * - Netlify Functions: NETLIFY
+ *
+ * @returns true if serverless environment detected, false otherwise
+ */
+export function isServerlessEnvironment() {
+    return !!(
+    // AWS Lambda
+    (process.env.AWS_LAMBDA_FUNCTION_NAME ||
+        process.env.AWS_EXECUTION_ENV ||
+        process.env.LAMBDA_TASK_ROOT ||
+        // Google Cloud Functions / Cloud Run
+        process.env.FUNCTION_NAME ||
+        process.env.FUNCTION_TARGET ||
+        process.env.K_SERVICE ||
+        // Azure Functions
+        process.env.FUNCTIONS_WORKER_RUNTIME ||
+        process.env.AZURE_FUNCTIONS_ENVIRONMENT ||
+        // Vercel
+        process.env.VERCEL ||
+        // Netlify Functions
+        process.env.NETLIFY));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lti-tool/core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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/index.ts

@@ -1,3 +1,4 @@
 export * from './interfaces/index.js';
 export * from './schemas/index.js';
+export { isServerlessEnvironment } from './utils/environment.js';
 export { LTITool } from './ltiTool.js';

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));
+}

package/src/utils/environment.ts

@@ -0,0 +1,33 @@
+/**
+ * Detects if the application is running in a serverless environment.
+ *
+ * Checks for environment variables commonly set by serverless platforms:
+ * - AWS Lambda: AWS_LAMBDA_FUNCTION_NAME, AWS_EXECUTION_ENV, LAMBDA_TASK_ROOT
+ * - Google Cloud Functions/Run: FUNCTION_NAME, FUNCTION_TARGET, K_SERVICE
+ * - Azure Functions: FUNCTIONS_WORKER_RUNTIME, AZURE_FUNCTIONS_ENVIRONMENT
+ * - Vercel: VERCEL, VERCEL_ENV
+ * - Netlify Functions: NETLIFY
+ *
+ * @returns true if serverless environment detected, false otherwise
+ */
+export function isServerlessEnvironment(): boolean {
+  return !!(
+    // AWS Lambda
+    (
+      process.env.AWS_LAMBDA_FUNCTION_NAME ||
+      process.env.AWS_EXECUTION_ENV ||
+      process.env.LAMBDA_TASK_ROOT ||
+      // Google Cloud Functions / Cloud Run
+      process.env.FUNCTION_NAME ||
+      process.env.FUNCTION_TARGET ||
+      process.env.K_SERVICE ||
+      // Azure Functions
+      process.env.FUNCTIONS_WORKER_RUNTIME ||
+      process.env.AZURE_FUNCTIONS_ENVIRONMENT ||
+      // Vercel
+      process.env.VERCEL ||
+      // Netlify Functions
+      process.env.NETLIFY
+    )
+  );
+}