@nuberea/sdk 0.0.1

package/dist/cli/index.js

@@ -0,0 +1,417 @@
+#!/usr/bin/env node
+/**
+ * NuBerea CLI
+ *
+ * Command-line interface for the NuBerea biblical data platform.
+ *
+ * Usage:
+ *   nuberea login              — Authenticate (opens browser)
+ *   nuberea logout             — Clear stored credentials
+ *   nuberea tools              — List available MCP tools
+ *   nuberea tool <name> [json] — Call an MCP tool
+ *   nuberea query <sql>        — Run a SQL analytics query
+ *   nuberea databases          — List available databases
+ *   nuberea describe <db> <tbl>— Describe a table
+ *   nuberea introspect <schema>— Deep schema introspection
+ *   nuberea verse <ref>        — Get a KJV verse (e.g., "John 1:1")
+ *   nuberea search <text>      — Search KJV text
+ *   nuberea greek <word>       — Look up a Greek word in LSJ
+ *   nuberea hebrew <strong>    — Look up a Hebrew Strong's number in BDB
+ */
+import { NuBerea } from '../client.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function usage() {
+    console.log(`
+  nuberea — NuBerea biblical data platform CLI
+
+  AUTHENTICATION
+    login                    Sign in (opens browser)
+    logout                   Clear stored credentials
+    status                   Check authentication status
+
+  MCP TOOLS
+    tools                    List all available tools
+    tool <name> [args_json]  Call a tool by name
+                             e.g., nuberea tool bible_kjv_get_verse '{"book":"John","chapter":1,"verse":1}'
+    resources                List available MCP resources
+    resource <uri>           Read an MCP resource by URI
+    mcp <method> [params]    Send a raw MCP JSON-RPC request
+
+  ANALYTICS
+    query <sql>              Execute a SQL query
+    databases                List databases and tables
+    describe <db> <table>    Describe table columns
+    introspect <schema>      Deep schema inspection (columns, counts, samples)
+    stats                    Row counts for all tables
+
+  SHORTCUTS
+    verse <book> <ch>:<vs>   Get a KJV verse
+    search <text>            Search KJV text
+    greek <word>             Look up Greek word in LSJ
+    hebrew <strong>          Look up Hebrew Strong's number in BDB
+
+  OPTIONS
+    --json                   Output raw JSON (default: formatted)
+    --limit <n>              Row limit for queries (default: 100)
+    --session                Use MCP session mode (initialize + session tracking)
+    --base-url <url>         Override API base URL
+    --token <token>          Use pre-set access token
+
+  ENVIRONMENT
+    NUBEREA_BASE_URL         API base URL
+    NUBEREA_ACCESS_TOKEN     Pre-set access token
+    NUBEREA_FIREBASE_TOKEN   Pre-set Firebase token (skip browser)
+`);
+}
+function die(msg) {
+    console.error(`error: ${msg}`);
+    process.exit(1);
+}
+function parseArgs(argv) {
+    const flags = {};
+    const positional = [];
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith('--')) {
+                flags[key] = next;
+                i += 2;
+            }
+            else {
+                flags[key] = true;
+                i += 1;
+            }
+        }
+        else {
+            positional.push(arg);
+            i += 1;
+        }
+    }
+    return {
+        command: positional[0] ?? '',
+        args: positional.slice(1),
+        flags,
+    };
+}
+function formatJson(data, raw) {
+    if (raw)
+        return JSON.stringify(data);
+    return JSON.stringify(data, null, 2);
+}
+function createClient(flags) {
+    return new NuBerea({
+        baseUrl: flags['base-url'] ?? process.env.NUBEREA_BASE_URL,
+        accessToken: flags.token ?? process.env.NUBEREA_ACCESS_TOKEN,
+        firebaseToken: process.env.NUBEREA_FIREBASE_TOKEN,
+        useSession: !!flags.session,
+    });
+}
+// ============================================================================
+// Commands
+// ============================================================================
+async function cmdLogin(client) {
+    console.log('Signing in to NuBerea...');
+    await client.login();
+    console.log('✅ Authenticated. Tokens saved to ~/.nuberea/tokens.json');
+}
+async function cmdLogout(client) {
+    client.logout();
+    console.log('✅ Logged out. Tokens cleared.');
+}
+async function cmdStatus(client) {
+    if (client.isAuthenticated()) {
+        console.log('✅ Authenticated');
+    }
+    else {
+        console.log('❌ Not authenticated. Run: nuberea login');
+    }
+}
+async function cmdTools(client, raw) {
+    const tools = await client.tools();
+    if (raw) {
+        console.log(formatJson(tools, true));
+        return;
+    }
+    console.log(`\n${tools.length} tools available:\n`);
+    for (const tool of tools) {
+        console.log(`  ${tool.name}`);
+        if (tool.description) {
+            const desc = tool.description.split('\n')[0].substring(0, 80);
+            console.log(`    ${desc}`);
+        }
+    }
+    console.log();
+}
+async function cmdTool(client, args, raw) {
+    const name = args[0];
+    if (!name)
+        die('Usage: nuberea tool <name> [args_json]');
+    let toolArgs = {};
+    if (args[1]) {
+        try {
+            toolArgs = JSON.parse(args[1]);
+        }
+        catch {
+            die(`Invalid JSON: ${args[1]}`);
+        }
+    }
+    const result = await client.tool(name, toolArgs);
+    if (raw) {
+        console.log(formatJson(result, true));
+    }
+    else {
+        for (const content of result.content) {
+            if (content.type === 'text') {
+                console.log(content.text);
+            }
+        }
+    }
+}
+async function cmdQuery(client, args, flags, raw) {
+    const sql = args.join(' ');
+    if (!sql)
+        die('Usage: nuberea query <sql>');
+    const limit = flags.limit ? parseInt(flags.limit, 10) : 100;
+    const result = await client.query(sql, { limit });
+    if (raw) {
+        console.log(formatJson(result, true));
+        return;
+    }
+    console.log(`\n${result.rowCount} rows (${result.executionTimeMs}ms)${result.truncated ? ' [truncated]' : ''}\n`);
+    if (result.rows.length === 0)
+        return;
+    // Simple table output
+    const cols = result.columns;
+    const widths = cols.map((c) => Math.max(c.length, ...result.rows.map((r) => String(r[c] ?? '').substring(0, 60).length)));
+    const header = cols.map((c, i) => c.padEnd(widths[i])).join(' | ');
+    const separator = widths.map((w) => '-'.repeat(w)).join('-+-');
+    console.log(header);
+    console.log(separator);
+    for (const row of result.rows) {
+        const line = cols
+            .map((c, i) => String(row[c] ?? '').substring(0, 60).padEnd(widths[i]))
+            .join(' | ');
+        console.log(line);
+    }
+    console.log();
+}
+async function cmdDatabases(client, raw) {
+    const dbs = await client.databases();
+    if (raw) {
+        console.log(formatJson(dbs, true));
+        return;
+    }
+    console.log(`\n${dbs.length} databases:\n`);
+    for (const db of dbs) {
+        const tables = db.tables.map((t) => t.table).join(', ');
+        console.log(`  ${db.name.padEnd(15)} ${db.description}`);
+        console.log(`  ${''.padEnd(15)} tables: ${tables}`);
+    }
+    console.log();
+}
+async function cmdDescribe(client, args, raw) {
+    if (args.length < 2)
+        die('Usage: nuberea describe <database> <table>');
+    const columns = await client.describe(args[0], args[1]);
+    if (raw) {
+        console.log(formatJson(columns, true));
+        return;
+    }
+    console.log(`\n${args[0]}.${args[1]}:\n`);
+    for (const col of columns) {
+        console.log(`  ${col.column_name.padEnd(25)} ${col.column_type.padEnd(15)} ${col.null === 'YES' ? 'nullable' : ''}`);
+    }
+    console.log();
+}
+async function cmdIntrospect(client, args, raw) {
+    if (args.length < 1)
+        die('Usage: nuberea introspect <schema> [table]');
+    const result = await client.introspect(args[0], args[1]);
+    if (raw) {
+        console.log(formatJson(result, true));
+        return;
+    }
+    console.log(`\nSchema: ${result.schema} — ${result.description}\n`);
+    for (const table of result.tables) {
+        console.log(`  ${table.table} (${(table.rowCount ?? 0).toLocaleString()} rows)`);
+        for (const col of table.columns ?? []) {
+            console.log(`    ${col.column_name.padEnd(25)} ${col.column_type}`);
+        }
+        if (table.sampleRows?.length) {
+            console.log(`    Sample: ${JSON.stringify(table.sampleRows[0]).substring(0, 120)}...`);
+        }
+        console.log();
+    }
+}
+async function cmdVerse(client, args, raw) {
+    // Parse "John 1:1" or "John" "1:1" or "John" "1" "1"
+    const joined = args.join(' ');
+    const match = joined.match(/^(.+?)\s+(\d+):(\d+)$/);
+    if (!match)
+        die('Usage: nuberea verse <book> <chapter>:<verse>  (e.g., "John 1:1")');
+    const [, book, chapter, verse] = match;
+    const text = await client.verse(book, parseInt(chapter, 10), parseInt(verse, 10));
+    if (raw) {
+        console.log(text);
+    }
+    else {
+        console.log(`\n${text}\n`);
+    }
+}
+async function cmdSearch(client, args, raw) {
+    const text = args.join(' ');
+    if (!text)
+        die('Usage: nuberea search <text>');
+    const result = await client.search(text);
+    if (raw) {
+        console.log(result);
+    }
+    else {
+        console.log(`\n${result}\n`);
+    }
+}
+async function cmdGreek(client, args, raw) {
+    const word = args[0];
+    if (!word)
+        die('Usage: nuberea greek <word>');
+    const result = await client.greekLookup(word);
+    if (raw) {
+        console.log(result);
+    }
+    else {
+        console.log(`\n${result}\n`);
+    }
+}
+async function cmdHebrew(client, args, raw) {
+    const strong = args[0];
+    if (!strong)
+        die('Usage: nuberea hebrew <strong_number>');
+    const result = await client.hebrewStrong(strong);
+    if (raw) {
+        console.log(result);
+    }
+    else {
+        console.log(`\n${result}\n`);
+    }
+}
+async function cmdResources(client, raw) {
+    const resources = await client.resources();
+    if (raw) {
+        console.log(formatJson(resources, true));
+        return;
+    }
+    console.log(`\n${resources.length} resources:\n`);
+    for (const r of resources) {
+        console.log(`  ${r.uri}`);
+        if (r.description) {
+            console.log(`    ${r.description.substring(0, 80)}`);
+        }
+    }
+    console.log();
+}
+async function cmdResource(client, args, raw) {
+    const uri = args[0];
+    if (!uri)
+        die('Usage: nuberea resource <uri>');
+    const contents = await client.resource(uri);
+    if (raw) {
+        console.log(formatJson(contents, true));
+        return;
+    }
+    for (const content of contents) {
+        console.log(`\n--- ${content.uri} (${content.mimeType ?? 'text/plain'}) ---`);
+        if (content.text) {
+            console.log(content.text);
+        }
+        else if (content.blob) {
+            console.log(`[binary: ${content.blob.length} bytes base64]`);
+        }
+    }
+    console.log();
+}
+async function cmdMcpRaw(client, args, raw) {
+    const method = args[0];
+    if (!method)
+        die('Usage: nuberea mcp <method> [params_json]');
+    let params;
+    if (args[1]) {
+        try {
+            params = JSON.parse(args[1]);
+        }
+        catch {
+            die(`Invalid JSON: ${args[1]}`);
+        }
+    }
+    const result = await client.mcpRequest(method, params);
+    console.log(formatJson(result, !raw));
+}
+// ============================================================================
+// Main
+// ============================================================================
+async function main() {
+    const { command, args, flags } = parseArgs(process.argv.slice(2));
+    const raw = !!flags.json;
+    if (!command || command === 'help' || flags.help) {
+        usage();
+        process.exit(0);
+    }
+    const client = createClient(flags);
+    // Commands that don't need auth
+    if (command === 'login')
+        return cmdLogin(client);
+    if (command === 'logout')
+        return cmdLogout(client);
+    if (command === 'status')
+        return cmdStatus(client);
+    // Tools listing doesn't need auth (public endpoint)
+    if (command === 'tools')
+        return cmdTools(client, raw);
+    // All other commands need auth — ensure we have it
+    if (!client.isAuthenticated() && !flags.token && !process.env.NUBEREA_ACCESS_TOKEN) {
+        console.log('Not authenticated. Signing in...\n');
+        await client.login();
+    }
+    switch (command) {
+        case 'tool':
+            return cmdTool(client, args, raw);
+        case 'resources':
+            return cmdResources(client, raw);
+        case 'resource':
+            return cmdResource(client, args, raw);
+        case 'mcp':
+            return cmdMcpRaw(client, args, raw);
+        case 'query':
+        case 'sql':
+            return cmdQuery(client, args, flags, raw);
+        case 'databases':
+        case 'dbs':
+            return cmdDatabases(client, raw);
+        case 'describe':
+        case 'desc':
+            return cmdDescribe(client, args, raw);
+        case 'introspect':
+            return cmdIntrospect(client, args, raw);
+        case 'verse':
+            return cmdVerse(client, args, raw);
+        case 'search':
+            return cmdSearch(client, args, raw);
+        case 'greek':
+            return cmdGreek(client, args, raw);
+        case 'hebrew':
+            return cmdHebrew(client, args, raw);
+        default:
+            console.error(`Unknown command: ${command}`);
+            usage();
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(`\n❌ ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,159 @@
+/**
+ * NuBerea Client — Main SDK entry point.
+ *
+ * Wraps authentication, MCP tool calls, and REST analytics queries
+ * into a single, ergonomic interface.
+ */
+import { type AuthConfig } from './auth.js';
+import { type McpInitializeResult, type McpResource, type McpResourceContent } from './mcp.js';
+import type { ToolResult, ToolInfo, QueryResult, QueryFormat, DatabaseInfo, ColumnInfo, SchemaIntrospection, StatsEntry } from './types.js';
+export interface NuBereaConfig {
+    /** OAuth / MCP server configuration */
+    auth?: Partial<AuthConfig>;
+    /** Override: OAuth server base URL */
+    baseUrl?: string;
+    /** Override: MCP endpoint URL */
+    mcpUrl?: string;
+    /** Pre-set access token (skip login) */
+    accessToken?: string;
+    /** Pre-set Firebase token (skip browser sign-in) */
+    firebaseToken?: string;
+    /** Use MCP session mode (initialize + session tracking) vs stateless */
+    useSession?: boolean;
+}
+export type NuBereaTokens = {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+};
+export declare class NuBerea {
+    private auth;
+    private baseUrl;
+    private mcpUrl;
+    private staticToken;
+    private firebaseToken;
+    private useSession;
+    private mcpClient;
+    constructor(config?: NuBereaConfig);
+    /**
+     * Authenticate with the NuBerea platform.
+     * Opens a browser for Firebase sign-in if no token is cached.
+     */
+    login(): Promise<void>;
+    /**
+     * Check if the client has valid credentials.
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Clear stored credentials.
+     */
+    logout(): void;
+    private getToken;
+    /**
+     * Get (or create) the MCP client instance.
+     * Handles token refresh automatically.
+     */
+    private getMcpClient;
+    /**
+     * Initialize an MCP session. Required in session mode before other calls.
+     * In stateless mode (default), this is a no-op.
+     */
+    initialize(): Promise<McpInitializeResult | null>;
+    /**
+     * Send a raw MCP JSON-RPC request.
+     * Use this for any MCP method not covered by the typed methods.
+     */
+    mcpRequest(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List available MCP resources.
+     */
+    resources(): Promise<McpResource[]>;
+    /**
+     * Read an MCP resource by URI.
+     *
+     * @example
+     * ```ts
+     * const contents = await client.resource('macula://hebrew');
+     * console.log(contents[0].text);
+     * ```
+     */
+    resource(uri: string): Promise<McpResourceContent[]>;
+    /**
+     * Close the MCP session (if session-based).
+     */
+    close(): Promise<void>;
+    /**
+     * Get the current MCP session ID (null in stateless mode).
+     */
+    getSessionId(): string | null;
+    /**
+     * List all available MCP tools.
+     * Uses MCP tools/list in session mode, or the public /tools endpoint in stateless mode.
+     */
+    tools(): Promise<ToolInfo[]>;
+    /**
+     * 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);
+     * ```
+     */
+    tool(name: string, args?: Record<string, unknown>): Promise<ToolResult>;
+    /**
+     * Call an MCP tool and return just the text content (convenience).
+     */
+    toolText(name: string, args?: Record<string, unknown>): Promise<string>;
+    /**
+     * Call an MCP tool and parse the text content as JSON (convenience).
+     */
+    toolJson<T = unknown>(name: string, args?: Record<string, unknown>): Promise<T>;
+    /**
+     * 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"
+     * );
+     * ```
+     */
+    query(sql: string, options?: {
+        limit?: number;
+        offset?: number;
+        timeout?: number;
+        format?: QueryFormat;
+    }): Promise<QueryResult>;
+    /**
+     * List all available databases (schemas) and their tables.
+     */
+    databases(): Promise<DatabaseInfo[]>;
+    /**
+     * Describe a table's columns.
+     */
+    describe(database: string, table: string): Promise<ColumnInfo[]>;
+    /**
+     * Deep introspection of a schema — tables, columns, row counts, sample rows.
+     */
+    introspect(schema: string, table?: string): Promise<SchemaIntrospection>;
+    /**
+     * Get row counts for all tables.
+     */
+    stats(): Promise<StatsEntry[]>;
+    /** Get a KJV verse */
+    verse(book: string, chapter: number, verse: number): Promise<string>;
+    /** Search KJV text */
+    search(text: string, limit?: number): Promise<string>;
+    /** Look up a Greek word in LSJ */
+    greekLookup(term: string): Promise<string>;
+    /** Look up a Hebrew word in BDB by Strong's number */
+    hebrewStrong(strong: string): Promise<string>;
+    /** Get Hebrew morphology for a verse */
+    hebrewMorphology(book: string, chapter: number, verse: number): Promise<string>;
+    /** Get Greek morphology for a verse */
+    greekMorphology(book: string, chapter: number, verse: number): Promise<string>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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