@nuberea/sdk 0.0.1

package/dist/client.js

@@ -0,0 +1,306 @@
+/**
+ * NuBerea Client — Main SDK entry point.
+ *
+ * Wraps authentication, MCP tool calls, and REST analytics queries
+ * into a single, ergonomic interface.
+ */
+import { NuBereaAuth } from './auth.js';
+import { McpClient, } from './mcp.js';
+const DEFAULT_BASE = 'https://auth.aws-dev.streamsappsgslbex.com';
+export class NuBerea {
+    auth;
+    baseUrl;
+    mcpUrl;
+    staticToken;
+    firebaseToken;
+    useSession;
+    mcpClient = null;
+    constructor(config) {
+        this.baseUrl = config?.baseUrl ?? config?.auth?.oauthBaseUrl ?? DEFAULT_BASE;
+        this.mcpUrl = config?.mcpUrl ?? config?.auth?.mcpUrl ?? `${this.baseUrl}/mcp`;
+        this.staticToken = config?.accessToken;
+        this.firebaseToken = config?.firebaseToken;
+        this.useSession = config?.useSession ?? false;
+        this.auth = new NuBereaAuth({
+            oauthBaseUrl: this.baseUrl,
+            mcpUrl: this.mcpUrl,
+            ...config?.auth,
+        });
+    }
+    // ==========================================================================
+    // Auth
+    // ==========================================================================
+    /**
+     * Authenticate with the NuBerea platform.
+     * Opens a browser for Firebase sign-in if no token is cached.
+     */
+    async login() {
+        if (this.staticToken)
+            return;
+        await this.auth.login(this.firebaseToken);
+    }
+    /**
+     * Check if the client has valid credentials.
+     */
+    isAuthenticated() {
+        return !!this.staticToken || this.auth.isAuthenticated();
+    }
+    /**
+     * Clear stored credentials.
+     */
+    logout() {
+        this.staticToken = undefined;
+        this.auth.logout();
+    }
+    async getToken() {
+        if (this.staticToken)
+            return this.staticToken;
+        return this.auth.getAccessToken();
+    }
+    /**
+     * Get (or create) the MCP client instance.
+     * Handles token refresh automatically.
+     */
+    async getMcpClient() {
+        const token = await this.getToken();
+        if (!this.mcpClient) {
+            this.mcpClient = new McpClient({
+                mcpUrl: this.mcpUrl,
+                accessToken: token,
+                useSession: this.useSession,
+            });
+        }
+        else {
+            // Update token in case it was refreshed
+            this.mcpClient.setAccessToken(token);
+        }
+        return this.mcpClient;
+    }
+    // ==========================================================================
+    // MCP Protocol — Full MCP operations
+    // ==========================================================================
+    /**
+     * Initialize an MCP session. Required in session mode before other calls.
+     * In stateless mode (default), this is a no-op.
+     */
+    async initialize() {
+        if (!this.useSession)
+            return null;
+        const mcp = await this.getMcpClient();
+        return mcp.initialize();
+    }
+    /**
+     * Send a raw MCP JSON-RPC request.
+     * Use this for any MCP method not covered by the typed methods.
+     */
+    async mcpRequest(method, params) {
+        const mcp = await this.getMcpClient();
+        const res = await mcp.request(method, params);
+        if (res.error)
+            throw new Error(`MCP error: ${JSON.stringify(res.error)}`);
+        return res.result;
+    }
+    /**
+     * List available MCP resources.
+     */
+    async resources() {
+        const mcp = await this.getMcpClient();
+        return mcp.listResources();
+    }
+    /**
+     * Read an MCP resource by URI.
+     *
+     * @example
+     * ```ts
+     * const contents = await client.resource('macula://hebrew');
+     * console.log(contents[0].text);
+     * ```
+     */
+    async resource(uri) {
+        const mcp = await this.getMcpClient();
+        return mcp.readResource(uri);
+    }
+    /**
+     * Close the MCP session (if session-based).
+     */
+    async close() {
+        if (this.mcpClient) {
+            await this.mcpClient.close();
+            this.mcpClient = null;
+        }
+    }
+    /**
+     * Get the current MCP session ID (null in stateless mode).
+     */
+    getSessionId() {
+        return this.mcpClient?.getSessionId() ?? null;
+    }
+    // ==========================================================================
+    // MCP Tools
+    // ==========================================================================
+    /**
+     * List all available MCP tools.
+     * Uses MCP tools/list in session mode, or the public /tools endpoint in stateless mode.
+     */
+    async tools() {
+        if (this.useSession) {
+            const mcp = await this.getMcpClient();
+            return mcp.listTools();
+        }
+        // Stateless: use public endpoint (no auth needed)
+        const res = await fetch(`${this.baseUrl}/tools`);
+        if (!res.ok)
+            throw new Error(`Failed to list tools: HTTP ${res.status}`);
+        const data = (await res.json());
+        return data.tools;
+    }
+    /**
+     * Call an MCP tool by name.
+     *
+     * @example
+     * ```ts
+     * const result = await client.tool('bible_kjv_get_verse', {
+     *   book: 'John', chapter: 1, verse: 1,
+     * });
+     * console.log(result.content[0].text);
+     * ```
+     */
+    async tool(name, args = {}) {
+        const mcp = await this.getMcpClient();
+        return mcp.callTool(name, args);
+    }
+    /**
+     * Call an MCP tool and return just the text content (convenience).
+     */
+    async toolText(name, args = {}) {
+        const result = await this.tool(name, args);
+        const textContent = result.content.find((c) => c.type === 'text');
+        return textContent?.text ?? '';
+    }
+    /**
+     * Call an MCP tool and parse the text content as JSON (convenience).
+     */
+    async toolJson(name, args = {}) {
+        const text = await this.toolText(name, args);
+        return JSON.parse(text);
+    }
+    // ==========================================================================
+    // Analytics / SQL queries
+    // ==========================================================================
+    /**
+     * Execute a SQL query against the unified data platform.
+     *
+     * @example
+     * ```ts
+     * const result = await client.query(
+     *   "SELECT * FROM hebrew.morphemes WHERE book_id = 'Gen' AND chapter = 1 LIMIT 10"
+     * );
+     * ```
+     */
+    async query(sql, options) {
+        const result = await this.tool('analytics_query', {
+            sql,
+            limit: options?.limit ?? 100,
+        });
+        const text = result.content.find((c) => c.type === 'text')?.text ?? '';
+        // analytics_query returns "<summary>\n\n<json>" — extract the JSON part
+        const jsonStart = text.indexOf('[');
+        if (jsonStart === -1) {
+            // Might be an error or empty result
+            return {
+                columns: [],
+                rows: [],
+                rowCount: 0,
+                executionTimeMs: 0,
+                truncated: false,
+                offset: 0,
+            };
+        }
+        const summaryLine = text.substring(0, jsonStart).trim();
+        const rows = JSON.parse(text.substring(jsonStart));
+        const columns = rows.length > 0 ? Object.keys(rows[0]) : [];
+        // Parse summary: "N rows returned in Xms (truncated)"
+        const truncated = summaryLine.includes('truncated');
+        const timeMatch = summaryLine.match(/in (\d+)ms/);
+        const executionTimeMs = timeMatch ? parseInt(timeMatch[1], 10) : 0;
+        return {
+            columns,
+            rows,
+            rowCount: rows.length,
+            executionTimeMs,
+            truncated,
+            offset: options?.offset ?? 0,
+        };
+    }
+    /**
+     * List all available databases (schemas) and their tables.
+     */
+    async databases() {
+        const result = await this.tool('analytics_list_databases');
+        const text = result.content.find((c) => c.type === 'text')?.text ?? '{}';
+        const data = JSON.parse(text);
+        return data.databases;
+    }
+    /**
+     * Describe a table's columns.
+     */
+    async describe(database, table) {
+        const result = await this.tool('analytics_describe_table', { database, table });
+        const text = result.content.find((c) => c.type === 'text')?.text ?? '{}';
+        const data = JSON.parse(text);
+        return data.columns;
+    }
+    /**
+     * Deep introspection of a schema — tables, columns, row counts, sample rows.
+     */
+    async introspect(schema, table) {
+        const args = { schema };
+        if (table)
+            args.table = table;
+        const result = await this.tool('analytics_schema_introspect', args);
+        const text = result.content.find((c) => c.type === 'text')?.text ?? '{}';
+        return JSON.parse(text);
+    }
+    /**
+     * Get row counts for all tables.
+     */
+    async stats() {
+        const result = await this.tool('analytics_list_databases');
+        // This returns the databases list; we'd need a stats tool or use query
+        const text = result.content.find((c) => c.type === 'text')?.text ?? '{}';
+        const data = JSON.parse(text);
+        return data.databases.flatMap((db) => db.tables.map((t) => ({
+            database: db.name,
+            table: t.table,
+            rowCount: t.rowCount ?? 0,
+        })));
+    }
+    // ==========================================================================
+    // Convenience methods (typed shortcuts for common tools)
+    // ==========================================================================
+    /** Get a KJV verse */
+    async verse(book, chapter, verse) {
+        return this.toolText('bible_kjv_get_verse', { book, chapter, verse });
+    }
+    /** Search KJV text */
+    async search(text, limit = 10) {
+        return this.toolText('bible_kjv_search_text', { query: text, limit });
+    }
+    /** Look up a Greek word in LSJ */
+    async greekLookup(term) {
+        return this.toolText('lexicon_lsj_lookup', { term });
+    }
+    /** Look up a Hebrew word in BDB by Strong's number */
+    async hebrewStrong(strong) {
+        return this.toolText('lexicon_bdb_search_strong', { strong });
+    }
+    /** Get Hebrew morphology for a verse */
+    async hebrewMorphology(book, chapter, verse) {
+        return this.toolText('macula_hebrew_query_verse', { book, chapter, verse });
+    }
+    /** Get Greek morphology for a verse */
+    async greekMorphology(book, chapter, verse) {
+        return this.toolText('macula_greek_query_verse', { book, chapter, verse });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * NuBerea SDK
+ *
+ * Client library for the NuBerea biblical data platform.
+ * Supports both MCP (Model Context Protocol) and REST query interfaces.
+ *
+ * @example
+ * ```ts
+ * import { NuBerea } from '@nuberea/sdk';
+ *
+ * const client = new NuBerea();
+ * await client.login();
+ *
+ * // Call any MCP tool
+ * const result = await client.tool('bible_kjv_get_verse', {
+ *   book: 'John', chapter: 1, verse: 1,
+ * });
+ *
+ * // Run SQL analytics
+ * const rows = await client.query(
+ *   'SELECT * FROM hebrew.morphemes WHERE book_id = \'Gen\' AND chapter = 1 LIMIT 10'
+ * );
+ *
+ * // List available tools
+ * const tools = await client.tools();
+ * ```
+ */
+export { NuBerea } from './client.js';
+export type { NuBereaConfig, NuBereaTokens } from './client.js';
+export { NuBereaAuth } from './auth.js';
+export type { AuthConfig } from './auth.js';
+export { McpClient, McpError } from './mcp.js';
+export type { McpClientConfig, McpServerInfo, McpCapabilities, McpInitializeResult, McpResource, McpResourceContent, McpJsonRpcRequest, McpJsonRpcResponse, } from './mcp.js';
+export type { ToolResult, ToolInfo, QueryResult, DatabaseInfo, TableInfo, ColumnInfo, SchemaIntrospection, } from './types.js';
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * NuBerea SDK
+ *
+ * Client library for the NuBerea biblical data platform.
+ * Supports both MCP (Model Context Protocol) and REST query interfaces.
+ *
+ * @example
+ * ```ts
+ * import { NuBerea } from '@nuberea/sdk';
+ *
+ * const client = new NuBerea();
+ * await client.login();
+ *
+ * // Call any MCP tool
+ * const result = await client.tool('bible_kjv_get_verse', {
+ *   book: 'John', chapter: 1, verse: 1,
+ * });
+ *
+ * // Run SQL analytics
+ * const rows = await client.query(
+ *   'SELECT * FROM hebrew.morphemes WHERE book_id = \'Gen\' AND chapter = 1 LIMIT 10'
+ * );
+ *
+ * // List available tools
+ * const tools = await client.tools();
+ * ```
+ */
+export { NuBerea } from './client.js';
+export { NuBereaAuth } from './auth.js';
+export { McpClient, McpError } from './mcp.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,125 @@
+/**
+ * NuBerea MCP Client — Full MCP protocol implementation.
+ *
+ * Implements MCP Streamable HTTP transport:
+ *   - POST /mcp: JSON-RPC requests (initialize, tools/list, tools/call, resources/list, resources/read)
+ *   - Session tracking via mcp-session-id header
+ *   - Stateless mode (no session) and session-based mode
+ *
+ * Can be used standalone or through the higher-level NuBerea client class.
+ */
+import type { ToolInfo, ToolResult } from './types.js';
+export interface McpServerInfo {
+    name: string;
+    version: string;
+}
+export interface McpCapabilities {
+    tools?: Record<string, unknown>;
+    resources?: Record<string, unknown>;
+    prompts?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface McpInitializeResult {
+    protocolVersion: string;
+    serverInfo: McpServerInfo;
+    capabilities: McpCapabilities;
+}
+export interface McpResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface McpResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+}
+export interface McpJsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: Record<string, unknown>;
+    id: string | number;
+}
+export interface McpJsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface McpClientConfig {
+    /** MCP endpoint URL */
+    mcpUrl: string;
+    /** Access token for Authorization header */
+    accessToken: string;
+    /** MCP protocol version (default: "2025-03-26") */
+    protocolVersion?: string;
+    /** Use session-based mode (sends initialize, tracks session ID) */
+    useSession?: boolean;
+}
+export declare class McpClient {
+    private mcpUrl;
+    private accessToken;
+    private protocolVersion;
+    private sessionId;
+    private initialized;
+    private serverInfo;
+    private capabilities;
+    private useSession;
+    private requestId;
+    constructor(config: McpClientConfig);
+    /**
+     * Send a JSON-RPC request to the MCP server.
+     * Handles both plain JSON and SSE response formats.
+     */
+    request(method: string, params?: Record<string, unknown>): Promise<McpJsonRpcResponse>;
+    /**
+     * Send a JSON-RPC notification (no id, no response expected).
+     */
+    notify(method: string, params?: Record<string, unknown>): Promise<void>;
+    /**
+     * Initialize the MCP session.
+     * Must be called before other methods in session-based mode.
+     */
+    initialize(): Promise<McpInitializeResult>;
+    /**
+     * List available tools.
+     */
+    listTools(): Promise<ToolInfo[]>;
+    /**
+     * Call a tool by name.
+     */
+    callTool(name: string, args?: Record<string, unknown>): Promise<ToolResult>;
+    /**
+     * List available resources.
+     */
+    listResources(): Promise<McpResource[]>;
+    /**
+     * Read a resource by URI.
+     */
+    readResource(uri: string): Promise<McpResourceContent[]>;
+    /**
+     * Close the MCP session (sends DELETE request).
+     */
+    close(): Promise<void>;
+    getSessionId(): string | null;
+    getServerInfo(): McpServerInfo | null;
+    getCapabilities(): McpCapabilities | null;
+    isInitialized(): boolean;
+    /**
+     * Update the access token (e.g., after refresh).
+     */
+    setAccessToken(token: string): void;
+    private ensureReady;
+    private parseResponse;
+}
+export declare class McpError extends Error {
+    code: number;
+    constructor(message: string, code: number);
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

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