Logging & Utils

Logger configurabili (ConsoleLogger, NullLogger) per iniettare il logging della libreria e FilterUtils — utility statiche per convertire FilterCriteria type-safe nella sintassi query PostgREST.

Cosa contiene questa sezione

Lo strato infrastrutturale di supporto trasversale a tutto il package:

Logger pluggable — l'interfaccia ILogger accetta qualsiasi implementazione conforme. La libreria espone due implementazioni out-of-the-box:
- ConsoleLogger — default basato su console.debug/warn/error
- NullLogger — no-op per ambienti produzione silenziosi o test
FilterUtils — utility statiche per convertire un FilterCriteria<T> nella query string PostgREST (?col=eq.value&order=...), parsare l'header Content-Range per il conteggio paginato, costruire headers per operazioni bulk.

import { ConsoleLogger, NullLogger, FilterUtils } from '@pzeta/postgrest'

Iniettare un logger custom (es. @pzeta/log con correlation ID) tramite l'opzione logger del PostgRESTClient o del BasePostgrestService. In produzione, NullLogger rimuove completamente l'overhead di logging.

Sotto-pagine

ConsoleLogger

Logger di default basato su console.* — implementazione standard di ILogger usata dal package quando non viene iniettato un logger custom.

FilterUtils

Utility statica per convertire FilterCriteria type-safe in query parameters PostgREST, parsare l'header Content-Range e costruire headers per operazioni bulk e paginate.

NullLogger

Logger no-op che scarta silenziosamente tutti i messaggi — usato per disabilitare completamente il logging della libreria in produzione o nei test.

WebStorageCacheStrategy

Classe base astratta condivisa da LocalStorageCacheStrategy e SessionStorageCacheStrategy. Implementa la logica comune per Web Storage API con prefix, TTL e quota handling.

ConsoleLogger

Logger di default basato su console.* — implementazione standard di ILogger usata dal package quando non viene iniettato un logger custom.