paper-manager 0.3.0 → 0.4.0

package/dist/config/init.test.js

@@ -0,0 +1,61 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { getFilesDir, getProjectDataDir, getVectorStoreDir } from "./index.js";
+import { initScope } from "./init.js";
+// initScope() uses getProjectDataDir() which is a module-level constant resolved at import time.
+// This means process.chdir() cannot redirect it. We must clean up the actual project data dir
+// between tests to ensure isolation.
+let origCwd;
+beforeEach(() => {
+    origCwd = process.cwd();
+    const projectDir = getProjectDataDir();
+    if (fs.existsSync(projectDir)) {
+        fs.rmSync(projectDir, { recursive: true, force: true });
+    }
+});
+afterEach(() => {
+    process.chdir(origCwd);
+    const projectDir = getProjectDataDir();
+    if (fs.existsSync(projectDir)) {
+        fs.rmSync(projectDir, { recursive: true, force: true });
+    }
+});
+describe("initScope (project scope)", () => {
+    it("creates all expected files and directories on first run", () => {
+        const result = initScope();
+        const baseDir = result.baseDir;
+        // All items should be "created"
+        expect(result.items.every((item) => item.status === "created")).toBe(true);
+        expect(result.items).toHaveLength(5);
+        // Verify filesystem
+        expect(fs.existsSync(baseDir)).toBe(true);
+        expect(fs.existsSync(path.join(baseDir, "config.json"))).toBe(true);
+        expect(fs.existsSync(path.join(baseDir, "papers.db"))).toBe(true);
+        expect(fs.existsSync(getFilesDir(baseDir))).toBe(true);
+        expect(fs.existsSync(getVectorStoreDir(baseDir))).toBe(true);
+    });
+    it("config.json contains $schema field", () => {
+        const result = initScope();
+        const configContent = fs.readFileSync(path.join(result.baseDir, "config.json"), "utf-8");
+        const config = JSON.parse(configContent);
+        expect(config["$schema"]).toContain("config.schema.json");
+    });
+    it("is idempotent — second run reports all items as exists", () => {
+        initScope();
+        const result = initScope();
+        expect(result.items.every((item) => item.status === "exists")).toBe(true);
+        expect(result.items).toHaveLength(5);
+    });
+    it("preserves existing config.json content on second run", () => {
+        const result = initScope();
+        const configPath = path.join(result.baseDir, "config.json");
+        // Write custom content
+        fs.writeFileSync(configPath, JSON.stringify({ custom: "data" }));
+        // Second init should not overwrite
+        initScope();
+        const content = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        expect(content["custom"]).toBe("data");
+    });
+});
+//# sourceMappingURL=init.test.js.map

package/dist/config/init.test.js.map

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

package/dist/db/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/db/index.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it } from "vitest";
+import { dbRowToKnowledgeBase, dbRowToLiterature, isRecord } from "./index.js";
+// ─── isRecord ────────────────────────────────────────────────
+describe("isRecord", () => {
+    it("returns true for plain objects", () => {
+        expect(isRecord({})).toBe(true);
+        expect(isRecord({ a: 1 })).toBe(true);
+    });
+    it("returns false for arrays", () => {
+        expect(isRecord([])).toBe(false);
+        expect(isRecord([1, 2])).toBe(false);
+    });
+    it("returns false for primitives and null", () => {
+        expect(isRecord(null)).toBe(false);
+        expect(isRecord(undefined)).toBe(false);
+        expect(isRecord(42)).toBe(false);
+        expect(isRecord("string")).toBe(false);
+        expect(isRecord(true)).toBe(false);
+    });
+});
+// ─── dbRowToKnowledgeBase ────────────────────────────────────
+describe("dbRowToKnowledgeBase", () => {
+    const validRow = {
+        id: "550e8400-e29b-41d4-a716-446655440000",
+        name: "Test KB",
+        description: "A description",
+        embedding_model_id: "model-1",
+        created_at: 1700000000000,
+        updated_at: 1700000000000,
+    };
+    it("converts a valid DB row to KnowledgeBaseMetadata", () => {
+        const result = dbRowToKnowledgeBase(validRow);
+        expect(result.id).toBe(validRow.id);
+        expect(result.name).toBe("Test KB");
+        expect(result.embeddingModelId).toBe("model-1");
+        expect(result.createdAt).toBeInstanceOf(Date);
+        expect(result.createdAt.getTime()).toBe(1700000000000);
+    });
+    it("throws on non-object input", () => {
+        expect(() => dbRowToKnowledgeBase(null)).toThrow("Invalid database row");
+        expect(() => dbRowToKnowledgeBase("string")).toThrow("Invalid database row");
+        expect(() => dbRowToKnowledgeBase([])).toThrow("Invalid database row");
+    });
+});
+// ─── dbRowToLiterature ───────────────────────────────────────
+describe("dbRowToLiterature", () => {
+    const validRow = {
+        id: "550e8400-e29b-41d4-a716-446655440000",
+        title: "A Paper",
+        title_translation: null,
+        author: "Alice",
+        abstract: "This paper...",
+        summary: null,
+        keywords: '["ai","ml"]',
+        url: null,
+        notes: '{"read":"yes"}',
+        knowledge_base_id: "550e8400-e29b-41d4-a716-446655440000",
+        created_at: 1700000000000,
+        updated_at: 1700000000000,
+    };
+    it("converts a valid DB row with JSON fields", () => {
+        const result = dbRowToLiterature(validRow);
+        expect(result.title).toBe("A Paper");
+        expect(result.author).toBe("Alice");
+        expect(result.keywords).toEqual(["ai", "ml"]);
+        expect(result.notes).toEqual({ read: "yes" });
+        expect(result.knowledgeBaseId).toBe(validRow.knowledge_base_id);
+    });
+    it("handles missing keywords/notes with defaults", () => {
+        const row = { ...validRow, keywords: undefined, notes: undefined };
+        const result = dbRowToLiterature(row);
+        expect(result.keywords).toEqual([]);
+        expect(result.notes).toEqual({});
+    });
+    it("throws on non-object input", () => {
+        expect(() => dbRowToLiterature(42)).toThrow("Invalid database row");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/db/index.test.js.map

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

package/dist/db/operations/knowledge-bases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/db/operations/knowledge-bases.test.js

@@ -0,0 +1,73 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { createTestDb } from "../test-utils.js";
+import { createKnowledgeBase, deleteKnowledgeBase, getKnowledgeBase, listKnowledgeBases, } from "./knowledge-bases.js";
+let db;
+beforeEach(() => {
+    db = createTestDb();
+});
+afterEach(() => {
+    db.close();
+});
+const input = {
+    name: "Test KB",
+    description: "A test knowledge base",
+    embeddingModelId: "model-1",
+};
+// ─── createKnowledgeBase ─────────────────────────────────────
+describe("createKnowledgeBase", () => {
+    it("creates and returns a knowledge base with generated id and timestamps", () => {
+        const kb = createKnowledgeBase(db, input);
+        expect(kb.id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+        expect(kb.name).toBe("Test KB");
+        expect(kb.description).toBe("A test knowledge base");
+        expect(kb.embeddingModelId).toBe("model-1");
+        expect(kb.createdAt).toBeInstanceOf(Date);
+        expect(kb.updatedAt).toBeInstanceOf(Date);
+    });
+    it("rejects duplicate names due to UNIQUE constraint", () => {
+        createKnowledgeBase(db, input);
+        expect(() => createKnowledgeBase(db, input)).toThrow();
+    });
+});
+// ─── getKnowledgeBase ────────────────────────────────────────
+describe("getKnowledgeBase", () => {
+    it("returns the knowledge base by id", () => {
+        const created = createKnowledgeBase(db, input);
+        const found = getKnowledgeBase(db, created.id);
+        expect(found).not.toBeNull();
+        expect(found.id).toBe(created.id);
+        expect(found.name).toBe("Test KB");
+    });
+    it("returns null for non-existent id", () => {
+        expect(getKnowledgeBase(db, "non-existent")).toBeNull();
+    });
+});
+// ─── listKnowledgeBases ──────────────────────────────────────
+describe("listKnowledgeBases", () => {
+    it("returns an empty array when no knowledge bases exist", () => {
+        expect(listKnowledgeBases(db)).toEqual([]);
+    });
+    it("returns knowledge bases ordered by created_at DESC", () => {
+        const kb1 = createKnowledgeBase(db, { ...input, name: "First" });
+        // Manually backdate kb1 so ordering is deterministic
+        db.prepare("UPDATE knowledge_bases SET created_at = created_at - 1000 WHERE id = ?").run(kb1.id);
+        const kb2 = createKnowledgeBase(db, { ...input, name: "Second" });
+        const list = listKnowledgeBases(db);
+        expect(list).toHaveLength(2);
+        // Second was created after First, so it should come first in DESC order
+        expect(list[0].id).toBe(kb2.id);
+        expect(list[1].id).toBe(kb1.id);
+    });
+});
+// ─── deleteKnowledgeBase ─────────────────────────────────────
+describe("deleteKnowledgeBase", () => {
+    it("deletes an existing knowledge base and returns true", () => {
+        const kb = createKnowledgeBase(db, input);
+        expect(deleteKnowledgeBase(db, kb.id)).toBe(true);
+        expect(getKnowledgeBase(db, kb.id)).toBeNull();
+    });
+    it("returns false for non-existent id", () => {
+        expect(deleteKnowledgeBase(db, "non-existent")).toBe(false);
+    });
+});
+//# sourceMappingURL=knowledge-bases.test.js.map

package/dist/db/operations/knowledge-bases.test.js.map

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

package/dist/db/operations/literatures.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/db/operations/literatures.test.js

@@ -0,0 +1,159 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { createTestDb } from "../test-utils.js";
+import { createKnowledgeBase } from "./knowledge-bases.js";
+import { createLiterature, deleteLiterature, deleteLiteraturesByKnowledgeBaseId, getLiterature, listLiteratures, updateLiterature, } from "./literatures.js";
+let db;
+let kbId;
+beforeEach(() => {
+    db = createTestDb();
+    // Every literature needs a knowledge base
+    const kb = createKnowledgeBase(db, {
+        name: "Test KB",
+        description: "test",
+        embeddingModelId: "model-1",
+    });
+    kbId = kb.id;
+});
+afterEach(() => {
+    db.close();
+});
+function makeInput(overrides) {
+    return {
+        title: "A Paper",
+        titleTranslation: null,
+        author: "Alice",
+        abstract: "This paper explores...",
+        summary: null,
+        keywords: ["ai", "ml"],
+        url: null,
+        notes: { read: "yes" },
+        knowledgeBaseId: kbId,
+        ...overrides,
+    };
+}
+// ─── createLiterature ────────────────────────────────────────
+describe("createLiterature", () => {
+    it("creates a literature with generated id and timestamps", () => {
+        const lit = createLiterature(db, makeInput());
+        expect(lit.id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+        expect(lit.title).toBe("A Paper");
+        expect(lit.author).toBe("Alice");
+        expect(lit.knowledgeBaseId).toBe(kbId);
+    });
+    it("round-trips JSON fields (keywords and notes)", () => {
+        const lit = createLiterature(db, makeInput({
+            keywords: ["deep learning", "transformer"],
+            notes: { chapter1: "interesting", chapter2: "review" },
+        }));
+        expect(lit.keywords).toEqual(["deep learning", "transformer"]);
+        expect(lit.notes).toEqual({ chapter1: "interesting", chapter2: "review" });
+    });
+    it("handles empty keywords and notes", () => {
+        const lit = createLiterature(db, makeInput({ keywords: [], notes: {} }));
+        expect(lit.keywords).toEqual([]);
+        expect(lit.notes).toEqual({});
+    });
+});
+// ─── getLiterature ───────────────────────────────────────────
+describe("getLiterature", () => {
+    it("returns the literature by id", () => {
+        const created = createLiterature(db, makeInput());
+        const found = getLiterature(db, created.id);
+        expect(found).not.toBeNull();
+        expect(found.title).toBe("A Paper");
+    });
+    it("returns null for non-existent id", () => {
+        expect(getLiterature(db, "non-existent")).toBeNull();
+    });
+});
+// ─── listLiteratures ─────────────────────────────────────────
+describe("listLiteratures", () => {
+    it("returns only literatures belonging to the given KB", () => {
+        const kb2 = createKnowledgeBase(db, {
+            name: "Other KB",
+            description: "other",
+            embeddingModelId: "model-1",
+        });
+        createLiterature(db, makeInput({ title: "Paper A" }));
+        createLiterature(db, makeInput({ title: "Paper B", knowledgeBaseId: kb2.id }));
+        const list = listLiteratures(db, kbId);
+        expect(list).toHaveLength(1);
+        expect(list[0].title).toBe("Paper A");
+    });
+    it("returns an empty array for a KB with no literatures", () => {
+        expect(listLiteratures(db, kbId)).toEqual([]);
+    });
+});
+// ─── updateLiterature ────────────────────────────────────────
+describe("updateLiterature", () => {
+    it("updates only the specified fields", () => {
+        const lit = createLiterature(db, makeInput());
+        const updated = updateLiterature(db, lit.id, { title: "New Title" });
+        expect(updated).not.toBeNull();
+        expect(updated.title).toBe("New Title");
+        // Other fields stay unchanged
+        expect(updated.author).toBe("Alice");
+        expect(updated.keywords).toEqual(["ai", "ml"]);
+    });
+    it("updates JSON fields correctly", () => {
+        const lit = createLiterature(db, makeInput());
+        const updated = updateLiterature(db, lit.id, {
+            keywords: ["new-tag"],
+            notes: { updated: "true" },
+        });
+        expect(updated.keywords).toEqual(["new-tag"]);
+        expect(updated.notes).toEqual({ updated: "true" });
+    });
+    it("advances updatedAt on update", () => {
+        const lit = createLiterature(db, makeInput());
+        const updated = updateLiterature(db, lit.id, { title: "Changed" });
+        expect(updated.updatedAt.getTime()).toBeGreaterThanOrEqual(lit.updatedAt.getTime());
+    });
+    it("returns the original when input is empty (no fields to update)", () => {
+        const lit = createLiterature(db, makeInput());
+        const unchanged = updateLiterature(db, lit.id, {});
+        expect(unchanged).not.toBeNull();
+        expect(unchanged.title).toBe(lit.title);
+        expect(unchanged.updatedAt.getTime()).toBe(lit.updatedAt.getTime());
+    });
+    it("returns null for non-existent id", () => {
+        expect(updateLiterature(db, "non-existent", { title: "X" })).toBeNull();
+    });
+});
+// ─── deleteLiterature ────────────────────────────────────────
+describe("deleteLiterature", () => {
+    it("deletes an existing literature and returns true", () => {
+        const lit = createLiterature(db, makeInput());
+        expect(deleteLiterature(db, lit.id)).toBe(true);
+        expect(getLiterature(db, lit.id)).toBeNull();
+    });
+    it("returns false for non-existent id", () => {
+        expect(deleteLiterature(db, "non-existent")).toBe(false);
+    });
+});
+// ─── deleteLiteraturesByKnowledgeBaseId ──────────────────────
+describe("deleteLiteraturesByKnowledgeBaseId", () => {
+    it("deletes all literatures in a KB and returns the count", () => {
+        createLiterature(db, makeInput({ title: "Paper 1" }));
+        createLiterature(db, makeInput({ title: "Paper 2" }));
+        expect(deleteLiteraturesByKnowledgeBaseId(db, kbId)).toBe(2);
+        expect(listLiteratures(db, kbId)).toEqual([]);
+    });
+    it("returns 0 when the KB has no literatures", () => {
+        expect(deleteLiteraturesByKnowledgeBaseId(db, kbId)).toBe(0);
+    });
+});
+// ─── Foreign Key Behavior ────────────────────────────────────
+describe("foreign key: ON DELETE SET NULL", () => {
+    it("sets knowledge_base_id to null when KB is deleted", () => {
+        const lit = createLiterature(db, makeInput());
+        // Delete the KB directly via SQL to trigger FK cascade
+        db.prepare("DELETE FROM knowledge_bases WHERE id = ?").run(kbId);
+        // getLiterature() will throw because Zod schema requires knowledgeBaseId to be a UUID,
+        // but FK cascade sets it to NULL. Check the raw row instead.
+        const raw = db.prepare("SELECT knowledge_base_id FROM literatures WHERE id = ?").get(lit.id);
+        expect(raw).toBeDefined();
+        expect(raw["knowledge_base_id"]).toBeNull();
+    });
+});
+//# sourceMappingURL=literatures.test.js.map

package/dist/db/operations/literatures.test.js.map

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

package/dist/db/test-utils.d.ts

@@ -0,0 +1,6 @@
+import type BetterSqlite3 from "better-sqlite3";
+/**
+ * Creates an in-memory SQLite database with the schema initialized.
+ * Each call returns a fresh, isolated database instance.
+ */
+export declare function createTestDb(): BetterSqlite3.Database;

package/dist/db/test-utils.js

@@ -0,0 +1,14 @@
+import Database from "better-sqlite3";
+import { initializeDatabase } from "./index.js";
+/**
+ * Creates an in-memory SQLite database with the schema initialized.
+ * Each call returns a fresh, isolated database instance.
+ */
+export function createTestDb() {
+    const db = new Database(":memory:");
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    initializeDatabase(db);
+    return db;
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/db/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../src/db/test-utils.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/extractor/index.d.ts

@@ -0,0 +1,5 @@
+import type { Document } from "@langchain/core/documents";
+import { extractPdfContent } from "./pdf.js";
+import { extractTextContent } from "./text.js";
+export { extractPdfContent, extractTextContent };
+export declare function extractContent(filePath: string): Promise<Document[]>;

package/dist/extractor/index.js

@@ -0,0 +1,23 @@
+import mime from "mime-types";
+import { extractPdfContent } from "./pdf.js";
+import { extractTextContent } from "./text.js";
+export { extractPdfContent, extractTextContent };
+const TEXT_LIKE_MIME_TYPES = new Set([
+    "application/x-tex",
+    "application/x-latex",
+]);
+function isTextLike(mimeType) {
+    return mimeType.startsWith("text/") || TEXT_LIKE_MIME_TYPES.has(mimeType);
+}
+export async function extractContent(filePath) {
+    const mimeType = mime.lookup(filePath);
+    if (mimeType === "application/pdf") {
+        return extractPdfContent(filePath);
+    }
+    if (typeof mimeType === "string" && isTextLike(mimeType)) {
+        return extractTextContent(filePath);
+    }
+    const ext = filePath.split(".").pop() ?? "unknown";
+    throw new Error(`Unsupported file type: .${ext} (${String(mimeType)})`);
+}
+//# sourceMappingURL=index.js.map

package/dist/extractor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractor/index.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,YAAY,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;AAEjD,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACxD,mBAAmB;IACnB,qBAAqB;CACtB,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;IACnD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,KAAK,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1E,CAAC"}

package/dist/extractor/pdf.d.ts

@@ -0,0 +1,2 @@
+import { Document } from "@langchain/core/documents";
+export declare function extractPdfContent(pdfPath: string): Promise<Document[]>;

package/dist/extractor/pdf.js

@@ -0,0 +1,18 @@
+import { readFile } from "node:fs/promises";
+import { Document } from "@langchain/core/documents";
+import { PDFParse } from "pdf-parse";
+export async function extractPdfContent(pdfPath) {
+    const data = await readFile(pdfPath);
+    const parser = new PDFParse({ data });
+    const result = await parser.getText();
+    await parser.destroy();
+    return result.pages.map((page) => new Document({
+        pageContent: page.text,
+        metadata: {
+            source: pdfPath,
+            pdf: { totalPages: result.total },
+            loc: { pageNumber: page.num },
+        },
+    }));
+}
+//# sourceMappingURL=pdf.js.map

package/dist/extractor/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../src/extractor/pdf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACtC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IAEvB,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CACrB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,QAAQ,CAAC;QACX,WAAW,EAAE,IAAI,CAAC,IAAI;QACtB,QAAQ,EAAE;YACR,MAAM,EAAE,OAAO;YACf,GAAG,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE;YACjC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;SAC9B;KACF,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/extractor/text.d.ts

@@ -0,0 +1,2 @@
+import { Document } from "@langchain/core/documents";
+export declare function extractTextContent(filePath: string): Promise<Document[]>;

package/dist/extractor/text.js

@@ -0,0 +1,17 @@
+import { readFile, stat } from "node:fs/promises";
+import { Document } from "@langchain/core/documents";
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB
+export async function extractTextContent(filePath) {
+    const fileStats = await stat(filePath);
+    if (fileStats.size > MAX_FILE_SIZE) {
+        throw new Error(`File too large: ${String(Math.round(fileStats.size / 1024 / 1024))} MB exceeds the 10 MB limit`);
+    }
+    const content = await readFile(filePath, "utf-8");
+    return [
+        new Document({
+            pageContent: content,
+            metadata: { source: filePath },
+        }),
+    ];
+}
+//# sourceMappingURL=text.js.map

package/dist/extractor/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/extractor/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAEhD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,6BAA6B,CACjG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO;QACL,IAAI,QAAQ,CAAC;YACX,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;SAC/B,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/types/index.test.d.ts

@@ -0,0 +1 @@
+export {};