@forklaunch/core 0.5.3 → 0.5.4

package/lib/cache/index.d.mts

@@ -1,4 +1,7 @@
 import { RedisClientOptions } from 'redis';
+import { O as OpenTelemetryCollector, M as MetricsDefinition } from '../openTelemetryCollector-CWrfzmmW.mjs';
+import '@opentelemetry/api';
+import 'pino';
 
 /**
  * Type representing a TTL (Time-To-Live) cache record.
@@ -67,6 +70,7 @@ interface TtlCache {
  */
 declare class RedisTtlCache implements TtlCache {
     private ttlMilliseconds;
+    private openTelemetryCollector;
     private client;
     /**
      * Creates an instance of RedisTtlCache.
@@ -74,7 +78,7 @@ declare class RedisTtlCache implements TtlCache {
      * @param {number} ttlMilliseconds - The default TTL in milliseconds.
      * @param {RedisClientOptions} [hostingOptions] - The Redis client options.
      */
-    constructor(ttlMilliseconds: number, hostingOptions?: RedisClientOptions);
+    constructor(ttlMilliseconds: number, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, hostingOptions?: RedisClientOptions);
     /**
      * Puts a record into the Redis cache.
      *

package/lib/cache/index.d.ts

@@ -1,4 +1,7 @@
 import { RedisClientOptions } from 'redis';
+import { O as OpenTelemetryCollector, M as MetricsDefinition } from '../openTelemetryCollector-CWrfzmmW.js';
+import '@opentelemetry/api';
+import 'pino';
 
 /**
  * Type representing a TTL (Time-To-Live) cache record.
@@ -67,6 +70,7 @@ interface TtlCache {
  */
 declare class RedisTtlCache implements TtlCache {
     private ttlMilliseconds;
+    private openTelemetryCollector;
     private client;
     /**
      * Creates an instance of RedisTtlCache.
@@ -74,7 +78,7 @@ declare class RedisTtlCache implements TtlCache {
      * @param {number} ttlMilliseconds - The default TTL in milliseconds.
      * @param {RedisClientOptions} [hostingOptions] - The Redis client options.
      */
-    constructor(ttlMilliseconds: number, hostingOptions?: RedisClientOptions);
+    constructor(ttlMilliseconds: number, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, hostingOptions?: RedisClientOptions);
     /**
      * Puts a record into the Redis cache.
      *

package/lib/cache/index.js

@@ -34,11 +34,12 @@ var RedisTtlCache = class {
    * @param {number} ttlMilliseconds - The default TTL in milliseconds.
    * @param {RedisClientOptions} [hostingOptions] - The Redis client options.
    */
-  constructor(ttlMilliseconds, hostingOptions) {
+  constructor(ttlMilliseconds, openTelemetryCollector, hostingOptions) {
     this.ttlMilliseconds = ttlMilliseconds;
+    this.openTelemetryCollector = openTelemetryCollector;
     this.client = (0, import_redis.createClient)(hostingOptions);
-    this.client.on("error", (err) => console.error("Redis Client Error", err));
-    this.client.connect().catch(console.error);
+    this.client.on("error", (err) => openTelemetryCollector.error(err));
+    this.client.connect().catch(openTelemetryCollector.error);
   }
   client;
   /**

package/lib/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cache/index.ts","../../src/cache/redisTtlCache.ts","../../src/cache/utils/cacheKey.ts"],"sourcesContent":["export * from './interfaces/ttlCache.interface';\nexport * from './redisTtlCache';\nexport * from './types/ttlCacheRecord.types';\nexport * from './utils/cacheKey';\n","import { RedisClientOptions, createClient } from 'redis';\nimport { TtlCache } from './interfaces/ttlCache.interface';\nimport { TtlCacheRecord } from './types/ttlCacheRecord.types';\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default TTL in milliseconds.\n   * @param {RedisClientOptions} [hostingOptions] - The Redis client options.\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    hostingOptions?: RedisClientOptions\n  ) {\n    // Connects to localhost:6379 by default\n    // url usage: redis[s]://[[username][:password]@][host][:port][/db-number]\n    this.client = createClient(hostingOptions);\n    this.client.on('error', (err) => console.error('Redis Client Error', err));\n    this.client.connect().catch(console.error);\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @param {TtlCacheRecord} param0 - The cache record to put into the cache.\n   * @returns {Promise<void>} - A promise that resolves when the record is put into the cache.\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    await this.client.set(key, JSON.stringify(value), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to delete.\n   * @returns {Promise<void>} - A promise that resolves when the record is deleted from the cache.\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to read.\n   * @returns {Promise<TtlCacheRecord>} - A promise that resolves with the cache record.\n   * @throws {Error} - Throws an error if the record is not found.\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const value = await this.client.get(cacheRecordKey);\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n    const ttl = await this.client.ttl(cacheRecordKey); // Fetch TTL from Redis\n    return {\n      key: cacheRecordKey,\n      value: JSON.parse(value),\n      ttlMilliseconds: ttl * 1000\n    };\n  }\n\n  /**\n   * Lists the keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The pattern prefix to match.\n   * @returns {Promise<string[]>} - A promise that resolves with an array of keys matching the pattern prefix.\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Peeks at a record in the Redis cache to check if it exists.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to peek at.\n   * @returns {Promise<boolean>} - A promise that resolves with a boolean indicating if the record exists.\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Disconnects the Redis client.\n   *\n   * @returns {Promise<void>} - A promise that resolves when the client is disconnected.\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default TTL (Time-To-Live) in milliseconds.\n   *\n   * @returns {number} - The TTL in milliseconds.\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n}\n","export const createCacheKey = (cacheKeyPrefix: string) => (id: string) => {\n  return `${cacheKeyPrefix}:${id}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAiD;AAQ1C,IAAM,gBAAN,MAAwC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS7C,YACU,iBACR,gBACA;AAFQ;AAKR,SAAK,aAAS,2BAAa,cAAc;AACzC,SAAK,OAAO,GAAG,SAAS,CAAC,QAAQ,QAAQ,MAAM,sBAAsB,GAAG,CAAC;AACzE,SAAK,OAAO,QAAQ,EAAE,MAAM,QAAQ,KAAK;AAAA,EAC3C;AAAA,EAjBQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBR,MAAM,UAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA,kBAAkB,KAAK;AAAA,EACzB,GAAqC;AACnC,UAAM,KAAK,OAAO,IAAI,KAAK,KAAK,UAAU,KAAK,GAAG;AAAA,MAChD,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,aAAa,gBAAuC;AACxD,UAAM,KAAK,OAAO,IAAI,cAAc;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAc,gBAAoD;AACtE,UAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,cAAc;AAClD,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,6BAA6B,cAAc,EAAE;AAAA,IAC/D;AACA,UAAM,MAAM,MAAM,KAAK,OAAO,IAAI,cAAc;AAChD,WAAO;AAAA,MACL,KAAK;AAAA,MACL,OAAO,KAAK,MAAM,KAAK;AAAA,MACvB,iBAAiB,MAAM;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,SAAS,gBAA2C;AACxD,UAAM,OAAO,MAAM,KAAK,OAAO,KAAK,iBAAiB,GAAG;AACxD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WAAW,gBAA0C;AACzD,UAAM,SAAS,MAAM,KAAK,OAAO,OAAO,cAAc;AACtD,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAA4B;AAChC,UAAM,KAAK,OAAO,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AACF;;;ACjHO,IAAM,iBAAiB,CAAC,mBAA2B,CAAC,OAAe;AACxE,SAAO,GAAG,cAAc,IAAI,EAAE;AAChC;","names":[]}
+{"version":3,"sources":["../../src/cache/index.ts","../../src/cache/redisTtlCache.ts","../../src/cache/utils/cacheKey.ts"],"sourcesContent":["export * from './interfaces/ttlCache.interface';\nexport * from './redisTtlCache';\nexport * from './types/ttlCacheRecord.types';\nexport * from './utils/cacheKey';\n","import { RedisClientOptions, createClient } from 'redis';\nimport { TtlCache } from './interfaces/ttlCache.interface';\nimport { TtlCacheRecord } from './types/ttlCacheRecord.types';\nimport { OpenTelemetryCollector } from '../http/telemetry/openTelemetryCollector';\nimport { MetricsDefinition } from '../http';\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default TTL in milliseconds.\n   * @param {RedisClientOptions} [hostingOptions] - The Redis client options.\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,\n    hostingOptions?: RedisClientOptions\n  ) {\n    // Connects to localhost:6379 by default\n    // url usage: redis[s]://[[username][:password]@][host][:port][/db-number]\n    this.client = createClient(hostingOptions);\n    this.client.on('error', (err) => openTelemetryCollector.error(err));\n    this.client.connect().catch(openTelemetryCollector.error);\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @param {TtlCacheRecord} param0 - The cache record to put into the cache.\n   * @returns {Promise<void>} - A promise that resolves when the record is put into the cache.\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    await this.client.set(key, JSON.stringify(value), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to delete.\n   * @returns {Promise<void>} - A promise that resolves when the record is deleted from the cache.\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to read.\n   * @returns {Promise<TtlCacheRecord>} - A promise that resolves with the cache record.\n   * @throws {Error} - Throws an error if the record is not found.\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const value = await this.client.get(cacheRecordKey);\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n    const ttl = await this.client.ttl(cacheRecordKey); // Fetch TTL from Redis\n    return {\n      key: cacheRecordKey,\n      value: JSON.parse(value),\n      ttlMilliseconds: ttl * 1000\n    };\n  }\n\n  /**\n   * Lists the keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The pattern prefix to match.\n   * @returns {Promise<string[]>} - A promise that resolves with an array of keys matching the pattern prefix.\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Peeks at a record in the Redis cache to check if it exists.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to peek at.\n   * @returns {Promise<boolean>} - A promise that resolves with a boolean indicating if the record exists.\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Disconnects the Redis client.\n   *\n   * @returns {Promise<void>} - A promise that resolves when the client is disconnected.\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default TTL (Time-To-Live) in milliseconds.\n   *\n   * @returns {number} - The TTL in milliseconds.\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n}\n","export const createCacheKey = (cacheKeyPrefix: string) => (id: string) => {\n  return `${cacheKeyPrefix}:${id}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAiD;AAU1C,IAAM,gBAAN,MAAwC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS7C,YACU,iBACA,wBACR,gBACA;AAHQ;AACA;AAKR,SAAK,aAAS,2BAAa,cAAc;AACzC,SAAK,OAAO,GAAG,SAAS,CAAC,QAAQ,uBAAuB,MAAM,GAAG,CAAC;AAClE,SAAK,OAAO,QAAQ,EAAE,MAAM,uBAAuB,KAAK;AAAA,EAC1D;AAAA,EAlBQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BR,MAAM,UAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA,kBAAkB,KAAK;AAAA,EACzB,GAAqC;AACnC,UAAM,KAAK,OAAO,IAAI,KAAK,KAAK,UAAU,KAAK,GAAG;AAAA,MAChD,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,aAAa,gBAAuC;AACxD,UAAM,KAAK,OAAO,IAAI,cAAc;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAc,gBAAoD;AACtE,UAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,cAAc;AAClD,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,6BAA6B,cAAc,EAAE;AAAA,IAC/D;AACA,UAAM,MAAM,MAAM,KAAK,OAAO,IAAI,cAAc;AAChD,WAAO;AAAA,MACL,KAAK;AAAA,MACL,OAAO,KAAK,MAAM,KAAK;AAAA,MACvB,iBAAiB,MAAM;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,SAAS,gBAA2C;AACxD,UAAM,OAAO,MAAM,KAAK,OAAO,KAAK,iBAAiB,GAAG;AACxD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WAAW,gBAA0C;AACzD,UAAM,SAAS,MAAM,KAAK,OAAO,OAAO,cAAc;AACtD,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAA4B;AAChC,UAAM,KAAK,OAAO,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AACF;;;ACpHO,IAAM,iBAAiB,CAAC,mBAA2B,CAAC,OAAe;AACxE,SAAO,GAAG,cAAc,IAAI,EAAE;AAChC;","names":[]}

package/lib/cache/index.mjs

@@ -7,11 +7,12 @@ var RedisTtlCache = class {
    * @param {number} ttlMilliseconds - The default TTL in milliseconds.
    * @param {RedisClientOptions} [hostingOptions] - The Redis client options.
    */
-  constructor(ttlMilliseconds, hostingOptions) {
+  constructor(ttlMilliseconds, openTelemetryCollector, hostingOptions) {
     this.ttlMilliseconds = ttlMilliseconds;
+    this.openTelemetryCollector = openTelemetryCollector;
     this.client = createClient(hostingOptions);
-    this.client.on("error", (err) => console.error("Redis Client Error", err));
-    this.client.connect().catch(console.error);
+    this.client.on("error", (err) => openTelemetryCollector.error(err));
+    this.client.connect().catch(openTelemetryCollector.error);
   }
   client;
   /**

package/lib/cache/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cache/redisTtlCache.ts","../../src/cache/utils/cacheKey.ts"],"sourcesContent":["import { RedisClientOptions, createClient } from 'redis';\nimport { TtlCache } from './interfaces/ttlCache.interface';\nimport { TtlCacheRecord } from './types/ttlCacheRecord.types';\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default TTL in milliseconds.\n   * @param {RedisClientOptions} [hostingOptions] - The Redis client options.\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    hostingOptions?: RedisClientOptions\n  ) {\n    // Connects to localhost:6379 by default\n    // url usage: redis[s]://[[username][:password]@][host][:port][/db-number]\n    this.client = createClient(hostingOptions);\n    this.client.on('error', (err) => console.error('Redis Client Error', err));\n    this.client.connect().catch(console.error);\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @param {TtlCacheRecord} param0 - The cache record to put into the cache.\n   * @returns {Promise<void>} - A promise that resolves when the record is put into the cache.\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    await this.client.set(key, JSON.stringify(value), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to delete.\n   * @returns {Promise<void>} - A promise that resolves when the record is deleted from the cache.\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to read.\n   * @returns {Promise<TtlCacheRecord>} - A promise that resolves with the cache record.\n   * @throws {Error} - Throws an error if the record is not found.\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const value = await this.client.get(cacheRecordKey);\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n    const ttl = await this.client.ttl(cacheRecordKey); // Fetch TTL from Redis\n    return {\n      key: cacheRecordKey,\n      value: JSON.parse(value),\n      ttlMilliseconds: ttl * 1000\n    };\n  }\n\n  /**\n   * Lists the keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The pattern prefix to match.\n   * @returns {Promise<string[]>} - A promise that resolves with an array of keys matching the pattern prefix.\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Peeks at a record in the Redis cache to check if it exists.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to peek at.\n   * @returns {Promise<boolean>} - A promise that resolves with a boolean indicating if the record exists.\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Disconnects the Redis client.\n   *\n   * @returns {Promise<void>} - A promise that resolves when the client is disconnected.\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default TTL (Time-To-Live) in milliseconds.\n   *\n   * @returns {number} - The TTL in milliseconds.\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n}\n","export const createCacheKey = (cacheKeyPrefix: string) => (id: string) => {\n  return `${cacheKeyPrefix}:${id}`;\n};\n"],"mappings":";AAAA,SAA6B,oBAAoB;AAQ1C,IAAM,gBAAN,MAAwC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS7C,YACU,iBACR,gBACA;AAFQ;AAKR,SAAK,SAAS,aAAa,cAAc;AACzC,SAAK,OAAO,GAAG,SAAS,CAAC,QAAQ,QAAQ,MAAM,sBAAsB,GAAG,CAAC;AACzE,SAAK,OAAO,QAAQ,EAAE,MAAM,QAAQ,KAAK;AAAA,EAC3C;AAAA,EAjBQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBR,MAAM,UAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA,kBAAkB,KAAK;AAAA,EACzB,GAAqC;AACnC,UAAM,KAAK,OAAO,IAAI,KAAK,KAAK,UAAU,KAAK,GAAG;AAAA,MAChD,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,aAAa,gBAAuC;AACxD,UAAM,KAAK,OAAO,IAAI,cAAc;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAc,gBAAoD;AACtE,UAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,cAAc;AAClD,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,6BAA6B,cAAc,EAAE;AAAA,IAC/D;AACA,UAAM,MAAM,MAAM,KAAK,OAAO,IAAI,cAAc;AAChD,WAAO;AAAA,MACL,KAAK;AAAA,MACL,OAAO,KAAK,MAAM,KAAK;AAAA,MACvB,iBAAiB,MAAM;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,SAAS,gBAA2C;AACxD,UAAM,OAAO,MAAM,KAAK,OAAO,KAAK,iBAAiB,GAAG;AACxD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WAAW,gBAA0C;AACzD,UAAM,SAAS,MAAM,KAAK,OAAO,OAAO,cAAc;AACtD,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAA4B;AAChC,UAAM,KAAK,OAAO,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AACF;;;ACjHO,IAAM,iBAAiB,CAAC,mBAA2B,CAAC,OAAe;AACxE,SAAO,GAAG,cAAc,IAAI,EAAE;AAChC;","names":[]}
+{"version":3,"sources":["../../src/cache/redisTtlCache.ts","../../src/cache/utils/cacheKey.ts"],"sourcesContent":["import { RedisClientOptions, createClient } from 'redis';\nimport { TtlCache } from './interfaces/ttlCache.interface';\nimport { TtlCacheRecord } from './types/ttlCacheRecord.types';\nimport { OpenTelemetryCollector } from '../http/telemetry/openTelemetryCollector';\nimport { MetricsDefinition } from '../http';\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default TTL in milliseconds.\n   * @param {RedisClientOptions} [hostingOptions] - The Redis client options.\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,\n    hostingOptions?: RedisClientOptions\n  ) {\n    // Connects to localhost:6379 by default\n    // url usage: redis[s]://[[username][:password]@][host][:port][/db-number]\n    this.client = createClient(hostingOptions);\n    this.client.on('error', (err) => openTelemetryCollector.error(err));\n    this.client.connect().catch(openTelemetryCollector.error);\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @param {TtlCacheRecord} param0 - The cache record to put into the cache.\n   * @returns {Promise<void>} - A promise that resolves when the record is put into the cache.\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    await this.client.set(key, JSON.stringify(value), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to delete.\n   * @returns {Promise<void>} - A promise that resolves when the record is deleted from the cache.\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to read.\n   * @returns {Promise<TtlCacheRecord>} - A promise that resolves with the cache record.\n   * @throws {Error} - Throws an error if the record is not found.\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const value = await this.client.get(cacheRecordKey);\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n    const ttl = await this.client.ttl(cacheRecordKey); // Fetch TTL from Redis\n    return {\n      key: cacheRecordKey,\n      value: JSON.parse(value),\n      ttlMilliseconds: ttl * 1000\n    };\n  }\n\n  /**\n   * Lists the keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The pattern prefix to match.\n   * @returns {Promise<string[]>} - A promise that resolves with an array of keys matching the pattern prefix.\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Peeks at a record in the Redis cache to check if it exists.\n   *\n   * @param {string} cacheRecordKey - The key of the cache record to peek at.\n   * @returns {Promise<boolean>} - A promise that resolves with a boolean indicating if the record exists.\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Disconnects the Redis client.\n   *\n   * @returns {Promise<void>} - A promise that resolves when the client is disconnected.\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default TTL (Time-To-Live) in milliseconds.\n   *\n   * @returns {number} - The TTL in milliseconds.\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n}\n","export const createCacheKey = (cacheKeyPrefix: string) => (id: string) => {\n  return `${cacheKeyPrefix}:${id}`;\n};\n"],"mappings":";AAAA,SAA6B,oBAAoB;AAU1C,IAAM,gBAAN,MAAwC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS7C,YACU,iBACA,wBACR,gBACA;AAHQ;AACA;AAKR,SAAK,SAAS,aAAa,cAAc;AACzC,SAAK,OAAO,GAAG,SAAS,CAAC,QAAQ,uBAAuB,MAAM,GAAG,CAAC;AAClE,SAAK,OAAO,QAAQ,EAAE,MAAM,uBAAuB,KAAK;AAAA,EAC1D;AAAA,EAlBQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BR,MAAM,UAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA,kBAAkB,KAAK;AAAA,EACzB,GAAqC;AACnC,UAAM,KAAK,OAAO,IAAI,KAAK,KAAK,UAAU,KAAK,GAAG;AAAA,MAChD,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,aAAa,gBAAuC;AACxD,UAAM,KAAK,OAAO,IAAI,cAAc;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAc,gBAAoD;AACtE,UAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,cAAc;AAClD,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,6BAA6B,cAAc,EAAE;AAAA,IAC/D;AACA,UAAM,MAAM,MAAM,KAAK,OAAO,IAAI,cAAc;AAChD,WAAO;AAAA,MACL,KAAK;AAAA,MACL,OAAO,KAAK,MAAM,KAAK;AAAA,MACvB,iBAAiB,MAAM;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,SAAS,gBAA2C;AACxD,UAAM,OAAO,MAAM,KAAK,OAAO,KAAK,iBAAiB,GAAG;AACxD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WAAW,gBAA0C;AACzD,UAAM,SAAS,MAAM,KAAK,OAAO,OAAO,cAAc;AACtD,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAA4B;AAChC,UAAM,KAAK,OAAO,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AACF;;;ACpHO,IAAM,iBAAiB,CAAC,mBAA2B,CAAC,OAAe;AACxE,SAAO,GAAG,cAAc,IAAI,EAAE;AAChC;","names":[]}

package/lib/http/index.d.mts

@@ -1,7 +1,10 @@
 import { AnySchemaValidator, UnboxedObjectSchema, IdiomaticSchema, Schema } from '@forklaunch/validator';
 import { Prettify, RemoveTrailingSlash, MakePropertyOptionalIfChildrenOptional } from '@forklaunch/common';
-import { Span, Counter, Gauge, Histogram, UpDownCounter, ObservableCounter, ObservableGauge, ObservableUpDownCounter } from '@opentelemetry/api';
+import { Span } from '@opentelemetry/api';
 import { ParsedQs } from 'qs';
+import { Readable } from 'stream';
+import { O as OpenTelemetryCollector, M as MetricsDefinition, L as LoggerMeta, a as LogFn } from '../openTelemetryCollector-CWrfzmmW.mjs';
+export { c as MetricType, h as httpRequestsTotalCounter, b as httpServerDurationHistogram } from '../openTelemetryCollector-CWrfzmmW.mjs';
 import { OpenAPIObject } from 'openapi3-ts/oas31';
 import { AnyValueMap } from '@opentelemetry/api-logs';
 import { LevelWithSilentOrString, LevelWithSilent, Logger } from 'pino';
@@ -292,6 +295,8 @@ interface ForklaunchRequest<SV extends AnySchemaValidator, P extends ParamsDicti
     requestSchema: unknown;
     /** Original path */
     originalPath: string;
+    /** OpenTelemetry Collector */
+    openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
 }
 /**
  * Represents the types of data that can be sent in a response.
@@ -355,6 +360,18 @@ interface ForklaunchResponse<ResBodyMap extends Record<number, unknown>, ResHead
      * @param {string} value - The header value.
      */
     setHeader: <K extends keyof (ResHeaders & ForklaunchResHeaders)>(key: K, value: K extends keyof ForklaunchResHeaders ? ForklaunchResHeaders[K] : ResHeaders[K]) => void;
+    /**
+     * Adds an event listener to the response.
+     * @param {string} event - The event to listen for.
+     * @param {Function} listener - The listener function.
+     */
+    on(event: 'close', listener: () => void): this;
+    on(event: 'drain', listener: () => void): this;
+    on(event: 'error', listener: (err: Error) => void): this;
+    on(event: 'finish', listener: () => void): this;
+    on(event: 'pipe', listener: (src: Readable) => void): this;
+    on(event: 'unpipe', listener: (src: Readable) => void): this;
+    on(event: string | symbol, listener: (...args: unknown[]) => void): this;
     /**
      * Sets the status of the response.
      * @param {U} code - The status code.
@@ -370,6 +387,11 @@ interface ForklaunchResponse<ResBodyMap extends Record<number, unknown>, ResHead
      * @param {string} [data] - Optional data to send.
      */
     end: (data?: string) => void;
+    /**
+     * Sets the content type of the response.
+     * @param {string} type - The content type.
+     */
+    type: (type: string) => void;
     /** Local variables */
     locals: LocalsObj;
     /** Cors */
@@ -618,11 +640,12 @@ declare class ForklaunchExpressLikeRouter<SV extends AnySchemaValidator, BasePat
     #private;
     readonly schemaValidator: SV;
     readonly internal: Internal;
+    readonly openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
     requestHandler: RouterHandler;
     routers: ForklaunchRouter<SV>[];
     readonly routes: ForklaunchRoute<SV>[];
     readonly basePath: BasePath;
-    constructor(basePath: BasePath, schemaValidator: SV, internal: Internal);
+    constructor(basePath: BasePath, schemaValidator: SV, internal: Internal, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>);
     registerRoute<ContractMethod extends Method, Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(method: ContractMethod, path: Path, registrationMethod: PathBasedHandler<RouterHandler>, contractDetailsOrMiddlewareOrTypedHandler: ContractDetailsOrMiddlewareOrTypedHandler<SV, ContractMethod, Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>, ...middlewareOrMiddlewareAndTypedHandler: MiddlewareOrMiddlewareWithTypedHandler<SV, ContractMethod, Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>[]): LiveTypeFunction<SV, `${BasePath}${Path}`, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders>;
     registerMiddlewareHandler<Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(registrationMethod: PathOrMiddlewareBasedHandler<RouterHandler>, pathOrContractDetailsOrMiddlewareOrTypedHandler: Path | ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>, contractDetailsOrMiddlewareOrTypedHandler?: ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>, ...middlewareOrMiddlewareWithTypedHandler: MiddlewareOrMiddlewareWithTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>[]): this;
     registerNestableMiddlewareHandler<Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(registrationMethod: NestableRouterBasedHandler<RouterHandler, Internal>, pathOrContractDetailsOrMiddlewareOrTypedHandler: Path | ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction> | ConstrainedForklaunchRouter<SV, RouterHandler>, contractDetailsOrMiddlewareOrTypedHandler?: ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction> | ConstrainedForklaunchRouter<SV, RouterHandler>, ...middlewareOrMiddlewareWithTypedHandler: (MiddlewareOrMiddlewareWithTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction> | ConstrainedForklaunchRouter<SV, RouterHandler>)[]): this;
@@ -752,12 +775,13 @@ declare class ForklaunchExpressLikeRouter<SV extends AnySchemaValidator, BasePat
 declare abstract class ForklaunchExpressLikeApplication<SV extends AnySchemaValidator, Server extends ExpressLikeRouter<RouterHandler, Server>, RouterHandler, BaseRequest, BaseResponse, NextFunction> extends ForklaunchExpressLikeRouter<SV, '/', RouterHandler, Server, BaseRequest, BaseResponse, NextFunction> {
     readonly schemaValidator: SV;
     readonly internal: Server;
+    readonly openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
     /**
      * Creates an instance of the Application class.
      *
      * @param {SV} schemaValidator - The schema validator.
      */
-    constructor(schemaValidator: SV, internal: Server);
+    constructor(schemaValidator: SV, internal: Server, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>);
     abstract listen(...args: unknown[]): void;
 }
 
@@ -914,43 +938,20 @@ declare function generateSwaggerDocument<SV extends AnySchemaValidator>(schemaVa
 declare const ATTR_API_NAME = "api.name";
 declare const ATTR_CORRELATION_ID = "correlation.id";
 
-type MetricType<T extends string> = T extends 'counter' ? Counter : T extends 'gauge' ? Gauge : T extends 'histogram' ? Histogram : T extends 'upDownCounter' ? UpDownCounter : T extends 'observableCounter' ? ObservableCounter : T extends 'observableGauge' ? ObservableGauge : T extends 'observableUpDownCounter' ? ObservableUpDownCounter : undefined;
-type MetricsDefinition = Record<string, 'counter' | 'gauge' | 'histogram' | 'upDownCounter' | 'observableCounter' | 'observableGauge' | 'observableUpDownCounter'>;
-
 declare function metricsDefinitions<T extends MetricsDefinition>(metrics: T): T;
 
-declare class OpenTelemetryCollector<AppliedMetricsDefinition extends MetricsDefinition> {
-    private readonly serviceName;
-    private readonly logger;
-    private readonly metrics;
-    constructor(serviceName: string, level?: LevelWithSilentOrString, metricDefinitions?: AppliedMetricsDefinition);
-    log(level: LevelWithSilent, msg: string, meta?: AnyValueMap): void;
-    info(msg: string, meta?: AnyValueMap): void;
-    error(msg: string, meta?: AnyValueMap): void;
-    warn(msg: string, meta?: AnyValueMap): void;
-    debug(msg: string, meta?: AnyValueMap): void;
-    trace(msg: string, meta?: AnyValueMap): void;
-    getMetric<T extends keyof AppliedMetricsDefinition>(metricId: T): MetricType<AppliedMetricsDefinition[T]>;
-}
-declare const httpRequestsTotalCounter: Counter<{
-    "service.name": string;
-    "api.name": string;
-    "correlation.id": string;
-    "http.request.method": string;
-    "http.route": string;
-    "http.response.status_code": number;
-}>;
-
+declare function meta(meta: Record<string, unknown>): LoggerMeta;
 declare class PinoLogger {
     private pinoLogger;
     private meta;
+    private prettyPrinter;
     constructor(level: LevelWithSilentOrString, meta?: AnyValueMap);
-    log(level: LevelWithSilent, msg: string, meta?: AnyValueMap): void;
-    error(msg: string, meta?: AnyValueMap): void;
-    info(msg: string, meta?: AnyValueMap): void;
-    debug(msg: string, meta?: AnyValueMap): void;
-    warn(msg: string, meta?: AnyValueMap): void;
-    trace(msg: string, meta?: AnyValueMap): void;
+    log(level: LevelWithSilent, ...args: (string | unknown | LoggerMeta)[]): void;
+    error: LogFn;
+    info: LogFn;
+    debug: LogFn;
+    warn: LogFn;
+    trace: LogFn;
     child(meta?: AnyValueMap): PinoLogger;
     getBaseLogger(): Logger;
 }
@@ -958,4 +959,4 @@ declare function logger(level: LevelWithSilentOrString, meta?: AnyValueMap): Pin
 
 declare function recordMetric<SV extends AnySchemaValidator, P extends ParamsDictionary, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ResBodyMap extends Record<string, unknown>, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>>(req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<ResBodyMap, ResHeaders, LocalsObj>): void;
 
-export { ATTR_API_NAME, ATTR_CORRELATION_ID, type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExpressLikeTypedHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, type MetricType, type MetricsDefinition, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, OpenTelemetryCollector, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResolvedForklaunchRequest, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, httpRequestsTotalCounter, isClientError, isForklaunchRequest, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, logger, metricsDefinitions, middleware, options, patch, post, put, recordMetric, trace, typedHandler };
+export { ATTR_API_NAME, ATTR_CORRELATION_ID, type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExpressLikeTypedHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, LogFn, LoggerMeta, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, MetricsDefinition, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, OpenTelemetryCollector, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResolvedForklaunchRequest, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, isClientError, isForklaunchRequest, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, logger, meta, metricsDefinitions, middleware, options, patch, post, put, recordMetric, trace, typedHandler };

package/lib/http/index.d.ts

@@ -1,7 +1,10 @@
 import { AnySchemaValidator, UnboxedObjectSchema, IdiomaticSchema, Schema } from '@forklaunch/validator';
 import { Prettify, RemoveTrailingSlash, MakePropertyOptionalIfChildrenOptional } from '@forklaunch/common';
-import { Span, Counter, Gauge, Histogram, UpDownCounter, ObservableCounter, ObservableGauge, ObservableUpDownCounter } from '@opentelemetry/api';
+import { Span } from '@opentelemetry/api';
 import { ParsedQs } from 'qs';
+import { Readable } from 'stream';
+import { O as OpenTelemetryCollector, M as MetricsDefinition, L as LoggerMeta, a as LogFn } from '../openTelemetryCollector-CWrfzmmW.js';
+export { c as MetricType, h as httpRequestsTotalCounter, b as httpServerDurationHistogram } from '../openTelemetryCollector-CWrfzmmW.js';
 import { OpenAPIObject } from 'openapi3-ts/oas31';
 import { AnyValueMap } from '@opentelemetry/api-logs';
 import { LevelWithSilentOrString, LevelWithSilent, Logger } from 'pino';
@@ -292,6 +295,8 @@ interface ForklaunchRequest<SV extends AnySchemaValidator, P extends ParamsDicti
     requestSchema: unknown;
     /** Original path */
     originalPath: string;
+    /** OpenTelemetry Collector */
+    openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
 }
 /**
  * Represents the types of data that can be sent in a response.
@@ -355,6 +360,18 @@ interface ForklaunchResponse<ResBodyMap extends Record<number, unknown>, ResHead
      * @param {string} value - The header value.
      */
     setHeader: <K extends keyof (ResHeaders & ForklaunchResHeaders)>(key: K, value: K extends keyof ForklaunchResHeaders ? ForklaunchResHeaders[K] : ResHeaders[K]) => void;
+    /**
+     * Adds an event listener to the response.
+     * @param {string} event - The event to listen for.
+     * @param {Function} listener - The listener function.
+     */
+    on(event: 'close', listener: () => void): this;
+    on(event: 'drain', listener: () => void): this;
+    on(event: 'error', listener: (err: Error) => void): this;
+    on(event: 'finish', listener: () => void): this;
+    on(event: 'pipe', listener: (src: Readable) => void): this;
+    on(event: 'unpipe', listener: (src: Readable) => void): this;
+    on(event: string | symbol, listener: (...args: unknown[]) => void): this;
     /**
      * Sets the status of the response.
      * @param {U} code - The status code.
@@ -370,6 +387,11 @@ interface ForklaunchResponse<ResBodyMap extends Record<number, unknown>, ResHead
      * @param {string} [data] - Optional data to send.
      */
     end: (data?: string) => void;
+    /**
+     * Sets the content type of the response.
+     * @param {string} type - The content type.
+     */
+    type: (type: string) => void;
     /** Local variables */
     locals: LocalsObj;
     /** Cors */
@@ -618,11 +640,12 @@ declare class ForklaunchExpressLikeRouter<SV extends AnySchemaValidator, BasePat
     #private;
     readonly schemaValidator: SV;
     readonly internal: Internal;
+    readonly openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
     requestHandler: RouterHandler;
     routers: ForklaunchRouter<SV>[];
     readonly routes: ForklaunchRoute<SV>[];
     readonly basePath: BasePath;
-    constructor(basePath: BasePath, schemaValidator: SV, internal: Internal);
+    constructor(basePath: BasePath, schemaValidator: SV, internal: Internal, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>);
     registerRoute<ContractMethod extends Method, Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(method: ContractMethod, path: Path, registrationMethod: PathBasedHandler<RouterHandler>, contractDetailsOrMiddlewareOrTypedHandler: ContractDetailsOrMiddlewareOrTypedHandler<SV, ContractMethod, Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>, ...middlewareOrMiddlewareAndTypedHandler: MiddlewareOrMiddlewareWithTypedHandler<SV, ContractMethod, Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>[]): LiveTypeFunction<SV, `${BasePath}${Path}`, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders>;
     registerMiddlewareHandler<Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(registrationMethod: PathOrMiddlewareBasedHandler<RouterHandler>, pathOrContractDetailsOrMiddlewareOrTypedHandler: Path | ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>, contractDetailsOrMiddlewareOrTypedHandler?: ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>, ...middlewareOrMiddlewareWithTypedHandler: MiddlewareOrMiddlewareWithTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction>[]): this;
     registerNestableMiddlewareHandler<Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(registrationMethod: NestableRouterBasedHandler<RouterHandler, Internal>, pathOrContractDetailsOrMiddlewareOrTypedHandler: Path | ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction> | ConstrainedForklaunchRouter<SV, RouterHandler>, contractDetailsOrMiddlewareOrTypedHandler?: ContractDetailsOrMiddlewareOrTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction> | ConstrainedForklaunchRouter<SV, RouterHandler>, ...middlewareOrMiddlewareWithTypedHandler: (MiddlewareOrMiddlewareWithTypedHandler<SV, 'middleware', Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, BaseRequest, BaseResponse, NextFunction> | ConstrainedForklaunchRouter<SV, RouterHandler>)[]): this;
@@ -752,12 +775,13 @@ declare class ForklaunchExpressLikeRouter<SV extends AnySchemaValidator, BasePat
 declare abstract class ForklaunchExpressLikeApplication<SV extends AnySchemaValidator, Server extends ExpressLikeRouter<RouterHandler, Server>, RouterHandler, BaseRequest, BaseResponse, NextFunction> extends ForklaunchExpressLikeRouter<SV, '/', RouterHandler, Server, BaseRequest, BaseResponse, NextFunction> {
     readonly schemaValidator: SV;
     readonly internal: Server;
+    readonly openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
     /**
      * Creates an instance of the Application class.
      *
      * @param {SV} schemaValidator - The schema validator.
      */
-    constructor(schemaValidator: SV, internal: Server);
+    constructor(schemaValidator: SV, internal: Server, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>);
     abstract listen(...args: unknown[]): void;
 }
 
@@ -914,43 +938,20 @@ declare function generateSwaggerDocument<SV extends AnySchemaValidator>(schemaVa
 declare const ATTR_API_NAME = "api.name";
 declare const ATTR_CORRELATION_ID = "correlation.id";
 
-type MetricType<T extends string> = T extends 'counter' ? Counter : T extends 'gauge' ? Gauge : T extends 'histogram' ? Histogram : T extends 'upDownCounter' ? UpDownCounter : T extends 'observableCounter' ? ObservableCounter : T extends 'observableGauge' ? ObservableGauge : T extends 'observableUpDownCounter' ? ObservableUpDownCounter : undefined;
-type MetricsDefinition = Record<string, 'counter' | 'gauge' | 'histogram' | 'upDownCounter' | 'observableCounter' | 'observableGauge' | 'observableUpDownCounter'>;
-
 declare function metricsDefinitions<T extends MetricsDefinition>(metrics: T): T;
 
-declare class OpenTelemetryCollector<AppliedMetricsDefinition extends MetricsDefinition> {
-    private readonly serviceName;
-    private readonly logger;
-    private readonly metrics;
-    constructor(serviceName: string, level?: LevelWithSilentOrString, metricDefinitions?: AppliedMetricsDefinition);
-    log(level: LevelWithSilent, msg: string, meta?: AnyValueMap): void;
-    info(msg: string, meta?: AnyValueMap): void;
-    error(msg: string, meta?: AnyValueMap): void;
-    warn(msg: string, meta?: AnyValueMap): void;
-    debug(msg: string, meta?: AnyValueMap): void;
-    trace(msg: string, meta?: AnyValueMap): void;
-    getMetric<T extends keyof AppliedMetricsDefinition>(metricId: T): MetricType<AppliedMetricsDefinition[T]>;
-}
-declare const httpRequestsTotalCounter: Counter<{
-    "service.name": string;
-    "api.name": string;
-    "correlation.id": string;
-    "http.request.method": string;
-    "http.route": string;
-    "http.response.status_code": number;
-}>;
-
+declare function meta(meta: Record<string, unknown>): LoggerMeta;
 declare class PinoLogger {
     private pinoLogger;
     private meta;
+    private prettyPrinter;
     constructor(level: LevelWithSilentOrString, meta?: AnyValueMap);
-    log(level: LevelWithSilent, msg: string, meta?: AnyValueMap): void;
-    error(msg: string, meta?: AnyValueMap): void;
-    info(msg: string, meta?: AnyValueMap): void;
-    debug(msg: string, meta?: AnyValueMap): void;
-    warn(msg: string, meta?: AnyValueMap): void;
-    trace(msg: string, meta?: AnyValueMap): void;
+    log(level: LevelWithSilent, ...args: (string | unknown | LoggerMeta)[]): void;
+    error: LogFn;
+    info: LogFn;
+    debug: LogFn;
+    warn: LogFn;
+    trace: LogFn;
     child(meta?: AnyValueMap): PinoLogger;
     getBaseLogger(): Logger;
 }
@@ -958,4 +959,4 @@ declare function logger(level: LevelWithSilentOrString, meta?: AnyValueMap): Pin
 
 declare function recordMetric<SV extends AnySchemaValidator, P extends ParamsDictionary, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ResBodyMap extends Record<string, unknown>, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>>(req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<ResBodyMap, ResHeaders, LocalsObj>): void;
 
-export { ATTR_API_NAME, ATTR_CORRELATION_ID, type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExpressLikeTypedHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, type MetricType, type MetricsDefinition, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, OpenTelemetryCollector, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResolvedForklaunchRequest, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, httpRequestsTotalCounter, isClientError, isForklaunchRequest, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, logger, metricsDefinitions, middleware, options, patch, post, put, recordMetric, trace, typedHandler };
+export { ATTR_API_NAME, ATTR_CORRELATION_ID, type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExpressLikeTypedHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, LogFn, LoggerMeta, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, MetricsDefinition, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, OpenTelemetryCollector, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResolvedForklaunchRequest, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, isClientError, isForklaunchRequest, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, logger, meta, metricsDefinitions, middleware, options, patch, post, put, recordMetric, trace, typedHandler };