qcobjects 2.5.141-beta → 2.5.142

package/.github/workflows/npmpublish.yml

@@ -0,0 +1,47 @@
+name: Node.js Publish
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          ref: ${{ github.ref }}
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+      - run: npm i --legacy-peer-deps
+      - run: npm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          ref: ${{ github.ref }}
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+      - name: Upgrade npm for OIDC support (requires >=11.5.1)
+        run: npm install -g npm@latest
+      - run: npm i --legacy-peer-deps
+      - name: Publish to npm
+        run: |
+          if [[ "${{ github.ref }}" == *-beta ]]; then
+            npm publish --tag beta
+          elif [[ "${{ github.ref }}" == *-lts ]]; then
+            npm publish --tag lts
+          else
+            npm publish
+          fi

package/VERSION

@@ -1 +1 @@
-2.5.141-beta
+2.5.142

package/build/CONFIG.js

@@ -65,7 +65,12 @@ class CONFIG extends InheritClass_1.InheritClass {
             Logger_1.logger.debug("No config value for: " + name);
             _value = _default;
         }
-        return Processor_1.GlobalProcessor.processObject(_value) || _default;
+        const processedValue = Processor_1.GlobalProcessor.processObject(_value);
+        // Special handling for null values
+        if (_value === null && processedValue === null) {
+            return null;
+        }
+        return processedValue || _default;
     }
     static _instance;
     static get instance() {

package/build/Processor.js

@@ -31,16 +31,30 @@ class Processor extends InheritClass_1.InheritClass {
         }
         return Processor._instance;
     }
+    static setProcessor(_proc_) {
+        if (typeof _proc_ === "function" && _proc_.name !== "") {
+            Processor.instance.processors[_proc_.name] = _proc_;
+        }
+    }
     setProcessor(_proc_) {
         if (typeof _proc_ === "function" && _proc_.name !== "") {
             this.processors[_proc_.name] = _proc_;
         }
     }
+    static getProcessor(_procName_) {
+        return Processor.instance.processors[_procName_];
+    }
+    static getProcessorNames() {
+        return Object.keys(Processor.instance.processors);
+    }
     component;
     execute(component, processorName, args) {
         const processorHandler = (typeof component !== "undefined" && component !== null) ? (component.processorHandler) : (this);
         return processorHandler?.processors[processorName].bind(processorHandler).apply(processorHandler, [component, args?.split(",")]);
     }
+    static process(template, component = null) {
+        return Processor.instance.process(template, component);
+    }
     process(template, component = null) {
         const processorHandler = (component !== null) ? (component.processorHandler) : ((0, New_1.New)(Processor, { component: null }));
         if (typeof template === "string") {
@@ -54,7 +68,17 @@ class Processor extends InheritClass_1.InheritClass {
         }
         return template;
     }
+    static processObject(obj, component) {
+        if (obj === null || obj === undefined) {
+            return obj;
+        }
+        return Processor.instance.processObject(obj, component);
+    }
     processObject(obj, component = null) {
+        // If obj is null or undefined, return it as is
+        if (obj === null || obj === undefined) {
+            return obj;
+        }
         let __instance__ = (component === null) ? (this) : (component.processorHandler);
         if (typeof __instance__ === "undefined") {
             __instance__ = new Processor({ component });

package/framework-audit-v2.5.141-beta.md

@@ -0,0 +1,184 @@
+> **Note**: This documentation was generated with the assistance of AI. While we strive for accuracy, please verify critical information and consult the official QCObjects repository for the most up-to-date documentation.
+
+# QCObjects Framework Audit
+
+## Overview
+QCObjects is an open-source framework designed for full-stack development with a focus on micro-services and micro-frontends in an N-Tier architecture. This audit analyzes both the core framework and its CLI tools.
+
+## Version Information
+- Core Package: 2.5.141-beta
+- CLI Package: 2.5.105-beta
+- License: LGPL-3.0
+
+## Core Framework Analysis
+
+### 1. Project Structure & Distribution
+- Multiple module format support:
+  - CommonJS (cjs)
+  - ES Modules (esm)
+  - Browser bundle
+- TypeScript support with type definitions
+- Flexible exports configuration
+
+### 2. Build & Development Tools
+- TypeScript-based project
+- ESBuild for bundling
+- Multiple build scripts:
+  - TypeScript compilation
+  - Type definitions generation
+  - Browser bundle creation
+- Testing framework: Jasmine
+- Linting: ESLint with TypeScript support
+
+### 3. Development Requirements
+- Node.js ≥ 22
+- npm ≥ 10
+- Modern tooling stack
+
+### 4. Core Architecture Components
+
+#### Source Code Structure
+```typescript
+// MVC Implementation
+- Controller.ts (2.9KB)
+- View.ts (542B)
+- Component.ts (54KB)
+
+// Component System
+- Component.ts (54KB)
+- ComponentFactory.ts (6.1KB)
+- componentLoader.ts (12KB)
+
+// Service Layer
+- Service.ts (3.6KB)
+- BackendMicroservice.ts (8.4KB)
+- serviceLoader.ts (13KB)
+
+// Security
+- Crypt.ts (2.8KB)
+- Base64.ts (2.6KB)
+- secretKey.ts (113B)
+
+// Core Architecture
+- Class.ts (9.2KB)
+- InheritClass.ts (7.7KB)
+- ClassFactory.ts (1.6KB)
+- MainProcess.ts (17KB)
+
+// Platform Support
+- platform.ts (1.1KB)
+- basePath.ts (613B)
+- domain.ts (132B)
+
+// Data Management
+- DataStringify.ts (556B)
+- ComplexStorageCache.ts (2.9KB)
+- PrimaryCollections.ts (3.1KB)
+- ArrayCollection.ts (3.6KB)
+```
+
+## CLI Tools Analysis
+
+### 1. Command Line Interface
+```bash
+# Main Commands
+qcobjects create <appname> [options]  # Create new applications
+qcobjects publish <appname>          # Publish applications
+qcobjects generate-sw <appname>      # Generate service workers
+qcobjects launch <appname>           # Launch applications
+```
+
+### 2. Project Generation Features
+```bash
+# Progressive Web App Creation
+qcobjects create mynewapp --pwa
+
+# Accelerated Mobile Pages
+qcobjects create mynewapp --amp
+```
+
+### 3. Server Integration
+- HTTP/2 server configuration: `/etc/qcobjects/config.json`
+- Service management:
+```bash
+service qcobjects status
+service qcobjects start
+service qcobjects stop
+service qcobjects restart
+```
+
+## Strengths and Weaknesses
+
+### Strengths
+1. **Component System**
+   - Robust component architecture
+   - Sophisticated lifecycle management
+   - Efficient component loading
+
+2. **Development Tooling**
+   - Comprehensive CLI support
+   - Built-in HTTP/2 server
+   - Multiple project templates
+
+3. **Architecture**
+   - Clear separation of concerns
+   - Modular design
+   - Type safety support
+
+4. **Build System**
+   - Multiple module format support
+   - Modern bundling with ESBuild
+   - TypeScript integration
+
+### Weaknesses
+1. **Node.js Version Requirement**
+   - Requires Node.js ≥ 22 (currently in development)
+   - May limit adoption in production environments
+
+2. **Documentation-Implementation Gap**
+   - Some features are more sophisticated than documented
+   - Others are less robust than suggested
+
+3. **Backend Features**
+   - Limited backend service templates
+   - Basic microservice scaffolding
+   - Needs more robust backend tooling
+
+4. **Cross-Platform Support**
+   - Browser-centric implementation
+   - Limited platform-specific optimizations
+
+## Recommendations
+
+### 1. Documentation Improvements
+- Better integration of CLI documentation
+- More comprehensive API documentation
+- Clear separation of browser vs Node.js features
+- Better documentation of limitations and requirements
+
+### 2. Technical Enhancements
+- Reduce Node.js version requirement
+- Enhance backend microservices capabilities
+- Strengthen cross-platform support
+- Add more robust security features
+
+### 3. Architecture Alignment
+- Better balance between frontend and backend features
+- More comprehensive N-Tier architecture support
+- Enhanced PWA feature implementation
+
+### 4. Development Workflow
+- Add more project templates
+- Improve testing infrastructure
+- Enhance microservice development tools
+- Better integration with modern development workflows
+
+## Conclusion
+QCObjects shows promise as a full-stack framework with strong frontend capabilities. While it provides good tooling and component architecture, it needs improvements in backend support and cross-platform capabilities. The high Node.js version requirement may limit its immediate adoption in production environments.
+
+The framework is actively maintained and shows good engineering practices, but could benefit from better alignment between documentation and implementation, particularly in areas of backend support and cross-platform capabilities.
+
+## Version Information
+- Audit Date: March 2024
+- Framework Version: 2.5.141-beta
+- CLI Version: 2.5.105-beta 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qcobjects",
-  "version": "2.5.141-beta",
+  "version": "2.5.142",
   "description": "QCObjects is an Open-source framework that empowers full-stack developers to make micro-services and micro-frontends into an N-Tier architecture.",
   "main": "public/cjs/index.cjs",
   "module": "public/esm/index.mjs",
@@ -30,7 +30,7 @@
   "scripts": {
     "build": "npm run build:ts-types && npm run build:ts && npm run build:browser",
     "postbuild": "node ./postbuild.js",
-    "build:ts": "npm test && npx tsc",
+    "build:ts": "npm run coverage && npx tsc",
     "build:ts-types": "npx tsc --project tsconfig.d.json",
     "build:browser": "npm run build:esbuild",
     "build:esbuild": "node ./build-esbuild.js",
@@ -38,8 +38,9 @@
     "test:ts-types": "npx tsc --project ./tsconfig.jasmine.json ",
     "test:jasmine": "npm run test:ts-types && npx ts-node -r tsconfig-paths/register --project ./tsconfig.jasmine.json ./node_modules/jasmine/bin/jasmine.js",
     "test": "(npm run lint && npm run test:jasmine)",
-    "lint": "(npx -y eslint@latest src/**/*.ts --fix )",
-    "preversion": "npm cache verify && npm test",
+    "coverage": "nyc --reporter=lcov --reporter=text-summary npm run test",
+    "lint": "(npx eslint src/**/*.ts --fix )",
+    "preversion": "npm cache verify && npm run coverage",
     "sync": "git add . && git commit -am ",
     "postversion": "git push && git push --tags",
     "v-patch": "qcobjects v-patch",
@@ -54,7 +55,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/QuickGroup/QCObjects.git"
+    "url": "git+https://github.com/QuickCorp/QCObjects.git"
   },
   "keywords": [
     "qcobjects",
@@ -111,17 +112,17 @@
   ],
   "author": "Jean Machuca <correojean@gmail.com>",
   "bugs": {
-    "url": "https://github.com/QuickGroup/QCObjects/issues"
+    "url": "https://github.com/QuickCorp/QCObjects/issues"
   },
   "homepage": "https://qcobjects.com",
   "devDependencies": {
     "@eslint/eslintrc": "^3.1.0",
     "@eslint/js": "^9.13.0",
-    "@types/jasmine": "^5.1.5",
-    "@types/node": "^22.10.2",
+    "@types/jasmine": "^5.1.7",
+    "@types/node": "^22.13.10",
     "@typescript-eslint/eslint-plugin": "^5.58.0",
     "@typescript-eslint/parser": "^5.58.0",
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.25.0",
     "esbuild-plugin-alias": "^0.2.1",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^8.10.0",
@@ -137,7 +138,8 @@
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.7.2",
-    "typescript-eslint": "^8.18.1"
+    "typescript-eslint": "^8.18.1",
+    "nyc": "^15.1.0"
   },
   "engines": {
     "npm": ">=10",

package/public/browser/QCObjects.js

@@ -1523,7 +1523,11 @@ var global = (() => {
             logger.debug("No config value for: " + name);
             _value = _default;
           }
-          return GlobalProcessor.processObject(_value) || _default;
+          const processedValue = GlobalProcessor.processObject(_value);
+          if (_value === null && processedValue === null) {
+            return null;
+          }
+          return processedValue || _default;
         }
         static _instance;
         static get instance() {
@@ -1581,16 +1585,30 @@ var global = (() => {
           }
           return _Processor._instance;
         }
+        static setProcessor(_proc_) {
+          if (typeof _proc_ === "function" && _proc_.name !== "") {
+            _Processor.instance.processors[_proc_.name] = _proc_;
+          }
+        }
         setProcessor(_proc_) {
           if (typeof _proc_ === "function" && _proc_.name !== "") {
             this.processors[_proc_.name] = _proc_;
           }
         }
+        static getProcessor(_procName_) {
+          return _Processor.instance.processors[_procName_];
+        }
+        static getProcessorNames() {
+          return Object.keys(_Processor.instance.processors);
+        }
         component;
         execute(component, processorName, args) {
           const processorHandler = typeof component !== "undefined" && component !== null ? component.processorHandler : this;
           return processorHandler?.processors[processorName].bind(processorHandler).apply(processorHandler, [component, args?.split(",")]);
         }
+        static process(template, component = null) {
+          return _Processor.instance.process(template, component);
+        }
         process(template, component = null) {
           const processorHandler = component !== null ? component.processorHandler : New(_Processor, { component: null });
           if (typeof template === "string") {
@@ -1606,7 +1624,16 @@ var global = (() => {
           }
           return template;
         }
+        static processObject(obj, component) {
+          if (obj === null || obj === void 0) {
+            return obj;
+          }
+          return _Processor.instance.processObject(obj, component);
+        }
         processObject(obj, component = null) {
+          if (obj === null || obj === void 0) {
+            return obj;
+          }
           let __instance__ = component === null ? this : component.processorHandler;
           if (typeof __instance__ === "undefined") {
             __instance__ = new _Processor({ component });