@hkdigital/lib-core 0.3.11 → 0.3.13

package/dist/design/utils/states.js

@@ -1,22 +1,22 @@
-/**
- * Generates state classes from an object of state variables
- *
- * @param {Object.<string, boolean>} stateObject
- *   Object with state names as keys and boolean values
- *
- * @returns {string} Space-separated string of state classes
- *
- * @example
- * // Returns "state-selected state-error"
- * toStateClasses({ selected: true, loading: false, error: true });
- */
-export function toStateClasses(stateObject) {
-  if (!stateObject || typeof stateObject !== 'object') {
-    return '';
-  }
-
-  return Object.entries(stateObject)
-    .filter((entry) => entry[1] === true)
-    .map(([state]) => `state-${state}`)
-    .join(' ');
-}
+/**
+ * Generates state classes from an object of state variables
+ *
+ * @param {Object.<string, boolean>} stateObject
+ *   Object with state names as keys and boolean values
+ *
+ * @returns {string} Space-separated string of state classes
+ *
+ * @example
+ * // Returns "state-selected state-error"
+ * toStateClasses({ selected: true, loading: false, error: true });
+ */
+export function toStateClasses(stateObject) {
+  if (!stateObject || typeof stateObject !== 'object') {
+    return '';
+  }
+
+  return Object.entries(stateObject)
+    .filter((entry) => entry[1] === true)
+    .map(([state]) => `state-${state}`)
+    .join(' ');
+}

package/dist/errors/api.js

@@ -1,9 +1,9 @@
-export class ResponseError extends Error {}
-
-export class AuthenticationError extends Error {}
-
-export class BadRequestError extends Error {}
-
-export class AbortError extends Error {}
-
-export class TimeoutError extends Error {}
+export class ResponseError extends Error {}
+
+export class AuthenticationError extends Error {}
+
+export class BadRequestError extends Error {}
+
+export class AbortError extends Error {}
+
+export class TimeoutError extends Error {}

package/dist/errors/generic.js

@@ -1,20 +1,20 @@
-export class TypeOrValueError extends Error {}
-
-export class InternalError extends Error {}
-
-export class InternalEventOrLogError extends Error {}
-
-export class DetailedError extends Error
-{
-  /**
-   * @param {string} message - Error message
-   * @param {string|{[key: string]: any}|null} [details] - Additional details
-   * @param {Error|string} [cause] - Original error
-   */
-  constructor(message, details, cause ) {
-    super(message);
-    this.name = 'DetailedError';
-    this.details = details ?? null;
-    this.cause = cause;
-  }
-}
+export class TypeOrValueError extends Error {}
+
+export class InternalError extends Error {}
+
+export class InternalEventOrLogError extends Error {}
+
+export class DetailedError extends Error
+{
+  /**
+   * @param {string} message - Error message
+   * @param {string|{[key: string]: any}|null} [details] - Additional details
+   * @param {Error|string} [cause] - Original error
+   */
+  constructor(message, details, cause ) {
+    super(message);
+    this.name = 'DetailedError';
+    this.details = details ?? null;
+    this.cause = cause;
+  }
+}

package/dist/errors/http.js

@@ -1,16 +1,16 @@
-export class HttpError extends Error
-{
-  /**
-   * @param {number} status - HTTP status
-   * @param {string} message - Error message
-   * @param {string|{[key: string]: any}|null} [details] - Additional details
-   * @param {Error|string} [cause] - Original error
-   */
-  constructor(status, message, details, cause ) {
-    super(message);
-    this.status = status;
-    this.name = 'HttpError';
-    this.details = details ?? null;
-    this.cause = cause;
-  }
-}
+export class HttpError extends Error
+{
+  /**
+   * @param {number} status - HTTP status
+   * @param {string} message - Error message
+   * @param {string|{[key: string]: any}|null} [details] - Additional details
+   * @param {Error|string} [cause] - Original error
+   */
+  constructor(status, message, details, cause ) {
+    super(message);
+    this.status = status;
+    this.name = 'HttpError';
+    this.details = details ?? null;
+    this.cause = cause;
+  }
+}

package/dist/errors/index.js

@@ -1,5 +1,5 @@
-export * from './api.js';
-export * from './generic.js';
-export * from './http.js';
-export * from './jwt.js';
-export * from './promise.js';
+export * from './api.js';
+export * from './generic.js';
+export * from './http.js';
+export * from './jwt.js';
+export * from './promise.js';

package/dist/errors/jwt.js

@@ -1,5 +1,5 @@
-export class SecretKeyError extends Error {}
-export class TokenExpiredError extends Error {}
-
-export class JsonWebTokenError extends Error {}
-export class InvalidSignatureError extends Error {}
+export class SecretKeyError extends Error {}
+export class TokenExpiredError extends Error {}
+
+export class JsonWebTokenError extends Error {}
+export class InvalidSignatureError extends Error {}

package/dist/errors/promise.js

@@ -1,26 +1,26 @@
-/**
- * Promise-related error classes
- */
-
-/**
- * Error class specifically for HkPromise operations
- * Provides timeout and cancelled properties with proper type safety
- */
-export class PromiseError extends Error {
-  /**
-   * @param {string} message - Error message
-   * @param {object} [options] - Error options
-   * @param {boolean} [options.timeout=false] - Whether this is a timeout error
-   * @param {boolean} [options.cancelled=false] - Whether this is a cancellation error
-   * @param {Error|*} [options.cause] - Original error or cause
-   * @param {*} [options.details] - Additional details object
-   */
-  constructor(message, options = {}) {
-    super(message);
-    this.name = 'PromiseError';
-    this.timeout = options.timeout ?? false;
-    this.cancelled = options.cancelled ?? false;
-    this.cause = options.cause;
-    this.details = options.details;
-  }
+/**
+ * Promise-related error classes
+ */
+
+/**
+ * Error class specifically for HkPromise operations
+ * Provides timeout and cancelled properties with proper type safety
+ */
+export class PromiseError extends Error {
+  /**
+   * @param {string} message - Error message
+   * @param {object} [options] - Error options
+   * @param {boolean} [options.timeout=false] - Whether this is a timeout error
+   * @param {boolean} [options.cancelled=false] - Whether this is a cancellation error
+   * @param {Error|*} [options.cause] - Original error or cause
+   * @param {*} [options.details] - Additional details object
+   */
+  constructor(message, options = {}) {
+    super(message);
+    this.name = 'PromiseError';
+    this.timeout = options.timeout ?? false;
+    this.cancelled = options.cancelled ?? false;
+    this.cause = options.cause;
+    this.details = options.details;
+  }
 }

package/dist/logging/README.md

@@ -0,0 +1,158 @@
+# Logging
+
+Universal logging utilities for SvelteKit applications with server/client/universal logger factories.
+
+## Installation
+
+```bash
+pnpm add -D pino-pretty
+```
+
+## Usage
+
+```javascript
+import { createServerLogger,
+         createClientLogger,
+         createLogger } from '@hkdigital/lib-core/logging/index.js';
+
+// Server-side logging (uses pino)
+const serverLogger = createServerLogger('app');
+
+// Client-side logging (uses console)
+const clientLogger = createClientLogger('app'); 
+
+// Universal logger (works on both server and client)
+const logger = createLogger('app');
+
+// Log at different levels
+logger.debug('Debug info', { data: 'details' });
+logger.info('Info message');
+logger.warn('Warning message');
+logger.error('Error message', { error: new Error('Something went wrong') });
+```
+
+## SvelteKit Integration
+
+### Server-side logging (src/hooks.server.js)
+
+```javascript
+import { createServerLogger } from '@hkdigital/lib-core/logging/index.js';
+
+let logger;
+
+// Initialize server logging and services
+export async function init() {
+  logger = createServerLogger('server');
+  
+  try {
+    logger.info('Initializing server');
+    
+    // Initialize your services here
+    // const serviceManager = new ServiceManager();
+    // await serviceManager.startAll();
+    
+    logger.info('Server initialization complete');
+  } catch (error) {
+    logger.error('Server initialization failed:', error);
+    throw error;
+  }
+}
+
+// Graceful shutdown
+export async function destroy() {
+  if (logger) {
+    logger.info('Shutting down server');
+    
+    // Clean up services here
+    // if (serviceManager) {
+    //   await serviceManager.stopAll();
+    // }
+  }
+}
+
+/** @type {import('@sveltejs/kit').Handle} */
+export async function handle({ event, resolve }) {
+  const start = Date.now();
+  
+  logger?.info('Request started', {
+    method: event.request.method,
+    url: event.url.pathname,
+    userAgent: event.request.headers.get('user-agent')
+  });
+
+  try {
+    const response = await resolve(event);
+    const duration = Date.now() - start;
+    
+    logger?.info('Request completed', {
+      method: event.request.method,
+      url: event.url.pathname,
+      status: response.status,
+      duration: `${duration}ms`
+    });
+    
+    return response;
+  } catch (error) {
+    logger?.error('Request failed', {
+      method: event.request.method,
+      url: event.url.pathname,
+      error: error.message,
+      stack: error.stack
+    });
+    throw error;
+  }
+}
+```
+
+### Client-side logging (src/hooks.client.js)
+
+```javascript
+import { createClientLogger } from '@hkdigital/lib-core/logging/index.js';
+
+const logger = createClientLogger('client');
+
+/** @type {import('@sveltejs/kit').HandleClientError} */
+export function handleError({ error, event }) {
+  logger.error('Client error occurred', {
+    message: error.message,
+    stack: error.stack,
+    url: event.url?.pathname,
+    userAgent: navigator.userAgent
+  });
+}
+
+// Initialize client-side logging
+export function init() {
+  logger.info('Client application initialized', {
+    userAgent: navigator.userAgent,
+    viewport: `${window.innerWidth}x${window.innerHeight}`
+  });
+  
+  // Log unhandled errors
+  window.addEventListener('error', (event) => {
+    logger.error('Unhandled error', {
+      message: event.error?.message || event.message,
+      filename: event.filename,
+      lineno: event.lineno,
+      colno: event.colno
+    });
+  });
+  
+  // Log unhandled promise rejections
+  window.addEventListener('unhandledrejection', (event) => {
+    logger.error('Unhandled promise rejection', {
+      reason: event.reason
+    });
+  });
+}
+
+// Cleanup when app is destroyed
+export function destroy() {
+  logger.info('Client application destroyed');
+  // Note: Console adapter doesn't require cleanup
+}
+```
+
+## Development
+
+Requires `pino-pretty` as peer dependency for development mode formatting.

package/dist/logging/index.d.ts

@@ -1,4 +1,6 @@
 export { createServerLogger } from "./internal/factories/server.js";
 export { createClientLogger } from "./internal/factories/client.js";
 export { createLogger } from "./internal/factories/universal.js";
-export * from "./internal/unified-logger/index.js";
+export { Logger } from "./internal/logger/index.js";
+export * from "./internal/constants.js";
+export * from "./internal/typedef.js";

package/dist/logging/index.js

@@ -1,7 +1,11 @@
-// Factories
-export { createServerLogger } from './internal/factories/server.js';
-export { createClientLogger } from './internal/factories/client.js';
-export { createLogger } from './internal/factories/universal.js';
-
-// Logger, constants and typedefs
-export * from './internal/unified-logger/index.js';
+// Factories
+export { createServerLogger } from './internal/factories/server.js';
+export { createClientLogger } from './internal/factories/client.js';
+export { createLogger } from './internal/factories/universal.js';
+
+// Logger (advanced usage)
+export { Logger } from './internal/logger/index.js';
+
+// Constants and typedefs
+export * from './internal/constants.js';
+export * from './internal/typedef.js';

package/dist/logging/internal/adapters/console.js

@@ -1,114 +1,114 @@
-import { LEVELS } from '../unified-logger/constants.js';
-
-/**
- * (Browser) console adapter that uses native DevTools styling
- */
-export class ConsoleAdapter {
-  /**
-   * Create a new ConsoleAdapter
-   *
-   * @param {Object} [options] - Browser configuration options
-   * @param {string} [options.level] - Minimum log level
-   * @param {Object} [options.context]
-   *   Additional context data to include with all logs
-   */
-  constructor(options = {}) {
-    this.level = options.level || 'info';
-    this.context = options.context || {};
-  }
-
-  /**
-   * Handle log events from Logger
-   *
-   * @param {Object} logEvent - Log event from Logger
-   */
-  handleLog(logEvent) {
-    // eslint-disable-next-line no-unused-vars
-    const { level, message, details, source, timestamp } = logEvent;
-
-    // Filter by level
-    if (LEVELS[level] < LEVELS[this.level]) {
-      return;
-    }
-
-    // Use browser console styling
-    const styles = this._getStyles(level);
-    const prefix = `%c[${source}]`;
-
-    // Merge context with details
-    const logData = details
-      ? { ...this.context, ...details }
-      : Object.keys(this.context).length > 0
-        ? this.context
-        : undefined;
-
-    if (logData) {
-      console[this._getConsoleMethod(level)](prefix, styles, message, logData);
-    } else {
-      console[this._getConsoleMethod(level)](prefix, styles, message);
-    }
-  }
-
-  /**
-   * Get CSS styles for browser console
-   *
-   * @param {string} level - Log level
-   * @returns {string} CSS styles
-   * @private
-   */
-  _getStyles(level) {
-    const baseStyle =
-      'padding: 2px 4px; border-radius: 2px; font-weight: bold;';
-
-    switch (level) {
-      case 'debug':
-        return `${baseStyle} background: #e3f2fd; color: #1976d2;`;
-      case 'info':
-        return `${baseStyle} background: #e8f5e8; color: #2e7d32;`;
-      case 'warn':
-        return `${baseStyle} background: #fff3e0; color: #f57c00;`;
-      case 'error':
-        return `${baseStyle} background: #ffebee; color: #d32f2f;`;
-      case 'fatal':
-        return `${baseStyle} background: #d32f2f; color: white;`;
-      default:
-        return baseStyle;
-    }
-  }
-
-  /**
-   * Get appropriate console method for log level
-   *
-   * @param {string} level - Log level
-   * @returns {string} Console method name
-   * @private
-   */
-  _getConsoleMethod(level) {
-    switch (level) {
-      case 'debug':
-        return 'debug';
-      case 'info':
-        return 'info';
-      case 'warn':
-        return 'warn';
-      case 'error':
-      case 'fatal':
-        return 'error';
-      default:
-        return 'log';
-    }
-  }
-
-  /**
-   * Create a child logger with additional context
-   *
-   * @param {Object} context - Additional context data
-   * @returns {ConsoleAdapter} New adapter instance with context
-   */
-  child(context) {
-    return new ConsoleAdapter({
-      level: this.level,
-      context: { ...this.context, ...context }
-    });
-  }
-}
+import { LEVELS } from '../constants.js';
+
+/**
+ * (Browser) console adapter that uses native DevTools styling
+ */
+export class ConsoleAdapter {
+  /**
+   * Create a new ConsoleAdapter
+   *
+   * @param {Object} [options] - Browser configuration options
+   * @param {string} [options.level] - Minimum log level
+   * @param {Object} [options.context]
+   *   Additional context data to include with all logs
+   */
+  constructor(options = {}) {
+    this.level = options.level || 'info';
+    this.context = options.context || {};
+  }
+
+  /**
+   * Handle log events from Logger
+   *
+   * @param {Object} logEvent - Log event from Logger
+   */
+  handleLog(logEvent) {
+    // eslint-disable-next-line no-unused-vars
+    const { level, message, details, source, timestamp } = logEvent;
+
+    // Filter by level
+    if (LEVELS[level] < LEVELS[this.level]) {
+      return;
+    }
+
+    // Use browser console styling
+    const styles = this._getStyles(level);
+    const prefix = `%c[${source}]`;
+
+    // Merge context with details
+    const logData = details
+      ? { ...this.context, ...details }
+      : Object.keys(this.context).length > 0
+        ? this.context
+        : undefined;
+
+    if (logData) {
+      console[this._getConsoleMethod(level)](prefix, styles, message, logData);
+    } else {
+      console[this._getConsoleMethod(level)](prefix, styles, message);
+    }
+  }
+
+  /**
+   * Get CSS styles for browser console
+   *
+   * @param {string} level - Log level
+   * @returns {string} CSS styles
+   * @private
+   */
+  _getStyles(level) {
+    const baseStyle =
+      'padding: 2px 4px; border-radius: 2px; font-weight: bold;';
+
+    switch (level) {
+      case 'debug':
+        return `${baseStyle} background: #e3f2fd; color: #1976d2;`;
+      case 'info':
+        return `${baseStyle} background: #e8f5e8; color: #2e7d32;`;
+      case 'warn':
+        return `${baseStyle} background: #fff3e0; color: #f57c00;`;
+      case 'error':
+        return `${baseStyle} background: #ffebee; color: #d32f2f;`;
+      case 'fatal':
+        return `${baseStyle} background: #d32f2f; color: white;`;
+      default:
+        return baseStyle;
+    }
+  }
+
+  /**
+   * Get appropriate console method for log level
+   *
+   * @param {string} level - Log level
+   * @returns {string} Console method name
+   * @private
+   */
+  _getConsoleMethod(level) {
+    switch (level) {
+      case 'debug':
+        return 'debug';
+      case 'info':
+        return 'info';
+      case 'warn':
+        return 'warn';
+      case 'error':
+      case 'fatal':
+        return 'error';
+      default:
+        return 'log';
+    }
+  }
+
+  /**
+   * Create a child logger with additional context
+   *
+   * @param {Object} context - Additional context data
+   * @returns {ConsoleAdapter} New adapter instance with context
+   */
+  child(context) {
+    return new ConsoleAdapter({
+      level: this.level,
+      context: { ...this.context, ...context }
+    });
+  }
+}

package/dist/logging/internal/adapters/index.js

@@ -1,2 +1,2 @@
-export * from './console.js';
-export * from './pino.js';
+export * from './console.js';
+export * from './pino.js';