@seamapi/http 2.1.0 → 2.3.0

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

@@ -0,0 +1,34 @@
+import type { Method } from 'axios';
+import type { Client } from './client.js';
+import type { SeamHttpRequestOptions } from './options.js';
+import { type ActionAttemptsClient } from './resolve-action-attempt.js';
+interface SeamHttpRequestParent {
+    readonly client: Client;
+    readonly defaults: Required<SeamHttpRequestOptions>;
+}
+interface SeamHttpRequestConfig<TResponseKey> {
+    readonly pathname: string;
+    readonly method: Method;
+    readonly body?: unknown;
+    readonly params?: undefined | Record<string, unknown>;
+    readonly responseKey: TResponseKey;
+    readonly options?: Pick<SeamHttpRequestOptions, 'waitForActionAttempt'>;
+    readonly actionAttempts?: ActionAttemptsClient;
+}
+export declare class SeamHttpRequest<const TResponse, const TResponseKey extends keyof TResponse | undefined> implements Promise<TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined> {
+    #private;
+    readonly [Symbol.toStringTag]: string;
+    constructor(parent: SeamHttpRequestParent, config: SeamHttpRequestConfig<TResponseKey>);
+    get responseKey(): TResponseKey;
+    get url(): URL;
+    get pathname(): string;
+    get method(): Method;
+    get params(): undefined | Record<string, unknown>;
+    get body(): unknown;
+    execute(): Promise<TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined>;
+    fetchResponse(): Promise<TResponse>;
+    then<TResult1 = TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined, TResult2 = never>(onfulfilled?: ((value: TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null | undefined): Promise<(TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined) | TResult>;
+    finally(onfinally?: (() => void) | null | undefined): Promise<TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined>;
+}
+export {};

package/lib/seam-http-request.js

@@ -0,0 +1,101 @@
+import { serializeUrlSearchParams } from '@seamapi/url-search-params-serializer';
+import { resolveActionAttempt, } from './resolve-action-attempt.js';
+export class SeamHttpRequest {
+    [Symbol.toStringTag] = 'SeamHttpRequest';
+    #parent;
+    #config;
+    constructor(parent, config) {
+        this.#parent = parent;
+        this.#config = config;
+    }
+    get responseKey() {
+        return this.#config.responseKey;
+    }
+    get url() {
+        const { client } = this.#parent;
+        const serializer = typeof client.defaults.paramsSerializer === 'function'
+            ? client.defaults.paramsSerializer
+            : serializeUrlSearchParams;
+        const origin = getUrlPrefix(client.defaults.baseURL ?? '');
+        const path = this.params == null
+            ? this.pathname
+            : `${this.pathname}?${serializer(this.params)}`;
+        return new URL(`${origin}${path}`);
+    }
+    get pathname() {
+        return this.#config.pathname.startsWith('/')
+            ? this.#config.pathname
+            : `/${this.#config.pathname}`;
+    }
+    get method() {
+        return this.#config.method;
+    }
+    get params() {
+        return this.#config.params;
+    }
+    get body() {
+        return this.#config.body;
+    }
+    async execute() {
+        const response = await this.fetchResponse();
+        if (this.responseKey === undefined) {
+            return undefined;
+        }
+        const data = response[this.responseKey];
+        if (this.responseKey === 'action_attempt') {
+            const waitForActionAttempt = this.#config.options?.waitForActionAttempt ??
+                this.#parent.defaults.waitForActionAttempt;
+            if (waitForActionAttempt !== false) {
+                if (this.#config.actionAttempts == null) {
+                    throw new Error('Cannot wait for an action attempt without an action attempts client');
+                }
+                const actionAttempt = await resolveActionAttempt(data, this.#config.actionAttempts, typeof waitForActionAttempt === 'boolean' ? {} : waitForActionAttempt);
+                return actionAttempt;
+            }
+        }
+        return data;
+    }
+    async fetchResponse() {
+        const { client } = this.#parent;
+        const response = await client.request({
+            url: this.pathname,
+            method: this.method,
+            data: this.body,
+            params: this.params,
+        });
+        return response.data;
+    }
+    async then(onfulfilled, onrejected) {
+        return await this.execute().then(onfulfilled, onrejected);
+    }
+    async catch(onrejected) {
+        return await this.execute().catch(onrejected);
+    }
+    async finally(onfinally) {
+        return await this.execute().finally(onfinally);
+    }
+}
+const getUrlPrefix = (input) => {
+    if (canParseUrl(input)) {
+        const url = new URL(input).toString();
+        if (url.endsWith('/'))
+            return url.slice(0, -1);
+        return url;
+    }
+    if (globalThis.location != null) {
+        const pathname = input.startsWith('/') ? input : `/${input}`;
+        return new URL(`${globalThis.location.origin}${pathname}`).toString();
+    }
+    throw new Error(`Cannot resolve origin from ${input} in a non-browser environment`);
+};
+// UPSTREAM: Prefer URL.canParse when it has wider support.
+// https://caniuse.com/mdn-api_url_canparse_static
+const canParseUrl = (input) => {
+    try {
+        return new URL(input) != null;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=seam-http-request.js.map

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

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

package/lib/seam-paginator.js.map

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

package/lib/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/lib/token.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAA;AAE7B,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAA;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAA;AAElD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAW,EAAE,CACtD,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAA;AAErC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;AAE5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAW,EAAE,CACpD,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AAE/B,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAW,EAAE,CACjD,CAAC,oBAAoB,CAAC,KAAK,CAAC;IAC5B,CAAC,KAAK,CAAC,KAAK,CAAC;IACb,CAAC,aAAa,CAAC,KAAK,CAAC;IACrB,CAAC,gBAAgB,CAAC,KAAK,CAAC;IACxB,WAAW,CAAC,KAAK,CAAC,CAAA;AAEpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAW,EAAE,CAC7D,KAAK,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAA;AAE5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAW,EAAE,CACzD,KAAK,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAA;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAE7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAW,EAAE,CAC9D,aAAa,CAAC,KAAK,CAAC,CAAA"}

package/lib/version.d.ts

@@ -1,2 +1,2 @@
-declare const seamapiJavascriptHttpVersion = "2.1.0";
+declare const seamapiJavascriptHttpVersion = "2.3.0";
 export default seamapiJavascriptHttpVersion;

package/lib/version.js

@@ -1,3 +1,3 @@
-const seamapiJavascriptHttpVersion = '2.1.0';
+const seamapiJavascriptHttpVersion = '2.3.0';
 export default seamapiJavascriptHttpVersion;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/http",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "JavaScript HTTP client for the Seam API written in TypeScript.",
   "type": "module",
   "main": "index.js",
@@ -11,8 +11,8 @@
       "import": "./index.js"
     },
     "./connect": {
-      "types": "./connect.d.ts",
-      "import": "./connect.js"
+      "types": "./index.d.ts",
+      "import": "./index.js"
     }
   },
   "module": "index.js",
@@ -32,9 +32,6 @@
     "index.js",
     "index.js.map",
     "index.d.ts",
-    "connect.js",
-    "connect.js.map",
-    "connect.d.ts",
     "lib",
     "src",
     "!test",
@@ -42,8 +39,8 @@
   ],
   "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'",
+    "prebuild": "tsx src/index.ts",
+    "postbuild": "node ./index.js",
     "build:entrypoints": "npm run build:ts",
     "build:ts": "tsc --project tsconfig.build.json",
     "prebuild:ts": "del 'index.*' 'connect.*' lib",
@@ -69,7 +66,7 @@
   },
   "engines": {
     "node": ">=22.11.0",
-    "npm": ">=10.9.4"
+    "npm": ">=10.0.0"
   },
   "devEngines": {
     "runtime": {
@@ -78,7 +75,7 @@
     },
     "packageManager": {
       "name": "npm",
-      "version": "^11.12.0 || ^10.9.4"
+      "version": "^11.0.0 || ^10.0.0"
     }
   },
   "dependencies": {
@@ -96,9 +93,9 @@
     "ava": "^8.0.1",
     "c8": "^12.0.0",
     "change-case": "^5.0.2",
-    "concurrently": "^10.0.4",
     "del-cli": "^7.0.0",
     "eslint": "^9.31.0",
+    "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.1.4",

package/src/index.ts

@@ -1 +1,2 @@
-export * from './connect.js'
+export * from './lib/index.js'
+export * from '@seamapi/url-search-params-serializer'

package/src/lib/auth.ts

@@ -0,0 +1,280 @@
+import {
+  isSeamHttpOptionsWithApiKey,
+  isSeamHttpOptionsWithClientSessionToken,
+  isSeamHttpOptionsWithConsoleSessionToken,
+  isSeamHttpOptionsWithPersonalAccessToken,
+  isSeamHttpWithoutWorkspaceOptionsWithConsoleSessionToken,
+  isSeamHttpWithoutWorkspaceOptionsWithPersonalAccessToken,
+  SeamHttpInvalidOptionsError,
+  type SeamHttpOptions,
+  type SeamHttpOptionsWithApiKey,
+  type SeamHttpOptionsWithClientSessionToken,
+  type SeamHttpOptionsWithConsoleSessionToken,
+  type SeamHttpOptionsWithPersonalAccessToken,
+  type SeamHttpWithoutWorkspaceOptions,
+  type SeamHttpWithoutWorkspaceOptionsWithConsoleSessionToken,
+  type SeamHttpWithoutWorkspaceOptionsWithPersonalAccessToken,
+} from './options.js'
+import {
+  accessTokenPrefix,
+  clientSessionTokenPrefix,
+  isAccessToken,
+  isClientSessionToken,
+  isJwt,
+  isPublishableKey,
+  isSeamToken,
+  jwtPrefix,
+  publishableKeyTokenPrefix,
+  tokenPrefix,
+} from './token.js'
+
+type Headers = Record<string, string>
+type Options =
+  | SeamHttpWithoutWorkspaceOptions
+  | (SeamHttpOptions & { publishableKey?: string })
+
+export const getAuthHeaders = (options: Options): Headers => {
+  if ('publishableKey' in options && options.publishableKey != null) {
+    return getAuthHeadersForPublishableKey(options.publishableKey)
+  }
+
+  if (isSeamHttpOptionsWithApiKey(options)) {
+    return getAuthHeadersForApiKey(options)
+  }
+
+  if (isSeamHttpOptionsWithClientSessionToken(options)) {
+    return getAuthHeadersForClientSessionToken(options)
+  }
+
+  if (
+    isSeamHttpWithoutWorkspaceOptionsWithConsoleSessionToken(options) ||
+    isSeamHttpOptionsWithConsoleSessionToken(options)
+  ) {
+    return getAuthHeadersForConsoleSessionToken(options)
+  }
+
+  if (
+    isSeamHttpWithoutWorkspaceOptionsWithPersonalAccessToken(options) ||
+    isSeamHttpOptionsWithPersonalAccessToken(options)
+  ) {
+    return getAuthHeadersForPersonalAccessToken(options)
+  }
+
+  throw new SeamHttpInvalidOptionsError(
+    [
+      'Must specify',
+      'an apiKey,',
+      'clientSessionToken,',
+      'publishableKey,',
+      'consoleSessionToken',
+      'or personalAccessToken.',
+      'Attempted reading configuration from the environment, but the environment variable SEAM_API_KEY is not set.',
+    ].join(' '),
+  )
+}
+
+const getAuthHeadersForApiKey = ({
+  apiKey,
+}: SeamHttpOptionsWithApiKey): Headers => {
+  if (isClientSessionToken(apiKey)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Client Session Token cannot be used as an apiKey',
+    )
+  }
+
+  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',
+    )
+  }
+
+  if (isPublishableKey(apiKey)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Publishable Key cannot be used as an apiKey',
+    )
+  }
+
+  if (!isSeamToken(apiKey)) {
+    throw new SeamHttpInvalidTokenError(
+      `Unknown or invalid apiKey format, expected token to start with ${tokenPrefix}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${apiKey}`,
+  }
+}
+
+export 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}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${clientSessionToken}`,
+    'client-session-token': clientSessionToken,
+  }
+}
+
+const getAuthHeadersForConsoleSessionToken = ({
+  consoleSessionToken,
+  ...options
+}:
+  | SeamHttpWithoutWorkspaceOptionsWithConsoleSessionToken
+  | SeamHttpOptionsWithConsoleSessionToken): Headers => {
+  const workspaceId = 'workspaceId' in options ? options.workspaceId : undefined
+
+  if (isAccessToken(consoleSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'An Access Token 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 consoleSessionToken',
+    )
+  }
+
+  if (!isJwt(consoleSessionToken)) {
+    throw new SeamHttpInvalidTokenError(
+      `Unknown or invalid consoleSessionToken format, expected a JWT which starts with ${jwtPrefix}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${consoleSessionToken}`,
+    ...(workspaceId != null ? { 'seam-workspace': workspaceId } : {}),
+  }
+}
+
+const getAuthHeadersForPersonalAccessToken = ({
+  personalAccessToken,
+  ...options
+}:
+  | SeamHttpWithoutWorkspaceOptionsWithPersonalAccessToken
+  | SeamHttpOptionsWithPersonalAccessToken): Headers => {
+  const workspaceId = 'workspaceId' in options ? options.workspaceId : undefined
+
+  if (isJwt(personalAccessToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A JWT cannot be used as a personalAccessToken',
+    )
+  }
+
+  if (isClientSessionToken(personalAccessToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Client Session Token cannot be used as a personalAccessToken',
+    )
+  }
+
+  if (isPublishableKey(personalAccessToken)) {
+    throw new SeamHttpInvalidTokenError(
+      'A Publishable Key cannot be used as a personalAccessToken',
+    )
+  }
+
+  if (!isAccessToken(personalAccessToken)) {
+    throw new SeamHttpInvalidTokenError(
+      `Unknown or invalid personalAccessToken format, expected token to start with ${accessTokenPrefix}`,
+    )
+  }
+
+  return {
+    authorization: `Bearer ${personalAccessToken}`,
+    ...(workspaceId != null ? { 'seam-workspace': workspaceId } : {}),
+  }
+}
+
+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}`)
+    this.name = this.constructor.name
+  }
+}
+
+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',
+      ],
+    )
+  }
+}
+
+// SOURCE: https://stackoverflow.com/a/46181
+const isEmail = (value: string): boolean => {
+  if (value.includes('!')) return false
+  // The regex may run slow on strings starting with '!@!.' and with many repetitions of '!.'.
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)
+}

package/src/lib/client.ts

@@ -0,0 +1,36 @@
+import { serializeUrlSearchParams } from '@seamapi/url-search-params-serializer'
+import axios, { type AxiosInstance, type AxiosRequestConfig } from 'axios'
+import axiosRetry, { type AxiosRetry, exponentialDelay } from 'axios-retry'
+
+import { errorInterceptor } from './error-interceptor.js'
+
+export type Client = AxiosInstance
+
+export const defaultTimeout = 30_000
+
+export interface ClientOptions {
+  timeout?: number
+  axiosOptions?: AxiosRequestConfig
+  axiosRetryOptions?: AxiosRetryConfig
+}
+
+type AxiosRetryConfig = Parameters<AxiosRetry>[1]
+
+export const createClient = (options: ClientOptions): AxiosInstance => {
+  const client = axios.create({
+    paramsSerializer: serializeUrlSearchParams,
+    adapter: 'fetch',
+    timeout: options.timeout ?? defaultTimeout,
+    ...options.axiosOptions,
+  })
+
+  axiosRetry(client, {
+    retries: 2,
+    retryDelay: exponentialDelay,
+    ...options.axiosRetryOptions,
+  })
+
+  client.interceptors.response.use(undefined, errorInterceptor)
+
+  return client
+}