ACY Generic Service Package for Vue

A comprehensive generic service package for Vue 3 applications, providing HTTP client, data management, authentication, and error handling.

Installation

npm install acy-generic-service-package-vue

Usage

As a Plugin

import { createApp } from 'vue';
import App from './App.vue';
import VueGenericService from 'acy-generic-service-package-vue';

const app = createApp(App);
app.use(VueGenericService, { baseURL: 'https://api.example.com' });
app.mount('#app');

In components:

export default {
  async mounted() {
    try {
      const response = await this.$service.http.get('/users');
      this.$service.data.set('users', response.data);
    } catch (error) {
      console.error(GenericService.handleError(error));
    }
  }
}

Using Composables

import { useService } from 'acy-generic-service-package-vue';

export default {
  setup() {
    const service = useService();

    const fetchData = async () => {
      try {
        const response = await service.http.get('/data');
        service.data.set('data', response.data);
      } catch (error) {
        console.error(GenericService.handleError(error));
      }
    };

    return { fetchData };
  }
}

Authentication

const login = async () => {
  try {
    await service.auth.login({ username: 'user', password: 'pass' });
    // Redirect or update UI
  } catch (error) {
    console.error(error.message);
  }
};

const logout = () => {
  service.auth.logout();
};

API Reference

GenericService

• http: HttpClient instance
• data: DataManager instance
• auth: AuthService instance

HttpClient

• get(url, config)
• post(url, data, config)
• put(url, data, config)
• delete(url, config)

DataManager

• set(key, data)
• get(key)
• clear(key)
• clearAll()

AuthService

• login(credentials)
• logout()
• isAuthenticated()
• getToken()

ErrorHandler

• handleError(error): Static method to format errors

Development

npm install
npm run test
npm run build

License

MIT