@seamapi/http 0.0.2

package/lib/seam/connect/client.js

@@ -0,0 +1,51 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SeamHttp_legacy;
+import { createAxiosClient } from './axios.js';
+import { InvalidSeamHttpOptionsError, isSeamHttpOptionsWithApiKey, isSeamHttpOptionsWithClientSessionToken, } from './client-options.js';
+import { LegacyWorkspacesHttp } from './legacy/workspaces.js';
+import { parseOptions } from './parse-options.js';
+import { WorkspacesHttp } from './routes/workspaces.js';
+export class SeamHttp {
+    constructor(apiKeyOrOptions) {
+        _SeamHttp_legacy.set(this, void 0);
+        const options = parseOptions(apiKeyOrOptions);
+        __classPrivateFieldSet(this, _SeamHttp_legacy, options.enableLegacyMethodBehaivor, "f");
+        this.client = createAxiosClient(options);
+    }
+    static fromApiKey(apiKey, options = {}) {
+        const opts = { ...options, apiKey };
+        if (!isSeamHttpOptionsWithApiKey(opts)) {
+            throw new InvalidSeamHttpOptionsError('Missing apiKey');
+        }
+        return new SeamHttp(opts);
+    }
+    static fromClientSessionToken(clientSessionToken, options = {}) {
+        const opts = { ...options, clientSessionToken };
+        if (!isSeamHttpOptionsWithClientSessionToken(opts)) {
+            throw new InvalidSeamHttpOptionsError('Missing clientSessionToken');
+        }
+        return new SeamHttp(opts);
+    }
+    // TODO
+    // static fromPublishableKey and deprecate getClientSessionToken
+    // TODO: Should we keep makeRequest?
+    // Better to implement error handling and wrapping in an error handler.
+    // makeRequest
+    get workspaces() {
+        if (__classPrivateFieldGet(this, _SeamHttp_legacy, "f"))
+            return new LegacyWorkspacesHttp(this.client);
+        return new WorkspacesHttp(this.client);
+    }
+}
+_SeamHttp_legacy = new WeakMap();
+//# sourceMappingURL=client.js.map

package/lib/seam/connect/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/client.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,uCAAuC,GAIxC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,MAAM,OAAO,QAAQ;IAKnB,YAAY,eAAyC;QAFrD,mCAAgB;QAGd,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,CAAC,CAAA;QAC7C,uBAAA,IAAI,oBAAW,OAAO,CAAC,0BAA0B,MAAA,CAAA;QACjD,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,CAAC,UAAU,CACf,MAA2C,EAC3C,UAAqD,EAAE;QAEvD,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAA;QACnC,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE;YACtC,MAAM,IAAI,2BAA2B,CAAC,gBAAgB,CAAC,CAAA;SACxD;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED,MAAM,CAAC,sBAAsB,CAC3B,kBAA+E,EAC/E,UAGI,EAAE;QAEN,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,kBAAkB,EAAE,CAAA;QAC/C,IAAI,CAAC,uCAAuC,CAAC,IAAI,CAAC,EAAE;YAClD,MAAM,IAAI,2BAA2B,CAAC,4BAA4B,CAAC,CAAA;SACpE;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO;IACP,gEAAgE;IAEhE,oCAAoC;IACpC,uEAAuE;IACvE,cAAc;IAEd,IAAI,UAAU;QACZ,IAAI,uBAAA,IAAI,wBAAQ;YAAE,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9D,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;CACF"}

package/lib/seam/connect/index.d.ts

@@ -0,0 +1 @@
+export * from './client.js';

package/lib/seam/connect/index.js

@@ -0,0 +1,2 @@
+export * from './client.js';
+//# sourceMappingURL=index.js.map

package/lib/seam/connect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/lib/seam/connect/legacy/workspaces.d.ts

@@ -0,0 +1,8 @@
+import type { RouteRequestParams, RouteResponse } from '@seamapi/types/connect';
+import type { SetNonNullable } from 'type-fest';
+import { WorkspacesHttp } from '../../../../lib/seam/connect/routes/workspaces.js';
+export declare class LegacyWorkspacesHttp extends WorkspacesHttp {
+    get(params?: WorkspacesGetParams): Promise<WorkspacesGetResponse['workspace']>;
+}
+export type WorkspacesGetParams = SetNonNullable<Required<RouteRequestParams<'/workspaces/get'>>>;
+export type WorkspacesGetResponse = SetNonNullable<Required<RouteResponse<'/workspaces/get'>>>;

package/lib/seam/connect/legacy/workspaces.js

@@ -0,0 +1,10 @@
+import { WorkspacesHttp } from '../../../../lib/seam/connect/routes/workspaces.js';
+export class LegacyWorkspacesHttp extends WorkspacesHttp {
+    async get(params = {}) {
+        const { data } = await this.client.get('/workspaces/get', {
+            params,
+        });
+        return data.workspace;
+    }
+}
+//# sourceMappingURL=workspaces.js.map

package/lib/seam/connect/legacy/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../../src/lib/seam/connect/legacy/workspaces.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAEtE,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IAC7C,KAAK,CAAC,GAAG,CAChB,SAA8B,EAAE;QAEhC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,iBAAiB,EACjB;YACE,MAAM;SACP,CACF,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;CACF"}

package/lib/seam/connect/parse-options.d.ts

@@ -0,0 +1,2 @@
+import type { SeamHttpOptions } from './client-options.js';
+export declare const parseOptions: (apiKeyOrOptions: string | SeamHttpOptions) => Required<SeamHttpOptions>;

package/lib/seam/connect/parse-options.js

@@ -0,0 +1,20 @@
+export const parseOptions = (apiKeyOrOptions) => {
+    const options = typeof apiKeyOrOptions === 'string'
+        ? { apiKey: apiKeyOrOptions }
+        : apiKeyOrOptions;
+    const endpoint = options.endpoint ??
+        globalThis.process?.env?.['SEAM_ENDPOINT'] ??
+        globalThis.process?.env?.['SEAM_API_URL'] ??
+        'https://connect.getseam.com';
+    const apiKey = 'apiKey' in options
+        ? options.apiKey
+        : globalThis.process?.env?.['SEAM_API_KEY'];
+    return {
+        ...options,
+        ...(apiKey != null ? { apiKey } : {}),
+        endpoint,
+        axiosOptions: options.axiosOptions ?? {},
+        enableLegacyMethodBehaivor: false,
+    };
+};
+//# sourceMappingURL=parse-options.js.map

package/lib/seam/connect/parse-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-options.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/parse-options.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,eAAyC,EACd,EAAE;IAC7B,MAAM,OAAO,GACX,OAAO,eAAe,KAAK,QAAQ;QACjC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE;QAC7B,CAAC,CAAC,eAAe,CAAA;IAErB,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;QAChB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC;QAC1C,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC;QACzC,6BAA6B,CAAA;IAE/B,MAAM,MAAM,GACV,QAAQ,IAAI,OAAO;QACjB,CAAC,CAAC,OAAO,CAAC,MAAM;QAChB,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,CAAA;IAE/C,OAAO;QACL,GAAG,OAAO;QACV,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,QAAQ;QACR,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,0BAA0B,EAAE,KAAK;KAClC,CAAA;AACH,CAAC,CAAA"}

package/lib/seam/connect/routes/workspaces.d.ts

@@ -0,0 +1,11 @@
+import type { RouteRequestParams, RouteResponse } from '@seamapi/types/connect';
+import { Axios } from 'axios';
+import type { SetNonNullable } from 'type-fest';
+import type { SeamHttpOptions } from '../../../../lib/seam/connect/client-options.js';
+export declare class WorkspacesHttp {
+    client: Axios;
+    constructor(apiKeyOrOptionsOrClient: Axios | string | SeamHttpOptions);
+    get(params?: WorkspacesGetParams): Promise<WorkspacesGetResponse['workspace']>;
+}
+export type WorkspacesGetParams = SetNonNullable<Required<RouteRequestParams<'/workspaces/get'>>>;
+export type WorkspacesGetResponse = SetNonNullable<Required<RouteResponse<'/workspaces/get'>>>;

package/lib/seam/connect/routes/workspaces.js

@@ -0,0 +1,20 @@
+import { Axios } from 'axios';
+import { createAxiosClient } from '../../../../lib/seam/connect/axios.js';
+import { parseOptions } from '../../../../lib/seam/connect/parse-options.js';
+export class WorkspacesHttp {
+    constructor(apiKeyOrOptionsOrClient) {
+        if (apiKeyOrOptionsOrClient instanceof Axios) {
+            this.client = apiKeyOrOptionsOrClient;
+            return;
+        }
+        const options = parseOptions(apiKeyOrOptionsOrClient);
+        this.client = createAxiosClient(options);
+    }
+    async get(params = {}) {
+        const { data } = await this.client.get('/workspaces/get', {
+            params,
+        });
+        return data.workspace;
+    }
+}
+//# sourceMappingURL=workspaces.js.map

package/lib/seam/connect/routes/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../../src/lib/seam/connect/routes/workspaces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,MAAM,OAAO,cAAc;IAGzB,YAAY,uBAAyD;QACnE,IAAI,uBAAuB,YAAY,KAAK,EAAE;YAC5C,IAAI,CAAC,MAAM,GAAG,uBAAuB,CAAA;YACrC,OAAM;SACP;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAA;QACrD,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,GAAG,CACP,SAA8B,EAAE;QAEhC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,iBAAiB,EACjB;YACE,MAAM;SACP,CACF,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@seamapi/http",
+  "version": "0.0.2",
+  "description": "JavaScript HTTP client for the Seam API written in TypeScript.",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./dist/index.cjs",
+      "types": "./index.d.ts"
+    },
+    "./connect": {
+      "import": "./connect.js",
+      "require": "./dist/connect.cjs",
+      "types": "./connect.d.ts"
+    }
+  },
+  "module": "index.js",
+  "sideEffects": false,
+  "keywords": [
+    "node"
+  ],
+  "homepage": "https://github.com/seamapi/javascript-http",
+  "bugs": "https://github.com/seamapi/javascript-http/issues",
+  "repository": "seamapi/javascript-http",
+  "license": "MIT",
+  "author": {
+    "name": "Seam Labs, Inc.",
+    "email": "devops@getseam.com"
+  },
+  "files": [
+    "index.js",
+    "index.js.map",
+    "index.d.ts",
+    "connect.js",
+    "connect.js.map",
+    "connect.d.ts",
+    "dist",
+    "lib",
+    "src",
+    "!**/*.test.ts"
+  ],
+  "scripts": {
+    "build": "npm run build:entrypoints",
+    "prebuild": "concurrently --raw --group 'tsx src/index.ts' 'tsx src/connect.ts'",
+    "postbuild": "concurrently --raw --group 'node ./index.js' 'node ./connect.js'",
+    "build:entrypoints": "npm run build:ts",
+    "postbuild:entrypoints": "tsup",
+    "build:ts": "tsc --project tsconfig.build.json",
+    "prebuild:ts": "del 'index.*' 'connect.*' 'lib'",
+    "postbuild:ts": "tsc-alias --project tsconfig.build.json",
+    "typecheck": "tsc",
+    "test": "c8 ava",
+    "pretest": "tsx src/index.ts",
+    "test:update": "ava --update-snapshots",
+    "test:watch": "ava --watch",
+    "test:debug": "ava debug --break",
+    "lint": "eslint --ignore-path .gitignore .",
+    "prelint": "prettier --check --ignore-path .gitignore .",
+    "postversion": "git push --follow-tags",
+    "example": "tsx examples",
+    "example:inspect": "tsx --inspect examples",
+    "format": "eslint --ignore-path .gitignore --fix .",
+    "preformat": "prettier --write --ignore-path .gitignore .",
+    "report": "c8 report"
+  },
+  "engines": {
+    "node": ">=16.13.0",
+    "npm": ">= 8.1.0"
+  },
+  "peerDependencies": {
+    "@seamapi/types": "^1.0.0",
+    "type-fest": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@seamapi/types": {
+      "optional": true
+    },
+    "type-fest": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "axios": "^1.5.0"
+  },
+  "devDependencies": {
+    "@seamapi/types": "^1.14.0",
+    "@types/node": "^18.11.18",
+    "ava": "^5.0.1",
+    "c8": "^8.0.0",
+    "concurrently": "^8.2.1",
+    "del-cli": "^5.0.0",
+    "eslint": "^8.9.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-config-standard": "^17.1.0",
+    "eslint-config-standard-with-typescript": "^39.0.0",
+    "eslint-plugin-simple-import-sort": "^10.0.0",
+    "eslint-plugin-unused-imports": "^3.0.0",
+    "landlubber": "^1.0.0",
+    "prettier": "^3.0.0",
+    "tsc-alias": "^1.8.2",
+    "tsup": "^7.2.0",
+    "tsx": "^3.12.1",
+    "type-fest": "^4.3.1",
+    "typescript": "^5.1.0"
+  }
+}

package/src/connect.ts

@@ -0,0 +1 @@
+export * from './lib/seam/connect/index.js'

package/src/index.ts

@@ -0,0 +1 @@
+export default null

package/src/lib/seam/connect/auth.ts

@@ -0,0 +1,86 @@
+import {
+  InvalidSeamHttpOptionsError,
+  isSeamHttpOptionsWithApiKey,
+  isSeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptions,
+  type SeamHttpOptionsWithApiKey,
+  type SeamHttpOptionsWithClientSessionToken,
+} from './client-options.js'
+
+type Headers = Record<string, string>
+
+export const getAuthHeaders = (options: SeamHttpOptions): Headers => {
+  if (isSeamHttpOptionsWithApiKey(options)) {
+    return getAuthHeadersForApiKey(options)
+  }
+
+  if (isSeamHttpOptionsWithClientSessionToken(options)) {
+    return getAuthHeadersForClientSessionToken(options)
+  }
+
+  throw new InvalidSeamHttpOptionsError(
+    'Must specify an apiKey or clientSessionToken',
+  )
+}
+
+const getAuthHeadersForApiKey = ({
+  apiKey,
+}: SeamHttpOptionsWithApiKey): Headers => {
+  if (isClientSessionToken(apiKey)) {
+    throw new InvalidSeamTokenError(
+      'A Client Session Token cannot be used as an apiKey',
+    )
+  }
+
+  if (isAccessToken(apiKey)) {
+    throw new InvalidSeamTokenError(
+      'An access token cannot be used as an apiKey',
+    )
+  }
+
+  if (isJwt(apiKey) || !isSeamToken(apiKey)) {
+    throw new InvalidSeamTokenError(
+      `Unknown or invalid apiKey format, expected token to start with ${tokenPrefix}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${apiKey}`,
+  }
+}
+
+const getAuthHeadersForClientSessionToken = ({
+  clientSessionToken,
+}: SeamHttpOptionsWithClientSessionToken): Headers => {
+  if (!isClientSessionToken(clientSessionToken)) {
+    throw new InvalidSeamTokenError(
+      `Unknown or invalid clientSessionToken format, expected token to start with ${clientSessionTokenPrefix}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${clientSessionToken}`,
+    'client-session-token': clientSessionToken,
+  }
+}
+
+export class InvalidSeamTokenError extends Error {
+  constructor(message: string) {
+    super(`SeamHttp received an invalid token: ${message}`)
+    this.name = this.constructor.name
+    Error.captureStackTrace(this, this.constructor)
+  }
+}
+
+const tokenPrefix = 'seam_'
+
+const clientSessionTokenPrefix = 'seam_cst'
+
+const isClientSessionToken = (token: string): boolean =>
+  token.startsWith(clientSessionTokenPrefix)
+
+const isAccessToken = (token: string): boolean => token.startsWith('seam_at')
+
+const isJwt = (token: string): boolean => token.startsWith('ey')
+
+const isSeamToken = (token: string): boolean => token.startsWith(tokenPrefix)

package/src/lib/seam/connect/axios.ts

@@ -0,0 +1,23 @@
+import axios, { type Axios } from 'axios'
+
+import { getAuthHeaders } from './auth.js'
+import {
+  isSeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptions,
+} from './client-options.js'
+
+export const createAxiosClient = (
+  options: Required<SeamHttpOptions>,
+): Axios => {
+  // TODO: axiosRetry? Allow options to configure this if so
+  return axios.create({
+    baseURL: options.endpoint,
+    withCredentials: isSeamHttpOptionsWithClientSessionToken(options),
+    ...options.axiosOptions,
+    headers: {
+      ...getAuthHeaders(options),
+      ...options.axiosOptions.headers,
+      // TODO: User-Agent
+    },
+  })
+}

package/src/lib/seam/connect/client-options.ts

@@ -0,0 +1,62 @@
+import type { AxiosRequestConfig } from 'axios'
+
+export type SeamHttpOptions =
+  | SeamHttpOptionsWithApiKey
+  | SeamHttpOptionsWithClientSessionToken
+
+interface SeamHttpCommonOptions {
+  endpoint?: string
+  axiosOptions?: AxiosRequestConfig
+  enableLegacyMethodBehaivor?: boolean
+}
+
+export interface SeamHttpOptionsWithApiKey extends SeamHttpCommonOptions {
+  apiKey: string
+}
+
+export const isSeamHttpOptionsWithApiKey = (
+  options: SeamHttpOptions,
+): options is SeamHttpOptionsWithApiKey => {
+  if (!('apiKey' in options)) return false
+
+  if ('clientSessionToken' in options && options.clientSessionToken != null) {
+    throw new InvalidSeamHttpOptionsError(
+      'The clientSessionToken option cannot be used with the apiKey option.',
+    )
+  }
+
+  return true
+}
+
+export interface SeamHttpOptionsWithClientSessionToken
+  extends SeamHttpCommonOptions {
+  clientSessionToken: string
+}
+
+export const isSeamHttpOptionsWithClientSessionToken = (
+  options: SeamHttpOptions,
+): options is SeamHttpOptionsWithClientSessionToken => {
+  if (!('clientSessionToken' in options)) return false
+
+  if ('apiKey' in options && options.apiKey != null) {
+    throw new InvalidSeamHttpOptionsError(
+      'The clientSessionToken option cannot be used with the apiKey option.',
+    )
+  }
+
+  return true
+}
+
+export class InvalidSeamHttpOptionsError extends Error {
+  constructor(message: string) {
+    super(`SeamHttp received invalid options: ${message}`)
+    this.name = this.constructor.name
+    Error.captureStackTrace(this, this.constructor)
+  }
+}
+
+// TODO: withSessionToken { sessionToken } or withMultiWorkspaceApiKey { apiKey }?
+// export interface SeamHttpOptionsWithSessionToken extends SeamHttpCommonOptions {
+//   workspaceId: string
+//   apiKey: string
+// }

package/src/lib/seam/connect/client.ts

@@ -0,0 +1,63 @@
+import type { Axios } from 'axios'
+
+import { createAxiosClient } from './axios.js'
+import {
+  InvalidSeamHttpOptionsError,
+  isSeamHttpOptionsWithApiKey,
+  isSeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptions,
+  type SeamHttpOptionsWithApiKey,
+  type SeamHttpOptionsWithClientSessionToken,
+} from './client-options.js'
+import { LegacyWorkspacesHttp } from './legacy/workspaces.js'
+import { parseOptions } from './parse-options.js'
+import { WorkspacesHttp } from './routes/workspaces.js'
+
+export class SeamHttp {
+  client: Axios
+
+  #legacy: boolean
+
+  constructor(apiKeyOrOptions: string | SeamHttpOptions) {
+    const options = parseOptions(apiKeyOrOptions)
+    this.#legacy = options.enableLegacyMethodBehaivor
+    this.client = createAxiosClient(options)
+  }
+
+  static fromApiKey(
+    apiKey: SeamHttpOptionsWithApiKey['apiKey'],
+    options: Omit<SeamHttpOptionsWithApiKey, 'apiKey'> = {},
+  ): SeamHttp {
+    const opts = { ...options, apiKey }
+    if (!isSeamHttpOptionsWithApiKey(opts)) {
+      throw new InvalidSeamHttpOptionsError('Missing apiKey')
+    }
+    return new SeamHttp(opts)
+  }
+
+  static fromClientSessionToken(
+    clientSessionToken: SeamHttpOptionsWithClientSessionToken['clientSessionToken'],
+    options: Omit<
+      SeamHttpOptionsWithClientSessionToken,
+      'clientSessionToken'
+    > = {},
+  ): SeamHttp {
+    const opts = { ...options, clientSessionToken }
+    if (!isSeamHttpOptionsWithClientSessionToken(opts)) {
+      throw new InvalidSeamHttpOptionsError('Missing clientSessionToken')
+    }
+    return new SeamHttp(opts)
+  }
+
+  // TODO
+  // static fromPublishableKey and deprecate getClientSessionToken
+
+  // TODO: Should we keep makeRequest?
+  // Better to implement error handling and wrapping in an error handler.
+  // makeRequest
+
+  get workspaces(): WorkspacesHttp {
+    if (this.#legacy) return new LegacyWorkspacesHttp(this.client)
+    return new WorkspacesHttp(this.client)
+  }
+}

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

@@ -0,0 +1 @@
+export * from './client.js'

package/src/lib/seam/connect/legacy/workspaces.ts

@@ -0,0 +1,26 @@
+import type { RouteRequestParams, RouteResponse } from '@seamapi/types/connect'
+import type { SetNonNullable } from 'type-fest'
+
+import { WorkspacesHttp } from 'lib/seam/connect/routes/workspaces.js'
+
+export class LegacyWorkspacesHttp extends WorkspacesHttp {
+  override async get(
+    params: WorkspacesGetParams = {},
+  ): Promise<WorkspacesGetResponse['workspace']> {
+    const { data } = await this.client.get<WorkspacesGetResponse>(
+      '/workspaces/get',
+      {
+        params,
+      },
+    )
+    return data.workspace
+  }
+}
+
+export type WorkspacesGetParams = SetNonNullable<
+  Required<RouteRequestParams<'/workspaces/get'>>
+>
+
+export type WorkspacesGetResponse = SetNonNullable<
+  Required<RouteResponse<'/workspaces/get'>>
+>

package/src/lib/seam/connect/parse-options.ts

@@ -0,0 +1,28 @@
+import type { SeamHttpOptions } from './client-options.js'
+export const parseOptions = (
+  apiKeyOrOptions: string | SeamHttpOptions,
+): Required<SeamHttpOptions> => {
+  const options =
+    typeof apiKeyOrOptions === 'string'
+      ? { apiKey: apiKeyOrOptions }
+      : apiKeyOrOptions
+
+  const endpoint =
+    options.endpoint ??
+    globalThis.process?.env?.['SEAM_ENDPOINT'] ??
+    globalThis.process?.env?.['SEAM_API_URL'] ??
+    'https://connect.getseam.com'
+
+  const apiKey =
+    'apiKey' in options
+      ? options.apiKey
+      : globalThis.process?.env?.['SEAM_API_KEY']
+
+  return {
+    ...options,
+    ...(apiKey != null ? { apiKey } : {}),
+    endpoint,
+    axiosOptions: options.axiosOptions ?? {},
+    enableLegacyMethodBehaivor: false,
+  }
+}

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

@@ -0,0 +1,41 @@
+import type { RouteRequestParams, RouteResponse } from '@seamapi/types/connect'
+import { Axios } from 'axios'
+import type { SetNonNullable } from 'type-fest'
+
+import { createAxiosClient } from 'lib/seam/connect/axios.js'
+import type { SeamHttpOptions } from 'lib/seam/connect/client-options.js'
+import { parseOptions } from 'lib/seam/connect/parse-options.js'
+
+export class WorkspacesHttp {
+  client: Axios
+
+  constructor(apiKeyOrOptionsOrClient: Axios | string | SeamHttpOptions) {
+    if (apiKeyOrOptionsOrClient instanceof Axios) {
+      this.client = apiKeyOrOptionsOrClient
+      return
+    }
+
+    const options = parseOptions(apiKeyOrOptionsOrClient)
+    this.client = createAxiosClient(options)
+  }
+
+  async get(
+    params: WorkspacesGetParams = {},
+  ): Promise<WorkspacesGetResponse['workspace']> {
+    const { data } = await this.client.get<WorkspacesGetResponse>(
+      '/workspaces/get',
+      {
+        params,
+      },
+    )
+    return data.workspace
+  }
+}
+
+export type WorkspacesGetParams = SetNonNullable<
+  Required<RouteRequestParams<'/workspaces/get'>>
+>
+
+export type WorkspacesGetResponse = SetNonNullable<
+  Required<RouteResponse<'/workspaces/get'>>
+>