@barcidev/ngx-autogen 0.1.3 → 0.1.5

package/package.json

@@ -1,61 +1,62 @@
-{
-  "name": "@barcidev/ngx-autogen",
-  "version": "0.1.3",
-  "description": "A collection of Angular schematics for essential functionalities.",
-  "main": "dist/index.js",
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "npm run build && jasmine src/**/*_spec.js",
-    "prepublishOnly": "npm run build"
-  },
-  "files": [
-    "src/**/*.js",
-    "src/**/*.template",
-    "src/**/*.d.ts",
-    "src/**/schema.json",
-    "src/collection.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "keywords": [
-    "angular",
-    "schematics",
-    "state-management",
-    "ngrx",
-    "signals",
-    "scaffolding"
-  ],
-  "author": "Jorge Palacio Barcinilla",
-  "license": "MIT",
-  "schematics": "./src/collection.json",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/jpalacio09/ngx-autogen.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "homepage": "https://github.com/jpalacio09/ngx-autogen#readme",
-  "bugs": {
-    "url": "https://github.com/jpalacio09/ngx-autogen/issues"
-  },
-  "funding": {
-    "type": "github",
-    "url": "https://github.com/sponsors/jpalacio09"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "dependencies": {
-    "@angular-devkit/core": "^20.3.13",
-    "@angular-devkit/schematics": "^20.3.13",
-    "@schematics/angular": "^21.0.4",
-    "typescript": "~5.9.2"
-  },
-  "devDependencies": {
-    "@types/jasmine": "~5.1.0",
-    "@types/node": "^20.17.19",
-    "copyfiles": "^2.4.1",
-    "jasmine": "^5.0.0"
-  }
-}
+{
+  "name": "@barcidev/ngx-autogen",
+  "version": "0.1.5",
+  "description": "A collection of Angular schematics for essential functionalities.",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && jasmine src/**/*_spec.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "src/**/*.js",
+    "src/**/*.template",
+    "src/**/*.d.ts",
+    "src/**/schema.json",
+    "src/collection.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "angular",
+    "schematics",
+    "state-management",
+    "ngrx",
+    "signals",
+    "scaffolding"
+  ],
+  "author": "Jorge Palacio Barcinilla",
+  "license": "MIT",
+  "schematics": "./src/collection.json",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jpalacio09/ngx-autogen.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/jpalacio09/ngx-autogen#readme",
+  "bugs": {
+    "url": "https://github.com/jpalacio09/ngx-autogen/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/jpalacio09"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@angular-devkit/core": "^20.3.13",
+    "@angular-devkit/schematics": "^20.3.13",
+    "@schematics/angular": "^21.0.4",
+    "typescript": "~5.9.2"
+  },
+  "devDependencies": {
+    "@angular-devkit/schematics-cli": "^21.1.2",
+    "@types/jasmine": "~5.1.0",
+    "@types/node": "^20.17.19",
+    "copyfiles": "^2.4.1",
+    "jasmine": "^5.0.0"
+  }
+}

package/src/collection.json

@@ -1,15 +1,15 @@
-{
-  "$schema": "../node_modules/@angular-devkit/schematics/collection-schema.json",
-  "schematics": {
-    "ng-add": {
-      "description": "Ng add schematic for ngx-autogen.",
-      "factory": "./ng-add/index#ngAdd",
-      "schema": "./ng-add/schema.json"
-    },
-    "app-store": {
-      "description": "Adds NgRx Store to the Angular application with signal support.",
-      "factory": "./ngrx/store/index#signalStore",
-      "schema": "./ngrx/store/schema.json"
-    }
-  }
+{
+  "$schema": "../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Ng add schematic for ngx-autogen.",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json"
+    },
+    "app-store": {
+      "description": "Adds NgRx Store to the Angular application with signal support.",
+      "factory": "./ngrx/store/index#signalStore",
+      "schema": "./ngrx/store/schema.json"
+    }
+  }
 }

package/src/ng-add/index.js

@@ -11,26 +11,20 @@ function ngAdd(options) {
             throw new schematics_1.SchematicsException("Could not find package.json. Make sure you are in the root of an Angular project.");
         }
         const packageJson = JSON.parse(buffer.toString());
-        // 1. Obtener la versión de Angular Core
         const angularCoreVer = packageJson.dependencies["@angular/core"] ||
             packageJson.devDependencies["@angular/core"];
         if (!angularCoreVer) {
             throw new schematics_1.SchematicsException("The version of @angular/core could not be determined. Please ensure that Angular is installed in your project.");
         }
         const mainVersion = parseInt(angularCoreVer.replace(/[^\d.]/g, "").split(".")[0], 10);
-        // 2. Validación: NgRx Signals requiere Angular 16+ (v17+ recomendado)
-        if (mainVersion < 16) {
-            _context.logger.error(`❌ Error: ngx-essentials requires Angular v16 or higher. Detected: v${mainVersion}`);
+        if (mainVersion < 20) {
+            _context.logger.error(`❌ Error: ngx-essentials requires Angular v20 or higher. Detected: v${mainVersion}`);
             return tree; // Stop execution
         }
-        // 3. Mapear versión de NgRx (NgRx suele ir a la par con Angular)
         const ngrxVersion = `^${mainVersion}.0.0`;
         _context.logger.info(`📦 Configuring dependencies for Angular v${mainVersion}...`);
-        // 4. Modificar package.json
-        const packageName = "@barcidev/ngx-autogen";
-        // Inyectar dependencias compatibles
+        const packageName = "ngx-autogen";
         packageJson.dependencies = Object.assign(Object.assign({}, packageJson.dependencies), { "@ngrx/signals": ngrxVersion });
-        // Mover a devDependencies si es necesario
         if (packageJson.dependencies[packageName]) {
             const currentVer = packageJson.dependencies[packageName];
             delete packageJson.dependencies[packageName];
@@ -39,9 +33,8 @@ function ngAdd(options) {
         packageJson.dependencies = sortObjectKeys(packageJson.dependencies);
         packageJson.devDependencies = sortObjectKeys(packageJson.devDependencies);
         tree.overwrite(packagePath, JSON.stringify(packageJson, null, 2));
-        // 5. Configurar angular.json (Collections y Primary Key)
         updateAngularJson(tree, options);
-        // 6. Tarea de instalación
+        updateTsConfig(tree);
         _context.addTask(new tasks_1.NodePackageInstallTask());
         return tree;
     };
@@ -63,16 +56,51 @@ function updateAngularJson(tree, options) {
     if (!workspace.cli)
         workspace.cli = {};
     const collections = workspace.cli.schematicCollections || [];
-    if (!collections.includes("@barcidev/ngx-autogen")) {
-        collections.push("@barcidev/ngx-autogen");
+    if (!collections.includes("ngx-autogen")) {
+        collections.push("ngx-autogen");
         workspace.cli.schematicCollections = collections;
     }
     if (!workspace.schematics)
         workspace.schematics = {};
-    workspace.schematics["@barcidev/ngx-autogen:all"] = {
+    workspace.schematics["ngx-autogen:all"] = {
         pk: options.pk,
-        path: options.path,
+        lang: options.lang,
     };
     tree.overwrite(path, JSON.stringify(workspace, null, 2));
 }
+/**
+ * Configura los Paths en el tsconfig.json para permitir el uso de @shared/*
+ */
+function updateTsConfig(tree) {
+    const tsConfigPath = "/tsconfig.json";
+    const path = tree.exists(tsConfigPath) ? tsConfigPath : "/tsconfig.app.json";
+    const buffer = tree.read(path);
+    if (!buffer)
+        return;
+    let contentText = buffer.toString();
+    // Limpieza manual de comentarios para evitar que JSON.parse falle
+    const cleanJson = contentText.replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gm, "$1");
+    let tsconfig;
+    try {
+        tsconfig = JSON.parse(cleanJson);
+    }
+    catch (e) {
+        // Si falla, intentamos parsearlo tal cual por si no tiene comentarios
+        try {
+            tsconfig = JSON.parse(contentText);
+        }
+        catch (innerError) {
+            throw new schematics_1.SchematicsException(`No se pudo parsear ${path}. Asegúrate de que es un JSON válido.`);
+        }
+    }
+    // Configurar los paths
+    tsconfig.compilerOptions = tsconfig.compilerOptions || {};
+    tsconfig.compilerOptions.paths = tsconfig.compilerOptions.paths || {};
+    const sharedAlias = "@shared-state/*";
+    const sharedPath = ["src/app/shared/state/*"];
+    if (!tsconfig.compilerOptions.paths[sharedAlias]) {
+        tsconfig.compilerOptions.paths[sharedAlias] = sharedPath;
+        tree.overwrite(path, JSON.stringify(tsconfig, null, 2));
+    }
+}
 //# sourceMappingURL=index.js.map

package/src/ng-add/schema.d.ts

@@ -1,4 +1,4 @@
-export interface NgAddSchemaOptions {
-  pk: string;
-  path: string;
-}
+export interface NgAddSchemaOptions {
+  pk: string;
+  lang: string;
+}

package/src/ng-add/schema.json

@@ -1,20 +1,20 @@
-{
-  "$schema": "http://json-schema.org/schema",
-  "$id": "ng-add-schema",
-  "type": "object",
-  "properties": {
-    "pk": {
-      "type": "string",
-      "description": "The name of the default Primary Key (e.g., id, cod, uuid); default is 'id'.",
-      "x-prompt": "What is the name of the default Primary Key (e.g., id, cod, uuid)?",
-      "default": "id"
-    },
-    "path": {
-      "type": "string",
-      "description": "The path where the state management files will be created.",
-      "x-prompt": "Where do you want to create the state management files?",
-      "default": "src/app/core"
-    }
-  },
-  "required": ["pk", "path"]
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "ng-add-schema",
+  "type": "object",
+  "properties": {
+    "pk": {
+      "type": "string",
+      "description": "The name of the default Primary Key (e.g., id, cod, uuid); default is 'id'.",
+      "x-prompt": "What is the name of the default Primary Key (e.g., id, cod, uuid)?",
+      "default": "id"
+    },
+    "lang":{
+      "type": "string",
+      "description": "The default language for the application (en, es); default is 'en'.",
+      "x-prompt": "What is the default language for the application (en, es)?",
+      "default": "en"
+    }
+  },
+  "required": ["pk"]
 }

package/src/ngrx/store/files/entity/entity.model.ts.template

@@ -1,22 +1,12 @@
-import { FormControl } from '@angular/forms';
-
-export interface EntityStatus {
-  addError?: Error | null;
-  addLoading?: boolean;
-  error: Error | null;
-  idSelected?: null | number | string;
-  idsRemoving?: (number | string)[];
-  idsUpdating?: (number | string)[];
-  loaded: boolean;
-  loading: boolean;
-  removeError?: Error | null;
-  removeLoading?: boolean;
-  selectedError?: Error | null;
-  selectedLoading?: boolean;
-  updateError?: Error | null;
-  updateLoading?: boolean;
-}
-
-export type FormGroupType<T> = {
-  [K in keyof T]: FormControl<T[K]>;
-};
+import { HttpErrorResponse } from '@angular/common/http';
+import { FormControl } from '@angular/forms';
+
+export type FormGroupType<T> = {
+  [K in keyof T]: FormControl<T[K]>;
+};
+
+export interface RequestConfig<T, U = unknown> {
+  onError?: (error?: HttpErrorResponse) => void;
+  onSuccess?: (response?: U) => void;
+  payload: T;
+}

package/src/ngrx/store/files/entity/with-entity-pagination.ts.template

@@ -0,0 +1,89 @@
+import { computed, Signal } from '@angular/core';
+import {
+  EmptyFeatureResult,
+  patchState,
+  SignalStoreFeature,
+  signalStoreFeature,
+  withComputed,
+  withMethods,
+  withState
+} from '@ngrx/signals';
+
+export interface PaginationState {
+  page: number;
+  pageSize: number;
+  totalCount: number;
+}
+
+interface PaginationComputedProps {
+  hasNext: boolean;
+  hasPrevious: boolean;
+  totalPages: number;
+}
+
+const initialPaginationState: PaginationState = {
+  page: 1,
+  pageSize: 10,
+  totalCount: 0
+};
+
+/**
+ * Resetea el estado de paginación al estado inicial.
+ * @returns {PaginationState} - El estado inicial de paginación.
+ */
+export function resetPaginationState(): PaginationState {
+  return initialPaginationState;
+}
+
+/**
+ * Agrega funcionalidades de paginación a un Store.
+ * @param {[number]} initialPageSize - Tamaño inicial de página (opcional).
+ * @returns {SignalStoreFeature} - Características de la tienda con estado, computados y métodos de paginación.
+ */
+export function withPagination(initialPageSize?: number): SignalStoreFeature<
+  EmptyFeatureResult,
+  {
+    methods: {
+      nextPage: () => void;
+      previousPage: () => void;
+      setPage: (page: number) => void;
+      setPageSize: (pageSize: number) => void;
+      setTotalCount: (totalCount: number) => void;
+    };
+    props: Record<'paginationComputed', Signal<PaginationComputedProps>>;
+    state: Record<'pagination', PaginationState>;
+  }
+> {
+  return signalStoreFeature(
+    withState({
+      pagination: initialPageSize ? { ...initialPaginationState, pageSize: initialPageSize } : initialPaginationState
+    }),
+
+    withComputed(({ pagination: { page, pageSize, totalCount } }) => ({
+      paginationComputed: computed(() => ({
+        hasNext: page() < Math.ceil(totalCount() / pageSize()),
+        hasPrevious: page() > 1,
+        totalPages: Math.ceil(totalCount() / pageSize())
+      }))
+    })),
+    withMethods((store) => ({
+      nextPage: () => {
+        if (store.pagination.page() < Math.ceil(store.pagination.totalCount() / store.pagination.pageSize())) {
+          patchState(store, (state) => ({ pagination: { ...state.pagination, page: store.pagination.page() + 1 } }));
+        }
+      },
+      previousPage: () => {
+        if (store.pagination.page() > 1) {
+          patchState(store, (state) => ({ pagination: { ...state.pagination, page: store.pagination.page() - 1 } }));
+        }
+      },
+      setPage: (page: number) => {
+        patchState(store, (state) => ({ pagination: { ...state.pagination, page } }));
+      },
+      setPageSize: (pageSize: number) =>
+        patchState(store, (state) => ({ pagination: { ...state.pagination, page: 1, pageSize } })), // Reset a pág 1 si cambia el tamaño
+      setTotalCount: (totalCount: number) =>
+        patchState(store, (state) => ({ pagination: { ...state.pagination, totalCount } }))
+    }))
+  );
+}

package/src/ngrx/store/files/entity/with-entity-status.ts.template

@@ -0,0 +1,92 @@
+import { computed, Signal } from '@angular/core';
+import { EmptyFeatureResult, SignalStoreFeature, signalStoreFeature, withComputed, withState } from '@ngrx/signals';
+
+export interface EntityStatus {
+  _removeLoading: boolean;
+  _updateLoading: boolean;
+  addError: Error | null;
+  addLoading: boolean;
+  error: Error | null;
+  idSelected: null | number | string;
+  idsRemoving: (number | string)[];
+  idsUpdating: (number | string)[];
+  loaded: boolean;
+  loading: boolean;
+  removeError: Error | null;
+  selectedError: Error | null;
+  selectedLoading: boolean;
+  updateError: Error | null;
+}
+
+interface EntityStatusComputedProps {
+  anyError: Error | null;
+  isAnyActionLoading: boolean;
+  removeLoading: boolean;
+  updateLoading: boolean;
+}
+
+type EntityStatusMethodProps = Record<string, (...args: unknown[]) => unknown>;
+
+const initialState: EntityStatus = {
+  _removeLoading: false,
+  _updateLoading: false,
+  addError: null,
+  addLoading: false,
+  error: null,
+  idSelected: null,
+  idsRemoving: [],
+  idsUpdating: [],
+  loaded: false,
+  loading: false,
+  removeError: null,
+  selectedError: null,
+  selectedLoading: false,
+  updateError: null
+};
+
+/**
+ * Resetea el estado de la entidad al estado inicial.
+ * @returns {EntityStatus} - El estado inicial de la entidad.
+ */
+export function resetEntityStatus(): EntityStatus {
+  return initialState;
+}
+
+/**
+ * Agrega funcionalidades comunes de estado y computados para manejar el estado de entidades.
+ * @returns {SignalStoreFeature} -Características de la tienda con estado y computados para el manejo de entidades.
+ */
+export function withEntityStatus(): SignalStoreFeature<
+  EmptyFeatureResult,
+  {
+    methods: EntityStatusMethodProps;
+    props: Record<'statusComputed', Signal<EntityStatusComputedProps>>;
+    state: Record<'status', EntityStatus>;
+  }
+> {
+  return signalStoreFeature(
+    withState({ status: initialState }),
+    withComputed(
+      ({
+        status: {
+          _removeLoading,
+          _updateLoading,
+          addError,
+          error,
+          idsRemoving,
+          idsUpdating,
+          removeError,
+          selectedError,
+          updateError
+        }
+      }) => ({
+        statusComputed: computed(() => ({
+          anyError: error() || addError() || removeError() || updateError() || selectedError(),
+          isAnyActionLoading: idsUpdating().length > 0 || idsRemoving().length > 0,
+          removeLoading: _removeLoading() || idsRemoving().length > 0,
+          updateLoading: _updateLoading() || idsUpdating().length > 0
+        }))
+      })
+    )
+  );
+}

package/src/ngrx/store/files/{store → state/models}/__name@dasherize__.model.ts.template

@@ -1,14 +1,14 @@
-import { FormGroupType } from '../common/entity/entity.model';
-
-export interface Add<%= classify(name) %> {
-}
-
-export type Add<%= classify(name) %>Form = FormGroupType<Add<%= classify(name) %>>;
-
-export interface <%= classify(name) %>Dto {
-  <%= pk %>: number;
-}
-
-export type Update<%= classify(name) %> = Partial<<%= classify(name) %>Dto> & Pick<<%= classify(name) %>Dto, '<%= pk %>'>;
-
+import { FormGroupType } from '@shared-state/entity.model';
+
+export interface Add<%= classify(name) %> {
+}
+
+export type Add<%= classify(name) %>Form = FormGroupType<Add<%= classify(name) %>>;
+
+export interface <%= classify(name) %>Dto {
+  <%= pk %>: number;
+}
+
+export type Update<%= classify(name) %> = Partial<<%= classify(name) %>Dto> & Pick<<%= classify(name) %>Dto, '<%= pk %>'>;
+
 export interface <%= classify(name) %>Request{}

package/src/ngrx/store/files/{store → state/services}/__name@dasherize__.service.ts.template

@@ -1,29 +1,29 @@
-import { Injectable } from '@angular/core';
-import { Observable, of } from 'rxjs';
-import {
-  Add<%= classify(name) %>,
-  <%= classify(name) %>Dto,
-  Update<%= classify(name) %>
-} from './<%= dasherize(name) %>.model';
-
-@Injectable({
-  providedIn: 'root'
-})
-export class <%= classify(name) %>Service {
-
-  add<%= classify(name) %>$(entity: Add<%= classify(name) %>): Observable<number> {
-    return of(0);
-  }
-
-  remove<%= classify(name) %>$(<%= pk %>: number): Observable<boolean> {
-    return of(true);
-  }
-
-  get<%= classify(pluralize(name)) %>$(): Observable<<%= classify(name) %>Dto[]> {
-    return of([]);
-  }
-
-  update<%= classify(name) %>$(entity: Update<%= classify(name) %>): Observable<boolean> {
-    return of(true);
-  }
+import { Injectable } from '@angular/core';
+import { Observable, of } from 'rxjs';
+import {
+  Add<%= classify(name) %>,
+  <%= classify(name) %>Dto,
+  Update<%= classify(name) %>
+} from '<%= grouped ? "../models/" + dasherize(name) + ".model" : "./" + dasherize(name) + ".model" %>';
+
+@Injectable({
+  providedIn: 'root'
+})
+export class <%= classify(name) %>Service {
+
+  add<%= classify(name) %>$(entity: Add<%= classify(name) %>): Observable<number> {
+    return of(0);
+  }
+
+  remove<%= classify(name) %>$(<%= pk %>: number): Observable<boolean> {
+    return of(true);
+  }
+
+  get<%= classify(pluralize(name)) %>$(): Observable<<%= classify(name) %>Dto[]> {
+    return of([]);
+  }
+
+  update<%= classify(name) %>$(entity: Update<%= classify(name) %>): Observable<boolean> {
+    return of(true);
+  }
 }