@quvel-kit/core 1.1.0

package/dist/types/logging.types.js

@@ -0,0 +1,22 @@
+/**
+ * Log levels (RFC 5424 severity levels)
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["EMERGENCY"] = "emergency";
+    LogLevel["ALERT"] = "alert";
+    LogLevel["CRITICAL"] = "critical";
+    LogLevel["ERROR"] = "error";
+    LogLevel["WARNING"] = "warning";
+    LogLevel["NOTICE"] = "notice";
+    LogLevel["INFO"] = "info";
+    LogLevel["DEBUG"] = "debug";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Logger implementation types
+ */
+export var LoggerType;
+(function (LoggerType) {
+    LoggerType["CONSOLE"] = "console";
+    LoggerType["NULL"] = "null";
+})(LoggerType || (LoggerType = {}));

package/dist/types/pinia.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pinia Type Extensions
+ *
+ * Extends Pinia store types to include custom properties added by plugins.
+ */
+
+import 'pinia';
+import type { ServiceContainer } from '../container/ServiceContainer';
+
+declare module 'pinia' {
+  /**
+   * Extend PiniaCustomProperties to add $quvel to all stores
+   */
+  export interface PiniaCustomProperties {
+    /**
+     * Quvel Service Container instance
+     *
+     * Injected by serviceContainerPlugin, provides access to all registered services.
+     */
+    $quvel: ServiceContainer;
+  }
+}
+
+export {};

package/dist/types/scripts.types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Script Loading Types
+ *
+ * Type definitions for dynamic script loading
+ */
+/**
+ * Interface for script loading options
+ */
+export interface ScriptOptions {
+    /**
+     * Auto-load the script on component mount
+     */
+    autoLoad?: boolean;
+    /**
+     * Auto-unload the script on component unmount
+     */
+    autoUnload?: boolean;
+    /**
+     * Callback function to execute after script is loaded
+     */
+    onLoad?: () => void;
+    /**
+     * Callback function to execute after script is unloaded
+     */
+    onUnload?: () => void;
+    /**
+     * Callback function to execute if script loading fails
+     */
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=scripts.types.d.ts.map

package/dist/types/scripts.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.types.d.ts","sourceRoot":"","sources":["../../src/types/scripts.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC"}

package/dist/types/scripts.types.js

@@ -0,0 +1,6 @@
+/**
+ * Script Loading Types
+ *
+ * Type definitions for dynamic script loading
+ */
+export {};

package/dist/types/ssr.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SSR Type Augmentations
+ */
+
+import type { ServiceContainer } from '../container/ServiceContainer.js';
+
+declare module '@quasar/app-vite' {
+  interface QSsrContext {
+    $quvel?: ServiceContainer;
+  }
+}

package/dist/types/task.types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Task Service Types
+ *
+ * Type definitions for the TaskService - manages async operations with
+ * built-in error handling, notifications, and loading indicators.
+ */
+import type { AxiosError } from 'axios';
+import type { ErrorBag, LaravelErrorResponse } from './laravel.types.js';
+import type { ErrorHandler, ErrorHandlerContext } from '../utils/error.js';
+import type { Resolvable } from '../utils/object.js';
+/**
+ * Represents the state of a task
+ */
+export type TaskState = 'fresh' | 'active' | 'success' | 'error';
+/**
+ * Context for success handlers
+ * @template Result The result type of the task
+ */
+export interface SuccessHandlerContext<Result = unknown> {
+    result: Result;
+}
+/**
+ * Base interface for handlers, supporting conditional execution via `matcher`
+ * @template Payload The payload type of the task
+ */
+export interface Handler<Payload = unknown> {
+    key?: string;
+    matcher?: (payload: Payload) => boolean;
+}
+/**
+ * Defines a success handler that processes successful task execution
+ * @template Result The result type of the task
+ * @template Payload The payload type of the task
+ */
+export interface SuccessHandler<Result = unknown, Payload = unknown> extends Handler<Payload> {
+    callback: (payload: Payload, context: SuccessHandlerContext<Result>) => void;
+}
+/**
+ * Allows defining a success callback or a list of success handlers
+ * @template Result The result type of the task
+ * @template Payload The payload type of the task
+ */
+export type SuccessCallbackOrValue<Result = unknown, Payload = unknown> = Array<SuccessHandler<Result, Payload>> | ((result: Result) => unknown);
+/**
+ * Allows defining an error callback or a list of error handlers
+ * @template Err The error type of the task
+ */
+export type ErrorCallbackOrValue<Err = unknown> = Array<ErrorHandler<Err>> | ((error: Err, context: ErrorHandlerContext<Err>) => unknown);
+/**
+ * Callback for Laravel error handler
+ */
+export type ErrorHandlerCallback = (err: AxiosError, context: ErrorHandlerContext<LaravelErrorResponse>) => void;
+/**
+ * Defines the options available when creating a new task
+ *
+ * @template Result The result type of the task
+ * @template Payload The payload type of the task
+ */
+export interface TaskOptions<Result = unknown, Payload = unknown> {
+    /**
+     * The primary function executed when the task runs
+     *
+     * @returns The result of the task function
+     */
+    task: ((payload?: Payload) => Result) | ((payload?: Payload) => Promise<Result>);
+    /**
+     * Optional payload resolver for the task function.
+     * Can be a direct value, a sync or async function.
+     */
+    taskPayload?: Payload | (() => Payload) | (() => Promise<Payload>);
+    /**
+     * Function executed at the end of the task, regardless of success or failure
+     */
+    always?: () => void | Promise<void>;
+    /**
+     * Defines whether to show toast notifications
+     *
+     * Does nothing on SSR.
+     *
+     * If true, gets a message from a task result or the default message.
+     * If a string, uses the string as the message.
+     * If false, does nothing.
+     */
+    showNotification?: {
+        success?: Resolvable<boolean | string>;
+        error?: Resolvable<boolean | string>;
+    };
+    /**
+     * Defines whether to show a loading indicator
+     *
+     * Does nothing on SSR.
+     */
+    showLoading?: Resolvable<boolean>;
+    /**
+     * Configuration options for loading indicator
+     *
+     * Does nothing on SSR.
+     */
+    loadingOptions?: object;
+    /**
+     * Controls whether the task should execute
+     */
+    shouldRun?: Resolvable<boolean>;
+    /**
+     * Handlers executed on successful task execution
+     */
+    successHandlers?: SuccessCallbackOrValue<Result>;
+    /**
+     * Handlers executed when an error occurs
+     */
+    errorHandlers?: ErrorCallbackOrValue;
+    /**
+     * Whether to handle Laravel errors automatically
+     */
+    handleLaravelError?: boolean | {
+        translate?: boolean;
+        userCallBack?: ErrorHandlerCallback;
+    };
+}
+export type { ErrorBag, ErrorHandler, ErrorHandlerContext, Resolvable };
+//# sourceMappingURL=task.types.d.ts.map

package/dist/types/task.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.types.d.ts","sourceRoot":"","sources":["../../src/types/task.types.ts"],"names":[],"mappings":"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"}

package/dist/types/task.types.js

@@ -0,0 +1,7 @@
+/**
+ * Task Service Types
+ *
+ * Type definitions for the TaskService - manages async operations with
+ * built-in error handling, notifications, and loading indicators.
+ */
+export {};

package/dist/types/theme.types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Theme Types and Constants
+ */
+export declare const THEME_COOKIE_NAME: string;
+/**
+ * Define the theme options
+ */
+export declare const themeOptions: readonly ["light", "dark"];
+/**
+ * Type definition for the theme options
+ */
+export type ThemeOptions = (typeof themeOptions)[number];
+//# sourceMappingURL=theme.types.d.ts.map

package/dist/types/theme.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.types.d.ts","sourceRoot":"","sources":["../../src/types/theme.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,eAAO,MAAM,iBAAiB,QAAuB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,YAAY,4BAA6B,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/theme.types.js

@@ -0,0 +1,17 @@
+/**
+ * Theme Types and Constants
+ */
+/**
+ * Get the theme cookie name from env or use default
+ */
+function getThemeCookieName() {
+    const env = (typeof import.meta !== 'undefined' && import.meta.env)
+        ? import.meta.env
+        : (typeof process !== 'undefined' ? process.env : {});
+    return env.VITE_THEME_COOKIE || 'user-theme';
+}
+export const THEME_COOKIE_NAME = getThemeCookieName();
+/**
+ * Define the theme options
+ */
+export const themeOptions = ['light', 'dark'];

package/dist/types/user.types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Base User Interface
+ *
+ * Core user properties that all user implementations should have.
+ * Applications can extend this interface for custom user models.
+ */
+export interface IUser {
+    id: number;
+    name: string;
+    email: string;
+    email_verified_at: string | null;
+    two_factor_enabled?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    avatarUrl?: string;
+}
+/**
+ * User Factory Function Type
+ *
+ * Factory function that creates user instances from API data.
+ * Users can provide their own factory to create custom user models.
+ */
+export type UserFactory<T extends IUser = IUser> = (data: IUser) => T;
+//# sourceMappingURL=user.types.d.ts.map

package/dist/types/user.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.types.d.ts","sourceRoot":"","sources":["../../src/types/user.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,GAAC,IAAI,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC"}

package/dist/types/user.types.js

@@ -0,0 +1 @@
+export {};

package/dist/types/vue-shim.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Vue Component Shims
+ *
+ * Allow TypeScript to recognize .vue files
+ */
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue';
+  const component: DefineComponent;
+  export default component;
+}

package/dist/types/websocket.types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * WebSocket Types
+ *
+ * Type definitions for Laravel Echo WebSocket connections
+ */
+import Echo from 'laravel-echo';
+/**
+ * Handlers for presence channel events
+ */
+export interface PresenceHandlers {
+    /**
+     * Callback when the channel is first connected
+     */
+    onListening?: {
+        event: string;
+        callback: () => void;
+    };
+    /**
+     * Callback when the channel is first connected with current members
+     */
+    onHere?: (members: Record<string, unknown>) => void;
+    /**
+     * Callback when a new member joins the channel
+     */
+    onJoining?: (member: Record<string, unknown>) => void;
+    /**
+     * Callback when a member leaves the channel
+     */
+    onLeaving?: (member: Record<string, unknown>) => void;
+}
+/**
+ * WebSocket channel types
+ */
+export type WebSocketChannelType = 'public' | 'private' | 'presence' | 'encrypted' | 'privateNotification' | 'publicNotification';
+/**
+ * Options for subscribing to a channel
+ */
+export interface SubscribeOptions<T = unknown> {
+    channelName: string;
+    type: WebSocketChannelType;
+    event?: string;
+    callback: (data: T) => unknown;
+    presenceHandlers?: PresenceHandlers;
+}
+/**
+ * Channel type aliases from Laravel Echo
+ */
+export type PublicChannelType = ReturnType<Echo<'pusher'>['channel']>;
+export type PrivateChannelType = ReturnType<Echo<'pusher'>['private']>;
+export type PresenceChannelType = ReturnType<Echo<'pusher'>['join']>;
+export type EncryptedChannelType = ReturnType<Echo<'pusher'>['encryptedPrivate']>;
+/**
+ * Union of all channel types
+ */
+export type AnyChannel = PublicChannelType | PrivateChannelType | PresenceChannelType | EncryptedChannelType;
+/**
+ * Unsubscribe function
+ */
+export type UnsubscribeFn = {
+    unsubscribe: () => void;
+};
+//# sourceMappingURL=websocket.types.d.ts.map

package/dist/types/websocket.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.types.d.ts","sourceRoot":"","sources":["../../src/types/websocket.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,cAAc,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,IAAI,CAAC;KACtB,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAEpD;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAEtD;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,SAAS,GACT,UAAU,GACV,WAAW,GACX,qBAAqB,GACrB,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC"}

package/dist/types/websocket.types.js

@@ -0,0 +1,6 @@
+/**
+ * WebSocket Types
+ *
+ * Type definitions for Laravel Echo WebSocket connections
+ */
+export {};

package/dist/utils/apiInterceptors.d.ts

@@ -0,0 +1,76 @@
+/**
+ * API Interceptors
+ *
+ * Optional debugging interceptors for Axios instance.
+ * Import and use these in your application to add logging for API requests/responses.
+ *
+ * @example
+ * ```typescript
+ * import { createDebugInterceptors } from '@quvel/core';
+ *
+ * // In your boot file or app initialization:
+ * const interceptors = createDebugInterceptors(container.log, container.config);
+ * container.api.instance.interceptors.request.use(
+ *   interceptors.request.onFulfilled,
+ *   interceptors.request.onRejected
+ * );
+ * container.api.instance.interceptors.response.use(
+ *   interceptors.response.onFulfilled,
+ *   interceptors.response.onRejected
+ * );
+ * ```
+ *
+ * @example With hooks
+ * ```typescript
+ * const interceptors = createDebugInterceptors(container.log, container.config, {
+ *   onRequest: (config) => {
+ *     console.log('Custom request logic', config.url);
+ *   },
+ *   onResponse: (response) => {
+ *     console.log('Custom response logic', response.status);
+ *   },
+ * });
+ * ```
+ */
+import type { AxiosResponse, InternalAxiosRequestConfig } from 'axios';
+import type { LogService } from '../services/LogService.js';
+import type { AppConfig } from '../types/app.types.js';
+/**
+ * Options for creating debug interceptors
+ */
+export interface DebugInterceptorOptions {
+    /**
+     * Optional hook called after request is processed but before it's sent
+     * Use this to add custom request logic or logging
+     */
+    onRequest?: (config: InternalAxiosRequestConfig) => void;
+    /**
+     * Optional hook called after response is received
+     * Use this to add custom response logic or logging
+     */
+    onResponse?: (response: AxiosResponse) => void;
+}
+/**
+ * Create debugging interceptors for Axios
+ *
+ * These interceptors will:
+ * - Add trace ID, tenant ID, and platform headers to requests
+ * - Log request/response details via LogService
+ * - Track request timing
+ *
+ * @param log - LogService instance for logging
+ * @param config - AppConfig for header configuration
+ * @param options - Optional hooks for custom logic
+ * @returns Object with request and response interceptor handlers
+ */
+export declare function createDebugInterceptors(log: LogService, config: Readonly<AppConfig>, options?: DebugInterceptorOptions): {
+    request: {
+        onFulfilled: (requestConfig: InternalAxiosRequestConfig) => InternalAxiosRequestConfig<any>;
+        onRejected: (error: Error) => Promise<never>;
+    };
+    response: {
+        onFulfilled: (response: AxiosResponse) => AxiosResponse<any, any, {}>;
+        onRejected: (error: unknown) => Promise<never>;
+    };
+};
+//# sourceMappingURL=apiInterceptors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apiInterceptors.d.ts","sourceRoot":"","sources":["../../src/utils/apiInterceptors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAEzD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAoCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC3B,OAAO,CAAC,EAAE,uBAAuB;;qCAIA,0BAA0B;4BAkCnC,KAAK;;;gCAMD,aAAa;4BAiBjB,OAAO;;EAsBhC"}

package/dist/utils/apiInterceptors.js

@@ -0,0 +1,149 @@
+/**
+ * API Interceptors
+ *
+ * Optional debugging interceptors for Axios instance.
+ * Import and use these in your application to add logging for API requests/responses.
+ *
+ * @example
+ * ```typescript
+ * import { createDebugInterceptors } from '@quvel/core';
+ *
+ * // In your boot file or app initialization:
+ * const interceptors = createDebugInterceptors(container.log, container.config);
+ * container.api.instance.interceptors.request.use(
+ *   interceptors.request.onFulfilled,
+ *   interceptors.request.onRejected
+ * );
+ * container.api.instance.interceptors.response.use(
+ *   interceptors.response.onFulfilled,
+ *   interceptors.response.onRejected
+ * );
+ * ```
+ *
+ * @example With hooks
+ * ```typescript
+ * const interceptors = createDebugInterceptors(container.log, container.config, {
+ *   onRequest: (config) => {
+ *     console.log('Custom request logic', config.url);
+ *   },
+ *   onResponse: (response) => {
+ *     console.log('Custom response logic', response.status);
+ *   },
+ * });
+ * ```
+ */
+import { getTraceIdHeader, getTenantIdHeader, getAcceptLanguageHeader, getPlatformHeader } from './headers.js';
+import { detectPlatformTags } from './platform.js';
+/**
+ * Sanitize headers to avoid logging sensitive data
+ */
+function sanitizeHeaders(headers, config) {
+    const allowedHeaders = [
+        getTraceIdHeader(config),
+        getTenantIdHeader(config),
+        getAcceptLanguageHeader(config),
+        getPlatformHeader(config),
+    ];
+    const sanitized = {};
+    for (const header of allowedHeaders) {
+        if (headers[header]) {
+            sanitized[header] = headers[header];
+        }
+    }
+    // Sanitize sensitive headers
+    if (headers['Cookie']) {
+        sanitized['Cookie'] = '[REDACTED]';
+    }
+    return sanitized;
+}
+/**
+ * Calculate response time from request metadata
+ */
+function getResponseTime(response) {
+    const startTime = response.config.metadata?.startTime;
+    return startTime ? Date.now() - startTime : undefined;
+}
+/**
+ * Create debugging interceptors for Axios
+ *
+ * These interceptors will:
+ * - Add trace ID, tenant ID, and platform headers to requests
+ * - Log request/response details via LogService
+ * - Track request timing
+ *
+ * @param log - LogService instance for logging
+ * @param config - AppConfig for header configuration
+ * @param options - Optional hooks for custom logic
+ * @returns Object with request and response interceptor handlers
+ */
+export function createDebugInterceptors(log, config, options) {
+    return {
+        request: {
+            onFulfilled: (requestConfig) => {
+                const method = requestConfig.method?.toUpperCase() || 'UNKNOWN';
+                const url = requestConfig.url || 'unknown-url';
+                const traceInfo = log.getLogger().getTraceInfo();
+                const traceIdHeader = getTraceIdHeader(config);
+                const tenantIdHeader = getTenantIdHeader(config);
+                const platformHeader = getPlatformHeader(config);
+                requestConfig.headers.set(traceIdHeader, traceInfo.id);
+                if (traceInfo.tenant) {
+                    requestConfig.headers.set(tenantIdHeader, traceInfo.tenant);
+                }
+                const platformTags = detectPlatformTags();
+                if (platformTags) {
+                    requestConfig.headers.set(platformHeader, platformTags);
+                }
+                log.debug(`API Request: ${method} ${url}`, {
+                    method,
+                    url,
+                    baseURL: requestConfig.baseURL,
+                    headers: sanitizeHeaders(requestConfig.headers, config),
+                });
+                // Add timing metadata
+                requestConfig.metadata = { startTime: Date.now() };
+                // Call custom hook if provided
+                options?.onRequest?.(requestConfig);
+                return requestConfig;
+            },
+            onRejected: (error) => {
+                log.error('API Request Error', { error: error.message });
+                return Promise.reject(error);
+            },
+        },
+        response: {
+            onFulfilled: (response) => {
+                const method = response.config.method?.toUpperCase() || 'UNKNOWN';
+                const url = response.config.url || 'unknown-url';
+                log.debug(`API Response: ${method} ${url} ${response.status}`, {
+                    method,
+                    url,
+                    status: response.status,
+                    statusText: response.statusText,
+                    responseTimeMs: getResponseTime(response),
+                });
+                // Call custom hook if provided
+                options?.onResponse?.(response);
+                return response;
+            },
+            onRejected: (error) => {
+                const config = error.config || {};
+                const method = config.method?.toString().toUpperCase() || 'UNKNOWN';
+                const url = config.url?.toString() || 'unknown-url';
+                const response = error.response;
+                const status = response?.status || 0;
+                log.error(`API Error: ${method} ${url} ${status}`, {
+                    method,
+                    url,
+                    status,
+                    statusText: response?.statusText,
+                    responseTimeMs: config.metadata
+                        ? Date.now() - config.metadata.startTime
+                        : undefined,
+                    message: error.message,
+                });
+                return Promise.reject(error);
+            },
+        },
+    };
+}

package/dist/utils/assets.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Asset Loading Utilities
+ *
+ * Helper functions for dynamically loading CSS and JS assets
+ * Support both client-side and SSR asset injection
+ */
+import type { CSSAssetConfig, JSAssetConfig, AppAssets } from '../types/app.types.js';
+/**
+ * Validates if a URL is safe to load as an asset
+ * Prevents loading from potentially malicious sources
+ */
+export declare function isValidAssetUrl(url: string): boolean;
+/**
+ * Sanitizes inline content to prevent XSS attacks
+ * Basic implementation - consider using DOMPurify for more robust protection
+ */
+export declare function sanitizeInlineContent(content: string): string;
+/**
+ * Creates a CSS link or style element from configuration
+ */
+export declare function createCSSElement(config: CSSAssetConfig): HTMLLinkElement | HTMLStyleElement | null;
+/**
+ * Creates a JavaScript script element from configuration
+ */
+export declare function createJSElement(config: JSAssetConfig): HTMLScriptElement | null;
+/**
+ * Injects app assets into the document
+ * Used by client-side asset loading (non-SSR modes)
+ */
+export declare function injectAssets(assets: AppAssets): void;
+/**
+ * Generates HTML strings for server-side asset injection
+ * Used by SSR asset injection
+ */
+export declare function generateAssetHTML(assets: AppAssets): {
+    headHTML: string;
+    bodyStartHTML: string;
+    bodyEndHTML: string;
+};
+//# sourceMappingURL=assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/utils/assets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAuBpD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,GACrB,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAkD3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,GAAG,IAAI,CAgD/E;AA2BD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiEpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CA0GA"}