slonik-interceptor-preset

Slonik interceptor preset.

Motivation

Slonik functionality is extendable using interceptors. Each interceptor is contained in a separate package. Installing and configuring each interceptor becomes a tedious task when using Slonik across multiple projects. slonik-interceptor-preset provides a factory function (createInterceptors) for constructing a collection of selected interceptors.

slonik-interceptor-preset installs these presets:

Name	Description
slonik-interceptor-field-name-transformation	Transforms Slonik query result field names.
slonik-interceptor-query-benchmarking	Benchmarks Slonik queries.
slonik-interceptor-query-logging	Logs Slonik queries.
slonik-interceptor-query-normalisation	Normalises Slonik queries.

Each interceptor can be selectively enabled/ disabled (see API).

API

1import {
2  createInterceptors
3} from 'slonik-interceptor-preset';
4

1/**
2 * @property benchmarkQueries Dictates whether to enable the [query benchmarking interceptor](https://github.com/gajus/slonik-interceptor-query-benchmarking). (Default: false)
3 * @property logQueries Dictates whether to enable the [query logging interceptor](https://github.com/gajus/slonik-interceptor-query-logging). (Default: true)
4 * @property normaliseQueries Dictates whether to enable the [query normalisation interceptor](https://github.com/gajus/slonik-interceptor-query-normalisation). (Default: true)
5 * @property transformFieldNames Dictates whether to enable the [field name transformation interceptor](https://github.com/gajus/slonik-interceptor-field-name-transformation). (Default: true)
6 */
7type UserConfigurationType = {|
8  +benchmarkQueries: boolean,
9  +logQueries: boolean,
10  +normaliseQueries: boolean,
11  +transformFieldNames: boolean
12|};
13
14(userConfiguration: UserConfigurationType) => $ReadOnlyArray<InterceptorType>;
15

Example usage

1import {
2  createPool
3} from 'slonik';
4import {
5  createInterceptors
6} from 'slonik-interceptor-preset';
7
8const connection = createPool('postgres://', {
9  interceptors: [
10    ...createInterceptors()
11  ]
12});
13