@s2-dev/streamstore 0.11.0 → 0.11.2

package/src/funcs/streamsReconfigureStream.ts

@@ -109,8 +109,8 @@ async function $do(
     Accept: "application/json",
   }));
 
-  const secConfig = await extractSecurity(client._options.bearerAuth);
-  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const secConfig = await extractSecurity(client._options.accessToken);
+  const securityInput = secConfig == null ? {} : { accessToken: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
@@ -120,7 +120,7 @@ async function $do(
 
     resolvedSecurity: requestSecurity,
 
-    securitySource: client._options.bearerAuth,
+    securitySource: client._options.accessToken,
     retryConfig: options?.retries
       || client._options.retryConfig
       || { strategy: "none" },

package/src/lib/config.ts

@@ -15,7 +15,7 @@ export const ServerList = [
 ] as const;
 
 export type SDKOptions = {
-  bearerAuth?: string | (() => Promise<string>) | undefined;
+  accessToken?: string | (() => Promise<string>) | undefined;
 
   httpClient?: HTTPClient;
   /**
@@ -54,8 +54,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.11.0",
-  genVersion: "2.593.4",
+  sdkVersion: "0.11.2",
+  genVersion: "2.597.9",
   userAgent:
-    "speakeasy-sdk/typescript 0.11.0 2.593.4 1.0.0 @s2-dev/streamstore",
+    "speakeasy-sdk/typescript 0.11.2 2.597.9 1.0.0 @s2-dev/streamstore",
 } as const;

package/src/lib/env.ts

@@ -7,13 +7,13 @@ import { dlv } from "./dlv.js";
 import * as z from "zod";
 
 export interface Env {
-  S2_BEARER_AUTH?: string | undefined;
+  S2_ACCESS_TOKEN?: string | undefined;
 
   S2_DEBUG?: boolean | undefined;
 }
 
 export const envSchema: z.ZodType<Env, z.ZodTypeDef, unknown> = z.object({
-  S2_BEARER_AUTH: z.string().optional(),
+  S2_ACCESS_TOKEN: z.string().optional(),
 
   S2_DEBUG: z.coerce.boolean().optional(),
 });

package/src/lib/sdks.ts

@@ -47,12 +47,14 @@ export type RequestOptions = {
    */
   serverURL?: string | URL;
   /**
+   * @deprecated `fetchOptions` has been flattened into `RequestOptions`.
+   *
    * Sets various request options on the `fetch` call made by an SDK method.
    *
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options|Request}
    */
   fetchOptions?: Omit<RequestInit, "method" | "body">;
-};
+} & Omit<RequestInit, "method" | "body">;
 
 type RequestConfig = {
   method: string;
@@ -172,7 +174,9 @@ export class ClientSDK {
     cookie = cookie.startsWith("; ") ? cookie.slice(2) : cookie;
     headers.set("cookie", cookie);
 
-    const userHeaders = new Headers(options?.fetchOptions?.headers);
+    const userHeaders = new Headers(
+      options?.headers ?? options?.fetchOptions?.headers,
+    );
     for (const [k, v] of userHeaders) {
       headers.set(k, v);
     }
@@ -183,20 +187,16 @@ export class ClientSDK {
       headers.set(conf.uaHeader ?? "user-agent", SDK_METADATA.userAgent);
     }
 
-    let fetchOptions = options?.fetchOptions;
+    const fetchOptions: Omit<RequestInit, "method" | "body"> = {
+      ...options?.fetchOptions,
+      ...options,
+    };
     if (!fetchOptions?.signal && conf.timeoutMs && conf.timeoutMs > 0) {
       const timeoutSignal = AbortSignal.timeout(conf.timeoutMs);
-      if (!fetchOptions) {
-        fetchOptions = { signal: timeoutSignal };
-      } else {
-        fetchOptions.signal = timeoutSignal;
-      }
+      fetchOptions.signal = timeoutSignal;
     }
 
     if (conf.body instanceof ReadableStream) {
-      if (!fetchOptions) {
-        fetchOptions = {};
-      }
       Object.assign(fetchOptions, { duplex: "half" });
     }
 

package/src/lib/security.ts

@@ -244,7 +244,7 @@ export function resolveGlobalSecurity(
       {
         fieldName: "Authorization",
         type: "http:bearer",
-        value: security?.bearerAuth ?? env().S2_BEARER_AUTH,
+        value: security?.accessToken ?? env().S2_ACCESS_TOKEN,
       },
     ],
   );

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

@@ -49,9 +49,9 @@ export const startCommand = buildCommand({
           },
         }
         : {}),
-      "bearer-auth": {
+      "access-token": {
         kind: "parsed",
-        brief: "Sets the bearerAuth auth field for the API",
+        brief: "Sets the accessToken auth field for the API",
         optional: true,
         parse: (value) => {
           return z.string().parse(value);

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

@@ -19,7 +19,7 @@ interface StartCommandFlags {
   readonly port: number;
   readonly tool?: string[];
   readonly scope?: MCPScope[];
-  readonly "bearer-auth"?: string | undefined;
+  readonly "access-token"?: string | undefined;
   readonly "server-url"?: string;
   readonly "server-index"?: SDKOptions["serverIdx"];
   readonly "log-level": ConsoleLoggerLevel;
@@ -50,7 +50,7 @@ async function startStdio(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     scopes: flags.scope,
-    ...{ bearerAuth: flags["bearer-auth"] },
+    ...{ accessToken: flags["access-token"] },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });
@@ -71,7 +71,7 @@ async function startSSE(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     scopes: flags.scope,
-    ...{ bearerAuth: flags["bearer-auth"] },
+    ...{ accessToken: flags["access-token"] },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });

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

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

package/src/mcp-server/server.ts

@@ -21,6 +21,7 @@ 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$recordsCheckTail } from "./tools/recordsCheckTail.js";
 import { tool$streamsCreateOrReconfigureStream } from "./tools/streamsCreateOrReconfigureStream.js";
 import { tool$streamsDeleteStream } from "./tools/streamsDeleteStream.js";
 import { tool$streamsGetStreamConfig } from "./tools/streamsGetStreamConfig.js";
@@ -32,16 +33,16 @@ export function createMCPServer(deps: {
   allowedTools?: string[] | undefined;
   scopes?: MCPScope[] | undefined;
   serverURL?: string | undefined;
-  bearerAuth?: SDKOptions["bearerAuth"] | undefined;
+  accessToken?: SDKOptions["accessToken"] | undefined;
   serverIdx?: SDKOptions["serverIdx"] | undefined;
 }) {
   const server = new McpServer({
     name: "S2",
-    version: "0.11.0",
+    version: "0.11.2",
   });
 
   const client = new S2Core({
-    bearerAuth: deps.bearerAuth,
+    accessToken: deps.accessToken,
     serverURL: deps.serverURL,
     serverIdx: deps.serverIdx,
   });
@@ -80,6 +81,7 @@ export function createMCPServer(deps: {
   tool(tool$streamsCreateOrReconfigureStream);
   tool(tool$streamsDeleteStream);
   tool(tool$streamsReconfigureStream);
+  tool(tool$recordsCheckTail);
 
   return server;
 }

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { recordsCheckTail } from "../../funcs/recordsCheckTail.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CheckTailRequest$inboundSchema,
+};
+
+export const tool$recordsCheckTail: ToolDefinition<typeof args> = {
+  name: "records-check-tail",
+  description: `Check the tail.
+
+Check the tail of a stream.`,
+  scopes: ["read"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await recordsCheckTail(
+      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 50 characters.
+   * It must be unique to the account and between 1 and 96 characters.
    */
   id: string;
   scope: AccessTokenScope;

package/src/models/components/checktailresponse.ts

@@ -0,0 +1,75 @@
+/*
+ * 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 {
+  StreamPosition,
+  StreamPosition$inboundSchema,
+  StreamPosition$Outbound,
+  StreamPosition$outboundSchema,
+} from "./streamposition.js";
+
+export type CheckTailResponse = {
+  /**
+   * Position of a record in a stream.
+   */
+  tail: StreamPosition;
+};
+
+/** @internal */
+export const CheckTailResponse$inboundSchema: z.ZodType<
+  CheckTailResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tail: StreamPosition$inboundSchema,
+});
+
+/** @internal */
+export type CheckTailResponse$Outbound = {
+  tail: StreamPosition$Outbound;
+};
+
+/** @internal */
+export const CheckTailResponse$outboundSchema: z.ZodType<
+  CheckTailResponse$Outbound,
+  z.ZodTypeDef,
+  CheckTailResponse
+> = z.object({
+  tail: StreamPosition$outboundSchema,
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace CheckTailResponse$ {
+  /** @deprecated use `CheckTailResponse$inboundSchema` instead. */
+  export const inboundSchema = CheckTailResponse$inboundSchema;
+  /** @deprecated use `CheckTailResponse$outboundSchema` instead. */
+  export const outboundSchema = CheckTailResponse$outboundSchema;
+  /** @deprecated use `CheckTailResponse$Outbound` instead. */
+  export type Outbound = CheckTailResponse$Outbound;
+}
+
+export function checkTailResponseToJSON(
+  checkTailResponse: CheckTailResponse,
+): string {
+  return JSON.stringify(
+    CheckTailResponse$outboundSchema.parse(checkTailResponse),
+  );
+}
+
+export function checkTailResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CheckTailResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CheckTailResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CheckTailResponse' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -9,6 +9,7 @@ export * from "./basininfo.js";
 export * from "./basinreconfiguration.js";
 export * from "./basinscope.js";
 export * from "./basinstate.js";
+export * from "./checktailresponse.js";
 export * from "./createbasinrequest.js";
 export * from "./issueaccesstokenresponse.js";
 export * from "./listaccesstokensresponse.js";
@@ -23,4 +24,8 @@ export * from "./security.js";
 export * from "./storageclass.js";
 export * from "./streamconfig.js";
 export * from "./streaminfo.js";
+export * from "./streamposition.js";
 export * from "./streamreconfiguration.js";
+export * from "./timestampingconfig.js";
+export * from "./timestampingmode.js";
+export * from "./timestampingreconfiguration.js";

package/src/models/components/listaccesstokensresponse.ts

@@ -16,13 +16,13 @@ import {
 
 export type ListAccessTokensResponse = {
   /**
-   * If set, indicates there are more results that can be listed with `start_after`.
+   * Access tokens information.
    */
-  hasMore: boolean;
+  accessTokens: Array<AccessTokenInfo>;
   /**
-   * Access tokens information.
+   * If set, indicates there are more results that can be listed with `start_after`.
    */
-  tokens: Array<AccessTokenInfo>;
+  hasMore: boolean;
 };
 
 /** @internal */
@@ -31,18 +31,19 @@ export const ListAccessTokensResponse$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  access_tokens: z.array(AccessTokenInfo$inboundSchema),
   has_more: z.boolean(),
-  tokens: z.array(AccessTokenInfo$inboundSchema),
 }).transform((v) => {
   return remap$(v, {
+    "access_tokens": "accessTokens",
     "has_more": "hasMore",
   });
 });
 
 /** @internal */
 export type ListAccessTokensResponse$Outbound = {
+  access_tokens: Array<AccessTokenInfo$Outbound>;
   has_more: boolean;
-  tokens: Array<AccessTokenInfo$Outbound>;
 };
 
 /** @internal */
@@ -51,10 +52,11 @@ export const ListAccessTokensResponse$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   ListAccessTokensResponse
 > = z.object({
+  accessTokens: z.array(AccessTokenInfo$outboundSchema),
   hasMore: z.boolean(),
-  tokens: z.array(AccessTokenInfo$outboundSchema),
 }).transform((v) => {
   return remap$(v, {
+    accessTokens: "access_tokens",
     hasMore: "has_more",
   });
 });

package/src/models/components/security.ts

@@ -3,12 +3,13 @@
  */
 
 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";
 
 export type Security = {
-  bearerAuth?: string | undefined;
+  accessToken?: string | undefined;
 };
 
 /** @internal */
@@ -17,12 +18,16 @@ export const Security$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  bearerAuth: z.string().optional(),
+  access_token: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "access_token": "accessToken",
+  });
 });
 
 /** @internal */
 export type Security$Outbound = {
-  bearerAuth?: string | undefined;
+  access_token?: string | undefined;
 };
 
 /** @internal */
@@ -31,7 +36,11 @@ export const Security$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Security
 > = z.object({
-  bearerAuth: z.string().optional(),
+  accessToken: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    accessToken: "access_token",
+  });
 });
 
 /**

package/src/models/components/streamconfig.ts

@@ -18,26 +18,17 @@ import {
   StorageClass$inboundSchema,
   StorageClass$outboundSchema,
 } from "./storageclass.js";
+import {
+  TimestampingConfig,
+  TimestampingConfig$inboundSchema,
+  TimestampingConfig$Outbound,
+  TimestampingConfig$outboundSchema,
+} from "./timestampingconfig.js";
 
 export type StreamConfig = {
-  /**
-   * Controls how to handle timestamps when they are not provided by the client.
-   *
-   * @remarks
-   *  If this is false (or not set), the record's arrival time in milliseconds since Unix epoch
-   * will be assigned as its timestamp. If this is true, then any append without a
-   * client-specified timestamp will be rejected as invalid.
-   */
-  requireClientTimestamps?: boolean | null | undefined;
   retentionPolicy?: RetentionPolicy | null | undefined;
   storageClass?: StorageClass | null | undefined;
-  /**
-   * Allow client timestamps to exceed the arrival time in milliseconds since Unix epoch.
-   *
-   * @remarks
-   * If this is false (or not set), client timestamps will be capped at the arrival time.
-   */
-  uncappedClientTimestamps?: boolean | null | undefined;
+  timestamping: TimestampingConfig;
 };
 
 /** @internal */
@@ -46,25 +37,21 @@ export const StreamConfig$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  require_client_timestamps: z.nullable(z.boolean()).optional(),
   retention_policy: z.nullable(RetentionPolicy$inboundSchema).optional(),
   storage_class: z.nullable(StorageClass$inboundSchema).optional(),
-  uncapped_client_timestamps: z.nullable(z.boolean()).optional(),
+  timestamping: TimestampingConfig$inboundSchema,
 }).transform((v) => {
   return remap$(v, {
-    "require_client_timestamps": "requireClientTimestamps",
     "retention_policy": "retentionPolicy",
     "storage_class": "storageClass",
-    "uncapped_client_timestamps": "uncappedClientTimestamps",
   });
 });
 
 /** @internal */
 export type StreamConfig$Outbound = {
-  require_client_timestamps?: boolean | null | undefined;
   retention_policy?: RetentionPolicy$Outbound | null | undefined;
   storage_class?: string | null | undefined;
-  uncapped_client_timestamps?: boolean | null | undefined;
+  timestamping: TimestampingConfig$Outbound;
 };
 
 /** @internal */
@@ -73,16 +60,13 @@ export const StreamConfig$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   StreamConfig
 > = z.object({
-  requireClientTimestamps: z.nullable(z.boolean()).optional(),
   retentionPolicy: z.nullable(RetentionPolicy$outboundSchema).optional(),
   storageClass: z.nullable(StorageClass$outboundSchema).optional(),
-  uncappedClientTimestamps: z.nullable(z.boolean()).optional(),
+  timestamping: TimestampingConfig$outboundSchema,
 }).transform((v) => {
   return remap$(v, {
-    requireClientTimestamps: "require_client_timestamps",
     retentionPolicy: "retention_policy",
     storageClass: "storage_class",
-    uncappedClientTimestamps: "uncapped_client_timestamps",
   });
 });
 

package/src/models/components/streamposition.ts

@@ -0,0 +1,87 @@
+/*
+ * 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";
+
+/**
+ * Position of a record in a stream.
+ */
+export type StreamPosition = {
+  /**
+   * Sequence number assigned by the service.
+   */
+  seqNum: number;
+  /**
+   * Timestamp, which may be user-specified or assigned by the service.
+   *
+   * @remarks
+   * If it is assigned by the service, it will represent milliseconds since Unix epoch.
+   */
+  timestamp: number;
+};
+
+/** @internal */
+export const StreamPosition$inboundSchema: z.ZodType<
+  StreamPosition,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  seq_num: z.number().int(),
+  timestamp: z.number().int(),
+}).transform((v) => {
+  return remap$(v, {
+    "seq_num": "seqNum",
+  });
+});
+
+/** @internal */
+export type StreamPosition$Outbound = {
+  seq_num: number;
+  timestamp: number;
+};
+
+/** @internal */
+export const StreamPosition$outboundSchema: z.ZodType<
+  StreamPosition$Outbound,
+  z.ZodTypeDef,
+  StreamPosition
+> = z.object({
+  seqNum: z.number().int(),
+  timestamp: z.number().int(),
+}).transform((v) => {
+  return remap$(v, {
+    seqNum: "seq_num",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace StreamPosition$ {
+  /** @deprecated use `StreamPosition$inboundSchema` instead. */
+  export const inboundSchema = StreamPosition$inboundSchema;
+  /** @deprecated use `StreamPosition$outboundSchema` instead. */
+  export const outboundSchema = StreamPosition$outboundSchema;
+  /** @deprecated use `StreamPosition$Outbound` instead. */
+  export type Outbound = StreamPosition$Outbound;
+}
+
+export function streamPositionToJSON(streamPosition: StreamPosition): string {
+  return JSON.stringify(StreamPosition$outboundSchema.parse(streamPosition));
+}
+
+export function streamPositionFromJSON(
+  jsonString: string,
+): SafeParseResult<StreamPosition, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StreamPosition$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StreamPosition' from JSON`,
+  );
+}