@flexzap/utilities 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vitor Azevedo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# @flexzap/utilities
+
+Essential utility services and helpers for Angular applications. Part of the FlexZap Library ecosystem.
+
+## Installation
+
+```bash
+npm install @flexzap/utilities
+```
+
+### Peer Dependencies
+
+This library requires the following peer dependencies:
+
+```bash
+npm install @angular/common@^21.1.0 @angular/core@^21.1.0 @angular/platform-browser@^21.1.0
+```
+
+## Usage
+
+### ZapNavigation
+
+The `ZapNavigation` service provides safe, platform-agnostic navigation methods.
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ZapNavigation } from '@flexzap/utilities';
+
+@Component({
+  template: `
+    <button (click)="goToExternal()">Go to Google</button>
+    <button (click)="sendEmail()">Contact Us</button>
+    <button (click)="callSupport()">Call Support</button>
+  `
+})
+export class MyComponent {
+  private navigation = inject(ZapNavigation);
+
+  goToExternal() {
+    // Safely navigates to URL (sanitized and browser-check included)
+    this.navigation.goToUrl('https://google.com', '_blank');
+  }
+
+  sendEmail() {
+    this.navigation.mailTo('support@example.com', 'Help', 'I need assistance');
+  }
+
+  callSupport() {
+    this.navigation.callTo('+1234567890');
+  }
+}
+```
+
+## API Reference
+
+### ZapNavigation Service
+
+Service for handling navigation and URL opening in a safe, platform-agnostic way.
+
+#### Methods
+
+| Method         | Parameters                                           | Description                                                    |
+| -------------- | ---------------------------------------------------- | -------------------------------------------------------------- |
+| `goToUrl`      | `url: string`, `target?: string`                     | Navigates to the specified URL. Default target is `_self`.     |
+| `mailTo`       | `email: string`, `subject?: string`, `body?: string` | Opens the default email client with optional subject and body. |
+| `callTo`       | `tel: string`                                        | Initiates a phone call to the specified number.                |
+| `smsTo`        | `tel: string`                                        | Initiates an SMS to the specified number.                      |
+| `linkTo`       | `id: string`                                         | Smoothly scrolls to the element with the specified ID.         |
+| `downloadFile` | `url: string`                                        | Downloads a file from the specified URL.                       |
+
+#### Features
+
+- **Platform Agnostic**: Safe to call in SSR environments (checks `PLATFORM_ID`).
+- **Security**: Automatically sanitizes URLs to prevent XSS.
+- **SSR Safe**: Prevents `window` access on the server.
+
+## Testing
+
+This library uses Jest for unit testing with zoneless Angular configuration.
+
+### Running Tests
+
+```bash
+# From the monorepo root
+npm run utilities:test            # Run all unit tests with coverage
+npm run utilities:test:watch      # Run tests in watch mode (no coverage)
+```
+
+### Test Configuration
+
+- **Framework**: Jest with jest-preset-angular
+- **Environment**: jsdom
+- **Configuration**: Zoneless Angular (mandatory)
+- **Coverage**: Reports generated at `coverage/flexzap/utilities/`
+
+## Development
+
+### Building the Library
+
+```bash
+# From the monorepo root
+npm run utilities:build       # Build directly
+ng build @flexzap/utilities   # Build using Angular CLI
+```
+
+## Publishing
+
+### Build for Publication
+
+```bash
+# From the monorepo root
+npm run utilities:build
+```
+
+### Publish to NPM
+
+```bash
+cd dist/flexzap/utilities
+npm publish --access public
+```
+
+## Contributing
+
+This library is part of the FlexZap Library monorepo. Please refer to the [main repository](../../../README.md) for contribution guidelines.
+
+## License
+
+MIT License - see the [LICENSE](../../../LICENSE) file for details.
+
+## Links
+
+- **Homepage**: [https://www.flexzap.dev](https://www.flexzap.dev)
+- **Repository**: [https://github.com/vitorazevedo/flexzap-library](https://github.com/vitorazevedo/flexzap-library)
+- **Monorepo Documentation**: [Main README](../../../README.md)

package/fesm2022/flexzap-utilities.mjs

@@ -0,0 +1,134 @@
+import { isPlatformBrowser } from '@angular/common';
+import * as i0 from '@angular/core';
+import { SecurityContext, PLATFORM_ID, Inject, Injectable } from '@angular/core';
+import * as i1 from '@angular/platform-browser';
+
+/**
+ * Service for handling navigation and URL opening in a safe, platform-agnostic way.
+ * It ensures that URLs are sanitized (rejecting 'unsafe:' prefixes) and that window operations are only performed in the browser environment.
+ */
+class ZapNavigation {
+    platformId;
+    sanitizer;
+    constructor(platformId, sanitizer) {
+        this.platformId = platformId;
+        this.sanitizer = sanitizer;
+    }
+    /**
+     * Navigates to the specified URL in the given target window/tab.
+     *
+     * This method performs the following safety checks:
+     * 1. Verifies the code is running in a browser environment.
+     * 2. Sanitizes the URL to prevent security vulnerabilities (like XSS) and rejects URLs prefixed with 'unsafe:'.
+     * 3. When target is '_blank', automatically adds 'noopener,noreferrer' and clears the opener to prevent reverse tabnabbing.
+     *
+     * @param {string} url - The URL to navigate to.
+     * @param {string} [target='_self'] - The target context for opening the URL (e.g., '_self', '_blank'). Defaults to '_self'.
+     */
+    goToUrl(url, target = '_self') {
+        if (isPlatformBrowser(this.platformId)) {
+            const sanitizedUrl = this.sanitizer.sanitize(SecurityContext.URL, url);
+            if (sanitizedUrl && !sanitizedUrl.startsWith('unsafe:')) {
+                if (target === '_blank') {
+                    const newWindow = window.open(sanitizedUrl, target, 'noopener,noreferrer');
+                    if (newWindow) {
+                        newWindow.opener = null;
+                    }
+                }
+                else {
+                    window.open(sanitizedUrl, target);
+                }
+            }
+        }
+    }
+    /**
+     * Opens the default email client with the specified email, subject, and body.
+     *
+     * @param {string} email - The recipient's email address.
+     * @param {string} [subject] - The subject of the email (optional).
+     * @param {string} [body] - The body of the email (optional).
+     */
+    mailTo(email, subject, body) {
+        const params = [];
+        if (subject) {
+            params.push(`subject=${encodeURIComponent(subject)}`);
+        }
+        if (body) {
+            params.push(`body=${encodeURIComponent(body)}`);
+        }
+        let url = `mailto:${email}`;
+        if (params.length > 0) {
+            url += `?${params.join('&')}`;
+        }
+        this.goToUrl(url);
+    }
+    /**
+     * Initiates a phone call to the specified telephone number.
+     *
+     * @param {string} tel - The telephone number to call.
+     */
+    callTo(tel) {
+        this.goToUrl(`tel:${tel}`);
+    }
+    /**
+     * Initiates a SMS to the specified telephone number.
+     *
+     * @param {string} tel - The telephone number to send SMS to.
+     */
+    smsTo(tel) {
+        this.goToUrl(`sms:${tel}`);
+    }
+    /**
+     * Navigates to the specified element id on the current page.
+     *
+     * This method performs a smooth scroll to the element. It is safe to call in SSR environments (no-op on server).
+     *
+     * @param {string} id - The element id to navigate to.
+     */
+    linkTo(id) {
+        if (isPlatformBrowser(this.platformId)) {
+            const element = document.getElementById(id);
+            if (element) {
+                element.scrollIntoView({ behavior: 'smooth' });
+            }
+        }
+    }
+    /**
+     * Downloads a file from the specified URL.
+     *
+     * @param {string} url - The URL of the file to download. It will be sanitized to prevent security vulnerabilities and rejected if prefixed with 'unsafe:'.
+     */
+    downloadFile(url) {
+        if (isPlatformBrowser(this.platformId)) {
+            const sanitizedUrl = this.sanitizer.sanitize(SecurityContext.URL, url);
+            if (sanitizedUrl && !sanitizedUrl.startsWith('unsafe:')) {
+                const link = document.createElement('a');
+                link.href = sanitizedUrl;
+                link.download = 'file';
+                link.click();
+            }
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ZapNavigation, deps: [{ token: PLATFORM_ID }, { token: i1.DomSanitizer }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ZapNavigation, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ZapNavigation, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: () => [{ type: Object, decorators: [{
+                    type: Inject,
+                    args: [PLATFORM_ID]
+                }] }, { type: i1.DomSanitizer }] });
+
+/*
+ * Public API Surface of utilities
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ZapNavigation };
+//# sourceMappingURL=flexzap-utilities.mjs.map

package/fesm2022/flexzap-utilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flexzap-utilities.mjs","sources":["../../../../projects/flexzap/utilities/src/lib/navigation/navigation.ts","../../../../projects/flexzap/utilities/src/public-api.ts","../../../../projects/flexzap/utilities/src/flexzap-utilities.ts"],"sourcesContent":["import { isPlatformBrowser } from '@angular/common';\nimport { Inject, Injectable, PLATFORM_ID, SecurityContext } from '@angular/core';\nimport { DomSanitizer } from '@angular/platform-browser';\n\n/**\n * Service for handling navigation and URL opening in a safe, platform-agnostic way.\n * It ensures that URLs are sanitized (rejecting 'unsafe:' prefixes) and that window operations are only performed in the browser environment.\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class ZapNavigation {\n  constructor(\n    @Inject(PLATFORM_ID) private platformId: Object,\n    private sanitizer: DomSanitizer\n  ) {}\n\n  /**\n   * Navigates to the specified URL in the given target window/tab.\n   *\n   * This method performs the following safety checks:\n   * 1. Verifies the code is running in a browser environment.\n   * 2. Sanitizes the URL to prevent security vulnerabilities (like XSS) and rejects URLs prefixed with 'unsafe:'.\n   * 3. When target is '_blank', automatically adds 'noopener,noreferrer' and clears the opener to prevent reverse tabnabbing.\n   *\n   * @param {string} url - The URL to navigate to.\n   * @param {string} [target='_self'] - The target context for opening the URL (e.g., '_self', '_blank'). Defaults to '_self'.\n   */\n  goToUrl(url: string, target: '_self' | '_blank' | '_parent' | '_top' = '_self') {\n    if (isPlatformBrowser(this.platformId)) {\n      const sanitizedUrl = this.sanitizer.sanitize(SecurityContext.URL, url);\n\n      if (sanitizedUrl && !sanitizedUrl.startsWith('unsafe:')) {\n        if (target === '_blank') {\n          const newWindow = window.open(sanitizedUrl, target, 'noopener,noreferrer');\n          if (newWindow) {\n            newWindow.opener = null;\n          }\n        } else {\n          window.open(sanitizedUrl, target);\n        }\n      }\n    }\n  }\n\n  /**\n   * Opens the default email client with the specified email, subject, and body.\n   *\n   * @param {string} email - The recipient's email address.\n   * @param {string} [subject] - The subject of the email (optional).\n   * @param {string} [body] - The body of the email (optional).\n   */\n  mailTo(email: string, subject?: string, body?: string) {\n    const params: string[] = [];\n    if (subject) {\n      params.push(`subject=${encodeURIComponent(subject)}`);\n    }\n    if (body) {\n      params.push(`body=${encodeURIComponent(body)}`);\n    }\n\n    let url = `mailto:${email}`;\n    if (params.length > 0) {\n      url += `?${params.join('&')}`;\n    }\n\n    this.goToUrl(url);\n  }\n\n  /**\n   * Initiates a phone call to the specified telephone number.\n   *\n   * @param {string} tel - The telephone number to call.\n   */\n  callTo(tel: string) {\n    this.goToUrl(`tel:${tel}`);\n  }\n\n  /**\n   * Initiates a SMS to the specified telephone number.\n   *\n   * @param {string} tel - The telephone number to send SMS to.\n   */\n  smsTo(tel: string) {\n    this.goToUrl(`sms:${tel}`);\n  }\n\n  /**\n   * Navigates to the specified element id on the current page.\n   *\n   * This method performs a smooth scroll to the element. It is safe to call in SSR environments (no-op on server).\n   *\n   * @param {string} id - The element id to navigate to.\n   */\n  linkTo(id: string) {\n    if (isPlatformBrowser(this.platformId)) {\n      const element = document.getElementById(id);\n\n      if (element) {\n        element.scrollIntoView({ behavior: 'smooth' });\n      }\n    }\n  }\n\n  /**\n   * Downloads a file from the specified URL.\n   *\n   * @param {string} url - The URL of the file to download. It will be sanitized to prevent security vulnerabilities and rejected if prefixed with 'unsafe:'.\n   */\n  downloadFile(url: string) {\n    if (isPlatformBrowser(this.platformId)) {\n      const sanitizedUrl = this.sanitizer.sanitize(SecurityContext.URL, url);\n\n      if (sanitizedUrl && !sanitizedUrl.startsWith('unsafe:')) {\n        const link = document.createElement('a');\n        link.href = sanitizedUrl;\n        link.download = 'file';\n        link.click();\n      }\n    }\n  }\n}\n","/*\n * Public API Surface of utilities\n */\n\nexport * from './lib/navigation/index';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@flexzap/utilities",
+  "version": "1.0.0",
+  "description": "All the utilities that makes part of the flexzap library",
+  "keywords": [
+    "flexzap",
+    "library",
+    "utilities",
+    "navigation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vitorazevedo/flexzap-library"
+  },
+  "author": "flexzap",
+  "license": "MIT",
+  "homepage": "https://www.flexzap.dev",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/common": "^21.1.0",
+    "@angular/core": "^21.1.0",
+    "@angular/platform-browser": "^21.1.0"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/flexzap-utilities.mjs",
+  "typings": "types/flexzap-utilities.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/flexzap-utilities.d.ts",
+      "default": "./fesm2022/flexzap-utilities.mjs"
+    }
+  }
+}

package/types/flexzap-utilities.d.ts

@@ -0,0 +1,62 @@
+import { DomSanitizer } from '@angular/platform-browser';
+import * as i0 from '@angular/core';
+
+/**
+ * Service for handling navigation and URL opening in a safe, platform-agnostic way.
+ * It ensures that URLs are sanitized (rejecting 'unsafe:' prefixes) and that window operations are only performed in the browser environment.
+ */
+declare class ZapNavigation {
+    private platformId;
+    private sanitizer;
+    constructor(platformId: Object, sanitizer: DomSanitizer);
+    /**
+     * Navigates to the specified URL in the given target window/tab.
+     *
+     * This method performs the following safety checks:
+     * 1. Verifies the code is running in a browser environment.
+     * 2. Sanitizes the URL to prevent security vulnerabilities (like XSS) and rejects URLs prefixed with 'unsafe:'.
+     * 3. When target is '_blank', automatically adds 'noopener,noreferrer' and clears the opener to prevent reverse tabnabbing.
+     *
+     * @param {string} url - The URL to navigate to.
+     * @param {string} [target='_self'] - The target context for opening the URL (e.g., '_self', '_blank'). Defaults to '_self'.
+     */
+    goToUrl(url: string, target?: '_self' | '_blank' | '_parent' | '_top'): void;
+    /**
+     * Opens the default email client with the specified email, subject, and body.
+     *
+     * @param {string} email - The recipient's email address.
+     * @param {string} [subject] - The subject of the email (optional).
+     * @param {string} [body] - The body of the email (optional).
+     */
+    mailTo(email: string, subject?: string, body?: string): void;
+    /**
+     * Initiates a phone call to the specified telephone number.
+     *
+     * @param {string} tel - The telephone number to call.
+     */
+    callTo(tel: string): void;
+    /**
+     * Initiates a SMS to the specified telephone number.
+     *
+     * @param {string} tel - The telephone number to send SMS to.
+     */
+    smsTo(tel: string): void;
+    /**
+     * Navigates to the specified element id on the current page.
+     *
+     * This method performs a smooth scroll to the element. It is safe to call in SSR environments (no-op on server).
+     *
+     * @param {string} id - The element id to navigate to.
+     */
+    linkTo(id: string): void;
+    /**
+     * Downloads a file from the specified URL.
+     *
+     * @param {string} url - The URL of the file to download. It will be sanitized to prevent security vulnerabilities and rejected if prefixed with 'unsafe:'.
+     */
+    downloadFile(url: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZapNavigation, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ZapNavigation>;
+}
+
+export { ZapNavigation };