Add SeamHttp.fromConsoleSessionToken

src/lib/seam/connect/auth.ts

@@ -1,9 +1,11 @@
 import {
   isSeamHttpOptionsWithApiKey,
   isSeamHttpOptionsWithClientSessionToken,
+  isSeamHttpOptionsWithConsoleSessionToken,
   SeamHttpInvalidOptionsError,
   type SeamHttpOptionsWithApiKey,
   type SeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptionsWithConsoleSessionToken,
 } from './options.js'
 import type { Options } from './parse-options.js'
 
@@ -22,8 +24,18 @@ export const getAuthHeaders = (options: Options): Headers => {
     return getAuthHeadersForClientSessionToken(options)
   }
 
+  if (isSeamHttpOptionsWithConsoleSessionToken(options)) {
+    return getAuthHeadersForConsoleSessionToken(options)
+  }
+
   throw new SeamHttpInvalidOptionsError(
-    'Must specify an apiKey, clientSessionToken, or publishableKey',
+    [
+      'Must specify',
+      'an apiKey,',
+      'clientSessionToken,',
+      'publishableKey,',
+      'or consoleSessionToken with a workspaceId',
+    ].join(' '),
   )
 }
 
@@ -96,6 +108,40 @@ const getAuthHeadersForClientSessionToken = ({
   }
 }
 
+const getAuthHeadersForConsoleSessionToken = ({
+  consoleSessionToken,
+  workspaceId,
+}: SeamHttpOptionsWithConsoleSessionToken): Headers => {
+  if (isJwt(consoleSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A JWT cannot be used as a consoleSessionToken',
+    )
+  }
+
+  if (isClientSessionToken(consoleSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Client Session Token cannot be used as a consoleSessionToken',
+    )
+  }
+
+  if (isPublishableKey(consoleSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Publishable Key cannot be used as a clientSessionToken',
+    )
+  }
+
+  if (!isAccessToken(consoleSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      `Unknown or invalid consoleSessionToken format, expected token to start with ${accessTokenPrefix}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${consoleSessionToken}`,
+    'seam-workspace-id': workspaceId,
+  }
+}
+
 const getAuthHeadersForPublishableKey = (publishableKey: string): Headers => {
   if (isJwt(publishableKey)) {
     throw new SeamHttpInvalidTokenError(

src/lib/seam/connect/options.ts

@@ -5,6 +5,7 @@ export type SeamHttpOptions =
   | SeamHttpOptionsWithClient
   | SeamHttpOptionsWithApiKey
   | SeamHttpOptionsWithClientSessionToken
+  | SeamHttpOptionsWithConsoleSessionToken
 
 interface SeamHttpCommonOptions extends ClientOptions {
   endpoint?: string
@@ -53,6 +54,12 @@ export const isSeamHttpOptionsWithApiKey = (
     )
   }
 
+  if ('consoleSessionToken' in options && options.consoleSessionToken != null) {
+    throw new SeamHttpInvalidOptionsError(
+      'The consoleSessionToken option cannot be used with the apiKey option',
+    )
+  }
+
   return true
 }
 
@@ -69,7 +76,40 @@ export const isSeamHttpOptionsWithClientSessionToken = (
 
   if ('apiKey' in options && options.apiKey != null) {
     throw new SeamHttpInvalidOptionsError(
-      'The clientSessionToken option cannot be used with the apiKey option',
+      'The apiKey option cannot be used with the clientSessionToken option',
+    )
+  }
+
+  if ('consoleSessionToken' in options && options.consoleSessionToken != null) {
+    throw new SeamHttpInvalidOptionsError(
+      'The consoleSessionToken option cannot be used with the clientSessionToken option',
+    )
+  }
+
+  return true
+}
+
+export interface SeamHttpOptionsWithConsoleSessionToken
+  extends SeamHttpCommonOptions {
+  consoleSessionToken: string
+  workspaceId: string
+}
+
+export const isSeamHttpOptionsWithConsoleSessionToken = (
+  options: SeamHttpOptions,
+): options is SeamHttpOptionsWithConsoleSessionToken => {
+  if (!('consoleSessionToken' in options)) return false
+  if (options.consoleSessionToken == null) return false
+
+  if ('apiKey' in options && options.apiKey != null) {
+    throw new SeamHttpInvalidOptionsError(
+      'The apiKey option cannot be used with the consoleSessionToken option',
+    )
+  }
+
+  if ('clientSessionToken' in options && options.clientSessionToken != null) {
+    throw new SeamHttpInvalidOptionsError(
+      'The clientSessionToken option cannot be used with the consoleSessionToken option',
     )
   }
 

src/lib/seam/connect/seam-http.ts

@@ -4,12 +4,14 @@ import {
   isSeamHttpOptionsWithApiKey,
   isSeamHttpOptionsWithClient,
   isSeamHttpOptionsWithClientSessionToken,
+  isSeamHttpOptionsWithConsoleSessionToken,
   type SeamHttpFromPublishableKeyOptions,
   SeamHttpInvalidOptionsError,
   type SeamHttpOptions,
   type SeamHttpOptionsWithApiKey,
   type SeamHttpOptionsWithClient,
   type SeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptionsWithConsoleSessionToken,
 } from './options.js'
 import { parseOptions } from './parse-options.js'
 import {
@@ -87,6 +89,23 @@ export class SeamHttp {
     return SeamHttp.fromClientSessionToken(token, options)
   }
 
+  static fromConsoleSessionToken(
+    consoleSessionToken: SeamHttpOptionsWithConsoleSessionToken['consoleSessionToken'],
+    workspaceId: SeamHttpOptionsWithConsoleSessionToken['workspaceId'],
+    options: Omit<
+      SeamHttpOptionsWithConsoleSessionToken,
+      'consoleSessionToken' | 'workspaceId'
+    > = {},
+  ): SeamHttp {
+    const constructorOptions = { ...options, consoleSessionToken, workspaceId }
+    if (!isSeamHttpOptionsWithConsoleSessionToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        'Missing consoleSessionToken or workspaceId',
+      )
+    }
+    return new SeamHttp(constructorOptions)
+  }
+
   get accessCodes(): SeamHttpAccessCodes {
     return SeamHttpAccessCodes.fromClient(this.client)
   }