lib-common-angular 0.0.9 → 0.0.11

package/.editorconfig

@@ -0,0 +1,16 @@
+# Editor configuration, see https://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.ts]
+quote_type = single
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

package/.eslintrc.json

@@ -0,0 +1,36 @@
+{
+  "parserOptions": {
+    "ecmaVersion": 2018,
+    "sourceType": "module"
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended" // Reglas recomendadas para TypeScript
+
+  ],
+  "env": {
+    "es6": true,
+    "node": true,
+    "jest": true
+  },
+  "ignorePatterns": ["dist/", "node_modules/"], // Ignora dist y node_modules
+  "rules": {
+    "max-lines-per-function": ["error", { 
+      "max":24, 
+      "skipComments": true,
+      "skipBlankLines": true
+      }],
+    "max-params": ["error", 4]
+  },
+  
+ "overrides": [
+    {
+      "files": ["src/api/controllers/**/*.ts"], // Aplica solo a los archivos en el paquete controllers
+      "rules": {
+        "max-lines-per-function": "off" // Deshabilita la regla en estos archivos
+      }
+    }
+  ]
+
+}
+

package/.github/CODEOWNERS

@@ -0,0 +1 @@
+@farius-red

package/.github/workflows/publish.yml

@@ -0,0 +1,108 @@
+name: Publicar en npm con Auto-Version
+
+
+on:
+  push:
+    branches:
+      - master
+    # Evita que el workflow se ejecute en ramas de release
+    # Solo ejecuta en master, no en release-auto-*
+    # Si necesitas permitir otros triggers, agrégalos aquí
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    # 🔐 IMPORTANTE: Permiso de escritura necesario para hacer git push
+    permissions:
+      contents: write  # Necesario para 'git push' (npm version)
+      id-token: write  # NECESARIO para 'npm publish --provenance' (OIDC)
+
+    steps:
+      - name: Checkout del código fuente
+        uses: actions/checkout@v4
+        with:
+          # Necesitamos el historial completo y el token para hacer push
+          fetch-depth: 0 
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Configura Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.12.0'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Configura Git
+        run: |
+          git config --global user.email "zigmainflables@gmail.com"
+          git config --global user.name "Daniel Juliao"
+      
+      - name: Clona lib-core-dtos (Dependencia Privada)
+        run: |
+          rm -rf lib-core-dtos
+          if [ -n "${{ secrets.LIB_CORE_DTOS_PAT }}" ]; then
+            echo "🔐 Clonando lib-core-dtos con token secreto"
+            git clone --depth 1 https://x-access-token:${{ secrets.LIB_CORE_DTOS_PAT }}@github.com/juliaosistem/lib-core-dtos.git lib-core-dtos
+          else
+            echo "⚠️ secrets.LIB_CORE_DTOS_PAT no configurado."
+            git clone --depth 1 https://github.com/juliaosistem/lib-core-dtos.git lib-core-dtos || echo "Fallo clonación pública."
+          fi
+
+      - name: Instala las dependencias
+        run: npm ci
+
+      - name: Genera DTOs
+        run: npm run generate:dtos
+        # NOTA: Si este paso modifica archivos rastreados por git, 
+        # 'npm version' fallará porque el directorio no estará limpio.
+        # Asegúrate de que los archivos generados estén en .gitignore.
+
+
+
+      - name: Incrementa versión (patch)
+        run: |
+          echo "🆙 Incrementando versión (patch)..."
+          git config --global user.email "zigmainflables@gmail.com"
+          git config --global user.name "Daniel Juliao"
+          echo "📂 Estado de Git antes de versionar:"
+          git status -s
+          npm version patch --force -m "chore(release): %s [skip ci]"
+
+
+      - name: Build
+        run: npm run build lib-common-angular
+
+      - name: Copia package.json corregido a dist/lib-common-angular
+        run: cp package.json dist/lib-common-angular/package.json
+
+      - name: Publica en npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+        run: |
+          echo "📦 Publicando en npm..."
+          npm publish  --access public --provenance
+          echo "✅ Publicación completada."
+
+      - name: Crea rama y PR de release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          BRANCH=release-auto-${{ github.run_id }}
+          git checkout -b $BRANCH
+          git push origin $BRANCH --follow-tags
+          echo "🔀 Creando Pull Request hacia master..."
+          gh pr create --base master --head $BRANCH --title "Release auto ${{ github.run_id }}" --body "Release generado automáticamente por CI"
+          echo "ℹ️ Espera la aprobación y merge del PR para completar el release."
+
+      - name: Notify Jenkins (al final)
+        if: always()
+        run: |
+          echo "🔄 Jenkins Multibranch será notificado (post-publicación)"
+          echo "📦 Rama: ${{ github.ref_name }}"
+          echo "📝 Commit: ${{ github.sha }}"
+          if [ -n "${{ secrets.JENKINS_URL }}" ]; then
+            echo "📣 Enviando notifyCommit a Jenkins: ${{ secrets.JENKINS_URL }}"
+            curl -sS -X POST "${{ secrets.JENKINS_URL }}/git/notifyCommit?url=${{ github.server_url }}/${{ github.repository }}" || true
+          else
+            echo "ℹ️ secrets.JENKINS_URL no está definido; omitiendo webhook"
+          fi

package/.gitmodules

@@ -0,0 +1,4 @@
+[submodule "lib-core-dtos"]
+    path = lib-core-dtos
+    url = https://github.com/juliaosistem/lib-core-dtos.git
+    branch = develop

package/.postcssrc.json

@@ -0,0 +1,5 @@
+{
+  "plugins": {
+    "@tailwindcss/postcss": {}
+  }
+}

package/Dockerfile

@@ -0,0 +1,42 @@
+# Dockerfile optimizado - usa artefactos ya construidos en Jenkins
+FROM nginx:alpine
+
+# Build arguments desde Jenkins
+ARG APP_VERSION="unknown"
+ARG BUILD_TAG="unknown"
+ARG GIT_COMMIT="unknown"
+
+# Instalar curl para health checks
+RUN apk add --no-cache curl
+
+# Copiar archivos ya construidos de la demo (desde Jenkins)
+COPY dist/lib-common-angular-demo/browser /usr/share/nginx/html
+
+# Configuración de nginx
+COPY nginx.conf /etc/nginx/nginx.conf
+
+# Crear usuario no-root para seguridad
+RUN addgroup -g 1001 -S angular && \
+    adduser -S angular -u 1001 -G angular
+
+# Ajustar permisos
+RUN chown -R angular:angular /usr/share/nginx/html && \
+    chown -R angular:angular /var/cache/nginx && \
+    chown -R angular:angular /var/log/nginx && \
+    chown -R angular:angular /etc/nginx/conf.d && \
+    touch /var/run/nginx.pid && \
+    chown -R angular:angular /var/run/nginx.pid
+
+# Labels dinámicos con información de build
+LABEL maintainer="Daniel Juliao <zigmainflables@gmail.com>"
+LABEL description="Demo application for lib-common-angular"
+LABEL version="${APP_VERSION}"
+LABEL build.tag="${BUILD_TAG}"
+LABEL build.commit="${GIT_COMMIT}"
+LABEL build.date="$(date -u +'%Y-%m-%dT%H:%M:%SZ')"
+
+USER angular
+
+EXPOSE 8080
+
+CMD ["nginx", "-g", "daemon off;"]

package/Jenkinsfile

@@ -0,0 +1,162 @@
+pipeline {
+    agent {
+        kubernetes {
+            // Usamos tu IP 192.168.1.254 para que el Pod encuentre a Nexus localmente
+            yaml """
+            apiVersion: v1
+            kind: Pod
+            spec:
+              hostAliases:
+              - ip: "192.168.1.254"
+                hostnames:
+                - "nexus.juliaosistem-server.in"
+              securityContext:
+                runAsUser: 0
+              containers:
+              - name: nodejs
+                image: node:20-alpine
+                command: ['cat']
+                tty: true
+                volumeMounts:
+                - name: node-cache
+                  mountPath: /root/.npm
+                resources:
+                  limits: { memory: "4Gi", cpu: "2000m" }
+                  requests: { memory: "2Gi", cpu: "1000m" }
+              - name: docker
+                image: docker:24-cli
+                command: ['cat']
+                tty: true
+                volumeMounts:
+                - name: dockersock
+                  mountPath: /var/run/docker.sock
+              volumes:
+              - name: dockersock
+                hostPath: { path: /var/run/docker.sock }
+              - name: node-cache
+                persistentVolumeClaim:
+                  claimName: node-pvc
+            """
+        }
+    }
+
+    environment {
+        NEXUS_DOMAIN = 'nexus.juliaosistem-server.in'
+        // Docker Registry: Dominio + Puerto NodePort
+        NEXUS_DOCKER_REGISTRY = "${env.NEXUS_DOMAIN}:30500"
+        // NPM Registry: URL Completa
+        NEXUS_NPM_REGISTRY = "http://${env.NEXUS_DOMAIN}:30080/repository/npm-private/"
+        
+        GIT_CREDS_ID = 'credencialesgit'
+        NEXUS_CREDS_ID = 'nexus-credentials'
+        RANCHER_CREDS_ID = 'rancher-api-credentials'
+    }
+
+    options {
+        skipDefaultCheckout() 
+        timeout(time: 1, unit: 'HOURS')
+    }
+
+    stages {
+        stage('Checkout & Tagging') {
+            steps {
+                script {
+                    sh "rm -rf ./* ./.* || true"
+                    withCredentials([usernamePassword(credentialsId: "${GIT_CREDS_ID}", usernameVariable: 'U', passwordVariable: 'P')]) {
+                        sh """
+                            git clone --depth 1 --branch ${BRANCH_NAME} https://${U}:${P}@github.com/juliaosistem/common-lib-angular.git .
+                            git clone --depth 1 https://${U}:${P}@github.com/juliaosistem/lib-core-dtos.git lib-core-dtos
+                        """
+                    }
+                    container('nodejs') {
+                        env.PACKAGE_VERSION = sh(script: "node -p \"require('./package.json').version\"", returnStdout: true).trim()
+                    }
+                    def commitId = sh(script: 'git rev-parse --short HEAD', returnStdout: true).trim()
+                    // Tag SemVer: version-rama-build-commit
+                    env.CUSTOM_TAG = "${env.PACKAGE_VERSION}-${BRANCH_NAME}-${BUILD_ID}-${commitId}"
+                    echo "🏷️ Tag generado: ${env.CUSTOM_TAG}"
+                }
+            }
+        }    
+
+        stage('Build Angular') {
+            steps {
+                container('nodejs') {
+                    sh '''
+                        apk add --no-cache git
+                        npm ci --prefer-offline --no-audit
+                        npm run generate:dtos
+                        npm run build:lib
+                        npm run build:demo
+                    '''
+                }
+            }
+        }
+
+        stage('Publish to Nexus NPM') {
+            when { anyOf { branch 'master'; branch 'develop'; branch 'desplieges' } }
+            steps {
+                container('nodejs') {
+                    withCredentials([usernamePassword(credentialsId: "${NEXUS_CREDS_ID}", usernameVariable: 'NEXUS_USER', passwordVariable: 'NEXUS_PASS')]) {
+                        sh '''
+                            set -e
+                            cd dist/lib-common-angular
+                            
+                            # Calculamos hostpath para el .npmrc
+                            hostpath=$(echo "$NEXUS_NPM_REGISTRY" | sed -E 's|https?://||; s|/$||')
+
+                            # Generamos el .npmrc con el token base64
+                            printf "registry=%s\n//%s/:_auth=%s\n//%s/:always-auth=true\n" \
+                                "$NEXUS_NPM_REGISTRY" \
+                                "$hostpath" \
+                                "$(printf "%s:%s" "$NEXUS_USER" "$NEXUS_PASS" | base64)" \
+                                "$hostpath" > .npmrc
+
+                            # Versionado
+                            if [ "$BRANCH_NAME" = "master" ]; then
+                                npm version patch --no-git-tag-version
+                            else
+                                npm version ${CUSTOM_TAG} --no-git-tag-version --allow-same-version
+                            fi
+
+                            npm publish --userconfig .npmrc
+                        '''
+                    }
+                }
+            }
+        }
+
+        stage('Docker Push & Deploy') {
+            when { anyOf { branch 'develop'; branch 'desplieges'; branch 'master' } }
+            steps {
+                container('docker') {
+                    withCredentials([usernamePassword(credentialsId: "${NEXUS_CREDS_ID}", usernameVariable: 'USER', passwordVariable: 'PASS')]) {
+                        sh '''
+                            IMAGE_TAGGED="${NEXUS_DOCKER_REGISTRY}/lib-common-angular-demo:${CUSTOM_TAG}"
+                            
+                            echo "$PASS" | docker login --username "$USER" --password-stdin "${NEXUS_DOCKER_REGISTRY}"
+                            
+                            docker build -t "$IMAGE_TAGGED" .
+                            docker push "$IMAGE_TAGGED"
+                        '''
+                        
+                        withCredentials([file(credentialsId: "${RANCHER_CREDS_ID}", variable: 'KUBECONFIG')]) {
+                            sh """
+                                export KUBECONFIG=${KUBECONFIG}
+                                kubectl set image deployment/demo-angular-app demo=${NEXUS_DOCKER_REGISTRY}/lib-common-angular-demo:${CUSTOM_TAG} -n develop
+                                kubectl rollout status deployment/demo-angular-app -n develop
+                            """
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    post {
+        always {
+            cleanWs() 
+            echo "🏁 Proceso terminado: ${env.CUSTOM_TAG}"
+        }
+    }
+}

package/README.md

@@ -0,0 +1,134 @@
+# Lib-Common-angular
+
+Esta libreria se usa para todos los proyectos frontales de aqui se usan los componentes 
+ version 20.1.6.
+
+# Lib Common Angular
+
+## Configuración de Ambientes
+
+### Uso Básico
+
+```typescript
+// En tu app.module.ts
+import { LibCommonAngularModule, LibConfigModule } from 'lib-common-angular';
+
+@NgModule({
+  imports: [
+    // ...otros imports
+    LibCommonAngularModule,
+    LibConfigModule.forRoot({
+      baseUrlProducts: 'https://api.miapp.com/productos',
+      baseUrlAuth: 'https://auth.miapp.com',
+      baseUrlUsers: 'https://users.miapp.com',
+      apiVersion: 'v2',
+      timeout: 60000
+    })
+  ],
+  // ...resto del módulo
+})
+export class AppModule { }
+```
+
+### Configuración por Ambiente
+
+```typescript
+// environment.prod.ts
+export const environment = {
+  production: true,
+  libConfig: {
+    baseUrlProducts: 'https://api-prod.miapp.com/productos',
+    baseUrlAuth: 'https://auth-prod.miapp.com',
+    baseUrlUsers: 'https://users-prod.miapp.com'
+  }
+};
+
+// app.module.ts
+import { environment } from '../environments/environment';
+
+@NgModule({
+  imports: [
+    LibConfigModule.forRoot(environment.libConfig)
+  ]
+})
+export class AppModule { }
+```
+
+### Configuración Dinámica
+
+```typescript
+// En cualquier servicio o componente
+constructor(private libConfig: LibConfigService) {}
+
+updateConfig() {
+  this.libConfig.updateConfig({
+    baseUrlProducts: 'https://nueva-api.com'
+  });
+}
+```
+
+
+
+## Paso 1
+
+**## npm install** 
+agregara las depencias localmente 
+
+## paso 2 
+
+ir ala carpeta principal del proyecto ejecutar 
+y ejecutar
+esto para probar componetes dentro de la misma libreria
+ **## ng build   lib-common-angular --watch**  
+
+en caso de probar cambios en un proyecto que esta importando esta libreria ejecutar.
+
+ si solo se quiere probar la libreria con el mismo proyecto interno  no ejecutar los siguientes comandos e ir hasta el paso 3 
+ **## ng build   lib-common-angular**  
+
+ y despues  
+**## npm  link  lib-common-angular** 
+ una vez ejecutado esto 
+ puedes ejecutar 
+para que construya los cambios en tiempo real y el proyecto que lo importa los tome
+ **## ng build   lib-common-angular --watch** 
+
+
+
+en el proyecto que usara la libreria ejecutar 
+**## npm   link  lib-common-angular** 
+
+## paso 3
+
+este paso aplica si quieres correr la libreria en el mismo proyecto que tiene la libreria para probar componetes 
+
+**## ng serve  lib-common-angular-demo**
+
+esto levantara la aplicacion donde podras probar tus componentes creados en la libreria
+
+
+
+
+**# importante**
+
+Si se va a crear nuevos dtos importante usar la libreria  juliaositembackenexpress los siguientes pasos son para modificar la libreria y ir viendo cambios  descargar la libreria localmn
+
+**# descargar la libreria juliaositembackenexpress localmente**
+despues 
+
+**# npm i**
+ 
+en la carpeta de la libreria 
+
+**# npm run build** 
+
+esto para crear la carpeta dist
+
+**# npm link** 
+esto creara un enlace simbolico  una vez creado ese enlace ir ala carpeta  common-lib-angular y ejecutar 
+
+**# npm link juliaositembackenexpress** 
+
+esto ara que cree un enlace a la libreria  si queremos ir desarrollando ala par con la libreria podemos despues ejecutar 
+
+**# npm run Build:watch** 

package/angular.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "lib-common-angular": {
+      "projectType": "library",
+      "root": "projects/lib-common-angular",
+      "sourceRoot": "projects/lib-common-angular/src",
+      "prefix": "lib",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:ng-packagr",
+          "options": {
+            "project": "projects/lib-common-angular/ng-package.json"
+          },
+          "configurations": {
+            "production": {
+              "tsConfig": "projects/lib-common-angular/tsconfig.lib.prod.json"
+            },
+            "development": {
+              "tsConfig": "projects/lib-common-angular/tsconfig.lib.json"
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "tsConfig": "projects/lib-common-angular/tsconfig.spec.json",
+            "polyfills": ["zone.js", "zone.js/testing"]
+          }
+        }
+      }
+    },
+    "lib-common-angular-demo": {
+      "projectType": "application",
+      "schematics": {
+        "@schematics/angular:component": {
+          "style": "scss"
+        }
+      },
+      "root": "projects/lib-common-angular-demo",
+      "sourceRoot": "projects/lib-common-angular-demo/src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:application",
+          "options": {
+            "outputPath": "dist/lib-common-angular-demo",
+            "index": "projects/lib-common-angular-demo/src/index.html",
+            "browser": "projects/lib-common-angular-demo/src/main.ts",
+            "polyfills": [
+              "zone.js"
+            ],
+            "tsConfig": "projects/lib-common-angular-demo/tsconfig.app.json",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "projects/lib-common-angular-demo/public",
+                "output": "/"
+              }
+            ],
+            "styles": [
+              "node_modules/prismjs/themes/prism.css",
+              "node_modules/tailwindcss/index.css",
+              "projects/lib-common-angular-demo/src/styles.scss"
+          ],
+            "scripts": [  
+        
+            ]
+    
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "1mb",
+                  "maximumError": "5mb"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "4kB",
+                  "maximumError": "8kB"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+         
+          "configurations": {
+            "production": {
+              "buildTarget": "lib-common-angular-demo:build:production"
+            },
+            "development": {
+              "buildTarget": "lib-common-angular-demo:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        },
+        "extract-i18n": {
+          "builder": "@angular-devkit/build-angular:extract-i18n"
+      },
+        "lint": {
+          "builder": "@angular-devkit/build-angular:tslint",
+          "options": {
+            "tsConfig": [
+              "projects/lib-common-angular-demo/tsconfig.app.json",
+              "projects/lib-common-angular-demo/tsconfig.spec.json"
+            ],
+            "exclude": [
+              "**/node_modules/**"
+            ]
+          }
+        }
+      }
+    }
+  },
+  "cli": {
+    "analytics": false
+  }
+}

package/eslint-rules/.ignore-logs-max-lines.js

@@ -0,0 +1,30 @@
+module.exports = {
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Custom rule to ignore log lines in max-lines-per-function",
+      category: "Best Practices",
+      recommended: false,
+    },
+    schema: [], // No opciones adicionales
+  },
+  create(context) {
+    const sourceCode = context.getSourceCode();
+
+    return {
+      FunctionDeclaration(node) {
+        const lines = sourceCode.getText(node).split("\n");
+        const filteredLines = lines.filter(
+          (line) => !/this\.log(Info|Error|Warn|Debug)\(/.test(line.trim())
+        );
+
+        if (filteredLines.length > 22) {
+          context.report({
+            node,
+            message: `Function '${node.id.name}' exceeds the maximum line limit (22 lines excluding logs).`,
+          });
+        }
+      },
+    };
+  },
+};