@hydradb/mcp 1.3.0 → 1.4.1

package/dist/hydra/graph.js

@@ -18,10 +18,8 @@
  * That reasoning is unaffected here — there is no generated name to be
  * insulated from yet.
  */
-import { unwrap } from "./envelope.js";
-import { HydraWrapperError, responseError, translateError } from "./errors.js";
-/** The SDK's own default, restated so this file does not depend on importing it. */
-const DEFAULT_BASE_URL = "https://api.hydradb.com";
+import { HydraWrapperError } from "./errors.js";
+import { newRawTransport, sendRaw } from "./transport.js";
 /**
  * Status codes worth retrying.
  *
@@ -29,9 +27,6 @@ const DEFAULT_BASE_URL = "https://api.hydradb.com";
  * rejected construct, a Cypher error and a bad collection name all fail
  * identically on retry, so retrying them only delays the message.
  */
-function isRetryable(status) {
-    return status === 429 || (status >= 500 && status <= 599);
-}
 /**
  * A 2xx whose body is not the shape this endpoint promises.
  *
@@ -57,12 +52,7 @@ function unexpectedShape(path, expected, got) {
 }
 export class GraphResource {
     constructor(config) {
-        this.config = config;
-        // Trailing slashes would produce `//byog/query`, which some proxies treat
-        // as a different path.
-        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-        this.timeoutMs = (config.timeoutSeconds ?? 30) * 1000;
-        this.maxRetries = config.maxRetries ?? 2;
+        this.transport = newRawTransport(config, { timeoutSeconds: 30, maxRetries: 2 });
     }
     /**
      * Run Cypher against one collection (`POST /byog/query`).
@@ -133,85 +123,8 @@ export class GraphResource {
         return this.send("/byog/databases", "DELETE", { database }, opts);
     }
     // --- Transport ---
-    async send(path, method, body, opts) {
-        let lastError;
-        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-            try {
-                return await this.attempt(path, method, body, opts);
-            }
-            catch (err) {
-                lastError = err;
-                const status = err instanceof HydraWrapperError ? err.status : undefined;
-                // A caller who cancelled is not waiting for a retry.
-                if (opts?.signal?.aborted)
-                    throw err;
-                if (attempt === this.maxRetries)
-                    break;
-                if (status != null && !isRetryable(status))
-                    break;
-                // Exponential backoff. Bounded so a 429 on the last attempt does not
-                // hold the MCP host's tool timeout open for its own sake.
-                const delay = Math.min(250 * 2 ** attempt, 2000);
-                await new Promise((resolve) => setTimeout(resolve, delay));
-            }
-        }
-        throw lastError;
-    }
-    async attempt(path, method, body, opts) {
-        // The host's cancellation and our own deadline both have to be able to
-        // abort the request, and `AbortSignal.any` is not available on every Node
-        // 18 this package supports — so they are combined by hand.
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-        const onAbort = () => controller.abort();
-        opts?.signal?.addEventListener("abort", onAbort, { once: true });
-        try {
-            const response = await fetch(`${this.baseUrl}${path}`, {
-                method,
-                headers: {
-                    Authorization: `Bearer ${this.config.token}`,
-                    "Content-Type": "application/json",
-                    // CONTRACT §2 rule 6. The SDK sends this on every call; a
-                    // hand-rolled path that omitted it would silently get v1
-                    // behaviour from the same endpoints.
-                    "API-Version": "2",
-                },
-                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
-                signal: controller.signal,
-            });
-            const text = await response.text();
-            let parsed;
-            try {
-                parsed = text === "" ? null : JSON.parse(text);
-            }
-            catch {
-                parsed = text;
-            }
-            if (!response.ok) {
-                // Hand the parsed envelope to the shared formatter so a BYOG
-                // failure reads exactly like an SDK one, error code and request id
-                // and all.
-                throw responseError(path, response.status, parsed);
-            }
-            return unwrap(parsed);
-        }
-        catch (err) {
-            if (err instanceof HydraWrapperError)
-                throw err;
-            // Distinguish our own deadline from the caller's cancellation: they
-            // need different actions, and "aborted" alone says neither.
-            if (err instanceof Error && err.name === "AbortError") {
-                if (opts?.signal?.aborted) {
-                    throw new HydraWrapperError(`Hydra DB ${path} → ERR: request cancelled by the caller`, path, { cause: err });
-                }
-                throw new HydraWrapperError(`Hydra DB ${path} → ERR: request timed out after ${this.timeoutMs / 1000}s`, path, { cause: err });
-            }
-            throw translateError(path, err);
-        }
-        finally {
-            clearTimeout(timer);
-            opts?.signal?.removeEventListener("abort", onAbort);
-        }
+    send(path, method, body, opts) {
+        return sendRaw(this.transport, path, method, body, opts);
     }
 }
 //# sourceMappingURL=graph.js.map

package/dist/hydra/graph.js.map

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

package/dist/hydra/index.d.ts

@@ -6,9 +6,11 @@
  * other client repos (per CONTRACT.md).
  */
 export { HydraDB, ContextResource, DatabasesResource, DEFAULT_TIMEOUT_SECONDS, DEFAULT_MAX_RETRIES, } from "./client.js";
-export type { HydraConfig, ContextKind, RequestOptions, QueryKind, ConversationTurn, QueryParams, IngestParams, ListParams, InspectParams, IngestionStatusParams, RelationsParams, DeleteParams, CreateDatabaseParams, } from "./client.js";
+export type { HydraConfig, ContextKind, RequestOptions, QueryKind, ConversationTurn, QueryParams, IngestParams, ListParams, InspectParams, IngestionStatusParams, RelationsParams, SubgraphParams, SubgraphMember, SubgraphResult, DeleteParams, CreateDatabaseParams, DeleteCollectionParams, } from "./client.js";
 export { GraphResource } from "./graph.js";
 export type { GraphConfig, GraphQueryParams, GraphScopeParams, GraphRow, } from "./graph.js";
 export { HydraWrapperError, responseError, translateError } from "./errors.js";
 export { assertCollectionAllowed, assertDatabaseAllowed, DatabaseNotAllowedError, ScopeNotAllowedError, } from "./client.js";
 export { unwrap } from "./envelope.js";
+export { DEFAULT_BASE_URL, newRawTransport, sendRaw } from "./transport.js";
+export type { RawTransport } from "./transport.js";

package/dist/hydra/index.js

@@ -10,4 +10,5 @@ export { GraphResource } from "./graph.js";
 export { HydraWrapperError, responseError, translateError } from "./errors.js";
 export { assertCollectionAllowed, assertDatabaseAllowed, DatabaseNotAllowedError, ScopeNotAllowedError, } from "./client.js";
 export { unwrap } from "./envelope.js";
+export { DEFAULT_BASE_URL, newRawTransport, sendRaw } from "./transport.js";
 //# sourceMappingURL=index.js.map

package/dist/hydra/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hydra/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,aAAa,CAAC;AAgBrB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hydra/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACN,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,aAAa,CAAC;AAoBrB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hydra/transport.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The hand-rolled HTTP path for endpoints the SDK does not expose.
+ *
+ * CONTRACT §2 rule 7: a call that bypasses the SDK is still the wrapper — same
+ * `API-Version: 2` header, same envelope-by-shape unwrap, same translated error
+ * type — so a caller cannot tell which methods went through the SDK. This used
+ * to live inside GraphResource, where BYOG was the only such surface. The
+ * connected-subgraph read (PRO-1848) is the second, and a second copy of the
+ * retry/abort/translate logic is exactly what the rule exists to prevent, so
+ * it moved here and both resources call it.
+ *
+ * `fetchFn` is injectable for tests only; production never sets it.
+ */
+/** The SDK's own default, restated so this file does not depend on importing it. */
+export declare const DEFAULT_BASE_URL = "https://api.hydradb.com";
+export interface RawTransport {
+    token: string;
+    baseUrl: string;
+    timeoutMs: number;
+    maxRetries: number;
+    fetchFn?: typeof fetch;
+}
+export interface RawRequestOptions {
+    signal?: AbortSignal;
+}
+export declare function newRawTransport(config: {
+    token: string;
+    baseUrl?: string;
+    timeoutSeconds?: number;
+    maxRetries?: number;
+    fetchFn?: typeof fetch;
+}, defaults: {
+    timeoutSeconds: number;
+    maxRetries: number;
+}): RawTransport;
+/** Send with bounded retries on 429/5xx; the caller's abort ends retrying. */
+export declare function sendRaw<T>(t: RawTransport, path: string, method: "GET" | "POST" | "DELETE", body: unknown, opts?: RawRequestOptions): Promise<T>;

package/dist/hydra/transport.js

@@ -0,0 +1,114 @@
+/**
+ * The hand-rolled HTTP path for endpoints the SDK does not expose.
+ *
+ * CONTRACT §2 rule 7: a call that bypasses the SDK is still the wrapper — same
+ * `API-Version: 2` header, same envelope-by-shape unwrap, same translated error
+ * type — so a caller cannot tell which methods went through the SDK. This used
+ * to live inside GraphResource, where BYOG was the only such surface. The
+ * connected-subgraph read (PRO-1848) is the second, and a second copy of the
+ * retry/abort/translate logic is exactly what the rule exists to prevent, so
+ * it moved here and both resources call it.
+ *
+ * `fetchFn` is injectable for tests only; production never sets it.
+ */
+import { unwrap } from "./envelope.js";
+import { HydraWrapperError, responseError, translateError } from "./errors.js";
+/** The SDK's own default, restated so this file does not depend on importing it. */
+export const DEFAULT_BASE_URL = "https://api.hydradb.com";
+export function newRawTransport(config, defaults) {
+    return {
+        token: config.token,
+        // Trailing slashes would produce `//byog/query`, which some proxies treat
+        // as a different path.
+        baseUrl: (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
+        timeoutMs: (config.timeoutSeconds ?? defaults.timeoutSeconds) * 1000,
+        maxRetries: config.maxRetries ?? defaults.maxRetries,
+        ...(config.fetchFn ? { fetchFn: config.fetchFn } : {}),
+    };
+}
+function isRetryable(status) {
+    return status === 429 || (status >= 500 && status <= 599);
+}
+/** Send with bounded retries on 429/5xx; the caller's abort ends retrying. */
+export async function sendRaw(t, path, method, body, opts) {
+    let lastError;
+    for (let attempt = 0; attempt <= t.maxRetries; attempt++) {
+        try {
+            return await attemptRaw(t, path, method, body, opts);
+        }
+        catch (err) {
+            lastError = err;
+            const status = err instanceof HydraWrapperError ? err.status : undefined;
+            // A caller who cancelled is not waiting for a retry.
+            if (opts?.signal?.aborted)
+                throw err;
+            if (attempt === t.maxRetries)
+                break;
+            if (status != null && !isRetryable(status))
+                break;
+            // Exponential backoff. Bounded so a 429 on the last attempt does not
+            // hold the MCP host's tool timeout open for its own sake.
+            const delay = Math.min(250 * 2 ** attempt, 2000);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+async function attemptRaw(t, path, method, body, opts) {
+    // The host's cancellation and our own deadline both have to be able to
+    // abort the request, and `AbortSignal.any` is not available on every Node
+    // 18 this package supports — so they are combined by hand.
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), t.timeoutMs);
+    const onAbort = () => controller.abort();
+    opts?.signal?.addEventListener("abort", onAbort, { once: true });
+    const doFetch = t.fetchFn ?? fetch;
+    try {
+        const response = await doFetch(`${t.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${t.token}`,
+                "Content-Type": "application/json",
+                // CONTRACT §2 rule 6. The SDK sends this on every call; a
+                // hand-rolled path that omitted it would silently get v1
+                // behaviour from the same endpoints.
+                "API-Version": "2",
+            },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        let parsed;
+        try {
+            parsed = text === "" ? null : JSON.parse(text);
+        }
+        catch {
+            parsed = text;
+        }
+        if (!response.ok) {
+            // Hand the parsed envelope to the shared formatter so a raw-path
+            // failure reads exactly like an SDK one, error code and request id
+            // and all.
+            throw responseError(path, response.status, parsed);
+        }
+        return unwrap(parsed);
+    }
+    catch (err) {
+        if (err instanceof HydraWrapperError)
+            throw err;
+        // Distinguish our own deadline from the caller's cancellation: they
+        // need different actions, and "aborted" alone says neither.
+        if (err instanceof Error && err.name === "AbortError") {
+            if (opts?.signal?.aborted) {
+                throw new HydraWrapperError(`Hydra DB ${path} → ERR: request cancelled by the caller`, path, { cause: err });
+            }
+            throw new HydraWrapperError(`Hydra DB ${path} → ERR: request timed out after ${t.timeoutMs / 1000}s`, path, { cause: err });
+        }
+        throw translateError(path, err);
+    }
+    finally {
+        clearTimeout(timer);
+        opts?.signal?.removeEventListener("abort", onAbort);
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/hydra/transport.js.map

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