@arsedizioni/ars-utils 22.0.84 → 22.0.85

package/fesm2022/arsedizioni-ars-utils-core.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, inject, Injectable, makeEnvironmentProviders, ElementRef, afterNextRender, Directive, input, DestroyRef, HostListener, output, forwardRef, effect, Pipe, EventEmitter, signal, computed, Service, PLATFORM_ID, RendererFactory2 } from '@angular/core';
+import { inject, Injectable, makeEnvironmentProviders, InjectionToken, ElementRef, afterNextRender, Directive, input, DestroyRef, HostListener, output, forwardRef, effect, Pipe, EventEmitter, signal, computed, Service, PLATFORM_ID, RendererFactory2 } from '@angular/core';
 import { DateAdapter, MAT_DATE_LOCALE, MAT_DATE_FORMATS } from '@angular/material/core';
 import { TZDate } from '@date-fns/tz';
 import { format, getYear, getMonth, getDate, getDay, getDaysInMonth, parseISO, parse, addYears, addMonths, addDays, isDate, isValid, addSeconds, endOfDay } from 'date-fns';
@@ -13,189 +13,6 @@ import { DomSanitizer } from '@angular/platform-browser';
 import { SelectionModel } from '@angular/cdk/collections';
 import { isPlatformBrowser } from '@angular/common';
 
-/** Default application timezone: all dates are serialised as Europe/Rome wall-clock values. */
-const DEFAULT_TIME_ZONE = 'Europe/Rome';
-/**
- * IANA timezone used to serialise dates towards the backend.
- * Override it in the application providers to run the same code in another zone:
- * `{ provide: ARS_TIME_ZONE, useValue: 'Europe/Zurich' }`.
- */
-const ARS_TIME_ZONE = new InjectionToken('ARS_TIME_ZONE', {
-    providedIn: 'root',
-    factory: () => DEFAULT_TIME_ZONE,
-});
-/** Naive local datetime pattern (no timezone designator): the server reads it as DateTimeKind.Unspecified. */
-const NAIVE_PATTERN = "yyyy-MM-dd'T'HH:mm:ss";
-/**
- * Returns `true` for payloads that must be forwarded untouched
- * (binary or already-encoded bodies).
- * @param body - The request body to test.
- */
-function isOpaqueBody(body) {
-    return (body instanceof FormData ||
-        body instanceof Blob ||
-        body instanceof ArrayBuffer ||
-        ArrayBuffer.isView(body) ||
-        body instanceof URLSearchParams ||
-        typeof body === 'string');
-}
-/**
- * Recursively replaces every `Date` found in `value` with its naive local
- * datetime string, returning a NEW structure: the original object graph — and
- * therefore any bound form model — is never mutated.
- *
- * @param value    - The value to normalise (object, array, Date or primitive).
- * @param timeZone - IANA timezone used to compute the wall-clock value.
- * @param seen     - Guard against circular references.
- * @returns The normalised value, safe to hand over to `JSON.stringify`.
- */
-function normalizeDates(value, timeZone, seen) {
-    if (value instanceof Date) {
-        // Invalid dates would make format() throw a RangeError: send null instead.
-        if (isNaN(value.getTime()))
-            return null;
-        return format(new TZDate(value.getTime(), timeZone), NAIVE_PATTERN);
-    }
-    if (value === null || typeof value !== 'object')
-        return value;
-    if (isOpaqueBody(value))
-        return value;
-    // Circular reference: leave it as is, JSON.stringify will report it anyway.
-    if (seen.has(value))
-        return value;
-    seen.add(value);
-    if (Array.isArray(value)) {
-        return value.map(item => normalizeDates(item, timeZone, seen));
-    }
-    const source = value;
-    const result = {};
-    for (const key of Object.keys(source)) {
-        result[key] = normalizeDates(source[key], timeZone, seen);
-    }
-    return result;
-}
-/**
- * Rewrites the request body, if any, replacing Dates with naive local strings.
- * Shared by the functional and the class-based interceptor.
- * @param req      - The outgoing request.
- * @param timeZone - IANA timezone used to compute the wall-clock value.
- * @returns The original request when there is nothing to convert, a clone otherwise.
- */
-function localizeRequest(req, timeZone) {
-    const body = req.body;
-    if (body === null || body === undefined || isOpaqueBody(body))
-        return req;
-    return req.clone({ body: normalizeDates(body, timeZone, new WeakSet()) });
-}
-/**
- * Functional interceptor that serialises every `Date` in an outgoing request
- * body as a naive local datetime string (`yyyy-MM-ddTHH:mm:ss`: no `Z`, no offset).
- *
- * WHY: `JSON.stringify` calls `Date.prototype.toJSON`, which emits a UTC instant.
- * A date picked as 29/07/2026 00:00 in Rome (UTC+2) becomes
- * `2026-07-28T22:00:00.000Z`, so the server stores the 28th — the classic
- * "off by one day" bug. Sending the wall-clock value instead makes
- * System.Text.Json produce a `DateTime` with `Kind = Unspecified` and the exact
- * day/time the user selected.
- *
- * This is the single serialisation boundary of the application: no call site has
- * to convert anything, and it also covers dates that lost a per-instance
- * `toJSON` along the way (e.g. after `structuredClone`).
- *
- * Register it explicitly in `provideHttpClient(withInterceptors([...]))`.
- * If you would rather have the library register it for you, use
- * {@link provideArsLocalDates} instead.
- *
- * @example
- * provideHttpClient(withInterceptors([
- *   arsLocalDateInterceptor,
- *   evolutionAuthInterceptor(...),
- * ]));
- */
-const arsLocalDateInterceptor = (req, next) => next(localizeRequest(req, inject(ARS_TIME_ZONE)));
-/**
- * Class-based twin of {@link arsLocalDateInterceptor}.
- *
- * Exists because a functional `HttpInterceptorFn` can ONLY be registered inside
- * `provideHttpClient(withInterceptors([...]))`, while a class registered on the
- * `HTTP_INTERCEPTORS` multi-token can be contributed by any `EnvironmentProviders` —
- * which is what lets {@link provideArsLocalDates} (and `provideArsDateFns`) wire it up
- * on their own.
- *
- * REQUIRES `withInterceptorsFromDi()` in the application's `provideHttpClient()`:
- * without it Angular never reads `HTTP_INTERCEPTORS` and this interceptor is
- * silently skipped.
- */
-class ArsLocalDateInterceptor {
-    constructor() {
-        this.timeZone = inject(ARS_TIME_ZONE);
-    }
-    /**
-     * Normalises the request body before handing it to the next handler.
-     * @param req  - The outgoing request.
-     * @param next - The next handler in the chain.
-     */
-    intercept(req, next) {
-        return next.handle(localizeRequest(req, this.timeZone));
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ArsLocalDateInterceptor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ArsLocalDateInterceptor }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ArsLocalDateInterceptor, decorators: [{
-            type: Injectable
-        }] });
-/**
- * Standalone providers for date serialisation towards the backend.
- *
- * Registers {@link ArsLocalDateInterceptor} so that every `Date` in a request
- * body travels as a naive local datetime string instead of a UTC instant.
- *
- * IMPORTANT: the application MUST call `withInterceptorsFromDi()`, otherwise
- * these providers have no effect at all (no error is raised).
- *
- * @param timeZone - IANA timezone name (default: `Europe/Rome`).
- *
- * @example
- * providers: [
- *   provideArsLocalDates(),
- *   provideHttpClient(withInterceptors([evolutionAuthInterceptor(...)]), withInterceptorsFromDi()),
- * ]
- */
-function provideArsLocalDates(timeZone = DEFAULT_TIME_ZONE) {
-    return makeEnvironmentProviders([
-        { provide: ARS_TIME_ZONE, useValue: timeZone },
-        { provide: HTTP_INTERCEPTORS, useClass: ArsLocalDateInterceptor, multi: true },
-    ]);
-}
-/**
- * Formats a date as a date-only ISO string (`yyyy-MM-dd`) using its wall-clock
- * calendar day in the given timezone. Use it for query-string parameters and for
- * DTO fields mapped to a .NET `DateOnly`, which the interceptor cannot detect.
- *
- * @param value    - The date to serialise.
- * @param timeZone - IANA timezone name (default: `Europe/Rome`).
- * @returns The `yyyy-MM-dd` string, or `undefined` for empty/invalid input.
- */
-function toLocalDateOnlyString(value, timeZone = DEFAULT_TIME_ZONE) {
-    if (!value || isNaN(value.getTime()))
-        return undefined;
-    return format(new TZDate(value.getTime(), timeZone), 'yyyy-MM-dd');
-}
-/**
- * Formats a date as a naive local datetime string (`yyyy-MM-ddTHH:mm:ss`), the
- * same representation produced by the interceptor. Useful for query-string
- * parameters, which never pass through the request body.
- *
- * @param value    - The date to serialise.
- * @param timeZone - IANA timezone name (default: `Europe/Rome`).
- * @returns The naive datetime string, or `undefined` for empty/invalid input.
- */
-function toLocalDateTimeString(value, timeZone = DEFAULT_TIME_ZONE) {
-    if (!value || isNaN(value.getTime()))
-        return undefined;
-    return format(new TZDate(value.getTime(), timeZone), NAIVE_PATTERN);
-}
-
 /**
  * Creates an array of the given length, filling each slot with the result of `valueFunction`.
  * @param length        - Number of elements to create.
@@ -595,15 +412,199 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  *   providers: [provideArsDateFns()]
  * });
  */
-function provideArsDateFns(options = {}) {
-    const { timeZone = 'Europe/Rome', httpSerialization = true } = options;
+function provideArsDateFns() {
     return makeEnvironmentProviders([
-        { provide: DateAdapter, useClass: DateFnsAdapter },
-        { provide: MAT_DATE_FORMATS, useValue: MAT_DATE_FNS_FORMATS },
-        ...(httpSerialization ? [provideArsLocalDates(timeZone)] : []),
+        {
+            provide: DateAdapter,
+            useClass: DateFnsAdapter
+        },
+        { provide: MAT_DATE_FORMATS, useValue: MAT_DATE_FNS_FORMATS }
     ]);
 }
 
+/** Default application timezone: all dates are serialised as Europe/Rome wall-clock values. */
+const DEFAULT_TIME_ZONE = 'Europe/Rome';
+/**
+ * IANA timezone used to serialise dates towards the backend.
+ * Override it in the application providers to run the same code in another zone:
+ * `{ provide: ARS_TIME_ZONE, useValue: 'Europe/Zurich' }`.
+ */
+const ARS_TIME_ZONE = new InjectionToken('ARS_TIME_ZONE', {
+    providedIn: 'root',
+    factory: () => DEFAULT_TIME_ZONE,
+});
+/** Naive local datetime pattern (no timezone designator): the server reads it as DateTimeKind.Unspecified. */
+const NAIVE_PATTERN = "yyyy-MM-dd'T'HH:mm:ss";
+/**
+ * Returns `true` for payloads that must be forwarded untouched
+ * (binary or already-encoded bodies).
+ * @param body - The request body to test.
+ */
+function isOpaqueBody(body) {
+    return (body instanceof FormData ||
+        body instanceof Blob ||
+        body instanceof ArrayBuffer ||
+        ArrayBuffer.isView(body) ||
+        body instanceof URLSearchParams ||
+        typeof body === 'string');
+}
+/**
+ * Recursively replaces every `Date` found in `value` with its naive local
+ * datetime string, returning a NEW structure: the original object graph — and
+ * therefore any bound form model — is never mutated.
+ *
+ * @param value    - The value to normalise (object, array, Date or primitive).
+ * @param timeZone - IANA timezone used to compute the wall-clock value.
+ * @param seen     - Guard against circular references.
+ * @returns The normalised value, safe to hand over to `JSON.stringify`.
+ */
+function normalizeDates(value, timeZone, seen) {
+    if (value instanceof Date) {
+        // Invalid dates would make format() throw a RangeError: send null instead.
+        if (isNaN(value.getTime()))
+            return null;
+        return format(new TZDate(value.getTime(), timeZone), NAIVE_PATTERN);
+    }
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (isOpaqueBody(value))
+        return value;
+    // Circular reference: leave it as is, JSON.stringify will report it anyway.
+    if (seen.has(value))
+        return value;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map(item => normalizeDates(item, timeZone, seen));
+    }
+    const source = value;
+    const result = {};
+    for (const key of Object.keys(source)) {
+        result[key] = normalizeDates(source[key], timeZone, seen);
+    }
+    return result;
+}
+/**
+ * Rewrites the request body, if any, replacing Dates with naive local strings.
+ * Shared by the functional and the class-based interceptor.
+ * @param req      - The outgoing request.
+ * @param timeZone - IANA timezone used to compute the wall-clock value.
+ * @returns The original request when there is nothing to convert, a clone otherwise.
+ */
+function localizeRequest(req, timeZone) {
+    const body = req.body;
+    if (body === null || body === undefined || isOpaqueBody(body))
+        return req;
+    return req.clone({ body: normalizeDates(body, timeZone, new WeakSet()) });
+}
+/**
+ * Functional interceptor that serialises every `Date` in an outgoing request
+ * body as a naive local datetime string (`yyyy-MM-ddTHH:mm:ss`: no `Z`, no offset).
+ *
+ * WHY: `JSON.stringify` calls `Date.prototype.toJSON`, which emits a UTC instant.
+ * A date picked as 29/07/2026 00:00 in Rome (UTC+2) becomes
+ * `2026-07-28T22:00:00.000Z`, so the server stores the 28th — the classic
+ * "off by one day" bug. Sending the wall-clock value instead makes
+ * System.Text.Json produce a `DateTime` with `Kind = Unspecified` and the exact
+ * day/time the user selected.
+ *
+ * This is the single serialisation boundary of the application: no call site has
+ * to convert anything, and it also covers dates that lost a per-instance
+ * `toJSON` along the way (e.g. after `structuredClone`).
+ *
+ * Register it explicitly in `provideHttpClient(withInterceptors([...]))`.
+ * If you would rather have the library register it for you, use
+ * {@link provideArsLocalDates} instead.
+ *
+ * @example
+ * provideHttpClient(withInterceptors([
+ *   arsLocalDateInterceptor,
+ *   evolutionAuthInterceptor(...),
+ * ]));
+ */
+const arsLocalDateInterceptor = (req, next) => next(localizeRequest(req, inject(ARS_TIME_ZONE)));
+/**
+ * Class-based twin of {@link arsLocalDateInterceptor}.
+ *
+ * Exists because a functional `HttpInterceptorFn` can ONLY be registered inside
+ * `provideHttpClient(withInterceptors([...]))`, while a class registered on the
+ * `HTTP_INTERCEPTORS` multi-token can be contributed by any `EnvironmentProviders` —
+ * which is what lets {@link provideArsLocalDates} (and `provideArsDateFns`) wire it up
+ * on their own.
+ *
+ * REQUIRES `withInterceptorsFromDi()` in the application's `provideHttpClient()`:
+ * without it Angular never reads `HTTP_INTERCEPTORS` and this interceptor is
+ * silently skipped.
+ */
+class ArsLocalDateInterceptor {
+    constructor() {
+        this.timeZone = inject(ARS_TIME_ZONE);
+    }
+    /**
+     * Normalises the request body before handing it to the next handler.
+     * @param req  - The outgoing request.
+     * @param next - The next handler in the chain.
+     */
+    intercept(req, next) {
+        return next.handle(localizeRequest(req, this.timeZone));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ArsLocalDateInterceptor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ArsLocalDateInterceptor }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ArsLocalDateInterceptor, decorators: [{
+            type: Injectable
+        }] });
+/**
+ * Standalone providers for date serialisation towards the backend.
+ *
+ * Registers {@link ArsLocalDateInterceptor} so that every `Date` in a request
+ * body travels as a naive local datetime string instead of a UTC instant.
+ *
+ * IMPORTANT: the application MUST call `withInterceptorsFromDi()`, otherwise
+ * these providers have no effect at all (no error is raised).
+ *
+ * @param timeZone - IANA timezone name (default: `Europe/Rome`).
+ *
+ * @example
+ * providers: [
+ *   provideArsLocalDates(),
+ *   provideHttpClient(withInterceptors([evolutionAuthInterceptor(...)]), withInterceptorsFromDi()),
+ * ]
+ */
+function provideArsLocalDates(timeZone = DEFAULT_TIME_ZONE) {
+    return makeEnvironmentProviders([
+        { provide: ARS_TIME_ZONE, useValue: timeZone },
+        { provide: HTTP_INTERCEPTORS, useClass: ArsLocalDateInterceptor, multi: true },
+    ]);
+}
+/**
+ * Formats a date as a date-only ISO string (`yyyy-MM-dd`) using its wall-clock
+ * calendar day in the given timezone. Use it for query-string parameters and for
+ * DTO fields mapped to a .NET `DateOnly`, which the interceptor cannot detect.
+ *
+ * @param value    - The date to serialise.
+ * @param timeZone - IANA timezone name (default: `Europe/Rome`).
+ * @returns The `yyyy-MM-dd` string, or `undefined` for empty/invalid input.
+ */
+function toLocalDateOnlyString(value, timeZone = DEFAULT_TIME_ZONE) {
+    if (!value || isNaN(value.getTime()))
+        return undefined;
+    return format(new TZDate(value.getTime(), timeZone), 'yyyy-MM-dd');
+}
+/**
+ * Formats a date as a naive local datetime string (`yyyy-MM-ddTHH:mm:ss`), the
+ * same representation produced by the interceptor. Useful for query-string
+ * parameters, which never pass through the request body.
+ *
+ * @param value    - The date to serialise.
+ * @param timeZone - IANA timezone name (default: `Europe/Rome`).
+ * @returns The naive datetime string, or `undefined` for empty/invalid input.
+ */
+function toLocalDateTimeString(value, timeZone = DEFAULT_TIME_ZONE) {
+    if (!value || isNaN(value.getTime()))
+        return undefined;
+    return format(new TZDate(value.getTime(), timeZone), NAIVE_PATTERN);
+}
+
 /**
  * Directive that moves browser focus to the host element after the first render cycle.
  * Apply `autoFocus` to any focusable element to set focus automatically on initialisation.
@@ -4102,5 +4103,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AutoFocusDirective, BroadcastChannelManager, BroadcastService, CHANNEL_NAME, CopyClipboardDirective, DateFnsAdapter, DateFormat, DateInterval, DateIntervalChangeDirective, DeleteModel, EmailsValidatorDirective, EnvironmentService, EqualsValidatorDirective, FileInfo, FileSizeValidatorDirective, FormatHtmlPipe, FormatMarkdownPipe, FormatPipe, GroupModel, GuidValidatorDirective, IDModel, ImportModel, MAT_DATE_FNS_FORMATS, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, QueryModel, RelationModel, RemoveFocusDirective, ReplacePipe, SafeHtmlPipe, SafeUrlPipe, ScreenService, SearchCallbackPipe, SearchFilterPipe, SelectableModel, SplashService, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel, provideArsDateFns };
+export { ARS_TIME_ZONE, ArsLocalDateInterceptor, AutoFocusDirective, BroadcastChannelManager, BroadcastService, CHANNEL_NAME, CopyClipboardDirective, DEFAULT_TIME_ZONE, DateFnsAdapter, DateFormat, DateInterval, DateIntervalChangeDirective, DeleteModel, EmailsValidatorDirective, EnvironmentService, EqualsValidatorDirective, FileInfo, FileSizeValidatorDirective, FormatHtmlPipe, FormatMarkdownPipe, FormatPipe, GroupModel, GuidValidatorDirective, IDModel, ImportModel, MAT_DATE_FNS_FORMATS, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, QueryModel, RelationModel, RemoveFocusDirective, ReplacePipe, SafeHtmlPipe, SafeUrlPipe, ScreenService, SearchCallbackPipe, SearchFilterPipe, SelectableModel, SplashService, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel, arsLocalDateInterceptor, provideArsDateFns, provideArsLocalDates, toLocalDateOnlyString, toLocalDateTimeString };
 //# sourceMappingURL=arsedizioni-ars-utils-core.mjs.map