@flexzap/utilities 1.0.0 → 1.1.0

package/README.md

@@ -59,14 +59,14 @@ 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.                       |
+| Method         | Parameters                                                           | Description                                                    |
+| -------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `goToUrl`      | `url: string`, `target?: '_self' \| '_blank' \| '_parent' \| '_top'` | 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`, `filename?: string`                                   | Downloads a file from the specified URL.                       |
 
 #### Features
 

package/fesm2022/flexzap-utilities.mjs

@@ -1,8 +1,79 @@
-import { isPlatformBrowser } from '@angular/common';
+import { DOCUMENT, isPlatformBrowser } from '@angular/common';
 import * as i0 from '@angular/core';
-import { SecurityContext, PLATFORM_ID, Inject, Injectable } from '@angular/core';
+import { inject, Injectable, SecurityContext, PLATFORM_ID, Inject } from '@angular/core';
 import * as i1 from '@angular/platform-browser';
 
+/**
+ * Utility service for managing browser cookies.
+ * Provides typesafe methods to get and set cookies with support for:
+ * - Expiration days
+ * - Path and Domain
+ * - Secure flag
+ * - SameSite policy
+ */
+class ZapCookieUtil {
+    document = inject(DOCUMENT);
+    /**
+     * Retrieves a cookie value by name.
+     * @param name The name of the cookie
+     * @returns The cookie value or null if not found
+     */
+    getCookie(name) {
+        if (!this.document) {
+            return null;
+        }
+        const nameEQ = name + '=';
+        const ca = this.getCookieString().split(';');
+        for (const c of ca) {
+            let cookie = c.trim();
+            if (cookie.startsWith(nameEQ)) {
+                return decodeURIComponent(cookie.substring(nameEQ.length));
+            }
+        }
+        return null;
+    }
+    /**
+     * Sets a cookie with the specified parameters.
+     * @param name Name of the cookie
+     * @param value Value of the cookie
+     * @param days Expiration in days (optional)
+     * @param path Cookie path (default: '/')
+     * @param domain Cookie domain (optional)
+     * @param secure Secure flag (optional)
+     * @param sameSite SameSite policy (default: 'Lax')
+     */
+    setCookie(name, value, days, path, domain, secure, sameSite) {
+        if (!this.document) {
+            return;
+        }
+        if (sameSite === 'None' && !secure) {
+            secure = true;
+        }
+        let expires = '';
+        if (days) {
+            const date = new Date();
+            date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);
+            expires = '; expires=' + date.toUTCString();
+        }
+        const cookieString = `${name}=${encodeURIComponent(value)}${expires}; path=${path ?? '/'}${domain ? '; domain=' + domain : ''}${secure ? '; secure' : ''}; SameSite=${sameSite ?? 'Lax'}`;
+        this.setCookieString(cookieString);
+    }
+    getCookieString() {
+        return this.document.cookie;
+    }
+    setCookieString(value) {
+        this.document.cookie = value;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ZapCookieUtil, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ZapCookieUtil, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ZapCookieUtil, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
 /**
  * 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.
@@ -97,14 +168,15 @@ class ZapNavigation {
      * 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:'.
+     * @param {string} [filename] - Optional filename to suggest for the downloaded file. If provided, it takes precedence (for same-origin URLs). If omitted, the browser infers the name from the server headers (Content-Disposition) or URL.
      */
-    downloadFile(url) {
+    downloadFile(url, filename) {
         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.download = filename ?? '';
                 link.click();
             }
         }
@@ -130,5 +202,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { ZapNavigation };
+export { ZapCookieUtil, ZapNavigation };
 //# sourceMappingURL=flexzap-utilities.mjs.map

package/fesm2022/flexzap-utilities.mjs.map

@@ -1 +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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"}
+{"version":3,"file":"flexzap-utilities.mjs","sources":["../../../../projects/flexzap/utilities/src/lib/cookies/cookie-util.ts","../../../../projects/flexzap/utilities/src/lib/navigation/navigation.ts","../../../../projects/flexzap/utilities/src/public-api.ts","../../../../projects/flexzap/utilities/src/flexzap-utilities.ts"],"sourcesContent":["import { DOCUMENT } from '@angular/common';\nimport { Injectable, inject } from '@angular/core';\n\n/**\n * Utility service for managing browser cookies.\n * Provides typesafe methods to get and set cookies with support for:\n * - Expiration days\n * - Path and Domain\n * - Secure flag\n * - SameSite policy\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class ZapCookieUtil {\n  private document = inject(DOCUMENT);\n\n  /**\n   * Retrieves a cookie value by name.\n   * @param name The name of the cookie\n   * @returns The cookie value or null if not found\n   */\n  getCookie(name: string): string | null {\n    if (!this.document) {\n      return null;\n    }\n    const nameEQ = name + '=';\n    const ca = this.getCookieString().split(';');\n    for (const c of ca) {\n      let cookie = c.trim();\n      if (cookie.startsWith(nameEQ)) {\n        return decodeURIComponent(cookie.substring(nameEQ.length));\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Sets a cookie with the specified parameters.\n   * @param name Name of the cookie\n   * @param value Value of the cookie\n   * @param days Expiration in days (optional)\n   * @param path Cookie path (default: '/')\n   * @param domain Cookie domain (optional)\n   * @param secure Secure flag (optional)\n   * @param sameSite SameSite policy (default: 'Lax')\n   */\n  setCookie(\n    name: string,\n    value: string,\n    days?: number,\n    path?: string,\n    domain?: string,\n    secure?: boolean,\n    sameSite?: 'Lax' | 'Strict' | 'None'\n  ): void {\n    if (!this.document) {\n      return;\n    }\n\n    if (sameSite === 'None' && !secure) {\n      secure = true;\n    }\n\n    let expires = '';\n    if (days) {\n      const date = new Date();\n      date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);\n      expires = '; expires=' + date.toUTCString();\n    }\n    const cookieString = `${name}=${encodeURIComponent(value)}${expires}; path=${path ?? '/'}${\n      domain ? '; domain=' + domain : ''\n    }${secure ? '; secure' : ''}; SameSite=${sameSite ?? 'Lax'}`;\n    this.setCookieString(cookieString);\n  }\n\n  private getCookieString(): string {\n    return this.document.cookie;\n  }\n\n  private setCookieString(value: string): void {\n    this.document.cookie = value;\n  }\n}\n","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   * @param {string} [filename] - Optional filename to suggest for the downloaded file. If provided, it takes precedence (for same-origin URLs). If omitted, the browser infers the name from the server headers (Content-Disposition) or URL.\n   */\n  downloadFile(url: string, filename?: 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 = filename ?? '';\n        link.click();\n      }\n    }\n  }\n}\n","/*\n * Public API Surface of utilities\n */\n\nexport * from './lib/cookies/index';\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

@@ -1,6 +1,6 @@
 {
   "name": "@flexzap/utilities",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "All the utilities that makes part of the flexzap library",
   "keywords": [
     "flexzap",

package/types/flexzap-utilities.d.ts

@@ -1,5 +1,38 @@
-import { DomSanitizer } from '@angular/platform-browser';
 import * as i0 from '@angular/core';
+import { DomSanitizer } from '@angular/platform-browser';
+
+/**
+ * Utility service for managing browser cookies.
+ * Provides typesafe methods to get and set cookies with support for:
+ * - Expiration days
+ * - Path and Domain
+ * - Secure flag
+ * - SameSite policy
+ */
+declare class ZapCookieUtil {
+    private document;
+    /**
+     * Retrieves a cookie value by name.
+     * @param name The name of the cookie
+     * @returns The cookie value or null if not found
+     */
+    getCookie(name: string): string | null;
+    /**
+     * Sets a cookie with the specified parameters.
+     * @param name Name of the cookie
+     * @param value Value of the cookie
+     * @param days Expiration in days (optional)
+     * @param path Cookie path (default: '/')
+     * @param domain Cookie domain (optional)
+     * @param secure Secure flag (optional)
+     * @param sameSite SameSite policy (default: 'Lax')
+     */
+    setCookie(name: string, value: string, days?: number, path?: string, domain?: string, secure?: boolean, sameSite?: 'Lax' | 'Strict' | 'None'): void;
+    private getCookieString;
+    private setCookieString;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZapCookieUtil, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ZapCookieUtil>;
+}
 
 /**
  * Service for handling navigation and URL opening in a safe, platform-agnostic way.
@@ -53,10 +86,11 @@ declare class ZapNavigation {
      * 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:'.
+     * @param {string} [filename] - Optional filename to suggest for the downloaded file. If provided, it takes precedence (for same-origin URLs). If omitted, the browser infers the name from the server headers (Content-Disposition) or URL.
      */
-    downloadFile(url: string): void;
+    downloadFile(url: string, filename?: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ZapNavigation, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ZapNavigation>;
 }
 
-export { ZapNavigation };
+export { ZapCookieUtil, ZapNavigation };