@s2-dev/streamstore 0.15.13 → 0.16.0

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";
-import { S2Core } 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: S2Core,
-      args: objectOutputType<Args, ZodTypeAny>,
-      extra: RequestHandlerExtra,
-    ) => GetPromptResult | Promise<GetPromptResult>;
-  }
-  : {
-    name: string;
-    description?: string;
-    scopes?: MCPScope[];
-    args?: undefined;
-    prompt: (
-      client: S2Core,
-      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: S2Core,
-  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 { S2Core } 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: S2Core,
-  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: S2Core,
-  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: S2Core,
-  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: S2Core,
-  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,10 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-export const mcpScopes = [
-  "read",
-  "write",
-] as const;
-
-export type MCPScope = (typeof mcpScopes)[number];

package/src/mcp-server/server.ts

@@ -1,101 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { S2Core } 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$accessTokensIssueAccessToken } from "./tools/accessTokensIssueAccessToken.js";
-import { tool$accessTokensListAccessTokens } from "./tools/accessTokensListAccessTokens.js";
-import { tool$accessTokensRevokeAccessToken } from "./tools/accessTokensRevokeAccessToken.js";
-import { tool$basinsCreateBasin } from "./tools/basinsCreateBasin.js";
-import { tool$basinsCreateOrReconfigureBasin } from "./tools/basinsCreateOrReconfigureBasin.js";
-import { tool$basinsDeleteBasin } from "./tools/basinsDeleteBasin.js";
-import { tool$basinsGetBasinConfig } from "./tools/basinsGetBasinConfig.js";
-import { tool$basinsListBasins } from "./tools/basinsListBasins.js";
-import { tool$basinsReconfigureBasin } from "./tools/basinsReconfigureBasin.js";
-import { tool$metricsAccountMetrics } from "./tools/metricsAccountMetrics.js";
-import { tool$metricsBasinMetrics } from "./tools/metricsBasinMetrics.js";
-import { tool$metricsStreamMetrics } from "./tools/metricsStreamMetrics.js";
-import { tool$recordsAppend } from "./tools/recordsAppend.js";
-import { tool$recordsCheckTail } from "./tools/recordsCheckTail.js";
-import { tool$recordsRead } from "./tools/recordsRead.js";
-import { tool$streamsCreateOrReconfigureStream } from "./tools/streamsCreateOrReconfigureStream.js";
-import { tool$streamsCreateStream } from "./tools/streamsCreateStream.js";
-import { tool$streamsDeleteStream } from "./tools/streamsDeleteStream.js";
-import { tool$streamsGetStreamConfig } from "./tools/streamsGetStreamConfig.js";
-import { tool$streamsListStreams } from "./tools/streamsListStreams.js";
-import { tool$streamsReconfigureStream } from "./tools/streamsReconfigureStream.js";
-
-export function createMCPServer(deps: {
-  logger: ConsoleLogger;
-  allowedTools?: string[] | undefined;
-  scopes?: MCPScope[] | undefined;
-  serverURL?: string | undefined;
-  accessToken?: SDKOptions["accessToken"] | undefined;
-  serverIdx?: SDKOptions["serverIdx"] | undefined;
-}) {
-  const server = new McpServer({
-    name: "S2",
-    version: "0.15.13",
-  });
-
-  const client = new S2Core({
-    accessToken: deps.accessToken,
-    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$accessTokensListAccessTokens);
-  tool(tool$accessTokensIssueAccessToken);
-  tool(tool$accessTokensRevokeAccessToken);
-  tool(tool$basinsListBasins);
-  tool(tool$basinsCreateBasin);
-  tool(tool$basinsGetBasinConfig);
-  tool(tool$basinsCreateOrReconfigureBasin);
-  tool(tool$basinsDeleteBasin);
-  tool(tool$basinsReconfigureBasin);
-  tool(tool$metricsAccountMetrics);
-  tool(tool$metricsBasinMetrics);
-  tool(tool$metricsStreamMetrics);
-  tool(tool$streamsListStreams);
-  tool(tool$streamsCreateStream);
-  tool(tool$streamsGetStreamConfig);
-  tool(tool$streamsCreateOrReconfigureStream);
-  tool(tool$streamsDeleteStream);
-  tool(tool$streamsReconfigureStream);
-  tool(tool$recordsRead);
-  tool(tool$recordsAppend);
-  tool(tool$recordsCheckTail);
-
-  return server;
-}

package/src/mcp-server/shared.ts

@@ -1,75 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod";
-import { bytesToBase64 } from "../lib/base64.js";
-
-type BinaryData =
-  | Uint8Array
-  | ArrayBuffer
-  | Blob
-  | ReadableStream
-  | Response
-  | string;
-
-export async function consumeStream(
-  stream: ReadableStream<Uint8Array>,
-): Promise<Uint8Array> {
-  const reader = stream.getReader();
-  const chunks: Uint8Array[] = [];
-
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (value != null) chunks.push(value);
-      if (done) break;
-    }
-  } finally {
-    reader.releaseLock();
-  }
-
-  return new Uint8Array(await new Blob(chunks).arrayBuffer());
-}
-
-export function isAsyncIterable(
-  value: unknown,
-): value is AsyncIterable<string> {
-  return (
-    typeof value === "object" && value != null && Symbol.asyncIterator in value
-  );
-}
-
-export function isBinaryData(value: unknown): value is BinaryData {
-  return (
-    value instanceof Uint8Array
-    || value instanceof ArrayBuffer
-    || value instanceof Blob
-    || value instanceof ReadableStream
-    || value instanceof Response
-    || typeof value === "string"
-  );
-}
-
-const base64Schema = z.string().base64();
-
-export async function valueToBase64(
-  value: BinaryData | null | undefined,
-): Promise<string | null> {
-  if (value == null) {
-    return null;
-  } else if (value instanceof Uint8Array) {
-    return bytesToBase64(value);
-  } else if (value instanceof ArrayBuffer) {
-    return bytesToBase64(new Uint8Array(value));
-  } else if (value instanceof Response || value instanceof Blob) {
-    return bytesToBase64(new Uint8Array(await value.arrayBuffer()));
-  } else if (value instanceof ReadableStream) {
-    return bytesToBase64(await consumeStream(value));
-  } else if (typeof value === "string") {
-    return base64Schema.parse(value);
-  } else {
-    value satisfies never;
-    throw new Error(`Unsupported image value type: ${typeof value}`);
-  }
-}

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

@@ -1,36 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { accessTokensIssueAccessToken } from "../../funcs/accessTokensIssueAccessToken.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.AccessTokenInfo$inboundSchema,
-};
-
-export const tool$accessTokensIssueAccessToken: ToolDefinition<typeof args> = {
-  name: "access-tokens-issue-access-token",
-  description: `Issue a new access token.`,
-  scopes: ["write", "write", "write"],
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await accessTokensIssueAccessToken(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

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

@@ -1,36 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { accessTokensListAccessTokens } from "../../funcs/accessTokensListAccessTokens.js";
-import * as operations from "../../models/operations/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: operations.ListAccessTokensRequest$inboundSchema,
-};
-
-export const tool$accessTokensListAccessTokens: ToolDefinition<typeof args> = {
-  name: "access-tokens-list-access-tokens",
-  description: `List access tokens.`,
-  scopes: ["read", "read", "read"],
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await accessTokensListAccessTokens(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

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

@@ -1,34 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { accessTokensRevokeAccessToken } from "../../funcs/accessTokensRevokeAccessToken.js";
-import * as operations from "../../models/operations/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: operations.RevokeAccessTokenRequest$inboundSchema,
-};
-
-export const tool$accessTokensRevokeAccessToken: ToolDefinition<typeof args> = {
-  name: "access-tokens-revoke-access-token",
-  description: `Revoke an access token.`,
-  scopes: ["write", "write", "write"],
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await accessTokensRevokeAccessToken(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    return formatResult(void 0, apiCall);
-  },
-};

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

@@ -1,36 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { basinsCreateBasin } from "../../funcs/basinsCreateBasin.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.CreateBasinRequest$inboundSchema,
-};
-
-export const tool$basinsCreateBasin: ToolDefinition<typeof args> = {
-  name: "basins-create-basin",
-  description: `Create a basin.`,
-  scopes: ["write", "write", "write"],
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await basinsCreateBasin(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

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

@@ -1,37 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { basinsCreateOrReconfigureBasin } from "../../funcs/basinsCreateOrReconfigureBasin.js";
-import * as operations from "../../models/operations/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: operations.CreateOrReconfigureBasinRequest$inboundSchema,
-};
-
-export const tool$basinsCreateOrReconfigureBasin: ToolDefinition<typeof args> =
-  {
-    name: "basins-create-or-reconfigure-basin",
-    description: `Create or reconfigure a basin.`,
-    scopes: ["write", "write", "write"],
-    args,
-    tool: async (client, args, ctx) => {
-      const [result, apiCall] = await basinsCreateOrReconfigureBasin(
-        client,
-        args.request,
-        { fetchOptions: { signal: ctx.signal } },
-      ).$inspect();
-
-      if (!result.ok) {
-        return {
-          content: [{ type: "text", text: result.error.message }],
-          isError: true,
-        };
-      }
-
-      const value = result.value;
-
-      return formatResult(value, apiCall);
-    },
-  };

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

@@ -1,34 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { basinsDeleteBasin } from "../../funcs/basinsDeleteBasin.js";
-import * as operations from "../../models/operations/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: operations.DeleteBasinRequest$inboundSchema,
-};
-
-export const tool$basinsDeleteBasin: ToolDefinition<typeof args> = {
-  name: "basins-delete-basin",
-  description: `Delete a basin.`,
-  scopes: ["write", "write", "write"],
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await basinsDeleteBasin(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    return formatResult(void 0, apiCall);
-  },
-};