@arsedizioni/ars-utils 22.0.83 → 22.0.85

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

@@ -1,8 +1,9 @@
 import * as i0 from '@angular/core';
-import { 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';
+import { HTTP_INTERCEPTORS } from '@angular/common/http';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { Subject, filter as filter$1, map as map$1, BehaviorSubject } from 'rxjs';
 import { debounceTime, filter, map } from 'rxjs/operators';
@@ -421,6 +422,189 @@ function provideArsDateFns() {
     ]);
 }
 
+/** 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.
@@ -3919,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