@s2-dev/streamstore 0.13.3 → 0.15.0

package/src/index.ts

@@ -4,6 +4,8 @@
 
 export * from "./lib/config.js";
 export * as files from "./lib/files.js";
+export { HTTPClient } from "./lib/http.js";
+export type { Fetcher, HTTPClientOptions } from "./lib/http.js";
 export * from "./sdk/sdk.js";
 
 export * from "./index.extras.js";

package/src/lib/config.ts

@@ -26,6 +26,10 @@ export type SDKOptions = {
    * Allows overriding the default server URL used by the SDK
    */
   serverURL?: string | undefined;
+  /**
+   * Allows overriding the default user agent used by the SDK
+   */
+  userAgent?: string | undefined;
   /**
    * Allows overriding the default retry config used by the SDK
    */
@@ -54,8 +58,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.13.3",
-  genVersion: "2.610.0",
+  sdkVersion: "0.15.0",
+  genVersion: "2.618.0",
   userAgent:
-    "speakeasy-sdk/typescript 0.13.3 2.610.0 1.0.0 @s2-dev/streamstore",
+    "speakeasy-sdk/typescript 0.15.0 2.618.0 1.0.0 @s2-dev/streamstore",
 } as const;

package/src/lib/sdks.ts

@@ -65,6 +65,7 @@ type RequestConfig = {
   headers?: HeadersInit;
   security?: SecurityState | null;
   uaHeader?: string;
+  userAgent?: string | undefined;
   timeoutMs?: number;
 };
 
@@ -96,19 +97,21 @@ export class ClientSDK {
     } else {
       this.#hooks = new SDKHooks();
     }
-    this._options = { ...options, hooks: this.#hooks };
-
     const url = serverURLFromOptions(options);
     if (url) {
       url.pathname = url.pathname.replace(/\/+$/, "") + "/";
     }
+
     const { baseURL, client } = this.#hooks.sdkInit({
       baseURL: url,
       client: options.httpClient || new HTTPClient(),
     });
     this._baseURL = baseURL;
     this.#httpClient = client;
-    this.#logger = options.debugLogger;
+
+    this._options = { ...options, hooks: this.#hooks };
+
+    this.#logger = this._options.debugLogger;
     if (!this.#logger && env().S2_DEBUG) {
       this.#logger = console;
     }
@@ -184,7 +187,10 @@ export class ClientSDK {
     // Only set user agent header in non-browser-like environments since CORS
     // policy disallows setting it in browsers e.g. Chrome throws an error.
     if (!isBrowserLike) {
-      headers.set(conf.uaHeader ?? "user-agent", SDK_METADATA.userAgent);
+      headers.set(
+        conf.uaHeader ?? "user-agent",
+        conf.userAgent ?? SDK_METADATA.userAgent,
+      );
     }
 
     const fetchOptions: Omit<RequestInit, "method" | "body"> = {

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.13.3",
+    currentVersion: "0.15.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -22,6 +22,9 @@ 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";
@@ -42,7 +45,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "S2",
-    version: "0.13.3",
+    version: "0.15.0",
   });
 
   const client = new S2Core({
@@ -81,6 +84,9 @@ export function createMCPServer(deps: {
   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);

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

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsAccountMetrics } from "../../funcs/metricsAccountMetrics.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.AccountMetricsRequest$inboundSchema,
+};
+
+export const tool$metricsAccountMetrics: ToolDefinition<typeof args> = {
+  name: "metrics-account-metrics",
+  description: `Get account level metrics.`,
+  scopes: ["read", "read", "read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsAccountMetrics(
+      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/metricsBasinMetrics.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsBasinMetrics } from "../../funcs/metricsBasinMetrics.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.BasinMetricsRequest$inboundSchema,
+};
+
+export const tool$metricsBasinMetrics: ToolDefinition<typeof args> = {
+  name: "metrics-basin-metrics",
+  description: `Get metrics for a basin.`,
+  scopes: ["read", "read", "read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsBasinMetrics(
+      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/metricsStreamMetrics.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsStreamMetrics } from "../../funcs/metricsStreamMetrics.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.StreamMetricsRequest$inboundSchema,
+};
+
+export const tool$metricsStreamMetrics: ToolDefinition<typeof args> = {
+  name: "metrics-stream-metrics",
+  description: `Get metrics for a stream.`,
+  scopes: ["read", "read", "read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await metricsStreamMetrics(
+      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/models/components/accesstokeninfo.ts

@@ -34,7 +34,7 @@ export type AccessTokenInfo = {
    * Access token ID.
    *
    * @remarks
-   * It must be unique to the account and between 1 and 96 characters.
+   * It must be unique to the account and between 1 and 96 bytes in length.
    */
   id: string;
   scope: AccessTokenScope;

package/src/models/components/accountmetricset.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const AccountMetricSet = {
+  ActiveBasins: "active_basins",
+  AccountOps: "account_ops",
+} as const;
+export type AccountMetricSet = ClosedEnum<typeof AccountMetricSet>;
+
+/** @internal */
+export const AccountMetricSet$inboundSchema: z.ZodNativeEnum<
+  typeof AccountMetricSet
+> = z.nativeEnum(AccountMetricSet);
+
+/** @internal */
+export const AccountMetricSet$outboundSchema: z.ZodNativeEnum<
+  typeof AccountMetricSet
+> = AccountMetricSet$inboundSchema;
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AccountMetricSet$ {
+  /** @deprecated use `AccountMetricSet$inboundSchema` instead. */
+  export const inboundSchema = AccountMetricSet$inboundSchema;
+  /** @deprecated use `AccountMetricSet$outboundSchema` instead. */
+  export const outboundSchema = AccountMetricSet$outboundSchema;
+}

package/src/models/components/accumulation.ts

@@ -0,0 +1,150 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  MetricUnit,
+  MetricUnit$inboundSchema,
+  MetricUnit$outboundSchema,
+} from "./metricunit.js";
+import {
+  TimeseriesInterval,
+  TimeseriesInterval$inboundSchema,
+  TimeseriesInterval$outboundSchema,
+} from "./timeseriesinterval.js";
+
+export type Values = number | number;
+
+export type Accumulation = {
+  bucketLength: TimeseriesInterval;
+  /**
+   * Timeseries name.
+   */
+  name: string;
+  unit: MetricUnit;
+  /**
+   * Timeseries values.
+   *
+   * @remarks
+   *
+   * Each element is a tuple containing the seconds since Unix epoch, followed by the data
+   * point.
+   *
+   * The data point represented the accumulated value for a bucket of time, starting
+   * at the provided epoch, lasting for the duration of the `bucket_length` parameter above.
+   */
+  values: Array<Array<number | number>>;
+};
+
+/** @internal */
+export const Values$inboundSchema: z.ZodType<Values, z.ZodTypeDef, unknown> = z
+  .union([z.number().int(), z.number()]);
+
+/** @internal */
+export type Values$Outbound = number | number;
+
+/** @internal */
+export const Values$outboundSchema: z.ZodType<
+  Values$Outbound,
+  z.ZodTypeDef,
+  Values
+> = z.union([z.number().int(), z.number()]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Values$ {
+  /** @deprecated use `Values$inboundSchema` instead. */
+  export const inboundSchema = Values$inboundSchema;
+  /** @deprecated use `Values$outboundSchema` instead. */
+  export const outboundSchema = Values$outboundSchema;
+  /** @deprecated use `Values$Outbound` instead. */
+  export type Outbound = Values$Outbound;
+}
+
+export function valuesToJSON(values: Values): string {
+  return JSON.stringify(Values$outboundSchema.parse(values));
+}
+
+export function valuesFromJSON(
+  jsonString: string,
+): SafeParseResult<Values, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Values$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Values' from JSON`,
+  );
+}
+
+/** @internal */
+export const Accumulation$inboundSchema: z.ZodType<
+  Accumulation,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  bucket_length: TimeseriesInterval$inboundSchema,
+  name: z.string(),
+  unit: MetricUnit$inboundSchema,
+  values: z.array(z.array(z.union([z.number().int(), z.number()]))),
+}).transform((v) => {
+  return remap$(v, {
+    "bucket_length": "bucketLength",
+  });
+});
+
+/** @internal */
+export type Accumulation$Outbound = {
+  bucket_length: string;
+  name: string;
+  unit: string;
+  values: Array<Array<number | number>>;
+};
+
+/** @internal */
+export const Accumulation$outboundSchema: z.ZodType<
+  Accumulation$Outbound,
+  z.ZodTypeDef,
+  Accumulation
+> = z.object({
+  bucketLength: TimeseriesInterval$outboundSchema,
+  name: z.string(),
+  unit: MetricUnit$outboundSchema,
+  values: z.array(z.array(z.union([z.number().int(), z.number()]))),
+}).transform((v) => {
+  return remap$(v, {
+    bucketLength: "bucket_length",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Accumulation$ {
+  /** @deprecated use `Accumulation$inboundSchema` instead. */
+  export const inboundSchema = Accumulation$inboundSchema;
+  /** @deprecated use `Accumulation$outboundSchema` instead. */
+  export const outboundSchema = Accumulation$outboundSchema;
+  /** @deprecated use `Accumulation$Outbound` instead. */
+  export type Outbound = Accumulation$Outbound;
+}
+
+export function accumulationToJSON(accumulation: Accumulation): string {
+  return JSON.stringify(Accumulation$outboundSchema.parse(accumulation));
+}
+
+export function accumulationFromJSON(
+  jsonString: string,
+): SafeParseResult<Accumulation, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Accumulation$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Accumulation' from JSON`,
+  );
+}

package/src/models/components/basinmetricset.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const BasinMetricSet = {
+  Storage: "storage",
+  AppendOps: "append_ops",
+  ReadOps: "read_ops",
+  ReadThroughput: "read_throughput",
+  AppendThroughput: "append_throughput",
+  BasinOps: "basin_ops",
+} as const;
+export type BasinMetricSet = ClosedEnum<typeof BasinMetricSet>;
+
+/** @internal */
+export const BasinMetricSet$inboundSchema: z.ZodNativeEnum<
+  typeof BasinMetricSet
+> = z.nativeEnum(BasinMetricSet);
+
+/** @internal */
+export const BasinMetricSet$outboundSchema: z.ZodNativeEnum<
+  typeof BasinMetricSet
+> = BasinMetricSet$inboundSchema;
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BasinMetricSet$ {
+  /** @deprecated use `BasinMetricSet$inboundSchema` instead. */
+  export const inboundSchema = BasinMetricSet$inboundSchema;
+  /** @deprecated use `BasinMetricSet$outboundSchema` instead. */
+  export const outboundSchema = BasinMetricSet$outboundSchema;
+}

package/src/models/components/createbasinrequest.ts

@@ -22,7 +22,12 @@ export type Scope = BasinScope;
 
 export type CreateBasinRequest = {
   /**
-   * Basin name.
+   * Basin name which must be globally unique.
+   *
+   * @remarks
+   * It can be between 8 and 48 characters in length,
+   * and comprise lowercase letters, numbers and hyphens.
+   * It cannot begin or end with a hyphen.
    */
   basin: string;
   config?: BasinConfig | null | undefined;

package/src/models/components/createstreamrequest.ts

@@ -16,7 +16,10 @@ import {
 export type CreateStreamRequest = {
   config?: StreamConfig | null | undefined;
   /**
-   * Stream name.
+   * Stream name that is unique to the basin.
+   *
+   * @remarks
+   * It can be between 1 and 512 bytes in length.
    */
   stream: string;
 };

package/src/models/components/gauge.ts

@@ -0,0 +1,131 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  MetricUnit,
+  MetricUnit$inboundSchema,
+  MetricUnit$outboundSchema,
+} from "./metricunit.js";
+
+export type GaugeValues = number | number;
+
+export type Gauge = {
+  /**
+   * Timeseries name.
+   */
+  name: string;
+  unit: MetricUnit;
+  /**
+   * Timeseries values.
+   *
+   * @remarks
+   *
+   * Each element is a tuple containing the seconds since Unix epoch, followed by the data
+   * point.
+   *
+   * The data point represents the value at the instant of the epoch.
+   */
+  values: Array<Array<number | number>>;
+};
+
+/** @internal */
+export const GaugeValues$inboundSchema: z.ZodType<
+  GaugeValues,
+  z.ZodTypeDef,
+  unknown
+> = z.union([z.number().int(), z.number()]);
+
+/** @internal */
+export type GaugeValues$Outbound = number | number;
+
+/** @internal */
+export const GaugeValues$outboundSchema: z.ZodType<
+  GaugeValues$Outbound,
+  z.ZodTypeDef,
+  GaugeValues
+> = z.union([z.number().int(), z.number()]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace GaugeValues$ {
+  /** @deprecated use `GaugeValues$inboundSchema` instead. */
+  export const inboundSchema = GaugeValues$inboundSchema;
+  /** @deprecated use `GaugeValues$outboundSchema` instead. */
+  export const outboundSchema = GaugeValues$outboundSchema;
+  /** @deprecated use `GaugeValues$Outbound` instead. */
+  export type Outbound = GaugeValues$Outbound;
+}
+
+export function gaugeValuesToJSON(gaugeValues: GaugeValues): string {
+  return JSON.stringify(GaugeValues$outboundSchema.parse(gaugeValues));
+}
+
+export function gaugeValuesFromJSON(
+  jsonString: string,
+): SafeParseResult<GaugeValues, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GaugeValues$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GaugeValues' from JSON`,
+  );
+}
+
+/** @internal */
+export const Gauge$inboundSchema: z.ZodType<Gauge, z.ZodTypeDef, unknown> = z
+  .object({
+    name: z.string(),
+    unit: MetricUnit$inboundSchema,
+    values: z.array(z.array(z.union([z.number().int(), z.number()]))),
+  });
+
+/** @internal */
+export type Gauge$Outbound = {
+  name: string;
+  unit: string;
+  values: Array<Array<number | number>>;
+};
+
+/** @internal */
+export const Gauge$outboundSchema: z.ZodType<
+  Gauge$Outbound,
+  z.ZodTypeDef,
+  Gauge
+> = z.object({
+  name: z.string(),
+  unit: MetricUnit$outboundSchema,
+  values: z.array(z.array(z.union([z.number().int(), z.number()]))),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Gauge$ {
+  /** @deprecated use `Gauge$inboundSchema` instead. */
+  export const inboundSchema = Gauge$inboundSchema;
+  /** @deprecated use `Gauge$outboundSchema` instead. */
+  export const outboundSchema = Gauge$outboundSchema;
+  /** @deprecated use `Gauge$Outbound` instead. */
+  export type Outbound = Gauge$Outbound;
+}
+
+export function gaugeToJSON(gauge: Gauge): string {
+  return JSON.stringify(Gauge$outboundSchema.parse(gauge));
+}
+
+export function gaugeFromJSON(
+  jsonString: string,
+): SafeParseResult<Gauge, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Gauge$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Gauge' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -4,29 +4,39 @@
 
 export * from "./accesstokeninfo.js";
 export * from "./accesstokenscope.js";
+export * from "./accountmetricset.js";
+export * from "./accumulation.js";
 export * from "./appendack.js";
 export * from "./appendinput.js";
 export * from "./appendrecord.js";
 export * from "./basinconfig.js";
 export * from "./basininfo.js";
+export * from "./basinmetricset.js";
 export * from "./basinreconfiguration.js";
 export * from "./basinscope.js";
 export * from "./basinstate.js";
 export * from "./createbasinrequest.js";
 export * from "./createorreconfigurebasinrequest.js";
 export * from "./createstreamrequest.js";
+export * from "./gauge.js";
 export * from "./issueaccesstokenresponse.js";
+export * from "./label.js";
 export * from "./listaccesstokensresponse.js";
 export * from "./listbasinsresponse.js";
 export * from "./liststreamsresponse.js";
+export * from "./metric.js";
+export * from "./metricsetresponse.js";
+export * from "./metricunit.js";
 export * from "./operation.js";
 export * from "./permittedoperationgroups.js";
+export * from "./pingeventdata.js";
 export * from "./readbatch.js";
 export * from "./readevent.js";
 export * from "./readwritepermissions.js";
 export * from "./resourceset.js";
 export * from "./retentionpolicy.js";
 export * from "./s2format.js";
+export * from "./scalar.js";
 export * from "./security.js";
 export * from "./sequencedrecord.js";
 export * from "./storageclass.js";
@@ -35,6 +45,7 @@ export * from "./streaminfo.js";
 export * from "./streamposition.js";
 export * from "./streamreconfiguration.js";
 export * from "./tailresponse.js";
+export * from "./timeseriesinterval.js";
 export * from "./timestampingconfig.js";
 export * from "./timestampingmode.js";
 export * from "./timestampingreconfiguration.js";