@hkdigital/lib-core 0.4.31 → 0.4.32

package/dist/util/sveltekit/env/all.d.ts

@@ -13,7 +13,7 @@
  * @param {boolean} [options.autoGroup=true]
  *   Enable automatic prefix grouping
  *
- * @returns {Object} Grouped and parsed combined environment variables
+ * @returns {Record<string, any>} Grouped and parsed combined environment variables
  *
  * @example
  * // Environment variables:
@@ -34,21 +34,10 @@ export function getAllEnv(options?: {
     camelCase?: boolean | undefined;
     parseValues?: boolean | undefined;
     autoGroup?: boolean | undefined;
-}): Object;
-/**
- * Get combined environment variables by prefix
- *
- * @param {string} prefix - Environment variable prefix (e.g., 'DATABASE')
- * @param {Object} [options={}] - Parsing options
- *
- * @returns {Object} Parsed configuration object
- */
-export function getAllEnvByPrefix(prefix: string, options?: Object): Object;
+}): Record<string, any>;
 /**
  * Get raw combined environment variables (no parsing)
  *
- * @returns {Object<string, string>} Raw combined environment variables
+ * @returns {Record<string, string|undefined>} Raw combined environment variables
  */
-export function getRawAllEnv(): {
-    [x: string]: string;
-};
+export function getRawAllEnv(): Record<string, string | undefined>;

package/dist/util/sveltekit/env/all.js

@@ -31,7 +31,7 @@ import { autoGroupEnvByPrefix } from './parsers.js';
  * @param {boolean} [options.autoGroup=true]
  *   Enable automatic prefix grouping
  *
- * @returns {Object} Grouped and parsed combined environment variables
+ * @returns {Record<string, any>} Grouped and parsed combined environment variables
  *
  * @example
  * // Environment variables:
@@ -65,28 +65,10 @@ export function getAllEnv(options = {}) {
   return { ...publicVars, ...privateVars };
 }
 
-/**
- * Get combined environment variables by prefix
- *
- * @param {string} prefix - Environment variable prefix (e.g., 'DATABASE')
- * @param {Object} [options={}] - Parsing options
- *
- * @returns {Object} Parsed configuration object
- */
-export function getAllEnvByPrefix(prefix, options = {}) {
-  const prefixWithUnderscore = prefix.endsWith('_') ? prefix : `${prefix}_`;
-  
-  return getAllEnv({
-    ...options,
-    prefix: prefixWithUnderscore,
-    removePrefix: true
-  });
-}
-
 /**
  * Get raw combined environment variables (no parsing)
  *
- * @returns {Object<string, string>} Raw combined environment variables
+ * @returns {Record<string, string|undefined>} Raw combined environment variables
  */
 export function getRawAllEnv() {
   const publicVars = getRawPublicEnv();

package/dist/util/sveltekit/env/parsers.d.ts

@@ -17,7 +17,7 @@
 /**
  * Parse environment object with type conversion and key transformation
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {Object} [options={}] - Parsing options
  * @param {boolean} [options.camelCase=true]
  *   Convert env var names to camelCase object keys
@@ -27,28 +27,24 @@
  * @param {boolean} [options.removePrefix=true]
  *   Remove prefix from resulting keys
  *
- * @returns {Object} Parsed environment object
+ * @returns {Record<string, any>} Parsed environment object
  */
-export function parseEnv(env: {
-    [x: string]: string;
-}, options?: {
+export function parseEnv(env: Record<string, string | undefined>, options?: {
     camelCase?: boolean | undefined;
     parseValues?: boolean | undefined;
     prefix?: string | undefined;
     removePrefix?: boolean | undefined;
-}): Object;
+}): Record<string, any>;
 /**
  * Parse environment variables by prefix
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {string} prefix - Environment variable prefix (e.g., 'DATABASE')
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Parsed configuration object
+ * @returns {Record<string, any>} Parsed configuration object
  */
-export function parseEnvByPrefix(env: {
-    [x: string]: string;
-}, prefix: string, options?: Object): Object;
+export function parseEnvByPrefix(env: Record<string, string | undefined>, prefix: string, options?: Object): Record<string, any>;
 /**
  * Convert SCREAMING_SNAKE_CASE to camelCase
  *
@@ -72,14 +68,14 @@ export function parseValue(value: string): any;
  * them into configuration objects. All variables with underscores are
  * grouped by their prefix (the part before the first underscore).
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {Object} [options={}] - Parsing options
  * @param {boolean} [options.camelCase=true]
  *   Convert env var names to camelCase object keys
  * @param {boolean} [options.parseValues=true]
  *   Parse string values to numbers/booleans when possible
  *
- * @returns {Object<string, Object>} Grouped environment variables
+ * @returns {Record<string, Record<string, any> | any>} Grouped environment variables
  *
  * @example
  * // Input env vars:
@@ -95,41 +91,31 @@ export function parseValue(value: string): any;
  * //   single: 'value'  // No underscore, stays top-level
  * // }
  */
-export function autoGroupEnvByPrefix(env: {
-    [x: string]: string;
-}, options?: {
+export function autoGroupEnvByPrefix(env: Record<string, string | undefined>, options?: {
     camelCase?: boolean | undefined;
     parseValues?: boolean | undefined;
-}): {
-    [x: string]: Object;
-};
+}): Record<string, Record<string, any> | any>;
 /**
  * Group environment variables by specific prefixes
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {string[]} prefixes - Array of prefixes to group by
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object<string, Object>} Grouped environment variables
+ * @returns {Record<string, Record<string, any>>} Grouped environment variables
  *
  * @example
  * const grouped = groupEnvByPrefixes(env, ['DATABASE', 'REDIS', 'JWT']);
  * // Returns: { database: {...}, redis: {...}, jwt: {...} }
  */
-export function groupEnvByPrefixes(env: {
-    [x: string]: string;
-}, prefixes: string[], options?: Object): {
-    [x: string]: Object;
-};
+export function groupEnvByPrefixes(env: Record<string, string | undefined>, prefixes: string[], options?: Object): Record<string, Record<string, any>>;
 /**
  * Filter environment variables by pattern
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {RegExp|string} pattern - Pattern to match against keys
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Filtered and parsed environment variables
+ * @returns {Record<string, any>} Filtered and parsed environment variables
  */
-export function filterEnvByPattern(env: {
-    [x: string]: string;
-}, pattern: RegExp | string, options?: Object): Object;
+export function filterEnvByPattern(env: Record<string, string | undefined>, pattern: RegExp | string, options?: Object): Record<string, any>;

package/dist/util/sveltekit/env/parsers.js

@@ -18,7 +18,7 @@
 /**
  * Parse environment object with type conversion and key transformation
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {Object} [options={}] - Parsing options
  * @param {boolean} [options.camelCase=true]
  *   Convert env var names to camelCase object keys
@@ -28,7 +28,7 @@
  * @param {boolean} [options.removePrefix=true]
  *   Remove prefix from resulting keys
  *
- * @returns {Object} Parsed environment object
+ * @returns {Record<string, any>} Parsed environment object
  */
 export function parseEnv(env, options = {}) {
   const {
@@ -41,8 +41,8 @@ export function parseEnv(env, options = {}) {
   const result = {};
 
   for (const [key, value] of Object.entries(env || {})) {
-    // Skip if prefix specified and key doesn't match
-    if (prefix && !key.startsWith(prefix)) {
+    // Skip if value is undefined or if prefix specified and key doesn't match
+    if (value === undefined || (prefix && !key.startsWith(prefix))) {
       continue;
     }
 
@@ -73,11 +73,11 @@ export function parseEnv(env, options = {}) {
 /**
  * Parse environment variables by prefix
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {string} prefix - Environment variable prefix (e.g., 'DATABASE')
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Parsed configuration object
+ * @returns {Record<string, any>} Parsed configuration object
  */
 export function parseEnvByPrefix(env, prefix, options = {}) {
   const prefixWithUnderscore = prefix.endsWith('_') ? prefix : `${prefix}_`;
@@ -135,14 +135,14 @@ export function parseValue(value) {
  * them into configuration objects. All variables with underscores are 
  * grouped by their prefix (the part before the first underscore).
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {Object} [options={}] - Parsing options
  * @param {boolean} [options.camelCase=true]
  *   Convert env var names to camelCase object keys
  * @param {boolean} [options.parseValues=true]
  *   Parse string values to numbers/booleans when possible
  *
- * @returns {Object<string, Object>} Grouped environment variables
+ * @returns {Record<string, Record<string, any> | any>} Grouped environment variables
  *
  * @example
  * // Input env vars:
@@ -197,7 +197,7 @@ export function autoGroupEnvByPrefix(env, options = {}) {
 
   // Add remaining variables (no underscore) as top-level properties
   for (const [key, value] of Object.entries(env)) {
-    if (!usedKeys.has(key)) {
+    if (!usedKeys.has(key) && value !== undefined) {
       const finalKey = camelCase ? toCamelCase(key) : key.toLowerCase();
       result[finalKey] = parseValues ? parseValue(value) : value;
     }
@@ -209,11 +209,11 @@ export function autoGroupEnvByPrefix(env, options = {}) {
 /**
  * Group environment variables by specific prefixes
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {string[]} prefixes - Array of prefixes to group by
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object<string, Object>} Grouped environment variables
+ * @returns {Record<string, Record<string, any>>} Grouped environment variables
  *
  * @example
  * const grouped = groupEnvByPrefixes(env, ['DATABASE', 'REDIS', 'JWT']);
@@ -236,19 +236,19 @@ export function groupEnvByPrefixes(env, prefixes, options = {}) {
 /**
  * Filter environment variables by pattern
  *
- * @param {Object<string, string>} env - Raw environment variables
+ * @param {Record<string, string | undefined>} env - Raw environment variables
  * @param {RegExp|string} pattern - Pattern to match against keys
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Filtered and parsed environment variables
+ * @returns {Record<string, any>} Filtered and parsed environment variables
  */
 export function filterEnvByPattern(env, pattern, options = {}) {
   const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
-  /** @type {Object<string, string>} */
+  /** @type {Record<string, string>} */
   const filtered = {};
   
   for (const [key, value] of Object.entries(env || {})) {
-    if (regex.test(key)) {
+    if (regex.test(key) && value !== undefined) {
       filtered[key] = value;
     }
   }

package/dist/util/sveltekit/env/private.d.ts

@@ -13,7 +13,7 @@
  * @param {boolean} [options.autoGroup=true]
  *   Enable automatic prefix grouping
  *
- * @returns {Object} Grouped and parsed private environment variables
+ * @returns {Record<string, any>} Grouped and parsed private environment variables
  *
  * @example
  * // Environment variables:
@@ -36,21 +36,19 @@ export function getPrivateEnv(options?: {
     camelCase?: boolean | undefined;
     parseValues?: boolean | undefined;
     autoGroup?: boolean | undefined;
-}): Object;
+}): Record<string, any>;
 /**
  * Get private environment variables by prefix
  *
  * @param {string} prefix - Environment variable prefix (e.g., 'DATABASE')
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Parsed configuration object
+ * @returns {Record<string, any>} Parsed configuration object
  */
-export function getPrivateEnvByPrefix(prefix: string, options?: Object): Object;
+export function getPrivateEnvByPrefix(prefix: string, options?: Object): Record<string, any>;
 /**
  * Get raw private environment variables (no parsing)
  *
- * @returns {Object<string, string>} Raw private environment variables
+ * @returns {Record<string, string|undefined>} Raw private environment variables
  */
-export function getRawPrivateEnv(): {
-    [x: string]: string;
-};
+export function getRawPrivateEnv(): Record<string, string | undefined>;

package/dist/util/sveltekit/env/private.js

@@ -30,7 +30,7 @@ import { autoGroupEnvByPrefix, parseEnv } from './parsers.js';
  * @param {boolean} [options.autoGroup=true]
  *   Enable automatic prefix grouping
  *
- * @returns {Object} Grouped and parsed private environment variables
+ * @returns {Record<string, any>} Grouped and parsed private environment variables
  *
  * @example
  * // Environment variables:
@@ -65,7 +65,7 @@ export function getPrivateEnv(options = {}) {
  * @param {string} prefix - Environment variable prefix (e.g., 'DATABASE')
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Parsed configuration object
+ * @returns {Record<string, any>} Parsed configuration object
  */
 export function getPrivateEnvByPrefix(prefix, options = {}) {
   const prefixWithUnderscore = prefix.endsWith('_') ? prefix : `${prefix}_`;
@@ -80,8 +80,8 @@ export function getPrivateEnvByPrefix(prefix, options = {}) {
 /**
  * Get raw private environment variables (no parsing)
  *
- * @returns {Object<string, string>} Raw private environment variables
+ * @returns {Record<string, string|undefined>} Raw private environment variables
  */
 export function getRawPrivateEnv() {
   return { ...env };
-}
+}

package/dist/util/sveltekit/env/public.d.ts

@@ -13,7 +13,7 @@
  * @param {boolean} [options.autoGroup=true]
  *   Enable automatic prefix grouping
  *
- * @returns {Object} Grouped and parsed public environment variables
+ * @returns {Record<string, any>} Grouped and parsed public environment variables
  *
  * @example
  * // Environment variables:
@@ -32,21 +32,19 @@ export function getPublicEnv(options?: {
     camelCase?: boolean | undefined;
     parseValues?: boolean | undefined;
     autoGroup?: boolean | undefined;
-}): Object;
+}): Record<string, any>;
 /**
  * Get public environment variables by prefix
  *
  * @param {string} prefix - Environment variable prefix (e.g., 'PUBLIC_API')
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Parsed configuration object
+ * @returns {Record<string, any>} Parsed configuration object
  */
-export function getPublicEnvByPrefix(prefix: string, options?: Object): Object;
+export function getPublicEnvByPrefix(prefix: string, options?: Object): Record<string, any>;
 /**
  * Get raw public environment variables (no parsing)
  *
- * @returns {Object<string, string>} Raw public environment variables
+ * @returns {Record<string, string>} Raw public environment variables
  */
-export function getRawPublicEnv(): {
-    [x: string]: string;
-};
+export function getRawPublicEnv(): Record<string, string>;

package/dist/util/sveltekit/env/public.js

@@ -29,7 +29,7 @@ import { autoGroupEnvByPrefix, parseEnv } from './parsers.js';
  * @param {boolean} [options.autoGroup=true]
  *   Enable automatic prefix grouping
  *
- * @returns {Object} Grouped and parsed public environment variables
+ * @returns {Record<string, any>} Grouped and parsed public environment variables
  *
  * @example
  * // Environment variables:
@@ -60,7 +60,7 @@ export function getPublicEnv(options = {}) {
  * @param {string} prefix - Environment variable prefix (e.g., 'PUBLIC_API')
  * @param {Object} [options={}] - Parsing options
  *
- * @returns {Object} Parsed configuration object
+ * @returns {Record<string, any>} Parsed configuration object
  */
 export function getPublicEnvByPrefix(prefix, options = {}) {
   const prefixWithUnderscore = prefix.endsWith('_') ? prefix : `${prefix}_`;
@@ -75,7 +75,7 @@ export function getPublicEnvByPrefix(prefix, options = {}) {
 /**
  * Get raw public environment variables (no parsing)
  *
- * @returns {Object<string, string>} Raw public environment variables
+ * @returns {Record<string, string>} Raw public environment variables
  */
 export function getRawPublicEnv() {
   return { ...env };

package/dist/util/sveltekit/env-all.d.ts

@@ -1 +1 @@
-export { getAllEnv, getAllEnvByPrefix, getRawAllEnv } from "./env/all.js";
+export { getAllEnv, getRawAllEnv } from "./env/all.js";

package/dist/util/sveltekit/env-all.js

@@ -6,14 +6,12 @@
  * imports private environment variables.
  *
  * @example
- * import { getAllEnv, getAllEnvByPrefix } from './env-all.js';
+ * import { getAllEnv } from './env-all.js';
  *
  * const allVars = getAllEnv();
- * const dbConfig = getAllEnvByPrefix('DATABASE');
  */
 
 export {
   getAllEnv,
-  getAllEnvByPrefix,
   getRawAllEnv
-} from './env/all.js';
+} from './env/all.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.31",
+	"version": "0.4.32",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"