learngraph 0.4.0 → 0.7.0

package/dist/cjs/api/routes/skills.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Skill routes
+ *
+ * CRUD operations and graph traversal for skills.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillRoutes = createSkillRoutes;
+const hono_1 = require("hono");
+const server_js_1 = require("../server.js");
+const index_js_1 = require("../../types/index.js");
+/**
+ * Create skill routes
+ */
+function createSkillRoutes(ctx) {
+    const app = new hono_1.Hono();
+    // ─────────────────────────────────────────────────────────────────────────
+    // List Skills
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/', async (c) => {
+        try {
+            const page = Number(c.req.query('page')) || 1;
+            const pageSize = Number(c.req.query('pageSize')) || 50;
+            const search = c.req.query('search');
+            const bloomLevel = c.req.query('bloomLevel');
+            const sortBy = c.req.query('sortBy');
+            const sortOrder = c.req.query('sortOrder');
+            // Get tags as array
+            const tagsParam = c.req.query('tags');
+            const tags = tagsParam ? tagsParam.split(',') : undefined;
+            const skills = await ctx.storage.findSkills({});
+            // Apply filters
+            let filtered = skills;
+            if (search) {
+                const searchLower = search.toLowerCase();
+                filtered = filtered.filter((s) => s.name.toLowerCase().includes(searchLower) ||
+                    s.description.toLowerCase().includes(searchLower));
+            }
+            if (bloomLevel) {
+                filtered = filtered.filter((s) => s.bloomLevel === bloomLevel);
+            }
+            if (tags && tags.length > 0) {
+                filtered = filtered.filter((s) => tags.some((tag) => s.tags.includes(tag)));
+            }
+            // Sort
+            if (sortBy) {
+                filtered.sort((a, b) => {
+                    const order = sortOrder === 'desc' ? -1 : 1;
+                    switch (sortBy) {
+                        case 'name':
+                            return order * a.name.localeCompare(b.name);
+                        case 'difficulty':
+                            return order * (a.difficulty - b.difficulty);
+                        case 'createdAt':
+                            return order * (new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+                        case 'updatedAt':
+                            return order * (new Date(a.updatedAt).getTime() - new Date(b.updatedAt).getTime());
+                        default:
+                            return 0;
+                    }
+                });
+            }
+            // Paginate
+            const start = (page - 1) * pageSize;
+            const paginated = filtered.slice(start, start + pageSize);
+            return c.json((0, server_js_1.success)(paginated, {
+                total: filtered.length,
+                page,
+                pageSize,
+                hasMore: start + paginated.length < filtered.length,
+            }));
+        }
+        catch (err) {
+            console.error('List skills error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to list skills'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Get Skill by ID
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/:id', async (c) => {
+        try {
+            const idParam = c.req.param('id');
+            const skillId = (0, index_js_1.createSkillId)(idParam);
+            const skill = await ctx.storage.getSkill(skillId);
+            if (!skill) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${idParam}`), 404);
+            }
+            // Check for expansions
+            const expand = c.req.query('expand')?.split(',') || [];
+            const result = { ...skill };
+            if (expand.includes('prerequisites')) {
+                const edges = await ctx.storage.findPrerequisites({ targetId: skillId });
+                result.prerequisites = await Promise.all(edges.map(async (e) => {
+                    const prereq = await ctx.storage.getSkill(e.sourceId);
+                    return {
+                        id: e.sourceId,
+                        name: prereq?.name || 'Unknown',
+                        strength: e.strength,
+                    };
+                }));
+            }
+            if (expand.includes('dependents')) {
+                const edges = await ctx.storage.findPrerequisites({ sourceId: skillId });
+                result.dependents = await Promise.all(edges.map(async (e) => {
+                    const dep = await ctx.storage.getSkill(e.targetId);
+                    return {
+                        id: e.targetId,
+                        name: dep?.name || 'Unknown',
+                        strength: e.strength,
+                    };
+                }));
+            }
+            return c.json((0, server_js_1.success)(result));
+        }
+        catch (err) {
+            console.error('Get skill error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to get skill'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Create Skill
+    // ─────────────────────────────────────────────────────────────────────────
+    app.post('/', async (c) => {
+        try {
+            const body = await c.req.json();
+            if (!body.name || !body.description || !body.bloomLevel) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.VALIDATION_ERROR, 'name, description, and bloomLevel are required'), 400);
+            }
+            const skill = await ctx.storage.createSkill({
+                name: body.name,
+                description: body.description,
+                bloomLevel: body.bloomLevel,
+                difficulty: body.difficulty ?? 0.5,
+                isThresholdConcept: body.isThresholdConcept ?? false,
+                masteryThreshold: body.masteryThreshold ?? 0.8,
+                estimatedMinutes: body.estimatedMinutes ?? 30,
+                tags: body.tags ?? [],
+                metadata: body.metadata ?? {},
+            });
+            return c.json((0, server_js_1.success)(skill), 201);
+        }
+        catch (err) {
+            console.error('Create skill error:', err);
+            if (err instanceof Error && err.message.includes('already exists')) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.CONFLICT, err.message), 409);
+            }
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to create skill'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Update Skill
+    // ─────────────────────────────────────────────────────────────────────────
+    app.put('/:id', async (c) => {
+        try {
+            const idParam = c.req.param('id');
+            const skillId = (0, index_js_1.createSkillId)(idParam);
+            const body = await c.req.json();
+            const existing = await ctx.storage.getSkill(skillId);
+            if (!existing) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${idParam}`), 404);
+            }
+            const updated = await ctx.storage.updateSkill(skillId, body);
+            return c.json((0, server_js_1.success)(updated));
+        }
+        catch (err) {
+            console.error('Update skill error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to update skill'), 500);
+        }
+    });
+    app.patch('/:id', async (c) => {
+        try {
+            const idParam = c.req.param('id');
+            const skillId = (0, index_js_1.createSkillId)(idParam);
+            const body = await c.req.json();
+            const existing = await ctx.storage.getSkill(skillId);
+            if (!existing) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${idParam}`), 404);
+            }
+            const updated = await ctx.storage.updateSkill(skillId, body);
+            return c.json((0, server_js_1.success)(updated));
+        }
+        catch (err) {
+            console.error('Update skill error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to update skill'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Delete Skill
+    // ─────────────────────────────────────────────────────────────────────────
+    app.delete('/:id', async (c) => {
+        try {
+            const idParam = c.req.param('id');
+            const skillId = (0, index_js_1.createSkillId)(idParam);
+            const existing = await ctx.storage.getSkill(skillId);
+            if (!existing) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${idParam}`), 404);
+            }
+            await ctx.storage.deleteSkill(skillId);
+            return c.json((0, server_js_1.success)({ deleted: true }));
+        }
+        catch (err) {
+            console.error('Delete skill error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to delete skill'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Get All Prerequisites (Recursive)
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/:id/prerequisites', async (c) => {
+        try {
+            const idParam = c.req.param('id');
+            const skillId = (0, index_js_1.createSkillId)(idParam);
+            const maxDepth = Number(c.req.query('depth')) || 10;
+            const skill = await ctx.storage.getSkill(skillId);
+            if (!skill) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${idParam}`), 404);
+            }
+            // BFS to get all prerequisites
+            const prerequisites = [];
+            const visited = new Set();
+            const queue = [{ skillId, depth: 0 }];
+            while (queue.length > 0) {
+                const current = queue.shift();
+                if (current.depth >= maxDepth)
+                    continue;
+                const edges = await ctx.storage.findPrerequisites({ targetId: current.skillId });
+                for (const edge of edges) {
+                    const sourceIdStr = String(edge.sourceId);
+                    if (!visited.has(sourceIdStr)) {
+                        visited.add(sourceIdStr);
+                        const prereqSkill = await ctx.storage.getSkill(edge.sourceId);
+                        if (prereqSkill) {
+                            prerequisites.push({
+                                id: edge.sourceId,
+                                name: prereqSkill.name,
+                                bloomLevel: prereqSkill.bloomLevel,
+                                strength: edge.strength,
+                                depth: current.depth + 1,
+                            });
+                            queue.push({ skillId: edge.sourceId, depth: current.depth + 1 });
+                        }
+                    }
+                }
+            }
+            // Sort by depth
+            prerequisites.sort((a, b) => a.depth - b.depth);
+            const response = {
+                skillId,
+                skillName: skill.name,
+                prerequisites,
+                depth: maxDepth,
+            };
+            return c.json((0, server_js_1.success)(response));
+        }
+        catch (err) {
+            console.error('Get prerequisites error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to get prerequisites'), 500);
+        }
+    });
+    // ─────────────────────────────────────────────────────────────────────────
+    // Get All Dependents (Recursive)
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/:id/dependents', async (c) => {
+        try {
+            const idParam = c.req.param('id');
+            const skillId = (0, index_js_1.createSkillId)(idParam);
+            const maxDepth = Number(c.req.query('depth')) || 10;
+            const skill = await ctx.storage.getSkill(skillId);
+            if (!skill) {
+                return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.NOT_FOUND, `Skill not found: ${idParam}`), 404);
+            }
+            // BFS to get all dependents
+            const dependents = [];
+            const visited = new Set();
+            const queue = [{ skillId, depth: 0 }];
+            while (queue.length > 0) {
+                const current = queue.shift();
+                if (current.depth >= maxDepth)
+                    continue;
+                const edges = await ctx.storage.findPrerequisites({ sourceId: current.skillId });
+                for (const edge of edges) {
+                    const targetIdStr = String(edge.targetId);
+                    if (!visited.has(targetIdStr)) {
+                        visited.add(targetIdStr);
+                        const depSkill = await ctx.storage.getSkill(edge.targetId);
+                        if (depSkill) {
+                            dependents.push({
+                                id: edge.targetId,
+                                name: depSkill.name,
+                                bloomLevel: depSkill.bloomLevel,
+                                strength: edge.strength,
+                                depth: current.depth + 1,
+                            });
+                            queue.push({ skillId: edge.targetId, depth: current.depth + 1 });
+                        }
+                    }
+                }
+            }
+            // Sort by depth
+            dependents.sort((a, b) => a.depth - b.depth);
+            const response = {
+                skillId,
+                skillName: skill.name,
+                dependents,
+                depth: maxDepth,
+            };
+            return c.json((0, server_js_1.success)(response));
+        }
+        catch (err) {
+            console.error('Get dependents error:', err);
+            return c.json((0, server_js_1.error)(server_js_1.ErrorCodes.INTERNAL_ERROR, 'Failed to get dependents'), 500);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=skills.js.map

package/dist/cjs/api/routes/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../../src/api/routes/skills.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/server.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * LearnGraph REST API Server
+ *
+ * Hono-based REST API for skill graphs, learners, and assessments.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCodes = void 0;
+exports.success = success;
+exports.error = error;
+exports.createApiServer = createApiServer;
+const hono_1 = require("hono");
+const cors_1 = require("hono/cors");
+const logger_1 = require("hono/logger");
+const pretty_json_1 = require("hono/pretty-json");
+const timing_1 = require("hono/timing");
+const skills_js_1 = require("./routes/skills.js");
+const edges_js_1 = require("./routes/edges.js");
+const learners_js_1 = require("./routes/learners.js");
+const me_js_1 = require("./routes/me.js");
+const explore_js_1 = require("./routes/explore.js");
+const assessments_js_1 = require("./routes/assessments.js");
+const analytics_js_1 = require("./routes/analytics.js");
+const curriculum_js_1 = require("./routes/curriculum.js");
+// ─────────────────────────────────────────────────────────────────────────────
+// Response Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create success response
+ */
+function success(data, meta) {
+    const response = {
+        success: true,
+        data,
+    };
+    if (meta) {
+        response.meta = meta;
+    }
+    return response;
+}
+/**
+ * Create error response
+ */
+function error(code, message, details) {
+    const errorObj = {
+        code,
+        message,
+    };
+    if (details) {
+        errorObj.details = details;
+    }
+    return {
+        success: false,
+        error: errorObj,
+    };
+}
+/**
+ * Common error codes
+ */
+exports.ErrorCodes = {
+    NOT_FOUND: 'NOT_FOUND',
+    BAD_REQUEST: 'BAD_REQUEST',
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    FORBIDDEN: 'FORBIDDEN',
+    CONFLICT: 'CONFLICT',
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Server Factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create the LearnGraph API server
+ *
+ * @example
+ * ```typescript
+ * import { createApiServer } from 'learngraph/api';
+ * import { MemoryStorage } from 'learngraph/storage';
+ *
+ * const storage = new MemoryStorage();
+ * await storage.connect({ backend: 'memory' });
+ *
+ * const app = createApiServer({ storage });
+ *
+ * // Start with Bun
+ * export default app;
+ *
+ * // Or with Node.js
+ * import { serve } from '@hono/node-server';
+ * serve({ fetch: app.fetch, port: 3000 });
+ * ```
+ */
+function createApiServer(config) {
+    const app = new hono_1.Hono();
+    const basePath = config.basePath ?? '/api';
+    const ctx = {
+        storage: config.storage,
+    };
+    if (config.getCurrentUserId) {
+        ctx.getCurrentUserId = config.getCurrentUserId;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Middleware
+    // ─────────────────────────────────────────────────────────────────────────
+    // CORS
+    if (config.cors !== false) {
+        app.use('*', (0, cors_1.cors)({
+            origin: config.corsOrigins ?? '*',
+            allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'],
+            allowHeaders: ['Content-Type', 'Authorization'],
+        }));
+    }
+    // Logging
+    if (config.logging !== false) {
+        app.use('*', (0, logger_1.logger)());
+    }
+    // Timing headers
+    if (config.timing !== false) {
+        app.use('*', (0, timing_1.timing)());
+    }
+    // Pretty JSON (dev mode)
+    if (config.prettyJson) {
+        app.use('*', (0, pretty_json_1.prettyJSON)());
+    }
+    // Custom auth middleware
+    if (config.authMiddleware) {
+        app.use('*', config.authMiddleware);
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Health Check
+    // ─────────────────────────────────────────────────────────────────────────
+    app.get('/health', (c) => c.json({
+        status: 'healthy',
+        timestamp: new Date().toISOString(),
+        version: '0.5.0',
+    }));
+    // ─────────────────────────────────────────────────────────────────────────
+    // Mount Routes
+    // ─────────────────────────────────────────────────────────────────────────
+    const api = new hono_1.Hono();
+    // Skills CRUD + Graph Traversal
+    api.route('/skills', (0, skills_js_1.createSkillRoutes)(ctx));
+    // Edges CRUD
+    api.route('/edges', (0, edges_js_1.createEdgeRoutes)(ctx));
+    // Learners CRUD + Mastery
+    api.route('/learners', (0, learners_js_1.createLearnerRoutes)(ctx));
+    // Student self-service (/me)
+    api.route('/me', (0, me_js_1.createMeRoutes)(ctx));
+    // Public skill exploration
+    api.route('/explore', (0, explore_js_1.createExploreRoutes)(ctx));
+    // Assessments & Sessions
+    api.route('/assessments', (0, assessments_js_1.createAssessmentRoutes)(ctx));
+    api.route('/questions', (0, assessments_js_1.createAssessmentRoutes)(ctx)); // Alias
+    // Curriculum management
+    api.route('/curriculum', (0, curriculum_js_1.createCurriculumRoutes)(ctx));
+    // Analytics
+    api.route('/analytics', (0, analytics_js_1.createAnalyticsRoutes)(ctx));
+    // Mount API routes at base path
+    app.route(basePath, api);
+    // ─────────────────────────────────────────────────────────────────────────
+    // Error Handling
+    // ─────────────────────────────────────────────────────────────────────────
+    app.onError((err, c) => {
+        console.error('API Error:', err);
+        // Handle known error types
+        if (err.message.includes('not found')) {
+            return c.json(error(exports.ErrorCodes.NOT_FOUND, err.message), 404);
+        }
+        if (err.message.includes('already exists')) {
+            return c.json(error(exports.ErrorCodes.CONFLICT, err.message), 409);
+        }
+        if (err.message.includes('validation') || err.message.includes('invalid')) {
+            return c.json(error(exports.ErrorCodes.VALIDATION_ERROR, err.message), 400);
+        }
+        // Generic internal error
+        return c.json(error(exports.ErrorCodes.INTERNAL_ERROR, 'An unexpected error occurred'), 500);
+    });
+    app.notFound((c) => {
+        return c.json(error(exports.ErrorCodes.NOT_FOUND, `Route not found: ${c.req.path}`), 404);
+    });
+    return app;
+}
+//# sourceMappingURL=server.js.map

package/dist/cjs/api/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/api/server.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * REST API Types
+ *
+ * Type definitions for the LearnGraph REST API.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}