@s2-dev/streamstore 0.14.0 → 0.15.0

package/src/models/components/scalar.ts

@@ -0,0 +1,78 @@
+/*
+ * 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 Scalar = {
+  /**
+   * Metric name.
+   */
+  name: string;
+  unit: MetricUnit;
+  /**
+   * Metric value.
+   */
+  value: number;
+};
+
+/** @internal */
+export const Scalar$inboundSchema: z.ZodType<Scalar, z.ZodTypeDef, unknown> = z
+  .object({
+    name: z.string(),
+    unit: MetricUnit$inboundSchema,
+    value: z.number(),
+  });
+
+/** @internal */
+export type Scalar$Outbound = {
+  name: string;
+  unit: string;
+  value: number;
+};
+
+/** @internal */
+export const Scalar$outboundSchema: z.ZodType<
+  Scalar$Outbound,
+  z.ZodTypeDef,
+  Scalar
+> = z.object({
+  name: z.string(),
+  unit: MetricUnit$outboundSchema,
+  value: 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 Scalar$ {
+  /** @deprecated use `Scalar$inboundSchema` instead. */
+  export const inboundSchema = Scalar$inboundSchema;
+  /** @deprecated use `Scalar$outboundSchema` instead. */
+  export const outboundSchema = Scalar$outboundSchema;
+  /** @deprecated use `Scalar$Outbound` instead. */
+  export type Outbound = Scalar$Outbound;
+}
+
+export function scalarToJSON(scalar: Scalar): string {
+  return JSON.stringify(Scalar$outboundSchema.parse(scalar));
+}
+
+export function scalarFromJSON(
+  jsonString: string,
+): SafeParseResult<Scalar, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Scalar$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Scalar' from JSON`,
+  );
+}

package/src/models/components/timeseriesinterval.ts

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

package/src/models/errors/appendconditionfailed.ts

@@ -59,14 +59,14 @@ export class SeqNum extends Error {
  * Fencing token did not match.
  *
  * @remarks
- * The expected fencing token is returned, encoded with base64.
+ * The expected fencing token is returned.
  */
 export type FencingTokenData = {
   /**
    * Fencing token did not match.
    *
    * @remarks
-   * The expected fencing token is returned, encoded with base64.
+   * The expected fencing token is returned.
    */
   fencingTokenMismatch: string;
 };
@@ -75,14 +75,14 @@ export type FencingTokenData = {
  * Fencing token did not match.
  *
  * @remarks
- * The expected fencing token is returned, encoded with base64.
+ * The expected fencing token is returned.
  */
 export class FencingToken extends Error {
   /**
    * Fencing token did not match.
    *
    * @remarks
-   * The expected fencing token is returned, encoded with base64.
+   * The expected fencing token is returned.
    */
   fencingTokenMismatch: string;
 

package/src/models/operations/accountmetrics.ts

@@ -0,0 +1,91 @@
+/*
+ * 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 * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type AccountMetricsRequest = {
+  /**
+   * Metric type to return.
+   */
+  set: components.AccountMetricSet;
+  /**
+   * Start timestamp, in Unix epoch seconds, if applicable for metric set.
+   */
+  start?: number | undefined;
+  /**
+   * End timestamp, in Unix epoch seconds, if applicable for metric set.
+   */
+  end?: number | undefined;
+  /**
+   * For timeseries metric sets, the interval to aggregate over.
+   */
+  interval?: components.TimeseriesInterval | undefined;
+};
+
+/** @internal */
+export const AccountMetricsRequest$inboundSchema: z.ZodType<
+  AccountMetricsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  set: components.AccountMetricSet$inboundSchema,
+  start: z.number().int().optional(),
+  end: z.number().int().optional(),
+  interval: components.TimeseriesInterval$inboundSchema.optional(),
+});
+
+/** @internal */
+export type AccountMetricsRequest$Outbound = {
+  set: string;
+  start?: number | undefined;
+  end?: number | undefined;
+  interval?: string | undefined;
+};
+
+/** @internal */
+export const AccountMetricsRequest$outboundSchema: z.ZodType<
+  AccountMetricsRequest$Outbound,
+  z.ZodTypeDef,
+  AccountMetricsRequest
+> = z.object({
+  set: components.AccountMetricSet$outboundSchema,
+  start: z.number().int().optional(),
+  end: z.number().int().optional(),
+  interval: components.TimeseriesInterval$outboundSchema.optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AccountMetricsRequest$ {
+  /** @deprecated use `AccountMetricsRequest$inboundSchema` instead. */
+  export const inboundSchema = AccountMetricsRequest$inboundSchema;
+  /** @deprecated use `AccountMetricsRequest$outboundSchema` instead. */
+  export const outboundSchema = AccountMetricsRequest$outboundSchema;
+  /** @deprecated use `AccountMetricsRequest$Outbound` instead. */
+  export type Outbound = AccountMetricsRequest$Outbound;
+}
+
+export function accountMetricsRequestToJSON(
+  accountMetricsRequest: AccountMetricsRequest,
+): string {
+  return JSON.stringify(
+    AccountMetricsRequest$outboundSchema.parse(accountMetricsRequest),
+  );
+}
+
+export function accountMetricsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<AccountMetricsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AccountMetricsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AccountMetricsRequest' from JSON`,
+  );
+}

package/src/models/operations/basinmetrics.ts

@@ -0,0 +1,98 @@
+/*
+ * 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 * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type BasinMetricsRequest = {
+  /**
+   * Metric type to return.
+   */
+  set: components.BasinMetricSet;
+  /**
+   * Start timestamp, in Unix epoch seconds, if applicable for metric set.
+   */
+  start?: number | undefined;
+  /**
+   * End timestamp, in Unix epoch seconds, if applicable for metric set.
+   */
+  end?: number | undefined;
+  /**
+   * For timeseries metric sets, the interval to aggregate over.
+   */
+  interval?: components.TimeseriesInterval | undefined;
+  /**
+   * Basin name.
+   */
+  basin: string;
+};
+
+/** @internal */
+export const BasinMetricsRequest$inboundSchema: z.ZodType<
+  BasinMetricsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  set: components.BasinMetricSet$inboundSchema,
+  start: z.number().int().optional(),
+  end: z.number().int().optional(),
+  interval: components.TimeseriesInterval$inboundSchema.optional(),
+  basin: z.string(),
+});
+
+/** @internal */
+export type BasinMetricsRequest$Outbound = {
+  set: string;
+  start?: number | undefined;
+  end?: number | undefined;
+  interval?: string | undefined;
+  basin: string;
+};
+
+/** @internal */
+export const BasinMetricsRequest$outboundSchema: z.ZodType<
+  BasinMetricsRequest$Outbound,
+  z.ZodTypeDef,
+  BasinMetricsRequest
+> = z.object({
+  set: components.BasinMetricSet$outboundSchema,
+  start: z.number().int().optional(),
+  end: z.number().int().optional(),
+  interval: components.TimeseriesInterval$outboundSchema.optional(),
+  basin: z.string(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BasinMetricsRequest$ {
+  /** @deprecated use `BasinMetricsRequest$inboundSchema` instead. */
+  export const inboundSchema = BasinMetricsRequest$inboundSchema;
+  /** @deprecated use `BasinMetricsRequest$outboundSchema` instead. */
+  export const outboundSchema = BasinMetricsRequest$outboundSchema;
+  /** @deprecated use `BasinMetricsRequest$Outbound` instead. */
+  export type Outbound = BasinMetricsRequest$Outbound;
+}
+
+export function basinMetricsRequestToJSON(
+  basinMetricsRequest: BasinMetricsRequest,
+): string {
+  return JSON.stringify(
+    BasinMetricsRequest$outboundSchema.parse(basinMetricsRequest),
+  );
+}
+
+export function basinMetricsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<BasinMetricsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BasinMetricsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BasinMetricsRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -2,7 +2,9 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+export * from "./accountmetrics.js";
 export * from "./append.js";
+export * from "./basinmetrics.js";
 export * from "./checktail.js";
 export * from "./createorreconfigurebasin.js";
 export * from "./createorreconfigurestream.js";
@@ -18,3 +20,4 @@ export * from "./read.js";
 export * from "./reconfigurebasin.js";
 export * from "./reconfigurestream.js";
 export * from "./revokeaccesstoken.js";
+export * from "./streammetrics.js";

package/src/models/operations/streammetrics.ts

@@ -0,0 +1,76 @@
+/*
+ * 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";
+
+export type StreamMetricsRequest = {
+  /**
+   * Basin name.
+   */
+  basin: string;
+  /**
+   * Stream name.
+   */
+  stream: string;
+};
+
+/** @internal */
+export const StreamMetricsRequest$inboundSchema: z.ZodType<
+  StreamMetricsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  basin: z.string(),
+  stream: z.string(),
+});
+
+/** @internal */
+export type StreamMetricsRequest$Outbound = {
+  basin: string;
+  stream: string;
+};
+
+/** @internal */
+export const StreamMetricsRequest$outboundSchema: z.ZodType<
+  StreamMetricsRequest$Outbound,
+  z.ZodTypeDef,
+  StreamMetricsRequest
+> = z.object({
+  basin: z.string(),
+  stream: z.string(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace StreamMetricsRequest$ {
+  /** @deprecated use `StreamMetricsRequest$inboundSchema` instead. */
+  export const inboundSchema = StreamMetricsRequest$inboundSchema;
+  /** @deprecated use `StreamMetricsRequest$outboundSchema` instead. */
+  export const outboundSchema = StreamMetricsRequest$outboundSchema;
+  /** @deprecated use `StreamMetricsRequest$Outbound` instead. */
+  export type Outbound = StreamMetricsRequest$Outbound;
+}
+
+export function streamMetricsRequestToJSON(
+  streamMetricsRequest: StreamMetricsRequest,
+): string {
+  return JSON.stringify(
+    StreamMetricsRequest$outboundSchema.parse(streamMetricsRequest),
+  );
+}
+
+export function streamMetricsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<StreamMetricsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StreamMetricsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StreamMetricsRequest' from JSON`,
+  );
+}

package/src/sdk/metrics.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metricsAccountMetrics } from "../funcs/metricsAccountMetrics.js";
+import { metricsBasinMetrics } from "../funcs/metricsBasinMetrics.js";
+import { metricsStreamMetrics } from "../funcs/metricsStreamMetrics.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Metrics extends ClientSDK {
+  /**
+   * Get account level metrics.
+   */
+  async accountMetrics(
+    request: operations.AccountMetricsRequest,
+    options?: RequestOptions,
+  ): Promise<components.MetricSetResponse> {
+    return unwrapAsync(metricsAccountMetrics(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get metrics for a basin.
+   */
+  async basinMetrics(
+    request: operations.BasinMetricsRequest,
+    options?: RequestOptions,
+  ): Promise<components.MetricSetResponse> {
+    return unwrapAsync(metricsBasinMetrics(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get metrics for a stream.
+   */
+  async streamMetrics(
+    request: operations.StreamMetricsRequest,
+    options?: RequestOptions,
+  ): Promise<components.MetricSetResponse> {
+    return unwrapAsync(metricsStreamMetrics(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -5,6 +5,7 @@
 import { ClientSDK } from "../lib/sdks.js";
 import { AccessTokens } from "./accesstokens.js";
 import { Basins } from "./basins.js";
+import { Metrics } from "./metrics.js";
 import { Records } from "./records.js";
 import { Streams } from "./streams.js";
 
@@ -19,6 +20,11 @@ export class S2 extends ClientSDK {
     return (this._basins ??= new Basins(this._options));
   }
 
+  private _metrics?: Metrics;
+  get metrics(): Metrics {
+    return (this._metrics ??= new Metrics(this._options));
+  }
+
   private _streams?: Streams;
   get streams(): Streams {
     return (this._streams ??= new Streams(this._options));