expo-services

Files (1)

• SKILL.md

SKILL.md (first lines)

## Propósito

Crear servicios API consistentes en MyQuota App usando `requestWithAuth`.

---

## HTTP Client

**SIEMPRE** usar `requestWithAuth` para endpoints autenticados:

```typescript
import { requestWithAuth } from "@/features/auth/hooks/useAuth";
import { API_BASE_URL } from "@/config/api";
```

**NUNCA** usar `fetch()` directamente para endpoints que requieren auth.

---

## Patrón Base

```typescript
// src/features/<feature>/services/<feature>Api.ts

import { requestWithAuth } from "@/features/auth/hooks/useAuth";
import { API_BASE_URL } from "@/config/api";
import { MyItem } from "@/shared/types/myItem";

export const getItems = async (): Promise<MyItem[]> => {
  const response = await requestWithAuth(`${API_BASE_URL}/items`);
  if (!response.ok) {
    const data = await response.json().catch(() => null);
    const msg = data?.message || data?.error || `Error HTTP ${response.status}`;
    throw new Error(msg);
  }
  return response.json();
};
```

---

## Templates por Operación

### GET All

```typescript
export const getItems = async (): Promise<Item[]> => {
  const response = await requestWithAuth(`${API_BASE_URL}/items`);
  if (!response.ok) {
    const data = await response.json().catch(() => null);
    const msg = data?.message || data?.error || `Error HTTP ${response.status}`;
    throw new Error(msg);
  }
  return response.json();
};
```

### GET by ID

```typescript
export const getItemById = async (id: string): Promise<Item> => {
  const response = await requestWithAuth(`${API_BASE_URL}/items/${id}`);
  if (!response.ok) {
    const data = await response.json().catch(() => null);
    const msg = data?.message || data?.error || `Error HTTP ${response.status}`;
    throw new Error(msg);
  }
  return response.json();
};
```

### POST Create

```typescript
export const createItem = async (item: CreateItemDto): Promise<Item> => {
  const response = await requestWithAuth(`${API_BASE_URL}/items`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(item),
  });
  if (!response.ok) {
    const data = await response.json().catch(() => null);
    const msg = data?.message || data?.error || `Error HTTP ${response.status}`;
    throw new Error(msg);
  }
  return response.json();
};
```

### PUT Update

```typescript
export const updateItem = async (
  id: string,
  item: UpdateItemDto
): Promise<Item> => {
  const response = await requestWithAuth(`${API_BASE_URL}/items/${id}`, {
    method: "PUT",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(item),
  });
  if (!response.ok) {
    const data = await response.json().catch(() => null);
    const msg = data?.message || data?.error || `Error HTTP ${response.status}`;
    throw new Error(msg);
  }
  return response.json();
};
```

### DELETE

```typescript
export const deleteItem = async (id: string): Promise<void> => {
  const response = await requestWithAuth(`${API_BASE_URL}/items/${id}`, {
    method: "DELETE",
  });
  if (!response.ok) {
    const data = await response.json().catch(() => null);

From cabrerojas/myquota-app, MIT.

More from cabrerojas/myquota-app