@nimbus-dev/connectors 0.2.1 → 0.2.3

package/connectors/launchdarkly/src/server.ts

@@ -1,79 +1,6 @@
-import { z } from "zod";
-import { matchesResult } from "../../../shared/mcp-search-tool.ts";
-import { mcpJsonResult as jsonResult } from "../../../shared/mcp-tool-kit.ts";
 import { runReadOnlyMcpConnector } from "../../../shared/run-read-only-mcp-connector.ts";
-import { filterLaunchDarklyFlags } from "./search-filter.ts";
-
-const DEFAULT_BASE = "https://app.launchdarkly.com";
-
-function baseUrl(): string {
-  const v = process.env["LAUNCHDARKLY_BASE_URL"]?.trim();
-  return v === undefined || v === "" ? DEFAULT_BASE : v;
-}
-
-function authHeader(): Record<string, string> {
-  const t = process.env["LAUNCHDARKLY_TOKEN"]?.trim();
-  if (t === undefined || t === "") {
-    throw new Error("LAUNCHDARKLY_TOKEN is not set");
-  }
-  return { Authorization: t, Accept: "application/json" };
-}
-
-async function ldGet(path: string): Promise<unknown> {
-  const res = await fetch(`${baseUrl()}/api/v2${path}`, { headers: authHeader() });
-  const text = await res.text();
-  if (!res.ok) {
-    throw new Error(`LaunchDarkly ${String(res.status)}: ${text.slice(0, 400)}`);
-  }
-  return JSON.parse(text) as unknown;
-}
+import { registerLaunchdarklyTools } from "./tools.ts";
 
 await runReadOnlyMcpConnector("nimbus-launchdarkly", (reg) => {
-  reg(
-    "launchdarkly_list",
-    "List LaunchDarkly projects, or feature flags for a project. Without `projectKey`, returns the account's projects (`/projects`). With `projectKey`, returns that project's flags (`/flags/{projectKey}`), capped at `limit` (default 100).",
-    z.object({
-      projectKey: z.string().min(1).optional(),
-      limit: z.number().int().min(1).max(500).optional(),
-    }),
-    async (p) => {
-      if (p.projectKey === undefined) {
-        return jsonResult(await ldGet("/projects"));
-      }
-      const search = new URLSearchParams({ summary: "true", limit: String(p.limit ?? 100) });
-      return jsonResult(
-        await ldGet(`/flags/${encodeURIComponent(p.projectKey)}?${search.toString()}`),
-      );
-    },
-  );
-
-  reg(
-    "launchdarkly_get",
-    "Fetch one LaunchDarkly feature flag by project key + flag key. Throws when no match is found.",
-    z.object({
-      projectKey: z.string().min(1),
-      flagKey: z.string().min(1),
-    }),
-    async (p) => {
-      return jsonResult(
-        await ldGet(`/flags/${encodeURIComponent(p.projectKey)}/${encodeURIComponent(p.flagKey)}`),
-      );
-    },
-  );
-
-  reg(
-    "launchdarkly_search",
-    "Substring search across a project's feature flags. Matches the query against flag key, name, description, and tags (case-insensitive). Returns a `{ matches: [...] }` envelope.",
-    z.object({
-      projectKey: z.string().min(1),
-      query: z.string().min(1),
-      limit: z.number().int().min(1).max(200).optional(),
-    }),
-    async (p) => {
-      const search = new URLSearchParams({ summary: "true", limit: "500" });
-      const root = await ldGet(`/flags/${encodeURIComponent(p.projectKey)}?${search.toString()}`);
-      const flags = (root as { items?: unknown[] } | null)?.items;
-      return matchesResult(flags, filterLaunchDarklyFlags, p);
-    },
-  );
+  registerLaunchdarklyTools(reg);
 });

package/connectors/launchdarkly/src/tools.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { createJsonGetter, envAuthHeaders, optionalEnv } from "../../../shared/env-json-api.ts";
+import { matchesResult } from "../../../shared/mcp-search-tool.ts";
+import { mcpJsonResult as jsonResult } from "../../../shared/mcp-tool-kit.ts";
+import type { ZodToolRegistrar } from "../../../shared/run-read-only-mcp-connector.ts";
+import { filterLaunchDarklyFlags } from "./search-filter.ts";
+
+const DEFAULT_BASE = "https://app.launchdarkly.com";
+
+const ldGet = createJsonGetter({
+  // `optionalEnv`, not `optionalBaseUrl`: a trailing slash on the override is left as given.
+  base: () => `${optionalEnv("LAUNCHDARKLY_BASE_URL", DEFAULT_BASE)}/api/v2`,
+  label: "LaunchDarkly",
+  headers: envAuthHeaders({ env: "LAUNCHDARKLY_TOKEN", scheme: "" }),
+});
+
+/** Tool names exposed by this connector — for contract/introspection tests. */
+export const LAUNCHDARKLY_TOOL_NAMES = [
+  "launchdarkly_list",
+  "launchdarkly_get",
+  "launchdarkly_search",
+] as const;
+
+export function registerLaunchdarklyTools(reg: ZodToolRegistrar): void {
+  reg(
+    "launchdarkly_list",
+    "List LaunchDarkly projects, or feature flags for a project. Without `projectKey`, returns the account's projects (`/projects`). With `projectKey`, returns that project's flags (`/flags/{projectKey}`), capped at `limit` (default 100).",
+    z.object({
+      projectKey: z.string().min(1).optional(),
+      limit: z.number().int().min(1).max(500).optional(),
+    }),
+    async (p) => {
+      if (p.projectKey === undefined) {
+        return jsonResult(await ldGet("/projects"));
+      }
+      const search = new URLSearchParams({ summary: "true", limit: String(p.limit ?? 100) });
+      return jsonResult(
+        await ldGet(`/flags/${encodeURIComponent(p.projectKey)}?${search.toString()}`),
+      );
+    },
+  );
+
+  reg(
+    "launchdarkly_get",
+    "Fetch one LaunchDarkly feature flag by project key + flag key. Throws when no match is found.",
+    z.object({
+      projectKey: z.string().min(1),
+      flagKey: z.string().min(1),
+    }),
+    async (p) => {
+      return jsonResult(
+        await ldGet(`/flags/${encodeURIComponent(p.projectKey)}/${encodeURIComponent(p.flagKey)}`),
+      );
+    },
+  );
+
+  reg(
+    "launchdarkly_search",
+    "Substring search across a project's feature flags. Matches the query against flag key, name, description, and tags (case-insensitive). Returns a `{ matches: [...] }` envelope.",
+    z.object({
+      projectKey: z.string().min(1),
+      query: z.string().min(1),
+      limit: z.number().int().min(1).max(200).optional(),
+    }),
+    async (p) => {
+      const search = new URLSearchParams({ summary: "true", limit: "500" });
+      const root = await ldGet(`/flags/${encodeURIComponent(p.projectKey)}?${search.toString()}`);
+      const flags = (root as { items?: unknown[] } | null)?.items;
+      return matchesResult(flags, filterLaunchDarklyFlags, p);
+    },
+  );
+}

package/connectors/lever/src/search-filter.ts

@@ -1,6 +1,7 @@
 import {
   asObjectish,
   makeQueryFilter,
+  nestedString,
   type SearchMatchOptions,
   stringField,
   tagText,
@@ -8,15 +9,6 @@ import {
 
 export type LeverSearchMatchOptions = SearchMatchOptions;
 
-function categoryField(row: Record<string, unknown>, key: string): string {
-  const cats = row["categories"];
-  if (cats === null || typeof cats !== "object" || Array.isArray(cats)) {
-    return "";
-  }
-  const v = (cats as Record<string, unknown>)[key];
-  return typeof v === "string" ? v : "";
-}
-
 function fieldsOf(item: unknown): readonly string[] | null {
   const row = asObjectish(item);
   if (row === undefined) {
@@ -25,9 +17,9 @@ function fieldsOf(item: unknown): readonly string[] | null {
   return [
     stringField(row, "text"),
     stringField(row, "state"),
-    categoryField(row, "team"),
-    categoryField(row, "department"),
-    categoryField(row, "location"),
+    nestedString(row, ["categories", "team"]),
+    nestedString(row, ["categories", "department"]),
+    nestedString(row, ["categories", "location"]),
     tagText(row),
   ];
 }

package/connectors/lever/src/server.ts

@@ -1,64 +1,6 @@
-import { z } from "zod";
-import { matchesResult, searchToolInputSchema } from "../../../shared/mcp-search-tool.ts";
-import {
-  encodeBasicAuthHeader,
-  mcpJsonResult as jsonResult,
-} from "../../../shared/mcp-tool-kit.ts";
 import { runReadOnlyMcpConnector } from "../../../shared/run-read-only-mcp-connector.ts";
-import { filterLeverPostings } from "./search-filter.ts";
-
-const BASE = "https://api.lever.co";
-
-function apiKey(): string {
-  const t = process.env["LEVER_API_KEY"]?.trim();
-  if (t === undefined || t === "") {
-    throw new Error("LEVER_API_KEY is not set");
-  }
-  return t;
-}
-
-function authHeader(): Record<string, string> {
-  return { Authorization: encodeBasicAuthHeader(apiKey(), ""), Accept: "application/json" };
-}
-
-async function leverGet(path: string): Promise<unknown> {
-  const res = await fetch(`${BASE}${path}`, { headers: authHeader() });
-  const text = await res.text();
-  if (!res.ok) {
-    throw new Error(`Lever ${String(res.status)}: ${text.slice(0, 400)}`);
-  }
-  return JSON.parse(text) as unknown;
-}
+import { registerLeverTools } from "./tools.ts";
 
 await runReadOnlyMcpConnector("nimbus-lever", (reg) => {
-  reg(
-    "lever_list",
-    "List the company's published Lever job postings (`GET /v1/postings?limit=100`). Returns the offset-cursor envelope `{ data: [...], hasNext: boolean, next?: string }` — `data` holds the posting objects.",
-    z.object({}),
-    async () => {
-      return jsonResult(await leverGet(`/v1/postings?limit=100`));
-    },
-  );
-
-  reg(
-    "lever_get",
-    "Fetch one Lever job posting by its id (`GET /v1/postings/{id}`). Returns the `{ data: {...} }` envelope. Throws when no match is found.",
-    z.object({
-      id: z.string().min(1),
-    }),
-    async (p) => {
-      return jsonResult(await leverGet(`/v1/postings/${encodeURIComponent(p.id)}`));
-    },
-  );
-
-  reg(
-    "lever_search",
-    "Substring search across the company's Lever job postings (first page only). Matches the query against the posting text (title), state, and the team/department/location categories and tags (case-insensitive). Returns a `{ matches: [...] }` envelope.",
-    searchToolInputSchema(100),
-    async (p) => {
-      const root = await leverGet(`/v1/postings?limit=100`);
-      const data = (root as { data?: unknown[] } | null)?.data;
-      return matchesResult(data, filterLeverPostings, p);
-    },
-  );
+  registerLeverTools(reg);
 });

package/connectors/lever/src/tools.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { createJsonGetter, requiredEnv } from "../../../shared/env-json-api.ts";
+import { matchesResult, searchToolInputSchema } from "../../../shared/mcp-search-tool.ts";
+import {
+  encodeBasicAuthHeader,
+  mcpJsonResult as jsonResult,
+} from "../../../shared/mcp-tool-kit.ts";
+import type { ZodToolRegistrar } from "../../../shared/run-read-only-mcp-connector.ts";
+import { filterLeverPostings } from "./search-filter.ts";
+
+const BASE = "https://api.lever.co";
+
+/** HTTP Basic with the API key as the username and an empty password. */
+function authHeader(): Record<string, string> {
+  return {
+    Authorization: encodeBasicAuthHeader(requiredEnv("LEVER_API_KEY"), ""),
+    Accept: "application/json",
+  };
+}
+
+const leverGet = createJsonGetter({
+  base: BASE,
+  label: "Lever",
+  headers: authHeader,
+});
+
+/** Tool names exposed by this connector — for contract/introspection tests. */
+export const LEVER_TOOL_NAMES = ["lever_get", "lever_list", "lever_search"] as const;
+
+export function registerLeverTools(reg: ZodToolRegistrar): void {
+  reg(
+    "lever_list",
+    "List the company's published Lever job postings (`GET /v1/postings?limit=100`). Returns the offset-cursor envelope `{ data: [...], hasNext: boolean, next?: string }` — `data` holds the posting objects.",
+    z.object({}),
+    async () => {
+      return jsonResult(await leverGet(`/v1/postings?limit=100`));
+    },
+  );
+
+  reg(
+    "lever_get",
+    "Fetch one Lever job posting by its id (`GET /v1/postings/{id}`). Returns the `{ data: {...} }` envelope. Throws when no match is found.",
+    z.object({
+      id: z.string().min(1),
+    }),
+    async (p) => {
+      return jsonResult(await leverGet(`/v1/postings/${encodeURIComponent(p.id)}`));
+    },
+  );
+
+  reg(
+    "lever_search",
+    "Substring search across the company's Lever job postings (first page only). Matches the query against the posting text (title), state, and the team/department/location categories and tags (case-insensitive). Returns a `{ matches: [...] }` envelope.",
+    searchToolInputSchema(100),
+    async (p) => {
+      const root = await leverGet(`/v1/postings?limit=100`);
+      const data = (root as { data?: unknown[] } | null)?.data;
+      return matchesResult(data, filterLeverPostings, p);
+    },
+  );
+}