@quvel-kit/core 1.1.0

package/dist/auth/services/index.d.ts

@@ -0,0 +1,8 @@
+export { AuthService } from './AuthService.js';
+export { PasswordResetService } from './PasswordResetService.js';
+export { TwoFactorService } from './TwoFactorService.js';
+export { TwoFactorChallengeService } from './TwoFactorChallengeService.js';
+export { AuthGuard } from './AuthGuard.js';
+export type { AuthCheckResult, AuthGuardConfig } from './AuthGuard.js';
+export type { TwoFactorQRResponse, TwoFactorSecretResponse, TwoFactorRecoveryCodesResponse } from './TwoFactorService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/auth/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/auth/services/index.js

@@ -0,0 +1,5 @@
+export { AuthService } from './AuthService.js';
+export { PasswordResetService } from './PasswordResetService.js';
+export { TwoFactorService } from './TwoFactorService.js';
+export { TwoFactorChallengeService } from './TwoFactorChallengeService.js';
+export { AuthGuard } from './AuthGuard.js';

package/dist/auth/types/auth-meta.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Authentication Meta Types
+ *
+ * Type definitions for route-level authentication configuration.
+ */
+/**
+ * Authentication configuration for routes
+ */
+export interface AuthMeta {
+    /**
+     * Explicitly require authentication for this route.
+     * If undefined, falls back to VITE_REQUIRE_AUTH_BY_DEFAULT environment variable.
+     *
+     * @example
+     * ```typescript
+     * auth: { requiresAuth: true }
+     * ```
+     */
+    requiresAuth?: boolean;
+    /**
+     * Skip all authentication checks for this route.
+     * Useful for static pages, public APIs, or routes that handle auth manually.
+     * Takes precedence over all other auth settings.
+     *
+     * @example
+     * ```typescript
+     * auth: { skipAuth: true }
+     * ```
+     */
+    skipAuth?: boolean;
+    /**
+     * Redirect authenticated users away from this route.
+     * Perfect for login, signup, and other auth-related pages where
+     * authenticated users shouldn't have access.
+     *
+     * @example
+     * ```typescript
+     * auth: { guestOnly: true }
+     * ```
+     */
+    guestOnly?: boolean;
+    /**
+     * Custom redirect target for authenticated users on guest-only routes.
+     * If not specified, uses VITE_AUTH_SUCCESS_ROUTE environment variable
+     * or falls back to dashboard.
+     *
+     * @example
+     * ```typescript
+     * auth: { guestOnly: true, redirectTo: '/custom-dashboard' }
+     * ```
+     */
+    redirectTo?: string;
+}
+//# sourceMappingURL=auth-meta.d.ts.map

package/dist/auth/types/auth-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-meta.d.ts","sourceRoot":"","sources":["../../../src/auth/types/auth-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/auth/types/auth-meta.js

@@ -0,0 +1,6 @@
+/**
+ * Authentication Meta Types
+ *
+ * Type definitions for route-level authentication configuration.
+ */
+export {};

package/dist/auth/types/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Auth Types Exports
+ */
+export type { AuthMeta } from './auth-meta.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/auth/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/auth/types/index.js

@@ -0,0 +1,4 @@
+/**
+ * Auth Types Exports
+ */
+export {};

package/dist/auth/utils/auth-meta.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Authentication Meta Utilities
+ *
+ * Helper functions for creating type-safe auth meta configurations.
+ */
+import type { AuthMeta } from '../types/auth-meta';
+/**
+ * Generic factory function for creating type-safe auth meta objects
+ *
+ * @param options - Auth configuration options
+ * @returns AuthMeta object for use in route meta
+ *
+ * @example
+ * ```typescript
+ * meta: {
+ *   auth: createAuthMeta({
+ *     guestOnly: true,
+ *     redirectTo: '/dashboard'
+ *   })
+ * }
+ * ```
+ */
+export declare function createAuthMeta(options: AuthMeta): AuthMeta;
+/**
+ * Create auth meta for guest-only routes (login, signup, etc.)
+ * Redirects authenticated users to the specified route or default success route.
+ *
+ * @param redirectTo - Optional custom redirect target for authenticated users
+ * @returns AuthMeta object configured for guest-only access
+ *
+ * @example
+ * ```typescript
+ * // Redirect to default success route
+ * meta: { auth: createGuestOnlyAuth() }
+ *
+ * // Redirect to custom route
+ * meta: { auth: createGuestOnlyAuth('/custom-dashboard') }
+ * ```
+ */
+export declare function createGuestOnlyAuth(redirectTo?: string): AuthMeta;
+/**
+ * Create auth meta for protected routes that explicitly require authentication
+ *
+ * @returns AuthMeta object configured to require authentication
+ *
+ * @example
+ * ```typescript
+ * meta: { auth: createProtectedAuth() }
+ * ```
+ */
+export declare function createProtectedAuth(): AuthMeta;
+/**
+ * Create auth meta for public routes that explicitly allow unauthenticated access
+ *
+ * @returns AuthMeta object configured for public access
+ *
+ * @example
+ * ```typescript
+ * meta: { auth: createPublicAuth() }
+ * ```
+ */
+export declare function createPublicAuth(): AuthMeta;
+/**
+ * Create auth meta that skips all authentication logic
+ * Useful for static pages, health checks, or routes with custom auth handling
+ *
+ * @returns AuthMeta object configured to skip all auth checks
+ *
+ * @example
+ * ```typescript
+ * meta: { auth: createSkipAuth() }
+ * ```
+ */
+export declare function createSkipAuth(): AuthMeta;
+//# sourceMappingURL=auth-meta.d.ts.map

package/dist/auth/utils/auth-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-meta.d.ts","sourceRoot":"","sources":["../../../src/auth/utils/auth-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAE1D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAMjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAI9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAI3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAIzC"}

package/dist/auth/utils/auth-meta.js

@@ -0,0 +1,93 @@
+/**
+ * Authentication Meta Utilities
+ *
+ * Helper functions for creating type-safe auth meta configurations.
+ */
+/**
+ * Generic factory function for creating type-safe auth meta objects
+ *
+ * @param options - Auth configuration options
+ * @returns AuthMeta object for use in route meta
+ *
+ * @example
+ * ```typescript
+ * meta: {
+ *   auth: createAuthMeta({
+ *     guestOnly: true,
+ *     redirectTo: '/dashboard'
+ *   })
+ * }
+ * ```
+ */
+export function createAuthMeta(options) {
+    return { ...options };
+}
+/**
+ * Create auth meta for guest-only routes (login, signup, etc.)
+ * Redirects authenticated users to the specified route or default success route.
+ *
+ * @param redirectTo - Optional custom redirect target for authenticated users
+ * @returns AuthMeta object configured for guest-only access
+ *
+ * @example
+ * ```typescript
+ * // Redirect to default success route
+ * meta: { auth: createGuestOnlyAuth() }
+ *
+ * // Redirect to custom route
+ * meta: { auth: createGuestOnlyAuth('/custom-dashboard') }
+ * ```
+ */
+export function createGuestOnlyAuth(redirectTo) {
+    return {
+        guestOnly: true,
+        requiresAuth: false, // Explicitly allow unauthenticated access
+        ...(redirectTo && { redirectTo }),
+    };
+}
+/**
+ * Create auth meta for protected routes that explicitly require authentication
+ *
+ * @returns AuthMeta object configured to require authentication
+ *
+ * @example
+ * ```typescript
+ * meta: { auth: createProtectedAuth() }
+ * ```
+ */
+export function createProtectedAuth() {
+    return {
+        requiresAuth: true,
+    };
+}
+/**
+ * Create auth meta for public routes that explicitly allow unauthenticated access
+ *
+ * @returns AuthMeta object configured for public access
+ *
+ * @example
+ * ```typescript
+ * meta: { auth: createPublicAuth() }
+ * ```
+ */
+export function createPublicAuth() {
+    return {
+        requiresAuth: false,
+    };
+}
+/**
+ * Create auth meta that skips all authentication logic
+ * Useful for static pages, health checks, or routes with custom auth handling
+ *
+ * @returns AuthMeta object configured to skip all auth checks
+ *
+ * @example
+ * ```typescript
+ * meta: { auth: createSkipAuth() }
+ * ```
+ */
+export function createSkipAuth() {
+    return {
+        skipAuth: true,
+    };
+}

package/dist/boot/quvel.d.ts

@@ -0,0 +1,26 @@
+import type { App } from 'vue';
+import type { QSsrContext } from '@quasar/app-vite';
+import type { ServiceRegistry } from '../modules/types.js';
+/**
+ * Define Quvel boot function
+ *
+ * This helper creates a Quasar boot function that initializes the Quvel service container
+ * with services from modules.
+ *
+ * @param serviceRegistry - Services from modules (getServices(modules))
+ * @returns Boot function for Quasar
+ *
+ * @example
+ * ```ts
+ * import { defineQuvelBoot } from '@quvel-kit/core';
+ * import { getServices } from '@quvel-kit/core';
+ * import { modules } from '../modules';
+ *
+ * export default defineQuvelBoot(getServices(modules));
+ * ```
+ */
+export declare function defineQuvelBoot(serviceRegistry: ServiceRegistry): ({ ssrContext, app }: {
+    ssrContext?: QSsrContext | null;
+    app: App;
+}) => void;
+//# sourceMappingURL=quvel.d.ts.map

package/dist/boot/quvel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quvel.d.ts","sourceRoot":"","sources":["../../src/boot/quvel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,eAAe,EAAE,eAAe,IACtD,qBAAqB;IAC3B,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,GAAG,EAAE,GAAG,CAAC;CACV,UAmBF"}

package/dist/boot/quvel.js

@@ -0,0 +1,38 @@
+import { createContainer } from '../utils/container.js';
+import { ContainerKey, setClientContainer } from '../composables/useQuvel.js';
+/**
+ * Define Quvel boot function
+ *
+ * This helper creates a Quasar boot function that initializes the Quvel service container
+ * with services from modules.
+ *
+ * @param serviceRegistry - Services from modules (getServices(modules))
+ * @returns Boot function for Quasar
+ *
+ * @example
+ * ```ts
+ * import { defineQuvelBoot } from '@quvel-kit/core';
+ * import { getServices } from '@quvel-kit/core';
+ * import { modules } from '../modules';
+ *
+ * export default defineQuvelBoot(getServices(modules));
+ * ```
+ */
+export function defineQuvelBoot(serviceRegistry) {
+    return ({ ssrContext, app }) => {
+        const serviceMap = new Map();
+        for (const [name, ServiceCls] of Object.entries(serviceRegistry)) {
+            serviceMap.set(name, ServiceCls);
+        }
+        const container = createContainer(ssrContext, serviceMap);
+        if (ssrContext) {
+            ssrContext.$quvel = container;
+        }
+        else {
+            app.provide(ContainerKey, container);
+            setClientContainer(container);
+        }
+        app.config.globalProperties.$quvel = container;
+        app.use(container.i18n.instance);
+    };
+}

package/dist/build/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Build-time Configuration Helpers
+ *
+ * Node.js-only utilities for quasar.config.ts
+ * These use Node.js APIs and should NOT be imported in browser code.
+ */
+export { config } from './quasarConfig.js';
+export { loadEnvFiles } from './loadEnv.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/build/index.js

@@ -0,0 +1,8 @@
+/**
+ * Build-time Configuration Helpers
+ *
+ * Node.js-only utilities for quasar.config.ts
+ * These use Node.js APIs and should NOT be imported in browser code.
+ */
+export { config } from './quasarConfig.js';
+export { loadEnvFiles } from './loadEnv.js';

package/dist/build/loadEnv.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Load environment files without side effects
+ *
+ * Reads .env files and returns a merged object without modifying process.env
+ */
+/**
+ * Load environment files into an object
+ *
+ * @param baseDir - Base directory to search for .env files
+ * @param files - Array of .env file names to load (in order of priority)
+ * @returns Merged environment object
+ */
+export declare function loadEnvFiles(baseDir: string, files?: string[]): Record<string, string>;
+//# sourceMappingURL=loadEnv.d.ts.map

package/dist/build/loadEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnv.d.ts","sourceRoot":"","sources":["../../src/build/loadEnv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,EAAa,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB"}

package/dist/build/loadEnv.js

@@ -0,0 +1,33 @@
+/**
+ * Load environment files without side effects
+ *
+ * Reads .env files and returns a merged object without modifying process.env
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse } from 'dotenv';
+/**
+ * Load environment files into an object
+ *
+ * @param baseDir - Base directory to search for .env files
+ * @param files - Array of .env file names to load (in order of priority)
+ * @returns Merged environment object
+ */
+export function loadEnvFiles(baseDir, files = ['.env']) {
+    const env = {};
+    for (const file of files) {
+        const filePath = resolve(baseDir, file);
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const parsed = parse(content);
+            Object.assign(env, parsed);
+        }
+        catch (error) {
+            console.warn(`Failed to load ${file}:`, error);
+        }
+    }
+    return env;
+}

package/dist/build/quasarConfig.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Quasar Configuration Helpers
+ *
+ * Configuration utilities for Quasar applications
+ */
+/**
+ * Configuration helper for Quasar applications
+ *
+ * Provides infrastructure settings and app metadata
+ */
+export declare const config: {
+    /**
+     * HTTPS/SSL configuration
+     */
+    https: {
+        /** Check if HTTPS is enabled */
+        isEnabled(): boolean;
+        /** Get SSL certificate paths (returns false if HTTPS disabled) */
+        getCerts(): {
+            key: string;
+            cert: string;
+            ca: string;
+        } | false;
+    };
+    /**
+     * Infrastructure configuration
+     */
+    infra: {
+        /** Check if running in local development mode */
+        isLocal(): boolean;
+        /** Get host based on type */
+        getHost(type?: "dev" | "tenant" | "prod"): string;
+        /** Get dev server port for a specific mode */
+        getPort(mode: "ssr" | "spa" | "capacitor" | "electron" | "pwa"): number;
+        /** Get Vite HMR port for SSR/PWA modes */
+        getHmrPort(mode: "ssr" | "pwa"): number;
+        /** Get a production server port (SSR only) */
+        getProdPort(): number;
+        /** Get a list of allowed hosts */
+        getAllowedHosts(): string[];
+        /** Get HMR configuration for reverse proxy setups */
+        getHMR(): {
+            protocol: string;
+            host: string;
+            port: number;
+        };
+    };
+    /**
+     * Application metadata
+     */
+    app: {
+        /** Get application ID */
+        getId(): string;
+        /** Get application name */
+        getName(): string;
+        /** Get application short name */
+        getShortName(): string;
+    };
+    /**
+     * SSR configuration
+     */
+    ssr: {
+        /** Check if PWA is enabled in SSR mode */
+        isPwaEnabled(): boolean;
+    };
+};
+//# sourceMappingURL=quasarConfig.d.ts.map

package/dist/build/quasarConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quasarConfig.d.ts","sourceRoot":"","sources":["../../src/build/quasarConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH;;;;GAIG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;;QAED,gCAAgC;qBACnB,OAAO;QAIpB,kEAAkE;oBACtD;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,KAAK;;IAa/D;;OAEG;;QAED,iDAAiD;mBACtC,OAAO;QAIlB,6BAA6B;uBACf,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAW,MAAM;QAWxD,8CAA8C;sBAChC,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM;QAYvE,0CAA0C;yBACzB,KAAK,GAAG,KAAK,GAAG,MAAM;QASvC,8CAA8C;uBAC/B,MAAM;QAIrB,kCAAkC;2BACf,MAAM,EAAE;QAI3B,qDAAqD;kBAC3C;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE;;IAS5D;;OAEG;;QAED,yBAAyB;iBAChB,MAAM;QAIf,2BAA2B;mBAChB,MAAM;QAIjB,iCAAiC;wBACjB,MAAM;;IAKxB;;OAEG;;QAED,0CAA0C;wBAC1B,OAAO;;CAI1B,CAAC"}

package/dist/build/quasarConfig.js

@@ -0,0 +1,126 @@
+/**
+ * Quasar Configuration Helpers
+ *
+ * Configuration utilities for Quasar applications
+ */
+import { EnvConfig } from '../utils/envConfig.js';
+import { loadEnvFiles } from './loadEnv.js';
+// Determine which env files to load based on NODE_ENV
+const nodeEnv = process.env.NODE_ENV || 'development';
+const envMode = nodeEnv === 'production' ? 'prod' : 'dev';
+const envFiles = [
+    '.env',
+    `.env.${envMode}`,
+    '.env.local',
+    `.env.${envMode}.local`,
+];
+const envVars = loadEnvFiles(process.cwd(), envFiles);
+const envConfig = new EnvConfig({ env: envVars });
+/**
+ * Configuration helper for Quasar applications
+ *
+ * Provides infrastructure settings and app metadata
+ */
+export const config = {
+    /**
+     * HTTPS/SSL configuration
+     */
+    https: {
+        /** Check if HTTPS is enabled */
+        isEnabled() {
+            return envConfig.getBoolean('HTTPS_ENABLED', true);
+        },
+        /** Get SSL certificate paths (returns false if HTTPS disabled) */
+        getCerts() {
+            if (!this.isEnabled()) {
+                return false;
+            }
+            return {
+                key: envConfig.get('CERT_KEY_PATH', '../docker/certs/selfsigned.key'),
+                cert: envConfig.get('CERT_PATH', '../docker/certs/selfsigned.crt'),
+                ca: envConfig.get('CERT_CA_PATH', '../docker/certs/ca.pem'),
+            };
+        },
+    },
+    /**
+     * Infrastructure configuration
+     */
+    infra: {
+        /** Check if running in local development mode */
+        isLocal() {
+            return envConfig.getBoolean('LOCAL', false);
+        },
+        /** Get host based on type */
+        getHost(type = 'dev') {
+            switch (type) {
+                case 'tenant':
+                    return envConfig.get('DEV_TENANT_HOST', 'cap-tenant.quvel.127.0.0.1.nip.io');
+                case 'prod':
+                    return envConfig.get('PROD_HOST', '0.0.0.0');
+                default:
+                    return envConfig.get('DEV_HOST', 'quvel.127.0.0.1.nip.io');
+            }
+        },
+        /** Get dev server port for a specific mode */
+        getPort(mode) {
+            const defaults = {
+                ssr: 3000,
+                spa: 3001,
+                capacitor: 3002,
+                electron: 3003,
+                pwa: 3004,
+            };
+            return envConfig.getNumber(`${mode.toUpperCase()}_DEV_PORT`, defaults[mode]);
+        },
+        /** Get Vite HMR port for SSR/PWA modes */
+        getHmrPort(mode) {
+            const defaults = {
+                ssr: 9001,
+                pwa: 9003,
+            };
+            return envConfig.getNumber(`${mode.toUpperCase()}_VITE_PORT`, defaults[mode]);
+        },
+        /** Get a production server port (SSR only) */
+        getProdPort() {
+            return envConfig.getNumber('SSR_PROD_PORT', 3000);
+        },
+        /** Get a list of allowed hosts */
+        getAllowedHosts() {
+            return envConfig.getArray('ALLOWED_HOSTS', ['quvel.127.0.0.1.nip.io']);
+        },
+        /** Get HMR configuration for reverse proxy setups */
+        getHMR() {
+            return {
+                protocol: envConfig.get('HMR_PROTOCOL', 'wss'),
+                host: envConfig.get('HMR_HOST', 'quvel.127.0.0.1.nip.io'),
+                port: envConfig.getNumber('HMR_PORT', 443),
+            };
+        },
+    },
+    /**
+     * Application metadata
+     */
+    app: {
+        /** Get application ID */
+        getId() {
+            return envConfig.get('APP_ID', 'quvel.irv.codes');
+        },
+        /** Get application name */
+        getName() {
+            return envConfig.get('VITE_APP_NAME', 'QuVel Kit');
+        },
+        /** Get application short name */
+        getShortName() {
+            return envConfig.get('APP_SHORT_NAME', 'QuVel');
+        },
+    },
+    /**
+     * SSR configuration
+     */
+    ssr: {
+        /** Check if PWA is enabled in SSR mode */
+        isPwaEnabled() {
+            return envConfig.getBoolean('SSR_PWA', false);
+        },
+    },
+};

package/dist/components/Common/TaskErrors.vue

@@ -0,0 +1,47 @@
+<script lang="ts" setup>
+/**
+ * TaskErrors.vue
+ *
+ * A component to display errors from a task.
+ *
+ * Props:
+ * - `taskErrors`: The errors from a task, including the main error and additional errors.
+ */
+import { computed } from 'vue';
+import FadeInOut from '../Transitions/FadeInOut.vue';
+import type { ErrorBag } from '../../types/laravel.types.js';
+
+/**
+ * Props for the component.
+ */
+const props = defineProps({
+  taskErrors: {
+    type: Object as () => ErrorBag,
+    default: () => ({ message: '', errors: {} }),
+  },
+});
+
+/**
+ * Extracts the most relevant error message.
+ * - If `message` is already inside `errors`, we ignore `message` to prevent duplication.
+ * - If `errors` exist, extract the first error.
+ * - Otherwise, fallback to `message`.
+ */
+const errorMessage = computed(() => {
+  const { taskErrors } = props;
+
+  // Get the first available error from `taskErrors`
+  const firstError = Array.from(taskErrors.values())[0];
+
+  // If firstError exists, use it. Otherwise, fallback to message.
+  return firstError || taskErrors.get('message') || '';
+});
+</script>
+
+<template>
+  <FadeInOut>
+    <q-banner v-if="errorMessage" class="bg-negative text-white" dense rounded>
+      {{ errorMessage }}
+    </q-banner>
+  </FadeInOut>
+</template>