@seamapi/http 1.36.0 → 1.38.0

package/src/lib/seam/connect/routes/bridges/bridges.ts

@@ -0,0 +1,242 @@
+/*
+ * Automatically generated by codegen/smith.ts.
+ * Do not edit this file or add other files to this directory.
+ */
+
+import type { RouteRequestBody, RouteResponse } from '@seamapi/types/connect'
+
+import { seamApiLtsVersion } from 'lib/lts-version.js'
+import {
+  getAuthHeadersForClientSessionToken,
+  warnOnInsecureuserIdentifierKey,
+} from 'lib/seam/connect/auth.js'
+import { type Client, createClient } from 'lib/seam/connect/client.js'
+import {
+  isSeamHttpOptionsWithApiKey,
+  isSeamHttpOptionsWithClient,
+  isSeamHttpOptionsWithClientSessionToken,
+  isSeamHttpOptionsWithConsoleSessionToken,
+  isSeamHttpOptionsWithPersonalAccessToken,
+  type SeamHttpFromPublishableKeyOptions,
+  SeamHttpInvalidOptionsError,
+  type SeamHttpOptions,
+  type SeamHttpOptionsWithApiKey,
+  type SeamHttpOptionsWithClient,
+  type SeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptionsWithConsoleSessionToken,
+  type SeamHttpOptionsWithPersonalAccessToken,
+  type SeamHttpRequestOptions,
+} from 'lib/seam/connect/options.js'
+import {
+  limitToSeamHttpRequestOptions,
+  parseOptions,
+} from 'lib/seam/connect/parse-options.js'
+import { SeamHttpClientSessions } from 'lib/seam/connect/routes/client-sessions/index.js'
+import { SeamHttpRequest } from 'lib/seam/connect/seam-http-request.js'
+import { SeamPaginator } from 'lib/seam/connect/seam-paginator.js'
+import type { SetNonNullable } from 'lib/types.js'
+
+export class SeamHttpBridges {
+  client: Client
+  readonly defaults: Required<SeamHttpRequestOptions>
+  readonly ltsVersion = seamApiLtsVersion
+  static ltsVersion = seamApiLtsVersion
+
+  constructor(apiKeyOrOptions: string | SeamHttpOptions = {}) {
+    const options = parseOptions(apiKeyOrOptions)
+    if (!options.isUndocumentedApiEnabled) {
+      throw new Error(
+        'Cannot use undocumented API without isUndocumentedApiEnabled',
+      )
+    }
+    this.client = 'client' in options ? options.client : createClient(options)
+    this.defaults = limitToSeamHttpRequestOptions(options)
+  }
+
+  static fromClient(
+    client: SeamHttpOptionsWithClient['client'],
+    options: Omit<SeamHttpOptionsWithClient, 'client'> = {},
+  ): SeamHttpBridges {
+    const constructorOptions = { ...options, client }
+    if (!isSeamHttpOptionsWithClient(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError('Missing client')
+    }
+    return new SeamHttpBridges(constructorOptions)
+  }
+
+  static fromApiKey(
+    apiKey: SeamHttpOptionsWithApiKey['apiKey'],
+    options: Omit<SeamHttpOptionsWithApiKey, 'apiKey'> = {},
+  ): SeamHttpBridges {
+    const constructorOptions = { ...options, apiKey }
+    if (!isSeamHttpOptionsWithApiKey(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError('Missing apiKey')
+    }
+    return new SeamHttpBridges(constructorOptions)
+  }
+
+  static fromClientSessionToken(
+    clientSessionToken: SeamHttpOptionsWithClientSessionToken['clientSessionToken'],
+    options: Omit<
+      SeamHttpOptionsWithClientSessionToken,
+      'clientSessionToken'
+    > = {},
+  ): SeamHttpBridges {
+    const constructorOptions = { ...options, clientSessionToken }
+    if (!isSeamHttpOptionsWithClientSessionToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError('Missing clientSessionToken')
+    }
+    return new SeamHttpBridges(constructorOptions)
+  }
+
+  static async fromPublishableKey(
+    publishableKey: string,
+    userIdentifierKey: string,
+    options: SeamHttpFromPublishableKeyOptions = {},
+  ): Promise<SeamHttpBridges> {
+    warnOnInsecureuserIdentifierKey(userIdentifierKey)
+    const clientOptions = parseOptions({ ...options, publishableKey })
+    if (isSeamHttpOptionsWithClient(clientOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        'The client option cannot be used with SeamHttpBridges.fromPublishableKey',
+      )
+    }
+    const client = createClient(clientOptions)
+    const clientSessions = SeamHttpClientSessions.fromClient(client)
+    const { token } = await clientSessions.getOrCreate({
+      user_identifier_key: userIdentifierKey,
+    })
+    return SeamHttpBridges.fromClientSessionToken(token, options)
+  }
+
+  static fromConsoleSessionToken(
+    consoleSessionToken: SeamHttpOptionsWithConsoleSessionToken['consoleSessionToken'],
+    workspaceId: SeamHttpOptionsWithConsoleSessionToken['workspaceId'],
+    options: Omit<
+      SeamHttpOptionsWithConsoleSessionToken,
+      'consoleSessionToken' | 'workspaceId'
+    > = {},
+  ): SeamHttpBridges {
+    const constructorOptions = { ...options, consoleSessionToken, workspaceId }
+    if (!isSeamHttpOptionsWithConsoleSessionToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        'Missing consoleSessionToken or workspaceId',
+      )
+    }
+    return new SeamHttpBridges(constructorOptions)
+  }
+
+  static fromPersonalAccessToken(
+    personalAccessToken: SeamHttpOptionsWithPersonalAccessToken['personalAccessToken'],
+    workspaceId: SeamHttpOptionsWithPersonalAccessToken['workspaceId'],
+    options: Omit<
+      SeamHttpOptionsWithPersonalAccessToken,
+      'personalAccessToken' | 'workspaceId'
+    > = {},
+  ): SeamHttpBridges {
+    const constructorOptions = { ...options, personalAccessToken, workspaceId }
+    if (!isSeamHttpOptionsWithPersonalAccessToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        'Missing personalAccessToken or workspaceId',
+      )
+    }
+    return new SeamHttpBridges(constructorOptions)
+  }
+
+  createPaginator<const TResponse, const TResponseKey extends keyof TResponse>(
+    request: SeamHttpRequest<TResponse, TResponseKey>,
+  ): SeamPaginator<TResponse, TResponseKey> {
+    return new SeamPaginator<TResponse, TResponseKey>(this, request)
+  }
+
+  async updateClientSessionToken(
+    clientSessionToken: SeamHttpOptionsWithClientSessionToken['clientSessionToken'],
+  ): Promise<void> {
+    const { headers } = this.client.defaults
+    const authHeaders = getAuthHeadersForClientSessionToken({
+      clientSessionToken,
+    })
+    for (const key of Object.keys(authHeaders)) {
+      if (headers[key] == null) {
+        throw new Error(
+          'Cannot update a clientSessionToken on a client created without a clientSessionToken',
+        )
+      }
+    }
+    this.client.defaults.headers = { ...headers, ...authHeaders }
+    const clientSessions = SeamHttpClientSessions.fromClient(this.client)
+    await clientSessions.get()
+  }
+
+  get(
+    parameters?: BridgesGetParameters,
+    options: BridgesGetOptions = {},
+  ): BridgesGetRequest {
+    if (!this.defaults.isUndocumentedApiEnabled) {
+      throw new Error(
+        'Cannot use undocumented API without isUndocumentedApiEnabled',
+      )
+    }
+    return new SeamHttpRequest(this, {
+      pathname: '/bridges/get',
+      method: 'POST',
+      body: parameters,
+      responseKey: 'bridge',
+      options,
+    })
+  }
+
+  list(
+    parameters?: BridgesListParameters,
+    options: BridgesListOptions = {},
+  ): BridgesListRequest {
+    if (!this.defaults.isUndocumentedApiEnabled) {
+      throw new Error(
+        'Cannot use undocumented API without isUndocumentedApiEnabled',
+      )
+    }
+    return new SeamHttpRequest(this, {
+      pathname: '/bridges/list',
+      method: 'POST',
+      body: parameters,
+      responseKey: 'bridges',
+      options,
+    })
+  }
+}
+
+export type BridgesGetParameters = RouteRequestBody<'/bridges/get'>
+
+/**
+ * @deprecated Use BridgesGetParameters instead.
+ */
+export type BridgesGetParams = BridgesGetParameters
+
+/**
+ * @deprecated Use BridgesGetRequest instead.
+ */
+export type BridgesGetResponse = SetNonNullable<
+  Required<RouteResponse<'/bridges/get'>>
+>
+
+export type BridgesGetRequest = SeamHttpRequest<BridgesGetResponse, 'bridge'>
+
+export type BridgesGetOptions = Record<string, never>
+
+export type BridgesListParameters = RouteRequestBody<'/bridges/list'>
+
+/**
+ * @deprecated Use BridgesListParameters instead.
+ */
+export type BridgesListParams = BridgesListParameters
+
+/**
+ * @deprecated Use BridgesListRequest instead.
+ */
+export type BridgesListResponse = SetNonNullable<
+  Required<RouteResponse<'/bridges/list'>>
+>
+
+export type BridgesListRequest = SeamHttpRequest<BridgesListResponse, 'bridges'>
+
+export type BridgesListOptions = Record<string, never>

package/src/lib/seam/connect/routes/bridges/index.ts

@@ -0,0 +1,6 @@
+/*
+ * Automatically generated by codegen/smith.ts.
+ * Do not edit this file or add other files to this directory.
+ */
+
+export * from './bridges.js'

package/src/lib/seam/connect/routes/client-sessions/client-sessions.ts

@@ -163,138 +163,238 @@ export class SeamHttpClientSessions {
   }
 
   create(
-    body?: ClientSessionsCreateBody,
-  ): SeamHttpRequest<ClientSessionsCreateResponse, 'client_session'> {
+    parameters?: ClientSessionsCreateParameters,
+    options: ClientSessionsCreateOptions = {},
+  ): ClientSessionsCreateRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/create',
       method: 'PUT',
-      body,
+      body: parameters,
       responseKey: 'client_session',
+      options,
     })
   }
 
   delete(
-    params?: ClientSessionsDeleteParams,
-  ): SeamHttpRequest<void, undefined> {
+    parameters?: ClientSessionsDeleteParameters,
+    options: ClientSessionsDeleteOptions = {},
+  ): ClientSessionsDeleteRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/delete',
       method: 'POST',
-      body: params,
+      body: parameters,
       responseKey: undefined,
+      options,
     })
   }
 
   get(
-    params?: ClientSessionsGetParams,
-  ): SeamHttpRequest<ClientSessionsGetResponse, 'client_session'> {
+    parameters?: ClientSessionsGetParameters,
+    options: ClientSessionsGetOptions = {},
+  ): ClientSessionsGetRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/get',
       method: 'POST',
-      body: params,
+      body: parameters,
       responseKey: 'client_session',
+      options,
     })
   }
 
   getOrCreate(
-    body?: ClientSessionsGetOrCreateBody,
-  ): SeamHttpRequest<ClientSessionsGetOrCreateResponse, 'client_session'> {
+    parameters?: ClientSessionsGetOrCreateParameters,
+    options: ClientSessionsGetOrCreateOptions = {},
+  ): ClientSessionsGetOrCreateRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/get_or_create',
       method: 'POST',
-      body,
+      body: parameters,
       responseKey: 'client_session',
+      options,
     })
   }
 
   grantAccess(
-    body?: ClientSessionsGrantAccessBody,
-  ): SeamHttpRequest<void, undefined> {
+    parameters?: ClientSessionsGrantAccessParameters,
+    options: ClientSessionsGrantAccessOptions = {},
+  ): ClientSessionsGrantAccessRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/grant_access',
       method: 'PATCH',
-      body,
+      body: parameters,
       responseKey: undefined,
+      options,
     })
   }
 
   list(
-    params?: ClientSessionsListParams,
-  ): SeamHttpRequest<ClientSessionsListResponse, 'client_sessions'> {
+    parameters?: ClientSessionsListParameters,
+    options: ClientSessionsListOptions = {},
+  ): ClientSessionsListRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/list',
       method: 'POST',
-      body: params,
+      body: parameters,
       responseKey: 'client_sessions',
+      options,
     })
   }
 
-  revoke(body?: ClientSessionsRevokeBody): SeamHttpRequest<void, undefined> {
+  revoke(
+    parameters?: ClientSessionsRevokeParameters,
+    options: ClientSessionsRevokeOptions = {},
+  ): ClientSessionsRevokeRequest {
     return new SeamHttpRequest(this, {
       pathname: '/client_sessions/revoke',
       method: 'POST',
-      body,
+      body: parameters,
       responseKey: undefined,
+      options,
     })
   }
 }
 
-export type ClientSessionsCreateBody =
+export type ClientSessionsCreateParameters =
   RouteRequestBody<'/client_sessions/create'>
 
+/**
+ * @deprecated Use ClientSessionsCreateParameters instead.
+ */
+export type ClientSessionsCreateBody = ClientSessionsCreateParameters
+
+/**
+ * @deprecated Use ClientSessionsCreateRequest instead.
+ */
 export type ClientSessionsCreateResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/create'>>
 >
 
-export type ClientSessionsCreateOptions = never
+export type ClientSessionsCreateRequest = SeamHttpRequest<
+  ClientSessionsCreateResponse,
+  'client_session'
+>
+
+export type ClientSessionsCreateOptions = Record<string, never>
 
-export type ClientSessionsDeleteParams =
+export type ClientSessionsDeleteParameters =
   RouteRequestBody<'/client_sessions/delete'>
 
+/**
+ * @deprecated Use ClientSessionsDeleteParameters instead.
+ */
+export type ClientSessionsDeleteParams = ClientSessionsDeleteParameters
+
+/**
+ * @deprecated Use ClientSessionsDeleteRequest instead.
+ */
 export type ClientSessionsDeleteResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/delete'>>
 >
 
-export type ClientSessionsDeleteOptions = never
+export type ClientSessionsDeleteRequest = SeamHttpRequest<void, undefined>
 
-export type ClientSessionsGetParams = RouteRequestBody<'/client_sessions/get'>
+export type ClientSessionsDeleteOptions = Record<string, never>
 
+export type ClientSessionsGetParameters =
+  RouteRequestBody<'/client_sessions/get'>
+
+/**
+ * @deprecated Use ClientSessionsGetParameters instead.
+ */
+export type ClientSessionsGetParams = ClientSessionsGetParameters
+
+/**
+ * @deprecated Use ClientSessionsGetRequest instead.
+ */
 export type ClientSessionsGetResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/get'>>
 >
 
-export type ClientSessionsGetOptions = never
+export type ClientSessionsGetRequest = SeamHttpRequest<
+  ClientSessionsGetResponse,
+  'client_session'
+>
+
+export type ClientSessionsGetOptions = Record<string, never>
 
-export type ClientSessionsGetOrCreateBody =
+export type ClientSessionsGetOrCreateParameters =
   RouteRequestBody<'/client_sessions/get_or_create'>
 
+/**
+ * @deprecated Use ClientSessionsGetOrCreateParameters instead.
+ */
+export type ClientSessionsGetOrCreateBody = ClientSessionsGetOrCreateParameters
+
+/**
+ * @deprecated Use ClientSessionsGetOrCreateRequest instead.
+ */
 export type ClientSessionsGetOrCreateResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/get_or_create'>>
 >
 
-export type ClientSessionsGetOrCreateOptions = never
+export type ClientSessionsGetOrCreateRequest = SeamHttpRequest<
+  ClientSessionsGetOrCreateResponse,
+  'client_session'
+>
+
+export type ClientSessionsGetOrCreateOptions = Record<string, never>
 
-export type ClientSessionsGrantAccessBody =
+export type ClientSessionsGrantAccessParameters =
   RouteRequestBody<'/client_sessions/grant_access'>
 
+/**
+ * @deprecated Use ClientSessionsGrantAccessParameters instead.
+ */
+export type ClientSessionsGrantAccessBody = ClientSessionsGrantAccessParameters
+
+/**
+ * @deprecated Use ClientSessionsGrantAccessRequest instead.
+ */
 export type ClientSessionsGrantAccessResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/grant_access'>>
 >
 
-export type ClientSessionsGrantAccessOptions = never
+export type ClientSessionsGrantAccessRequest = SeamHttpRequest<void, undefined>
+
+export type ClientSessionsGrantAccessOptions = Record<string, never>
+
+export type ClientSessionsListParameters =
+  RouteRequestBody<'/client_sessions/list'>
 
-export type ClientSessionsListParams = RouteRequestBody<'/client_sessions/list'>
+/**
+ * @deprecated Use ClientSessionsListParameters instead.
+ */
+export type ClientSessionsListParams = ClientSessionsListParameters
 
+/**
+ * @deprecated Use ClientSessionsListRequest instead.
+ */
 export type ClientSessionsListResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/list'>>
 >
 
-export type ClientSessionsListOptions = never
+export type ClientSessionsListRequest = SeamHttpRequest<
+  ClientSessionsListResponse,
+  'client_sessions'
+>
+
+export type ClientSessionsListOptions = Record<string, never>
 
-export type ClientSessionsRevokeBody =
+export type ClientSessionsRevokeParameters =
   RouteRequestBody<'/client_sessions/revoke'>
 
+/**
+ * @deprecated Use ClientSessionsRevokeParameters instead.
+ */
+export type ClientSessionsRevokeBody = ClientSessionsRevokeParameters
+
+/**
+ * @deprecated Use ClientSessionsRevokeRequest instead.
+ */
 export type ClientSessionsRevokeResponse = SetNonNullable<
   Required<RouteResponse<'/client_sessions/revoke'>>
 >
 
-export type ClientSessionsRevokeOptions = never
+export type ClientSessionsRevokeRequest = SeamHttpRequest<void, undefined>
+
+export type ClientSessionsRevokeOptions = Record<string, never>

package/src/lib/seam/connect/routes/connect-webviews/connect-webviews.ts

@@ -164,81 +164,139 @@ export class SeamHttpConnectWebviews {
   }
 
   create(
-    body?: ConnectWebviewsCreateBody,
-  ): SeamHttpRequest<ConnectWebviewsCreateResponse, 'connect_webview'> {
+    parameters?: ConnectWebviewsCreateParameters,
+    options: ConnectWebviewsCreateOptions = {},
+  ): ConnectWebviewsCreateRequest {
     return new SeamHttpRequest(this, {
       pathname: '/connect_webviews/create',
       method: 'POST',
-      body,
+      body: parameters,
       responseKey: 'connect_webview',
+      options,
     })
   }
 
   delete(
-    params?: ConnectWebviewsDeleteParams,
-  ): SeamHttpRequest<void, undefined> {
+    parameters?: ConnectWebviewsDeleteParameters,
+    options: ConnectWebviewsDeleteOptions = {},
+  ): ConnectWebviewsDeleteRequest {
     return new SeamHttpRequest(this, {
       pathname: '/connect_webviews/delete',
       method: 'POST',
-      body: params,
+      body: parameters,
       responseKey: undefined,
+      options,
     })
   }
 
   get(
-    params?: ConnectWebviewsGetParams,
-  ): SeamHttpRequest<ConnectWebviewsGetResponse, 'connect_webview'> {
+    parameters?: ConnectWebviewsGetParameters,
+    options: ConnectWebviewsGetOptions = {},
+  ): ConnectWebviewsGetRequest {
     return new SeamHttpRequest(this, {
       pathname: '/connect_webviews/get',
       method: 'POST',
-      body: params,
+      body: parameters,
       responseKey: 'connect_webview',
+      options,
     })
   }
 
   list(
-    params?: ConnectWebviewsListParams,
-  ): SeamHttpRequest<ConnectWebviewsListResponse, 'connect_webviews'> {
+    parameters?: ConnectWebviewsListParameters,
+    options: ConnectWebviewsListOptions = {},
+  ): ConnectWebviewsListRequest {
     return new SeamHttpRequest(this, {
       pathname: '/connect_webviews/list',
       method: 'POST',
-      body: params,
+      body: parameters,
       responseKey: 'connect_webviews',
+      options,
     })
   }
 }
 
-export type ConnectWebviewsCreateBody =
+export type ConnectWebviewsCreateParameters =
   RouteRequestBody<'/connect_webviews/create'>
 
+/**
+ * @deprecated Use ConnectWebviewsCreateParameters instead.
+ */
+export type ConnectWebviewsCreateBody = ConnectWebviewsCreateParameters
+
+/**
+ * @deprecated Use ConnectWebviewsCreateRequest instead.
+ */
 export type ConnectWebviewsCreateResponse = SetNonNullable<
   Required<RouteResponse<'/connect_webviews/create'>>
 >
 
-export type ConnectWebviewsCreateOptions = never
+export type ConnectWebviewsCreateRequest = SeamHttpRequest<
+  ConnectWebviewsCreateResponse,
+  'connect_webview'
+>
+
+export type ConnectWebviewsCreateOptions = Record<string, never>
 
-export type ConnectWebviewsDeleteParams =
+export type ConnectWebviewsDeleteParameters =
   RouteRequestBody<'/connect_webviews/delete'>
 
+/**
+ * @deprecated Use ConnectWebviewsDeleteParameters instead.
+ */
+export type ConnectWebviewsDeleteParams = ConnectWebviewsDeleteParameters
+
+/**
+ * @deprecated Use ConnectWebviewsDeleteRequest instead.
+ */
 export type ConnectWebviewsDeleteResponse = SetNonNullable<
   Required<RouteResponse<'/connect_webviews/delete'>>
 >
 
-export type ConnectWebviewsDeleteOptions = never
+export type ConnectWebviewsDeleteRequest = SeamHttpRequest<void, undefined>
 
-export type ConnectWebviewsGetParams = RouteRequestBody<'/connect_webviews/get'>
+export type ConnectWebviewsDeleteOptions = Record<string, never>
 
+export type ConnectWebviewsGetParameters =
+  RouteRequestBody<'/connect_webviews/get'>
+
+/**
+ * @deprecated Use ConnectWebviewsGetParameters instead.
+ */
+export type ConnectWebviewsGetParams = ConnectWebviewsGetParameters
+
+/**
+ * @deprecated Use ConnectWebviewsGetRequest instead.
+ */
 export type ConnectWebviewsGetResponse = SetNonNullable<
   Required<RouteResponse<'/connect_webviews/get'>>
 >
 
-export type ConnectWebviewsGetOptions = never
+export type ConnectWebviewsGetRequest = SeamHttpRequest<
+  ConnectWebviewsGetResponse,
+  'connect_webview'
+>
 
-export type ConnectWebviewsListParams =
+export type ConnectWebviewsGetOptions = Record<string, never>
+
+export type ConnectWebviewsListParameters =
   RouteRequestBody<'/connect_webviews/list'>
 
+/**
+ * @deprecated Use ConnectWebviewsListParameters instead.
+ */
+export type ConnectWebviewsListParams = ConnectWebviewsListParameters
+
+/**
+ * @deprecated Use ConnectWebviewsListRequest instead.
+ */
 export type ConnectWebviewsListResponse = SetNonNullable<
   Required<RouteResponse<'/connect_webviews/list'>>
 >
 
-export type ConnectWebviewsListOptions = never
+export type ConnectWebviewsListRequest = SeamHttpRequest<
+  ConnectWebviewsListResponse,
+  'connect_webviews'
+>
+
+export type ConnectWebviewsListOptions = Record<string, never>