typescript-dev

النتيجة المتوقعة:

Hier ist eine typsichere API-Funktion mit dem Result-Muster:

```typescript
type Result<T, E = Error> =
| { success: true; data: T }
| { success: false; error: E };

async function fetchUserData(id: string): Promise<Result<UserData>> {
try {
const response = await fetch(`/api/users/${id}`);
if (!response.ok) {
return { success: false, error: new Error('Failed to fetch') };
}
const data = await response.json();
return { success: true, data };
} catch (error) {
return { success: false, error: error as Error };
}
}
```

النتيجة المتوقعة:

Hier ist die Funktion mit TSDoc-Dokumentation:

```typescript
/**
* Calculates the total price including tax and discounts.
*
* @param basePrice - The original price before any modifications
* @param taxRate - The tax rate as a decimal (e.g., 0.08 for 8%)
* @param discountPercent - Optional discount percentage (0-100)
* @returns The final calculated price, never negative
*/
function calculateTotal(
basePrice: number,
taxRate: number,
discountPercent: number = 0
): number {
const discounted = basePrice * (1 - discountPercent / 100);
return Math.max(0, discounted * (1 + taxRate));
}
```