5.1.2

changelog.md

@@ -0,0 +1,57 @@
+# Changelog
+
+## 2024-11-06 - 5.1.2 - fix(appdata)
+Fix iteration over overwriteObject in AppData class
+
+- Corrected the for loop from in to of inside the AppData class for iterating over overwriteObject keys.
+
+## 2024-11-05 - 5.1.1 - fix(AppData)
+Fix issue with overwrite object handling in AppData class
+
+- Corrected logic to handle cases when overwriteObject is undefined.
+
+## 2024-11-05 - 5.1.0 - feat(appdata)
+Add support for overwriting keys using the overwriteObject option in AppData
+
+- Introduced the overwriteObject option in IAppDataOptions to allow overwriting specific keys in the AppData class.
+
+## 2024-06-19 - 5.0.17 - 5.0.23 - Core Updates
+Routine maintenance and updates to the core components.
+
+- Multiple core updates and fixes improving stability
+
+## 2024-06-12 - 5.0.13 - 5.0.16 - Core Updates
+Maintenance focus on core systems with enhancements and problem resolutions.
+
+- Enhancements and updates in the core functionality
+
+## 2024-05-29 - 5.0.13 - Documentation Update
+Descriptive improvements aligned with current features.
+
+- Updated core description for better clarity in documentation
+
+## 2024-04-01 - 5.0.10 - Configuration Update
+Improved configuration management for build processes.
+
+- Updated `npmextra.json` to reflect changes in git repository management
+
+## 2024-02-12 - 5.0.0 - 5.0.9 - Major Core Enhancements
+A series of critical updates with resolved issues in the core components.
+
+- Introduction of new core features
+- Several core system updates
+
+## 2024-02-12 - 4.0.16 - Major Version Transition
+Migration to the new major version with impactful changes.
+
+- BREAKING CHANGE: Significant updates requiring attention for smooth transition
+
+## 2023-08-24 - 3.0.9 - 4.0.16 - Organization Updates
+Formatted updates with attention to organizational standards and practice.
+
+- SWITCH to a new organizational scheme
+
+## 2023-07-11 - 3.0.9 - Organizational Enhancement
+Shifts aligning with contemporary structuring and logistics.
+
+- Strategic realignment with organizational principles

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/npmextra",
-  "version": "5.0.21",
+  "version": "5.1.2",
   "private": false,
   "description": "A utility to enhance npm with additional configuration, tool management capabilities, and a key-value store for project setups.",
   "main": "dist_ts/index.js",

ts/00_commitinfo_data.ts

@@ -1,8 +1,8 @@
 /**
- * autocreated commitinfo by @pushrocks/commitinfo
+ * autocreated commitinfo by @push.rocks/commitinfo
  */
 export const commitinfo = {
   name: '@push.rocks/npmextra',
-  version: '5.0.21',
+  version: '5.1.2',
   description: 'A utility to enhance npm with additional configuration, tool management capabilities, and a key-value store for project setups.'
 }

ts/npmextra.classes.appdata.ts

@@ -2,7 +2,6 @@ import * as plugins from './npmextra.plugins.js';
 import * as paths from './npmextra.paths.js';
 import { KeyValueStore } from './npmextra.classes.keyvaluestore.js';
 
-
 export interface IAppDataOptions<T = any> {
   dirPath?: string;
   requiredKeys?: Array<keyof T>;
@@ -15,7 +14,8 @@ export interface IAppDataOptions<T = any> {
   /**
    * kvStoreKey: 'MY_ENV_VAR'
    */
-  envMapping?: plugins.tsclass.typeFest.PartialDeep<T>
+  envMapping?: plugins.tsclass.typeFest.PartialDeep<T>;
+  overwriteObject?: plugins.tsclass.typeFest.PartialDeep<T>;
 }
 
 export class AppData<T = any> {
@@ -25,7 +25,9 @@ export class AppData<T = any> {
    * @param pathArg
    * @returns
    */
-  public static async createAndInit<T = any>(optionsArg: IAppDataOptions<T> = {}): Promise<AppData<T>> {
+  public static async createAndInit<T = any>(
+    optionsArg: IAppDataOptions<T> = {}
+  ): Promise<AppData<T>> {
     const appData = new AppData<T>(optionsArg);
     await appData.readyDeferred.promise;
     return appData;
@@ -68,27 +70,85 @@ export class AppData<T = any> {
       typeArg: this.options.ephermal ? 'ephemeral' : 'custom',
       identityArg: 'appkv',
       customPath: this.options.dirPath,
-      mandatoryKeys: this.options.requiredKeys as Array<keyof T>
+      mandatoryKeys: this.options.requiredKeys as Array<keyof T>,
     });
 
     if (this.options.envMapping) {
-      const qenvInstance = new plugins.qenv.Qenv(process.cwd(), plugins.path.join(process.cwd(), '.nogit'));
+      const qenvInstance = new plugins.qenv.Qenv(
+        process.cwd(),
+        plugins.path.join(process.cwd(), '.nogit')
+      );
 
       // Recursive function to handle nested objects, now includes key parameter
-      const processEnvMapping = async (key: keyof T, mappingValue: any, parentKey: keyof T | '' = ''): Promise<any> => {
+      const processEnvMapping = async (
+        key: keyof T,
+        mappingValue: any,
+        parentKey: keyof T | '' = ''
+      ): Promise<any> => {
         if (typeof mappingValue === 'string') {
-          let envValue: string | T[keyof T];
-          if (mappingValue.startsWith('hard:')) {
-            envValue = mappingValue.replace('hard:', '') as T[keyof T];
-          } else {
-            envValue = await qenvInstance.getEnvVarOnDemand(mappingValue) as T[keyof T];
+          let envValue: string | boolean | T[keyof T];
+          let convert: 'none' | 'json' | 'base64' | 'boolean' = 'none';
+          switch (true) {
+            case mappingValue.startsWith('hard:'):
+              envValue = mappingValue.replace('hard:', '') as T[keyof T];
+              break;
+            case mappingValue.startsWith('hard_boolean:'):
+              envValue = mappingValue.replace('hard_boolean:', '') === 'true';
+              convert = 'boolean';
+              break;
+            case mappingValue.startsWith('hard_json:'):
+              envValue = JSON.parse(mappingValue.replace('hard_json:', '')) as T[keyof T];
+              convert = 'json';
+              break;
+            case mappingValue.startsWith('hard_base64:'):
+              envValue = Buffer.from(
+                mappingValue.replace('hard_base64:', ''),
+                'base64'
+              ).toString() as T[keyof T];
+              convert = 'base64';
+              break;
+            case mappingValue.startsWith('boolean:'):
+              envValue = (await qenvInstance.getEnvVarOnDemand(
+                mappingValue.replace('boolean:', '')
+              )) as T[keyof T];
+              convert = 'boolean';
+              break;
+            case mappingValue.startsWith('json:'):
+              envValue = (await qenvInstance.getEnvVarOnDemand(
+                mappingValue.replace('json:', '')
+              )) as T[keyof T];
+              convert = 'json';
+              break;
+            case mappingValue.startsWith('base64:'):
+              envValue = (await qenvInstance.getEnvVarOnDemand(
+                mappingValue.replace('base64:', '')
+              )) as T[keyof T];
+              convert = 'base64';
+              break;
+            default:
+              envValue = (await qenvInstance.getEnvVarOnDemand(mappingValue)) as T[keyof T];
+              break;
           }
+
+          // lets format the env value
           if (envValue) {
-            if (typeof envValue === 'string' && mappingValue.endsWith('_JSON')) {
-              envValue = JSON.parse(envValue) as T[keyof T];
+            if (typeof envValue === 'string' && convert === 'boolean') {
+              envValue = envValue === 'true';
+            }
+            if (
+              typeof envValue === 'string' &&
+              (mappingValue.endsWith('_JSON') || convert === 'json')
+            ) {
+              envValue = JSON.parse(envValue as string) as T[keyof T];
+            }
+            if (
+              typeof envValue === 'string' &&
+              (mappingValue.endsWith('_BASE64') || convert === 'base64')
+            ) {
+              envValue = Buffer.from(envValue as string, 'base64').toString();
             }
             if (!parentKey) {
-              await this.kvStore.writeKey(key, envValue);
+              await this.kvStore.writeKey(key, envValue as any);
             } else {
               return envValue;
             }
@@ -116,6 +176,13 @@ export class AppData<T = any> {
       for (const key in this.options.envMapping) {
         await processEnvMapping(key as keyof T, this.options.envMapping[key]);
       }
+
+      if (this.options.overwriteObject) {
+        for (const key of Object.keys(this.options.overwriteObject)) {
+          console.log(`-> heads up: overwriting key ${key} from options.overwriteObject`);
+          await this.kvStore.writeKey(key as keyof T, this.options.overwriteObject[key]);
+        }
+      }
     }
 
     this.readyDeferred.resolve();
@@ -149,4 +216,4 @@ export class AppData<T = any> {
     await this.kvStore.waitForKeysPresent([keyArg]);
     return this.kvStore.readKey(keyArg);
   }
-}
+}