@saulo.martins/api-client 1.0.1

package/dist/apiError.d.ts

@@ -0,0 +1,15 @@
+export type ApiErrorResponse = {
+    message?: string | {
+        message: string;
+        code: string;
+    };
+    statusCode?: number;
+};
+export declare function getApiErrorFromResponse(data: unknown): {
+    message: string;
+    code?: string;
+};
+export declare function attachCodeToError(err: Error, code: string): Error & {
+    code: string;
+};
+export declare function getDisplayMessage(err: unknown, t: (key: string) => string, fallbackKey?: string): string;

package/dist/apiError.js

@@ -0,0 +1,28 @@
+export function getApiErrorFromResponse(data) {
+    if (data == null || typeof data !== 'object' || !('message' in data))
+        return { message: '' };
+    const msg = data.message;
+    if (typeof msg === 'object' &&
+        msg !== null &&
+        'message' in msg &&
+        'code' in msg) {
+        return { message: msg.message, code: msg.code };
+    }
+    return { message: typeof msg === 'string' ? msg : '' };
+}
+export function attachCodeToError(err, code) {
+    err.code = code;
+    return err;
+}
+export function getDisplayMessage(err, t, fallbackKey = 'errors.generic') {
+    const code = err instanceof Error ? err.code : undefined;
+    if (code) {
+        const translated = t(`errors.${code}`);
+        if (translated !== `errors.${code}`)
+            return translated;
+    }
+    const message = err instanceof Error ? err.message : '';
+    if (message)
+        return message;
+    return t(fallbackKey);
+}

package/dist/apiError.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/apiError.spec.js

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+import { getApiErrorFromResponse, attachCodeToError, getDisplayMessage, } from './apiError';
+describe('apiError', () => {
+    it('getApiErrorFromResponse extracts message and code', () => {
+        const r = getApiErrorFromResponse({
+            message: { message: 'Invalid', code: 'INVALID_PACK' },
+        });
+        expect(r.message).toBe('Invalid');
+        expect(r.code).toBe('INVALID_PACK');
+    });
+    it('attachCodeToError adds code to error', () => {
+        const err = new Error('test');
+        const out = attachCodeToError(err, 'CODE');
+        expect(out.code).toBe('CODE');
+    });
+    it('getDisplayMessage uses t when code present', () => {
+        const err = attachCodeToError(new Error('x'), 'INVALID_PACK');
+        const t = (key) => (key === 'errors.INVALID_PACK' ? 'Pacote inválido' : key);
+        expect(getDisplayMessage(err, t)).toBe('Pacote inválido');
+    });
+});

package/dist/fetchJson.d.ts

@@ -0,0 +1,3 @@
+export declare function fetchJson<T = unknown>(url: string, options?: RequestInit & {
+    parseResponse?: boolean;
+}): Promise<T>;

package/dist/fetchJson.js

@@ -0,0 +1,14 @@
+import { getApiErrorFromResponse, attachCodeToError } from './apiError';
+export async function fetchJson(url, options) {
+    const { parseResponse = true, ...init } = options ?? {};
+    const res = await fetch(url, init);
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        const { message, code } = getApiErrorFromResponse(data);
+        const err = new Error(message || `Request failed: ${res.status}`);
+        if (code)
+            attachCodeToError(err, code);
+        throw err;
+    }
+    return (parseResponse ? data : res);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './apiError';
+export * from './fetchJson';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './apiError';
+export * from './fetchJson';

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@saulo.martins/api-client",
+  "version": "1.0.1",
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "~5.6.2",
+    "vitest": "^2.1.6"
+  }
+}

package/src/apiError.spec.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from 'vitest';
+import {
+  getApiErrorFromResponse,
+  attachCodeToError,
+  getDisplayMessage,
+} from './apiError';
+
+describe('apiError', () => {
+  it('getApiErrorFromResponse extracts message and code', () => {
+    const r = getApiErrorFromResponse({
+      message: { message: 'Invalid', code: 'INVALID_PACK' },
+    });
+    expect(r.message).toBe('Invalid');
+    expect(r.code).toBe('INVALID_PACK');
+  });
+
+  it('attachCodeToError adds code to error', () => {
+    const err = new Error('test');
+    const out = attachCodeToError(err, 'CODE');
+    expect((out as any).code).toBe('CODE');
+  });
+
+  it('getDisplayMessage uses t when code present', () => {
+    const err = attachCodeToError(new Error('x'), 'INVALID_PACK');
+    const t = (key: string) => (key === 'errors.INVALID_PACK' ? 'Pacote inválido' : key);
+    expect(getDisplayMessage(err, t)).toBe('Pacote inválido');
+  });
+});

package/src/apiError.ts

@@ -0,0 +1,46 @@
+export type ApiErrorResponse = {
+  message?: string | { message: string; code: string };
+  statusCode?: number;
+};
+
+export function getApiErrorFromResponse(data: unknown): {
+  message: string;
+  code?: string;
+} {
+  if (data == null || typeof data !== 'object' || !('message' in data))
+    return { message: '' };
+  const msg = (data as ApiErrorResponse).message;
+  if (
+    typeof msg === 'object' &&
+    msg !== null &&
+    'message' in msg &&
+    'code' in msg
+  ) {
+    return { message: msg.message, code: msg.code };
+  }
+  return { message: typeof msg === 'string' ? msg : '' };
+}
+
+export function attachCodeToError(
+  err: Error,
+  code: string,
+): Error & { code: string } {
+  (err as Error & { code?: string }).code = code;
+  return err as Error & { code: string };
+}
+
+export function getDisplayMessage(
+  err: unknown,
+  t: (key: string) => string,
+  fallbackKey = 'errors.generic',
+): string {
+  const code =
+    err instanceof Error ? (err as Error & { code?: string }).code : undefined;
+  if (code) {
+    const translated = t(`errors.${code}`);
+    if (translated !== `errors.${code}`) return translated;
+  }
+  const message = err instanceof Error ? err.message : '';
+  if (message) return message;
+  return t(fallbackKey);
+}

package/src/fetchJson.ts

@@ -0,0 +1,17 @@
+import { getApiErrorFromResponse, attachCodeToError } from './apiError';
+
+export async function fetchJson<T = unknown>(
+  url: string,
+  options?: RequestInit & { parseResponse?: boolean },
+): Promise<T> {
+  const { parseResponse = true, ...init } = options ?? {};
+  const res = await fetch(url, init);
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const { message, code } = getApiErrorFromResponse(data);
+    const err = new Error(message || `Request failed: ${res.status}`);
+    if (code) attachCodeToError(err, code);
+    throw err;
+  }
+  return (parseResponse ? data : res) as T;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './apiError';
+export * from './fetchJson';

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true
+  },
+  "include": ["src"]
+}

package/vitest.config.mts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+  },
+});