@hkdigital/lib-core 0.4.12 → 0.4.13

package/dist/util/random/bytes.js

@@ -0,0 +1,72 @@
+/**
+ * bytes.js
+ *
+ * @description
+ * Cross-platform random byte generation utilities using Web Crypto API
+ */
+
+import * as expect from '../expect.js';
+
+/**
+ * Generate cryptographically secure random bytes
+ * - Uses Web Crypto API (works in Node.js 16+ and all modern browsers)
+ * - Returns Uint8Array for maximum compatibility
+ *
+ * @param {number} length - Number of bytes to generate
+ *
+ * @returns {Uint8Array} Random bytes
+ */
+export function randomBytes(length) {
+  expect.positiveNumber(length);
+
+  if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+    // Modern browsers + Node.js 16+
+    return crypto.getRandomValues(new Uint8Array(length));
+  } else if (typeof require !== 'undefined') {
+    // Fallback for older Node.js environments
+    try {
+      const { randomBytes: nodeRandomBytes } = require('crypto');
+      return new Uint8Array(nodeRandomBytes(length));
+    } catch (error) {
+      throw new Error('No secure random generator available');
+    }
+  } else {
+    throw new Error('No secure random generator available');
+  }
+}
+
+/**
+ * Generate random bytes and return as base64 string
+ * - Cross-platform base64 encoding
+ *
+ * @param {number} length - Number of bytes to generate
+ *
+ * @returns {string} Base64 encoded random bytes
+ */
+export function randomBytesBase64(length) {
+  const bytes = randomBytes(length);
+
+  // Convert to base64 using available method
+  if (typeof Buffer !== 'undefined') {
+    // Node.js - most efficient
+    return Buffer.from(bytes).toString('base64');
+  } else {
+    // Browser - use btoa
+    return btoa(String.fromCharCode(...bytes));
+  }
+}
+
+/**
+ * Generate random bytes and return as hex string
+ * - Cross-platform hex encoding
+ *
+ * @param {number} length - Number of bytes to generate
+ *
+ * @returns {string} Hex encoded random bytes
+ */
+export function randomBytesHex(length) {
+  const bytes = randomBytes(length);
+  
+  // Convert to hex string
+  return Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('');
+}

package/dist/util/random.d.ts

@@ -0,0 +1 @@
+export * from "./random/bytes.js";

package/dist/util/random.js

@@ -0,0 +1,9 @@
+/**
+ * Random utilities main export
+ *
+ * @description
+ * This module provides cross-platform random generation utilities
+ * using the Web Crypto API for maximum compatibility.
+ */
+
+export * from './random/bytes.js';

package/dist/util/singleton/index.js

@@ -1,4 +1,4 @@
-import { expect } from '../index.js';
+import * as expect from '../expect.js';
 
 const instancesByNeedle = new Map();
 

package/dist/util/singleton.d.ts

@@ -0,0 +1 @@
+export * from "./singleton/index.js";

package/dist/util/singleton.js

@@ -0,0 +1,8 @@
+/**
+ * Singleton utilities main export
+ *
+ * @description
+ * This module provides singleton pattern utilities.
+ */
+
+export * from './singleton/index.js';

package/dist/util/ssr.d.ts

@@ -0,0 +1 @@
+export * from "./ssr/index.js";

package/dist/util/ssr.js

@@ -0,0 +1,8 @@
+/**
+ * Server-side rendering utilities main export
+ *
+ * @description
+ * This module provides SSR-related utilities for SvelteKit applications.
+ */
+
+export * from './ssr/index.js';

package/dist/util/string/convert.js

@@ -1,4 +1,4 @@
-import * as expect from '../expect/index.js';
+import * as expect from '../expect.js';
 
 /**
  * Remove strange characters from a string and replace whitespace by

package/dist/util/string/index.d.ts

@@ -1,5 +0,0 @@
-export * from "./array-path.js";
-export * from "./convert.js";
-export * from "./fs.js";
-export * from "./interpolate.js";
-export * from "./pad.js";

package/dist/util/string/index.js

@@ -1,5 +0,0 @@
-export * from './array-path.js';
-export * from './convert.js';
-export * from './fs.js';
-export * from './interpolate.js';
-export * from './pad.js';

package/dist/util/string/interpolate.js

@@ -1,4 +1,4 @@
-import * as expect from '../expect/index.js';
+import * as expect from '../expect.js';
 
 import { toArrayPath } from '../array/index.js';
 

package/dist/util/string.d.ts

@@ -0,0 +1,5 @@
+export * from "./string/array-path.js";
+export * from "./string/convert.js";
+export * from "./string/fs.js";
+export * from "./string/interpolate.js";
+export * from "./string/pad.js";

package/dist/util/string.js

@@ -0,0 +1,12 @@
+/**
+ * String utilities main export
+ *
+ * @description
+ * This module provides string manipulation and processing utilities.
+ */
+
+export * from './string/array-path.js';
+export * from './string/convert.js';
+export * from './string/fs.js';
+export * from './string/interpolate.js';
+export * from './string/pad.js';

package/dist/util/svelte/index.d.ts

@@ -1,3 +0,0 @@
-export * as observe from "./observe/index.js";
-export * as stateContext from "../../state/context/state-context.js";
-export * as loading from "./loading/loading-tracker.svelte.js";

package/dist/util/svelte/index.js

@@ -1,4 +0,0 @@
-export * as observe from './observe/index.js';
-export * as stateContext from '../../state/context/state-context.js';
-
-export * as loading from './loading/loading-tracker.svelte.js';

package/dist/util/svelte.d.ts

@@ -0,0 +1,3 @@
+export * from "./svelte/loading/loading-tracker.svelte.js";
+export * from "./svelte/observe/index.js";
+export * from "./svelte/wait/index.js";

package/dist/util/svelte.js

@@ -0,0 +1,11 @@
+/**
+ * Svelte utilities main export
+ *
+ * @description
+ * This module provides Svelte-specific utilities including loading trackers,
+ * observers, and waiting utilities.
+ */
+
+export * from './svelte/loading/loading-tracker.svelte.js';
+export * from './svelte/observe/index.js';
+export * from './svelte/wait/index.js';

package/dist/util/sveltekit/index.d.ts

@@ -1 +0,0 @@
-export * from "./route-folders/index.js";

package/dist/util/sveltekit/index.js

@@ -1 +0,0 @@
-export * from './route-folders/index.js';

package/dist/util/sveltekit/route-folders/index.js

@@ -1,7 +1,7 @@
 import { readdir } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 
-import { kebabToTitleCase, basename } from '../../string/index.js';
+import { kebabToTitleCase, basename } from '../../string.js';
 
 /**
  * Validates if a path is within the project's src/routes directory

package/dist/util/sveltekit.d.ts

@@ -0,0 +1 @@
+export * from "./sveltekit/route-folders/index.js";

package/dist/util/sveltekit.js

@@ -0,0 +1,8 @@
+/**
+ * SvelteKit utilities main export
+ *
+ * @description
+ * This module provides SvelteKit-specific utilities including route management.
+ */
+
+export * from './sveltekit/route-folders/index.js';

package/dist/util/time/index.d.ts

@@ -13,6 +13,13 @@
  * @returns {HkPromise} promise that resolves after a specified timeout
  */
 export function delay(delayOrMinDelayMs: number, maxDelayMs?: number): HkPromise<any>;
+/**
+ * Returns Date.now(), later this method may be extended with time
+ * synchronisaiton
+ *
+ * @return {number} date timestamp
+ */
+export function now(): number;
 /**
  * Get the number of milliseconds since the specified time stamp of the default
  * reference time stamp TIME_2025_01_01

package/dist/util/time/index.js

@@ -85,6 +85,17 @@ export function delay(delayOrMinDelayMs, maxDelayMs) {
 	return promise;
 }
 
+/**
+ * Returns Date.now(), later this method may be extended with time
+ * synchronisaiton
+ *
+ * @return {number} date timestamp
+ */
+export function now()
+{
+  return Date.now();
+}
+
 /**
  * Get the number of milliseconds since the specified time stamp of the default
  * reference time stamp TIME_2025_01_01
@@ -94,7 +105,7 @@ export function delay(delayOrMinDelayMs, maxDelayMs) {
  * @returns {number} number of milliseconds since the specified time
  */
 export function sinceMs(sinceMs = TIME_2025_01_01) {
-	return Date.now() - sinceMs;
+	return now() - sinceMs;
 }
 
 /**

package/dist/util/time.d.ts

@@ -0,0 +1 @@
+export * from "./time/index.js";

package/dist/util/time.js

@@ -0,0 +1 @@
+export * from './time/index.js';

package/dist/util/unique.d.ts

@@ -0,0 +1 @@
+export * from "./unique/index.js";

package/dist/util/unique.js

@@ -0,0 +1,8 @@
+/**
+ * Unique value utilities main export
+ *
+ * @description
+ * This module provides utilities for generating and working with unique values.
+ */
+
+export * from './unique/index.js';

package/dist/valibot/{index.d.ts → valibot.d.ts}

@@ -1,4 +1,3 @@
-export * from "./parsers.js";
-export default valibot;
 export const v: any;
 import * as valibot from 'valibot';
+export { valibot };

package/dist/valibot/{index.js → valibot.js}

@@ -1,9 +1,5 @@
 import * as valibot from 'valibot';
 
-// export * from './date.js';
-
-export * from './parsers.js';
-
 /**
  * Custom parse function that wraps valibot's original parse
  * for better stack trace detection in error logging
@@ -30,5 +26,4 @@ Object.defineProperty(v, 'parse', {
   configurable: true
 });
 
-export { v };
-export default valibot;
+export { v, valibot };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.12",
+	"version": "0.4.13",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"
@@ -77,6 +77,7 @@
 		"@steeze-ui/heroicons": "^2.4.2",
 		"@sveltejs/kit": "^2.28.0",
 		"eslint-plugin-import": "^2.32.0",
+		"jsonwebtoken": "^9.0.0",
 		"pino": "^9.8.0",
 		"pino-pretty": "^13.1.1",
 		"runed": "^0.31.1",
@@ -107,6 +108,7 @@
 		"fake-indexeddb": "^6.1.0",
 		"globals": "^16.3.0",
 		"jsdom": "^26.1.0",
+		"jsonwebtoken": "^9.0.0",
 		"npm-check-updates": "^18.0.2",
 		"npm-run-all": "^4.1.5",
 		"pino": "^9.8.0",

package/dist/auth/errors/jwt.d.ts

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

package/dist/auth/errors/jwt.js

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

package/dist/util/expect/index.d.ts

@@ -1,103 +0,0 @@
-/**
- * Throws a validation error if value is not an Error instance
- *
- * @param {any} value
- */
-export function error_(value: any): void;
-/**
- * Expect a value not to be null
- *
- * @param {any} value
- */
-export function notNull(value: any): void;
-/**
- * Expect a value to be a boolean and true
- *
- * @param {any} value
- */
-export function _true(value: any): void;
-/**
- * Expect a positive number
- *
- * @param {any} value
- */
-export function positiveNumber(value: any): void;
-/**
- * Throws a validation error if value is not a string
- *
- * @param {any} value
- */
-export function notEmptyString(value: any): void;
-/**
- * Throws a validation error if value is not iterable
- *
- * @param {any} value
- */
-export function iterable(value: any): void;
-/**
- * Throws a validation error if value is not a a store (has not subscribe
- * method)
- *
- * @param {any} value
- */
-export function store(value: any): void;
-/**
- * Throws a validation error if value is not an object or the value
- * is an array
- *
- * @param {any} value
- */
-export function objectNoArray(value: any): void;
-/**
- * Throws a validation error if value is not an object or the value
- * is a function
- *
- * @param {any} value
- */
-export function objectNoFunction(value: any): void;
-/**
- * Throws a validation error if value is not an object or null
- *
- * @param {any} value
- */
-export function objectOrNull(value: any): void;
-/**
- * Throws a validation error if value is not an array or Set
- *
- * @param {any} value
- */
-export function arrayOrSet(value: any): void;
-export * from "./arrays.js";
-export * from "./primitives.js";
-export * from "./url.js";
-/**
- * Throws a validation error if value is not an object
- *
- * @param {any} value
- */
-declare function object_(value: any): void;
-/**
- * Throws a validation error if value is not a function
- *
- * @param {any} value
- */
-declare function function_(value: any): void;
-/**
- * Throws a validation error if value is not a Promise
- *
- * @param {any} value
- */
-declare function promise_(value: any): void;
-/**
- * Throws a validation error if value is not a Map
- *
- * @param {any} value
- */
-declare function map_(value: any): void;
-/**
- * Throws a validation error if value is not a Set
- *
- * @param {any} value
- */
-declare function set_(value: any): void;
-export { object_ as object, function_ as function, _function as function, function_ as class, _class as class, promise_ as promise, map_ as map, set_ as set, error_ as error, _true as true, _true as true };