@seamapi/http 0.3.0 → 0.4.0

package/dist/connect.d.cts

@@ -3,6 +3,8 @@ import { AxiosRetry } from 'axios-retry';
 import { RouteRequestBody, RouteResponse, RouteRequestParams } from '@seamapi/types/connect';
 import { SetNonNullable } from 'type-fest';
 
+declare const errorInterceptor: (err: unknown) => Promise<void>;
+
 type Client = AxiosInstance;
 interface ClientOptions {
     axiosOptions?: AxiosRequestConfig;
@@ -527,9 +529,35 @@ declare class SeamHttp {
     get workspaces(): SeamHttpWorkspaces;
 }
 
+interface ApiError {
+    type: string;
+    message: string;
+    data?: unknown;
+}
+
+declare class SeamHttpApiError extends Error {
+    code: string;
+    statusCode: number;
+    requestId: string;
+    data?: unknown;
+    constructor(error: ApiError, statusCode: number, requestId: string);
+}
+declare const isSeamHttpApiError: (error: unknown) => error is SeamHttpApiError;
+declare class SeamHttpUnauthorizedError extends SeamHttpApiError {
+    code: 'unauthorized';
+    statusCode: 401;
+    constructor(requestId: string);
+}
+declare const isSeamHttpUnauthorizedError: (error: unknown) => error is SeamHttpUnauthorizedError;
+declare class SeamHttpInvalidInputError extends SeamHttpApiError {
+    code: 'invalid_input';
+    constructor(error: ApiError, statusCode: number, requestId: string);
+}
+declare const isSeamHttpInvalidInputError: (error: unknown) => error is SeamHttpInvalidInputError;
+
 declare const paramsSerializer: CustomParamsSerializer;
 declare class UnserializableParamError extends Error {
     constructor(name: string, message: string);
 }
 
-export { AccessCodesCreateBody, AccessCodesCreateMultipleBody, AccessCodesCreateMultipleResponse, AccessCodesCreateResponse, AccessCodesDeleteBody, AccessCodesDeleteResponse, AccessCodesGenerateCodeBody, AccessCodesGenerateCodeResponse, AccessCodesGetParams, AccessCodesGetResponse, AccessCodesListParams, AccessCodesListResponse, AccessCodesPullBackupAccessCodeBody, AccessCodesPullBackupAccessCodeResponse, AccessCodesUnmanagedConvertToManagedBody, AccessCodesUnmanagedConvertToManagedResponse, AccessCodesUnmanagedDeleteBody, AccessCodesUnmanagedDeleteResponse, AccessCodesUnmanagedGetParams, AccessCodesUnmanagedGetResponse, AccessCodesUnmanagedListParams, AccessCodesUnmanagedListResponse, AccessCodesUnmanagedUpdateBody, AccessCodesUnmanagedUpdateResponse, AccessCodesUpdateBody, AccessCodesUpdateResponse, AcsAccessGroupsAddUserBody, AcsAccessGroupsAddUserResponse, AcsAccessGroupsCreateBody, AcsAccessGroupsCreateResponse, AcsAccessGroupsDeleteBody, AcsAccessGroupsDeleteResponse, AcsAccessGroupsGetParams, AcsAccessGroupsGetResponse, AcsAccessGroupsListParams, AcsAccessGroupsListResponse, AcsAccessGroupsListUsersParams, AcsAccessGroupsListUsersResponse, AcsAccessGroupsRemoveUserBody, AcsAccessGroupsRemoveUserResponse, AcsAccessGroupsUpdateBody, AcsAccessGroupsUpdateResponse, AcsCredentialsCreateBody, AcsCredentialsCreateResponse, AcsCredentialsDeleteBody, AcsCredentialsDeleteResponse, AcsCredentialsGetParams, AcsCredentialsGetResponse, AcsCredentialsListParams, AcsCredentialsListResponse, AcsSystemsGetParams, AcsSystemsGetResponse, AcsSystemsListParams, AcsSystemsListResponse, AcsUsersAddToAccessGroupBody, AcsUsersAddToAccessGroupResponse, AcsUsersCreateBody, AcsUsersCreateResponse, AcsUsersDeleteBody, AcsUsersDeleteResponse, AcsUsersGetParams, AcsUsersGetResponse, AcsUsersListParams, AcsUsersListResponse, AcsUsersRemoveFromAccessGroupBody, AcsUsersRemoveFromAccessGroupResponse, AcsUsersSuspendBody, AcsUsersSuspendResponse, AcsUsersUnsuspendBody, AcsUsersUnsuspendResponse, AcsUsersUpdateBody, AcsUsersUpdateResponse, ActionAttemptsGetParams, ActionAttemptsGetResponse, ActionAttemptsListParams, ActionAttemptsListResponse, ClientSessionsCreateBody, ClientSessionsCreateResponse, ClientSessionsDeleteBody, ClientSessionsDeleteResponse, ClientSessionsGetOrCreateBody, ClientSessionsGetOrCreateResponse, ClientSessionsGetParams, ClientSessionsGetResponse, ClientSessionsGrantAccessBody, ClientSessionsGrantAccessResponse, ClientSessionsListParams, ClientSessionsListResponse, ConnectWebviewsCreateBody, ConnectWebviewsCreateResponse, ConnectWebviewsDeleteBody, ConnectWebviewsDeleteResponse, ConnectWebviewsGetParams, ConnectWebviewsGetResponse, ConnectWebviewsListParams, ConnectWebviewsListResponse, ConnectWebviewsViewParams, ConnectWebviewsViewResponse, ConnectedAccountsDeleteBody, ConnectedAccountsDeleteResponse, ConnectedAccountsGetParams, ConnectedAccountsGetResponse, ConnectedAccountsListParams, ConnectedAccountsListResponse, DevicesDeleteBody, DevicesDeleteResponse, DevicesGetParams, DevicesGetResponse, DevicesListDeviceProvidersParams, DevicesListDeviceProvidersResponse, DevicesListParams, DevicesListResponse, DevicesUnmanagedGetParams, DevicesUnmanagedGetResponse, DevicesUnmanagedListParams, DevicesUnmanagedListResponse, DevicesUnmanagedUpdateBody, DevicesUnmanagedUpdateResponse, DevicesUpdateBody, DevicesUpdateResponse, EventsGetParams, EventsGetResponse, EventsListParams, EventsListResponse, LocksGetParams, LocksGetResponse, LocksListParams, LocksListResponse, LocksLockDoorBody, LocksLockDoorResponse, LocksUnlockDoorBody, LocksUnlockDoorResponse, NoiseSensorsNoiseThresholdsCreateBody, NoiseSensorsNoiseThresholdsCreateResponse, NoiseSensorsNoiseThresholdsDeleteBody, NoiseSensorsNoiseThresholdsDeleteResponse, NoiseSensorsNoiseThresholdsGetParams, NoiseSensorsNoiseThresholdsGetResponse, NoiseSensorsNoiseThresholdsListParams, NoiseSensorsNoiseThresholdsListResponse, NoiseSensorsNoiseThresholdsUpdateBody, NoiseSensorsNoiseThresholdsUpdateResponse, SeamHttp, SeamHttpAccessCodes, SeamHttpAccessCodesUnmanaged, SeamHttpAcs, SeamHttpAcsAccessGroups, SeamHttpAcsCredentials, SeamHttpAcsSystems, SeamHttpAcsUsers, SeamHttpActionAttempts, SeamHttpClientSessions, SeamHttpConnectWebviews, SeamHttpConnectedAccounts, SeamHttpDevices, SeamHttpDevicesUnmanaged, SeamHttpEvents, SeamHttpFromPublishableKeyOptions, SeamHttpInvalidOptionsError, SeamHttpLocks, SeamHttpNoiseSensors, SeamHttpNoiseSensorsNoiseThresholds, SeamHttpOptions, SeamHttpOptionsFromEnv, SeamHttpOptionsWithApiKey, SeamHttpOptionsWithClient, SeamHttpOptionsWithClientSessionToken, SeamHttpThermostats, SeamHttpThermostatsClimateSettingSchedules, SeamHttpWebhooks, SeamHttpWorkspaces, ThermostatsClimateSettingSchedulesCreateBody, ThermostatsClimateSettingSchedulesCreateResponse, ThermostatsClimateSettingSchedulesDeleteBody, ThermostatsClimateSettingSchedulesDeleteResponse, ThermostatsClimateSettingSchedulesGetParams, ThermostatsClimateSettingSchedulesGetResponse, ThermostatsClimateSettingSchedulesListParams, ThermostatsClimateSettingSchedulesListResponse, ThermostatsClimateSettingSchedulesUpdateBody, ThermostatsClimateSettingSchedulesUpdateResponse, ThermostatsCoolBody, ThermostatsCoolResponse, ThermostatsGetParams, ThermostatsGetResponse, ThermostatsHeatBody, ThermostatsHeatCoolBody, ThermostatsHeatCoolResponse, ThermostatsHeatResponse, ThermostatsListParams, ThermostatsListResponse, ThermostatsOffBody, ThermostatsOffResponse, ThermostatsSetFanModeBody, ThermostatsSetFanModeResponse, ThermostatsUpdateBody, ThermostatsUpdateResponse, UnserializableParamError, WebhooksCreateBody, WebhooksCreateResponse, WebhooksDeleteBody, WebhooksDeleteResponse, WebhooksGetParams, WebhooksGetResponse, WebhooksListParams, WebhooksListResponse, WorkspacesGetParams, WorkspacesGetResponse, WorkspacesListParams, WorkspacesListResponse, WorkspacesResetSandboxBody, WorkspacesResetSandboxResponse, isSeamHttpOptionsWithApiKey, isSeamHttpOptionsWithClient, isSeamHttpOptionsWithClientSessionToken, paramsSerializer };
+export { AccessCodesCreateBody, AccessCodesCreateMultipleBody, AccessCodesCreateMultipleResponse, AccessCodesCreateResponse, AccessCodesDeleteBody, AccessCodesDeleteResponse, AccessCodesGenerateCodeBody, AccessCodesGenerateCodeResponse, AccessCodesGetParams, AccessCodesGetResponse, AccessCodesListParams, AccessCodesListResponse, AccessCodesPullBackupAccessCodeBody, AccessCodesPullBackupAccessCodeResponse, AccessCodesUnmanagedConvertToManagedBody, AccessCodesUnmanagedConvertToManagedResponse, AccessCodesUnmanagedDeleteBody, AccessCodesUnmanagedDeleteResponse, AccessCodesUnmanagedGetParams, AccessCodesUnmanagedGetResponse, AccessCodesUnmanagedListParams, AccessCodesUnmanagedListResponse, AccessCodesUnmanagedUpdateBody, AccessCodesUnmanagedUpdateResponse, AccessCodesUpdateBody, AccessCodesUpdateResponse, AcsAccessGroupsAddUserBody, AcsAccessGroupsAddUserResponse, AcsAccessGroupsCreateBody, AcsAccessGroupsCreateResponse, AcsAccessGroupsDeleteBody, AcsAccessGroupsDeleteResponse, AcsAccessGroupsGetParams, AcsAccessGroupsGetResponse, AcsAccessGroupsListParams, AcsAccessGroupsListResponse, AcsAccessGroupsListUsersParams, AcsAccessGroupsListUsersResponse, AcsAccessGroupsRemoveUserBody, AcsAccessGroupsRemoveUserResponse, AcsAccessGroupsUpdateBody, AcsAccessGroupsUpdateResponse, AcsCredentialsCreateBody, AcsCredentialsCreateResponse, AcsCredentialsDeleteBody, AcsCredentialsDeleteResponse, AcsCredentialsGetParams, AcsCredentialsGetResponse, AcsCredentialsListParams, AcsCredentialsListResponse, AcsSystemsGetParams, AcsSystemsGetResponse, AcsSystemsListParams, AcsSystemsListResponse, AcsUsersAddToAccessGroupBody, AcsUsersAddToAccessGroupResponse, AcsUsersCreateBody, AcsUsersCreateResponse, AcsUsersDeleteBody, AcsUsersDeleteResponse, AcsUsersGetParams, AcsUsersGetResponse, AcsUsersListParams, AcsUsersListResponse, AcsUsersRemoveFromAccessGroupBody, AcsUsersRemoveFromAccessGroupResponse, AcsUsersSuspendBody, AcsUsersSuspendResponse, AcsUsersUnsuspendBody, AcsUsersUnsuspendResponse, AcsUsersUpdateBody, AcsUsersUpdateResponse, ActionAttemptsGetParams, ActionAttemptsGetResponse, ActionAttemptsListParams, ActionAttemptsListResponse, ClientSessionsCreateBody, ClientSessionsCreateResponse, ClientSessionsDeleteBody, ClientSessionsDeleteResponse, ClientSessionsGetOrCreateBody, ClientSessionsGetOrCreateResponse, ClientSessionsGetParams, ClientSessionsGetResponse, ClientSessionsGrantAccessBody, ClientSessionsGrantAccessResponse, ClientSessionsListParams, ClientSessionsListResponse, ConnectWebviewsCreateBody, ConnectWebviewsCreateResponse, ConnectWebviewsDeleteBody, ConnectWebviewsDeleteResponse, ConnectWebviewsGetParams, ConnectWebviewsGetResponse, ConnectWebviewsListParams, ConnectWebviewsListResponse, ConnectWebviewsViewParams, ConnectWebviewsViewResponse, ConnectedAccountsDeleteBody, ConnectedAccountsDeleteResponse, ConnectedAccountsGetParams, ConnectedAccountsGetResponse, ConnectedAccountsListParams, ConnectedAccountsListResponse, DevicesDeleteBody, DevicesDeleteResponse, DevicesGetParams, DevicesGetResponse, DevicesListDeviceProvidersParams, DevicesListDeviceProvidersResponse, DevicesListParams, DevicesListResponse, DevicesUnmanagedGetParams, DevicesUnmanagedGetResponse, DevicesUnmanagedListParams, DevicesUnmanagedListResponse, DevicesUnmanagedUpdateBody, DevicesUnmanagedUpdateResponse, DevicesUpdateBody, DevicesUpdateResponse, EventsGetParams, EventsGetResponse, EventsListParams, EventsListResponse, LocksGetParams, LocksGetResponse, LocksListParams, LocksListResponse, LocksLockDoorBody, LocksLockDoorResponse, LocksUnlockDoorBody, LocksUnlockDoorResponse, NoiseSensorsNoiseThresholdsCreateBody, NoiseSensorsNoiseThresholdsCreateResponse, NoiseSensorsNoiseThresholdsDeleteBody, NoiseSensorsNoiseThresholdsDeleteResponse, NoiseSensorsNoiseThresholdsGetParams, NoiseSensorsNoiseThresholdsGetResponse, NoiseSensorsNoiseThresholdsListParams, NoiseSensorsNoiseThresholdsListResponse, NoiseSensorsNoiseThresholdsUpdateBody, NoiseSensorsNoiseThresholdsUpdateResponse, SeamHttp, SeamHttpAccessCodes, SeamHttpAccessCodesUnmanaged, SeamHttpAcs, SeamHttpAcsAccessGroups, SeamHttpAcsCredentials, SeamHttpAcsSystems, SeamHttpAcsUsers, SeamHttpActionAttempts, SeamHttpApiError, SeamHttpClientSessions, SeamHttpConnectWebviews, SeamHttpConnectedAccounts, SeamHttpDevices, SeamHttpDevicesUnmanaged, SeamHttpEvents, SeamHttpFromPublishableKeyOptions, SeamHttpInvalidInputError, SeamHttpInvalidOptionsError, SeamHttpLocks, SeamHttpNoiseSensors, SeamHttpNoiseSensorsNoiseThresholds, SeamHttpOptions, SeamHttpOptionsFromEnv, SeamHttpOptionsWithApiKey, SeamHttpOptionsWithClient, SeamHttpOptionsWithClientSessionToken, SeamHttpThermostats, SeamHttpThermostatsClimateSettingSchedules, SeamHttpUnauthorizedError, SeamHttpWebhooks, SeamHttpWorkspaces, ThermostatsClimateSettingSchedulesCreateBody, ThermostatsClimateSettingSchedulesCreateResponse, ThermostatsClimateSettingSchedulesDeleteBody, ThermostatsClimateSettingSchedulesDeleteResponse, ThermostatsClimateSettingSchedulesGetParams, ThermostatsClimateSettingSchedulesGetResponse, ThermostatsClimateSettingSchedulesListParams, ThermostatsClimateSettingSchedulesListResponse, ThermostatsClimateSettingSchedulesUpdateBody, ThermostatsClimateSettingSchedulesUpdateResponse, ThermostatsCoolBody, ThermostatsCoolResponse, ThermostatsGetParams, ThermostatsGetResponse, ThermostatsHeatBody, ThermostatsHeatCoolBody, ThermostatsHeatCoolResponse, ThermostatsHeatResponse, ThermostatsListParams, ThermostatsListResponse, ThermostatsOffBody, ThermostatsOffResponse, ThermostatsSetFanModeBody, ThermostatsSetFanModeResponse, ThermostatsUpdateBody, ThermostatsUpdateResponse, UnserializableParamError, WebhooksCreateBody, WebhooksCreateResponse, WebhooksDeleteBody, WebhooksDeleteResponse, WebhooksGetParams, WebhooksGetResponse, WebhooksListParams, WebhooksListResponse, WorkspacesGetParams, WorkspacesGetResponse, WorkspacesListParams, WorkspacesListResponse, WorkspacesResetSandboxBody, WorkspacesResetSandboxResponse, errorInterceptor, isSeamHttpApiError, isSeamHttpInvalidInputError, isSeamHttpOptionsWithApiKey, isSeamHttpOptionsWithClient, isSeamHttpOptionsWithClientSessionToken, isSeamHttpUnauthorizedError, paramsSerializer };

package/lib/seam/connect/api-error-type.d.ts

@@ -0,0 +1,8 @@
+export interface ApiErrorResponse {
+    error: ApiError;
+}
+export interface ApiError {
+    type: string;
+    message: string;
+    data?: unknown;
+}

package/lib/seam/connect/api-error-type.js

@@ -0,0 +1,3 @@
+// UPSTREAM: These types should be provided by @seamapi/types/connect.
+export {};
+//# sourceMappingURL=api-error-type.js.map

package/lib/seam/connect/api-error-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error-type.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/api-error-type.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/lib/seam/connect/client.js

@@ -1,6 +1,9 @@
 import axios, {} from 'axios';
+// @ts-expect-error https://github.com/svsool/axios-better-stacktrace/issues/12
+import axiosBetterStacktrace from 'axios-better-stacktrace';
 import axiosRetry, { exponentialDelay } from 'axios-retry';
 import { paramsSerializer } from '../../../lib/params-serializer.js';
+import { errorInterceptor } from './error-interceptor.js';
 export const createClient = (options) => {
     if (options.client != null)
         return options.client;
@@ -8,12 +11,14 @@ export const createClient = (options) => {
         paramsSerializer,
         ...options.axiosOptions,
     });
+    axiosBetterStacktrace(axios);
     // @ts-expect-error https://github.com/softonic/axios-retry/issues/159
     axiosRetry(client, {
         retries: 2,
         retryDelay: exponentialDelay,
         ...options.axiosRetryOptions,
     });
+    client.interceptors.response.use(undefined, errorInterceptor);
     return client;
 };
 //# sourceMappingURL=client.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA+C,MAAM,OAAO,CAAA;AAC1E,OAAO,UAAU,EAAE,EAAmB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAY3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAiB,EAAE;IACpE,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,OAAO,CAAC,MAAM,CAAA;IAEjD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,gBAAgB;QAChB,GAAG,OAAO,CAAC,YAAY;KACxB,CAAC,CAAA;IAEF,sEAAsE;IACtE,UAAU,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,gBAAgB;QAC5B,GAAG,OAAO,CAAC,iBAAiB;KAC7B,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA+C,MAAM,OAAO,CAAA;AAC1E,+EAA+E;AAC/E,OAAO,qBAAqB,MAAM,yBAAyB,CAAA;AAC3D,OAAO,UAAU,EAAE,EAAmB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAYzD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAiB,EAAE;IACpE,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,OAAO,CAAC,MAAM,CAAA;IAEjD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,gBAAgB;QAChB,GAAG,OAAO,CAAC,YAAY;KACxB,CAAC,CAAA;IAEF,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAE5B,sEAAsE;IACtE,UAAU,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,gBAAgB;QAC5B,GAAG,OAAO,CAAC,iBAAiB;KAC7B,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;IAE7D,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/lib/seam/connect/error-interceptor.d.ts

@@ -0,0 +1 @@
+export declare const errorInterceptor: (err: unknown) => Promise<void>;

package/lib/seam/connect/error-interceptor.js

@@ -0,0 +1,43 @@
+import { isAxiosError } from 'axios';
+import { SeamHttpApiError, SeamHttpInvalidInputError, SeamHttpUnauthorizedError, } from './seam-http-error.js';
+export const errorInterceptor = async (err) => {
+    if (!isAxiosError(err))
+        throw err;
+    const { response } = err;
+    const status = response?.status;
+    const headers = response?.headers;
+    const requestId = headers?.['seam-request-id'] ?? '';
+    if (status == null)
+        throw err;
+    if (status === 401) {
+        throw new SeamHttpUnauthorizedError(requestId);
+    }
+    if (!isApiErrorResponse(response))
+        throw err;
+    const { type } = response.data.error;
+    const args = [response.data.error, status, requestId];
+    if (type === 'invalid_input')
+        throw new SeamHttpInvalidInputError(...args);
+    throw new SeamHttpApiError(...args);
+};
+const isApiErrorResponse = (response) => {
+    if (response == null)
+        return false;
+    const { headers, data } = response;
+    if (headers == null)
+        return false;
+    const contentType = headers['content-type'];
+    if (typeof contentType === 'string' &&
+        !contentType.startsWith('application/json')) {
+        return false;
+    }
+    if (typeof data === 'object' && data != null) {
+        return ('error' in data &&
+            typeof data.error === 'object' &&
+            data.error != null &&
+            'type' in data.error &&
+            typeof data.error.type === 'string');
+    }
+    return false;
+};
+//# sourceMappingURL=error-interceptor.js.map

package/lib/seam/connect/error-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-interceptor.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/error-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,YAAY,EAAE,MAAM,OAAO,CAAA;AAGrD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAY,EAAiB,EAAE;IACpE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;QAAE,MAAM,GAAG,CAAA;IAEjC,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAA;IACxB,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAA;IAC/B,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAA;IACjC,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAA;IAEpD,IAAI,MAAM,IAAI,IAAI;QAAE,MAAM,GAAG,CAAA;IAE7B,IAAI,MAAM,KAAK,GAAG,EAAE;QAClB,MAAM,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAA;KAC/C;IAED,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QAAE,MAAM,GAAG,CAAA;IAE5C,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAA;IAEpC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAA;IAE9D,IAAI,IAAI,KAAK,eAAe;QAAE,MAAM,IAAI,yBAAyB,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1E,MAAM,IAAI,gBAAgB,CAAC,GAAG,IAAI,CAAC,CAAA;AACrC,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CACzB,QAAgC,EACmC,EAAE;IACrE,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IAClC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAA;IAElC,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IAEjC,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC3C,IACE,OAAO,WAAW,KAAK,QAAQ;QAC/B,CAAC,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAC3C;QACA,OAAO,KAAK,CAAA;KACb;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI,EAAE;QAC5C,OAAO,CACL,OAAO,IAAI,IAAI;YACf,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAC9B,IAAI,CAAC,KAAK,IAAI,IAAI;YAClB,MAAM,IAAI,IAAI,CAAC,KAAK;YACpB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CACpC,CAAA;KACF;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

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

@@ -1,4 +1,6 @@
+export * from './error-interceptor.js';
 export * from './options.js';
-export * from './routes//index.js';
+export * from './routes/index.js';
 export * from './seam-http.js';
+export * from './seam-http-error.js';
 export * from '../../../lib/params-serializer.js';

package/lib/seam/connect/index.js

@@ -1,5 +1,7 @@
+export * from './error-interceptor.js';
 export * from './options.js';
-export * from './routes//index.js';
+export * from './routes/index.js';
 export * from './seam-http.js';
+export * from './seam-http-error.js';
 export * from '../../../lib/params-serializer.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA"}

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

@@ -0,0 +1,20 @@
+import type { ApiError } from './api-error-type.js';
+export declare class SeamHttpApiError extends Error {
+    code: string;
+    statusCode: number;
+    requestId: string;
+    data?: unknown;
+    constructor(error: ApiError, statusCode: number, requestId: string);
+}
+export declare const isSeamHttpApiError: (error: unknown) => error is SeamHttpApiError;
+export declare class SeamHttpUnauthorizedError extends SeamHttpApiError {
+    code: 'unauthorized';
+    statusCode: 401;
+    constructor(requestId: string);
+}
+export declare const isSeamHttpUnauthorizedError: (error: unknown) => error is SeamHttpUnauthorizedError;
+export declare class SeamHttpInvalidInputError extends SeamHttpApiError {
+    code: 'invalid_input';
+    constructor(error: ApiError, statusCode: number, requestId: string);
+}
+export declare const isSeamHttpInvalidInputError: (error: unknown) => error is SeamHttpInvalidInputError;

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

@@ -0,0 +1,43 @@
+export class SeamHttpApiError extends Error {
+    constructor(error, statusCode, requestId) {
+        const { type, message, data } = error;
+        super(message);
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+        this.code = type;
+        this.statusCode = statusCode;
+        this.requestId = requestId;
+        if (data != null)
+            this.data = data;
+    }
+}
+export const isSeamHttpApiError = (error) => {
+    return error instanceof SeamHttpApiError;
+};
+export class SeamHttpUnauthorizedError extends SeamHttpApiError {
+    constructor(requestId) {
+        const type = 'unauthorized';
+        const status = 401;
+        super({ type, message: 'Unauthorized' }, status, requestId);
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+        this.code = type;
+        this.statusCode = status;
+        this.requestId = requestId;
+    }
+}
+export const isSeamHttpUnauthorizedError = (error) => {
+    return error instanceof SeamHttpUnauthorizedError;
+};
+export class SeamHttpInvalidInputError extends SeamHttpApiError {
+    constructor(error, statusCode, requestId) {
+        super(error, statusCode, requestId);
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+        this.code = 'invalid_input';
+    }
+}
+export const isSeamHttpInvalidInputError = (error) => {
+    return error instanceof SeamHttpInvalidInputError;
+};
+//# sourceMappingURL=seam-http-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seam-http-error.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/seam-http-error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAMzC,YAAY,KAAe,EAAE,UAAkB,EAAE,SAAiB;QAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;QACrC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,IAAI,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAc,EACa,EAAE;IAC7B,OAAO,KAAK,YAAY,gBAAgB,CAAA;AAC1C,CAAC,CAAA;AAED,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAI7D,YAAY,SAAiB;QAC3B,MAAM,IAAI,GAAG,cAAc,CAAA;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAA;QAClB,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,KAAc,EACsB,EAAE;IACtC,OAAO,KAAK,YAAY,yBAAyB,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAG7D,YAAY,KAAe,EAAE,UAAkB,EAAE,SAAiB;QAChE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,KAAc,EACsB,EAAE;IACtC,OAAO,KAAK,YAAY,yBAAyB,CAAA;AACnD,CAAC,CAAA"}

package/lib/version.d.ts

@@ -1,2 +1,2 @@
-declare const seamapiJavascriptHttpVersion = "0.3.0";
+declare const seamapiJavascriptHttpVersion = "0.4.0";
 export default seamapiJavascriptHttpVersion;

package/lib/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/http",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "JavaScript HTTP client for the Seam API written in TypeScript.",
   "type": "module",
   "main": "index.js",
@@ -87,10 +87,11 @@
   },
   "dependencies": {
     "axios": "^1.5.0",
+    "axios-better-stacktrace": "^2.1.5",
     "axios-retry": "^3.8.0"
   },
   "devDependencies": {
-    "@seamapi/fake-seam-connect": "1.24.0",
+    "@seamapi/fake-seam-connect": "^1.43.0",
     "@seamapi/types": "^1.24.0",
     "@types/eslint": "^8.44.2",
     "@types/node": "^18.11.18",

package/src/lib/seam/connect/api-error-type.ts

@@ -0,0 +1,11 @@
+// UPSTREAM: These types should be provided by @seamapi/types/connect.
+
+export interface ApiErrorResponse {
+  error: ApiError
+}
+
+export interface ApiError {
+  type: string
+  message: string
+  data?: unknown
+}

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

@@ -1,8 +1,12 @@
 import axios, { type AxiosInstance, type AxiosRequestConfig } from 'axios'
+// @ts-expect-error https://github.com/svsool/axios-better-stacktrace/issues/12
+import axiosBetterStacktrace from 'axios-better-stacktrace'
 import axiosRetry, { type AxiosRetry, exponentialDelay } from 'axios-retry'
 
 import { paramsSerializer } from 'lib/params-serializer.js'
 
+import { errorInterceptor } from './error-interceptor.js'
+
 export type Client = AxiosInstance
 
 export interface ClientOptions {
@@ -21,6 +25,8 @@ export const createClient = (options: ClientOptions): AxiosInstance => {
     ...options.axiosOptions,
   })
 
+  axiosBetterStacktrace(axios)
+
   // @ts-expect-error https://github.com/softonic/axios-retry/issues/159
   axiosRetry(client, {
     retries: 2,
@@ -28,5 +34,7 @@ export const createClient = (options: ClientOptions): AxiosInstance => {
     ...options.axiosRetryOptions,
   })
 
+  client.interceptors.response.use(undefined, errorInterceptor)
+
   return client
 }

package/src/lib/seam/connect/error-interceptor.ts

@@ -0,0 +1,61 @@
+import { type AxiosError, isAxiosError } from 'axios'
+
+import type { ApiErrorResponse } from './api-error-type.js'
+import {
+  SeamHttpApiError,
+  SeamHttpInvalidInputError,
+  SeamHttpUnauthorizedError,
+} from './seam-http-error.js'
+
+export const errorInterceptor = async (err: unknown): Promise<void> => {
+  if (!isAxiosError(err)) throw err
+
+  const { response } = err
+  const status = response?.status
+  const headers = response?.headers
+  const requestId = headers?.['seam-request-id'] ?? ''
+
+  if (status == null) throw err
+
+  if (status === 401) {
+    throw new SeamHttpUnauthorizedError(requestId)
+  }
+
+  if (!isApiErrorResponse(response)) throw err
+
+  const { type } = response.data.error
+
+  const args = [response.data.error, status, requestId] as const
+
+  if (type === 'invalid_input') throw new SeamHttpInvalidInputError(...args)
+  throw new SeamHttpApiError(...args)
+}
+
+const isApiErrorResponse = (
+  response: AxiosError['response'],
+): response is NonNullable<AxiosError<ApiErrorResponse>['response']> => {
+  if (response == null) return false
+  const { headers, data } = response
+
+  if (headers == null) return false
+
+  const contentType = headers['content-type']
+  if (
+    typeof contentType === 'string' &&
+    !contentType.startsWith('application/json')
+  ) {
+    return false
+  }
+
+  if (typeof data === 'object' && data != null) {
+    return (
+      'error' in data &&
+      typeof data.error === 'object' &&
+      data.error != null &&
+      'type' in data.error &&
+      typeof data.error.type === 'string'
+    )
+  }
+
+  return false
+}

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

@@ -1,4 +1,6 @@
+export * from './error-interceptor.js'
 export * from './options.js'
-export * from './routes//index.js'
+export * from './routes/index.js'
 export * from './seam-http.js'
+export * from './seam-http-error.js'
 export * from 'lib/params-serializer.js'

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

@@ -0,0 +1,64 @@
+import type { ApiError } from './api-error-type.js'
+
+export class SeamHttpApiError extends Error {
+  code: string
+  statusCode: number
+  requestId: string
+  data?: unknown
+
+  constructor(error: ApiError, statusCode: number, requestId: string) {
+    const { type, message, data } = error
+    super(message)
+    this.name = this.constructor.name
+    Error.captureStackTrace(this, this.constructor)
+    this.code = type
+    this.statusCode = statusCode
+    this.requestId = requestId
+    if (data != null) this.data = data
+  }
+}
+
+export const isSeamHttpApiError = (
+  error: unknown,
+): error is SeamHttpApiError => {
+  return error instanceof SeamHttpApiError
+}
+
+export class SeamHttpUnauthorizedError extends SeamHttpApiError {
+  override code: 'unauthorized'
+  override statusCode: 401
+
+  constructor(requestId: string) {
+    const type = 'unauthorized'
+    const status = 401
+    super({ type, message: 'Unauthorized' }, status, requestId)
+    this.name = this.constructor.name
+    Error.captureStackTrace(this, this.constructor)
+    this.code = type
+    this.statusCode = status
+    this.requestId = requestId
+  }
+}
+
+export const isSeamHttpUnauthorizedError = (
+  error: unknown,
+): error is SeamHttpUnauthorizedError => {
+  return error instanceof SeamHttpUnauthorizedError
+}
+
+export class SeamHttpInvalidInputError extends SeamHttpApiError {
+  override code: 'invalid_input'
+
+  constructor(error: ApiError, statusCode: number, requestId: string) {
+    super(error, statusCode, requestId)
+    this.name = this.constructor.name
+    Error.captureStackTrace(this, this.constructor)
+    this.code = 'invalid_input'
+  }
+}
+
+export const isSeamHttpInvalidInputError = (
+  error: unknown,
+): error is SeamHttpInvalidInputError => {
+  return error instanceof SeamHttpInvalidInputError
+}

package/src/lib/version.ts

@@ -1,3 +1,3 @@
-const seamapiJavascriptHttpVersion = '0.3.0'
+const seamapiJavascriptHttpVersion = '0.4.0'
 
 export default seamapiJavascriptHttpVersion