@nadohq/nuanze-client 0.41.0

package/src/endpoints.ts

@@ -0,0 +1,14 @@
+import { ChainEnv } from '@nadohq/shared';
+
+/**
+ * Base URLs for the Nuanze public analytics API, including the major version segment.
+ *
+ * Nuanze runs a single public deployment that serves mainnet data, so every chain environment maps
+ * to the same host. The map exists so callers can key off `chainEnv` exactly like the other service
+ * clients.
+ */
+export const NUANZE_CLIENT_ENDPOINTS: Record<ChainEnv, string> = {
+  local: 'https://api.nuanze.co/v1',
+  inkTestnet: 'https://api.nuanze.co/v1',
+  inkMainnet: 'https://api.nuanze.co/v1',
+};

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './dataMappers';
+export * from './endpoints';
+export * from './NuanzeClient';
+export * from './types';

package/src/types/NuanzeServerFailureError.ts

@@ -0,0 +1,36 @@
+import { NuanzeErrorCode } from './nuanzeErrorCodes';
+import { NuanzeServerFailureResponse } from './serverQueryTypes';
+
+/**
+ * Error thrown when the Nuanze API returns a failure envelope. Unlike the other service clients this
+ * does not extend `BaseServerFailureError`: Nuanze reports a string {@link NuanzeErrorCode} nested
+ * under `error` rather than a top-level numeric `error_code`, so there is no shared shape to inherit.
+ */
+export class NuanzeServerFailureError extends Error {
+  /**
+   * Error code to branch on, comparable against {@link NUANZE_ERROR_CODES}. Codes are additive, so an
+   * unrecognized value here came from a newer API release than this client.
+   */
+  readonly errorCode: NuanzeErrorCode;
+
+  /**
+   * HTTP status of the response, e.g. `404` for `MARKET_NOT_FOUND` or `429` for `RATE_LIMITED`.
+   */
+  readonly httpStatus: number;
+
+  /**
+   * Correlation ID to quote when reporting the failure. Matches the response's `X-Request-Id`.
+   */
+  readonly requestId: string;
+
+  constructor(
+    readonly responseData: NuanzeServerFailureResponse,
+    httpStatus: number,
+  ) {
+    super(`${responseData.error.code}: ${responseData.error.message}`);
+    this.name = 'NuanzeServerFailureError';
+    this.errorCode = responseData.error.code;
+    this.httpStatus = httpStatus;
+    this.requestId = responseData.error.requestId;
+  }
+}