@stefaninigo/core 0.9.0 → 1.0.0

package/README.md

@@ -1,73 +1,361 @@
-<p align="center">
-  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="200" alt="Nest Logo" /></a>
-</p>
-
-[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
-[circleci-url]: https://circleci.com/gh/nestjs/nest
-
-  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
-    <p align="center">
-<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
-<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
-<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a>
-<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a>
-<a href="https://coveralls.io/github/nestjs/nest?branch=master" target="_blank"><img src="https://coveralls.io/repos/github/nestjs/nest/badge.svg?branch=master#9" alt="Coverage" /></a>
-<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
-<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
-<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
-  <a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg"/></a>
-    <a href="https://opencollective.com/nest#sponsor"  target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a>
-  <a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow"></a>
-</p>
-  <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
-  [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
-
-## Description
-
-[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository.
+# stefaninigo
+
+Enterprise-grade NestJS library for the StefaniniGo microservice ecosystem. Provides database access, file storage, caching, messaging, real-time transport, event-driven architecture, geolocation utilities, health checks, and standardized request/response handling -- all through a unified **Strategy + DynamicModule** pattern.
+
+## Design Philosophy
+
+- **Transversal** -- shared foundation for all microservices in the ecosystem.
+- **Generic** -- no business logic; only infrastructure concerns.
+- **Provider-agnostic** -- every infrastructure module defines a **service interface**; concrete implementations (strategies) are swappable without touching consumer code.
+- **Easy integration** -- `forRootAsync()` one-liner registration, `@Inject('token')` consumption.
 
 ## Installation
 
 ```bash
-$ pnpm install
+npm install stefaninigo
 ```
 
-## Running the app
+## Quick Start
 
-```bash
-# development
-$ pnpm run start
+```typescript
+// app.module.ts
+import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import {
+  DatabaseModule,
+  StorageModule,
+  CacheModule,
+  EventBusModule,
+  HealthModule,
+  TraceIdMiddleware,
+  RequestContextMiddleware,
+  LoggingInterceptor,
+  ResponseInterceptor,
+  ProblemDetailsInterceptor,
+} from 'stefaninigo';
+import { APP_INTERCEPTOR } from '@nestjs/core';
+import configuration from './config/configuration';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ load: [configuration], isGlobal: true }),
 
-# watch mode
-$ pnpm run start:dev
+    // Database -- MongoDB provider with injection token 'db'
+    DatabaseModule.forRootAsync([
+      { name: 'db', provider: DatabaseModule.PROVIDERS.MONGODB },
+    ]),
 
-# production mode
-$ pnpm run start:prod
+    // Storage -- S3 provider with injection token 'storage'
+    StorageModule.forRootAsync([
+      { name: 'storage', provider: StorageModule.PROVIDERS.S3 },
+    ]),
+
+    // Cache -- Redis provider with injection token 'cache'
+    CacheModule.forRootAsync([
+      { name: 'cache', provider: CacheModule.PROVIDERS.REDIS },
+    ]),
+
+    // Event bus -- global module, no forRoot needed
+    EventBusModule,
+
+    // Health checks
+    HealthModule.forRoot({
+      config: {
+        serviceName: 'my-service',
+        version: '1.0.0',
+        database: {
+          token: 'db',
+          collection: 'health',
+          timeoutMs: 3000,
+        },
+      },
+    }),
+  ],
+  providers: [
+    // Interceptor chain (order matters -- first registered runs outermost)
+    { provide: APP_INTERCEPTOR, useClass: LoggingInterceptor },
+    { provide: APP_INTERCEPTOR, useClass: ResponseInterceptor },
+    { provide: APP_INTERCEPTOR, useClass: ProblemDetailsInterceptor },
+  ],
+})
+export class AppModule implements NestModule {
+  configure(consumer: MiddlewareConsumer) {
+    consumer
+      .apply(TraceIdMiddleware, RequestContextMiddleware)
+      .forRoutes('*');
+  }
+}
 ```
 
-## Test
+```typescript
+// main.ts
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import {
+  createStandardValidationPipe,
+  setupSwagger,
+  setupCors,
+} from 'stefaninigo';
 
-```bash
-# unit tests
-$ pnpm run test
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
 
-# e2e tests
-$ pnpm run test:e2e
+  app.useGlobalPipes(createStandardValidationPipe());
+  app.setGlobalPrefix('api/v1/my-service');
+  setupCors(app);
+  setupSwagger(app, {
+    title: 'My Service',
+    description: 'API docs',
+    version: '1.0.0',
+  });
 
-# test coverage
-$ pnpm run test:cov
+  await app.listen(3000);
+}
+bootstrap();
 ```
 
-## Support
+## Modules
+
+| Module | Pattern | Providers | Description |
+|--------|---------|-----------|-------------|
+| [`DatabaseModule`](libs/stefaninigo/src/database/ARCHITECTURE.md) | Strategy + DynamicModule | MongoDB, DynamoDB, PostgreSQL | Provider-agnostic data access layer |
+| [`StorageModule`](libs/stefaninigo/src/storage/ARCHITECTURE.md) | Strategy + DynamicModule | S3 | File upload, download, presigned URLs |
+| [`CacheModule`](libs/stefaninigo/src/cache/ARCHITECTURE.md) | Strategy + DynamicModule | Redis, Local (in-memory) | Key-value caching with TTL |
+| [`MessagingModule`](libs/stefaninigo/src/messaging/ARCHITECTURE.md) | Strategy + DynamicModule | SNS, SQS | Pub/sub and point-to-point messaging |
+| [`TransportModule`](libs/stefaninigo/src/transport/ARCHITECTURE.md) | Strategy + DynamicModule | AWS API Gateway WebSocket | Real-time bidirectional communication |
+| [`EventBusModule`](libs/stefaninigo/src/events/ARCHITECTURE.md) | `@Global` module | log, SNS, SQS | Toggleable domain event publishing |
+| [`HealthModule`](libs/stefaninigo/src/core/ARCHITECTURE.md) | DynamicModule | -- | K8s liveness, readiness, detailed health |
+| [Core](libs/stefaninigo/src/core/ARCHITECTURE.md) | Interceptors + Middleware | -- | Tracing, logging, RFC 7807 errors, response format |
+| [Config](libs/stefaninigo/src/config/ARCHITECTURE.md) | Service | -- | Centralized config resolver for all modules |
+| [Geo](libs/stefaninigo/src/geo/ARCHITECTURE.md) | Pure utilities | -- | GeoJSON types, Haversine distance, bounding boxes |
+
+## Architecture
+
+### Strategy Pattern
+
+Every infrastructure module (`DatabaseModule`, `StorageModule`, `CacheModule`, `MessagingModule`, `TransportModule`) follows the same pattern:
+
+1. A **service interface** defines the contract (e.g. `DatabaseService`, `StorageService`, `CacheServiceInterface`).
+2. **Concrete strategies** implement that interface per provider (e.g. `MongoDBService`, `DynamoDBService`, `PostgreService`).
+3. The module exposes `forRootAsync(providers[])` which takes an array of `{ name, provider }` configs.
+4. Each entry creates a named NestJS provider you inject with `@Inject('name')`.
+
+```typescript
+// Register two databases with different tokens
+DatabaseModule.forRootAsync([
+  { name: 'mainDb', provider: DatabaseModule.PROVIDERS.MONGODB },
+  { name: 'analyticsDb', provider: DatabaseModule.PROVIDERS.MONGODB, configKey: 'analytics' },
+  { name: 'dynamoDb', provider: DatabaseModule.PROVIDERS.DYNAMODB },
+])
+
+// Inject in a service
+constructor(@Inject('mainDb') private readonly db: DatabaseService) {}
+```
+
+### Interceptor Chain
+
+Interceptors execute in registration order on the request path and in reverse on the response/error path:
+
+```
+Request Flow:
+  Client --> LoggingInterceptor --> ResponseInterceptor --> ProblemDetailsInterceptor --> Controller
+
+Response Flow (success):
+  Controller --> ProblemDetailsInterceptor (pass-through) --> ResponseInterceptor (wraps: {success, message}) --> LoggingInterceptor (logs duration) --> Client
+
+Error Flow:
+  Controller throws --> ProblemDetailsInterceptor (converts to RFC 7807) --> ResponseInterceptor (pass-through if ProblemDetails) --> LoggingInterceptor (logs error) --> Client
+```
+
+| Interceptor | Responsibility |
+|-------------|---------------|
+| `LoggingInterceptor` | Logs request entry/exit, duration, errors. Includes traceId, controller, handler. Emits structured metrics. |
+| `ResponseInterceptor` | Wraps successful responses as `{ success: true, message: data }`. Wraps non-ProblemDetails errors as `{ success: false, error, message, statusCode }`. |
+| `ProblemDetailsInterceptor` | Converts all errors to RFC 7807 ProblemDetails format. Sanitizes sensitive body fields. Adds `debugInfo` in development mode. |
+
+### Distributed Tracing
+
+Full request lifecycle tracing through `AsyncLocalStorage`:
+
+```
+Incoming Request
+  |
+  v
+TraceIdMiddleware          -- reads/generates X-Trace-ID, attaches to req & res header
+  |
+  v
+RequestContextMiddleware   -- creates RequestContext in AsyncLocalStorage (traceId, userId, language, startTime)
+  |
+  v
+TracedLogger               -- extends NestJS Logger, auto-prefixes [traceId] to every log line
+  |
+  v
+LoggingInterceptor         -- reads traceId for structured logging
+  |
+  v
+ProblemDetailsInterceptor  -- embeds traceId in error responses
+```
+
+```typescript
+// Use TracedLogger in any service for automatic traceId injection
+import { TracedLogger } from 'stefaninigo';
+
+export class TicketService {
+  private readonly logger = new TracedLogger(TicketService.name);
+
+  findOne(id: string) {
+    this.logger.log(`Finding ticket ${id}`);
+    // Output: [a1b2c3d4-...] Finding ticket TK-001
+  }
+}
+
+// Or access context directly
+import { getRequestContext, getTraceId } from 'stefaninigo';
+
+const ctx = getRequestContext(); // { traceId, userId, language, startTime }
+const traceId = getTraceId();   // shortcut
+```
+
+### Event-Driven Architecture
+
+`EventBusModule` is a `@Global` module with 3 publishing strategies, toggled via environment variables:
+
+```
+EventBusService.publish(event)
+  |
+  |-- strategy = 'log'  --> Logger output (default, zero infra)
+  |-- strategy = 'sns'  --> AWS SNS topic (fan-out)
+  |-- strategy = 'sqs'  --> AWS SQS queue (point-to-point)
+```
+
+```typescript
+import { EventBusService } from 'stefaninigo';
+import { randomUUID } from 'crypto';
+
+@Injectable()
+export class TicketService {
+  constructor(private readonly eventBus: EventBusService) {}
+
+  async create(dto: CreateTicketDto) {
+    const ticket = await this.repo.create(dto);
+
+    await this.eventBus.publish({
+      eventId: randomUUID(),
+      eventType: 'ticket.created',
+      timestamp: new Date().toISOString(),
+      providerId: dto.providerId,
+      source: 'tickets-service',
+      data: { ticketId: ticket.id, clientId: dto.clientId },
+    });
+
+    return ticket;
+  }
+}
+```
+
+The library provides typed domain event interfaces for: tickets, routes, geofence, technicians, inventory, clients, locations, contacts, categories, and config. See `events/types/domain-events.ts`.
+
+## Environment Variables
+
+### Database
+
+| Variable | Provider | Description |
+|----------|----------|-------------|
+| `database.mongodb.uri` | MongoDB | Connection URI |
+| `database.mongodb.dbName` | MongoDB | Default database name |
+| `database.mongodb.updateAllFields` | MongoDB | Replace vs merge on update |
+| `database.mongodb.returnUpdatedDocument` | MongoDB | Return doc after update |
+| `database.dynamodb.region` | DynamoDB | AWS region |
+| `database.dynamodb.accessKeyId` | DynamoDB | AWS access key |
+| `database.dynamodb.secretAccessKey` | DynamoDB | AWS secret key |
+| `database.postgres.host` | PostgreSQL | Host |
+| `database.postgres.port` | PostgreSQL | Port |
+| `database.postgres.username` | PostgreSQL | Username |
+| `database.postgres.password` | PostgreSQL | Password |
+| `database.postgres.database` | PostgreSQL | Database name |
+
+### Storage
+
+| Variable | Provider | Description |
+|----------|----------|-------------|
+| `storage.s3.region` | S3 | AWS region |
+| `storage.s3.accessKeyId` | S3 | AWS access key |
+| `storage.s3.secretAccessKey` | S3 | AWS secret key |
+| `storage.s3.bucket` | S3 | Bucket name |
+| `storage.s3.containerPath` | S3 | Default key prefix |
+| `storage.s3.expiresIn` | S3 | Presigned URL expiry in seconds (default: 3600) |
+
+### Cache
+
+| Variable | Provider | Description |
+|----------|----------|-------------|
+| `cache.redis.host` | Redis | Redis host |
+| `cache.redis.port` | Redis | Redis port |
+
+### Messaging
+
+| Variable | Provider | Description |
+|----------|----------|-------------|
+| `message.sns.region` | SNS | AWS region |
+| `message.sns.accessKeyId` | SNS | AWS access key |
+| `message.sns.secretAccessKey` | SNS | AWS secret key |
+| `message.sqs.region` | SQS | AWS region |
+| `message.sqs.accessKeyId` | SQS | AWS access key |
+| `message.sqs.secretAccessKey` | SQS | AWS secret key |
+| `message.sqs.queueUrl` | SQS | Default queue URL |
+| `message.sqs.MaxNumberOfMessages` | SQS | Max messages per poll (default: 10) |
+| `message.sqs.WaitTimeSeconds` | SQS | Long poll wait (default: 20) |
+| `message.sqs.pollInterval` | SQS | Poll interval ms (default: 10000) |
+
+### Transport
+
+| Variable | Provider | Description |
+|----------|----------|-------------|
+| `transport.aws_ws.domain` | AWS WebSocket | API Gateway WebSocket endpoint |
+
+### EventBus
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `EVENTS_ENABLED` | `false` | Enable/disable event publishing |
+| `EVENTS_STRATEGY` | `log` | Strategy: `log`, `sns`, or `sqs` |
+| `EVENTS_SNS_TOPIC_ARN` | -- | SNS topic ARN (when strategy=sns) |
+| `EVENTS_SQS_QUEUE_URL` | -- | SQS queue URL (when strategy=sqs) |
+
+### Core
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `NODE_ENV` | `development` | Controls debug info in error responses |
+| `CORS_ORIGINS` | `*` | Comma-separated allowed origins |
+
+## Module Documentation
+
+Each module has its own ARCHITECTURE.md with detailed API reference, usage examples, and configuration:
 
-Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
+- [Core -- Interceptors, Middleware, Context, Logger, Errors, Health](libs/stefaninigo/src/core/ARCHITECTURE.md)
+- [Database -- MongoDB, DynamoDB, PostgreSQL](libs/stefaninigo/src/database/ARCHITECTURE.md)
+- [Storage -- S3 file operations](libs/stefaninigo/src/storage/ARCHITECTURE.md)
+- [Cache -- Redis and Local providers](libs/stefaninigo/src/cache/ARCHITECTURE.md)
+- [Messaging -- AWS SNS and SQS](libs/stefaninigo/src/messaging/ARCHITECTURE.md)
+- [Events -- Domain event bus](libs/stefaninigo/src/events/ARCHITECTURE.md)
+- [Transport -- WebSocket and HTTP](libs/stefaninigo/src/transport/ARCHITECTURE.md)
+- [Config -- Centralized configuration resolver](libs/stefaninigo/src/config/ARCHITECTURE.md)
+- [Geo -- GeoJSON, distance, bounding boxes](libs/stefaninigo/src/geo/ARCHITECTURE.md)
 
-## Stay in touch
+## Tech Stack
 
-- Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
-- Website - [https://nestjs.com](https://nestjs.com/)
-- Twitter - [@nestframework](https://twitter.com/nestframework)
+| Dependency | Version | Purpose |
+|------------|---------|---------|
+| NestJS | 11.x | Framework |
+| TypeScript | 5.x | Language |
+| MongoDB driver | 6.x | MongoDB provider |
+| pg | 8.x | PostgreSQL provider |
+| AWS SDK v3 | 3.x | S3, SNS, SQS, DynamoDB, API Gateway |
+| ioredis | 5.x | Redis provider |
+| axios | 1.x | HTTP transport |
+| ws | 8.x | WebSocket transport |
 
 ## License
 
-Nest is [MIT licensed](LICENSE).
+UNLICENSED -- Internal use only.

package/dist/libs/stefaninigo/cache/local/loca.service.d.ts

@@ -2,6 +2,7 @@ import { CacheServiceInterface } from '../cache-service.interface';
 export declare class LocalCacheService implements CacheServiceInterface {
     private readonly config;
     private cache;
+    private timers;
     constructor(config: {
         ttl?: number;
     });
@@ -9,4 +10,5 @@ export declare class LocalCacheService implements CacheServiceInterface {
     get(key: string): any | null;
     delete(key: string): void;
     clear(): void;
+    destroy(): void;
 }

package/dist/libs/stefaninigo/cache/local/loca.service.js

@@ -5,26 +5,55 @@ class LocalCacheService {
     constructor(config) {
         this.config = config;
         this.cache = new Map();
+        this.timers = new Map();
     }
     set(key, value, ttl) {
         const expirationTime = ttl || this.config.ttl || 86400000;
+        const existingTimer = this.timers.get(key);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
         this.cache.set(key, { value, expiresAt: Date.now() + expirationTime });
-        setTimeout(() => this.cache.delete(key), expirationTime);
+        const timer = setTimeout(() => {
+            this.cache.delete(key);
+            this.timers.delete(key);
+        }, expirationTime);
+        if (timer.unref) {
+            timer.unref();
+        }
+        this.timers.set(key, timer);
     }
     get(key) {
         const cached = this.cache.get(key);
         if (!cached || cached.expiresAt < Date.now()) {
             this.cache.delete(key);
+            const timer = this.timers.get(key);
+            if (timer) {
+                clearTimeout(timer);
+                this.timers.delete(key);
+            }
             return null;
         }
         return cached.value;
     }
     delete(key) {
         this.cache.delete(key);
+        const timer = this.timers.get(key);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(key);
+        }
     }
     clear() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
         this.cache.clear();
     }
+    destroy() {
+        this.clear();
+    }
 }
 exports.LocalCacheService = LocalCacheService;
 //# sourceMappingURL=loca.service.js.map

package/dist/libs/stefaninigo/cache/local/loca.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"loca.service.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/cache/local/loca.service.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAG5B,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QAF7C,UAAK,GAAqB,IAAI,GAAG,EAAE,CAAC;IAEY,CAAC;IAEzD,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,GAAY;QACvC,MAAM,cAAc,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC;QAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;QAEvE,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;IAC3D,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AA5BD,8CA4BC"}
+{"version":3,"file":"loca.service.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/cache/local/loca.service.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAI5B,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QAH7C,UAAK,GAAqB,IAAI,GAAG,EAAE,CAAC;QACpC,WAAM,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEA,CAAC;IAEzD,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,GAAY;QACvC,MAAM,cAAc,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC;QAG1D,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,aAAa,EAAE,CAAC;YAClB,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;QAEvE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC,EAAE,cAAc,CAAC,CAAC;QAGnB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK;QACH,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAOD,OAAO;QACL,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACF;AArED,8CAqEC"}

package/dist/libs/stefaninigo/core/bootstrap/bootstrap.helpers.d.ts

@@ -5,11 +5,25 @@ export interface SwaggerOptions {
     description: string;
     version: string;
     path?: string;
+    tags?: Array<{
+        name: string;
+        description: string;
+    }>;
+    servers?: Array<{
+        url: string;
+        description: string;
+    }>;
+    contact?: {
+        name: string;
+        url: string;
+        email: string;
+    };
+    bearerAuth?: boolean;
 }
 export declare function setupSwagger(app: INestApplication, options: SwaggerOptions): void;
 export interface CorsOptions {
-    origins?: string[];
-    methods?: string[];
+    origins?: string | string[];
+    methods?: string | string[];
     credentials?: boolean;
 }
 export declare function setupCors(app: INestApplication, options?: CorsOptions): void;

package/dist/libs/stefaninigo/core/bootstrap/bootstrap.helpers.js

@@ -10,22 +10,62 @@ function createStandardValidationPipe() {
         whitelist: true,
         forbidNonWhitelisted: true,
         transform: true,
+        transformOptions: {
+            enableImplicitConversion: true,
+        },
+        validateCustomDecorators: true,
     });
 }
 function setupSwagger(app, options) {
-    const config = new swagger_1.DocumentBuilder()
+    const builder = new swagger_1.DocumentBuilder()
         .setTitle(options.title)
         .setDescription(options.description)
-        .setVersion(options.version)
-        .addBearerAuth()
-        .build();
+        .setVersion(options.version);
+    if (options.bearerAuth !== false) {
+        builder.addBearerAuth({
+            type: 'http',
+            scheme: 'bearer',
+            bearerFormat: 'JWT',
+            name: 'Authorization',
+            description: 'JWT Bearer token',
+            in: 'header',
+        }, 'bearer');
+    }
+    if (options.contact) {
+        builder.setContact(options.contact.name, options.contact.url, options.contact.email);
+    }
+    if (options.tags) {
+        for (const tag of options.tags) {
+            builder.addTag(tag.name, tag.description);
+        }
+    }
+    if (options.servers) {
+        for (const server of options.servers) {
+            builder.addServer(server.url, server.description);
+        }
+    }
+    const config = builder.build();
     const document = swagger_1.SwaggerModule.createDocument(app, config);
-    swagger_1.SwaggerModule.setup(options.path || 'api/docs', app, document);
+    const docsPath = options.path || 'api/docs';
+    swagger_1.SwaggerModule.setup(docsPath, app, document, {
+        swaggerOptions: {
+            persistAuthorization: true,
+            tagsSorter: 'alpha',
+            operationsSorter: 'alpha',
+        },
+        customSiteTitle: options.title,
+        customCss: '.swagger-ui .topbar { display: none }',
+    });
+    const jsonPath = docsPath.replace(/\/docs$/, '/openapi.json');
+    app.getHttpAdapter().get(jsonPath, (_req, res) => {
+        res.setHeader('Content-Type', 'application/json');
+        res.send(document);
+    });
 }
 function setupCors(app, options) {
     app.enableCors({
-        origin: options?.origins || process.env.CORS_ORIGINS?.split(',') || '*',
-        methods: options?.methods || ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
+        origin: options?.origins || process.env.CORS_ORIGIN || '*',
+        methods: options?.methods || 'GET,HEAD,PUT,PATCH,POST,DELETE,OPTIONS',
         credentials: options?.credentials ?? true,
     });
 }

package/dist/libs/stefaninigo/core/bootstrap/bootstrap.helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.helpers.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/bootstrap/bootstrap.helpers.ts"],"names":[],"mappings":";;AAGA,oEAMC;AASD,oCAaC;AAQD,8BASC;AAhDD,2CAAkE;AAClE,6CAAiE;AAEjE,SAAgB,4BAA4B;IAC1C,OAAO,IAAI,uBAAc,CAAC;QACxB,SAAS,EAAE,IAAI;QACf,oBAAoB,EAAE,IAAI;QAC1B,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AASD,SAAgB,YAAY,CAC1B,GAAqB,EACrB,OAAuB;IAEvB,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SACjC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;SACvB,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC;SACnC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;SAC3B,aAAa,EAAE;SACf,KAAK,EAAE,CAAC;IAEX,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,uBAAa,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAQD,SAAgB,SAAS,CACvB,GAAqB,EACrB,OAAqB;IAErB,GAAG,CAAC,UAAU,CAAC;QACb,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG;QACvE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;QACjF,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;KAC1C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"bootstrap.helpers.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/bootstrap/bootstrap.helpers.ts"],"names":[],"mappings":"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"}

package/dist/libs/stefaninigo/core/config/env.utils.d.ts

@@ -0,0 +1,3 @@
+export declare function getEnvFilePaths(projectRoot?: string): string[];
+export declare function getEnvFilePath(projectRoot?: string): string | null;
+export declare function getEnvironment(): string;

package/dist/libs/stefaninigo/core/config/env.utils.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvFilePaths = getEnvFilePaths;
+exports.getEnvFilePath = getEnvFilePath;
+exports.getEnvironment = getEnvironment;
+const fs = require("fs");
+const path = require("path");
+function getEnvFilePaths(projectRoot = process.cwd()) {
+    const nodeEnv = process.env.NODE_ENV || 'development';
+    const envFiles = [];
+    const envByEnv = path.join(projectRoot, `.env.${nodeEnv}`);
+    if (fs.existsSync(envByEnv)) {
+        envFiles.push(envByEnv);
+    }
+    const defaultEnv = path.join(projectRoot, '.env');
+    if (fs.existsSync(defaultEnv)) {
+        envFiles.push(defaultEnv);
+    }
+    return envFiles;
+}
+function getEnvFilePath(projectRoot = process.cwd()) {
+    const paths = getEnvFilePaths(projectRoot);
+    return paths.length > 0 ? paths[0] : null;
+}
+function getEnvironment() {
+    return process.env.NODE_ENV || 'development';
+}
+//# sourceMappingURL=env.utils.js.map

package/dist/libs/stefaninigo/core/config/env.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.utils.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/config/env.utils.ts"],"names":[],"mappings":";;AAaA,0CAeC;AAQD,wCAGC;AAKD,wCAEC;AA9CD,yBAAyB;AACzB,6BAA6B;AAY7B,SAAgB,eAAe,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IACtD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,OAAO,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD,SAAgB,cAAc,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAKD,SAAgB,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;AAC/C,CAAC"}

package/dist/libs/stefaninigo/core/config/index.d.ts

@@ -0,0 +1 @@
+export * from './env.utils';