@hkdigital/lib-core 0.4.11 → 0.4.13

package/dist/auth/jwt.js

@@ -0,0 +1,12 @@
+/**
+ * JWT utilities main export
+ *
+ * @description
+ * This module provides a clean API for JWT operations including signing,
+ * verifying tokens, and generating secret keys.
+ */
+
+export * from './jwt/core.js';
+export * from './jwt/generators.js';
+export * from './jwt/errors.js';
+export * from './jwt/constants.js';

package/dist/config/README.md

@@ -56,6 +56,34 @@ export default defineConfig(
 );
 ```
 
+## PostCSS Configuration
+
+HKdigital projects use a standardized PostCSS configuration that integrates with Tailwind CSS.
+
+### Quick Start
+
+```javascript
+// postcss.config.js
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {}
+  }
+};
+```
+
+**Why this configuration:**
+- Uses the modern `@tailwindcss/postcss` plugin for Tailwind 4+ compatibility
+- Handles CSS processing for the design system and component styles
+- Works seamlessly with SvelteKit and Vite build processes
+
+### Integration
+
+This PostCSS config works together with:
+- `src/app.css` with `@import 'tailwindcss'` directive
+- `tailwind.config.js` with design system extensions
+- Vite configuration for CSS processing
+
+For projects using the complete hkdigital setup, this PostCSS configuration is essential for proper CSS compilation and design system integration.
 
 ## Imagetools Configuration
 

package/dist/design/README.md

@@ -6,6 +6,15 @@ A comprehensive, responsive design system built for SvelteKit applications. This
 
 ### Basic Usage
 
+**1. Import theme CSS in your app.css (REQUIRED for color classes):**
+```css
+/* src/app.css */
+@import 'tailwindcss';
+@import '../node_modules/@hkdigital/lib-core/dist/design/themes/hkdev/theme.css';
+@import '../node_modules/@hkdigital/lib-core/dist/css/utilities.css';
+```
+
+**2. Configure Tailwind:**
 ```javascript
 // tailwind.config.js
 import { 
@@ -35,6 +44,7 @@ export default {
 };
 ```
 
+**3. Add design tokens to your layout:**
 ```html
 <!-- +layout.svelte -->
 <script>
@@ -48,6 +58,8 @@ export default {
 {@render children()}
 ```
 
+**⚠️ Important:** Without the theme CSS import, color classes like `bg-surface-100`, `text-primary-500`, etc. will fail with "Cannot apply unknown utility class" errors during build.
+
 ## CSS Architecture & app.css
 
 ### Overview

package/dist/generic/data/classes/IterableTree.js

@@ -1,6 +1,6 @@
 /* ------------------------------------------------------------------ Imports */
 
-import * as expect from '../../../util/expect/index.js';
+import * as expect from '../../../util/expect.js';
 
 import { PATH_SEPARATOR } from '../../../util/object/index.js';
 

package/dist/generic/data/classes/Selector.js

@@ -28,7 +28,7 @@
 
 /* ------------------------------------------------------------------ Imports */
 
-import * as expect from '../../../util/expect/index.js';
+import * as expect from '../../../util/expect.js';
 
 /* ------------------------------------------------------------------- Export */
 

package/dist/generic/promises/classes/HkPromise.js

@@ -34,7 +34,7 @@
 
 /* ------------------------------------------------------------------ Imports */
 
-import * as expect from '../../../util/expect/index.js';
+import * as expect from '../../../util/expect.js';
 
 import { noop } from '../../../util/function/index.js';
 

package/dist/generic/streaming/classes/ServerEventsStore.js

@@ -2,7 +2,7 @@ import { writable } from 'svelte/store';
 
 // eslint-disable-next-line no-unused-vars
 import * as v from 'valibot';
-import { AbsOrRelUrl } from '../../../valibot/index.js';
+import { AbsOrRelUrl } from '../../../valibot/parsers.js';
 
 import { SubscribersCount } from '../../../state/classes.js';
 

package/dist/generic/typedef.d.ts

@@ -1 +1,3 @@
 export * from "./data/typedef.js";
+declare const _default: {};
+export default _default;

package/dist/generic/typedef.js

@@ -1 +1,3 @@
 export * from './data/typedef.js';
+
+export default {};

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

@@ -3,9 +3,7 @@ import { LEVELS } from '../../constants.js';
 import {
   findRelevantFrameIndex,
   detectErrorMeta,
-  formatErrorDisplay,
-  isMeaningfulFunctionName,
-  parseFunctionName
+  formatErrorDisplay
 } from './formatting.js';
 
 /**
@@ -362,6 +360,8 @@ export class ConsoleAdapter {
 
       let cleaned = trimmed;
 
+      console.log(123, cleaned);
+
       // Convert Chrome format to Firefox format for consistency
       if (isChromeFormat) {
         // "at functionName (url:line:col)" -> "functionName@url:line:col"

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

@@ -27,6 +27,14 @@ export class PinoAdapter {
     this.#projectRoot = import.meta.env.VITE_PROJECT_ROOT || process.cwd();
     const baseOptions = {
       serializers: {
+
+        //
+        // Use 'errors' property to trigger Pino's error serializer
+        // The serializer traverses the error.cause chain and outputs an array
+        // of serialized error objects, which is why we use 'errors' (plural)
+        // instead of Pino's standard 'err' property (which expects a single
+        // error)
+        //
         errors: (err) => {
 
           /** @type {import('./typedef').ErrorSummary[]} */
@@ -194,13 +202,18 @@ export class PinoAdapter {
     // Simplify pnpm paths: node_modules/.pnpm/package@version_deps/node_modules/package
     // becomes: node_modules/package
     const pnpmRegex =
-      /node_modules\/\.pnpm\/([^@\/]+)@[^\/]+\/node_modules\/\1/g;
+      /node_modules\/\.pnpm\/([^@/]+)@[^/]+\/node_modules\/\1/g;
     cleaned = cleaned.replace(pnpmRegex, 'node_modules/$1');
 
     // Also handle cases where the package name might be different in the final path
-    const pnpmRegex2 = /node_modules\/\.pnpm\/[^\/]+\/node_modules\/([^\/]+)/g;
+    const pnpmRegex2 = /node_modules\/\.pnpm\/[^/]+\/node_modules\/([^/]+)/g;
     cleaned = cleaned.replace(pnpmRegex2, 'node_modules/$1');
 
+    // Filter out Node.js internal modules
+    const lines = cleaned.split('\n');
+    const filteredLines = lines.filter(line => !line.includes('node:internal'));
+    cleaned = filteredLines.join('\n');
+
     return cleaned;
   }
 
@@ -217,7 +230,8 @@ export class PinoAdapter {
       timestamp
     };
 
-    // Check if details contains an error and promote it to err property for pino serializer
+    // Check if details contains an error and promote it to error property for
+    // pino serializer
     if (details) {
       if (details instanceof Error) {
         // details is directly an error

package/dist/logging/internal/adapters/pino.js__

@@ -0,0 +1,260 @@
+/**
+ * Pino adapter for server-side logging
+ */
+import pino from 'pino';
+import { dev } from '$app/environment';
+
+import {
+  detectErrorMeta,
+  findRelevantFrameIndex,
+  formatErrorDisplay
+} from './formatting.js';
+
+/**
+ * Pino adapter that bridges Logger events to pino
+ */
+export class PinoAdapter {
+  #projectRoot = null;
+
+  /**
+   * Create a new PinoAdapter
+   *
+   * @param {Object} [options] - Pino configuration options
+   */
+  constructor(options = {}) {
+    // Determine project root once for stack trace cleaning
+    this.#projectRoot = import.meta.env.VITE_PROJECT_ROOT || process.cwd();
+    const baseOptions = {
+      serializers: {
+        errors: (err) => {
+
+          /** @type {import('./typedef').ErrorSummary[]} */
+          const chain = [];
+          let loggedAt = null;
+
+          let current = err;
+          let isFirst = true;
+
+          while (current && current instanceof Error) {
+            // Check if this is the first error and it's a LoggerError - extract logging context
+            if (isFirst && current.name === 'LoggerError') {
+              if (current.stack) {
+                const cleanedStackString = this.#cleanStackTrace(current.stack);
+                const cleanedStackArray = cleanedStackString
+                  .split('\n')
+                  .map((line) => line.trim())
+                  .filter(
+                    (line) =>
+                      line && line !== current.name + ': ' + current.message
+                  );
+
+                // For LoggerError, we know it's a logger.error call, so find the relevant frame
+                const loggerErrorIndex = cleanedStackArray.findIndex(frame =>
+                  (frame.includes('Logger.error') && frame.includes('logger/Logger.js')) ||
+                  (frame.includes('error@') && frame.includes('logger/Logger.js'))
+                );
+
+                if (loggerErrorIndex >= 0 && loggerErrorIndex + 1 < cleanedStackArray.length) {
+                  const relevantFrame = cleanedStackArray[loggerErrorIndex + 1];
+
+                  // Extract function name from the relevant frame
+                  // const functionName = parseFunctionName(relevantFrame);
+
+                  // const errorType = functionName ? `logger.error in ${functionName}` : 'logger.error';
+                  loggedAt = relevantFrame.slice(3); // remove "at "
+                }
+              }
+
+              // Skip the LoggerError and move to the actual error
+              current = current.cause;
+              isFirst = false;
+              continue;
+            }
+            /** @type {import('./typedef').ErrorSummary} */
+            const serialized = {
+              name: current.name,
+              message: current.message
+            };
+
+            // Add error metadata for structured logging and terminal display
+            if (current.stack) {
+              // Convert cleaned stack string to array format expected by formatting functions
+              const cleanedStackString = this.#cleanStackTrace(current.stack);
+              const cleanedStackArray = cleanedStackString
+                .split('\n')
+                .map((line) => line.trim())
+                .filter(
+                  (line) =>
+                    line && line !== current.name + ': ' + current.message
+                );
+
+              const errorMeta = detectErrorMeta(current, cleanedStackArray);
+              const relevantFrameIndex = findRelevantFrameIndex(
+                current,
+                cleanedStackArray
+              );
+
+              serialized.meta = errorMeta;
+              serialized.errorType = formatErrorDisplay(errorMeta);
+
+              // Include stack frames for terminal display
+              serialized.stackFrames = cleanedStackArray
+                .slice(0, 9)
+                .map((frame, index) => {
+                  const marker = index === relevantFrameIndex ? '→' : ' ';
+
+                  return `${marker} ${frame}`;
+                });
+            }
+
+            // Include HttpError-specific properties
+            const httpError = /** @type {import('$lib/network/errors.js').HttpError} */ (current);
+            if (httpError.status !== undefined) {
+              serialized.status = httpError.status;
+            }
+            if (httpError.details !== undefined) {
+              serialized.details = httpError.details;
+            }
+
+            chain.push(serialized);
+            current = current.cause;
+            isFirst = false;
+          }
+
+          return loggedAt ? { chain, loggedAt } : chain;
+        }
+      }
+    };
+
+    // Add error handling for missing pino-pretty in dev
+    if ( dev) {
+      const devOptions = {
+        level: 'debug',
+        transport: {
+          target: 'pino-pretty',
+          options: {
+            colorize: true,
+            ignore: 'hostname,pid'
+          }
+        }
+      };
+
+      try {
+        this.pino = pino({ ...baseOptions, ...devOptions, ...options });
+      } catch (error) {
+        if (
+          error.message.includes('Cannot find module') &&
+          error.message.includes('pino-pretty')
+        ) {
+          const errorMessage = `
+╭─────────────────────────────────────────────────────────────╮
+│                     Missing Dependency                      │
+├─────────────────────────────────────────────────────────────┤
+│  'pino-pretty' is required for development logging          │
+│  Install it with: pnpm add -D pino-pretty                   │
+╰─────────────────────────────────────────────────────────────╯`;
+          console.error(errorMessage);
+          throw new Error('pino-pretty is required for development mode');
+        }
+        throw error;
+      }
+    } else {
+      this.pino = pino({ ...baseOptions, ...options });
+    }
+  }
+
+  /**
+   * Clean stack trace by removing project root path and simplifying node_modules
+   *
+   * @param {string} stack - Original stack trace
+   * @returns {string} Cleaned stack trace
+   */
+  #cleanStackTrace(stack) {
+    if (!stack || !this.#projectRoot) {
+      return stack;
+    }
+
+    let cleaned = stack;
+
+    // Escape special regex characters in the project root path
+    const escapedRoot = this.#projectRoot.replace(
+      /[.*+?^${}()|[\]\\]/g,
+      '\\$&'
+    );
+
+    // Replace project root path with relative path, handling file:// protocol
+    // Match both regular paths and file:// URLs
+    const rootRegex = new RegExp(
+      `(\\s+at\\s+.*\\()(file://)?${escapedRoot}[\\/\\\\]`,
+      'g'
+    );
+    cleaned = cleaned.replace(rootRegex, '$1');
+
+    // Simplify pnpm paths: node_modules/.pnpm/package@version_deps/node_modules/package
+    // becomes: node_modules/package
+    const pnpmRegex =
+      /node_modules\/\.pnpm\/([^@\/]+)@[^\/]+\/node_modules\/\1/g;
+    cleaned = cleaned.replace(pnpmRegex, 'node_modules/$1');
+
+    // Also handle cases where the package name might be different in the final path
+    const pnpmRegex2 = /node_modules\/\.pnpm\/[^\/]+\/node_modules\/([^\/]+)/g;
+    cleaned = cleaned.replace(pnpmRegex2, 'node_modules/$1');
+
+    return cleaned;
+  }
+
+  /**
+   * Handle log events from Logger
+   *
+   * @param {Object} logEvent - Log event from Logger
+   */
+  handleLog(logEvent) {
+    const { level, message, details, source, timestamp } = logEvent;
+
+    const logData = {
+      source,
+      timestamp
+    };
+
+    // Check if details contains an error and promote it to err property for pino serializer
+    if (details) {
+      if (details instanceof Error) {
+        // details is directly an error
+        logData.err = details;
+      } else if (details.error instanceof Error) {
+        // details has an error property
+        logData.err = details.error;
+        // Include other details except the error
+        // eslint-disable-next-line no-unused-vars
+        const { error, ...otherDetails } = details;
+        if (Object.keys(otherDetails).length > 0) {
+          logData.details = otherDetails;
+        }
+      } else {
+        // No error found in details, include all details
+        logData.details = details;
+      }
+    }
+
+    // Check if we have loggedAt info from the serializer
+    if (logData.err && typeof logData.err === 'object' && logData.err.loggedAt) {
+      logData.loggedAt = logData.err.loggedAt;
+      logData.err = logData.err.chain;
+    }
+
+    this.pino[level](logData, message);
+  }
+
+  /**
+   * Create a child logger with additional context
+   *
+   * @param {Object} context - Additional context data
+   * @returns {PinoAdapter} New adapter instance with context
+   */
+  child(context) {
+    const childPino = this.pino.child(context);
+    const adapter = new PinoAdapter();
+    adapter.pino = childPino;
+    return adapter;
+  }
+}

package/dist/logging/internal/test-errors.js

@@ -1,7 +1,8 @@
-import { expect, rethrow } from '../../util/index.js';
+import * as expect from '../../util/expect.js';
+import { rethrow } from '../../util/exceptions.js';
 import { HkPromise } from '../../generic/promises.js';
 import { httpGet } from '../../network/http/index.js';
-import { v } from '../../valibot/index.js';
+import { v } from '../../valibot/valibot.js';
 
 /**
  * Test functions for generating various types of errors for logging demonstration

package/dist/network/http/errors.js

@@ -1,9 +1,9 @@
-import * as expect from '../../util/expect/index.js';
+import * as expect from '../../util/expect.js';
 import { DetailedError } from '../../generic/errors.js';
 
 import { CONTENT_TYPE } from '../../constants/http/index.js';
 
-import { APPLICATION_JSON } from '../../constants/mime/index.js';
+import { APPLICATION_JSON, TEXT_PLAIN } from '../../constants/mime/index.js';
 
 /**
  * Try to get error information from the server error response
@@ -77,8 +77,14 @@ export async function getErrorFromResponse(response) {
 				}
 			}
 		}
-	} else {
-		// For non-JSON responses, always use status text (avoid HTML pages)
+	}
+
+	if (!message && contentType === TEXT_PLAIN ) {
+		message = await response.text();
+	}
+
+	if (!message) {
+		// Final fallback to status text (avoid HTML pages)
 		message = response.statusText || `HTTP ${response.status}`;
 	}
 	// console.log( "message", message );

package/dist/network/http/headers.js

@@ -1,4 +1,4 @@
-import * as expect from '../../util/expect/index.js';
+import * as expect from '../../util/expect.js';
 
 /**
  * Set headers in an existing `Headers` object

package/dist/network/http/http-request.js

@@ -13,7 +13,7 @@ import { CONTENT_TYPE } from '../../constants/http/headers.js';
 
 import { AbortError, TimeoutError } from '../errors/api.js';
 
-import * as expect from '../../util/expect/index.js';
+import * as expect from '../../util/expect.js';
 
 import { toURL } from './url.js';
 import { setRequestHeaders } from './headers.js';

package/dist/network/http/json-request.js

@@ -4,7 +4,7 @@ import { APPLICATION_JSON } from '../../constants/mime/application.js';
 import { CONTENT_TYPE } from '../../constants/http/headers.js';
 import { ResponseError } from '../errors.js';
 
-import * as expect from '../../util/expect/index.js';
+import * as expect from '../../util/expect.js';
 
 import { toURL } from './url.js';
 import { httpRequest } from './http-request.js';

package/dist/network/http/response.js

@@ -1,5 +1,5 @@
 import { ResponseError, HttpError } from '../errors.js';
-import * as expect from '../../util/expect/index.js';
+import * as expect from '../../util/expect.js';
 import { toURL } from './url.js';
 
 import {

package/dist/network/loaders/audio/AudioScene.svelte.js

@@ -1,4 +1,4 @@
-import * as expect from '../../../util/expect/index.js';
+import * as expect from '../../../util/expect.js';
 
 import { LoadingStateMachine } from '../../../state/classes.js';
 

package/dist/network/loaders/image/ImageScene.svelte.js

@@ -1,6 +1,6 @@
 /** @typedef {import('./typedef.js').ImageMeta} ImageMeta */
 
-import * as expect from '../../../util/expect/index.js';
+import * as expect from '../../../util/expect.js';
 
 import { LoadingStateMachine } from '../../../state/classes.js';
 

package/dist/network/loaders/image/utils/index.js

@@ -1,4 +1,4 @@
-import { expect } from '../../../../util/index.js';
+import * as expect from '../../../../util/expect.js';
 
 /**
  * Returns the unchanged image meta object or the last item of

package/dist/network/states/NetworkLoader.svelte.js

@@ -16,7 +16,7 @@ import {
   INITIAL
 } from '../../state/classes/loading-state-machine/constants.js';
 
-import * as expect from '../../util/expect/index.js';
+import * as expect from '../../util/expect.js';
 
 import { httpGet, loadResponseBuffer } from '../http.js';
 

package/dist/network/typedef.d.ts

@@ -2,3 +2,5 @@ export * from "./http/typedef.js";
 export * from "./cache/typedef.js";
 export * from "./states/typedef.js";
 export * from "./loaders/typedef.js";
+declare const _default: {};
+export default _default;

package/dist/network/typedef.js

@@ -7,4 +7,6 @@
 export * from './http/typedef.js';
 export * from './cache/typedef.js';
 export * from './states/typedef.js';
-export * from './loaders/typedef.js';
+export * from './loaders/typedef.js';
+
+export default {};

package/dist/services/service-base/ServiceBase.js

@@ -446,9 +446,7 @@ export class ServiceBase extends EventEmitter {
    * @param {Error} error - Error that occurred
    */
   _setError(operation, error) {
-    const detailedError = new DetailedError(`${operation} failed`, {
-      cause: error
-    });
+    const detailedError = new DetailedError(`${operation} failed`, null, error);
 
     this.error = detailedError;
     this._setState(ERROR_STATE);

package/dist/services/typedef.d.ts

@@ -1,2 +1,4 @@
 export * from "./service-base/typedef.js";
 export * from "./service-manager/typedef.js";
+declare const _default: {};
+export default _default;

package/dist/services/typedef.js

@@ -1,2 +1,4 @@
 export * from './service-base/typedef.js';
 export * from './service-manager/typedef.js';
+
+export default {};

package/dist/state/typedef.d.ts

@@ -0,0 +1,3 @@
+export * from "./context/typedef.js";
+declare const _default: {};
+export default _default;

package/dist/state/typedef.js

@@ -0,0 +1,3 @@
+export * from './context/typedef.js';
+
+export default {};

package/dist/ui/components/drag-drop/drag-state.svelte.d.ts

@@ -1,6 +1,6 @@
-export const createOrGetDragState: (contextKey?: import("../../../state/context/typedef.js").ContextKey) => DragState;
-export const createDragState: (contextKey?: import("../../../state/context/typedef.js").ContextKey) => DragState;
-export const getDragState: (contextKey?: import("../../../state/context/typedef.js").ContextKey) => DragState;
+export const createOrGetDragState: (contextKey?: import("../../../state/typedef.js").ContextKey) => DragState;
+export const createDragState: (contextKey?: import("../../../state/typedef.js").ContextKey) => DragState;
+export const getDragState: (contextKey?: import("../../../state/typedef.js").ContextKey) => DragState;
 export type SimulatedDragEvent = import("../../typedef.js").SimulatedDragEvent;
 /** @typedef {import('../../typedef.js').SimulatedDragEvent} SimulatedDragEvent */
 declare class DragState {

package/dist/ui/components/hk-app-layout/HkAppLayout.state.svelte.d.ts

@@ -1,6 +1,6 @@
 export class AppLayoutState {
     landscapeOnSmallScreen: boolean;
 }
-export const createOrGetState: (contextKey?: import("../../../state/context/typedef").ContextKey) => AppLayoutState;
-export const createState: (contextKey?: import("../../../state/context/typedef").ContextKey) => AppLayoutState;
-export const getState: (contextKey?: import("../../../state/context/typedef").ContextKey) => AppLayoutState;
+export const createOrGetState: (contextKey?: import("../../../state/typedef").ContextKey) => AppLayoutState;
+export const createState: (contextKey?: import("../../../state/typedef").ContextKey) => AppLayoutState;
+export const getState: (contextKey?: import("../../../state/typedef").ContextKey) => AppLayoutState;

package/dist/ui/components/presenter/util.js

@@ -1,6 +1,6 @@
 import { tick } from 'svelte';
 
-import * as expect from '../../../util/expect/index.js';
+import * as expect from '../../../util/expect.js';
 
 import { pushNotEmpty } from '../../../util/array/index.js';