balda 0.0.4 → 0.0.6

package/lib/index.d.cts

@@ -13,9 +13,9 @@ import * as pino from 'pino';
 import pino__default, { pino as pino$1 } from 'pino';
 import { TSchema } from '@sinclair/typebox';
 import { IClientSubscribeOptions, IClientOptions, IClientPublishOptions, MqttClient } from 'mqtt';
-import { SQSClientConfig, SQSClient } from '@aws-sdk/client-sqs';
-import { Queue, Job } from 'bullmq';
-import { PgBoss } from 'pg-boss';
+import { SQSClientConfig, SendMessageCommandInput } from '@aws-sdk/client-sqs';
+import { Queue, JobsOptions, Job } from 'bullmq';
+import { SendOptions } from 'pg-boss';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { S3Client } from '@aws-sdk/client-s3';
 
@@ -1163,25 +1163,16 @@ declare class Server<H extends NodeHttpClient = NodeHttpClient> implements Serve
     expressMiddleware(middleware: RequestHandler): ServerRouteMiddleware;
     mountExpressRouter(basePath: string, expressRouter: Router$1): void;
     setErrorHandler(errorHandler?: ServerErrorHandler): void;
-    /**
-     * Sets a custom handler for 404 Not Found responses.
-     * If not set, the default RouteNotFoundError will be used.
-     *
-     * @param notFoundHandler - Optional handler to customize 404 responses
-     * @example
-     * server.setNotFoundHandler((req, res) => {
-     *   res.status(404).json({ error: "Custom not found message" });
-     * });
-     */
     setNotFoundHandler(notFoundHandler?: ServerRouteHandler): void;
     listen(cb?: ServerListenCallback): void;
+    waitUntilListening(): Promise<void>;
     close(): Promise<void>;
-    /**
-     * Returns a mock server instance that can be used to test the server without starting it
-     * It will import the controllers and apply the plugins to the mock server
-     * @param options - The options for the mock server
-     * @param options.controllerPatterns - Custom controller patterns to import if the mock server must not be initialized with the same controller patterns as the server
-     */
+    disconnect(): Promise<void>;
+    configureHash(options: {
+        iterations?: number;
+        saltLength?: number;
+        keyLength?: number;
+    }): void;
     getMockServer(options?: Pick<ServerOptions, "controllerPatterns">): Promise<MockServer>;
     private importControllers;
     private extractOptionsAndHandlerFromRouteRegistration;
@@ -1847,21 +1838,55 @@ interface ServerInterface {
      */
     setErrorHandler: (errorHandler?: ServerErrorHandler) => void;
     /**
-     * Set the not found handler for the server
-     * @param notFoundHandler - The not found handler to be applied to all routes
+     * Sets a custom handler for 404 Not Found responses.
+     * If not set, the default RouteNotFoundError will be used.
+     *
+     * @param notFoundHandler - Optional handler to customize 404 responses
+     * @example
+     * server.setNotFoundHandler((req, res) => {
+     *   res.status(404).json({ error: "Custom not found message" });
+     * });
      */
     setNotFoundHandler: (notFoundHandler?: ServerRouteHandler) => void;
     /**
      * Binds the server to the port and hostname defined in the serverOptions, meant to be called only once
+     * It initializes the server without blocking the event loop, you can pass a callback to be called when the server is listening
+     * Use `waitUntilListening` instead if you want to wait for the server to be listening for requests before returning
      * @warning All routes defined with decorators are defined on this method just before the server starts listening for requests
      */
     listen: (cb?: ServerListenCallback) => void;
     /**
-     * Closes the server and frees the port
+     * Binds the server to the port and hostname defined in the serverOptions, meant to be called only once
+     * It initializes the server blocking the event loop, it will wait for the server to be listening for requests before returning
+     * Use `listen` instead if you want to initialize the server without blocking the event loop
+     * @warning All routes defined with decorators are defined on this method just before the server starts listening for requests
+     */
+    waitUntilListening: () => Promise<void>;
+    /**
+     * @alias disconnect
      */
     close: () => Promise<void>;
     /**
-     * Get a mock server instance, useful for testing purposes
+     * Closes the server and frees the port
+     */
+    disconnect: () => Promise<void>;
+    /**
+     * Configure hash settings for password hashing
+     * @param options - Hash configuration options
+     * @param options.iterations - Number of PBKDF2 iterations (default: 600,000)
+     * @param options.saltLength - Salt length in bytes (default: 16)
+     * @param options.keyLength - Key length in bits (default: 256)
+     */
+    configureHash: (options: {
+        iterations?: number;
+        saltLength?: number;
+        keyLength?: number;
+    }) => void;
+    /**
+     * Returns a mock server instance that can be used to test the server without starting it
+     * It will import the controllers and apply the plugins to the mock server
+     * @param options - The options for the mock server
+     * @param options.controllerPatterns - Custom controller patterns to import if the mock server must not be initialized with the same controller patterns as the server
      */
     getMockServer: () => Promise<MockServer>;
     /**
@@ -2220,9 +2245,9 @@ declare class SQSPubSub implements GenericPubSub {
     private getClientWithConfig;
 }
 
-type BullMQAddTaskOptions = Parameters<Queue["add"]>[2];
-type PGBossSendOptions = Parameters<PgBoss["send"]>[2];
-type SQSPublishOptions = Parameters<SQSClient["send"]>[0];
+type BullMQAddTaskOptions = JobsOptions;
+type PGBossSendOptions = SendOptions;
+type SQSPublishOptions = Omit<SendMessageCommandInput, "MessageBody">;
 type BuiltInProviderKey = "bullmq" | "sqs" | "pgboss";
 type PublishOptions<T extends BuiltInProviderKey> = T extends "bullmq" ? BullMQAddTaskOptions : T extends "sqs" ? SQSPublishOptions : T extends "pgboss" ? PGBossSendOptions : never;
 type SQSQueueOptions = {
@@ -2821,9 +2846,14 @@ declare class CommandRegistry {
 declare const commandRegistry: CommandRegistry;
 
 declare class NativeHash {
-    private readonly ITERATIONS;
-    private readonly SALT_LENGTH;
-    private readonly KEY_LENGTH;
+    private ITERATIONS;
+    private SALT_LENGTH;
+    private KEY_LENGTH;
+    configure(options: {
+        iterations?: number;
+        saltLength?: number;
+        keyLength?: number;
+    }): void;
     hash(data: string): Promise<string>;
     compare(hash: string, data: string): Promise<boolean>;
     private encodeBase64;

package/lib/index.d.ts

@@ -13,9 +13,9 @@ import * as pino from 'pino';
 import pino__default, { pino as pino$1 } from 'pino';
 import { TSchema } from '@sinclair/typebox';
 import { IClientSubscribeOptions, IClientOptions, IClientPublishOptions, MqttClient } from 'mqtt';
-import { SQSClientConfig, SQSClient } from '@aws-sdk/client-sqs';
-import { Queue, Job } from 'bullmq';
-import { PgBoss } from 'pg-boss';
+import { SQSClientConfig, SendMessageCommandInput } from '@aws-sdk/client-sqs';
+import { Queue, JobsOptions, Job } from 'bullmq';
+import { SendOptions } from 'pg-boss';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { S3Client } from '@aws-sdk/client-s3';
 
@@ -1163,25 +1163,16 @@ declare class Server<H extends NodeHttpClient = NodeHttpClient> implements Serve
     expressMiddleware(middleware: RequestHandler): ServerRouteMiddleware;
     mountExpressRouter(basePath: string, expressRouter: Router$1): void;
     setErrorHandler(errorHandler?: ServerErrorHandler): void;
-    /**
-     * Sets a custom handler for 404 Not Found responses.
-     * If not set, the default RouteNotFoundError will be used.
-     *
-     * @param notFoundHandler - Optional handler to customize 404 responses
-     * @example
-     * server.setNotFoundHandler((req, res) => {
-     *   res.status(404).json({ error: "Custom not found message" });
-     * });
-     */
     setNotFoundHandler(notFoundHandler?: ServerRouteHandler): void;
     listen(cb?: ServerListenCallback): void;
+    waitUntilListening(): Promise<void>;
     close(): Promise<void>;
-    /**
-     * Returns a mock server instance that can be used to test the server without starting it
-     * It will import the controllers and apply the plugins to the mock server
-     * @param options - The options for the mock server
-     * @param options.controllerPatterns - Custom controller patterns to import if the mock server must not be initialized with the same controller patterns as the server
-     */
+    disconnect(): Promise<void>;
+    configureHash(options: {
+        iterations?: number;
+        saltLength?: number;
+        keyLength?: number;
+    }): void;
     getMockServer(options?: Pick<ServerOptions, "controllerPatterns">): Promise<MockServer>;
     private importControllers;
     private extractOptionsAndHandlerFromRouteRegistration;
@@ -1847,21 +1838,55 @@ interface ServerInterface {
      */
     setErrorHandler: (errorHandler?: ServerErrorHandler) => void;
     /**
-     * Set the not found handler for the server
-     * @param notFoundHandler - The not found handler to be applied to all routes
+     * Sets a custom handler for 404 Not Found responses.
+     * If not set, the default RouteNotFoundError will be used.
+     *
+     * @param notFoundHandler - Optional handler to customize 404 responses
+     * @example
+     * server.setNotFoundHandler((req, res) => {
+     *   res.status(404).json({ error: "Custom not found message" });
+     * });
      */
     setNotFoundHandler: (notFoundHandler?: ServerRouteHandler) => void;
     /**
      * Binds the server to the port and hostname defined in the serverOptions, meant to be called only once
+     * It initializes the server without blocking the event loop, you can pass a callback to be called when the server is listening
+     * Use `waitUntilListening` instead if you want to wait for the server to be listening for requests before returning
      * @warning All routes defined with decorators are defined on this method just before the server starts listening for requests
      */
     listen: (cb?: ServerListenCallback) => void;
     /**
-     * Closes the server and frees the port
+     * Binds the server to the port and hostname defined in the serverOptions, meant to be called only once
+     * It initializes the server blocking the event loop, it will wait for the server to be listening for requests before returning
+     * Use `listen` instead if you want to initialize the server without blocking the event loop
+     * @warning All routes defined with decorators are defined on this method just before the server starts listening for requests
+     */
+    waitUntilListening: () => Promise<void>;
+    /**
+     * @alias disconnect
      */
     close: () => Promise<void>;
     /**
-     * Get a mock server instance, useful for testing purposes
+     * Closes the server and frees the port
+     */
+    disconnect: () => Promise<void>;
+    /**
+     * Configure hash settings for password hashing
+     * @param options - Hash configuration options
+     * @param options.iterations - Number of PBKDF2 iterations (default: 600,000)
+     * @param options.saltLength - Salt length in bytes (default: 16)
+     * @param options.keyLength - Key length in bits (default: 256)
+     */
+    configureHash: (options: {
+        iterations?: number;
+        saltLength?: number;
+        keyLength?: number;
+    }) => void;
+    /**
+     * Returns a mock server instance that can be used to test the server without starting it
+     * It will import the controllers and apply the plugins to the mock server
+     * @param options - The options for the mock server
+     * @param options.controllerPatterns - Custom controller patterns to import if the mock server must not be initialized with the same controller patterns as the server
      */
     getMockServer: () => Promise<MockServer>;
     /**
@@ -2220,9 +2245,9 @@ declare class SQSPubSub implements GenericPubSub {
     private getClientWithConfig;
 }
 
-type BullMQAddTaskOptions = Parameters<Queue["add"]>[2];
-type PGBossSendOptions = Parameters<PgBoss["send"]>[2];
-type SQSPublishOptions = Parameters<SQSClient["send"]>[0];
+type BullMQAddTaskOptions = JobsOptions;
+type PGBossSendOptions = SendOptions;
+type SQSPublishOptions = Omit<SendMessageCommandInput, "MessageBody">;
 type BuiltInProviderKey = "bullmq" | "sqs" | "pgboss";
 type PublishOptions<T extends BuiltInProviderKey> = T extends "bullmq" ? BullMQAddTaskOptions : T extends "sqs" ? SQSPublishOptions : T extends "pgboss" ? PGBossSendOptions : never;
 type SQSQueueOptions = {
@@ -2821,9 +2846,14 @@ declare class CommandRegistry {
 declare const commandRegistry: CommandRegistry;
 
 declare class NativeHash {
-    private readonly ITERATIONS;
-    private readonly SALT_LENGTH;
-    private readonly KEY_LENGTH;
+    private ITERATIONS;
+    private SALT_LENGTH;
+    private KEY_LENGTH;
+    configure(options: {
+        iterations?: number;
+        saltLength?: number;
+        keyLength?: number;
+    }): void;
     hash(data: string): Promise<string>;
     compare(hash: string, data: string): Promise<boolean>;
     private encodeBase64;