@iwo-szapar/data-mcp 0.1.0

package/dist/adapter/supabase.js

@@ -0,0 +1,294 @@
+/**
+ * Supabase adapter implementation.
+ *
+ * Uses service role key for authentication.
+ * textSearch uses PostgreSQL tsvector when available, ILIKE fallback.
+ * ILIKE search sanitizes \, %, _ characters.
+ */
+import { createClient } from '@supabase/supabase-js';
+import { AdapterError } from '../errors/adapter-error.js';
+export class SupabaseAdapter {
+    backend = 'supabase';
+    client;
+    constructor(url, key) {
+        this.client = createClient(url, key);
+    }
+    async create(collection, data) {
+        const { data: result, error } = await this.client
+            .from(collection)
+            .insert(data)
+            .select()
+            .single();
+        if (error)
+            throw mapSupabaseError(error, collection);
+        return result;
+    }
+    async getOne(collection, id) {
+        const { data: result, error } = await this.client
+            .from(collection)
+            .select('*')
+            .eq('id', id)
+            .single();
+        if (error)
+            throw mapSupabaseError(error, collection);
+        return result;
+    }
+    async list(collection, options) {
+        const limit = options?.page?.limit ?? 50;
+        const offset = options?.page?.offset ?? 0;
+        let query = this.client.from(collection).select('*', { count: 'exact' });
+        query = applyFilter(query, options?.filter);
+        if (options?.sort) {
+            for (const s of options.sort) {
+                query = query.order(s.field, { ascending: s.direction === 'asc' });
+            }
+        }
+        else {
+            query = query.order('created_at', { ascending: false });
+        }
+        query = query.range(offset, offset + limit - 1);
+        const { data, error, count } = await query;
+        if (error)
+            throw mapSupabaseError(error, collection);
+        return {
+            items: (data ?? []),
+            totalItems: count ?? 0,
+            page: Math.floor(offset / limit) + 1,
+            perPage: limit,
+        };
+    }
+    async textSearch(collection, query, options) {
+        const limit = options?.limit ?? 20;
+        // Try tsvector search first
+        try {
+            let q = this.client
+                .from(collection)
+                .select('*')
+                .textSearch('search_vector', query, { type: 'plain', config: 'english' })
+                .limit(limit);
+            q = applyFilter(q, options?.filter);
+            const { data, error } = await q;
+            // If tsvector query succeeded (no error), return results even if empty
+            // Only fall through to ILIKE if the column/function doesn't exist (error)
+            if (!error) {
+                return (data ?? []);
+            }
+            // Error indicates search_vector column likely doesn't exist — fall through
+        }
+        catch {
+            // search_vector column may not exist — fall through to ILIKE
+        }
+        // ILIKE fallback
+        const fields = options?.fields ?? ['title', 'content'];
+        const escaped = escapeIlike(query);
+        const orClauses = fields.map((f) => `${f}.ilike.%${escaped}%`).join(',');
+        let q = this.client
+            .from(collection)
+            .select('*')
+            .or(orClauses)
+            .order('created_at', { ascending: false })
+            .limit(limit);
+        q = applyFilter(q, options?.filter);
+        const { data, error } = await q;
+        if (error)
+            throw mapSupabaseError(error, collection);
+        return (data ?? []);
+    }
+    async update(collection, id, data) {
+        const { data: result, error } = await this.client
+            .from(collection)
+            .update(data)
+            .eq('id', id)
+            .select()
+            .single();
+        if (error)
+            throw mapSupabaseError(error, collection);
+        return result;
+    }
+    async delete(collection, id) {
+        const { error } = await this.client
+            .from(collection)
+            .delete()
+            .eq('id', id);
+        if (error)
+            throw mapSupabaseError(error, collection);
+    }
+    async upsert(collection, data, uniqueFields) {
+        // Build a query to find existing record by unique fields
+        let query = this.client.from(collection).select('id');
+        for (const field of uniqueFields) {
+            const value = data[field];
+            if (typeof value === 'string') {
+                const escaped = value.replace(/[\\%_]/g, '\\$&');
+                query = query.ilike(field, escaped);
+            }
+            else {
+                query = query.eq(field, value);
+            }
+        }
+        const { data: existing } = await query.limit(1).maybeSingle();
+        if (existing) {
+            return this.update(collection, existing.id, data);
+        }
+        return this.create(collection, data);
+    }
+    async count(collection, filter) {
+        let query = this.client.from(collection).select('id', { count: 'exact', head: true });
+        query = applyFilter(query, filter);
+        const { count, error } = await query;
+        if (error)
+            throw mapSupabaseError(error, collection);
+        return count ?? 0;
+    }
+    async collectionExists(collection) {
+        const { error } = await this.client
+            .from(collection)
+            .select('id', { count: 'exact', head: true })
+            .limit(0);
+        if (!error)
+            return true;
+        // PGRST205 = not in schema cache = table doesn't exist
+        if (error.code === 'PGRST205' || error.code === '42P01' || error.code === 'PGRST106') {
+            return false;
+        }
+        if (error.message?.includes('relation') && error.message?.includes('does not exist')) {
+            return false;
+        }
+        // Some other error — assume table exists but there's a different issue
+        return true;
+    }
+    async listCollections() {
+        // Query pg_tables for tables in the public schema
+        const { data, error } = await this.client
+            .rpc('get_public_tables');
+        if (error) {
+            // Fallback: try information_schema
+            const { data: fallbackData, error: fallbackError } = await this.client
+                .from('information_schema.tables')
+                .select('table_name')
+                .eq('table_schema', 'public')
+                .eq('table_type', 'BASE TABLE');
+            if (fallbackError)
+                throw mapSupabaseError(fallbackError);
+            return (fallbackData ?? []).map((r) => r.table_name);
+        }
+        return (data ?? []).map((r) => r.table_name);
+    }
+}
+/**
+ * Escape special ILIKE characters: \, %, _
+ */
+function escapeIlike(input) {
+    return input.replace(/[\\%_]/g, '\\$&');
+}
+/**
+ * Apply Filter (OR-of-AND groups) to a Supabase query.
+ * Uses `any` for the query type since PostgREST builder types are complex generics.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function applyFilter(query, filter) {
+    if (!filter || filter.length === 0)
+        return query;
+    if (filter.length === 1 && filter[0].length === 1) {
+        return applyClause(query, filter[0][0]);
+    }
+    if (filter.length === 1) {
+        let q = query;
+        for (const clause of filter[0]) {
+            q = applyClause(q, clause);
+        }
+        return q;
+    }
+    // Multiple OR groups: build .or() string
+    const orParts = filter.map((andGroup) => {
+        if (andGroup.length === 1) {
+            return clauseToSupabaseOr(andGroup[0]);
+        }
+        return `and(${andGroup.map(clauseToSupabaseOr).join(',')})`;
+    });
+    return query.or(orParts.join(','));
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function applyClause(query, clause) {
+    const { field, op, value } = clause;
+    switch (op) {
+        case 'eq': return query.eq(field, value);
+        case 'neq': return query.neq(field, value);
+        case 'gt': return query.gt(field, value);
+        case 'gte': return query.gte(field, value);
+        case 'lt': return query.lt(field, value);
+        case 'lte': return query.lte(field, value);
+        case 'like': return query.ilike(field, `%${escapeIlike(value)}%`);
+        case 'in': return query.in(field, value);
+        case 'contains': return query.contains(field, [value]);
+        default: return query.eq(field, value);
+    }
+}
+/**
+ * Validate a field name contains only safe characters (alphanumeric + underscore + dot).
+ * Prevents filter injection via field names.
+ */
+function validateFieldName(field) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_.]*$/.test(field)) {
+        throw new AdapterError('VALIDATION_ERROR', `Invalid field name: ${field}`);
+    }
+}
+/**
+ * Encode a value for safe interpolation into PostgREST filter strings.
+ * URL-encodes characters that have special meaning in PostgREST syntax.
+ */
+function encodeFilterValue(value) {
+    return encodeURIComponent(String(value));
+}
+function clauseToSupabaseOr(clause) {
+    const { field, op, value } = clause;
+    validateFieldName(field);
+    switch (op) {
+        case 'eq': return `${field}.eq.${encodeFilterValue(value)}`;
+        case 'neq': return `${field}.neq.${encodeFilterValue(value)}`;
+        case 'gt': return `${field}.gt.${encodeFilterValue(value)}`;
+        case 'gte': return `${field}.gte.${encodeFilterValue(value)}`;
+        case 'lt': return `${field}.lt.${encodeFilterValue(value)}`;
+        case 'lte': return `${field}.lte.${encodeFilterValue(value)}`;
+        case 'like': return `${field}.ilike.%${encodeFilterValue(escapeIlike(value))}%`;
+        case 'in': return `${field}.in.(${value.map(v => encodeFilterValue(v)).join(',')})`;
+        case 'contains': return `${field}.cs.{${encodeFilterValue(value)}}`;
+        default: return `${field}.eq.${encodeFilterValue(value)}`;
+    }
+}
+/**
+ * Map Supabase/PostgREST errors to AdapterError codes.
+ */
+function mapSupabaseError(error, collection) {
+    const code = error.code ?? '';
+    const message = error.message ?? 'Unknown Supabase error';
+    // Collection/table not found
+    if (code === 'PGRST205' || code === '42P01' || code === 'PGRST106') {
+        return new AdapterError('COLLECTION_NOT_FOUND', `Table '${collection ?? 'unknown'}' not found`);
+    }
+    if (message.includes('relation') && message.includes('does not exist')) {
+        return new AdapterError('COLLECTION_NOT_FOUND', `Table '${collection ?? 'unknown'}' not found`);
+    }
+    // Record not found
+    if (code === 'PGRST116') {
+        return new AdapterError('RECORD_NOT_FOUND', `Record not found in '${collection ?? 'unknown'}'`);
+    }
+    // Unique violation
+    if (code === '23505') {
+        return new AdapterError('UNIQUE_VIOLATION', message);
+    }
+    // Validation errors
+    if (code === '23502' || code === '23503' || code === '22001') {
+        return new AdapterError('VALIDATION_ERROR', message);
+    }
+    // Auth errors
+    if (code === '42501' || code === 'PGRST301') {
+        return new AdapterError('AUTH_ERROR', message);
+    }
+    // Connection errors
+    if (message.includes('fetch failed') || message.includes('ENOTFOUND') || message.includes('ECONNREFUSED')) {
+        return new AdapterError('CONNECTION_ERROR', `Cannot connect to Supabase`);
+    }
+    return new AdapterError('UNKNOWN', message);
+}
+//# sourceMappingURL=supabase.js.map

package/dist/adapter/supabase.js.map

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

package/dist/adapter/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * DataAdapter interface — the core abstraction between tools and backends.
+ *
+ * All tools interact with data through this interface.
+ * PocketBase and Supabase adapters implement it.
+ * SchemaMapProxy wraps any adapter to remap collection names.
+ */
+export interface PageOptions {
+    limit?: number;
+    offset?: number;
+}
+export interface SortClause {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+/**
+ * Filter as OR-of-AND groups.
+ * Each inner group is ANDed; outer groups are ORed.
+ * Example: [[{field:'type',op:'eq',value:'fact'}]] means type = 'fact'
+ * Example: [[{field:'type',op:'eq',value:'fact'}],[{field:'type',op:'eq',value:'pattern'}]]
+ *   means type = 'fact' OR type = 'pattern'
+ */
+export interface FilterClause {
+    field: string;
+    op: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'in' | 'contains';
+    value: string | number | boolean | string[] | null;
+}
+export type Filter = FilterClause[][];
+export interface ListResult<T> {
+    items: T[];
+    totalItems: number;
+    page: number;
+    perPage: number;
+}
+export interface DataAdapter {
+    /** Backend identifier */
+    readonly backend: 'pocketbase' | 'supabase';
+    /** Create a record in a collection */
+    create<T extends Record<string, unknown>>(collection: string, data: Record<string, unknown>): Promise<T>;
+    /** Get a single record by ID */
+    getOne<T extends Record<string, unknown>>(collection: string, id: string): Promise<T>;
+    /** List records with optional filters, sorting, and pagination */
+    list<T extends Record<string, unknown>>(collection: string, options?: {
+        filter?: Filter;
+        sort?: SortClause[];
+        page?: PageOptions;
+    }): Promise<ListResult<T>>;
+    /** Full-text search on a collection */
+    textSearch<T extends Record<string, unknown>>(collection: string, query: string, options?: {
+        fields?: string[];
+        filter?: Filter;
+        limit?: number;
+    }): Promise<T[]>;
+    /** Update a record by ID (partial update) */
+    update<T extends Record<string, unknown>>(collection: string, id: string, data: Record<string, unknown>): Promise<T>;
+    /** Delete a record by ID */
+    delete(collection: string, id: string): Promise<void>;
+    /** Upsert: create or update based on unique fields */
+    upsert<T extends Record<string, unknown>>(collection: string, data: Record<string, unknown>, uniqueFields: string[]): Promise<T>;
+    /** Count records matching optional filter */
+    count(collection: string, filter?: Filter): Promise<number>;
+    /** Check if a collection exists */
+    collectionExists(collection: string): Promise<boolean>;
+    /** List all collection names */
+    listCollections(): Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapter/types.d.ts.map

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

package/dist/adapter/types.js

@@ -0,0 +1,9 @@
+/**
+ * DataAdapter interface — the core abstraction between tools and backends.
+ *
+ * All tools interact with data through this interface.
+ * PocketBase and Supabase adapters implement it.
+ * SchemaMapProxy wraps any adapter to remap collection names.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapter/types.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Configuration parsing from environment variables.
+ *
+ * SB_BACKEND: 'pocketbase' | 'supabase' (required)
+ * SB_POCKETBASE_URL: PocketBase server URL (required if backend=pocketbase)
+ * SB_POCKETBASE_ADMIN_EMAIL: PocketBase admin email (required if backend=pocketbase)
+ * SB_POCKETBASE_ADMIN_PASSWORD: PocketBase admin password (required if backend=pocketbase)
+ * SB_SUPABASE_URL: Supabase project URL (required if backend=supabase)
+ * SB_SUPABASE_KEY: Supabase service role key (required if backend=supabase)
+ * SB_SCHEMA_MAP: JSON string mapping logical names to actual table names (optional)
+ * SB_RESEND_API_KEY: Resend API key for email sending (optional)
+ */
+export type Backend = 'pocketbase' | 'supabase';
+export interface PocketBaseConfig {
+    backend: 'pocketbase';
+    pocketbaseUrl: string;
+    pocketbaseAdminEmail: string;
+    pocketbaseAdminPassword: string;
+    schemaMap: Record<string, string>;
+    resendApiKey?: string;
+}
+export interface SupabaseConfig {
+    backend: 'supabase';
+    supabaseUrl: string;
+    supabaseKey: string;
+    schemaMap: Record<string, string>;
+    resendApiKey?: string;
+}
+export type Config = PocketBaseConfig | SupabaseConfig;
+export declare function parseConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,MAAM,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAEvD,wBAAgB,WAAW,IAAI,MAAM,CA4BpC"}

package/dist/config.js

@@ -0,0 +1,62 @@
+/**
+ * Configuration parsing from environment variables.
+ *
+ * SB_BACKEND: 'pocketbase' | 'supabase' (required)
+ * SB_POCKETBASE_URL: PocketBase server URL (required if backend=pocketbase)
+ * SB_POCKETBASE_ADMIN_EMAIL: PocketBase admin email (required if backend=pocketbase)
+ * SB_POCKETBASE_ADMIN_PASSWORD: PocketBase admin password (required if backend=pocketbase)
+ * SB_SUPABASE_URL: Supabase project URL (required if backend=supabase)
+ * SB_SUPABASE_KEY: Supabase service role key (required if backend=supabase)
+ * SB_SCHEMA_MAP: JSON string mapping logical names to actual table names (optional)
+ * SB_RESEND_API_KEY: Resend API key for email sending (optional)
+ */
+export function parseConfig() {
+    const backend = requireEnv('SB_BACKEND');
+    if (backend !== 'pocketbase' && backend !== 'supabase') {
+        throw new Error(`SB_BACKEND must be 'pocketbase' or 'supabase', got '${backend}'`);
+    }
+    const schemaMap = parseSchemaMap(process.env.SB_SCHEMA_MAP);
+    const resendApiKey = process.env.SB_RESEND_API_KEY || undefined;
+    if (backend === 'pocketbase') {
+        return {
+            backend,
+            pocketbaseUrl: requireEnv('SB_POCKETBASE_URL'),
+            pocketbaseAdminEmail: requireEnv('SB_POCKETBASE_ADMIN_EMAIL'),
+            pocketbaseAdminPassword: requireEnv('SB_POCKETBASE_ADMIN_PASSWORD'),
+            schemaMap,
+            resendApiKey,
+        };
+    }
+    return {
+        backend,
+        supabaseUrl: requireEnv('SB_SUPABASE_URL'),
+        supabaseKey: requireEnv('SB_SUPABASE_KEY'),
+        schemaMap,
+        resendApiKey,
+    };
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return value;
+}
+function parseSchemaMap(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('SB_SCHEMA_MAP must be a JSON object');
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new Error(`SB_SCHEMA_MAP is not valid JSON: ${err.message}`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAY,CAAC;IAEpD,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,uDAAuD,OAAO,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,CAAC;IAEhE,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO;YACP,aAAa,EAAE,UAAU,CAAC,mBAAmB,CAAC;YAC9C,oBAAoB,EAAE,UAAU,CAAC,2BAA2B,CAAC;YAC7D,uBAAuB,EAAE,UAAU,CAAC,8BAA8B,CAAC;YACnE,SAAS;YACT,YAAY;SACb,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO;QACP,WAAW,EAAE,UAAU,CAAC,iBAAiB,CAAC;QAC1C,WAAW,EAAE,UAAU,CAAC,iBAAiB,CAAC;QAC1C,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,GAAuB;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAgC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/errors/adapter-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adapter error taxonomy.
+ *
+ * All adapter implementations throw AdapterError with a specific code.
+ * Tool handlers use handleAdapterError() to convert these to safe MCP responses.
+ */
+export type AdapterErrorCode = 'COLLECTION_NOT_FOUND' | 'RECORD_NOT_FOUND' | 'VALIDATION_ERROR' | 'UNIQUE_VIOLATION' | 'CONNECTION_ERROR' | 'AUTH_ERROR' | 'UNKNOWN';
+export declare class AdapterError extends Error {
+    readonly code: AdapterErrorCode;
+    constructor(code: AdapterErrorCode, message: string);
+}
+//# sourceMappingURL=adapter-error.d.ts.map

package/dist/errors/adapter-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-error.d.ts","sourceRoot":"","sources":["../../src/errors/adapter-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,gBAAgB,GACxB,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,YAAY,GACZ,SAAS,CAAC;AAEd,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBAEpB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKpD"}

package/dist/errors/adapter-error.js

@@ -0,0 +1,15 @@
+/**
+ * Adapter error taxonomy.
+ *
+ * All adapter implementations throw AdapterError with a specific code.
+ * Tool handlers use handleAdapterError() to convert these to safe MCP responses.
+ */
+export class AdapterError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'AdapterError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=adapter-error.js.map

package/dist/errors/adapter-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-error.js","sourceRoot":"","sources":["../../src/errors/adapter-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IAEhC,YAAY,IAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @second-brain/data-mcp — entry point
+ *
+ * Parses configuration, creates the appropriate adapter,
+ * builds the MCP server, and connects via stdio transport.
+ */
+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":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * @second-brain/data-mcp — entry point
+ *
+ * Parses configuration, creates the appropriate adapter,
+ * builds the MCP server, and connects via stdio transport.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { parseConfig } from './config.js';
+import { createAdapter } from './adapter/factory.js';
+import { createServer } from './server.js';
+async function main() {
+    try {
+        const config = parseConfig();
+        const adapter = createAdapter(config);
+        const server = createServer(adapter);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error(`[data-mcp] Started with ${config.backend} backend`);
+    }
+    catch (error) {
+        console.error('[data-mcp] Fatal error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/search/alias-expansion.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Entity alias expansion for knowledge recall.
+ *
+ * Loads aliases from the entity_aliases collection and expands query tokens.
+ * Example: "payment stuff" -> ["payment", "stuff", "stripe", "checkout", "pricing", "invoice"]
+ *
+ * Degrades silently if entity_aliases table is missing.
+ */
+import type { DataAdapter } from '../adapter/types.js';
+/**
+ * AliasExpander — encapsulates alias cache and expansion logic.
+ *
+ * Takes a DataAdapter in its constructor. The cache is per-instance,
+ * making it easy to test without module-level singletons.
+ */
+export declare class AliasExpander {
+    private readonly adapter;
+    private cache;
+    private cacheTimestamp;
+    constructor(adapter: DataAdapter);
+    /**
+     * Expand a search query with entity aliases.
+     *
+     * Tokenizes the query, looks up each token in the alias map,
+     * and adds expanded terms to the result.
+     *
+     * Returns deduplicated array of all query terms (original + expansions).
+     */
+    expandQuery(query: string): Promise<string[]>;
+    /** Clear the internal alias cache (useful for testing) */
+    clearCache(): void;
+    /**
+     * Load all aliases from the entity_aliases collection.
+     * Builds a map: alias -> [canonical, ...other_aliases_for_same_canonical]
+     * Also maps: canonical -> [all its aliases]
+     */
+    private loadAliases;
+}
+/** Create an AliasExpander for the given adapter */
+export declare function createAliasExpander(adapter: DataAdapter): AliasExpander;
+/**
+ * Convenience function: expand a search query with entity aliases.
+ *
+ * Uses a shared expander per adapter for caching. For repeated calls,
+ * prefer creating and reusing an AliasExpander instance directly.
+ */
+export declare function expandQueryWithAliases(adapter: DataAdapter, query: string): Promise<string[]>;
+/**
+ * Clear all shared alias caches.
+ * @deprecated Use AliasExpander class instances with clearCache() instead.
+ */
+export declare function clearAliasCache(): void;
+//# sourceMappingURL=alias-expansion.d.ts.map

package/dist/search/alias-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-expansion.d.ts","sourceRoot":"","sources":["../../src/search/alias-expansion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASvD;;;;;GAKG;AACH,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,cAAc,CAAK;gBAEE,OAAO,EAAE,WAAW;IAEjD;;;;;;;OAOG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBnD,0DAA0D;IAC1D,UAAU,IAAI,IAAI;IAKlB;;;;OAIG;YACW,WAAW;CAqD1B;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAEvE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AAKD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC"}