@open-rlb/ng-app 3.1.110 → 3.1.112

package/schematics/ng-add/files/assets/i18n/en.json

@@ -0,0 +1,106 @@
+{
+  "common": {
+    "ok": "Ok",
+    "cancel": "Cancel",
+    "close": "Close",
+    "save": "Save",
+    "delete": "Delete",
+    "add": "Add",
+    "edit": "Edit",
+    "name": "Name",
+    "description": "Description",
+    "search": "Search",
+    "searching": "Searching...",
+    "noResults": "No results",
+    "loading": "Loading...",
+    "yes": "Yes",
+    "no": "No"
+  },
+  "core": {
+    "apps": {
+      "button": "Apps",
+      "title": "Riolabs Apps"
+    },
+    "settings": {
+      "title": "Settings",
+      "generalTitle": "General settings",
+      "generalDescription": "Manage general settings of applications",
+      "support": "Support",
+      "privacy": "Privacy",
+      "cookies": "Cookies",
+      "legal": "Legal",
+      "status": "Status",
+      "logger": "Logger"
+    },
+    "account": {
+      "title": "Account",
+      "email": "Email",
+      "changePassword": "Change password",
+      "firstName": "First name",
+      "lastName": "Last name",
+      "login": "Login",
+      "logout": "Logout",
+      "username": "Username",
+      "session": {
+        "title": "Sessions",
+        "current": "Current session",
+        "ip": "IP",
+        "applications": "Applications",
+        "lastAccess": "Last access",
+        "started": "Started",
+        "expires": "Expires"
+      },
+      "credentials": {
+        "title": "Credentials",
+        "password": "Password",
+        "otp": "One-time password",
+        "name": "Name",
+        "created": "Created",
+        "actions": "Actions",
+        "update": "Update",
+        "delete": "Delete",
+        "noCredentials": "No credentials found for this section",
+        "addOTP": "Configure OTP",
+        "deleteTitle": "Delete credential",
+        "deleteHeader": "Delete credential confirmation",
+        "deleteMessage": "Are you sure you want to delete this credential?"
+      },
+      "settings": {
+        "title": "Account settings",
+        "showMore": "Show more"
+      }
+    },
+    "pwa": {
+      "newVersionAvailable": "New version available",
+      "updateNow": "Update now",
+      "updateMessage": "A new version of the application is available. Do you want to update it now?",
+      "later": "Later",
+      "update": "Update"
+    }
+  },
+  "pages": {
+    "notFound": {
+      "title": "Page not found",
+      "content": "The page you are looking for does not exist.",
+      "button": "Go to home page"
+    },
+    "forbidden": {
+      "title": "Access forbidden",
+      "content": "You do not have permission to access this page.",
+      "button": "Go to home page"
+    },
+
+    "support": {
+      "title": "Support",
+      "legal": "Legal",
+      "name": "Name",
+      "email": "Email",
+      "subject": "Subject",
+      "message": "Message",
+      "send": "Send",
+      "success": "Your message has been sent successfully.",
+      "error": "An error occurred while sending your message.",
+      "infoPage": "For more information, please visit our legal page"
+    }
+  }
+}

package/schematics/ng-add/files/assets/i18n/it.json

@@ -0,0 +1,101 @@
+{
+  "common": {
+    "ok": "Ok",
+    "cancel": "Annulla",
+    "close": "Chiudi",
+    "save": "Salva",
+    "delete": "Elimina",
+    "add": "Aggiungi",
+    "edit": "Modifica",
+    "name": "Nome",
+    "description": "Descrizione",
+    "search": "Cerca",
+    "searching": "Ricerca in corso...",
+    "noResults": "Nessun risultato",
+    "loading": "Caricamento...",
+    "yes": "Sì",
+    "no": "No"
+  },
+  "core": {
+    "apps": {
+      "button": "Applicazioni",
+      "title": "App di Riolabs"
+    },
+    "settings": {
+      "title": "Impostazioni",
+      "generalTitle": "Impostazioni generali",
+      "generalDescription": "Gestisci le impostazioni generali delle applicazioni",
+      "support": "Supporto",
+      "privacy": "Privacy",
+      "cookies": "Cookie",
+      "legal": "Legale",
+      "status": "Stato",
+      "logger": "Logger"
+    },
+    "account": {
+      "title": "Account",
+      "email": "Email",
+      "changePassword": "Cambia password",
+      "firstName": "Nome",
+      "lastName": "Cognome",
+      "login": "Accesso",
+      "logout": "Esci",
+      "username": "Nome utente",
+      "session": {
+        "title": "Sessioni",
+        "current": "Sessione corrente",
+        "ip": "IP",
+        "applications": "Applicazioni",
+        "lastAccess": "Ultimo accesso",
+        "started": "Iniziata",
+        "expires": "Scade il"
+      },
+      "credentials": {
+        "title": "Credenziali",
+        "password": "Password",
+        "otp": "Password monouso",
+        "name": "Nome",
+        "created": "Creato",
+        "actions": "Azioni",
+        "update": "Aggiorna",
+        "delete": "Elimina",
+        "noCredentials": "Nessuna credenziale trovata per questa sezione",
+        "addOTP": "Configura OTP",
+        "deleteTitle": "Elimina credenziale",
+        "deleteHeader": "Conferma eliminazione credenziale",
+        "deleteMessage": "Sei sicuro di voler eliminare questa credenziale?"
+      }
+    },
+    "pwa": {
+      "newVersionAvailable": "Nuova versione disponibile",
+      "updateNow": "Aggiorna ora",
+      "updateMessage": "È disponibile una nuova versione dell'applicazione. Vuoi aggiornarla ora?",
+      "later": "Dopo",
+      "update": "Aggiorna"
+    }
+  },
+  "pages": {
+    "notFound": {
+      "title": "Pagina non trovata",
+      "content": "La pagina che stai cercando non esiste.",
+      "button": "Vai alla home page"
+    },
+    "forbidden": {
+      "title": "Accesso negato",
+      "content": "Non hai i permessi necessari per accedere a questa pagina.",
+      "button": "Vai alla home page"
+    },
+    "support": {
+      "title": "Supporto",
+      "legal": "Legale",
+      "name": "Nome",
+      "email": "Email",
+      "subject": "Oggetto",
+      "message": "Messaggio",
+      "send": "Invia",
+      "success": "Il tuo messaggio è stato inviato con successo.",
+      "error": "Si è verificato un errore durante l'invio del messaggio.",
+      "infoPage": "Per maggiori informazioni, visita la nostra pagina legale"
+    }
+  }
+}

package/schematics/ng-add/files/environments/environment.ts.template

@@ -0,0 +1,86 @@
+import { ProjectConfiguration } from '@open-rlb/ng-app';
+
+/**
+ * Application configuration consumed by `provideRlbConfig(environment)`.
+ *
+ * ⚠ Replace the placeholder values below with your real settings:
+ *   - auth.providers[].authority / clientId / redirectUrl / postLogoutRedirectUri
+ *   - auth.allowedUrls and endpoints[].baseUrl (your API gateway URLs)
+ */
+export const environment: ProjectConfiguration = {
+  production: false,
+  environment: {
+    baseUrl: 'http://localhost:4200',
+    ssr: false,
+    phone: false,
+    appLogo: '', // set to your logo path, e.g. 'assets/logo.svg' (place the file under src/assets)
+    appTitle: 'My App',
+    navbarDisabled: false,
+    errorDialogName: 'error-modal-component',
+    pwaUpdateEnabled: true,
+    errorDialogSize: 'md',
+    logLevel: 'log',
+  },
+  i18n: {
+    availableLangs: ['en', 'it'],
+    defaultLanguage: 'en',
+    useLanguageBrowser: true,
+    storeSelectedLanguage: true,
+    cookieStoreName: 'language',
+  },
+  auth: {
+    protocol: 'oauth',
+    storage: 'localStorage',
+    interceptor: 'oauth-code-ep',
+    allowedUrls: ['https://api.example.com'],
+    enableCompanyInterceptor: true,
+    providers: [
+      {
+        configId: 'default',
+        authority: 'https://login.example.com/realms/your-realm',
+        domains: ['localhost'],
+        redirectUrl: 'http://localhost:4200',
+        postLogoutRedirectUri: 'http://localhost:4200',
+        clientId: 'your-client-id',
+        scope: 'openid profile offline_access',
+        logLevel: 2,
+        acl: {
+          endpointKey: 'http-gateway',
+          path: 'admin/acl/resources',
+        },
+      },
+    ],
+  },
+  pages: {
+    content: { path: 'content' },
+    cookies: { path: 'cookies' },
+    notFound: { path: 'not-found' },
+    forbidden: { path: 'forbidden' },
+    privacy: { path: 'privacy' },
+    support: { path: 'support' },
+    terms: { path: 'terms' },
+    status: { path: 'status' },
+    logger: { path: 'logger' },
+  },
+  endpoints: {
+    'http-gateway': {
+      baseUrl: 'https://api.example.com',
+      auth: true,
+      healthPath: 'health',
+      wss: false,
+    },
+    'ws-gateway': {
+      baseUrl: 'wss://api.example.com',
+      healthPath: 'health',
+      auth: true,
+      wss: true,
+    },
+  },
+  acl: {
+    businessIdKey: 'businessId',
+    resourceIdKey: 'resourceId',
+    interceptorMapping: {
+      companyId: 'companyId',
+    },
+  },
+};

package/schematics/ng-add/files/main.ts.template

@@ -0,0 +1,5 @@
+import { bootstrapApplication } from '@angular/platform-browser';
+import { appConfig } from './app/app.config';
+import { AppComponent } from './app/app.component';
+
+bootstrapApplication(AppComponent, appConfig).catch(err => console.error(err));

package/schematics/ng-add/index.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ngAdd = ngAdd;
+const core_1 = require("@angular-devkit/core");
+const schematics_1 = require("@angular-devkit/schematics");
+const utility_1 = require("@schematics/angular/utility");
+/**
+ * Dependencies the library needs at the consumer side. `@angular/{core,common,forms,router}`
+ * and `rxjs` are intentionally omitted: every Angular app already provides them. Versions mirror
+ * the ranges declared in the library's `peerDependencies`.
+ */
+const DEPENDENCIES = [
+    { name: '@open-rlb/ng-bootstrap', version: '^3.0.1', type: utility_1.DependencyType.Default },
+    { name: '@open-rlb/date-tz', version: '^2.1.1', type: utility_1.DependencyType.Default },
+    { name: '@ngrx/store', version: '^21.0.0', type: utility_1.DependencyType.Default },
+    { name: '@ngrx/effects', version: '^21.0.0', type: utility_1.DependencyType.Default },
+    { name: '@ngrx/operators', version: '^21.0.0', type: utility_1.DependencyType.Default },
+    { name: '@ngrx/signals', version: '^21.0.0', type: utility_1.DependencyType.Default },
+    { name: '@ngx-translate/core', version: '^17.0.0', type: utility_1.DependencyType.Default },
+    { name: '@ngx-translate/http-loader', version: '^17.0.0', type: utility_1.DependencyType.Default },
+    { name: 'angular-auth-oidc-client', version: '^19.0.1', type: utility_1.DependencyType.Default },
+    { name: 'ngx-cookie-service', version: '^21.1.0', type: utility_1.DependencyType.Default },
+    { name: 'ngx-cookie-service-ssr', version: '^21.1.0', type: utility_1.DependencyType.Default },
+    { name: '@angular/service-worker', version: '^21.0.0', type: utility_1.DependencyType.Default },
+    { name: 'bootstrap-icons', version: '^1.13.1', type: utility_1.DependencyType.Default },
+    { name: '@types/bootstrap', version: '^5.2.10', type: utility_1.DependencyType.Dev },
+];
+/** Global styles required for the Bootstrap + @open-rlb/ng-bootstrap look & feel. */
+const STYLE_PATHS = [
+    'node_modules/bootstrap-icons/font/bootstrap-icons.css',
+    'node_modules/@open-rlb/ng-bootstrap/assets/scss/app.scss',
+    'node_modules/@open-rlb/ng-bootstrap/assets/scss/icons.scss',
+];
+/** SCSS `@use`/`@import` resolution root needed by the ng-bootstrap stylesheets. */
+const STYLE_INCLUDE_PATH = 'node_modules';
+/** Source folder for the scaffolded runtime assets (i18n JSON, logo), served at `/assets`. */
+const ASSETS_INPUT = 'src/assets';
+function ngAdd(options) {
+    return async (tree, _context) => {
+        const project = await resolveProject(tree, options.project);
+        return (0, schematics_1.chain)([
+            // 1. Install dependencies (a single npm install is scheduled automatically).
+            ...DEPENDENCIES.map(dep => (0, utility_1.addDependency)(dep.name, dep.version, { type: dep.type })),
+            // 2. Register Bootstrap + ng-bootstrap global styles and the SCSS include path in angular.json.
+            addBootstrapStyles(project),
+            // 3. Scaffold the runnable application shell (providers, environment, app component, routes).
+            options.skipShell ? noop : scaffoldShell(tree, project),
+            // 4. Optionally copy the bundled Claude skills into .claude/skills.
+            options.skipSkills ? noop : copyClaudeSkills(),
+            // 5. Print next steps.
+            logNextSteps(project, options),
+        ]);
+    };
+}
+/** Resolves the target project: the provided name, else the first application, else the first project. */
+async function resolveProject(tree, name) {
+    const workspace = await (0, utility_1.readWorkspace)(tree);
+    if (name) {
+        if (!workspace.projects.has(name)) {
+            throw new schematics_1.SchematicsException(`Project "${name}" was not found in the workspace.`);
+        }
+        return name;
+    }
+    for (const [projectName, project] of workspace.projects) {
+        if (project.extensions['projectType'] === 'application') {
+            return projectName;
+        }
+    }
+    const first = workspace.projects.keys().next().value;
+    if (!first) {
+        throw new schematics_1.SchematicsException('No project found in the workspace to add @open-rlb/ng-app to.');
+    }
+    return first;
+}
+function addBootstrapStyles(project) {
+    return (0, utility_1.updateWorkspace)(workspace => {
+        const target = workspace.projects.get(project)?.targets.get('build');
+        if (!target) {
+            return;
+        }
+        target.options ??= {};
+        const styles = target.options['styles'] ?? [];
+        for (const style of STYLE_PATHS) {
+            const present = styles.some(s => (typeof s === 'string' ? s : s.input) === style);
+            if (!present) {
+                styles.unshift(style);
+            }
+        }
+        target.options['styles'] = styles;
+        const preprocessor = target.options['stylePreprocessorOptions'] ?? {};
+        const includePaths = preprocessor.includePaths ?? [];
+        if (!includePaths.includes(STYLE_INCLUDE_PATH)) {
+            includePaths.push(STYLE_INCLUDE_PATH);
+        }
+        preprocessor.includePaths = includePaths;
+        target.options['stylePreprocessorOptions'] = preprocessor;
+        const assets = target.options['assets'] ?? [];
+        const servesAssets = assets.some(a => {
+            const input = typeof a === 'string' ? a : a.input;
+            return input === ASSETS_INPUT;
+        });
+        if (!servesAssets) {
+            assets.push({ glob: '**/*', input: ASSETS_INPUT, output: 'assets' });
+        }
+        target.options['assets'] = assets;
+    });
+}
+function scaffoldShell(tree, project) {
+    return async () => {
+        const workspace = await (0, utility_1.readWorkspace)(tree);
+        const def = workspace.projects.get(project);
+        const sourceRoot = def?.sourceRoot ?? (def ? `${def.root}/src` : 'src');
+        const templates = (0, schematics_1.apply)((0, schematics_1.url)('./files'), [
+            (0, schematics_1.applyTemplates)({ ...core_1.strings }),
+            (0, schematics_1.move)(sourceRoot),
+        ]);
+        // Overwrite the core shell files: ng add assumes a fresh/near-fresh app and the shell is the
+        // deliverable. Existing files (e.g. the default app.config.ts from `ng new`) are replaced.
+        return (0, schematics_1.mergeWith)(templates, schematics_1.MergeStrategy.Overwrite);
+    };
+}
+/**
+ * Copies the Claude skills bundled with the package into the consumer's
+ * `.claude/skills` folder. Library-authored skills are authoritative, so existing
+ * copies are overwritten to stay in sync with the installed version.
+ */
+function copyClaudeSkills() {
+    const skills = (0, schematics_1.apply)((0, schematics_1.url)('./claude-skills'), [(0, schematics_1.move)('.claude/skills')]);
+    return (0, schematics_1.mergeWith)(skills, schematics_1.MergeStrategy.Overwrite);
+}
+function logNextSteps(project, options) {
+    return (_tree, context) => {
+        const log = context.logger;
+        log.info('');
+        log.info('✅ @open-rlb/ng-app added successfully.');
+        log.info('   • Dependencies installed and added to package.json');
+        log.info('   • Bootstrap + ng-bootstrap styles registered in angular.json');
+        if (!options.skipShell) {
+            log.info(`   • Application shell scaffolded into the "${project}" app:`);
+            log.info('     - src/main.ts bootstraps the AppComponent shell');
+            log.info('     - src/environments/environment.ts (config: auth, endpoints, i18n, pages, acl)');
+            log.info('     - src/app/app.config.ts (provideRlbConfig + provideApp + RLB_INIT_PROVIDER)');
+            log.info('     - src/app/app.component.ts (<rlb-app-container> shell), app.describer.ts, routes, home');
+            log.info('     A default root component from `ng new` (e.g. src/app/app.ts) is now unused and can be deleted.');
+        }
+        if (!options.skipSkills) {
+            log.info('   • Claude skills copied to .claude/skills/ (rlb-app-* guides)');
+        }
+        log.info('');
+        log.info('⚠ Before running: edit src/environments/environment.ts and replace the placeholder');
+        log.info('  OIDC authority/clientId/redirectUrl and endpoint baseUrls with your real values.');
+        log.info('  Then start the app with: ng serve');
+        log.info('');
+    };
+}
+/** A no-op rule. */
+const noop = tree => tree;

package/schematics/ng-add/schema.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/schematics/ng-add/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "OpenRlbNgAppNgAdd",
+  "title": "@open-rlb/ng-app ng-add schematic",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the project to add the library to.",
+      "$default": {
+        "$source": "projectName"
+      }
+    },
+    "skipShell": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not scaffold the application shell (environment, providers, app component, routes, home)."
+    },
+    "skipSkills": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not copy the bundled Claude skills into .claude/skills."
+    }
+  },
+  "required": []
+}

package/schematics/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}