@hkdigital/lib-core 0.5.17 → 0.5.19

package/dist/browser/info/system.js

@@ -0,0 +1,102 @@
+/**
+ * Get simplified platform identifier
+ *
+ * @example
+ * // 'macos', 'windows', 'linux', 'ios', 'android', 'unknown'
+ *
+ * @returns {string} platform identifier
+ */
+export function getPlatform() {
+  const platform = navigator.platform.toLowerCase();
+  const ua = navigator.userAgent.toLowerCase();
+
+  // iOS devices
+  if (/iphone|ipod|ipad/.test(platform)) {
+    return 'ios';
+  }
+
+  // iPadOS (reports as MacIntel but has touch)
+  if (platform === 'macintel' && navigator.maxTouchPoints > 2) {
+    return 'ios';
+  }
+
+  // Android
+  if (/android/.test(ua)) {
+    return 'android';
+  }
+
+  // macOS
+  if (/mac/.test(platform)) {
+    return 'macos';
+  }
+
+  // Windows
+  if (/win/.test(platform)) {
+    return 'windows';
+  }
+
+  // Linux
+  if (/linux/.test(platform)) {
+    return 'linux';
+  }
+
+  return 'unknown';
+}
+
+/**
+ * Get raw platform string from navigator
+ *
+ * @example
+ * // 'MacIntel', 'Win32', 'Linux x86_64', 'iPhone', 'iPad'
+ *
+ * @returns {string} raw platform identifier
+ */
+export function getPlatformRaw() {
+  return navigator.platform;
+}
+
+/**
+ * Get number of CPU cores (logical processors)
+ *
+ * @example
+ * // Desktop: 8, 16, 24
+ * // Mobile: 4, 6, 8
+ * // Older devices: 2
+ *
+ * @returns {number} number of logical processors
+ */
+export function getCpuCores() {
+  return navigator.hardwareConcurrency || 1;
+}
+
+/**
+ * Check if device is online
+ *
+ * @example
+ * // true (connected), false (offline)
+ *
+ * @returns {boolean} true if online
+ */
+export function isOnline() {
+  return navigator.onLine;
+}
+
+/**
+ * Get connection type if available (experimental API)
+ *
+ * @example
+ * // '4g', '3g', 'slow-2g', 'wifi', null
+ *
+ * @returns {string|null} connection type or null
+ */
+export function getConnectionType() {
+  // @ts-ignore
+  const connection =
+    navigator.connection ||
+    // @ts-ignore
+    navigator.mozConnection ||
+    // @ts-ignore
+    navigator.webkitConnection;
+
+  return connection?.effectiveType || null;
+}

package/dist/browser/info/timezone.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Get timezone offset in minutes
+ *
+ * @example
+ * // UTC: 0
+ * // PST (UTC-8): 480
+ * // CET (UTC+1): -60
+ *
+ * @returns {number} timezone offset
+ */
+export function getTimezoneOffset(): number;
+/**
+ * Get timezone name
+ *
+ * @example
+ * // 'America/New_York', 'Europe/Amsterdam', 'Asia/Tokyo'
+ *
+ * @returns {string} timezone identifier
+ */
+export function getTimezone(): string;

package/dist/browser/info/timezone.js

@@ -0,0 +1,25 @@
+/**
+ * Get timezone offset in minutes
+ *
+ * @example
+ * // UTC: 0
+ * // PST (UTC-8): 480
+ * // CET (UTC+1): -60
+ *
+ * @returns {number} timezone offset
+ */
+export function getTimezoneOffset() {
+  return new Date().getTimezoneOffset();
+}
+
+/**
+ * Get timezone name
+ *
+ * @example
+ * // 'America/New_York', 'Europe/Amsterdam', 'Asia/Tokyo'
+ *
+ * @returns {string} timezone identifier
+ */
+export function getTimezone() {
+  return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}

package/dist/browser/info.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @typedef {{
+ *   deviceType?: boolean,
+ *   isMobile?: boolean,
+ *   platform?: boolean,
+ *   browser?: boolean,
+ *   browserEngine?: boolean,
+ *   screenWidth?: boolean,
+ *   screenHeight?: boolean,
+ *   devicePixelRatio?: boolean,
+ *   hasTouch?: boolean,
+ *   language?: boolean,
+ *   timezone?: boolean,
+ *   isPwa?: boolean,
+ *   viewportWidth?: boolean,
+ *   viewportHeight?: boolean,
+ *   orientation?: boolean,
+ *   cpuCores?: boolean,
+ *   connectionType?: boolean
+ * }} BrowserInfoOptions
+ */
+/**
+ * @typedef {import('./typedef.js').BrowserInfo} BrowserInfo
+ */
+/**
+ * Collect browser and device information for analytics/stats
+ *
+ * @param {BrowserInfoOptions} [options] - Enable/disable individual properties
+ *
+ * @returns {BrowserInfo} collected browser information
+ *
+ * @example
+ * // Get all essential info (default)
+ * const info = getBrowserInfo();
+ *
+ * @example
+ * // Get only specific properties
+ * const info = getBrowserInfo({
+ *   deviceType: true,
+ *   platform: true,
+ *   browser: true
+ * });
+ *
+ * @example
+ * // Get essential + extended properties
+ * const info = getBrowserInfo({
+ *   deviceType: true,
+ *   platform: true,
+ *   viewportWidth: true,
+ *   viewportHeight: true,
+ *   orientation: true,
+ *   cpuCores: true
+ * });
+ */
+export function getBrowserInfo(options?: BrowserInfoOptions): BrowserInfo;
+export * from "./info/device.js";
+export * from "./info/display.js";
+export * from "./info/engine.js";
+export * from "./info/language.js";
+export * from "./info/system.js";
+export * from "./info/timezone.js";
+export type BrowserInfoOptions = {
+    deviceType?: boolean;
+    isMobile?: boolean;
+    platform?: boolean;
+    browser?: boolean;
+    browserEngine?: boolean;
+    screenWidth?: boolean;
+    screenHeight?: boolean;
+    devicePixelRatio?: boolean;
+    hasTouch?: boolean;
+    language?: boolean;
+    timezone?: boolean;
+    isPwa?: boolean;
+    viewportWidth?: boolean;
+    viewportHeight?: boolean;
+    orientation?: boolean;
+    cpuCores?: boolean;
+    connectionType?: boolean;
+};
+export type BrowserInfo = import("./typedef.js").BrowserInfo;

package/dist/browser/info.js

@@ -0,0 +1,185 @@
+export * from './info/device.js';
+export * from './info/display.js';
+export * from './info/engine.js';
+export * from './info/language.js';
+export * from './info/system.js';
+export * from './info/timezone.js';
+
+import { getDeviceType, getIsMobile } from './info/device.js';
+import { getBrowserName, getBrowserEngine } from './info/engine.js';
+
+import {
+  getScreenSize,
+  getViewportSize,
+  getDevicePixelRatio,
+  getOrientation,
+  hasTouchSupport,
+  getIsPwa
+} from './info/display.js';
+
+import { getLanguage } from './info/language.js';
+import { getPlatform, getCpuCores, getConnectionType } from './info/system.js';
+import { getTimezone } from './info/timezone.js';
+
+/**
+ * @typedef {{
+ *   deviceType?: boolean,
+ *   isMobile?: boolean,
+ *   platform?: boolean,
+ *   browser?: boolean,
+ *   browserEngine?: boolean,
+ *   screenWidth?: boolean,
+ *   screenHeight?: boolean,
+ *   devicePixelRatio?: boolean,
+ *   hasTouch?: boolean,
+ *   language?: boolean,
+ *   timezone?: boolean,
+ *   isPwa?: boolean,
+ *   viewportWidth?: boolean,
+ *   viewportHeight?: boolean,
+ *   orientation?: boolean,
+ *   cpuCores?: boolean,
+ *   connectionType?: boolean
+ * }} BrowserInfoOptions
+ */
+
+/**
+ * @typedef {import('./typedef.js').BrowserInfo} BrowserInfo
+ */
+
+/**
+ * Collect browser and device information for analytics/stats
+ *
+ * @param {BrowserInfoOptions} [options] - Enable/disable individual properties
+ *
+ * @returns {BrowserInfo} collected browser information
+ *
+ * @example
+ * // Get all essential info (default)
+ * const info = getBrowserInfo();
+ *
+ * @example
+ * // Get only specific properties
+ * const info = getBrowserInfo({
+ *   deviceType: true,
+ *   platform: true,
+ *   browser: true
+ * });
+ *
+ * @example
+ * // Get essential + extended properties
+ * const info = getBrowserInfo({
+ *   deviceType: true,
+ *   platform: true,
+ *   viewportWidth: true,
+ *   viewportHeight: true,
+ *   orientation: true,
+ *   cpuCores: true
+ * });
+ */
+export function getBrowserInfo(options = {}) {
+  // Default to BrowserInfoEssential properties
+  const {
+    deviceType = true,
+    isMobile = true,
+    platform = true,
+    browser = true,
+    browserEngine = true,
+    screenWidth = true,
+    screenHeight = true,
+    devicePixelRatio = true,
+    hasTouch = true,
+    language = true,
+    timezone = true,
+    isPwa = true,
+    // Extended properties (default false)
+    viewportWidth = false,
+    viewportHeight = false,
+    orientation = false,
+    cpuCores = false,
+    connectionType = false
+  } = options;
+
+  const info = {};
+
+  // Device type
+  if (deviceType) {
+    info.deviceType = getDeviceType();
+  }
+
+  // Mobile check
+  if (isMobile) {
+    info.isMobile = getIsMobile();
+  }
+
+  // Platform
+  if (platform) {
+    info.platform = getPlatform();
+  }
+
+  // Browser name
+  if (browser) {
+    info.browser = getBrowserName();
+  }
+
+  // Browser engine
+  if (browserEngine) {
+    info.browserEngine = getBrowserEngine();
+  }
+
+  // Screen dimensions
+  if (screenWidth || screenHeight) {
+    const screenSize = getScreenSize();
+    if (screenWidth) info.screenWidth = screenSize.width;
+    if (screenHeight) info.screenHeight = screenSize.height;
+  }
+
+  // Device pixel ratio
+  if (devicePixelRatio) {
+    info.devicePixelRatio = getDevicePixelRatio();
+  }
+
+  // Touch support
+  if (hasTouch) {
+    info.hasTouch = hasTouchSupport();
+  }
+
+  // Language
+  if (language) {
+    info.language = getLanguage();
+  }
+
+  // Timezone
+  if (timezone) {
+    info.timezone = getTimezone();
+  }
+
+  // PWA
+  if (isPwa) {
+    info.isPwa = getIsPwa();
+  }
+
+  // Viewport dimensions (extended)
+  if (viewportWidth || viewportHeight) {
+    const viewportSize = getViewportSize();
+    if (viewportWidth) info.viewportWidth = viewportSize.width;
+    if (viewportHeight) info.viewportHeight = viewportSize.height;
+  }
+
+  // Orientation (extended)
+  if (orientation) {
+    info.orientation = getOrientation();
+  }
+
+  // CPU cores (extended)
+  if (cpuCores) {
+    info.cpuCores = getCpuCores();
+  }
+
+  // Connection type (extended)
+  if (connectionType) {
+    info.connectionType = getConnectionType();
+  }
+
+  return info;
+}

package/dist/browser/typedef.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Essential browser info
+ */
+export type BrowserInfoEssential = {
+    deviceType?: "phone" | "tablet" | "tv" | "desktop";
+    isMobile?: boolean;
+    platform?: string;
+    browser?: string;
+    browserEngine?: "blink" | "gecko" | "webkit" | "unknown";
+    screenWidth?: number;
+    screenHeight?: number;
+    devicePixelRatio?: number;
+    hasTouch?: boolean;
+    language?: string;
+    timezone?: string;
+    isPwa?: boolean;
+};
+/**
+ * Extended browser info (opt-in)
+ */
+export type BrowserInfoExtended = {
+    viewportWidth?: number;
+    viewportHeight?: number;
+    orientation?: "portrait" | "landscape";
+    cpuCores?: number;
+    connectionType?: string | null;
+};
+/**
+ * Complete browser info (essential + extended)
+ */
+export type BrowserInfo = BrowserInfoEssential & BrowserInfoExtended;

package/dist/browser/typedef.js

@@ -0,0 +1,38 @@
+/**
+ * Essential browser info
+ *
+ * @typedef {{
+ *   deviceType?: 'phone'|'tablet'|'tv'|'desktop',
+ *   isMobile?: boolean,
+ *   platform?: string,
+ *   browser?: string,
+ *   browserEngine?: 'blink'|'gecko'|'webkit'|'unknown',
+ *   screenWidth?: number,
+ *   screenHeight?: number,
+ *   devicePixelRatio?: number,
+ *   hasTouch?: boolean,
+ *   language?: string,
+ *   timezone?: string,
+ *   isPwa?: boolean
+ * }} BrowserInfoEssential
+ */
+
+/**
+ * Extended browser info (opt-in)
+ *
+ * @typedef {{
+ *   viewportWidth?: number,
+ *   viewportHeight?: number,
+ *   orientation?: 'portrait'|'landscape',
+ *   cpuCores?: number,
+ *   connectionType?: string|null
+ * }} BrowserInfoExtended
+ */
+
+/**
+ * Complete browser info (essential + extended)
+ *
+ * @typedef {BrowserInfoEssential & BrowserInfoExtended} BrowserInfo
+ */
+
+export {};

package/dist/config/generators/imagetools.js

@@ -25,38 +25,45 @@ const DEFAULT_PRESETS = {
 	default: {
 		format: 'avif',
 		quality: '90',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	},
 	render: {
 		format: 'jpg',
 		quality: '95',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	},
 	photo: {
 		format: 'jpg',
 		quality: '95',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	},
 	gradient: {
 		format: 'jpg',
 		quality: '95',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	},
 	drawing: {
 		format: 'avif',
 		quality: '90',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	},
 	savedata: {
 		format: 'avif',
 		quality: '85',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	},
 	blur: {
 		format: 'avif',
 		quality: '50',
 		blur: '75',
-		as: 'metadata'
+		as: 'metadata',
+		withMetadata: ''
 	}
 };
 
@@ -115,7 +122,8 @@ export function generateResponseConfigs(options) {
 				return {
 					...configPairs,
 					w: String(w),
-					format: 'png'
+					format: 'png',
+					withMetadata: ''
 				};
 			});
 			// console.log('Returning favicon configs:', faviconConfigs);
@@ -128,7 +136,8 @@ export function generateResponseConfigs(options) {
 				return {
 					...configPairs,
 					w: String(w),
-					format: 'png'
+					format: 'png',
+					withMetadata: ''
 				};
 			});
 			// console.log('Returning apple-touch-icon configs:', appleTouchConfigs);

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

@@ -392,7 +392,7 @@ export async function httpRequest(options) {
 
     if (!isTestEnv) {
       if (cachedResponse) {
-        console.debug(`http:cache-hit [${url.pathname}]`);
+        // console.debug(`http:cache-hit [${url.pathname}]`);
         // console.debug(`cached-response has body: ${!!cachedResponse.body}`);
         // console.debug(`cached-response content-length: ${cachedResponse.headers.get('content-length')}`);
         return cachedResponse;