Files
InvoiceShelf/resources/scripts-v2/composables/use-notification.ts
Darko Gjorgjijoski 991b716b33 Phase 1: TypeScript foundation in scripts-v2/
Create the complete TypeScript foundation for the Vue 3 migration
in a parallel scripts-v2/ directory. 72 files, 5430 lines, zero
any types, strict mode.

- types/ (21 files): Domain interfaces for all 17 entities derived
  from actual Laravel models and API resources. Enums for all
  statuses. Generic API response wrappers.
- api/ (29 files): Typed axios client with interceptors, endpoint
  constants from routes/api.php, 25 typed service classes covering
  every API endpoint.
- composables/ (14 files): Vue 3 composition functions for auth,
  notifications, dialogs, modals, pagination, filters, currency,
  dates, theme, sidebar, company context, and permissions.
- utils/ (5 files): Pure typed utilities for money formatting,
  date formatting (date-fns), localStorage, and error handling.
- config/ (3 files): Typed ability constants, app constants.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-04 05:00:00 +02:00

84 lines
2.1 KiB
TypeScript

import { ref, readonly } from 'vue'
import type { DeepReadonly, Ref } from 'vue'
import { NOTIFICATION_TYPE } from '../config/constants'
import type { NotificationType } from '../config/constants'
export interface Notification {
id: string
type: NotificationType
message: string
}
export interface UseNotificationReturn {
notifications: DeepReadonly<Ref<Notification[]>>
showSuccess: (message: string) => void
showError: (message: string) => void
showInfo: (message: string) => void
showWarning: (message: string) => void
showNotification: (type: NotificationType, message: string) => void
hideNotification: (id: string) => void
clearAll: () => void
}
const notifications = ref<Notification[]>([])
/**
* Generate a unique ID for a notification.
*/
function generateId(): string {
return (
Math.random().toString(36) + Date.now().toString(36)
).substring(2)
}
/**
* Composable for managing application-wide notifications.
* Provides typed helpers for success, error, info, and warning notifications.
*/
export function useNotification(): UseNotificationReturn {
function showNotification(type: NotificationType, message: string): void {
notifications.value.push({
id: generateId(),
type,
message,
})
}
function showSuccess(message: string): void {
showNotification(NOTIFICATION_TYPE.SUCCESS, message)
}
function showError(message: string): void {
showNotification(NOTIFICATION_TYPE.ERROR, message)
}
function showInfo(message: string): void {
showNotification(NOTIFICATION_TYPE.INFO, message)
}
function showWarning(message: string): void {
showNotification(NOTIFICATION_TYPE.WARNING, message)
}
function hideNotification(id: string): void {
notifications.value = notifications.value.filter(
(notification) => notification.id !== id
)
}
function clearAll(): void {
notifications.value = []
}
return {
notifications: readonly(notifications),
showSuccess,
showError,
showInfo,
showWarning,
showNotification,
hideNotification,
clearAll,
}
}