expo-types

Files (1)

• SKILL.md

SKILL.md (first lines)

## Propósito

Mantener tipado consistente en MyQuota App con TypeScript strict mode.

---

## Ubicación de Tipos

```
src/
├── shared/types/           # Interfaces usadas en múltiples features
│   ├── creditCard.ts
│   ├── transaction.ts
│   ├── quota.ts
│   ├── billingPeriod.ts
│   ├── user.ts
│   └── category.ts
│
└── features/<feature>/types/  # Interfaces de un solo feature
    └── featureSpecific.ts
```

---

## Regla de Ubicación

| Situación | Ubicación |
|-----------|-----------|
| Interface usada en 1 feature | `features/<feature>/types/` |
| Interface usada en 2+ features | `shared/types/` |
| DTOs para crear/actualizar | Junto a la interface principal |

---

## Template: Interface de Entidad

```typescript
// src/shared/types/creditCard.ts

export interface CreditCard {
  id: string;
  createdAt: string;     // ISO string (el backend devuelve strings)
  updatedAt: string;
  deletedAt?: string | null;

  name: string;
  lastFourDigits: string;
  color: string;
  closingDay: number;
  paymentDay: number;
}

// DTO para crear
export interface CreateCreditCardDto {
  name: string;
  lastFourDigits: string;
  color: string;
  closingDay: number;
  paymentDay: number;
}

// DTO para actualizar (parcial)
export type UpdateCreditCardDto = Partial<CreateCreditCardDto>;
```

---

## Template: Props de Componente

```typescript
// Definir interface para props
interface CreditCardItemProps {
  card: CreditCard;
  onPress?: () => void;
  showActions?: boolean;
}

export default function CreditCardItem({
  card,
  onPress,
  showActions = false,
}: CreditCardItemProps) {
  // ...
}
```

---

## Fechas

**El backend devuelve ISO strings**, no objetos `Date`:

```typescript
// ✅ Correcto
export interface BillingPeriod {
  id: string;
  startDate: string;    // "2025-03-01T00:00:00.000Z"
  endDate: string;
  closingDate: string;
}

// ❌ Incorrecto
export interface BillingPeriod {
  startDate: Date;      // NO — la API devuelve strings
}
```

---

## Opcionales

```typescript
// Propiedad puede no existir
deletedAt?: string | null;

// Propiedad requerida pero puede ser null
description: string | null;

// Propiedad opcional con default

From cabrerojas/myquota-app, MIT.

More from cabrerojas/myquota-app