@gizmodata/hardcharger-mcp 0.0.0 → 2.1.0

package/dist/registry.d.ts

@@ -0,0 +1,45 @@
+import { HardchargerConnection, type ConnectionConfig, type McpConfig } from "./connection.js";
+export declare class UnknownConnectionError extends Error {
+    constructor(name: string, available: string[]);
+}
+export interface ConnectionSummary {
+    name: string;
+    /** The connection's hardcharger:// URI (never carries credentials). */
+    uri: string;
+    host: string;
+    port: number;
+    tls: boolean;
+    auth: string;
+    default_catalog: string | null;
+    default_schema: string | null;
+    current: boolean;
+    connected: boolean;
+}
+/**
+ * Holds one lazily opened HardchargerConnection per configured server. Names are
+ * matched case-insensitively. The first configured connection is the
+ * initial default; `use()` switches it for the rest of the process.
+ */
+export declare class ConnectionRegistry {
+    readonly config: McpConfig;
+    private readonly byName;
+    private readonly order;
+    private currentName;
+    constructor(config: McpConfig, log?: (message: string) => void);
+    /** Names in configuration order. */
+    names(): string[];
+    /** Name of the current default connection. */
+    current(): string;
+    has(name: string): boolean;
+    /** Resolves a connection by name (case-insensitive); undefined/blank means the current default. */
+    get(name?: string): HardchargerConnection;
+    /** Makes `name` the default for subsequent calls; returns its canonical name. */
+    use(name: string): string;
+    all(): HardchargerConnection[];
+    configFor(name?: string): ConnectionConfig;
+    /** Every secret from every connection plus the HTTP bearer token. */
+    secrets(): Array<string | undefined>;
+    redact(text: string): string;
+    summaries(): ConnectionSummary[];
+    close(): Promise<void>;
+}

package/dist/registry.js

@@ -0,0 +1,91 @@
+// Registry of named Hardcharger connections with a switchable default.
+import { HardchargerConnection, redactSecrets } from "./connection.js";
+export class UnknownConnectionError extends Error {
+    constructor(name, available) {
+        super(`Unknown connection "${name}". Available connections: ${available.join(", ")}.`);
+        this.name = "UnknownConnectionError";
+    }
+}
+/**
+ * Holds one lazily opened HardchargerConnection per configured server. Names are
+ * matched case-insensitively. The first configured connection is the
+ * initial default; `use()` switches it for the rest of the process.
+ */
+export class ConnectionRegistry {
+    config;
+    byName = new Map();
+    order = [];
+    currentName;
+    constructor(config, log = (m) => console.error(m)) {
+        this.config = config;
+        if (config.connections.length === 0)
+            throw new Error("At least one connection is required.");
+        for (const c of config.connections) {
+            const conn = new HardchargerConnection(c, (m) => log(config.connections.length > 1 ? `${m} [${c.name}]` : m));
+            this.byName.set(c.name.toLowerCase(), conn);
+            this.order.push(c.name);
+        }
+        this.currentName = config.connections[0].name;
+    }
+    /** Names in configuration order. */
+    names() {
+        return [...this.order];
+    }
+    /** Name of the current default connection. */
+    current() {
+        return this.currentName;
+    }
+    has(name) {
+        return this.byName.has(name.trim().toLowerCase());
+    }
+    /** Resolves a connection by name (case-insensitive); undefined/blank means the current default. */
+    get(name) {
+        const key = (name ?? "").trim();
+        if (key === "")
+            return this.byName.get(this.currentName.toLowerCase());
+        const conn = this.byName.get(key.toLowerCase());
+        if (!conn)
+            throw new UnknownConnectionError(key, this.order);
+        return conn;
+    }
+    /** Makes `name` the default for subsequent calls; returns its canonical name. */
+    use(name) {
+        const conn = this.get(name);
+        this.currentName = conn.config.name;
+        return this.currentName;
+    }
+    all() {
+        return this.order.map((n) => this.byName.get(n.toLowerCase()));
+    }
+    configFor(name) {
+        return this.get(name).config;
+    }
+    /** Every secret from every connection plus the HTTP bearer token. */
+    secrets() {
+        return [...this.all().flatMap((c) => c.secrets()), this.config.mcpBearerToken];
+    }
+    redact(text) {
+        return redactSecrets(text, this.secrets());
+    }
+    summaries() {
+        return this.all().map((c) => {
+            const auth = c.effectiveAuth();
+            return {
+                name: c.config.name,
+                uri: c.config.uri,
+                host: c.config.host,
+                port: c.config.port,
+                tls: c.config.tls,
+                auth: auth.method === "password" ? `password (${auth.user ?? ""})` : auth.method,
+                default_catalog: c.currentSearchPath().catalog ?? null,
+                default_schema: c.currentSearchPath().schema ?? null,
+                current: c.config.name === this.currentName,
+                connected: c.connectedAt !== null,
+            };
+        });
+    }
+    async close() {
+        await Promise.all(this.all().map((c) => c.close().catch(() => undefined)));
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type McpConfig } from "./connection.js";
+import type { AuthenticatedUser } from "./oauth.js";
+import type { SessionInfo } from "./sessions.js";
+import { ConnectionRegistry } from "./registry.js";
+export interface ServerContext {
+    registry: ConnectionRegistry;
+    config: McpConfig;
+    transport: "stdio" | "http";
+    /** Caller verified by the HTTP transport's OAuth layer (absent on stdio or with a static bearer token). */
+    user?: AuthenticatedUser;
+    /** The caller's per-user session (HTTP transport with OAuth). */
+    session?: SessionInfo;
+    /** Called once a tool result has told the caller their previous session expired. */
+    acknowledgeSessionReset?: () => void;
+}
+/**
+ * Converts a thrown error into a redacted, user-facing message. The client's errors
+ * answered by the server end with their code, SQLSTATE, HTTP status and request id, e.g.
+ *   "Catalog Error: Table with name nope does not exist! ... (sql_error, SQLSTATE 42P01,
+ *    HTTP 400, request r_...)", which is what a bug report needs, so they pass through.
+ */
+export declare function describeError(err: unknown, redact: (text: string) => string): string;
+/**
+ * Per-backend temporary schemas of an attached Postgres database
+ * (`pg_temp_N` / `pg_toast_temp_N`). They hold nothing a client can use,
+ * one pair exists per Postgres backend, and there can be hundreds, so
+ * list_schemas never enumerates them.
+ */
+export declare function isTransientSchema(name: string): boolean;
+/**
+ * Schemas DuckDB and the Postgres-compatibility layer create in every
+ * catalog. Attached Postgres databases also expose one `pg_temp_N` /
+ * `pg_toast_temp_N` pair per backend, which can run into the hundreds.
+ */
+export declare function isSystemSchema(name: string): boolean;
+/** Builds the McpServer with every tool/resource registered against `ctx`. */
+export declare function createServer(ctx: ServerContext): McpServer;