@stacks/api-toolkit 1.12.0

package/dist/helpers/values.d.ts

@@ -0,0 +1,68 @@
+export declare const isDevEnv: boolean;
+export declare const isTestEnv: boolean;
+export declare const isProdEnv: boolean;
+/**
+ * Digests a string value into a SHA256 hash.
+ * @param content - String input
+ * @returns Hashed value
+ */
+export declare function sha256(content: string): string;
+/**
+ * Parses a boolean string using conventions from CLI arguments, URL query params, and environmental
+ * variables. If the input is defined but empty string then true is returned. If the input is
+ * undefined or null than false is returned. For example, if the input comes from a CLI arg like
+ * `--enable_thing` or URL query param like `?enable_thing`, then this function expects to receive a
+ * defined but empty string, and returns true. Otherwise, it checks or values like `true`, `1`,
+ * `on`, `yes` (and the inverses). Throws if an unexpected input value is provided.
+ */
+export declare function parseBoolean(val: string | undefined | null): boolean;
+/**
+ * Encodes a buffer as a `0x` prefixed lower-case hex string. Returns an empty string if the buffer
+ * is zero length.
+ */
+export declare function bufferToHex(buff: Buffer, prefix?: boolean): string;
+/**
+ * Decodes a `0x` prefixed hex string to a buffer.
+ * @param hex - A hex string with a `0x` prefix.
+ */
+export declare function hexToBuffer(hex: string): Buffer;
+/**
+ * Decodes a hex string to a Buffer, trims the 0x-prefix if exists.
+ * If already a buffer, returns the input immediately.
+ */
+export declare function coerceToBuffer(hex: string | Buffer | ArrayBufferView): Buffer;
+/**
+ * Converts a hex string into a UTF-8 string.
+ * @param hex - Hex string
+ * @returns UTF-8 string
+ */
+export declare function hexToUtf8String(hex: string): string;
+/**
+ * Converts a number to a hex string.
+ * @param number - Number
+ * @param paddingBytes - Padding bytes
+ * @returns Hex string
+ */
+export declare function numberToHex(number: number, paddingBytes?: number): string;
+/**
+ * Checks if a string has `0x` prefix.
+ * @param val - Hex string
+ * @returns Boolean
+ */
+export declare const has0xPrefix: (val: string) => boolean;
+/**
+ * Converts a string to an enum value.
+ * @param enumType - The enum type
+ * @param value - The string value to convert
+ * @returns Enum item or undefined
+ */
+export declare function toEnumValue<T>(enm: {
+    [s: string]: T;
+}, value: string): T | undefined;
+/**
+ * Unwraps a value that may be undefined or null.
+ * @param val - The value to unwrap
+ * @param onNullish - Callback to throw an error if the value is null or undefined
+ * @returns The unwrapped value
+ */
+export declare function unwrap<T>(val: T | null, onNullish?: () => string): Exclude<T, undefined | null>;

package/dist/helpers/values.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.has0xPrefix = exports.isProdEnv = exports.isTestEnv = exports.isDevEnv = void 0;
+exports.sha256 = sha256;
+exports.parseBoolean = parseBoolean;
+exports.bufferToHex = bufferToHex;
+exports.hexToBuffer = hexToBuffer;
+exports.coerceToBuffer = coerceToBuffer;
+exports.hexToUtf8String = hexToUtf8String;
+exports.numberToHex = numberToHex;
+exports.toEnumValue = toEnumValue;
+exports.unwrap = unwrap;
+const node_crypto_1 = require("node:crypto");
+const types_1 = require("node:util/types");
+exports.isDevEnv = process.env.NODE_ENV === 'development';
+exports.isTestEnv = process.env.NODE_ENV === 'test';
+exports.isProdEnv = process.env.NODE_ENV === 'production' ||
+    process.env.NODE_ENV === 'prod' ||
+    !process.env.NODE_ENV ||
+    (!exports.isTestEnv && !exports.isDevEnv);
+/**
+ * Digests a string value into a SHA256 hash.
+ * @param content - String input
+ * @returns Hashed value
+ */
+function sha256(content) {
+    return (0, node_crypto_1.createHash)('sha256').update(content).digest('hex');
+}
+/**
+ * Parses a boolean string using conventions from CLI arguments, URL query params, and environmental
+ * variables. If the input is defined but empty string then true is returned. If the input is
+ * undefined or null than false is returned. For example, if the input comes from a CLI arg like
+ * `--enable_thing` or URL query param like `?enable_thing`, then this function expects to receive a
+ * defined but empty string, and returns true. Otherwise, it checks or values like `true`, `1`,
+ * `on`, `yes` (and the inverses). Throws if an unexpected input value is provided.
+ */
+function parseBoolean(val) {
+    if (typeof val === 'undefined' || val === null) {
+        return false;
+    }
+    switch (val.trim().toLowerCase()) {
+        case '':
+        case 'true':
+        case '1':
+        case 'on':
+        case 'yes':
+            return true;
+        case 'false':
+        case '0':
+        case 'off':
+        case 'no':
+            return false;
+        default:
+            throw new Error(`Cannot parse boolean`);
+    }
+}
+/**
+ * Encodes a buffer as a `0x` prefixed lower-case hex string. Returns an empty string if the buffer
+ * is zero length.
+ */
+function bufferToHex(buff, prefix = true) {
+    return buff.length === 0 ? '' : (prefix ? '0x' : '') + buff.toString('hex');
+}
+/**
+ * Decodes a `0x` prefixed hex string to a buffer.
+ * @param hex - A hex string with a `0x` prefix.
+ */
+function hexToBuffer(hex) {
+    if (hex.length === 0) {
+        return Buffer.alloc(0);
+    }
+    if (!hex.startsWith('0x')) {
+        throw new Error(`Hex string is missing the "0x" prefix`);
+    }
+    if (hex.length % 2 !== 0) {
+        throw new Error(`Hex string is an odd number of digits`);
+    }
+    return Buffer.from(hex.substring(2), 'hex');
+}
+/**
+ * Decodes a hex string to a Buffer, trims the 0x-prefix if exists.
+ * If already a buffer, returns the input immediately.
+ */
+function coerceToBuffer(hex) {
+    if (typeof hex === 'string') {
+        if (hex.startsWith('0x')) {
+            hex = hex.substring(2);
+        }
+        if (hex.length % 2 !== 0) {
+            throw new Error(`Hex string is an odd number of characters`);
+        }
+        if (!/^[0-9a-fA-F]*$/.test(hex)) {
+            throw new Error(`Hex string contains non-hexadecimal characters`);
+        }
+        return Buffer.from(hex, 'hex');
+    }
+    else if (Buffer.isBuffer(hex)) {
+        return hex;
+    }
+    else if ((0, types_1.isArrayBufferView)(hex)) {
+        return Buffer.from(hex.buffer, hex.byteOffset, hex.byteLength);
+    }
+    else {
+        throw new Error(`Cannot convert to Buffer, unexpected type: ${hex.constructor.name}`);
+    }
+}
+/**
+ * Converts a hex string into a UTF-8 string.
+ * @param hex - Hex string
+ * @returns UTF-8 string
+ */
+function hexToUtf8String(hex) {
+    const buffer = hexToBuffer(hex);
+    return buffer.toString('utf8');
+}
+/**
+ * Converts a number to a hex string.
+ * @param number - Number
+ * @param paddingBytes - Padding bytes
+ * @returns Hex string
+ */
+function numberToHex(number, paddingBytes = 4) {
+    let result = number.toString(16);
+    if (result.length % 2 > 0) {
+        result = '0' + result;
+    }
+    if (paddingBytes && result.length / 2 < paddingBytes) {
+        result = '00'.repeat(paddingBytes - result.length / 2) + result;
+    }
+    return '0x' + result;
+}
+/**
+ * Checks if a string has `0x` prefix.
+ * @param val - Hex string
+ * @returns Boolean
+ */
+const has0xPrefix = (val) => val.substring(0, 2).toLowerCase() === '0x';
+exports.has0xPrefix = has0xPrefix;
+/**
+ * Converts a string to an enum value.
+ * @param enumType - The enum type
+ * @param value - The string value to convert
+ * @returns Enum item or undefined
+ */
+function toEnumValue(enm, value) {
+    return Object.values(enm).includes(value)
+        ? value
+        : undefined;
+}
+/**
+ * Unwraps a value that may be undefined or null.
+ * @param val - The value to unwrap
+ * @param onNullish - Callback to throw an error if the value is null or undefined
+ * @returns The unwrapped value
+ */
+function unwrap(val, onNullish) {
+    if (val === undefined) {
+        throw new Error(onNullish?.() ?? 'value is undefined');
+    }
+    if (val === null) {
+        throw new Error(onNullish?.() ?? 'value is null');
+    }
+    return val;
+}
+//# sourceMappingURL=values.js.map

package/dist/helpers/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/helpers/values.ts"],"names":[],"mappings":"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"}

package/dist/helpers/worker-thread-init.d.ts

@@ -0,0 +1 @@
+export declare const filename: string;

package/dist/helpers/worker-thread-init.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filename = void 0;
+const WorkerThreads = require("node:worker_threads");
+const serialize_error_1 = require("./serialize-error");
+// Minimal worker thread initialization code. This file is the entry point for worker threads
+// and is responsible for setting up the worker environment and handling messages from the main thread.
+// Imports should be kept to a minimum to avoid in worker thread init overhead and memory usage.
+exports.filename = __filename;
+/**
+ * Invokes a function that may return a value or a promise, and passes the result
+ * to a callback in a consistent format. Handles both synchronous and asynchronous cases,
+ * ensuring type safety and avoiding unnecessary async transitions for sync functions.
+ */
+function getMaybePromiseResult(fn, cb) {
+    try {
+        const maybePromise = fn();
+        if (maybePromise instanceof Promise) {
+            maybePromise.then(ok => cb({ ok }), (err) => cb({ err }));
+        }
+        else {
+            cb({ ok: maybePromise });
+        }
+    }
+    catch (err) {
+        cb({ err });
+    }
+}
+// Check if this file is being run in a worker thread. If so, it will set up the worker environment.
+if (!WorkerThreads.isMainThread && WorkerThreads.workerData?.workerFile) {
+    const { workerFile } = WorkerThreads.workerData;
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const workerModule = require(workerFile);
+    const parentPort = WorkerThreads.parentPort;
+    // Determine if the worker module `processTask` function is a default export or a named export.
+    const processTask = 'default' in workerModule ? workerModule.default.processTask : workerModule.processTask;
+    parentPort.on('messageerror', err => {
+        console.error(`Worker thread message error`, err);
+    });
+    parentPort.on('message', (message) => {
+        const msg = message;
+        getMaybePromiseResult(() => processTask(...msg.req), result => {
+            try {
+                let reply;
+                if (result.ok) {
+                    reply = {
+                        msgId: msg.msgId,
+                        resp: result.ok,
+                    };
+                }
+                else {
+                    const error = (0, serialize_error_1.isErrorLike)(result.err) ? (0, serialize_error_1.serializeError)(result.err) : result.err;
+                    reply = {
+                        msgId: msg.msgId,
+                        error,
+                    };
+                }
+                parentPort.postMessage(reply);
+            }
+            catch (err) {
+                console.error(`Critical bug in work task processing`, err);
+            }
+        });
+    });
+    parentPort.postMessage('ready');
+}
+//# sourceMappingURL=worker-thread-init.js.map

package/dist/helpers/worker-thread-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-thread-init.js","sourceRoot":"","sources":["../../src/helpers/worker-thread-init.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AAOrD,uDAAgE;AAEhE,6FAA6F;AAC7F,uGAAuG;AACvG,gGAAgG;AAEnF,QAAA,QAAQ,GAAG,UAAU,CAAC;AAEnC;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,EAAwB,EACxB,EAAyE;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,EAAE,EAAE,CAAC;QAC1B,IAAI,YAAY,YAAY,OAAO,EAAE,CAAC;YACpC,YAAY,CAAC,IAAI,CACf,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAChB,CAAC,GAAY,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAC9B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACd,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,IAAI,CAAC,aAAa,CAAC,YAAY,IAAK,aAAa,CAAC,UAAkC,EAAE,UAAU,EAAE,CAAC;IACjG,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,UAAiC,CAAC;IACvE,qGAAqG;IACrG,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAkD,CAAC;IAC1F,MAAM,UAAU,GAAG,aAAa,CAAC,UAAuC,CAAC;IACzE,+FAA+F;IAC/F,MAAM,WAAW,GACf,SAAS,IAAI,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;IAC1F,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE;QAClC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAgB,EAAE,EAAE;QAC5C,MAAM,GAAG,GAAG,OAAkC,CAAC;QAC/C,qBAAqB,CACnB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAC7B,MAAM,CAAC,EAAE;YACP,IAAI,CAAC;gBACH,IAAI,KAAsC,CAAC;gBAC3C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;oBACd,KAAK,GAAG;wBACN,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,IAAI,EAAE,MAAM,CAAC,EAAE;qBAChB,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,KAAK,GAAG,IAAA,6BAAW,EAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,gCAAc,EAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBAChF,KAAK,GAAG;wBACN,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,KAAK;qBACN,CAAC;gBACJ,CAAC;gBACD,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/helpers/worker-thread-manager.d.ts

@@ -0,0 +1,53 @@
+import { EventEmitter } from 'node:events';
+export type WorkerDataInterface = {
+    workerFile: string;
+};
+export type WorkerReqMsg<TArgs extends unknown[]> = {
+    msgId: number;
+    req: TArgs;
+};
+export type WorkerRespMsg<TResp, TErr> = {
+    msgId: number;
+} & ({
+    resp: TResp;
+    error?: null;
+} | {
+    resp?: null;
+    error: TErr;
+});
+export type WorkerPoolModuleInterface<TArgs extends unknown[], TResp> = {
+    workerModule: NodeJS.Module;
+    processTask: (...args: TArgs) => Promise<TResp> | TResp;
+} | {
+    default: {
+        workerModule: NodeJS.Module;
+        processTask: (...args: TArgs) => Promise<TResp> | TResp;
+    };
+};
+export declare class WorkerThreadManager<TArgs extends unknown[], TResp> {
+    private readonly workers;
+    private readonly idleWorkers;
+    private readonly jobQueue;
+    private readonly msgRequests;
+    private lastMsgId;
+    readonly workerCount: number;
+    readonly workerFile: string;
+    private readonly abortControlller;
+    readonly events: EventEmitter<{
+        workersReady: [];
+    }>;
+    get idleWorkerCount(): number;
+    get busyWorkerCount(): number;
+    get queuedJobCount(): number;
+    static init<TArgs extends unknown[], TResp>(workerModule: WorkerPoolModuleInterface<TArgs, TResp>, opts?: {
+        workerCount?: number;
+    }): Promise<WorkerThreadManager<TArgs, TResp>>;
+    constructor(workerModule: WorkerPoolModuleInterface<TArgs, TResp>, opts?: {
+        workerCount?: number;
+    });
+    exec(...args: TArgs): Promise<TResp>;
+    createWorkerPool(): void;
+    private setupWorkerHandler;
+    private assignJobs;
+    close(): Promise<void>;
+}

package/dist/helpers/worker-thread-manager.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerThreadManager = void 0;
+const WorkerThreads = require("node:worker_threads");
+const os = require("node:os");
+const node_events_1 = require("node:events");
+const time_1 = require("./time");
+const serialize_error_1 = require("./serialize-error");
+const worker_thread_init_1 = require("./worker-thread-init");
+class WorkerThreadManager {
+    workers = new Set();
+    idleWorkers = [];
+    jobQueue = [];
+    msgRequests = new Map();
+    lastMsgId = 0;
+    workerCount;
+    workerFile;
+    abortControlller = new AbortController();
+    events = new node_events_1.EventEmitter();
+    get idleWorkerCount() {
+        return this.idleWorkers.length;
+    }
+    get busyWorkerCount() {
+        return this.workerCount - this.idleWorkers.length;
+    }
+    get queuedJobCount() {
+        return this.jobQueue.length;
+    }
+    static init(workerModule, opts = {}) {
+        const workerManager = new WorkerThreadManager(workerModule, opts);
+        return new Promise(resolve => {
+            workerManager.events.once('workersReady', () => {
+                resolve(workerManager);
+            });
+        });
+    }
+    constructor(workerModule, opts = {}) {
+        if (!WorkerThreads.isMainThread) {
+            throw new Error(`${this.constructor.name} must be instantiated in the main thread`);
+        }
+        if ('default' in workerModule) {
+            this.workerFile = workerModule.default.workerModule.filename;
+        }
+        else {
+            this.workerFile = workerModule.workerModule.filename;
+        }
+        this.workerCount = opts.workerCount ?? os.cpus().length;
+        this.createWorkerPool();
+    }
+    exec(...args) {
+        this.abortControlller.signal.throwIfAborted();
+        if (this.lastMsgId >= Number.MAX_SAFE_INTEGER) {
+            this.lastMsgId = 0;
+        }
+        const msgId = this.lastMsgId++;
+        const replyWaiter = (0, time_1.waiter)();
+        this.msgRequests.set(msgId, replyWaiter);
+        const reqMsg = {
+            msgId,
+            req: args,
+        };
+        this.jobQueue.push(reqMsg);
+        this.assignJobs();
+        return replyWaiter;
+    }
+    createWorkerPool() {
+        let workersReady = 0;
+        for (let i = 0; i < this.workerCount; i++) {
+            const workerData = {
+                workerFile: this.workerFile,
+            };
+            const workerOpt = {
+                workerData,
+            };
+            const hasTsSource = worker_thread_init_1.filename.endsWith('.ts') || this.workerFile.endsWith('.ts');
+            if (hasTsSource) {
+                if (process.env.NODE_ENV !== 'test') {
+                    throw new Error('Worker threads are being created with ts-node outside of a test environment');
+                }
+                workerOpt.execArgv = ['-r', 'ts-node/register/transpile-only'];
+            }
+            const worker = new WorkerThreads.Worker(worker_thread_init_1.filename, workerOpt);
+            worker.unref();
+            this.workers.add(worker);
+            worker.on('error', err => {
+                console.error(`Worker error`, err);
+            });
+            worker.on('messageerror', err => {
+                console.error(`Worker message error`, err);
+            });
+            worker.once('message', (message) => {
+                if (message !== 'ready') {
+                    throw new Error(`Unexpected first msg from worker thread: ${JSON.stringify(message)}`);
+                }
+                this.setupWorkerHandler(worker);
+                this.idleWorkers.push(worker);
+                this.assignJobs();
+                workersReady++;
+                if (workersReady === this.workerCount) {
+                    this.events.emit('workersReady');
+                }
+            });
+        }
+        (0, node_events_1.addAbortListener)(this.abortControlller.signal, () => {
+            for (const replyWaiter of this.msgRequests.values()) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                replyWaiter.reject(this.abortControlller.signal.reason);
+            }
+            this.msgRequests.clear();
+        });
+    }
+    setupWorkerHandler(worker) {
+        worker.on('message', (message) => {
+            this.idleWorkers.push(worker);
+            this.assignJobs();
+            const msg = message;
+            const replyWaiter = this.msgRequests.get(msg.msgId);
+            if (replyWaiter) {
+                if (msg.error) {
+                    const error = (0, serialize_error_1.isErrorLike)(msg.error) ? (0, serialize_error_1.deserializeError)(msg.error) : msg.error;
+                    replyWaiter.reject(error);
+                }
+                else if (msg.resp) {
+                    replyWaiter.resolve(msg.resp);
+                }
+                this.msgRequests.delete(msg.msgId);
+            }
+            else {
+                console.error('Received unexpected message from worker', msg);
+            }
+        });
+    }
+    assignJobs() {
+        while (this.idleWorkers.length > 0 && this.jobQueue.length > 0) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            const worker = this.idleWorkers.shift();
+            const job = this.jobQueue.shift();
+            worker.postMessage(job);
+        }
+    }
+    async close() {
+        this.abortControlller.abort();
+        await Promise.all([...this.workers].map(worker => worker.terminate()));
+        this.workers.clear();
+    }
+}
+exports.WorkerThreadManager = WorkerThreadManager;
+//# sourceMappingURL=worker-thread-manager.js.map

package/dist/helpers/worker-thread-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-thread-manager.js","sourceRoot":"","sources":["../../src/helpers/worker-thread-manager.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './fastify';
+export * from './helpers';
+export * from './logger';
+export * from './postgres';
+export * from './profiler';
+export * from './server-version';
+export * from './shutdown-handler';

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fastify"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./postgres"), exports);
+__exportStar(require("./profiler"), exports);
+__exportStar(require("./server-version"), exports);
+__exportStar(require("./shutdown-handler"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,4CAA0B;AAC1B,2CAAyB;AACzB,6CAA2B;AAC3B,6CAA2B;AAC3B,mDAAiC;AACjC,qDAAmC"}

package/dist/logger/index.d.ts

@@ -0,0 +1,20 @@
+export declare const PINO_LOGGER_CONFIG: {
+    name: string;
+    level: string;
+    timestamp: () => string;
+    formatters: {
+        level: (label: string, number: number) => {
+            level: string;
+        };
+    };
+};
+export declare const logger: import("pino").Logger<{
+    name: string;
+    level: string;
+    timestamp: () => string;
+    formatters: {
+        level: (label: string, number: number) => {
+            level: string;
+        };
+    };
+}>;

package/dist/logger/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.PINO_LOGGER_CONFIG = void 0;
+const pino_1 = require("pino");
+exports.PINO_LOGGER_CONFIG = {
+    name: process.env.APPLICATION_NAME ?? 'api',
+    level: process.env.LOG_LEVEL ?? (process.env.NODE_ENV === 'production' ? 'info' : 'debug'),
+    timestamp: pino_1.default.stdTimeFunctions.isoTime,
+    formatters: {
+        level: (label, number) => ({ level: label }),
+    },
+};
+exports.logger = (0, pino_1.default)(exports.PINO_LOGGER_CONFIG);
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":";;;AAAA,+BAAwB;AAEX,QAAA,kBAAkB,GAAG;IAChC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK;IAC3C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1F,SAAS,EAAE,cAAI,CAAC,gBAAgB,CAAC,OAAO;IACxC,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,KAAa,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;KAC7D;CACF,CAAC;AACW,QAAA,MAAM,GAAG,IAAA,cAAI,EAAC,0BAAkB,CAAC,CAAC"}