@quvel-kit/core 1.1.0

package/dist/utils/envConfig.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Environment Configuration Utilities
+ *
+ * Type-safe helpers for reading and parsing environment variables
+ * with proper defaults and validation.
+ */
+export interface EnvConfigOptions {
+    /** Environment variables source (defaults to process.env) */
+    env?: Record<string, string | undefined>;
+    /** Throw errors on missing required variables */
+    strict?: boolean;
+}
+/**
+ * Environment configuration parser with type safety
+ */
+export declare class EnvConfig {
+    private readonly env;
+    private readonly strict;
+    constructor(options?: EnvConfigOptions);
+    /**
+     * Get string environment variable with optional default
+     */
+    get(key: string, defaultValue?: string): string;
+    /**
+     * Get the required string environment variable (throws if missing)
+     */
+    getRequired(key: string): string;
+    /**
+     * Get numeric environment variable with default
+     */
+    getNumber(key: string, defaultValue: number): number;
+    /**
+     * Get boolean environment variable with a default
+     *
+     * Treats '1', 'true', 'yes', 'on' as true (case-insensitive)
+     */
+    getBoolean(key: string, defaultValue: boolean): boolean;
+    /**
+     * Get array from comma-separated environment variable
+     */
+    getArray(key: string, defaultValue?: string[]): string[];
+    /**
+     * Get JSON-parsed environment variable
+     */
+    getJson<T = unknown>(key: string, defaultValue: T): T;
+    /**
+     * Check if environment variable exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get all environment variables with a given prefix
+     *
+     * @example
+     * ```ts
+     * env.getWithPrefix('VITE_')
+     * // Returns: { VITE_API_URL: '...', VITE_DEBUG: '...' }
+     * ```
+     */
+    getWithPrefix(prefix: string): Record<string, string>;
+}
+/**
+ * Create a scoped environment configuration helper
+ *
+ * @example
+ * ```ts
+ * const appConfig = createEnvConfig({ prefix: 'APP_' });
+ * const name = appConfig.get('NAME', 'MyApp'); // reads APP_NAME
+ * ```
+ */
+export declare function createEnvConfig(options?: EnvConfigOptions & {
+    prefix?: string;
+}): EnvConfig;
+//# sourceMappingURL=envConfig.d.ts.map

package/dist/utils/envConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envConfig.d.ts","sourceRoot":"","sources":["../../src/utils/envConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,GAAE,gBAAqB;IAK1C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAc/C;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUhC;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAqBpD;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO;IAcvD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE;IAa5D;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC;IAmBrD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;;;;;OAQG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAWtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,SAAS,CA8BX"}

package/dist/utils/envConfig.js

@@ -0,0 +1,161 @@
+/**
+ * Environment Configuration Utilities
+ *
+ * Type-safe helpers for reading and parsing environment variables
+ * with proper defaults and validation.
+ */
+/**
+ * Environment configuration parser with type safety
+ */
+export class EnvConfig {
+    env;
+    strict;
+    constructor(options = {}) {
+        this.env = options.env ?? process.env;
+        this.strict = options.strict ?? false;
+    }
+    /**
+     * Get string environment variable with optional default
+     */
+    get(key, defaultValue) {
+        const value = this.env[key];
+        if (value === undefined) {
+            if (this.strict && defaultValue === undefined) {
+                throw new Error(`Required environment variable ${key} is not defined`);
+            }
+            return defaultValue ?? '';
+        }
+        return value;
+    }
+    /**
+     * Get the required string environment variable (throws if missing)
+     */
+    getRequired(key) {
+        const value = this.env[key];
+        if (value === undefined || value === '') {
+            throw new Error(`Required environment variable ${key} is not defined`);
+        }
+        return value;
+    }
+    /**
+     * Get numeric environment variable with default
+     */
+    getNumber(key, defaultValue) {
+        const value = this.env[key];
+        if (value === undefined) {
+            return defaultValue;
+        }
+        const parsed = parseInt(value, 10);
+        if (isNaN(parsed)) {
+            if (this.strict) {
+                throw new Error(`Environment variable ${key} must be a number, got: ${value}`);
+            }
+            return defaultValue;
+        }
+        return parsed;
+    }
+    /**
+     * Get boolean environment variable with a default
+     *
+     * Treats '1', 'true', 'yes', 'on' as true (case-insensitive)
+     */
+    getBoolean(key, defaultValue) {
+        const value = this.env[key];
+        if (value === undefined) {
+            return defaultValue;
+        }
+        const normalized = value.toLowerCase().trim();
+        return normalized === '1'
+            || normalized === 'true'
+            || normalized === 'yes'
+            || normalized === 'on';
+    }
+    /**
+     * Get array from comma-separated environment variable
+     */
+    getArray(key, defaultValue = []) {
+        const value = this.env[key];
+        if (!value) {
+            return defaultValue;
+        }
+        return value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    /**
+     * Get JSON-parsed environment variable
+     */
+    getJson(key, defaultValue) {
+        const value = this.env[key];
+        if (!value) {
+            return defaultValue;
+        }
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            if (this.strict) {
+                throw new Error(`Failed to parse JSON from environment variable ${key}: ${error}`);
+            }
+            return defaultValue;
+        }
+    }
+    /**
+     * Check if environment variable exists
+     */
+    has(key) {
+        return this.env[key] !== undefined;
+    }
+    /**
+     * Get all environment variables with a given prefix
+     *
+     * @example
+     * ```ts
+     * env.getWithPrefix('VITE_')
+     * // Returns: { VITE_API_URL: '...', VITE_DEBUG: '...' }
+     * ```
+     */
+    getWithPrefix(prefix) {
+        const result = {};
+        for (const [key, value] of Object.entries(this.env)) {
+            if (key.startsWith(prefix) && value !== undefined) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Create a scoped environment configuration helper
+ *
+ * @example
+ * ```ts
+ * const appConfig = createEnvConfig({ prefix: 'APP_' });
+ * const name = appConfig.get('NAME', 'MyApp'); // reads APP_NAME
+ * ```
+ */
+export function createEnvConfig(options = {}) {
+    const { prefix, ...envOptions } = options;
+    if (!prefix) {
+        return new EnvConfig(envOptions);
+    }
+    const config = new EnvConfig(envOptions);
+    return new Proxy(config, {
+        get(target, prop) {
+            if (typeof prop !== 'string') {
+                return target[prop];
+            }
+            const method = target[prop];
+            if (typeof method !== 'function') {
+                return method;
+            }
+            if (['get', 'getRequired', 'getNumber', 'getBoolean', 'getArray', 'getJson', 'has'].includes(prop)) {
+                return function (key, ...args) {
+                    return method.call(target, prefix + key, ...args);
+                };
+            }
+            return method.bind(target);
+        },
+    });
+}

package/dist/utils/error.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Error Utility Functions
+ *
+ * Helper functions for error handling, especially Laravel validation errors
+ */
+import type { AxiosError } from 'axios';
+import type { LaravelErrorResponse, ErrorBag } from '../types/laravel.types.js';
+import type { I18nService } from '../services/I18nService.js';
+/**
+ * Normalize Laravel language key format
+ * Converts Laravel format `module::key` to frontend format `module.key`
+ *
+ * @param key - The key to normalize
+ * @param prefix - Optional prefix to replace
+ * @returns Normalized key
+ */
+export declare function normalizeKey(key: string, prefix?: string): string;
+/**
+ * Error handler context
+ */
+export interface ErrorHandlerContext<Err = unknown> {
+    error: Err;
+    errors: ErrorBag;
+    i18n: I18nService;
+}
+/**
+ * Error handler definition
+ */
+export interface ErrorHandler<Payload = unknown, Err = unknown> {
+    key?: string;
+    matcher?: (payload: Payload) => boolean;
+    callback: (payload: Payload, context: ErrorHandlerContext<Err>) => void;
+}
+/**
+ * Laravel error handler factory
+ *
+ * Handles Laravel validation errors by extracting a message and errors into ErrorBag
+ *
+ * @param userCallBack - Optional callback for additional error handling
+ * @param translate - Whether to translate error messages using i18n
+ * @returns Error handler that processes Laravel errors
+ */
+export declare function LaravelErrorHandler(userCallBack?: (err: AxiosError, context: ErrorHandlerContext<LaravelErrorResponse>) => void, translate?: boolean): ErrorHandler<boolean, LaravelErrorResponse>;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,GAAG,GAAG,OAAO;IAChD,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO,EAAE,GAAG,GAAG,OAAO;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAC5F,SAAS,GAAE,OAAe,GACzB,YAAY,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAoD7C"}

package/dist/utils/error.js

@@ -0,0 +1,67 @@
+/**
+ * Error Utility Functions
+ *
+ * Helper functions for error handling, especially Laravel validation errors
+ */
+/**
+ * Normalize Laravel language key format
+ * Converts Laravel format `module::key` to frontend format `module.key`
+ *
+ * @param key - The key to normalize
+ * @param prefix - Optional prefix to replace
+ * @returns Normalized key
+ */
+export function normalizeKey(key, prefix = '') {
+    return key.replace(`${prefix}::`, `${prefix}.`);
+}
+/**
+ * Laravel error handler factory
+ *
+ * Handles Laravel validation errors by extracting a message and errors into ErrorBag
+ *
+ * @param userCallBack - Optional callback for additional error handling
+ * @param translate - Whether to translate error messages using i18n
+ * @returns Error handler that processes Laravel errors
+ */
+export function LaravelErrorHandler(userCallBack, translate = false) {
+    return {
+        key: 'isAxiosError',
+        matcher: (isAxiosError) => isAxiosError,
+        callback: (_, context) => {
+            const responseData = context.error.response?.data;
+            const { errors } = responseData || {};
+            // Store a message if it's not already in errors
+            if (typeof responseData?.message === 'string') {
+                const normalizedKey = normalizeKey(responseData.message);
+                const translatedMessage = translate && context.i18n.te(normalizedKey)
+                    ? context.i18n.t(normalizedKey)
+                    : responseData.message;
+                const isDuplicate = errors
+                    ? Object.values(errors)
+                        .flat()
+                        .some((msg) => msg.includes(responseData.message ?? ''))
+                    : false;
+                if (!isDuplicate) {
+                    context.errors.set('message', translatedMessage);
+                }
+            }
+            // Store only top-level error keys
+            if (errors) {
+                for (const [key, value] of Object.entries(errors)) {
+                    if (typeof value === 'string') {
+                        const normalizedKey = normalizeKey(value);
+                        context.errors.set(key, translate && context.i18n.te(normalizedKey) ? context.i18n.t(normalizedKey) : value);
+                    }
+                    else if (Array.isArray(value) && value[0] && typeof value[0] === 'string') {
+                        const normalizedKey = normalizeKey(value[0]);
+                        context.errors.set(key, translate && context.i18n.te(normalizedKey)
+                            ? context.i18n.t(normalizedKey)
+                            : value[0]);
+                    }
+                }
+            }
+            // Execute optional callback
+            userCallBack?.(context.error, context);
+        },
+    };
+}

package/dist/utils/headers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * HTTP Headers Utilities
+ *
+ * Centralized header name management matching backend configuration.
+ * All header names are configurable via AppConfig or environment variables.
+ */
+import type { AppConfig } from '../types/app.types.js';
+/**
+ * Get the Accept-Language header name
+ */
+export declare function getAcceptLanguageHeader(config?: AppConfig): string;
+/**
+ * Get X-Trace-ID header name
+ */
+export declare function getTraceIdHeader(config?: AppConfig): string;
+/**
+ * Get X-Tenant-ID header name
+ */
+export declare function getTenantIdHeader(config?: AppConfig): string;
+/**
+ * Get X-SSR-Key header name (for SSR internal requests)
+ */
+export declare function getSsrKeyHeader(config?: AppConfig): string;
+/**
+ * Get X-Platform header name
+ */
+export declare function getPlatformHeader(config?: AppConfig): string;
+/**
+ * Get X-Device-ID header name
+ */
+export declare function getDeviceIdHeader(config?: AppConfig): string;
+/**
+ * Get X-Push-Token header name
+ */
+export declare function getPushTokenHeader(config?: AppConfig): string;
+//# sourceMappingURL=headers.d.ts.map

package/dist/utils/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAavD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAE7D"}

package/dist/utils/headers.js

@@ -0,0 +1,54 @@
+/**
+ * HTTP Headers Utilities
+ *
+ * Centralized header name management matching backend configuration.
+ * All header names are configurable via AppConfig or environment variables.
+ */
+/**
+ * Get the configured header name or default
+ */
+function getHeaderName(configValue, envKey, defaultValue) {
+    return configValue || import.meta.env[envKey] || defaultValue;
+}
+/**
+ * Get the Accept-Language header name
+ */
+export function getAcceptLanguageHeader(config) {
+    return getHeaderName(config?.headers?.acceptLanguage, 'VITE_HEADER_ACCEPT_LANGUAGE', 'Accept-Language');
+}
+/**
+ * Get X-Trace-ID header name
+ */
+export function getTraceIdHeader(config) {
+    return getHeaderName(config?.headers?.traceId, 'VITE_HEADER_TRACE_ID', 'X-Trace-ID');
+}
+/**
+ * Get X-Tenant-ID header name
+ */
+export function getTenantIdHeader(config) {
+    return getHeaderName(config?.headers?.tenantId, 'VITE_HEADER_TENANT_ID', 'X-Tenant-ID');
+}
+/**
+ * Get X-SSR-Key header name (for SSR internal requests)
+ */
+export function getSsrKeyHeader(config) {
+    return getHeaderName(config?.headers?.apiKey, 'VITE_HEADER_SSR_KEY', 'X-SSR-Key');
+}
+/**
+ * Get X-Platform header name
+ */
+export function getPlatformHeader(config) {
+    return getHeaderName(config?.headers?.platform, 'VITE_HEADER_PLATFORM', 'X-Platform');
+}
+/**
+ * Get X-Device-ID header name
+ */
+export function getDeviceIdHeader(config) {
+    return getHeaderName(config?.headers?.deviceId, 'VITE_HEADER_DEVICE_ID', 'X-Device-ID');
+}
+/**
+ * Get X-Push-Token header name
+ */
+export function getPushTokenHeader(config) {
+    return getHeaderName(config?.headers?.pushToken, 'VITE_HEADER_PUSH_TOKEN', 'X-Push-Token');
+}

package/dist/utils/i18n.d.ts

@@ -0,0 +1,26 @@
+/**
+ * I18n Utility Functions
+ *
+ * Helper functions for managing i18n locales and messages
+ */
+import type { QSsrContext } from '@quasar/app-vite';
+import type { I18nType, MessageLanguages } from '../types/i18n.types.js';
+import type { AppConfig } from '../types/app.types.js';
+/**
+ * Validates if a locale is supported
+ */
+export declare function isValidLocale(locale: string, config?: AppConfig): locale is MessageLanguages;
+/**
+ * Retrieves the stored locale from cookies (SSR) or client-side
+ * Falls back to the default locale if no valid locale is found
+ */
+export declare function getStoredLocale(ssrContext?: QSsrContext | null, config?: AppConfig): MessageLanguages;
+/**
+ * Stores the selected locale persistently in cookies
+ */
+export declare function storeLocale(locale: string, config?: AppConfig): void;
+/**
+ * Creates an I18n instance with provided messages
+ */
+export declare function createI18n(messages: Record<string, Record<string, unknown>>, ssrContext?: QSsrContext | null, config?: AppConfig): I18nType;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/utils/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/utils/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,IAAI,gBAAgB,CAE5F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE,SAAS,GACjB,gBAAgB,CAalB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAYpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACjD,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE,SAAS,GACjB,QAAQ,CAQV"}

package/dist/utils/i18n.js

@@ -0,0 +1,56 @@
+/**
+ * I18n Utility Functions
+ *
+ * Helper functions for managing i18n locales and messages
+ */
+import { Cookies } from 'quasar';
+import { createI18n as createI18nInstance } from 'vue-i18n';
+import { getDefaultLocale, getLocaleCookieKey, isValidLocale as isValidLocaleConfig, } from '../config/i18n.js';
+/**
+ * Validates if a locale is supported
+ */
+export function isValidLocale(locale, config) {
+    return isValidLocaleConfig(locale, config);
+}
+/**
+ * Retrieves the stored locale from cookies (SSR) or client-side
+ * Falls back to the default locale if no valid locale is found
+ */
+export function getStoredLocale(ssrContext, config) {
+    const cookieKey = getLocaleCookieKey(config);
+    const defaultLocale = getDefaultLocale(config);
+    let locale;
+    if (ssrContext) {
+        const cookies = Cookies.parseSSR(ssrContext);
+        locale = cookies.get(cookieKey) || '';
+    }
+    else {
+        locale = Cookies.get(cookieKey) || '';
+    }
+    return isValidLocale(locale, config) ? locale : defaultLocale;
+}
+/**
+ * Stores the selected locale persistently in cookies
+ */
+export function storeLocale(locale, config) {
+    if (!isValidLocale(locale, config))
+        return;
+    const cookieKey = getLocaleCookieKey(config);
+    if (typeof document !== 'undefined') {
+        document.cookie = `${cookieKey}=${encodeURIComponent(locale)}; path=/; max-age=31536000;`;
+    }
+    if (typeof window !== 'undefined') {
+        Cookies.set(cookieKey, locale, { expires: 365 });
+    }
+}
+/**
+ * Creates an I18n instance with provided messages
+ */
+export function createI18n(messages, ssrContext, config) {
+    const locale = getStoredLocale(ssrContext, config);
+    return createI18nInstance({
+        locale: locale,
+        messages: messages,
+        legacy: false,
+    });
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility Functions
+ *
+ * Core utilities for configuration management, environment parsing,
+ * and path resolution.
+ */
+export { deepMerge, mergeConfigs, } from './deepMerge.js';
+export { EnvConfig, createEnvConfig, type EnvConfigOptions, } from './envConfig.js';
+export { moduleResource, moduleResources, type ModuleResourceOptions, } from './paths.js';
+export { getAcceptLanguageHeader, getTraceIdHeader, getTenantIdHeader, getSsrKeyHeader, getPlatformHeader, getDeviceIdHeader, getPushTokenHeader, } from './headers.js';
+export { createApiInstance, isValidSessionToken, } from './axios.js';
+export { detectPlatformTags, } from './platform.js';
+export { createDebugInterceptors, type DebugInterceptorOptions, } from './apiInterceptors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,13 @@
+/**
+ * Utility Functions
+ *
+ * Core utilities for configuration management, environment parsing,
+ * and path resolution.
+ */
+export { deepMerge, mergeConfigs, } from './deepMerge.js';
+export { EnvConfig, createEnvConfig, } from './envConfig.js';
+export { moduleResource, moduleResources, } from './paths.js';
+export { getAcceptLanguageHeader, getTraceIdHeader, getTenantIdHeader, getSsrKeyHeader, getPlatformHeader, getDeviceIdHeader, getPushTokenHeader, } from './headers.js';
+export { createApiInstance, isValidSessionToken, } from './axios.js';
+export { detectPlatformTags, } from './platform.js';
+export { createDebugInterceptors, } from './apiInterceptors.js';

package/dist/utils/loading.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Loading Utility
+ *
+ * Wrapper for Quasar's Loading plugin
+ */
+import { type QLoadingShowOptions } from 'quasar';
+/**
+ * Show the loading spinner with an optional auto-hide timeout
+ *
+ * @param timeout - Timeout in milliseconds before hiding automatically (0 = no auto-hide)
+ * @param options - Additional Quasar loading options
+ */
+export declare function showLoading(timeout?: number, options?: QLoadingShowOptions): void;
+/**
+ * Hide the loading spinner
+ */
+export declare function hideLoading(): void;
+/**
+ * Execute a task with a loading spinner displayed during execution
+ *
+ * @param task - The asynchronous task to execute
+ * @param options - Loading spinner options
+ * @returns The result of the task
+ */
+export declare function withLoading<T>(task: () => Promise<T>, options?: {
+    message?: string;
+    timeout?: number;
+}): Promise<T>;
+//# sourceMappingURL=loading.d.ts.map

package/dist/utils/loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../src/utils/loading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAAI,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAU5E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAIlC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/utils/loading.js

@@ -0,0 +1,46 @@
+/**
+ * Loading Utility
+ *
+ * Wrapper for Quasar's Loading plugin
+ */
+import { Loading } from 'quasar';
+/**
+ * Show the loading spinner with an optional auto-hide timeout
+ *
+ * @param timeout - Timeout in milliseconds before hiding automatically (0 = no auto-hide)
+ * @param options - Additional Quasar loading options
+ */
+export function showLoading(timeout = 0, options) {
+    if (typeof window === 'undefined')
+        return;
+    Loading.show({
+        ...options,
+    });
+    if (timeout > 0) {
+        setTimeout(hideLoading, timeout);
+    }
+}
+/**
+ * Hide the loading spinner
+ */
+export function hideLoading() {
+    if (typeof window === 'undefined')
+        return;
+    Loading.hide();
+}
+/**
+ * Execute a task with a loading spinner displayed during execution
+ *
+ * @param task - The asynchronous task to execute
+ * @param options - Loading spinner options
+ * @returns The result of the task
+ */
+export async function withLoading(task, options) {
+    try {
+        showLoading(options?.timeout, { message: options?.message ?? '' });
+        return await task();
+    }
+    finally {
+        hideLoading();
+    }
+}

package/dist/utils/logging.d.ts

@@ -0,0 +1,20 @@
+import type { LoggerInterface, LogLevel } from '../types/logging.types.js';
+import type { AppConfig } from '../types/app.types.js';
+/**
+ * Create a logger instance based on configuration
+ */
+export declare function createLogger(config?: Readonly<AppConfig>): LoggerInterface;
+/**
+ * Log level priority mapping (higher number = higher priority)
+ */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+/**
+ * Get the current log level from environment variables
+ * Defaults to INFO if not specified or invalid
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Determine if a log level should be displayed based on the configured level
+ */
+export declare function shouldLog(level: LogLevel, configuredLevel?: LogLevel): boolean;
+//# sourceMappingURL=logging.d.ts.map