@seamapi/http 0.1.0 → 0.2.0

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

@@ -2,34 +2,46 @@
  * Automatically generated by generate-routes.ts.
  * Do not edit this file or add other files to this directory.
  */
-import { createAxiosClient } from '../../../../lib/seam/connect/axios.js';
-import { isSeamHttpOptionsWithApiKey, isSeamHttpOptionsWithClient, isSeamHttpOptionsWithClientSessionToken, SeamHttpInvalidOptionsError, } from '../../../../lib/seam/connect/client-options.js';
+import { warnOnInsecureuserIdentifierKey } from '../../../../lib/seam/connect/auth.js';
+import { createClient } from '../../../../lib/seam/connect/client.js';
+import { isSeamHttpOptionsWithApiKey, isSeamHttpOptionsWithClient, isSeamHttpOptionsWithClientSessionToken, SeamHttpInvalidOptionsError, } from '../../../../lib/seam/connect/options.js';
 import { parseOptions } from '../../../../lib/seam/connect/parse-options.js';
+import { SeamHttpClientSessions } from './client-sessions.js';
 export class SeamHttpWorkspaces {
-    constructor(apiKeyOrOptions) {
-        const options = parseOptions(apiKeyOrOptions);
-        this.client = createAxiosClient(options);
+    constructor(apiKeyOrOptions = {}) {
+        const clientOptions = parseOptions(apiKeyOrOptions);
+        this.client = createClient(clientOptions);
     }
     static fromClient(client, options = {}) {
-        const opts = { ...options, client };
-        if (!isSeamHttpOptionsWithClient(opts)) {
+        const constructorOptions = { ...options, client };
+        if (!isSeamHttpOptionsWithClient(constructorOptions)) {
             throw new SeamHttpInvalidOptionsError('Missing client');
         }
-        return new SeamHttpWorkspaces(opts);
+        return new SeamHttpWorkspaces(constructorOptions);
     }
     static fromApiKey(apiKey, options = {}) {
-        const opts = { ...options, apiKey };
-        if (!isSeamHttpOptionsWithApiKey(opts)) {
+        const constructorOptions = { ...options, apiKey };
+        if (!isSeamHttpOptionsWithApiKey(constructorOptions)) {
             throw new SeamHttpInvalidOptionsError('Missing apiKey');
         }
-        return new SeamHttpWorkspaces(opts);
+        return new SeamHttpWorkspaces(constructorOptions);
     }
     static fromClientSessionToken(clientSessionToken, options = {}) {
-        const opts = { ...options, clientSessionToken };
-        if (!isSeamHttpOptionsWithClientSessionToken(opts)) {
+        const constructorOptions = { ...options, clientSessionToken };
+        if (!isSeamHttpOptionsWithClientSessionToken(constructorOptions)) {
             throw new SeamHttpInvalidOptionsError('Missing clientSessionToken');
         }
-        return new SeamHttpWorkspaces(opts);
+        return new SeamHttpWorkspaces(constructorOptions);
+    }
+    static async fromPublishableKey(publishableKey, userIdentifierKey, options = {}) {
+        warnOnInsecureuserIdentifierKey(userIdentifierKey);
+        const clientOptions = parseOptions({ ...options, publishableKey });
+        const client = createClient(clientOptions);
+        const clientSessions = SeamHttpClientSessions.fromClient(client);
+        const { token } = await clientSessions.getOrCreate({
+            user_identifier_key: userIdentifierKey,
+        });
+        return SeamHttpWorkspaces.fromClientSessionToken(token, options);
     }
     async get(params) {
         const { data } = await this.client.request({

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

@@ -1 +1 @@
-{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../../src/lib/seam/connect/routes/workspaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,uCAAuC,EACvC,2BAA2B,GAK5B,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAEhE,MAAM,OAAO,kBAAkB;IAG7B,YAAY,eAAyC;QACnD,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,CAAC,CAAA;QAC7C,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,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACrC,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,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACrC,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,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,GAAG,CACP,MAA4B;QAE5B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB;YAChE,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,KAAK;YACb,MAAM;SACP,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAA6B;QAE7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAyB;YACjE,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,KAAK;YACb,MAAM;SACP,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAgC;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAiC;YACxD,GAAG,EAAE,2BAA2B;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;IACJ,CAAC;CACF"}
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../../src/lib/seam/connect/routes/workspaces.ts"],"names":[],"mappings":"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"}

package/lib/seam/connect/seam-http.d.ts

@@ -0,0 +1,24 @@
+import { type Client } from './client.js';
+import { type SeamHttpFromPublishableKeyOptions, type SeamHttpOptions, type SeamHttpOptionsWithApiKey, type SeamHttpOptionsWithClient, type SeamHttpOptionsWithClientSessionToken } from './options.js';
+import { SeamHttpAccessCodes, SeamHttpAcs, SeamHttpActionAttempts, SeamHttpClientSessions, SeamHttpConnectedAccounts, SeamHttpConnectWebviews, SeamHttpDevices, SeamHttpEvents, SeamHttpLocks, SeamHttpNoiseSensors, SeamHttpThermostats, SeamHttpWebhooks, SeamHttpWorkspaces } from './routes/index.js';
+export declare class SeamHttp {
+    client: Client;
+    constructor(apiKeyOrOptions?: string | SeamHttpOptions);
+    static fromClient(client: SeamHttpOptionsWithClient['client'], options?: Omit<SeamHttpOptionsWithClient, 'client'>): SeamHttp;
+    static fromApiKey(apiKey: SeamHttpOptionsWithApiKey['apiKey'], options?: Omit<SeamHttpOptionsWithApiKey, 'apiKey'>): SeamHttp;
+    static fromClientSessionToken(clientSessionToken: SeamHttpOptionsWithClientSessionToken['clientSessionToken'], options?: Omit<SeamHttpOptionsWithClientSessionToken, 'clientSessionToken'>): SeamHttp;
+    static fromPublishableKey(publishableKey: string, userIdentifierKey: string, options?: SeamHttpFromPublishableKeyOptions): Promise<SeamHttp>;
+    get accessCodes(): SeamHttpAccessCodes;
+    get acs(): SeamHttpAcs;
+    get actionAttempts(): SeamHttpActionAttempts;
+    get clientSessions(): SeamHttpClientSessions;
+    get connectedAccounts(): SeamHttpConnectedAccounts;
+    get connectWebviews(): SeamHttpConnectWebviews;
+    get devices(): SeamHttpDevices;
+    get events(): SeamHttpEvents;
+    get locks(): SeamHttpLocks;
+    get noiseSensors(): SeamHttpNoiseSensors;
+    get thermostats(): SeamHttpThermostats;
+    get webhooks(): SeamHttpWebhooks;
+    get workspaces(): SeamHttpWorkspaces;
+}

package/lib/seam/connect/seam-http.js

@@ -0,0 +1,82 @@
+import { warnOnInsecureuserIdentifierKey } from './auth.js';
+import { createClient } from './client.js';
+import { isSeamHttpOptionsWithApiKey, isSeamHttpOptionsWithClient, isSeamHttpOptionsWithClientSessionToken, SeamHttpInvalidOptionsError, } from './options.js';
+import { parseOptions } from './parse-options.js';
+import { SeamHttpAccessCodes, SeamHttpAcs, SeamHttpActionAttempts, SeamHttpClientSessions, SeamHttpConnectedAccounts, SeamHttpConnectWebviews, SeamHttpDevices, SeamHttpEvents, SeamHttpLocks, SeamHttpNoiseSensors, SeamHttpThermostats, SeamHttpWebhooks, SeamHttpWorkspaces, } from './routes/index.js';
+export class SeamHttp {
+    constructor(apiKeyOrOptions = {}) {
+        const clientOptions = parseOptions(apiKeyOrOptions);
+        this.client = createClient(clientOptions);
+    }
+    static fromClient(client, options = {}) {
+        const constructorOptions = { ...options, client };
+        if (!isSeamHttpOptionsWithClient(constructorOptions)) {
+            throw new SeamHttpInvalidOptionsError('Missing client');
+        }
+        return new SeamHttp(constructorOptions);
+    }
+    static fromApiKey(apiKey, options = {}) {
+        const constructorOptions = { ...options, apiKey };
+        if (!isSeamHttpOptionsWithApiKey(constructorOptions)) {
+            throw new SeamHttpInvalidOptionsError('Missing apiKey');
+        }
+        return new SeamHttp(constructorOptions);
+    }
+    static fromClientSessionToken(clientSessionToken, options = {}) {
+        const constructorOptions = { ...options, clientSessionToken };
+        if (!isSeamHttpOptionsWithClientSessionToken(constructorOptions)) {
+            throw new SeamHttpInvalidOptionsError('Missing clientSessionToken');
+        }
+        return new SeamHttp(constructorOptions);
+    }
+    static async fromPublishableKey(publishableKey, userIdentifierKey, options = {}) {
+        warnOnInsecureuserIdentifierKey(userIdentifierKey);
+        const clientOptions = parseOptions({ ...options, publishableKey });
+        const client = createClient(clientOptions);
+        const clientSessions = SeamHttpClientSessions.fromClient(client);
+        const { token } = await clientSessions.getOrCreate({
+            user_identifier_key: userIdentifierKey,
+        });
+        return SeamHttp.fromClientSessionToken(token, options);
+    }
+    get accessCodes() {
+        return SeamHttpAccessCodes.fromClient(this.client);
+    }
+    get acs() {
+        return SeamHttpAcs.fromClient(this.client);
+    }
+    get actionAttempts() {
+        return SeamHttpActionAttempts.fromClient(this.client);
+    }
+    get clientSessions() {
+        return SeamHttpClientSessions.fromClient(this.client);
+    }
+    get connectedAccounts() {
+        return SeamHttpConnectedAccounts.fromClient(this.client);
+    }
+    get connectWebviews() {
+        return SeamHttpConnectWebviews.fromClient(this.client);
+    }
+    get devices() {
+        return SeamHttpDevices.fromClient(this.client);
+    }
+    get events() {
+        return SeamHttpEvents.fromClient(this.client);
+    }
+    get locks() {
+        return SeamHttpLocks.fromClient(this.client);
+    }
+    get noiseSensors() {
+        return SeamHttpNoiseSensors.fromClient(this.client);
+    }
+    get thermostats() {
+        return SeamHttpThermostats.fromClient(this.client);
+    }
+    get webhooks() {
+        return SeamHttpWebhooks.fromClient(this.client);
+    }
+    get workspaces() {
+        return SeamHttpWorkspaces.fromClient(this.client);
+    }
+}
+//# sourceMappingURL=seam-http.js.map

package/lib/seam/connect/seam-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seam-http.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/seam-http.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/http",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "JavaScript HTTP client for the Seam API written in TypeScript.",
   "type": "module",
   "main": "index.js",
@@ -84,15 +84,17 @@
     }
   },
   "dependencies": {
-    "axios": "^1.5.0"
+    "axios": "^1.5.0",
+    "axios-retry": "^3.8.0"
   },
   "devDependencies": {
-    "@seamapi/types": "^1.14.0",
+    "@seamapi/fake-seam-connect": "^1.21.0",
+    "@seamapi/types": "^1.24.0",
     "@types/eslint": "^8.44.2",
     "@types/node": "^18.11.18",
     "ava": "^5.0.1",
     "c8": "^8.0.0",
-    "change-case": "^4.1.2",
+    "change-case": "^5.0.2",
     "concurrently": "^8.2.1",
     "del-cli": "^5.0.0",
     "eslint": "^8.9.0",
@@ -102,6 +104,7 @@
     "eslint-plugin-simple-import-sort": "^10.0.0",
     "eslint-plugin-unused-imports": "^3.0.0",
     "landlubber": "^1.0.0",
+    "node-fetch": "^3.3.2",
     "prettier": "^3.0.0",
     "tsc-alias": "^1.8.2",
     "tsup": "^7.2.0",

package/src/lib/params-serializer.ts

@@ -0,0 +1,55 @@
+import type { CustomParamsSerializer } from 'axios'
+
+export const paramsSerializer: CustomParamsSerializer = (params) => {
+  const searchParams = new URLSearchParams()
+
+  for (const [name, value] of Object.entries(params)) {
+    if (value == null) continue
+
+    if (Array.isArray(value)) {
+      if (value.length === 0) searchParams.set(name, '')
+      if (value.length === 1 && value[0] === '') {
+        throw new UnserializableParamError(
+          name,
+          `is a single element array containing the empty string which is unsupported because it serializes to the empty array`,
+        )
+      }
+      for (const v of value) {
+        throwIfUnserializable(name, v)
+        searchParams.append(name, v)
+      }
+      continue
+    }
+
+    throwIfUnserializable(name, value)
+    searchParams.set(name, value)
+  }
+
+  searchParams.sort()
+  return searchParams.toString()
+}
+
+const throwIfUnserializable = (k: string, v: unknown): void => {
+  if (v == null) {
+    throw new UnserializableParamError(k, `is ${v} or contains ${v}`)
+  }
+
+  if (typeof v === 'function') {
+    throw new UnserializableParamError(
+      k,
+      'is a function or contains a function',
+    )
+  }
+
+  if (typeof v === 'object') {
+    throw new UnserializableParamError(k, 'is an object or contains an object')
+  }
+}
+
+export class UnserializableParamError extends Error {
+  constructor(name: string, message: string) {
+    super(`Could not serialize parameter: '${name}' ${message}`)
+    this.name = this.constructor.name
+    Error.captureStackTrace(this, this.constructor)
+  }
+}

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

@@ -2,14 +2,18 @@ import {
   isSeamHttpOptionsWithApiKey,
   isSeamHttpOptionsWithClientSessionToken,
   SeamHttpInvalidOptionsError,
-  type SeamHttpOptions,
   type SeamHttpOptionsWithApiKey,
   type SeamHttpOptionsWithClientSessionToken,
-} from './client-options.js'
+} from './options.js'
+import type { Options } from './parse-options.js'
 
 type Headers = Record<string, string>
 
-export const getAuthHeaders = (options: SeamHttpOptions): Headers => {
+export const getAuthHeaders = (options: Options): Headers => {
+  if ('publishableKey' in options) {
+    return getAuthHeadersForPublishableKey(options.publishableKey)
+  }
+
   if (isSeamHttpOptionsWithApiKey(options)) {
     return getAuthHeadersForApiKey(options)
   }
@@ -19,7 +23,7 @@ export const getAuthHeaders = (options: SeamHttpOptions): Headers => {
   }
 
   throw new SeamHttpInvalidOptionsError(
-    'Must specify an apiKey or clientSessionToken',
+    'Must specify an apiKey, clientSessionToken, or publishableKey',
   )
 }
 
@@ -32,13 +36,23 @@ const getAuthHeadersForApiKey = ({
     )
   }
 
+  if (isJwt(apiKey)) {
+    throw new SeamHttpInvalidTokenError('A JWT cannot be used as an apiKey')
+  }
+
   if (isAccessToken(apiKey)) {
     throw new SeamHttpInvalidTokenError(
-      'An access token cannot be used as an apiKey',
+      'An Access Token cannot be used as an apiKey',
+    )
+  }
+
+  if (isPublishableKey(apiKey)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Publishable Key cannot be used as an apiKey',
     )
   }
 
-  if (isJwt(apiKey) || !isSeamToken(apiKey)) {
+  if (!isSeamToken(apiKey)) {
     throw new SeamHttpInvalidTokenError(
       `Unknown or invalid apiKey format, expected token to start with ${tokenPrefix}`,
     )
@@ -52,6 +66,24 @@ const getAuthHeadersForApiKey = ({
 const getAuthHeadersForClientSessionToken = ({
   clientSessionToken,
 }: SeamHttpOptionsWithClientSessionToken): Headers => {
+  if (isJwt(clientSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A JWT cannot be used as a clientSessionToken',
+    )
+  }
+
+  if (isAccessToken(clientSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'An Access Token cannot be used as a clientSessionToken',
+    )
+  }
+
+  if (isPublishableKey(clientSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Publishable Key cannot be used as a clientSessionToken',
+    )
+  }
+
   if (!isClientSessionToken(clientSessionToken)) {
     throw new SeamHttpInvalidTokenError(
       `Unknown or invalid clientSessionToken format, expected token to start with ${clientSessionTokenPrefix}`,
@@ -64,6 +96,36 @@ const getAuthHeadersForClientSessionToken = ({
   }
 }
 
+const getAuthHeadersForPublishableKey = (publishableKey: string): Headers => {
+  if (isJwt(publishableKey)) {
+    throw new SeamHttpInvalidTokenError(
+      'A JWT cannot be used as a publishableKey',
+    )
+  }
+
+  if (isAccessToken(publishableKey)) {
+    throw new SeamHttpInvalidTokenError(
+      'An Access Token cannot be used as a publishableKey',
+    )
+  }
+
+  if (isClientSessionToken(publishableKey)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Client Session Token Key cannot be used as a publishableKey',
+    )
+  }
+
+  if (!isPublishableKey(publishableKey)) {
+    throw new SeamHttpInvalidTokenError(
+      `Unknown or invalid publishableKey format, expected token to start with ${publishableKeyTokenPrefix}`,
+    )
+  }
+
+  return {
+    'seam-publishable-key': publishableKey,
+  }
+}
+
 export class SeamHttpInvalidTokenError extends Error {
   constructor(message: string) {
     super(`SeamHttp received an invalid token: ${message}`)
@@ -72,10 +134,29 @@ export class SeamHttpInvalidTokenError extends Error {
   }
 }
 
+export const warnOnInsecureuserIdentifierKey = (
+  userIdentifierKey: string,
+): void => {
+  if (isEmail(userIdentifierKey)) {
+    // eslint-disable-next-line no-console
+    console.warn(
+      ...[
+        'Using an email for the userIdentifierKey is insecure and may return an error in the future!',
+        'This is insecure because an email is common knowledge or easily guessed.',
+        'Use something with sufficient entropy known only to the owner of the client session.',
+        'For help choosing a user identifier key see',
+        'https://docs.seam.co/latest/seam-components/overview/get-started-with-client-side-components#3-select-a-user-identifier-key',
+      ],
+    )
+  }
+}
+
 const tokenPrefix = 'seam_'
 
 const clientSessionTokenPrefix = 'seam_cst'
 
+const publishableKeyTokenPrefix = 'seam_pk'
+
 const isClientSessionToken = (token: string): boolean =>
   token.startsWith(clientSessionTokenPrefix)
 
@@ -84,3 +165,10 @@ 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)
+
+const isPublishableKey = (token: string): boolean =>
+  token.startsWith(publishableKeyTokenPrefix)
+
+// SOURCE: https://stackoverflow.com/a/46181
+const isEmail = (value: string): boolean =>
+  /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)

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

@@ -1,136 +1,31 @@
-import type { Axios } from 'axios'
+import axios, { type Axios, type AxiosRequestConfig } from 'axios'
+import axiosRetry, { type AxiosRetry, exponentialDelay } from 'axios-retry'
 
-import { createAxiosClient } from './axios.js'
-import {
-  isSeamHttpOptionsWithApiKey,
-  isSeamHttpOptionsWithClient,
-  isSeamHttpOptionsWithClientSessionToken,
-  SeamHttpInvalidOptionsError,
-  type SeamHttpOptions,
-  type SeamHttpOptionsWithApiKey,
-  type SeamHttpOptionsWithClient,
-  type SeamHttpOptionsWithClientSessionToken,
-} from './client-options.js'
-import { parseOptions } from './parse-options.js'
-import {
-  SeamHttpAccessCodes,
-  SeamHttpAcs,
-  SeamHttpActionAttempts,
-  SeamHttpClientSessions,
-  SeamHttpConnectedAccounts,
-  SeamHttpConnectWebviews,
-  SeamHttpDevices,
-  SeamHttpEvents,
-  SeamHttpLocks,
-  SeamHttpNoiseSensors,
-  SeamHttpThermostats,
-  SeamHttpWebhooks,
-  SeamHttpWorkspaces,
-} from './routes/index.js'
+import { paramsSerializer } from 'lib/params-serializer.js'
 
-export class SeamHttp {
-  client: Axios
+export type Client = Axios
 
-  // #legacy: boolean
-
-  constructor(apiKeyOrOptions: string | SeamHttpOptions) {
-    const options = parseOptions(apiKeyOrOptions)
-    // this.#legacy = options.enableLegacyMethodBehaivor
-    this.client = createAxiosClient(options)
-  }
-
-  static fromClient(
-    client: SeamHttpOptionsWithClient['client'],
-    options: Omit<SeamHttpOptionsWithClient, 'client'> = {},
-  ): SeamHttp {
-    const opts = { ...options, client }
-    if (!isSeamHttpOptionsWithClient(opts)) {
-      throw new SeamHttpInvalidOptionsError('Missing client')
-    }
-    return new SeamHttp(opts)
-  }
-
-  static fromApiKey(
-    apiKey: SeamHttpOptionsWithApiKey['apiKey'],
-    options: Omit<SeamHttpOptionsWithApiKey, 'apiKey'> = {},
-  ): SeamHttp {
-    const opts = { ...options, apiKey }
-    if (!isSeamHttpOptionsWithApiKey(opts)) {
-      throw new SeamHttpInvalidOptionsError('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 SeamHttpInvalidOptionsError('Missing clientSessionToken')
-    }
-    return new SeamHttp(opts)
-  }
-
-  get accessCodes(): SeamHttpAccessCodes {
-    return SeamHttpAccessCodes.fromClient(this.client)
-  }
-
-  get acs(): SeamHttpAcs {
-    return SeamHttpAcs.fromClient(this.client)
-  }
-
-  get actionAttempts(): SeamHttpActionAttempts {
-    return SeamHttpActionAttempts.fromClient(this.client)
-  }
-
-  get clientSessions(): SeamHttpClientSessions {
-    return SeamHttpClientSessions.fromClient(this.client)
-  }
-
-  get connectedAccounts(): SeamHttpConnectedAccounts {
-    return SeamHttpConnectedAccounts.fromClient(this.client)
-  }
-
-  get connectWebviews(): SeamHttpConnectWebviews {
-    return SeamHttpConnectWebviews.fromClient(this.client)
-  }
-
-  get devices(): SeamHttpDevices {
-    return SeamHttpDevices.fromClient(this.client)
-  }
-
-  get events(): SeamHttpEvents {
-    return SeamHttpEvents.fromClient(this.client)
-  }
+export interface ClientOptions {
+  axiosOptions?: AxiosRequestConfig
+  axiosRetryOptions?: AxiosRetryConfig
+  client?: Client
+}
 
-  get locks(): SeamHttpLocks {
-    return SeamHttpLocks.fromClient(this.client)
-  }
+type AxiosRetryConfig = Parameters<AxiosRetry>[1]
 
-  get noiseSensors(): SeamHttpNoiseSensors {
-    return SeamHttpNoiseSensors.fromClient(this.client)
-  }
+export const createClient = (options: ClientOptions): Axios => {
+  if (options.client != null) return options.client
 
-  get thermostats(): SeamHttpThermostats {
-    return SeamHttpThermostats.fromClient(this.client)
-  }
+  const client = axios.create({
+    paramsSerializer,
+    ...options.axiosOptions,
+  })
 
-  get webhooks(): SeamHttpWebhooks {
-    return SeamHttpWebhooks.fromClient(this.client)
-  }
+  axiosRetry(client, {
+    retries: 2,
+    retryDelay: exponentialDelay,
+    ...options.axiosRetryOptions,
+  })
 
-  get workspaces(): SeamHttpWorkspaces {
-    return SeamHttpWorkspaces.fromClient(this.client)
-  }
+  return client
 }
-
-// TODO
-// static fromPublishableKey and deprecate getClientSessionToken
-
-// TODO: Should we keep makeRequest?
-// Better to implement error handling and wrapping in an error handler.
-// makeRequest

package/src/lib/seam/connect/env.d.ts

@@ -0,0 +1,11 @@
+declare global {
+  namespace NodeJS {
+    interface ProcessEnv {
+      SEAM_API_KEY?: string
+      SEAM_API_URL?: string
+      SEAM_ENDPOINT?: string
+    }
+  }
+}
+
+export {}

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

@@ -1 +1,2 @@
-export * from './client.js'
+export * from './options.js'
+export * from './seam-http.js'