@grupodiariodaregiao/bunstone 0.7.0 → 0.7.2

package/AGENTS.md

@@ -1062,6 +1062,68 @@ OR using a connection string:
 export class AppModule {}
 ```
 
+### Connection options
+
+You can pass a second argument with pool and client settings. Bunstone forwards only the supported options to [Bun.SQL](https://bun.sh/docs/api/sql):
+
+```typescript
+@Module({
+  imports: [
+    SqlModule.register("mysql://user:pass@host:3306/db", {
+      maxLifetime: 25200,
+      connectionTimeout: 30,
+      max: 10,
+      timezone: "UTC",
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+The same options can be combined with the object-style registration:
+
+```typescript
+SqlModule.register({
+  provider: "postgresql",
+  host: "localhost",
+  port: 5432,
+  username: "user",
+  password: "password",
+  database: "my_db",
+  max: 20,
+  idleTimeout: 30,
+});
+```
+
+For backward compatibility, the second argument may still be a timezone string:
+
+```typescript
+SqlModule.register("mysql://user:pass@host/db", "UTC");
+```
+
+#### Supported options (`SqlModuleOptions`)
+
+| Option | Description |
+|---|---|
+| `timezone` | Bunstone helper for date/time handling. Defaults to `UTC`. Mapped to driver `connection` settings. |
+| `max` | Maximum connections in the pool |
+| `maxLifetime` | Maximum connection lifetime in seconds |
+| `connectionTimeout` | Timeout when establishing a connection (seconds) |
+| `idleTimeout` | Close idle connections after N seconds |
+| `connection` | Driver-specific runtime settings (e.g. PostgreSQL `TimeZone`) |
+| `tls` | TLS/SSL configuration |
+| `prepare` | Enable automatic prepared statements |
+| `bigint` | Return out-of-range integers as `BigInt` |
+| `onconnect` | Callback when a connection attempt completes |
+| `onclose` | Callback when a connection closes |
+| `path` | Unix domain socket path |
+| `readonly` | SQLite read-only mode |
+| `create` | SQLite create-if-missing behavior |
+| `safeIntegers` | SQLite safe integer handling |
+| `strict` | SQLite strict mode |
+
+Only the options listed above are accepted. Invalid keys are rejected by TypeScript and also throw `DatabaseError` (`BNS-DB-003`) at runtime.
+
 ## Usage
 
 Once registered, the `SqlService` is globally available. You can inject it into any controller or provider without needing to import `SqlModule` into subsequent modules.
@@ -3943,6 +4005,68 @@ OU usando uma string de conexão:
 export class AppModule {}
 ```
 
+### Opções de conexão
+
+Você pode passar um segundo argumento com configurações de pool e do client. O Bunstone repassa apenas as opções suportadas para o [Bun.SQL](https://bun.sh/docs/api/sql):
+
+```typescript
+@Module({
+  imports: [
+    SqlModule.register("mysql://user:pass@host:3306/db", {
+      maxLifetime: 25200,
+      connectionTimeout: 30,
+      max: 10,
+      timezone: "UTC",
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+As mesmas opções podem ser usadas no registro via objeto:
+
+```typescript
+SqlModule.register({
+  provider: "postgresql",
+  host: "localhost",
+  port: 5432,
+  username: "user",
+  password: "password",
+  database: "my_db",
+  max: 20,
+  idleTimeout: 30,
+});
+```
+
+Por compatibilidade, o segundo argumento ainda pode ser uma string de timezone:
+
+```typescript
+SqlModule.register("mysql://user:pass@host/db", "UTC");
+```
+
+#### Opções suportadas (`SqlModuleOptions`)
+
+| Opção | Descrição |
+|---|---|
+| `timezone` | Helper do Bunstone para datas/horas. Padrão: `UTC`. Mapeado para `connection` do driver. |
+| `max` | Máximo de conexões no pool |
+| `maxLifetime` | Tempo máximo de vida da conexão em segundos |
+| `connectionTimeout` | Timeout ao estabelecer conexão (segundos) |
+| `idleTimeout` | Fecha conexões ociosas após N segundos |
+| `connection` | Configurações runtime do driver (ex.: `TimeZone` no PostgreSQL) |
+| `tls` | Configuração TLS/SSL |
+| `prepare` | Habilita prepared statements automáticos |
+| `bigint` | Retorna inteiros fora do range como `BigInt` |
+| `onconnect` | Callback ao concluir tentativa de conexão |
+| `onclose` | Callback ao fechar conexão |
+| `path` | Caminho do Unix domain socket |
+| `readonly` | Modo somente leitura (SQLite) |
+| `create` | Comportamento de criação do arquivo (SQLite) |
+| `safeIntegers` | Tratamento seguro de inteiros (SQLite) |
+| `strict` | Modo strict (SQLite) |
+
+Somente as opções listadas acima são aceitas. Chaves inválidas são rejeitadas pelo TypeScript e também lançam `DatabaseError` (`BNS-DB-003`) em runtime.
+
 ## Uso
 
 Depois de registrado, o `SqlService` fica disponível globalmente. Você pode injetá-lo em qualquer controller ou provider sem precisar importar o `SqlModule` nos módulos subsequentes.

package/dist/index.d.ts

@@ -13,14 +13,15 @@ import "reflect-metadata";
  * Nunca deixe uma nova feature da lib sem a respectiva entrada aqui.
  */
 export * from "./lib/adapters/cache-adapter";
-export { EmailModule, EmailService } from "./lib/email/email-module";
-export { EmailLayout } from "./lib/email/email-layout";
 export * from "./lib/adapters/form-data";
 export * from "./lib/adapters/upload-adapter";
 export * from "./lib/app-startup";
+export { BullMqModule } from "./lib/bullmq/bullmq-module";
+export * from "./lib/bullmq/decorators/process.decorator";
+export * from "./lib/bullmq/decorators/processor.decorator";
+export { QueueService } from "./lib/bullmq/queue.service";
 export * from "./lib/components/layout";
 export * from "./lib/controller";
-export * from "./lib/ratelimit";
 export * from "./lib/cqrs/command-bus";
 export * from "./lib/cqrs/cqrs-module";
 export * from "./lib/cqrs/decorators/command-handler.decorator";
@@ -33,44 +34,44 @@ export * from "./lib/cqrs/interfaces/event.interface";
 export * from "./lib/cqrs/interfaces/query.interface";
 export * from "./lib/cqrs/query-bus";
 export { SqlModule, SqlService } from "./lib/database/sql-module";
-export { BullMqModule } from "./lib/bullmq/bullmq-module";
-export { QueueService } from "./lib/bullmq/queue.service";
-export * from "./lib/bullmq/decorators/processor.decorator";
-export * from "./lib/bullmq/decorators/process.decorator";
-export { RabbitMQModule } from "./lib/rabbitmq/rabbitmq-module";
-export { RabbitMQService } from "./lib/rabbitmq/rabbitmq.service";
-export { RabbitMQDeadLetterService } from "./lib/rabbitmq/dead-letter.service";
-export { RabbitMQConnection } from "./lib/rabbitmq/rabbitmq-connection";
-export * from "./lib/rabbitmq/decorators/consumer.decorator";
-export * from "./lib/rabbitmq/decorators/subscribe.decorator";
-export type * from "./lib/rabbitmq/interfaces/rabbitmq-options.interface";
-export type * from "./lib/rabbitmq/interfaces/rabbitmq-message.interface";
+export type { BunSqlClientOptions, ConnectionOptions, SqlConnectionDetails, SqlConnectionOptions, SqlModuleOptions, SqlPoolOptions, SqlRegisterOptions, } from "./lib/database/sql-module";
+export { EmailLayout } from "./lib/email/email-layout";
+export { EmailModule, EmailService } from "./lib/email/email-module";
 export * from "./lib/errors";
-export { ErrorFormatter } from "./lib/utils/error-formatter";
 export * from "./lib/guard";
 export * from "./lib/http-exceptions";
 export * from "./lib/http-methods";
 export * from "./lib/http-params";
 export * from "./lib/injectable";
+export type { GuardContract } from "./lib/interfaces/guard-contract";
 export * from "./lib/jwt";
 export * from "./lib/jwt/jwt-module";
 export { JwtService } from "./lib/jwt/jwt.service";
 export * from "./lib/module";
 export * from "./lib/on-module";
 export * from "./lib/openapi";
+export { RabbitMQDeadLetterService } from "./lib/rabbitmq/dead-letter.service";
+export * from "./lib/rabbitmq/decorators/consumer.decorator";
+export * from "./lib/rabbitmq/decorators/subscribe.decorator";
+export type * from "./lib/rabbitmq/interfaces/rabbitmq-message.interface";
+export type * from "./lib/rabbitmq/interfaces/rabbitmq-options.interface";
+export { RabbitMQConnection } from "./lib/rabbitmq/rabbitmq-connection";
+export { RabbitMQModule } from "./lib/rabbitmq/rabbitmq-module";
+export { RabbitMQService } from "./lib/rabbitmq/rabbitmq.service";
+export * from "./lib/ratelimit";
 export * from "./lib/render";
-export * from "./lib/types/options";
-export * from "./lib/types/module-config";
 export * from "./lib/schedule/cron/cron";
 export * from "./lib/schedule/timeout/timeout";
+export type { OtlpExporterOptions, TelemetryOptions } from "./lib/telemetry/interfaces/telemetry-options.interface";
 export { TelemetryModule } from "./lib/telemetry/telemetry-module";
 export { TelemetrySdk } from "./lib/telemetry/telemetry.sdk";
-export type { TelemetryOptions, OtlpExporterOptions } from "./lib/telemetry/interfaces/telemetry-options.interface";
 export * from "./lib/testing/test";
-export * from "./lib/testing/testing-module";
 export * from "./lib/testing/test-app";
+export * from "./lib/testing/testing-module";
 export type { HttpRequest } from "./lib/types/http-request";
+export * from "./lib/types/module-config";
 export type { ModuleConfig } from "./lib/types/module-config";
+export * from "./lib/types/options";
 export type { Options } from "./lib/types/options";
+export { ErrorFormatter } from "./lib/utils/error-formatter";
 export * from "./lib/utils/logger";
-export type { GuardContract } from "./lib/interfaces/guard-contract";