@abhishekmcp/notes 0.1.1 → 0.3.0

package/dist/notes.d.ts

@@ -1,36 +0,0 @@
-/**
- * Resolve the notes directory from the NOTES_DIR env var, defaulting to ~/notes.
- * A leading "~" is expanded to the user's home directory.
- */
-export declare function getNotesDir(): string;
-/** Ensure the notes directory exists. */
-export declare function ensureNotesDir(): Promise<string>;
-/**
- * Turn a user-supplied note name into a safe absolute path inside the notes
- * directory. Throws if the resolved path would escape the notes directory.
- * A ".md" extension is added when missing.
- */
-export declare function resolveNotePath(name: string): string;
-export interface NoteInfo {
-    name: string;
-    size: number;
-    modified: string;
-}
-/** Recursively list all markdown notes in the notes directory. */
-export declare function listNotes(): Promise<NoteInfo[]>;
-export declare function readNote(name: string): Promise<string>;
-export declare function createNote(name: string, content: string, overwrite?: boolean): Promise<string>;
-export declare function appendNote(name: string, content: string): Promise<string>;
-export declare function deleteNote(name: string): Promise<void>;
-export interface SearchHit {
-    name: string;
-    line: number;
-    text: string;
-}
-/** Case-insensitive substring search across all notes. */
-export declare function searchNotes(query: string, limit?: number): Promise<SearchHit[]>;
-/**
- * Find notes that link to the given note via [[wiki-link]] syntax.
- * Matches the bare note name (with or without the .md extension).
- */
-export declare function getBacklinks(name: string): Promise<SearchHit[]>;

package/dist/notes.js

@@ -1,138 +0,0 @@
-import { promises as fs } from "node:fs";
-import { homedir } from "node:os";
-import path from "node:path";
-/**
- * Resolve the notes directory from the NOTES_DIR env var, defaulting to ~/notes.
- * A leading "~" is expanded to the user's home directory.
- */
-export function getNotesDir() {
-    const raw = process.env.NOTES_DIR ?? path.join(homedir(), "notes");
-    const expanded = raw.startsWith("~")
-        ? path.join(homedir(), raw.slice(1))
-        : raw;
-    return path.resolve(expanded);
-}
-/** Ensure the notes directory exists. */
-export async function ensureNotesDir() {
-    const dir = getNotesDir();
-    await fs.mkdir(dir, { recursive: true });
-    return dir;
-}
-/**
- * Turn a user-supplied note name into a safe absolute path inside the notes
- * directory. Throws if the resolved path would escape the notes directory.
- * A ".md" extension is added when missing.
- */
-export function resolveNotePath(name) {
-    const dir = getNotesDir();
-    const withExt = name.endsWith(".md") ? name : `${name}.md`;
-    const resolved = path.resolve(dir, withExt);
-    const rel = path.relative(dir, resolved);
-    if (rel.startsWith("..") || path.isAbsolute(rel)) {
-        throw new Error(`Refusing to access "${name}": path escapes the notes directory.`);
-    }
-    return resolved;
-}
-/** Recursively list all markdown notes in the notes directory. */
-export async function listNotes() {
-    const dir = await ensureNotesDir();
-    const results = [];
-    async function walk(current) {
-        const entries = await fs.readdir(current, { withFileTypes: true });
-        for (const entry of entries) {
-            const full = path.join(current, entry.name);
-            if (entry.isDirectory()) {
-                await walk(full);
-            }
-            else if (entry.isFile() && entry.name.endsWith(".md")) {
-                const stat = await fs.stat(full);
-                const rel = path.relative(dir, full).replace(/\.md$/, "");
-                results.push({
-                    name: rel,
-                    size: stat.size,
-                    modified: stat.mtime.toISOString(),
-                });
-            }
-        }
-    }
-    await walk(dir);
-    results.sort((a, b) => b.modified.localeCompare(a.modified));
-    return results;
-}
-export async function readNote(name) {
-    const file = resolveNotePath(name);
-    return fs.readFile(file, "utf8");
-}
-export async function createNote(name, content, overwrite = false) {
-    const file = resolveNotePath(name);
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    if (!overwrite) {
-        try {
-            await fs.access(file);
-            throw new Error(`Note "${name}" already exists. Use overwrite or append instead.`);
-        }
-        catch (err) {
-            // ENOENT means it does not exist yet — that's what we want.
-            if (err.code !== "ENOENT")
-                throw err;
-        }
-    }
-    await fs.writeFile(file, content, "utf8");
-    return file;
-}
-export async function appendNote(name, content) {
-    const file = resolveNotePath(name);
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    // Separate appended content with a blank line for readability.
-    const prefix = content.startsWith("\n") ? "" : "\n\n";
-    await fs.appendFile(file, prefix + content, "utf8");
-    return file;
-}
-export async function deleteNote(name) {
-    const file = resolveNotePath(name);
-    await fs.unlink(file);
-}
-/** Case-insensitive substring search across all notes. */
-export async function searchNotes(query, limit = 50) {
-    const notes = await listNotes();
-    const needle = query.toLowerCase();
-    const hits = [];
-    for (const note of notes) {
-        const content = await readNote(note.name);
-        const lines = content.split("\n");
-        for (let i = 0; i < lines.length; i++) {
-            if (lines[i].toLowerCase().includes(needle)) {
-                hits.push({ name: note.name, line: i + 1, text: lines[i].trim() });
-                if (hits.length >= limit)
-                    return hits;
-            }
-        }
-    }
-    return hits;
-}
-/**
- * Find notes that link to the given note via [[wiki-link]] syntax.
- * Matches the bare note name (with or without the .md extension).
- */
-export async function getBacklinks(name) {
-    const target = name.replace(/\.md$/, "");
-    const notes = await listNotes();
-    const hits = [];
-    for (const note of notes) {
-        if (note.name === target)
-            continue;
-        const content = await readNote(note.name);
-        const lines = content.split("\n");
-        for (let i = 0; i < lines.length; i++) {
-            const wikiLinks = lines[i].match(/\[\[([^\]]+)\]\]/g) ?? [];
-            for (const link of wikiLinks) {
-                const inner = link.slice(2, -2).split("|")[0].trim().replace(/\.md$/, "");
-                if (inner === target) {
-                    hits.push({ name: note.name, line: i + 1, text: lines[i].trim() });
-                }
-            }
-        }
-    }
-    return hits;
-}
-//# sourceMappingURL=notes.js.map

package/dist/notes.js.map

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