@bis-code/study-dash 0.2.0

package/server/dist/tools/curriculum.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+function getSession(sessions, sessionId) {
+    const key = sessionId || '_default';
+    if (!sessions.has(key)) {
+        sessions.set(key, { subjectId: null, topicId: null });
+    }
+    return sessions.get(key);
+}
+function err(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerCurriculumTools(server, svc, sessions, notify) {
+    // 1. learn_create_subject
+    server.tool('learn_create_subject', 'Create a new subject to study', {
+        name: z.string().describe('Subject name'),
+        language: z.string().optional().describe('Programming language (optional)'),
+        source: z.enum(['manual', 'roadmap', 'pdf']).optional().describe('Curriculum source'),
+    }, async ({ name, language, source }) => {
+        const subject = svc.createSubject(name, language, source);
+        notify();
+        return ok(`Created subject "${subject.name}" (id=${subject.id}, slug=${subject.slug})`);
+    });
+    // 2. learn_import_curriculum
+    server.tool('learn_import_curriculum', 'Import a curriculum (phases + topics) for a subject from JSON', {
+        subject_id: z.number().describe('Subject ID to import curriculum into'),
+        phases_json: z.string().describe('JSON array of phases, each with name, description, and topics array'),
+    }, async ({ subject_id, phases_json }) => {
+        let phases;
+        try {
+            phases = JSON.parse(phases_json);
+        }
+        catch {
+            return err('Invalid JSON in phases_json');
+        }
+        if (!Array.isArray(phases)) {
+            return err('phases_json must be a JSON array');
+        }
+        svc.importCurriculum(subject_id, phases);
+        notify();
+        return ok(`Imported ${phases.length} phase(s) into subject id=${subject_id}`);
+    });
+    // 3. learn_switch_subject
+    server.tool('learn_switch_subject', 'Switch the active subject for the session (by name or numeric ID)', {
+        subject: z.string().describe('Subject name or numeric ID'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ subject, session_id }) => {
+        const numId = Number(subject);
+        let resolved = isNaN(numId)
+            ? svc.findSubjectByName(subject)
+            : svc.getSubject(numId) ?? svc.findSubjectByName(subject);
+        if (!resolved) {
+            return err(`Subject not found: "${subject}"`);
+        }
+        const session = getSession(sessions, session_id);
+        session.subjectId = resolved.id;
+        session.topicId = null;
+        return ok(`Active subject: "${resolved.name}" (id=${resolved.id})`);
+    });
+    // 4. learn_set_topic
+    server.tool('learn_set_topic', 'Set the active topic for the session and mark it in_progress', {
+        topic: z.string().describe('Topic name or numeric ID'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ topic, session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.subjectId === null) {
+            return err('No active subject. Use learn_switch_subject first.');
+        }
+        const numId = Number(topic);
+        let resolved = isNaN(numId)
+            ? svc.findTopic(session.subjectId, topic)
+            : svc.getTopic(numId) ?? svc.findTopic(session.subjectId, topic);
+        if (!resolved) {
+            return err(`Topic not found: "${topic}"`);
+        }
+        svc.setTopicStatus(resolved.id, 'in_progress');
+        session.topicId = resolved.id;
+        notify();
+        return ok(`Active topic: "${resolved.name}" (id=${resolved.id}, status=in_progress)`);
+    });
+    // 5. learn_mark_done
+    server.tool('learn_mark_done', 'Mark a topic as done (defaults to the active session topic)', {
+        topic: z.string().optional().describe('Topic name or numeric ID (uses session topic if omitted)'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ topic, session_id }) => {
+        const session = getSession(sessions, session_id);
+        let topicId = null;
+        if (topic !== undefined) {
+            const numId = Number(topic);
+            const resolved = isNaN(numId)
+                ? (session.subjectId !== null ? svc.findTopic(session.subjectId, topic) : undefined)
+                : svc.getTopic(numId);
+            if (!resolved) {
+                return err(`Topic not found: "${topic}"`);
+            }
+            topicId = resolved.id;
+        }
+        else {
+            topicId = session.topicId;
+        }
+        if (topicId === null) {
+            return err('No topic specified and no active topic in session.');
+        }
+        const resolved = svc.getTopic(topicId);
+        if (!resolved) {
+            return err(`Topic id=${topicId} not found.`);
+        }
+        svc.setTopicStatus(topicId, 'done');
+        notify();
+        return ok(`Topic "${resolved.name}" marked as done.`);
+    });
+    // 6. learn_get_progress
+    server.tool('learn_get_progress', 'Get progress statistics for the active subject', {
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.subjectId === null) {
+            return err('No active subject. Use learn_switch_subject first.');
+        }
+        const progress = svc.getProgress(session.subjectId);
+        return ok(JSON.stringify(progress, null, 2));
+    });
+    // 7. learn_get_curriculum
+    server.tool('learn_get_curriculum', 'Get the full curriculum (phases + topics) for the active subject', {
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.subjectId === null) {
+            return err('No active subject. Use learn_switch_subject first.');
+        }
+        const curriculum = svc.getCurriculum(session.subjectId);
+        return ok(JSON.stringify(curriculum, null, 2));
+    });
+}
+//# sourceMappingURL=curriculum.js.map

package/server/dist/tools/curriculum.js.map

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

package/server/dist/tools/exercises.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ExerciseService } from '../services/exercises.js';
+import type { SessionState } from '../types.js';
+export declare function registerExerciseTools(server: McpServer, svc: ExerciseService, sessions: Map<string, SessionState>, notify: () => void): void;

package/server/dist/tools/exercises.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+function getSession(sessions, sessionId) {
+    const key = sessionId || '_default';
+    if (!sessions.has(key)) {
+        sessions.set(key, { subjectId: null, topicId: null });
+    }
+    return sessions.get(key);
+}
+function err(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerExerciseTools(server, svc, sessions, notify) {
+    // 1. learn_create_exercise
+    server.tool('learn_create_exercise', 'Create an exercise (coding, quiz, project, assignment) for the active topic', {
+        title: z.string().describe('Exercise title'),
+        type: z.enum(['coding', 'quiz', 'project', 'assignment']).describe('Exercise type'),
+        description: z.string().describe('Exercise description / instructions'),
+        difficulty: z.enum(['easy', 'medium', 'hard']).optional().describe('Difficulty level'),
+        est_minutes: z.number().optional().describe('Estimated time in minutes'),
+        source: z.enum(['ai', 'pdf_import']).optional().describe('Source of the exercise'),
+        starter_code: z.string().optional().describe('Starter code for coding/project exercises'),
+        test_content: z.string().optional().describe('Test code for coding/project exercises'),
+        quiz_json: z
+            .string()
+            .optional()
+            .describe('JSON string of QuizPayload for quiz exercises'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ title, type, description, difficulty, est_minutes, source, starter_code, test_content, quiz_json, session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.topicId === null) {
+            return err('No active topic. Use learn_set_topic first.');
+        }
+        const exercise = svc.createExercise(session.topicId, {
+            title,
+            type,
+            description,
+            difficulty,
+            est_minutes,
+            source,
+            starter_code,
+            test_content,
+            quiz_json,
+        });
+        notify();
+        return ok(`Created exercise "${exercise.title}" (id=${exercise.id}, type=${exercise.type})`);
+    });
+    // 2. learn_run_tests
+    server.tool('learn_run_tests', 'Run tests for a coding/project exercise and return results', {
+        exercise_id: z.number().describe('ID of the exercise to run tests for'),
+    }, async ({ exercise_id }) => {
+        try {
+            const results = await svc.runTests(exercise_id);
+            notify();
+            return ok(JSON.stringify(results, null, 2));
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return err(`Failed to run tests: ${msg}`);
+        }
+    });
+    // 3. learn_get_exercises
+    server.tool('learn_get_exercises', 'List all exercises for the active topic', {
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.topicId === null) {
+            return err('No active topic. Use learn_set_topic first.');
+        }
+        const exercises = svc.listForTopic(session.topicId);
+        return ok(JSON.stringify(exercises, null, 2));
+    });
+}
+//# sourceMappingURL=exercises.js.map

package/server/dist/tools/exercises.js.map

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

package/server/dist/tools/qa.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { QAService } from '../services/qa.js';
+import type { SessionState } from '../types.js';
+export declare function registerQATools(server: McpServer, svc: QAService, sessions: Map<string, SessionState>, notify: () => void): void;

package/server/dist/tools/qa.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+function getSession(sessions, sessionId) {
+    const key = sessionId || '_default';
+    if (!sessions.has(key)) {
+        sessions.set(key, { subjectId: null, topicId: null });
+    }
+    return sessions.get(key);
+}
+function err(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerQATools(server, svc, sessions, notify) {
+    // 1. learn_log_question
+    server.tool('learn_log_question', 'Log a question for the active topic', {
+        content: z.string().describe('The question text'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ content, session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.topicId === null) {
+            return err('No active topic. Use learn_set_topic first.');
+        }
+        const entry = svc.logEntry(session.topicId, 'question', content, session_id);
+        notify();
+        return ok(`Logged question (id=${entry.id})`);
+    });
+    // 2. learn_log_answer
+    server.tool('learn_log_answer', 'Log an answer or note for the active topic', {
+        content: z.string().describe('The answer or note text'),
+        question_id: z.number().optional().describe('ID of the question this answers (optional)'),
+        kind: z.enum(['answer', 'note']).optional().describe('Entry kind: answer or note (defaults to answer)'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ content, question_id, kind, session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.topicId === null) {
+            return err('No active topic. Use learn_set_topic first.');
+        }
+        const entryKind = kind ?? 'answer';
+        const entry = svc.logEntry(session.topicId, entryKind, content, session_id, question_id);
+        notify();
+        return ok(`Logged ${entryKind} (id=${entry.id})`);
+    });
+    // 3. learn_search
+    server.tool('learn_search', 'Full-text search across all entries', {
+        query: z.string().describe('Search query'),
+    }, async ({ query }) => {
+        const results = svc.search(query);
+        if (results.length === 0) {
+            return ok('No results found.');
+        }
+        return ok(JSON.stringify(results, null, 2));
+    });
+}
+//# sourceMappingURL=qa.js.map

package/server/dist/tools/qa.js.map

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

package/server/dist/tools/viz.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VizService } from '../services/viz.js';
+import type { SessionState } from '../types.js';
+export declare function registerVizTools(server: McpServer, svc: VizService, sessions: Map<string, SessionState>, notify: () => void): void;

package/server/dist/tools/viz.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+function getSession(sessions, sessionId) {
+    const key = sessionId || '_default';
+    if (!sessions.has(key)) {
+        sessions.set(key, { subjectId: null, topicId: null });
+    }
+    return sessions.get(key);
+}
+function err(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerVizTools(server, svc, sessions, notify) {
+    // 1. learn_create_viz
+    server.tool('learn_create_viz', 'Create a step-by-step HTML visualization for the active topic', {
+        title: z.string().describe('Title for the visualization'),
+        steps: z
+            .string()
+            .describe('JSON array of steps, each with { html: string, description: string }'),
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ title, steps, session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.topicId === null) {
+            return err('No active topic. Use learn_set_topic first.');
+        }
+        let parsedSteps;
+        try {
+            parsedSteps = JSON.parse(steps);
+        }
+        catch {
+            return err('Invalid JSON in steps parameter');
+        }
+        if (!Array.isArray(parsedSteps)) {
+            return err('steps must be a JSON array');
+        }
+        const viz = svc.create(session.topicId, title, parsedSteps);
+        notify();
+        return ok(`Created visualization "${viz.title}" (id=${viz.id})`);
+    });
+    // 2. learn_get_viz
+    server.tool('learn_get_viz', 'Get all visualizations for the active topic', {
+        session_id: z.string().optional().describe('Session identifier (defaults to _default)'),
+    }, async ({ session_id }) => {
+        const session = getSession(sessions, session_id);
+        if (session.topicId === null) {
+            return err('No active topic. Use learn_set_topic first.');
+        }
+        const vizList = svc.listForTopic(session.topicId);
+        return ok(JSON.stringify(vizList, null, 2));
+    });
+}
+//# sourceMappingURL=viz.js.map

package/server/dist/tools/viz.js.map

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

package/server/dist/types.d.ts

@@ -0,0 +1,103 @@
+export interface Subject {
+    id: number;
+    name: string;
+    slug: string;
+    language: string;
+    source: 'manual' | 'roadmap' | 'pdf';
+    created_at: string;
+}
+export interface Phase {
+    id: number;
+    subject_id: number;
+    name: string;
+    description: string;
+    sort_order: number;
+}
+export interface Topic {
+    id: number;
+    phase_id: number;
+    name: string;
+    description: string;
+    sort_order: number;
+    status: 'todo' | 'in_progress' | 'done';
+    updated_at: string;
+}
+export interface Entry {
+    id: number;
+    topic_id: number;
+    kind: 'question' | 'answer' | 'note';
+    content: string;
+    session_id: string;
+    question_id: number | null;
+    created_at: string;
+}
+export interface Visualization {
+    id: number;
+    topic_id: number;
+    title: string;
+    steps_json: string;
+    created_at: string;
+}
+export interface VizStep {
+    html: string;
+    description: string;
+}
+export interface Exercise {
+    id: number;
+    topic_id: number;
+    title: string;
+    type: 'coding' | 'quiz' | 'project' | 'assignment';
+    description: string;
+    difficulty: 'easy' | 'medium' | 'hard';
+    est_minutes: number;
+    source: 'ai' | 'pdf_import';
+    starter_code: string;
+    test_content: string;
+    quiz_json: string;
+    file_path: string;
+    status: 'pending' | 'in_progress' | 'passed' | 'failed';
+    created_at: string;
+}
+export interface ExerciseResult {
+    id: number;
+    exercise_id: number;
+    test_name: string;
+    passed: boolean;
+    output: string;
+    ran_at: string;
+}
+export interface QuizQuestion {
+    id: number;
+    text: string;
+    type: 'multiple_choice' | 'true_false' | 'fill_in';
+    options?: string[];
+    correct: number | boolean | string;
+    explanation: string;
+}
+export interface QuizPayload {
+    questions: QuizQuestion[];
+}
+export interface ProgressStats {
+    total_topics: number;
+    done: number;
+    in_progress: number;
+    todo: number;
+    total_entries: number;
+    total_exercises: number;
+    total_viz: number;
+}
+export interface PhaseWithTopics extends Phase {
+    topics: Topic[];
+}
+export interface TopicWithEntries extends Topic {
+    entries: Entry[];
+}
+export interface SessionState {
+    subjectId: number | null;
+    topicId: number | null;
+}
+export interface SSEEvent {
+    type: 'connected' | 'update' | 'test_result';
+    payload: Record<string, unknown>;
+    ts: string;
+}

package/server/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/server/dist/types.js.map

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

package/server/node_modules/better-sqlite3/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Joshua Wise
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/server/node_modules/better-sqlite3/README.md

@@ -0,0 +1,99 @@
+# better-sqlite3 [![Build Status](https://github.com/JoshuaWise/better-sqlite3/actions/workflows/build.yml/badge.svg)](https://github.com/JoshuaWise/better-sqlite3/actions/workflows/build.yml?query=branch%3Amaster)
+
+The fastest and simplest library for SQLite in Node.js.
+
+- Full transaction support
+- High performance, efficiency, and safety
+- Easy-to-use synchronous API *(better concurrency than an asynchronous API... yes, you read that correctly)*
+- Support for user-defined functions, aggregates, virtual tables, and extensions
+- 64-bit integers *(invisible until you need them)*
+- Worker thread support *(for large/slow queries)*
+
+## Help this project stay strong! 💪
+
+`better-sqlite3` is used by thousands of developers and engineers on a daily basis. Long nights and weekends were spent keeping this project strong and dependable, with no ask for compensation or funding, until now. If your company uses `better-sqlite3`, ask your manager to consider supporting the project:
+
+- [Become a GitHub sponsor](https://github.com/sponsors/JoshuaWise)
+- [Become a backer on Patreon](https://www.patreon.com/joshuawise)
+- [Make a one-time donation on PayPal](https://www.paypal.me/joshuathomaswise)
+
+## How other libraries compare
+
+|   |select 1 row  `get()` |select 100 rows   `all()`  |select 100 rows `iterate()` 1-by-1|insert 1 row `run()`|insert 100 rows in a transaction|
+|---|---|---|---|---|---|
+|better-sqlite3|1x|1x|1x|1x|1x|
+|[sqlite](https://www.npmjs.com/package/sqlite) and [sqlite3](https://www.npmjs.com/package/sqlite3)|11.7x slower|2.9x slower|24.4x slower|2.8x slower|15.6x slower|
+
+> You can verify these results by [running the benchmark yourself](./docs/benchmark.md).
+
+## Installation
+
+```bash
+npm install better-sqlite3
+```
+
+> Requires Node.js v14.21.1 or later. Prebuilt binaries are available for [LTS versions](https://nodejs.org/en/about/releases/). If you have trouble installing, check the [troubleshooting guide](./docs/troubleshooting.md).
+
+## Usage
+
+```js
+const db = require('better-sqlite3')('foobar.db', options);
+
+const row = db.prepare('SELECT * FROM users WHERE id = ?').get(userId);
+console.log(row.firstName, row.lastName, row.email);
+```
+
+Though not required, [it is generally important to set the WAL pragma for performance reasons](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/performance.md).
+
+```js
+db.pragma('journal_mode = WAL');
+```
+
+##### In ES6 module notation:
+
+```js
+import Database from 'better-sqlite3';
+const db = new Database('foobar.db', options);
+db.pragma('journal_mode = WAL');
+```
+
+## Why should I use this instead of [node-sqlite3](https://github.com/mapbox/node-sqlite3)?
+
+- `node-sqlite3` uses asynchronous APIs for tasks that are either CPU-bound or serialized. That's not only bad design, but it wastes tons of resources. It also causes [mutex thrashing](https://en.wikipedia.org/wiki/Resource_contention) which has devastating effects on performance.
+- `node-sqlite3` exposes low-level (C language) memory management functions. `better-sqlite3` does it the JavaScript way, allowing the garbage collector to worry about memory management.
+- `better-sqlite3` is simpler to use, and it provides nice utilities for some operations that are very difficult or impossible in `node-sqlite3`.
+- `better-sqlite3` is much faster than `node-sqlite3` in most cases, and just as fast in all other cases.
+
+#### When is this library not appropriate?
+
+In most cases, if you're attempting something that cannot be reasonably accomplished with `better-sqlite3`, it probably cannot be reasonably accomplished with SQLite in general. For example, if you're executing queries that take one second to complete, and you expect to have many concurrent users executing those queries, no amount of asynchronicity will save you from SQLite's serialized nature. Fortunately, SQLite is very *very* fast. With proper indexing, we've been able to achieve upward of 2000 queries per second with 5-way-joins in a 60 GB database, where each query was handling 5–50 kilobytes of real data.
+
+If you have a performance problem, the most likely causes are inefficient queries, improper indexing, or a lack of [WAL mode](./docs/performance.md)—not `better-sqlite3` itself. However, there are some cases where `better-sqlite3` could be inappropriate:
+
+- If you expect a high volume of concurrent reads each returning many megabytes of data (i.e., videos)
+- If you expect a high volume of concurrent writes (i.e., a social media site)
+- If your database's size is near the terabyte range
+
+For these situations, you should probably use a full-fledged RDBMS such as [PostgreSQL](https://www.postgresql.org/).
+
+## Upgrading
+
+Upgrading your `better-sqlite3` dependency can potentially introduce breaking changes, either in the `better-sqlite3` API (if you upgrade to a new [major version](https://semver.org/)), or between your existing database(s) and the underlying version of SQLite. Before upgrading, review:
+
+* [`better-sqlite3` release notes](https://github.com/WiseLibs/better-sqlite3/releases)
+* [SQLite release history](https://www.sqlite.org/changes.html)
+
+# Documentation
+
+- [API documentation](./docs/api.md)
+- [Performance](./docs/performance.md) (also see [benchmark results](./docs/benchmark.md))
+- [64-bit integer support](./docs/integer.md)
+- [Worker thread support](./docs/threads.md)
+- [Unsafe mode (advanced)](./docs/unsafe.md)
+- [SQLite compilation (advanced)](./docs/compilation.md)
+- [Contribution rules](./docs/contribution.md)
+- [Code of conduct](./docs/conduct.md)
+
+# License
+
+[MIT](./LICENSE)

package/server/node_modules/better-sqlite3/binding.gyp

@@ -0,0 +1,38 @@
+# ===
+# This is the main GYP file, which builds better-sqlite3 with SQLite itself.
+# ===
+
+{
+  'includes': ['deps/common.gypi'],
+  'targets': [
+    {
+      'target_name': 'better_sqlite3',
+      'dependencies': ['deps/sqlite3.gyp:sqlite3'],
+      'sources': ['src/better_sqlite3.cpp'],
+      'cflags_cc': ['-std=c++20'],
+      'xcode_settings': {
+        'OTHER_CPLUSPLUSFLAGS': ['-std=c++20', '-stdlib=libc++'],
+      },
+      'msvs_settings': {
+        'VCCLCompilerTool': {
+          'AdditionalOptions': [
+            '/std:c++20',
+          ],
+        },
+      },
+      'conditions': [
+        ['OS=="linux"', {
+          'ldflags': [
+            '-Wl,-Bsymbolic',
+            '-Wl,--exclude-libs,ALL',
+          ],
+        }],
+      ],
+    },
+    {
+      'target_name': 'test_extension',
+      'dependencies': ['deps/sqlite3.gyp:sqlite3'],
+      'conditions': [['sqlite3 == ""', { 'sources': ['deps/test_extension.c'] }]],
+    },
+  ],
+}