@unkey/api 2.1.3 → 2.2.0

package/src/mcp-server/cli/start/impl.ts

@@ -1,130 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import express from "express";
-import { SDKOptions } from "../../../lib/config.js";
-import { LocalContext } from "../../cli.js";
-import {
-  ConsoleLoggerLevel,
-  createConsoleLogger,
-} from "../../console-logger.js";
-import { createMCPServer } from "../../server.js";
-
-interface StartCommandFlags {
-  readonly transport: "stdio" | "sse";
-  readonly port: number;
-  readonly tool?: string[];
-  readonly "root-key"?: string | undefined;
-  readonly "server-url"?: string;
-  readonly "server-index"?: SDKOptions["serverIdx"];
-  readonly "log-level": ConsoleLoggerLevel;
-  readonly env?: [string, string][];
-}
-
-export async function main(this: LocalContext, flags: StartCommandFlags) {
-  flags.env?.forEach(([key, value]) => {
-    process.env[key] = value;
-  });
-
-  switch (flags.transport) {
-    case "stdio":
-      await startStdio(flags);
-      break;
-    case "sse":
-      await startSSE(flags);
-      break;
-    default:
-      throw new Error(`Invalid transport: ${flags.transport}`);
-  }
-}
-
-async function startStdio(flags: StartCommandFlags) {
-  const logger = createConsoleLogger(flags["log-level"]);
-  const transport = new StdioServerTransport();
-  const server = createMCPServer({
-    logger,
-    allowedTools: flags.tool,
-    ...{ rootKey: flags["root-key"] ?? "" },
-    serverURL: flags["server-url"],
-    serverIdx: flags["server-index"],
-  });
-  await server.connect(transport);
-
-  const abort = async () => {
-    await server.close();
-    process.exit(0);
-  };
-  process.on("SIGTERM", abort);
-  process.on("SIGINT", abort);
-}
-
-async function startSSE(flags: StartCommandFlags) {
-  const logger = createConsoleLogger(flags["log-level"]);
-  const app = express();
-  const mcpServer = createMCPServer({
-    logger,
-    allowedTools: flags.tool,
-    ...{ rootKey: flags["root-key"] ?? "" },
-    serverURL: flags["server-url"],
-    serverIdx: flags["server-index"],
-  });
-  let transport: SSEServerTransport | undefined;
-  const controller = new AbortController();
-
-  app.get("/sse", async (_req, res) => {
-    transport = new SSEServerTransport("/message", res);
-
-    await mcpServer.connect(transport);
-
-    mcpServer.server.onclose = async () => {
-      res.end();
-    };
-  });
-
-  app.post("/message", async (req, res) => {
-    if (!transport) {
-      throw new Error("Server transport not initialized");
-    }
-
-    await transport.handlePostMessage(req, res);
-  });
-
-  const httpServer = app.listen(flags.port, "0.0.0.0", () => {
-    const ha = httpServer.address();
-    const host = typeof ha === "string" ? ha : `${ha?.address}:${ha?.port}`;
-    logger.info("MCP HTTP server started", { host });
-  });
-
-  let closing = false;
-  controller.signal.addEventListener("abort", async () => {
-    if (closing) {
-      logger.info("Received second signal. Forcing shutdown.");
-      process.exit(1);
-    }
-    closing = true;
-
-    logger.info("Shutting down MCP server");
-
-    await mcpServer.close();
-
-    logger.info("Shutting down HTTP server");
-
-    const timer = setTimeout(() => {
-      logger.info("Forcing shutdown");
-      process.exit(1);
-    }, 5000);
-
-    httpServer.close(() => {
-      clearTimeout(timer);
-      logger.info("Graceful shutdown complete");
-      process.exit(0);
-    });
-  });
-
-  const abort = () => controller.abort();
-  process.on("SIGTERM", abort);
-  process.on("SIGINT", abort);
-}

package/src/mcp-server/cli.ts

@@ -1,13 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { CommandContext, StricliProcess } from "@stricli/core";
-
-export interface LocalContext extends CommandContext {
-  readonly process: StricliProcess;
-}
-
-export function buildContext(process: NodeJS.Process): LocalContext {
-  return { process: process as StricliProcess };
-}

package/src/mcp-server/console-logger.ts

@@ -1,71 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-export const consoleLoggerLevels = [
-  "debug",
-  "warning",
-  "info",
-  "error",
-] as const;
-
-export type ConsoleLoggerLevel = (typeof consoleLoggerLevels)[number];
-
-export type ConsoleLogger = {
-  [key in ConsoleLoggerLevel]: (
-    message: string,
-    data?: Record<string, unknown>,
-  ) => void;
-};
-
-export function createConsoleLogger(level: ConsoleLoggerLevel): ConsoleLogger {
-  const min = consoleLoggerLevels.indexOf(level);
-  const noop = () => {};
-
-  const logger: ConsoleLogger = {
-    debug: noop,
-    warning: noop,
-    info: noop,
-    error: noop,
-  };
-
-  return consoleLoggerLevels.reduce((logger, level, i) => {
-    if (i < min) {
-      return logger;
-    }
-
-    logger[level] = log.bind(null, level);
-
-    return logger;
-  }, logger);
-}
-
-function log(
-  level: ConsoleLoggerLevel,
-  message: string,
-  data?: Record<string, unknown>,
-) {
-  let line = "";
-  const allData = [{ msg: message, l: level }, data];
-
-  for (const ctx of allData) {
-    for (const [key, value] of Object.entries(ctx || {})) {
-      if (value == null) {
-        line += ` ${key}=<${value}>`;
-      } else if (typeof value === "function") {
-        line += ` ${key}=<function>`;
-      } else if (typeof value === "symbol") {
-        line += ` ${key}=${value.toString()}`;
-      } else if (typeof value === "string") {
-        const v = value.search(/\s/g) >= 0 ? JSON.stringify(value) : value;
-        line += ` ${key}=${v}`;
-      } else if (typeof value !== "object") {
-        line += ` ${key}=${value}`;
-      } else {
-        line += ` ${key}="${JSON.stringify(value)}"`;
-      }
-    }
-  }
-
-  console.error(line);
-}

package/src/mcp-server/extensions.ts

@@ -1,17 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { ZodRawShape } from "zod/v3";
-import { PromptArgsRawShape, PromptDefinition } from "./prompts.js";
-import { ResourceDefinition, ResourceTemplateDefinition } from "./resources.js";
-import { ToolDefinition } from "./tools.js";
-
-export type Register = {
-  tool: <A extends ZodRawShape | undefined>(def: ToolDefinition<A>) => void;
-  resource: (def: ResourceDefinition) => void;
-  resourceTemplate: (def: ResourceTemplateDefinition) => void;
-  prompt: <A extends PromptArgsRawShape | undefined>(
-    prompt: PromptDefinition<A>,
-  ) => void;
-};

package/src/mcp-server/mcp-server.ts

@@ -1,26 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { buildApplication, buildRouteMap, run } from "@stricli/core";
-import process from "node:process";
-import { buildContext } from "./cli.js";
-import { startCommand } from "./cli/start/command.js";
-
-const routes = buildRouteMap({
-  routes: {
-    start: startCommand,
-  },
-  docs: {
-    brief: "MCP server CLI",
-  },
-});
-
-export const app = buildApplication(routes, {
-  name: "mcp",
-  versionInfo: {
-    currentVersion: "2.1.3",
-  },
-});
-
-run(app, process.argv.slice(2), buildContext(process));

package/src/mcp-server/prompts.ts

@@ -1,117 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
-import {
-  objectOutputType,
-  ZodOptional,
-  ZodType,
-  ZodTypeAny,
-  ZodTypeDef,
-} from "zod/v3";
-import { UnkeyCore } from "../core.js";
-import { ConsoleLogger } from "./console-logger.js";
-import { MCPScope } from "./scopes.js";
-
-// '@modelcontextprotocol/sdk' currently does not export this type
-export type PromptArgsRawShape = {
-  [k: string]:
-    | ZodType<string, ZodTypeDef, string>
-    | ZodOptional<ZodType<string, ZodTypeDef, string>>;
-};
-
-export type PromptDefinition<
-  Args extends undefined | PromptArgsRawShape = undefined,
-> = Args extends PromptArgsRawShape ? {
-    name: string;
-    description?: string;
-    scopes?: MCPScope[];
-    args: Args;
-    prompt: (
-      client: UnkeyCore,
-      args: objectOutputType<Args, ZodTypeAny>,
-      extra: RequestHandlerExtra,
-    ) => GetPromptResult | Promise<GetPromptResult>;
-  }
-  : {
-    name: string;
-    description?: string;
-    scopes?: MCPScope[];
-    args?: undefined;
-    prompt: (
-      client: UnkeyCore,
-      extra: RequestHandlerExtra,
-    ) => GetPromptResult | Promise<GetPromptResult>;
-  };
-
-// Optional function to assist with formatting prompt results
-export async function formatResult(value: string): Promise<GetPromptResult> {
-  return {
-    messages: [
-      {
-        role: "user",
-        content: {
-          type: "text",
-          text: value,
-        },
-      },
-    ],
-  };
-}
-
-export function createRegisterPrompt(
-  logger: ConsoleLogger,
-  server: McpServer,
-  sdk: UnkeyCore,
-  allowedScopes: Set<MCPScope>,
-): <A extends PromptArgsRawShape | undefined>(
-  prompt: PromptDefinition<A>,
-) => void {
-  return <A extends PromptArgsRawShape | undefined>(
-    prompt: PromptDefinition<A>,
-  ): void => {
-    const scopes = prompt.scopes ?? [];
-    if (allowedScopes.size > 0 && scopes.length === 0) {
-      return;
-    }
-
-    if (
-      allowedScopes.size > 0
-      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
-    ) {
-      return;
-    }
-
-    if (prompt.args) {
-      if (prompt.description) {
-        server.prompt(
-          prompt.name,
-          prompt.description,
-          prompt.args,
-          async (args, ctx) => prompt.prompt(sdk, args, ctx),
-        );
-      } else {
-        server.prompt(
-          prompt.name,
-          prompt.args,
-          async (args, ctx) => prompt.prompt(sdk, args, ctx),
-        );
-      }
-    } else {
-      if (prompt.description) {
-        server.prompt(
-          prompt.name,
-          prompt.description,
-          async (ctx) => prompt.prompt(sdk, ctx),
-        );
-      } else {
-        server.prompt(prompt.name, async (ctx) => prompt.prompt(sdk, ctx));
-      }
-    }
-
-    logger.debug("Registered prompt", { name: prompt.name });
-  };
-}

package/src/mcp-server/resources.ts

@@ -1,172 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import {
-  McpServer,
-  ResourceMetadata,
-  ResourceTemplate,
-} from "@modelcontextprotocol/sdk/server/mcp.js";
-import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import { Variables } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
-import { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
-import { UnkeyCore } from "../core.js";
-import { ConsoleLogger } from "./console-logger.js";
-import { MCPScope } from "./scopes.js";
-import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
-
-export type ReadResourceCallback = (
-  client: UnkeyCore,
-  uri: URL,
-  extra: RequestHandlerExtra,
-) => ReadResourceResult | Promise<ReadResourceResult>;
-
-export type ResourceDefinition = {
-  name: string;
-  description?: string;
-  metadata?: ResourceMetadata;
-  scopes?: MCPScope[];
-  resource: string;
-  read: ReadResourceCallback;
-};
-
-export type ReadResourceTemplateCallback = (
-  client: UnkeyCore,
-  uri: URL,
-  vars: Variables,
-  extra: RequestHandlerExtra,
-) => ReadResourceResult | Promise<ReadResourceResult>;
-
-export type ResourceTemplateDefinition = {
-  name: string;
-  description: string;
-  metadata?: ResourceMetadata;
-  scopes?: MCPScope[];
-  resource: ResourceTemplate;
-  read: ReadResourceTemplateCallback;
-};
-
-// Optional function to assist with formatting resource results
-export async function formatResult(
-  value: unknown,
-  uri: URL,
-  init: { mimeType?: string | undefined; response?: Response | undefined },
-): Promise<ReadResourceResult> {
-  if (typeof value === "undefined") {
-    return { contents: [] };
-  }
-
-  let contents: ReadResourceResult["contents"] = [];
-
-  const mimeType = init.mimeType ?? init.response?.headers.get("content-type")
-    ?? "";
-
-  if (mimeType.search(/\bjson\b/g) !== -1) {
-    contents = [{ uri: uri.toString(), mimeType, text: JSON.stringify(value) }];
-  } else if (
-    mimeType.startsWith("text/event-stream")
-    && isAsyncIterable(value)
-  ) {
-    contents = [
-      {
-        uri: uri.toString(),
-        mimeType: "application/json",
-        text: await stringifySSEToJSON(value),
-      },
-    ];
-  } else if (
-    (mimeType.startsWith("text/") || mimeType.startsWith("application/"))
-    && typeof value === "string"
-  ) {
-    contents = [{ uri: uri.toString(), mimeType, text: value }];
-  } else if (isBinaryData(value)) {
-    const blob = await valueToBase64(value);
-    contents = blob == null ? [] : [{ uri: uri.toString(), blob, mimeType }];
-  } else {
-    throw new Error(`Unsupported content type: "${mimeType}"`);
-  }
-
-  return { contents };
-}
-
-async function stringifySSEToJSON(
-  value: AsyncIterable<unknown>,
-): Promise<string> {
-  const payloads = [];
-
-  for await (const chunk of value) {
-    payloads.push(chunk);
-  }
-
-  return JSON.stringify(payloads);
-}
-
-export function createRegisterResource(
-  logger: ConsoleLogger,
-  server: McpServer,
-  sdk: UnkeyCore,
-  allowedScopes: Set<MCPScope>,
-): (resource: ResourceDefinition) => void {
-  return (resource: ResourceDefinition): void => {
-    const scopes = resource.scopes ?? [];
-    if (allowedScopes.size > 0 && scopes.length === 0) {
-      return;
-    }
-
-    if (
-      allowedScopes.size > 0
-      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
-    ) {
-      return;
-    }
-
-    const metadata: ResourceMetadata = {
-      ...resource.metadata,
-      description: resource.description,
-    };
-
-    server.resource(
-      resource.name,
-      resource.resource,
-      metadata,
-      async (uri, ctx) => resource.read(sdk, uri, ctx),
-    );
-
-    logger.debug("Registered resource", { name: resource.name });
-  };
-}
-
-export function createRegisterResourceTemplate(
-  logger: ConsoleLogger,
-  server: McpServer,
-  sdk: UnkeyCore,
-  allowedScopes: Set<MCPScope>,
-): (resource: ResourceTemplateDefinition) => void {
-  return (resource: ResourceTemplateDefinition): void => {
-    const scopes = resource.scopes ?? [];
-    if (allowedScopes.size > 0 && scopes.length === 0) {
-      return;
-    }
-
-    if (
-      allowedScopes.size > 0
-      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
-    ) {
-      return;
-    }
-
-    const metadata: ResourceMetadata = {
-      ...resource.metadata,
-      description: resource.description,
-    };
-
-    server.resource(
-      resource.name,
-      resource.resource,
-      metadata,
-      async (uri, vars, ctx) => resource.read(sdk, uri, vars, ctx),
-    );
-
-    logger.debug("Registered resource template", { name: resource.name });
-  };
-}

package/src/mcp-server/scopes.ts

@@ -1,7 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-export const mcpScopes = [] as const;
-
-export type MCPScope = (typeof mcpScopes)[number];

package/src/mcp-server/server.ts

@@ -1,137 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { UnkeyCore } from "../core.js";
-import { SDKOptions } from "../lib/config.js";
-import type { ConsoleLogger } from "./console-logger.js";
-import { createRegisterPrompt } from "./prompts.js";
-import {
-  createRegisterResource,
-  createRegisterResourceTemplate,
-} from "./resources.js";
-import { MCPScope } from "./scopes.js";
-import { createRegisterTool } from "./tools.js";
-import { tool$analyticsGetVerifications } from "./tools/analyticsGetVerifications.js";
-import { tool$apisCreateApi } from "./tools/apisCreateApi.js";
-import { tool$apisDeleteApi } from "./tools/apisDeleteApi.js";
-import { tool$apisGetApi } from "./tools/apisGetApi.js";
-import { tool$apisListKeys } from "./tools/apisListKeys.js";
-import { tool$identitiesCreateIdentity } from "./tools/identitiesCreateIdentity.js";
-import { tool$identitiesDeleteIdentity } from "./tools/identitiesDeleteIdentity.js";
-import { tool$identitiesGetIdentity } from "./tools/identitiesGetIdentity.js";
-import { tool$identitiesListIdentities } from "./tools/identitiesListIdentities.js";
-import { tool$identitiesUpdateIdentity } from "./tools/identitiesUpdateIdentity.js";
-import { tool$keysAddPermissions } from "./tools/keysAddPermissions.js";
-import { tool$keysAddRoles } from "./tools/keysAddRoles.js";
-import { tool$keysCreateKey } from "./tools/keysCreateKey.js";
-import { tool$keysDeleteKey } from "./tools/keysDeleteKey.js";
-import { tool$keysGetKey } from "./tools/keysGetKey.js";
-import { tool$keysMigrateKeys } from "./tools/keysMigrateKeys.js";
-import { tool$keysRemovePermissions } from "./tools/keysRemovePermissions.js";
-import { tool$keysRemoveRoles } from "./tools/keysRemoveRoles.js";
-import { tool$keysRerollKey } from "./tools/keysRerollKey.js";
-import { tool$keysSetPermissions } from "./tools/keysSetPermissions.js";
-import { tool$keysSetRoles } from "./tools/keysSetRoles.js";
-import { tool$keysUpdateCredits } from "./tools/keysUpdateCredits.js";
-import { tool$keysUpdateKey } from "./tools/keysUpdateKey.js";
-import { tool$keysVerifyKey } from "./tools/keysVerifyKey.js";
-import { tool$keysWhoami } from "./tools/keysWhoami.js";
-import { tool$permissionsCreatePermission } from "./tools/permissionsCreatePermission.js";
-import { tool$permissionsCreateRole } from "./tools/permissionsCreateRole.js";
-import { tool$permissionsDeletePermission } from "./tools/permissionsDeletePermission.js";
-import { tool$permissionsDeleteRole } from "./tools/permissionsDeleteRole.js";
-import { tool$permissionsGetPermission } from "./tools/permissionsGetPermission.js";
-import { tool$permissionsGetRole } from "./tools/permissionsGetRole.js";
-import { tool$permissionsListPermissions } from "./tools/permissionsListPermissions.js";
-import { tool$permissionsListRoles } from "./tools/permissionsListRoles.js";
-import { tool$ratelimitDeleteOverride } from "./tools/ratelimitDeleteOverride.js";
-import { tool$ratelimitGetOverride } from "./tools/ratelimitGetOverride.js";
-import { tool$ratelimitLimit } from "./tools/ratelimitLimit.js";
-import { tool$ratelimitListOverrides } from "./tools/ratelimitListOverrides.js";
-import { tool$ratelimitMultiLimit } from "./tools/ratelimitMultiLimit.js";
-import { tool$ratelimitSetOverride } from "./tools/ratelimitSetOverride.js";
-
-export function createMCPServer(deps: {
-  logger: ConsoleLogger;
-  allowedTools?: string[] | undefined;
-  scopes?: MCPScope[] | undefined;
-  serverURL?: string | undefined;
-  rootKey?: SDKOptions["rootKey"] | undefined;
-  serverIdx?: SDKOptions["serverIdx"] | undefined;
-}) {
-  const server = new McpServer({
-    name: "Unkey",
-    version: "2.1.3",
-  });
-
-  const client = new UnkeyCore({
-    rootKey: deps.rootKey,
-    serverURL: deps.serverURL,
-    serverIdx: deps.serverIdx,
-  });
-
-  const scopes = new Set(deps.scopes);
-
-  const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
-  const tool = createRegisterTool(
-    deps.logger,
-    server,
-    client,
-    scopes,
-    allowedTools,
-  );
-  const resource = createRegisterResource(deps.logger, server, client, scopes);
-  const resourceTemplate = createRegisterResourceTemplate(
-    deps.logger,
-    server,
-    client,
-    scopes,
-  );
-  const prompt = createRegisterPrompt(deps.logger, server, client, scopes);
-  const register = { tool, resource, resourceTemplate, prompt };
-  void register; // suppress unused warnings
-
-  tool(tool$analyticsGetVerifications);
-  tool(tool$apisCreateApi);
-  tool(tool$apisDeleteApi);
-  tool(tool$apisGetApi);
-  tool(tool$apisListKeys);
-  tool(tool$identitiesCreateIdentity);
-  tool(tool$identitiesDeleteIdentity);
-  tool(tool$identitiesGetIdentity);
-  tool(tool$identitiesListIdentities);
-  tool(tool$identitiesUpdateIdentity);
-  tool(tool$keysAddPermissions);
-  tool(tool$keysAddRoles);
-  tool(tool$keysCreateKey);
-  tool(tool$keysDeleteKey);
-  tool(tool$keysGetKey);
-  tool(tool$keysMigrateKeys);
-  tool(tool$keysRemovePermissions);
-  tool(tool$keysRemoveRoles);
-  tool(tool$keysRerollKey);
-  tool(tool$keysSetPermissions);
-  tool(tool$keysSetRoles);
-  tool(tool$keysUpdateCredits);
-  tool(tool$keysUpdateKey);
-  tool(tool$keysVerifyKey);
-  tool(tool$keysWhoami);
-  tool(tool$permissionsCreatePermission);
-  tool(tool$permissionsCreateRole);
-  tool(tool$permissionsDeletePermission);
-  tool(tool$permissionsDeleteRole);
-  tool(tool$permissionsGetPermission);
-  tool(tool$permissionsGetRole);
-  tool(tool$permissionsListPermissions);
-  tool(tool$permissionsListRoles);
-  tool(tool$ratelimitDeleteOverride);
-  tool(tool$ratelimitGetOverride);
-  tool(tool$ratelimitLimit);
-  tool(tool$ratelimitListOverrides);
-  tool(tool$ratelimitMultiLimit);
-  tool(tool$ratelimitSetOverride);
-
-  return server;
-}