@quvel-kit/core 1.1.0

package/dist/services/ValidationService.js

@@ -0,0 +1,81 @@
+import * as z from 'zod/v4';
+import { Service } from './Service.js';
+/**
+ * Default locale mapping for validation
+ * Maps common locale codes to Zod v4 locale codes
+ */
+export const DEFAULT_LOCALE_MAPPING = {
+    'en': 'en',
+    'en-US': 'en',
+    'en-GB': 'en',
+    'es': 'es',
+    'es-MX': 'es',
+    'es-ES': 'es',
+};
+/**
+ * Validation Service with Zod v4 locale integration
+ */
+export class ValidationService extends Service {
+    static localeMapping = DEFAULT_LOCALE_MAPPING;
+    i18n;
+    currentLocale = 'en';
+    /**
+     * Set custom locale mapping for validation
+     * Optional - uses DEFAULT_LOCALE_MAPPING if not called
+     *
+     * @param mapping - Locale mapping (e.g., { 'en-US': 'en', 'es-MX': 'es' })
+     */
+    static setLocaleMapping(mapping) {
+        ValidationService.localeMapping = mapping;
+    }
+    constructor(config, ssrContext) {
+        super(config, ssrContext);
+    }
+    /**
+     * Register with container - inject dependencies and set initial locale
+     */
+    register({ i18n }) {
+        this.i18n = i18n;
+        this.setLocale(this.i18n.locale);
+    }
+    /**
+     * Set Zod validation locale based on language code
+     * Uses the locale mapping configured via setLocaleMapping()
+     */
+    setLocale(locale) {
+        const localeMap = ValidationService.localeMapping;
+        const zodLocale = localeMap[locale] || 'en';
+        if (zodLocale !== this.currentLocale) {
+            this.currentLocale = zodLocale;
+            const localeConfig = z.locales[zodLocale];
+            if (localeConfig && typeof localeConfig === 'function') {
+                z.config(localeConfig());
+            }
+            else {
+                z.config(z.locales.en());
+            }
+        }
+    }
+    validate(value, schema, firstOnly) {
+        this.setLocale(this.i18n.locale);
+        const result = schema.safeParse(value);
+        if (result.success) {
+            return firstOnly ? true : [];
+        }
+        if (firstOnly) {
+            const firstIssue = result.error.issues[0];
+            return firstIssue?.message || 'Invalid input';
+        }
+        return result.error.issues.map((issue) => issue.message);
+    }
+    /**
+     * Creates a Quasar-compatible validation rule that stops at the first error
+     * This is the recommended way to create validation rules for QInput
+     *
+     * @param schema - The Zod schema
+     * @returns A Quasar validation rule function
+     */
+    createInputRule(schema) {
+        return (value) => this.validate(value, schema, true);
+    }
+}

package/dist/services/WebSocketService.d.ts

@@ -0,0 +1,59 @@
+/**
+ * WebSocket Service
+ *
+ * Service for managing Laravel Echo WebSocket connections with Pusher
+ */
+import type Echo from 'laravel-echo';
+import type { QSsrContext } from '@quasar/app-vite';
+import type { ServiceContainer } from '../container/ServiceContainer.js';
+import type { RegisterService } from '../container/types.js';
+import type { EncryptedChannelType, PresenceChannelType, PrivateChannelType, PublicChannelType, SubscribeOptions } from '../types/websocket.types.js';
+import { Service } from './Service.js';
+import { AppConfig } from "../types/app.types";
+/**
+ * WebSocket Service for Laravel Echo connections
+ *
+ * Manages WebSocket connections using Laravel Echo and Pusher
+ */
+export declare class WebSocketService extends Service implements RegisterService {
+    #private;
+    private api;
+    private connectionPromise;
+    private isConnected;
+    private apiKey;
+    private cluster;
+    private readonly isSsr;
+    constructor(config: AppConfig, ssrContext?: QSsrContext | null);
+    /**
+     * Get the Echo instance
+     */
+    get echo(): Echo<'pusher'> | null;
+    /**
+     * Register with container - inject dependencies and get config
+     */
+    register({ api, config }: ServiceContainer): void;
+    /**
+     * Connect to WebSocket server
+     */
+    connect(): Promise<void>;
+    /**
+     * Unified subscription method for all channel types
+     */
+    subscribe<T = unknown>(options: SubscribeOptions<T> & {
+        type: 'public' | 'publicNotification';
+    }): Promise<PublicChannelType>;
+    subscribe<T = unknown>(options: SubscribeOptions<T> & {
+        type: 'private' | 'privateNotification';
+    }): Promise<PrivateChannelType>;
+    subscribe<T = unknown>(options: SubscribeOptions<T> & {
+        type: 'presence';
+    }): Promise<PresenceChannelType>;
+    subscribe<T = unknown>(options: SubscribeOptions<T> & {
+        type: 'encrypted';
+    }): Promise<EncryptedChannelType>;
+    /**
+     * Disconnect from the WebSocket server
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=WebSocketService.d.ts.map

package/dist/services/WebSocketService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketService.d.ts","sourceRoot":"","sources":["../../src/services/WebSocketService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,OAAQ,YAAW,eAAe;;IAEtE,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;gBAEpD,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAEhC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,IAAI;IASjD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDxB;;OAEG;IACG,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,QAAQ,GAAG,oBAAoB,CAAA;KAAE,GACvE,OAAO,CAAC,iBAAiB,CAAC;IACvB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAAA;KAAE,GACzE,OAAO,CAAC,kBAAkB,CAAC;IACxB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,GAClD,OAAO,CAAC,mBAAmB,CAAC;IACzB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GACnD,OAAO,CAAC,oBAAoB,CAAC;IAuEhC;;OAEG;IACH,UAAU,IAAI,IAAI;CAMnB"}

package/dist/services/WebSocketService.js

@@ -0,0 +1,148 @@
+/**
+ * WebSocket Service
+ *
+ * Service for managing Laravel Echo WebSocket connections with Pusher
+ */
+import { Service } from './Service.js';
+/**
+ * WebSocket Service for Laravel Echo connections
+ *
+ * Manages WebSocket connections using Laravel Echo and Pusher
+ */
+export class WebSocketService extends Service {
+    #echo = null;
+    api;
+    connectionPromise = null;
+    isConnected = false;
+    apiKey = '';
+    cluster = '';
+    isSsr = typeof window === 'undefined';
+    constructor(config, ssrContext) {
+        super(config, ssrContext);
+    }
+    /**
+     * Get the Echo instance
+     */
+    get echo() {
+        return this.#echo;
+    }
+    /**
+     * Register with container - inject dependencies and get config
+     */
+    register({ api, config }) {
+        this.api = api;
+        const broadcasting = config?.broadcasting?.pusher;
+        this.apiKey = broadcasting?.key ?? import.meta.env.VITE_PUSHER_APP_KEY ?? '';
+        this.cluster = broadcasting?.options?.cluster ?? import.meta.env.VITE_PUSHER_APP_CLUSTER ?? '';
+    }
+    /**
+     * Connect to WebSocket server
+     */
+    connect() {
+        if (this.isConnected || this.isSsr)
+            return Promise.resolve();
+        if (this.connectionPromise)
+            return this.connectionPromise;
+        this.connectionPromise = new Promise((resolve, reject) => {
+            void Promise.all([import('pusher-js'), import('laravel-echo')]).then(([Pusher, EchoModule]) => {
+                const EchoConstructor = EchoModule.default;
+                if (!this.isSsr && !window.Pusher) {
+                    window.Pusher = Pusher;
+                }
+                this.#echo = new EchoConstructor({
+                    broadcaster: 'pusher',
+                    key: this.apiKey,
+                    cluster: this.cluster,
+                    authorizer: (channel) => {
+                        const apiService = this.api;
+                        return {
+                            authorize: async (socketId, callback) => {
+                                try {
+                                    const data = await apiService.post('/broadcasting/auth', {
+                                        socket_id: socketId,
+                                        channel_name: channel.name,
+                                    });
+                                    return callback(false, data);
+                                }
+                                catch {
+                                    return callback(true, null);
+                                }
+                            },
+                        };
+                    },
+                });
+                this.#echo.connector.pusher.connection.bind('connected', () => {
+                    this.isConnected = true;
+                    this.connectionPromise = null;
+                    resolve();
+                });
+                this.#echo.connector.pusher.connection.bind('disconnected', () => {
+                    this.isConnected = false;
+                    this.connectionPromise = null;
+                });
+                this.#echo.connector.pusher.connection.bind('error', (err) => {
+                    console.error('[WebSocket Error]', err);
+                    reject(new Error('WebSocket connection error'));
+                });
+            });
+        });
+        return this.connectionPromise;
+    }
+    async subscribe(options) {
+        if (this.isSsr)
+            return false;
+        await this.connect();
+        if (!this.#echo)
+            return false;
+        const { channelName, type, event, callback, presenceHandlers } = options;
+        let channel;
+        switch (type) {
+            case 'public':
+            case 'publicNotification':
+                channel = this.#echo.channel(channelName);
+                break;
+            case 'private':
+            case 'privateNotification':
+                channel = this.#echo.private(channelName);
+                break;
+            case 'presence':
+                channel = this.#echo.join(channelName);
+                break;
+            case 'encrypted':
+                channel = this.#echo.encryptedPrivate(channelName);
+                break;
+            default:
+                throw new Error('Unknown channel type');
+        }
+        if (type.endsWith('Notification')) {
+            return channel.notification(callback);
+        }
+        if (event) {
+            channel.listen(event, callback);
+        }
+        if (type === 'presence' && presenceHandlers) {
+            if (presenceHandlers.onListening) {
+                channel.listen(presenceHandlers.onListening.event, presenceHandlers.onListening.callback);
+            }
+            if (presenceHandlers.onHere) {
+                channel.here((members) => presenceHandlers.onHere?.(members));
+            }
+            if (presenceHandlers.onJoining) {
+                channel.joining((member) => presenceHandlers.onJoining?.(member));
+            }
+            if (presenceHandlers.onLeaving) {
+                channel.leaving((member) => presenceHandlers.onLeaving?.(member));
+            }
+        }
+        return channel;
+    }
+    /**
+     * Disconnect from the WebSocket server
+     */
+    disconnect() {
+        this.#echo?.disconnect();
+        this.#echo = null;
+        this.connectionPromise = null;
+        this.isConnected = false;
+    }
+}

package/dist/services/logger/BaseLogger.d.ts

@@ -0,0 +1,35 @@
+import { LogLevel } from '../../types/logging.types.js';
+import type { LoggerInterface, TraceInfo } from '../../types/logging.types.js';
+/**
+ * Abstract base logger class
+ * Provides common functionality for all logger implementations
+ */
+export declare abstract class BaseLogger implements LoggerInterface {
+    protected readonly traceInfo: TraceInfo;
+    constructor(traceInfo: TraceInfo);
+    /**
+     * Gets the current trace info
+     */
+    getTraceInfo(): TraceInfo;
+    /**
+     * Format a log message with trace context
+     */
+    protected formatMessage(level: LogLevel, message: string, context?: Record<string, unknown>): string;
+    /**
+     * Abstract method for logging - must be implemented by subclasses
+     */
+    protected abstract writeLog(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    emergency(message: string, context?: Record<string, unknown>): void;
+    alert(message: string, context?: Record<string, unknown>): void;
+    critical(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    warning(message: string, context?: Record<string, unknown>): void;
+    notice(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Logs with an arbitrary level
+     */
+    log(level: string, message: string, context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=BaseLogger.d.ts.map

package/dist/services/logger/BaseLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseLogger.d.ts","sourceRoot":"","sources":["../../../src/services/logger/BaseLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE/E;;;GAGG;AACH,8BAAsB,UAAW,YAAW,eAAe;IAC7C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;gBAApB,SAAS,EAAE,SAAS;IAEnD;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,SAAS,CAAC,aAAa,CACrB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM;IAiBT;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAEtG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIlE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAK7E"}

package/dist/services/logger/BaseLogger.js

@@ -0,0 +1,66 @@
+import { LogLevel } from '../../types/logging.types.js';
+/**
+ * Abstract base logger class
+ * Provides common functionality for all logger implementations
+ */
+export class BaseLogger {
+    traceInfo;
+    constructor(traceInfo) {
+        this.traceInfo = traceInfo;
+    }
+    /**
+     * Gets the current trace info
+     */
+    getTraceInfo() {
+        return this.traceInfo;
+    }
+    /**
+     * Format a log message with trace context
+     */
+    formatMessage(level, message, context) {
+        const parts = [
+            `[${level.toUpperCase()}]`,
+            `[${this.traceInfo.timestamp}]`,
+            `[${this.traceInfo.runtime}]`,
+            this.traceInfo.id ? `[trace:${this.traceInfo.id}]` : null,
+            this.traceInfo.tenant !== 'unknown' ? `[tenant:${this.traceInfo.tenant}]` : null,
+            message,
+        ].filter(Boolean);
+        if (context && Object.keys(context).length > 0) {
+            parts.push(JSON.stringify(context));
+        }
+        return parts.join(' ');
+    }
+    emergency(message, context) {
+        this.writeLog(LogLevel.EMERGENCY, message, context);
+    }
+    alert(message, context) {
+        this.writeLog(LogLevel.ALERT, message, context);
+    }
+    critical(message, context) {
+        this.writeLog(LogLevel.CRITICAL, message, context);
+    }
+    error(message, context) {
+        this.writeLog(LogLevel.ERROR, message, context);
+    }
+    warning(message, context) {
+        this.writeLog(LogLevel.WARNING, message, context);
+    }
+    notice(message, context) {
+        this.writeLog(LogLevel.NOTICE, message, context);
+    }
+    info(message, context) {
+        this.writeLog(LogLevel.INFO, message, context);
+    }
+    debug(message, context) {
+        this.writeLog(LogLevel.DEBUG, message, context);
+    }
+    /**
+     * Logs with an arbitrary level
+     */
+    log(level, message, context) {
+        // Map string level to LogLevel enum
+        const logLevel = level.toLowerCase() || LogLevel.INFO;
+        this.writeLog(logLevel, message, context);
+    }
+}

package/dist/services/logger/ConsoleLogger.d.ts

@@ -0,0 +1,21 @@
+import { LogLevel } from '../../types/logging.types.js';
+import type { TraceInfo } from '../../types/logging.types.js';
+import { BaseLogger } from './BaseLogger.js';
+/**
+ * Console logger implementation
+ * Logs to the browser console with level filtering
+ */
+export declare class ConsoleLogger extends BaseLogger {
+    private readonly minLevel;
+    constructor(traceInfo: TraceInfo, minLevel?: LogLevel);
+    /**
+     * Check if a log level should be displayed
+     */
+    private shouldLog;
+    /**
+     * Map log level to console method
+     */
+    private getConsoleMethod;
+    protected writeLog(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=ConsoleLogger.d.ts.map

package/dist/services/logger/ConsoleLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.d.ts","sourceRoot":"","sources":["../../../src/services/logger/ConsoleLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgB7C;;;GAGG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,SAAS,EAAE,SAAS,EAAE,QAAQ,GAAE,QAAwB;IAKpE;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAS9F"}

package/dist/services/logger/ConsoleLogger.js

@@ -0,0 +1,60 @@
+import { LogLevel } from '../../types/logging.types.js';
+import { BaseLogger } from './BaseLogger.js';
+/**
+ * Log level priority mapping (higher number = higher priority)
+ */
+const LOG_LEVEL_PRIORITY = {
+    [LogLevel.EMERGENCY]: 8,
+    [LogLevel.ALERT]: 7,
+    [LogLevel.CRITICAL]: 6,
+    [LogLevel.ERROR]: 5,
+    [LogLevel.WARNING]: 4,
+    [LogLevel.NOTICE]: 3,
+    [LogLevel.INFO]: 2,
+    [LogLevel.DEBUG]: 1,
+};
+/**
+ * Console logger implementation
+ * Logs to the browser console with level filtering
+ */
+export class ConsoleLogger extends BaseLogger {
+    minLevel;
+    constructor(traceInfo, minLevel = LogLevel.INFO) {
+        super(traceInfo);
+        this.minLevel = minLevel;
+    }
+    /**
+     * Check if a log level should be displayed
+     */
+    shouldLog(level) {
+        return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.minLevel];
+    }
+    /**
+     * Map log level to console method
+     */
+    getConsoleMethod(level) {
+        switch (level) {
+            case LogLevel.EMERGENCY:
+            case LogLevel.ALERT:
+            case LogLevel.CRITICAL:
+            case LogLevel.ERROR:
+                return 'error';
+            case LogLevel.WARNING:
+                return 'warn';
+            case LogLevel.NOTICE:
+            case LogLevel.INFO:
+                return 'info';
+            case LogLevel.DEBUG:
+            default:
+                return 'log';
+        }
+    }
+    writeLog(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const formatted = this.formatMessage(level, message, context);
+        const method = this.getConsoleMethod(level);
+        console[method](formatted);
+    }
+}

package/dist/services/logger/NullLogger.d.ts

@@ -0,0 +1,10 @@
+import type { LogLevel } from '../../types/logging.types.js';
+import { BaseLogger } from './BaseLogger.js';
+/**
+ * Null logger implementation
+ * Does nothing - useful for disabling logs
+ */
+export declare class NullLogger extends BaseLogger {
+    protected writeLog(_level: LogLevel, _message: string, _context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=NullLogger.d.ts.map

package/dist/services/logger/NullLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NullLogger.d.ts","sourceRoot":"","sources":["../../../src/services/logger/NullLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGjG"}

package/dist/services/logger/NullLogger.js

@@ -0,0 +1,10 @@
+import { BaseLogger } from './BaseLogger.js';
+/**
+ * Null logger implementation
+ * Does nothing - useful for disabling logs
+ */
+export class NullLogger extends BaseLogger {
+    writeLog(_level, _message, _context) {
+        // No-op
+    }
+}

package/dist/stores/plugins/serviceContainer.d.ts

@@ -0,0 +1,10 @@
+import type { PiniaPluginContext } from 'pinia';
+import type { QSsrContext } from '@quasar/app-vite';
+/**
+ * Pinia plugin to inject the Quvel service container into every store as `$quvel`.
+ * Handles SSR context or falls back to the client container.
+ */
+export declare function serviceContainerPlugin(context: PiniaPluginContext, ssrContext?: QSsrContext | null): {
+    $quvel: import("vue").Raw<import("../../index.js").ServiceContainer>;
+};
+//# sourceMappingURL=serviceContainer.d.ts.map

package/dist/stores/plugins/serviceContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceContainer.d.ts","sourceRoot":"","sources":["../../../src/stores/plugins/serviceContainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI;;EAUhC"}

package/dist/stores/plugins/serviceContainer.js

@@ -0,0 +1,14 @@
+import { useQuvel } from '../../composables/useQuvel.js';
+import { markRaw } from 'vue';
+/**
+ * Pinia plugin to inject the Quvel service container into every store as `$quvel`.
+ * Handles SSR context or falls back to the client container.
+ */
+export function serviceContainerPlugin(context, ssrContext) {
+    // markRaw to prevent Vue from making it reactive
+    const rawContainer = markRaw(ssrContext?.$quvel ?? useQuvel());
+    context.store.$quvel = rawContainer;
+    return {
+        $quvel: rawContainer,
+    };
+}

package/dist/stores/sessionStore.d.ts

@@ -0,0 +1,71 @@
+import type { IUser } from '../types/user.types.js';
+/**
+ * Type for the authenticated user.
+ * Supports custom user models via generic type parameter.
+ */
+type StateUser<T extends IUser = IUser> = T | null;
+/**
+ * Interface defining the structure of the session state.
+ */
+interface SessionState<T extends IUser = IUser> {
+    user: StateUser<T>;
+    initialized: boolean;
+}
+/**
+ * Interface defining getters for the session store.
+ */
+type SessionGetters<T extends IUser = IUser> = {
+    isAuthenticated: (state: SessionState<T>) => boolean;
+    isInitialized: (state: SessionState<T>) => boolean;
+    getUser: (state: SessionState<T>) => StateUser<T>;
+};
+/**
+ * Interface defining actions for the session store.
+ */
+interface SessionActions<T extends IUser = IUser> {
+    setSession(data: IUser): void;
+    clearSession(): void;
+    markInitialized(): void;
+    fetchSession(): Promise<void>;
+    getUserFactory(): (data: IUser) => T;
+}
+/**
+ * Pinia store for managing user session state.
+ *
+ * This is a generic session store that can be extended with auth-specific
+ * actions (login, signup, etc.) in your application.
+ *
+ * @example
+ * ```typescript
+ * // Use in a component
+ * const session = useSessionStore();
+ *
+ * // Check auth status
+ * if (session.isAuthenticated) {
+ *   console.log(session.user?.name);
+ * }
+ *
+ * // Set session (typically after login)
+ * session.setSession(userData);
+ *
+ * // Clear session (typically after logout)
+ * session.clearSession();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Extend with custom actions
+ * export const useAuthStore = defineStore('auth', {
+ *   ...useSessionStore(),
+ *   actions: {
+ *     async login(email: string, password: string) {
+ *       const response = await authService.login(email, password);
+ *       this.setSession(response.user);
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare const useSessionStore: import("pinia").StoreDefinition<"session", SessionState<IUser>, SessionGetters<IUser>, SessionActions<IUser>>;
+export {};
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/stores/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/stores/sessionStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAIpD;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;AAEnD;;GAEG;AACH,UAAU,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC5C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,KAAK,cAAc,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI;IAC7C,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IACrD,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,UAAU,cAAc,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC9C,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,YAAY,IAAI,IAAI,CAAC;IACrB,eAAe,IAAI,IAAI,CAAC;IACxB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,cAAc,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,eAAe,+GA+F1B,CAAC"}