@j0hanz/memdb 1.0.8 → 1.0.10

package/dist/core/relation-queries.js

@@ -0,0 +1,126 @@
+import { mapRowToRelatedMemory } from './row-mappers.js';
+import { executeAll, prepareCached } from './sqlite.js';
+const directConfig = {
+    outgoing: { joinColumn: 'to_memory_id', whereColumn: 'from_memory_id' },
+    incoming: { joinColumn: 'from_memory_id', whereColumn: 'to_memory_id' },
+};
+const recursiveConfig = {
+    outgoing: {
+        baseColumn: 'from_memory_id',
+        joinColumn: 'from_memory_id',
+        relsJoinColumn: 'to_id',
+        memoryJoinColumn: 'to_id',
+    },
+    incoming: {
+        baseColumn: 'to_memory_id',
+        joinColumn: 'to_memory_id',
+        relsJoinColumn: 'from_id',
+        memoryJoinColumn: 'from_id',
+    },
+};
+const typeFilter = (relationType) => relationType
+    ? { clause: ' AND r.relation_type = ?', params: [relationType] }
+    : { clause: '', params: [] };
+const run = (sql, params) => executeAll(prepareCached(sql), ...params).map((row) => mapRowToRelatedMemory(row));
+const buildDirectSql = (input) => {
+    const config = directConfig[input.direction];
+    const limitClause = input.includeLimit === false ? '' : '\n    LIMIT 1000';
+    return `
+    SELECT m.*, r.relation_type as relation_type, 1 as depth
+    FROM memories m
+    JOIN relationships r ON m.id = r.${config.joinColumn}
+    WHERE r.${config.whereColumn} = ?${input.clause}${limitClause}
+  `;
+};
+const buildRecursiveSql = (input) => {
+    const config = recursiveConfig[input.direction];
+    return `
+    WITH RECURSIVE rels(depth, from_id, to_id, relation_type) AS (
+      SELECT 1, r.from_memory_id, r.to_memory_id, r.relation_type
+      FROM relationships r
+      WHERE r.${config.baseColumn} = ?${input.clause}
+      UNION ALL
+      SELECT rels.depth + 1, r.from_memory_id, r.to_memory_id, r.relation_type
+      FROM relationships r
+      JOIN rels ON r.${config.joinColumn} = rels.${config.relsJoinColumn}
+      WHERE rels.depth < ?${input.clause}
+    )
+    SELECT m.*, rels.relation_type as relation_type, MIN(rels.depth) as depth
+    FROM rels
+    JOIN memories m ON m.id = rels.${config.memoryJoinColumn}
+    GROUP BY m.id, rels.relation_type
+    ORDER BY depth, m.id
+    LIMIT 1000
+  `;
+};
+const buildRecursiveParams = (input) => {
+    if (!input.relationType) {
+        return [input.memoryId, input.maxDepth];
+    }
+    return [input.memoryId, ...input.params, input.maxDepth, ...input.params];
+};
+export const queryOutgoingDirect = (memoryId, relationType) => {
+    const { clause, params } = typeFilter(relationType);
+    const sql = buildDirectSql({ direction: 'outgoing', clause });
+    return run(sql, [memoryId, ...params]);
+};
+export const queryIncomingDirect = (memoryId, relationType) => {
+    const { clause, params } = typeFilter(relationType);
+    const sql = buildDirectSql({ direction: 'incoming', clause });
+    return run(sql, [memoryId, ...params]);
+};
+export const queryBothDirect = (memoryId, relationType) => {
+    const { clause, params } = typeFilter(relationType);
+    const outgoingSql = buildDirectSql({
+        direction: 'outgoing',
+        clause,
+        includeLimit: false,
+    });
+    const incomingSql = buildDirectSql({
+        direction: 'incoming',
+        clause,
+        includeLimit: false,
+    });
+    const sql = `
+    ${outgoingSql}
+    UNION
+    ${incomingSql}
+    LIMIT 1000
+  `;
+    return run(sql, [memoryId, ...params, memoryId, ...params]);
+};
+export const queryOutgoingRecursive = (memoryId, relationType, maxDepth) => {
+    const { clause, params } = typeFilter(relationType);
+    const sql = buildRecursiveSql({ direction: 'outgoing', clause });
+    const sqlParams = buildRecursiveParams({
+        memoryId,
+        relationType,
+        maxDepth,
+        params,
+    });
+    return run(sql, sqlParams);
+};
+export const queryIncomingRecursive = (memoryId, relationType, maxDepth) => {
+    const { clause, params } = typeFilter(relationType);
+    const sql = buildRecursiveSql({ direction: 'incoming', clause });
+    const sqlParams = buildRecursiveParams({
+        memoryId,
+        relationType,
+        maxDepth,
+        params,
+    });
+    return run(sql, sqlParams);
+};
+export const deduplicateByHash = (memories) => {
+    const seen = new Map();
+    for (const mem of memories) {
+        const existing = seen.get(mem.hash);
+        if (!existing || mem.depth < existing.depth) {
+            seen.set(mem.hash, mem);
+        }
+    }
+    return [...seen.values()]
+        .sort((a, b) => a.depth - b.depth || a.id - b.id)
+        .slice(0, 1000);
+};
+//# sourceMappingURL=relation-queries.js.map

package/dist/core/relation-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-queries.js","sourceRoot":"","sources":["../../src/core/relation-queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAIvE,MAAM,YAAY,GAGd;IACF,QAAQ,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACvE,QAAQ,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE;CACxE,CAAC;AAEF,MAAM,eAAe,GAQjB;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,gBAAgB;QAC5B,UAAU,EAAE,gBAAgB;QAC5B,cAAc,EAAE,OAAO;QACvB,gBAAgB,EAAE,OAAO;KAC1B;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,cAAc;QAC1B,UAAU,EAAE,cAAc;QAC1B,cAAc,EAAE,SAAS;QACzB,gBAAgB,EAAE,SAAS;KAC5B;CACF,CAAC;AAEF,MAAM,UAAU,GAAG,CACjB,YAAqB,EACiB,EAAE,CACxC,YAAY;IACV,CAAC,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE;IAChE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEjC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,MAAkB,EAAmB,EAAE,CAC/D,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAU,EAAE,EAAE,CAC3D,qBAAqB,CAAC,GAAG,CAAC,CAC3B,CAAC;AAEJ,MAAM,cAAc,GAAG,CAAC,KAIvB,EAAU,EAAE;IACX,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC3E,OAAO;;;uCAG8B,MAAM,CAAC,UAAU;cAC1C,MAAM,CAAC,WAAW,OAAO,KAAK,CAAC,MAAM,GAAG,WAAW;GAC9D,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAG1B,EAAU,EAAE;IACX,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO;;;;gBAIO,MAAM,CAAC,UAAU,OAAO,KAAK,CAAC,MAAM;;;;uBAI7B,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,cAAc;4BAC5C,KAAK,CAAC,MAAM;;;;qCAIH,MAAM,CAAC,gBAAgB;;;;GAIzD,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,KAK7B,EAAuB,EAAE;IACxB,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAgB,EAChB,YAAqB,EACJ,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAgB,EAChB,YAAqB,EACJ,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAgB,EAChB,YAAqB,EACJ,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,cAAc,CAAC;QACjC,SAAS,EAAE,UAAU;QACrB,MAAM;QACN,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,cAAc,CAAC;QACjC,SAAS,EAAE,UAAU;QACrB,MAAM;QACN,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,MAAM,GAAG,GAAG;MACR,WAAW;;MAEX,WAAW;;GAEd,CAAC;IACF,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAgB,EAChB,YAAgC,EAChC,QAAgB,EACC,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACrC,QAAQ;QACR,YAAY;QACZ,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAgB,EAChB,YAAgC,EAChC,QAAgB,EACC,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACrC,QAAQ;QACR,YAAY;QACZ,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAAyB,EACR,EAAE;IACnB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;SACtB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;SAChD,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpB,CAAC,CAAC"}

package/dist/core/row-mappers.d.ts

@@ -0,0 +1,7 @@
+import type { Memory, RelatedMemory, SearchResult } from '../types/index.js';
+export type DbRow = Record<string, unknown>;
+export declare const toSafeInteger: (value: unknown, field: string) => number;
+export declare const mapRowToMemory: (row: DbRow) => Memory;
+export declare const mapRowToSearchResult: (row: DbRow) => SearchResult;
+export declare const mapRowToRelatedMemory: (row: DbRow) => RelatedMemory;
+//# sourceMappingURL=row-mappers.d.ts.map

package/dist/core/row-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-mappers.d.ts","sourceRoot":"","sources":["../../src/core/row-mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7E,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAc5C,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,OAAO,MAAM,KAAG,MAM7D,CAAC;AAuBF,eAAO,MAAM,cAAc,GAAI,KAAK,KAAK,KAAG,MAS1C,CAAC;AAEH,eAAO,MAAM,oBAAoB,GAAI,KAAK,KAAK,KAAG,YAGhD,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAAI,KAAK,KAAK,KAAG,aAIjD,CAAC"}

package/dist/core/row-mappers.js

@@ -0,0 +1,53 @@
+const createFieldError = (field) => new Error(`Invalid ${field}`);
+const toNumber = (value, field) => {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'bigint') {
+        const numeric = Number(value);
+        if (Number.isFinite(numeric))
+            return numeric;
+    }
+    throw createFieldError(field);
+};
+export const toSafeInteger = (value, field) => {
+    const numeric = toNumber(value, field);
+    if (!Number.isSafeInteger(numeric)) {
+        throw createFieldError(field);
+    }
+    return numeric;
+};
+const toString = (value, field) => {
+    if (typeof value === 'string')
+        return value;
+    throw createFieldError(field);
+};
+const toOptionalString = (value, field) => {
+    if (value === null || value === undefined)
+        return undefined;
+    return toString(value, field);
+};
+const toOptionalNumber = (value, field) => {
+    if (value === null || value === undefined)
+        return undefined;
+    return toNumber(value, field);
+};
+export const mapRowToMemory = (row) => ({
+    id: toSafeInteger(row.id, 'id'),
+    content: toString(row.content, 'content'),
+    summary: toOptionalString(row.summary, 'summary'),
+    importance: toSafeInteger(row.importance, 'importance'),
+    memory_type: toString(row.memory_type, 'memory_type'),
+    created_at: toString(row.created_at, 'created_at'),
+    accessed_at: toString(row.accessed_at, 'accessed_at'),
+    hash: toString(row.hash, 'hash'),
+});
+export const mapRowToSearchResult = (row) => ({
+    ...mapRowToMemory(row),
+    relevance: toOptionalNumber(row.relevance, 'relevance') ?? 0,
+});
+export const mapRowToRelatedMemory = (row) => ({
+    ...mapRowToMemory(row),
+    relation_type: toString(row.relation_type, 'relation_type'),
+    depth: toSafeInteger(row.depth, 'depth'),
+});
+//# sourceMappingURL=row-mappers.js.map

package/dist/core/row-mappers.js.map

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

package/dist/core/search-errors.d.ts

@@ -0,0 +1,2 @@
+export declare const toSearchError: (err: unknown) => Error | undefined;
+//# sourceMappingURL=search-errors.d.ts.map

package/dist/core/search-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-errors.d.ts","sourceRoot":"","sources":["../../src/core/search-errors.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,KAAG,KAAK,GAAG,SAQpD,CAAC"}

package/dist/core/search-errors.js

@@ -0,0 +1,31 @@
+const INDEX_MISSING_TOKENS = [
+    'no such module: fts5',
+    'no such table: memories_fts',
+];
+const QUERY_INVALID_TOKENS = ['fts5', 'syntax error'];
+const isSearchIndexMissing = (message) => INDEX_MISSING_TOKENS.some((token) => message.includes(token));
+const isSearchQueryInvalid = (message) => QUERY_INVALID_TOKENS.some((token) => message.includes(token));
+const getErrorMessage = (err) => err instanceof Error ? err.message : String(err);
+const SEARCH_ERROR_MAP = [
+    {
+        matches: isSearchIndexMissing,
+        build: () => new Error('Search index unavailable. Ensure FTS5 is enabled and the index is ' +
+            'initialized.'),
+    },
+    {
+        matches: isSearchQueryInvalid,
+        build: (message) => new Error('Invalid search query syntax. Check for unbalanced quotes or special ' +
+            'characters. ' +
+            `Details: ${message}`),
+    },
+];
+export const toSearchError = (err) => {
+    const message = getErrorMessage(err);
+    for (const mapping of SEARCH_ERROR_MAP) {
+        if (mapping.matches(message)) {
+            return mapping.build(message);
+        }
+    }
+    return undefined;
+};
+//# sourceMappingURL=search-errors.js.map

package/dist/core/search-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-errors.js","sourceRoot":"","sources":["../../src/core/search-errors.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG;IAC3B,sBAAsB;IACtB,6BAA6B;CAC9B,CAAC;AACF,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEtD,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAW,EAAE,CACxD,oBAAoB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAEhE,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAW,EAAE,CACxD,oBAAoB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAEhE,MAAM,eAAe,GAAG,CAAC,GAAY,EAAU,EAAE,CAC/C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAEnD,MAAM,gBAAgB,GAGhB;IACJ;QACE,OAAO,EAAE,oBAAoB;QAC7B,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,KAAK,CACP,oEAAoE;YAClE,cAAc,CACjB;KACJ;IACD;QACE,OAAO,EAAE,oBAAoB;QAC7B,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,IAAI,KAAK,CACP,sEAAsE;YACpE,cAAc;YACd,YAAY,OAAO,EAAE,CACxB;KACJ;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAY,EAAqB,EAAE;IAC/D,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/core/search.d.ts

@@ -0,0 +1,13 @@
+import type { DbRow } from './row-mappers.js';
+export declare const buildSearchQuery: (input: {
+    query: string;
+    limit: number;
+    tags: readonly string[];
+    minRelevance?: number;
+    offset?: number;
+}) => {
+    sql: string;
+    params: (number | string)[];
+};
+export declare const executeSearch: (sql: string, params: (number | string)[]) => DbRow[];
+//# sourceMappingURL=search.d.ts.map

package/dist/core/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AA4E9C,eAAO,MAAM,gBAAgB,GAAI,OAAO;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CAkB7C,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,KAAK,MAAM,EACX,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAC1B,KAAK,EAWP,CAAC"}

package/dist/core/search.js

@@ -0,0 +1,88 @@
+import { toSearchError } from './search-errors.js';
+import { executeAll, prepareCached } from './sqlite.js';
+const MAX_QUERY_TOKENS = 50;
+const tokenizeQuery = (query) => {
+    const parts = query
+        .trim()
+        .split(/\s+/)
+        .filter((w) => w.length > 0);
+    if (parts.length === 0)
+        return '""';
+    if (parts.length > MAX_QUERY_TOKENS) {
+        throw new Error('Query has too many terms (max ' + String(MAX_QUERY_TOKENS) + ')');
+    }
+    const tokens = [];
+    for (const part of parts) {
+        tokens.push(`"${part.replace(/"/g, '""')}"`);
+    }
+    return tokens.join(' OR ');
+};
+const buildTagFilter = (tags) => {
+    if (tags.length === 0)
+        return { clause: '', params: [] };
+    const placeholders = tags.map(() => '?').join(', ');
+    return {
+        clause: ` AND m.id IN (SELECT memory_id FROM tags WHERE tag IN (${placeholders}))`,
+        params: [...tags],
+    };
+};
+const buildBaseSql = (whereClause) => {
+    const relevanceExpr = '1.0 / (1.0 + abs(bm25(memories_fts)))';
+    return `
+    WITH ranked AS (
+      SELECT m.*, ${relevanceExpr} as relevance
+      FROM memories m
+      JOIN memories_fts ON m.id = memories_fts.rowid
+      WHERE memories_fts MATCH ?${whereClause}
+    )
+    SELECT * FROM ranked
+  `;
+};
+const appendMinRelevance = (input) => {
+    if (input.minRelevance === undefined)
+        return input;
+    return {
+        sql: `${input.sql} WHERE relevance >= ?`,
+        params: [...input.params, input.minRelevance],
+    };
+};
+const appendPagination = (input) => {
+    const params = [...input.params, input.limit];
+    let sql = `${input.sql} ORDER BY relevance DESC LIMIT ?`;
+    if (input.offset !== undefined && input.offset > 0) {
+        sql += ' OFFSET ?';
+        params.push(input.offset);
+    }
+    return { sql, params };
+};
+export const buildSearchQuery = (input) => {
+    const sanitizedQuery = tokenizeQuery(input.query);
+    const tagFilter = buildTagFilter(input.tags);
+    const baseSql = buildBaseSql(tagFilter.clause);
+    const baseParams = [sanitizedQuery, ...tagFilter.params];
+    const baseQuery = { sql: baseSql, params: baseParams };
+    const withRelevance = input.minRelevance === undefined
+        ? baseQuery
+        : appendMinRelevance({
+            ...baseQuery,
+            minRelevance: input.minRelevance,
+        });
+    const paginatedQuery = input.offset === undefined
+        ? { ...withRelevance, limit: input.limit }
+        : { ...withRelevance, limit: input.limit, offset: input.offset };
+    return appendPagination(paginatedQuery);
+};
+export const executeSearch = (sql, params) => {
+    try {
+        const stmt = prepareCached(sql);
+        return executeAll(stmt, ...params);
+    }
+    catch (err) {
+        const mappedError = toSearchError(err);
+        if (mappedError) {
+            throw mappedError;
+        }
+        throw err;
+    }
+};
+//# sourceMappingURL=search.js.map

package/dist/core/search.js.map

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

package/dist/core/sqlite.d.ts

@@ -0,0 +1,11 @@
+import type { StatementSync } from 'node:sqlite';
+import type { DbRow } from './row-mappers.js';
+export type SqlParam = string | number | bigint | null | Uint8Array;
+export declare const prepareCached: (sql: string) => StatementSync;
+export declare const executeAll: (stmt: StatementSync, ...params: SqlParam[]) => DbRow[];
+export declare const executeGet: (stmt: StatementSync, ...params: SqlParam[]) => DbRow | undefined;
+export declare const executeRun: (stmt: StatementSync, ...params: SqlParam[]) => {
+    changes: number | bigint;
+};
+export declare const withImmediateTransaction: <T>(operation: () => T) => T;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/core/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/core/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,CAAC;AAqDpE,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,aAW3C,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,MAAM,aAAa,EACnB,GAAG,QAAQ,QAAQ,EAAE,KACpB,KAAK,EAAuC,CAAC;AAEhD,eAAO,MAAM,UAAU,GACrB,MAAM,aAAa,EACnB,GAAG,QAAQ,QAAQ,EAAE,KACpB,KAAK,GAAG,SAAoD,CAAC;AAEhE,eAAO,MAAM,UAAU,GACrB,MAAM,aAAa,EACnB,GAAG,QAAQ,QAAQ,EAAE,KACpB;IAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAAsC,CAAC;AAEpE,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,WAAW,MAAM,CAAC,KAAG,CAUhE,CAAC"}

package/dist/core/sqlite.js

@@ -0,0 +1,74 @@
+import { db } from './database.js';
+const MAX_CACHED_STATEMENTS = 200;
+const statementCache = new Map();
+const statementCacheOrder = [];
+const enforceStatementCacheLimit = () => {
+    if (statementCacheOrder.length <= MAX_CACHED_STATEMENTS)
+        return;
+    const oldestSql = statementCacheOrder.shift();
+    if (!oldestSql)
+        return;
+    const toEvict = statementCache.get(oldestSql);
+    statementCache.delete(oldestSql);
+    void toEvict;
+};
+const isDbRow = (value) => {
+    return typeof value === 'object' && value !== null;
+};
+const toDbRowArray = (value) => {
+    if (!Array.isArray(value)) {
+        throw new Error('Expected rows array');
+    }
+    const rows = [];
+    for (const row of value) {
+        if (!isDbRow(row)) {
+            throw new Error('Invalid row');
+        }
+        rows.push(row);
+    }
+    return rows;
+};
+const toDbRowOrUndefined = (value) => {
+    if (value === undefined)
+        return undefined;
+    if (!isDbRow(value)) {
+        throw new Error('Invalid row');
+    }
+    return value;
+};
+const toRunResult = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        throw new Error('Invalid run result');
+    }
+    const changes = Reflect.get(value, 'changes');
+    if (typeof changes !== 'number' && typeof changes !== 'bigint') {
+        throw new Error('Invalid run result');
+    }
+    return { changes };
+};
+export const prepareCached = (sql) => {
+    const cached = statementCache.get(sql);
+    if (cached)
+        return cached;
+    const stmt = db.prepare(sql);
+    statementCache.set(sql, stmt);
+    statementCacheOrder.push(sql);
+    enforceStatementCacheLimit();
+    return stmt;
+};
+export const executeAll = (stmt, ...params) => toDbRowArray(stmt.all(...params));
+export const executeGet = (stmt, ...params) => toDbRowOrUndefined(stmt.get(...params));
+export const executeRun = (stmt, ...params) => toRunResult(stmt.run(...params));
+export const withImmediateTransaction = (operation) => {
+    db.exec('BEGIN IMMEDIATE');
+    try {
+        const result = operation();
+        db.exec('COMMIT');
+        return result;
+    }
+    catch (err) {
+        db.exec('ROLLBACK');
+        throw err;
+    }
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/core/sqlite.js.map

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

package/dist/core/tags.d.ts

@@ -0,0 +1,2 @@
+export declare const normalizeTags: (tags: readonly string[], maxTags: number) => string[];
+//# sourceMappingURL=tags.d.ts.map

package/dist/core/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/core/tags.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,aAAa,GACxB,MAAM,SAAS,MAAM,EAAE,EACvB,SAAS,MAAM,KACd,MAAM,EAIR,CAAC"}

package/dist/core/tags.js

@@ -0,0 +1,28 @@
+const validateTag = (tag) => {
+    if (tag.length === 0) {
+        throw new Error('Tag must be at least 1 character');
+    }
+    if (tag.length > 50) {
+        throw new Error('Tag exceeds 50 characters');
+    }
+};
+const validateTagCount = (tags, maxTags) => {
+    if (tags.length > maxTags) {
+        throw new Error('Too many tags (max ' + String(maxTags) + ')');
+    }
+};
+const dedupeTags = (tags) => {
+    const seen = new Set();
+    for (const tag of tags) {
+        validateTag(tag);
+        seen.add(tag);
+    }
+    return [...seen];
+};
+export const normalizeTags = (tags, maxTags) => {
+    if (tags.length === 0)
+        return [];
+    validateTagCount(tags, maxTags);
+    return dedupeTags(tags);
+};
+//# sourceMappingURL=tags.js.map

package/dist/core/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/core/tags.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,CAAC,GAAW,EAAQ,EAAE;IACxC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAuB,EAAE,OAAe,EAAQ,EAAE;IAC1E,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAY,EAAE;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,WAAW,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAAuB,EACvB,OAAe,EACL,EAAE;IACZ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import process from 'node:process';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { closeDb } from './core/database.js';
+import { registerAllTools } from './tools/index.js';
+import { config } from './utils/config.js';
+import { logger } from './utils/logger.js';
+const packageJsonText = await readFile(new URL('../package.json', import.meta.url), {
+    encoding: 'utf-8',
+    signal: AbortSignal.timeout(5000),
+});
+const packageVersion = (() => {
+    const parsed = JSON.parse(packageJsonText);
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const version = Reflect.get(parsed, 'version');
+    return typeof version === 'string' ? version : undefined;
+})();
+const server = new McpServer({ name: 'memdb', version: packageVersion ?? '0.0.0' }, {
+    instructions: 'A Memory MCP Server for AI Assistants using node:sqlite',
+    capabilities: { logging: {}, tools: {} },
+});
+registerAllTools(server);
+let transport;
+let shuttingDown = false;
+async function shutdown(signal) {
+    if (shuttingDown)
+        return;
+    shuttingDown = true;
+    logger.info(`Received ${signal}, shutting down gracefully...`);
+    const forceExitTimer = setTimeout(() => {
+        logger.warn('Shutdown timeout exceeded, forcing exit');
+        process.exit(1);
+    }, config.shutdownTimeout);
+    const exit = (code) => {
+        clearTimeout(forceExitTimer);
+        process.exit(code);
+    };
+    try {
+        closeDb();
+        if (transport) {
+            await transport.close();
+        }
+        exit(0);
+    }
+    catch (err) {
+        logger.error('Error during shutdown:', err);
+        exit(1);
+    }
+}
+async function main() {
+    try {
+        const stdio = new StdioServerTransport();
+        transport = stdio;
+        await server.connect(stdio);
+        logger.info('Memory MCP Server running on stdio');
+    }
+    catch (error) {
+        logger.error('Failed to start server', error);
+        process.exit(1);
+    }
+}
+void main();
+process.on('SIGTERM', () => void shutdown('SIGTERM'));
+process.on('SIGINT', () => void shutdown('SIGINT'));
+process.on('SIGBREAK', () => void shutdown('SIGBREAK'));
+process.on('uncaughtException', (err, origin) => {
+    logger.error(`Uncaught exception (${origin}):`, err);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    logger.error('Unhandled rejection:', reason);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,20 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+type ErrorResponse = CallToolResult & {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: {
+        ok: false;
+        error: {
+            code: string;
+            message: string;
+        };
+        result?: unknown;
+    };
+    isError: true;
+};
+export declare function getErrorMessage(error: unknown): string;
+export declare function createErrorResponse(code: string, message: string, result?: unknown): ErrorResponse;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,KAAK,aAAa,GAAG,cAAc,GAAG;IACpC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,EAAE;QACjB,EAAE,EAAE,KAAK,CAAC;QACV,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAOF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAWf"}