@stefaninigo/core 0.9.0 → 1.1.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/cache-service.interface.d.ts

@@ -1,6 +1,6 @@
 export interface CacheServiceInterface<T = any> {
-    set(key: string, value: T, ttl?: number): void;
-    get(key: string): T | undefined;
-    delete(key: string): void;
-    clear(): void;
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    get(key: string): Promise<T | undefined>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
 }

package/dist/libs/stefaninigo/cache/cache.module.d.ts

@@ -1,10 +1,6 @@
 import { DynamicModule } from '@nestjs/common';
 import { CacheServiceInterface } from './cache-service.interface';
-declare const cacheStrategies: {
-    [key: string]: new (config: {
-        [key: string]: any;
-    }) => CacheServiceInterface;
-};
+declare const cacheStrategies: Record<string, new (config: Record<string, any>) => CacheServiceInterface>;
 interface CacheProviderConfig {
     name: string;
     provider: keyof typeof cacheStrategies;

package/dist/libs/stefaninigo/cache/cache.module.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CacheModule = void 0;
 const common_1 = require("@nestjs/common");
 const redis_service_1 = require("./redis/redis.service");
-const loca_service_1 = require("./local/loca.service");
+const local_service_1 = require("./local/local.service");
 const config_1 = require("../config");
 const config_2 = require("@nestjs/config");
 const PROVIDERS = {
@@ -19,7 +19,7 @@ const PROVIDERS = {
 };
 const cacheStrategies = {
     [PROVIDERS.REDIS]: redis_service_1.RedisCacheService,
-    [PROVIDERS.LOCAL]: loca_service_1.LocalCacheService
+    [PROVIDERS.LOCAL]: local_service_1.LocalCacheService,
 };
 let CacheModule = CacheModule_1 = class CacheModule {
     static forRootAsync(providers) {

package/dist/libs/stefaninigo/cache/cache.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.module.js","sourceRoot":"","sources":["../../../../libs/stefaninigo/src/cache/cache.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAiE;AACjE,yDAA0D;AAE1D,uDAAyD;AACzD,sCAAqD;AACrD,2CAA+C;AAE/C,MAAM,SAAS,GAAG;IAChB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACf,CAAA;AAED,MAAM,eAAe,GAAqF;IACxG,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,iCAAiB;IACpC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,gCAAiB;CACrC,CAAC;AAWK,IAAM,WAAW,mBAAjB,MAAM,WAAW;IAGtB,MAAM,CAAC,YAAY,CAAC,SAAgC;QAClD,MAAM,cAAc,GAAe,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;YACtE,MAAM,iBAAiB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEpD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,CAAC,aAAuC,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACvH,MAAM,EAAE,CAAC,iCAAwB,EAAE,sBAAa,CAAC;aAClD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS,EAAE,cAAc;YACzB,OAAO,EAAE,cAAc;SACxB,CAAC;IACJ,CAAC;;AAvBU,kCAAW;AACf,qBAAS,GAAG,SAAS,AAAZ,CAAa;sBADlB,WAAW;IAJvB,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,iCAAwB,EAAE,sBAAa,CAAC;QACpD,OAAO,EAAE,CAAC,iCAAwB,EAAE,sBAAa,CAAC;KACnD,CAAC;GACW,WAAW,CAwBvB"}
+{"version":3,"file":"cache.module.js","sourceRoot":"","sources":["../../../../libs/stefaninigo/src/cache/cache.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAiE;AACjE,yDAA0D;AAE1D,yDAA0D;AAC1D,sCAAqD;AACrD,2CAA+C;AAE/C,MAAM,SAAS,GAAG;IAChB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,eAAe,GAA+E;IAClG,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,iCAAiB;IACpC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,iCAAiB;CACrC,CAAC;AAWK,IAAM,WAAW,mBAAjB,MAAM,WAAW;IAGtB,MAAM,CAAC,YAAY,CAAC,SAAgC;QAClD,MAAM,cAAc,GAAe,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;YACtE,MAAM,iBAAiB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEpD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,CAAC,aAAuC,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACvH,MAAM,EAAE,CAAC,iCAAwB,EAAE,sBAAa,CAAC;aAClD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS,EAAE,cAAc;YACzB,OAAO,EAAE,cAAc;SACxB,CAAC;IACJ,CAAC;;AAvBU,kCAAW;AACf,qBAAS,GAAG,SAAS,AAAZ,CAAa;sBADlB,WAAW;IAJvB,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,iCAAwB,EAAE,sBAAa,CAAC;QACpD,OAAO,EAAE,CAAC,iCAAwB,EAAE,sBAAa,CAAC;KACnD,CAAC;GACW,WAAW,CAwBvB"}

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

@@ -2,11 +2,13 @@ import { CacheServiceInterface } from '../cache-service.interface';
 export declare class LocalCacheService implements CacheServiceInterface {
     private readonly config;
     private cache;
+    private timers;
     constructor(config: {
         ttl?: number;
     });
-    set(key: string, value: any, ttl?: number): void;
-    get(key: string): any | null;
-    delete(key: string): void;
-    clear(): void;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    get(key: string): Promise<any | undefined>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    destroy(): void;
 }

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

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalCacheService = void 0;
+class LocalCacheService {
+    constructor(config) {
+        this.config = config;
+        this.cache = new Map();
+        this.timers = new Map();
+    }
+    async 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 });
+        const timer = setTimeout(() => {
+            this.cache.delete(key);
+            this.timers.delete(key);
+        }, expirationTime);
+        if (timer.unref) {
+            timer.unref();
+        }
+        this.timers.set(key, timer);
+    }
+    async 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 undefined;
+        }
+        return cached.value;
+    }
+    async delete(key) {
+        this.cache.delete(key);
+        const timer = this.timers.get(key);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(key);
+        }
+    }
+    async clear() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        this.cache.clear();
+    }
+    destroy() {
+        this.clear();
+    }
+}
+exports.LocalCacheService = LocalCacheService;
+//# sourceMappingURL=local.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local.service.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/cache/local/local.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,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,GAAY;QAC7C,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,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,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,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,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,CAAC,KAAK;QACT,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/config/config.service.d.ts

@@ -1,20 +1,74 @@
 import { ConfigService } from '@nestjs/config';
+export interface MongoDBProviderConfig {
+    uri: string;
+    dbName: string;
+    updateAllFields?: boolean;
+    returnUpdatedDocument?: boolean;
+    maxPoolSize?: number;
+}
+export interface DynamoDBProviderConfig {
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    updateAllFields?: boolean;
+    returnUpdatedDocument?: boolean;
+}
+export interface PostgresProviderConfig {
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    database: string;
+    synchronize?: boolean;
+}
+export interface S3ProviderConfig {
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucket: string;
+    containerPath: string;
+    expiresIn?: number;
+}
+export interface RedisProviderConfig {
+    host: string;
+    port: number;
+    password?: string;
+    db?: number;
+    tls?: boolean;
+}
+export interface SQSProviderConfig {
+    region: string;
+    queueUrl: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    MaxNumberOfMessages?: number;
+    WaitTimeSeconds?: number;
+    pollInterval?: number;
+}
+export interface SNSProviderConfig {
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+}
+export interface WsProviderConfig {
+    domain: string;
+}
 export declare class StefaniniGoConfigService {
     private configService;
     constructor(configService: ConfigService);
     storage: {
-        getConfig: (provider: any) => any;
+        getConfig: (provider: string) => S3ProviderConfig | undefined;
     };
     database: {
-        getConfig: (provider: string, configKey?: string) => any;
+        getConfig: (provider: string, configKey?: string) => MongoDBProviderConfig | DynamoDBProviderConfig | PostgresProviderConfig | undefined;
     };
     cache: {
-        getConfig: (provider: any) => any;
+        getConfig: (provider: string) => RedisProviderConfig | undefined;
     };
-    messagin: {
-        getConfig: (provider: any) => any;
+    messaging: {
+        getConfig: (provider: string) => SQSProviderConfig | SNSProviderConfig | undefined;
     };
     transport: {
-        getConfig: (provider: any) => any;
+        getConfig: (provider: string) => WsProviderConfig | Record<string, never> | undefined;
     };
 }