@invariant--labs/foundation 1.1.2

package/.yarnrc.yml

@@ -0,0 +1 @@
+#nodeLinker: node-modules

package/CHANGELOG.md

@@ -0,0 +1,527 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.1.1] - 2026-02-09
+
+### Changed - Folder Cleanup & Code Modernization
+
+Complete cleanup of the incomplete v1.1.0 folder restructuring, removing all duplicate files and simplifying the directory layout.
+
+#### Folder Structure Simplification
+
+Consolidated from 17 top-level directories down to 7:
+
+```
+src/
+├── core/           # Domain, Application, Infrastructure, Errors, Types
+├── modules/        # NestJS modules (config, logger, messaging, queue, knex, graphql, healthcheck)
+├── nestjs/         # NestJS framework integration (http, errors)
+├── validation/     # Validation decorators
+├── utils/          # Utility functions
+├── testing/        # Test stubs and fakes
+└── index.ts
+```
+
+#### Removed (duplicates of canonical locations)
+
+| Deleted Directory | Canonical Location |
+|---|---|
+| `src/domain/` | `src/core/domain/` |
+| `src/application/` | `src/core/application/` |
+| `src/errors/` | `src/core/errors/` |
+| `src/definitions/` | `src/core/types/` |
+| `src/error-handlers/` | `src/nestjs/errors/handlers/` |
+| `src/error-parsers/` | `src/nestjs/errors/parsers/` |
+| `src/decorators/` | `src/validation/` |
+| `src/filters/` | `src/nestjs/http/filters/` |
+| `src/interceptors/` | `src/nestjs/http/interceptors/` |
+| `src/modules/` | `src/modules/` (moved from `src/nestjs/modules/`) |
+| `src/infrastructure/web/` | `src/nestjs/http/` |
+| `src/core/errors/deprecated/` | removed entirely |
+
+#### Moved
+
+| From | To |
+|---|---|
+| `src/infrastructure/` | `src/core/infrastructure/` |
+| `src/nestjs/modules/` | `src/modules/` |
+
+#### Code Modernization
+
+- Replaced `||` with `??` (nullish coalescing) throughout
+- Replaced `&&` guard patterns with `?.` (optional chaining)
+- Applied `as const` and `satisfies` for type-safe constants
+- Replaced `forEach` with `for...of` loops
+- Used `.at(-1)` instead of `arr[arr.length - 1]` (ES2022)
+- Used named imports (`import { v4 as uuidv4 }`) instead of namespace imports
+- Replaced `.substr()` with `.substring()` (non-deprecated)
+- Removed unused color constants and unnecessary JSDoc comments
+- Extracted helper functions to keep methods under 20 lines
+- Renamed constants to UPPER_SNAKE_CASE (`nsid` → `NSID`, `logLevel` → `LOG_LEVELS`, etc.)
+- Made class properties `readonly` where appropriate
+
+### Fixed
+
+- Fixed `QueueModuleAsyncOptions.inject` type to use proper NestJS `InjectionToken` type
+- Fixed `StubCommandBus.execute()` to return `Promise` matching parent class signature
+- Fixed `AllExceptionsFilter` to pass `DataLog` instead of raw `Error` to logger
+- Fixed `LogAppCtx` decorator to cast computed architecture layer properly
+- Removed deprecated error classes (`http-controller-exception.error.ts`, `platform-unavailable.error.ts`)
+
+### Added
+
+- New spec tests for domain entities, value objects, errors, persistence, and validation
+
+## [1.1.0] - 2026-01-17
+
+### Changed - DDD/Clean Architecture Reorganization
+
+Major structural reorganization following Domain-Driven Design (DDD), Clean Architecture, and CQRS principles. **No breaking changes** - all exports remain available from the package root.
+
+#### Architectural Overview
+
+The library is now organized into four main layers:
+- **core/** - Framework-agnostic domain and application building blocks
+- **infrastructure/** - Technology-specific implementations (TypeORM, Knex, RabbitMQ)
+- **nestjs/** - NestJS framework integrations (modules, HTTP layer, error handling)
+- **shared/** - Validation, utilities, and testing helpers
+
+#### Core Layer Migration
+
+**Domain Entities** (`src/core/domain/entities/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/domain/aggregate-root.ts` | `src/core/domain/entities/aggregate-root.ts` |
+| `src/domain/entity.ts` | `src/core/domain/entities/entity.ts` |
+| `src/domain/identifier.ts` | `src/core/domain/entities/identifier.ts` |
+| `src/domain/unique-entity-id.ts` | `src/core/domain/entities/unique-entity-id.ts` |
+| `src/domain/projection.ts` | `src/core/domain/entities/projection.ts` |
+
+**Value Objects** (`src/core/domain/value-objects/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/domain/value-object.ts` | `src/core/domain/value-objects/value-object.ts` |
+| `src/domain/range.ts` | `src/core/domain/value-objects/range.ts` |
+
+**Domain Events** (`src/core/domain/events/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/domain/domain-event.ts` | `src/core/domain/events/domain-event.ts` |
+
+**Application Layer** (`src/core/application/persistence/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/application/repository.ts` | `src/core/application/persistence/repository.ts` |
+| `src/application/query-builder.ts` | `src/core/application/persistence/query-builder.ts` |
+| `src/application/read-projection.ts` | `src/core/application/persistence/read-projection.ts` |
+
+**Types** (`src/core/types/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/domain/architechture-layer.ts` | `src/core/types/architecture-layer.ts` (typo fixed) |
+| `src/definitions/array-element.ts` | `src/core/types/array-element.ts` |
+
+**Errors** (`src/core/errors/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/errors/detailed.error.ts` | `src/core/errors/detailed.error.ts` |
+| `src/errors/domain.error.ts` | `src/core/errors/domain.error.ts` |
+| `src/errors/entity-not-found.error.ts` | `src/core/errors/entity-not-found.error.ts` |
+| `src/errors/command-failure.error.ts` | `src/core/errors/command-failure.error.ts` |
+| `src/errors/command-filter.error.ts` | `src/core/errors/command-filter.error.ts` |
+| `src/errors/query-failure.error.ts` | `src/core/errors/query-failure.error.ts` |
+| `src/errors/too-many-results.error.ts` | `src/core/errors/too-many-results.error.ts` |
+| `src/errors/fake-implementation.error.ts` | `src/core/errors/fake-implementation.error.ts` |
+
+**Deprecated Errors** (`src/core/errors/deprecated/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/errors/old/http-controller-exception.error.ts` | `src/core/errors/deprecated/http-controller-exception.error.ts` |
+| `src/errors/old/platform-unavailable.error.ts` | `src/core/errors/deprecated/platform-unavailable.error.ts` |
+
+#### Infrastructure Layer Migration
+
+**Write-Side TypeORM** (`src/infrastructure/persistence/write-side/typeorm/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/infrastructure/persistence/write-side/aggregate-typeorm-repository.ts` | `src/infrastructure/persistence/write-side/typeorm/aggregate-typeorm.repository.ts` |
+| `src/infrastructure/persistence/write-side/entity-typeorm-repository.ts` | `src/infrastructure/persistence/write-side/typeorm/entity-typeorm.repository.ts` |
+| `src/infrastructure/persistence/write-side/orm-mapper.ts` | `src/infrastructure/persistence/write-side/typeorm/orm.mapper.ts` |
+| `src/infrastructure/persistence/write-side/orm-embedded-mapper.ts` | `src/infrastructure/persistence/write-side/typeorm/orm-embedded.mapper.ts` |
+| `src/infrastructure/persistence/write-side/model-attributes.ts` | `src/infrastructure/persistence/write-side/typeorm/model-attributes.ts` |
+
+**Read-Side Knex** (`src/infrastructure/persistence/read-side/knex/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/infrastructure/persistence/read-side/knex-query-builder.ts` | `src/infrastructure/persistence/read-side/knex/knex.query-builder.ts` |
+| `src/infrastructure/persistence/read-side/knex-types.definition.ts` | `src/infrastructure/persistence/read-side/knex/knex-types.definition.ts` |
+
+**In-Memory** (`src/infrastructure/persistence/in-memory/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/infrastructure/persistence/write-side/in-memory.repository.ts` | `src/infrastructure/persistence/in-memory/in-memory.repository.ts` |
+| `src/infrastructure/persistence/read-side/in-memory.query-builder.ts` | `src/infrastructure/persistence/in-memory/in-memory.query-builder.ts` |
+| `src/application/fake.repository.ts` | `src/infrastructure/persistence/in-memory/fake.repository.ts` |
+
+**Messaging** (`src/infrastructure/messaging/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/modules/messaging/messaging.service.ts` | `src/infrastructure/messaging/messaging.service.ts` |
+| `src/modules/queue/messaging.service.ts` | `src/infrastructure/messaging/queue-messaging.service.ts` |
+| `src/modules/queue/queue-manager.service.ts` | `src/infrastructure/messaging/queue-manager.service.ts` |
+| `src/modules/queue/types.ts` | `src/infrastructure/messaging/types.ts` |
+| `src/modules/messaging/rabbit-messaging.service.ts` | `src/infrastructure/messaging/rabbitmq/rabbit-messaging.service.ts` |
+| `src/modules/messaging/fake-messaging.service.ts` | `src/infrastructure/messaging/fake/fake-messaging.service.ts` |
+
+**Config** (`src/infrastructure/config/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/modules/config/config.service.ts` | `src/infrastructure/config/config.service.ts` |
+| `src/modules/config/config.provider.ts` | `src/infrastructure/config/config.provider.ts` |
+
+#### NestJS Layer Migration
+
+**HTTP Filters** (`src/nestjs/http/filters/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/filters/all-exceptions.filter.ts` | `src/nestjs/http/filters/all-exceptions.filter.ts` |
+| `src/filters/command-failure.filter.ts` | `src/nestjs/http/filters/command-failure.filter.ts` |
+| `src/filters/too-many-results.filter.ts` | `src/nestjs/http/filters/too-many-results.filter.ts` |
+| `src/filters/rpc-exceptions.filter.ts` | `src/nestjs/http/filters/rpc-exceptions.filter.ts` |
+
+**HTTP Interceptors** (`src/nestjs/http/interceptors/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/interceptors/serialize-output.ts` | `src/nestjs/http/interceptors/serialize-output.interceptor.ts` |
+| `src/modules/logger/interceptor/log-app-ctx-interceptor.ts` | `src/nestjs/http/interceptors/log-app-ctx.interceptor.ts` |
+
+**HTTP Middleware** (`src/nestjs/http/middleware/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/modules/logger/middleware/http-logger-middleware.ts` | `src/nestjs/http/middleware/http-logger.middleware.ts` |
+| `src/modules/logger/middleware/logger-middleware.ts` | `src/nestjs/http/middleware/logger.middleware.ts` |
+
+**HTTP Decorators** (`src/nestjs/http/decorators/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/modules/logger/decorator/log-app-ctx.ts` | `src/nestjs/http/decorators/log-app-ctx.decorator.ts` |
+
+**HTTP DTOs** (`src/nestjs/http/dtos/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/infrastructure/web/common-dtos/date-range.dto.ts` | `src/nestjs/http/dtos/date-range.dto.ts` |
+
+**HTTP Swagger** (`src/nestjs/http/swagger/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/infrastructure/web/rest/swagger.ts` | `src/nestjs/http/swagger/swagger.ts` |
+
+**Error Handlers** (`src/nestjs/errors/handlers/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/error-handlers/error-handler.ts` | `src/nestjs/errors/handlers/error-handler.ts` |
+| `src/error-handlers/error-handler.type.ts` | `src/nestjs/errors/handlers/error-handler.type.ts` |
+| `src/error-handlers/generic-error-handler.ts` | `src/nestjs/errors/handlers/generic-error-handler.ts` |
+| `src/error-handlers/validation-error-handler.ts` | `src/nestjs/errors/handlers/validation-error-handler.ts` |
+| `src/error-handlers/handle-errors.decorator.ts` | `src/nestjs/errors/handlers/handle-errors.decorator.ts` |
+
+**Error Parsers** (`src/nestjs/errors/parsers/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/error-parsers/error-metadata.definition.ts` | `src/nestjs/errors/parsers/error-metadata.definition.ts` |
+| `src/error-parsers/axios-metadata.parser.ts` | `src/nestjs/errors/parsers/axios-metadata.parser.ts` |
+| `src/error-parsers/knex-metadata.parser.ts` | `src/nestjs/errors/parsers/knex-metadata.parser.ts` |
+| `src/error-parsers/typeorm-metadata.parser.ts` | `src/nestjs/errors/parsers/typeorm-metadata.parser.ts` |
+| `src/error-parsers/workos-metadata.parser.ts` | `src/nestjs/errors/parsers/workos-metadata.parser.ts` |
+
+**Modules** (`src/nestjs/modules/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/modules/config/config.module.ts` | `src/nestjs/modules/config/config.module.ts` |
+| `src/modules/logger/logger.module.ts` | `src/nestjs/modules/logger/logger.module.ts` |
+| `src/modules/messaging/messaging.module.ts` | `src/nestjs/modules/messaging/messaging.module.ts` |
+| `src/modules/queue/queue.module.ts` | `src/nestjs/modules/queue/queue.module.ts` |
+| `src/modules/knex/knex.module.ts` | `src/nestjs/modules/knex/knex.module.ts` |
+| `src/modules/graphql/paginated-response.object-type.ts` | `src/nestjs/modules/graphql/paginated-response.object-type.ts` |
+| `src/modules/healthcheck/dtos/healthcheck-out.dto.ts` | `src/nestjs/modules/healthcheck/healthcheck-out.dto.ts` |
+
+#### Validation Layer Migration
+
+**Validation Decorators** (`src/validation/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/decorators/ensure-array.ts` | `src/validation/ensure-array.decorator.ts` |
+| `src/decorators/is-iso-date.ts` | `src/validation/is-iso-date.decorator.ts` |
+| `src/decorators/is-less-than.ts` | `src/validation/is-less-than.decorator.ts` |
+| `src/decorators/is-less-than-or-equal.ts` | `src/validation/is-less-than-or-equal.decorator.ts` |
+| `src/decorators/is-more-than.ts` | `src/validation/is-more-than.decorator.ts` |
+| `src/decorators/is-more-than-or-equal.ts` | `src/validation/is-more-than-or-equal.decorator.ts` |
+| `src/decorators/is-time-string.ts` | `src/validation/is-time-string.decorator.ts` |
+
+#### Testing Layer Migration
+
+**Stubs** (`src/testing/stubs/`)
+| Old Path | New Path |
+|----------|----------|
+| `src/testing/command-bus.stub.ts` | `src/testing/stubs/command-bus.stub.ts` |
+| `src/testing/event-bus.stub.ts` | `src/testing/stubs/event-bus.stub.ts` |
+| `src/testing/event-publisher.stub.ts` | `src/testing/stubs/event-publisher.stub.ts` |
+| `src/testing/query-bus.stub.ts` | `src/testing/stubs/query-bus.stub.ts` |
+| `src/testing/stub.ts` | `src/testing/stubs/stub.ts` |
+
+### Fixed
+- Fixed typo: `architechture-layer.ts` renamed to `architecture-layer.ts`
+- Fixed TypeScript compilation error in `src/utils/file.ts` by ensuring `@types/multer` dependency is installed
+
+### Deprecated
+- `src/core/errors/deprecated/http-controller-exception.error.ts` - Use error handlers from `nestjs/errors/handlers` instead
+- `src/core/errors/deprecated/platform-unavailable.error.ts` - Use a more specific error class instead
+
+## [1.0.0] - 2026-01-17
+
+### Added - Initial Release
+
+#### Application Layer
+- `src/application/fake.repository.ts` - Fake repository implementation for testing
+- `src/application/index.ts` - Application layer exports
+- `src/application/query-builder.ts` - Query builder abstraction
+- `src/application/read-projection.ts` - Read projection interface
+- `src/application/repository.ts` - Repository interface
+
+#### Decorators
+- `src/decorators/ensure-array.ts` - Array transformation decorator
+- `src/decorators/index.ts` - Decorators exports
+- `src/decorators/is-iso-date.spec.ts` - ISO date validation tests
+- `src/decorators/is-iso-date.ts` - ISO date validation decorator
+- `src/decorators/is-less-than-or-equal.spec.ts` - Less than or equal validation tests
+- `src/decorators/is-less-than-or-equal.ts` - Less than or equal validation decorator
+- `src/decorators/is-less-than.spec.ts` - Less than validation tests
+- `src/decorators/is-less-than.ts` - Less than validation decorator
+- `src/decorators/is-more-than-or-equal.spec.ts` - More than or equal validation tests
+- `src/decorators/is-more-than-or-equal.ts` - More than or equal validation decorator
+- `src/decorators/is-more-than.spec.ts` - More than validation tests
+- `src/decorators/is-more-than.ts` - More than validation decorator
+- `src/decorators/is-time-string.spec.ts` - Time string validation tests
+- `src/decorators/is-time-string.ts` - Time string validation decorator
+
+#### Definitions
+- `src/definitions/array-element.ts` - Array element type definitions
+- `src/definitions/index.ts` - Definitions exports
+
+#### Domain Layer
+- `src/domain/aggregate-root.ts` - Aggregate root base class
+- `src/domain/architechture-layer.ts` - Architecture layer definitions
+- `src/domain/domain-event.ts` - Domain event base class
+- `src/domain/entity.ts` - Entity base class
+- `src/domain/identifier.ts` - Identifier interface
+- `src/domain/index.ts` - Domain layer exports
+- `src/domain/projection.ts` - Projection interface
+- `src/domain/range.ts` - Range value object
+- `src/domain/unique-entity-id.ts` - Unique entity identifier
+- `src/domain/value-object.ts` - Value object base class
+
+#### Error Handlers
+- `src/error-handlers/error-handler.spec.ts` - Error handler tests
+- `src/error-handlers/error-handler.ts` - Error handler interface
+- `src/error-handlers/error-handler.type.ts` - Error handler type definitions
+- `src/error-handlers/generic-error-handler.spec.ts` - Generic error handler tests
+- `src/error-handlers/generic-error-handler.ts` - Generic error handler implementation
+- `src/error-handlers/handle-errors.decorator.ts` - Error handling decorator
+- `src/error-handlers/handle-errors.spec.ts` - Error handling decorator tests
+- `src/error-handlers/index.ts` - Error handlers exports
+- `src/error-handlers/validation-error-handler.spec.ts` - Validation error handler tests
+- `src/error-handlers/validation-error-handler.ts` - Validation error handler implementation
+
+#### Error Parsers
+- `src/error-parsers/axios-metadata.parser.ts` - Axios error metadata parser
+- `src/error-parsers/error-metadata.definition.ts` - Error metadata type definitions
+- `src/error-parsers/index.ts` - Error parsers exports
+- `src/error-parsers/knex-metadata.parser.ts` - Knex error metadata parser
+- `src/error-parsers/typeorm-metadata.parser.ts` - TypeORM error metadata parser
+- `src/error-parsers/workos-metadata.parser.ts` - WorkOS error metadata parser
+
+#### Errors
+- `src/errors/command-failure.error.ts` - Command failure error
+- `src/errors/command-filter.error.ts` - Command filter error
+- `src/errors/detailed.error.ts` - Detailed error with metadata
+- `src/errors/domain.error.ts` - Domain error base class
+- `src/errors/entity-not-found.error.ts` - Entity not found error
+- `src/errors/fake-implementation.error.ts` - Fake implementation error
+- `src/errors/index.ts` - Errors exports
+- `src/errors/old/http-controller-exception.error.ts` - Legacy HTTP controller exception
+- `src/errors/old/platform-unavailable.error.ts` - Legacy platform unavailable error
+- `src/errors/query-failure.error.ts` - Query failure error
+- `src/errors/too-many-results.error.ts` - Too many results error
+
+#### Filters
+- `src/filters/all-exceptions.filter.spec.ts` - All exceptions filter tests
+- `src/filters/all-exceptions.filter.ts` - All exceptions filter implementation
+- `src/filters/command-failure.filter.spec.ts` - Command failure filter tests
+- `src/filters/command-failure.filter.ts` - Command failure filter implementation
+- `src/filters/index.ts` - Filters exports
+- `src/filters/rpc-exceptions.filter.ts` - RPC exceptions filter
+- `src/filters/too-many-results.filter.ts` - Too many results filter
+
+#### Infrastructure - Persistence
+- `src/infrastructure/persistence/errors/model-to-entity-conversion.error.ts` - Model to entity conversion error
+- `src/infrastructure/persistence/errors/persistence.error.ts` - Persistence error
+- `src/infrastructure/persistence/index.ts` - Persistence layer exports
+- `src/infrastructure/persistence/read-side/in-memory.query-builder.ts` - In-memory query builder
+- `src/infrastructure/persistence/read-side/knex-query-builder.ts` - Knex query builder
+- `src/infrastructure/persistence/read-side/knex-types.definition.ts` - Knex type definitions
+- `src/infrastructure/persistence/write-side/aggregate-typeorm-repository.ts` - Aggregate TypeORM repository
+- `src/infrastructure/persistence/write-side/entity-typeorm-repository.ts` - Entity TypeORM repository
+- `src/infrastructure/persistence/write-side/in-memory.repository.ts` - In-memory repository
+- `src/infrastructure/persistence/write-side/model-attributes.ts` - Model attributes utilities
+- `src/infrastructure/persistence/write-side/orm-embedded-mapper.ts` - ORM embedded mapper
+- `src/infrastructure/persistence/write-side/orm-mapper.ts` - ORM mapper
+
+#### Infrastructure - Web
+- `src/infrastructure/web/common-dtos/date-range.dto.ts` - Date range DTO
+- `src/infrastructure/web/common-dtos/index.ts` - Common DTOs exports
+- `src/infrastructure/web/index.ts` - Web infrastructure exports
+- `src/infrastructure/web/rest/index.ts` - REST infrastructure exports
+- `src/infrastructure/web/rest/swagger.ts` - Swagger configuration
+
+#### Interceptors
+- `src/interceptors/index.ts` - Interceptors exports
+- `src/interceptors/serialize-output.ts` - Output serialization interceptor
+
+#### Modules - Config
+- `src/modules/config/config.module.ts` - Configuration module
+- `src/modules/config/config.provider.spec.ts` - Configuration provider tests
+- `src/modules/config/config.provider.ts` - Configuration provider
+- `src/modules/config/config.service.ts` - Configuration service
+- `src/modules/config/index.ts` - Config module exports
+
+#### Modules - GraphQL
+- `src/modules/graphql/index.ts` - GraphQL module exports
+- `src/modules/graphql/paginated-response.object-type.ts` - Paginated response GraphQL type
+
+#### Modules - Healthcheck
+- `src/modules/healthcheck/dtos/healthcheck-out.dto.ts` - Healthcheck output DTO
+- `src/modules/healthcheck/index.ts` - Healthcheck module exports
+
+#### Modules - Knex
+- `src/modules/knex/index.ts` - Knex module exports
+- `src/modules/knex/knex-core.module.ts` - Knex core module
+- `src/modules/knex/knex.decorator.ts` - Knex decorator
+- `src/modules/knex/knex.interface.ts` - Knex interface
+- `src/modules/knex/knex.module.ts` - Knex module
+- `src/modules/knex/knex.token.ts` - Knex injection token
+
+#### Modules - Logger
+- `src/modules/logger/app-logger/app-logger.spec.ts` - App logger tests
+- `src/modules/logger/app-logger/app-logger.ts` - App logger implementation
+- `src/modules/logger/decorator/log-app-ctx.spec.ts` - Log application context decorator tests
+- `src/modules/logger/decorator/log-app-ctx.ts` - Log application context decorator
+- `src/modules/logger/index.ts` - Logger module exports
+- `src/modules/logger/interceptor/log-app-ctx-interceptor.spec.ts` - Log context interceptor tests
+- `src/modules/logger/interceptor/log-app-ctx-interceptor.ts` - Log context interceptor
+- `src/modules/logger/logger.module.ts` - Logger module
+- `src/modules/logger/middleware/http-logger-middleware.spec.ts` - HTTP logger middleware tests
+- `src/modules/logger/middleware/http-logger-middleware.ts` - HTTP logger middleware
+- `src/modules/logger/middleware/logger-middleware.spec.ts` - Logger middleware tests
+- `src/modules/logger/middleware/logger-middleware.ts` - Logger middleware
+- `src/modules/logger/service/log.ts` - Log utility
+- `src/modules/logger/service/logger.service.spec.ts` - Logger service tests
+- `src/modules/logger/service/logger.service.ts` - Logger service
+- `src/modules/logger/transports/console-color.transport.ts` - Console color transport
+- `src/modules/logger/transports/console-json.transport.ts` - Console JSON transport
+- `src/modules/logger/transports/console.transport.ts` - Console transport
+- `src/modules/logger/transports/fake.transport.ts` - Fake transport for testing
+- `src/modules/logger/transports/index.ts` - Transports exports
+- `src/modules/logger/transports/logger-transport.spec.ts` - Logger transport tests
+- `src/modules/logger/transports/logger-transport.ts` - Logger transport interface
+
+#### Modules - Messaging
+- `src/modules/messaging/fake-messaging.service.ts` - Fake messaging service
+- `src/modules/messaging/index.ts` - Messaging module exports
+- `src/modules/messaging/messaging.module.ts` - Messaging module
+- `src/modules/messaging/messaging.service.ts` - Messaging service interface
+- `src/modules/messaging/rabbit-messaging.service.ts` - RabbitMQ messaging service
+
+#### Modules - Queue
+- `src/modules/queue/default-queue-name.resolver.ts` - Default queue name resolver
+- `src/modules/queue/fake-messaging.service.ts` - Fake messaging service for queues
+- `src/modules/queue/fake-queue-manager.service.ts` - Fake queue manager
+- `src/modules/queue/index.ts` - Queue module exports
+- `src/modules/queue/messaging.service.ts` - Queue messaging service
+- `src/modules/queue/queue-manager.service.ts` - Queue manager interface
+- `src/modules/queue/queue.module.ts` - Queue module
+- `src/modules/queue/rabbit-messaging.service.ts` - RabbitMQ messaging service
+- `src/modules/queue/rabbit-queue-manager.service.ts` - RabbitMQ queue manager
+- `src/modules/queue/types.ts` - Queue type definitions
+
+#### Testing Utilities
+- `src/testing/command-bus.stub.ts` - Command bus stub for testing
+- `src/testing/event-bus.stub.ts` - Event bus stub for testing
+- `src/testing/event-publisher.stub.ts` - Event publisher stub for testing
+- `src/testing/fake-logger.ts` - Fake logger for testing
+- `src/testing/index.ts` - Testing utilities exports
+- `src/testing/query-bus.stub.ts` - Query bus stub for testing
+- `src/testing/stub.spec.ts` - Stub utilities tests
+- `src/testing/stub.ts` - Stub utilities
+
+#### Utils
+- `src/utils/array.spec.ts` - Array utilities tests
+- `src/utils/array.ts` - Array utilities
+- `src/utils/base64.spec.ts` - Base64 utilities tests
+- `src/utils/base64.ts` - Base64 encoding/decoding utilities
+- `src/utils/collection.ts` - Collection utilities
+- `src/utils/common.ts` - Common utilities
+- `src/utils/csv.ts` - CSV utilities
+- `src/utils/file.spec.ts` - File utilities tests
+- `src/utils/file.ts` - File utilities (file extension extraction)
+- `src/utils/hash-key.ts` - Hash key utilities
+- `src/utils/index.ts` - Utils exports
+- `src/utils/invariant.ts` - Invariant assertion utilities
+- `src/utils/iso-date.ts` - ISO date utilities
+- `src/utils/object.spec.ts` - Object utilities tests
+- `src/utils/object.ts` - Object utilities
+- `src/utils/paginated.ts` - Pagination utilities
+- `src/utils/string.spec.ts` - String utilities tests
+- `src/utils/string.ts` - String utilities
+- `src/utils/type.ts` - Type utilities
+- `src/utils/xml.ts` - XML utilities
+
+#### Utils - Date
+- `src/utils/date/date-range.ts` - Date range utilities
+- `src/utils/date/date.spec.ts` - Date utilities tests
+- `src/utils/date/date.ts` - Date utilities
+- `src/utils/date/diff.spec.ts` - Date diff tests
+- `src/utils/date/diffYear.spec.ts` - Year diff tests
+- `src/utils/date/fillMissingRangeValues.spec.ts` - Fill missing range values tests
+- `src/utils/date/groubBy.spec.ts` - Group by date tests
+- `src/utils/date/index.ts` - Date utilities exports
+- `src/utils/date/isSame.spec.ts` - Date comparison tests
+
+#### Root Files
+- `src/index.ts` - Main library exports
+
+#### Configuration Files
+- `.eslintrc.js` - ESLint configuration
+- `.yarnrc.yml` - Yarn configuration
+- `jest.config.ts` - Jest configuration
+- `jest/jest.config.base.ts` - Jest base configuration
+- `jest/jest.spec.base.ts` - Jest spec base configuration
+- `package.json` - Package configuration and dependencies
+- `tsconfig.build.json` - TypeScript build configuration
+- `tsconfig.json` - TypeScript configuration
+- `tsconfig.spec.json` - TypeScript test configuration
+
+### Dependencies
+- NestJS framework (v11.x) with core modules
+- TypeORM (v0.3.25) for ORM
+- Knex (v3.1.0) for query building
+- GraphQL (v16.11.0) with NestJS integration
+- RabbitMQ via amqplib for messaging
+- Jest (v30.x) for testing
+- TypeScript (v5.8.3)
+- Various utility libraries (lodash, luxon, uuid, etc.)

package/README.md

@@ -0,0 +1,3 @@
+### @invariant-labs/foundation
+
+DDD foundation library with common utilities for NestJS applications.

package/eslint.config.mjs

@@ -0,0 +1,52 @@
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+import prettierConfig from "eslint-config-prettier";
+import noOnlyTests from "eslint-plugin-no-only-tests";
+import globals from "globals";
+
+export default tseslint.config(
+  {
+    ignores: ["node_modules/", "dist/", "eslint.config.mjs"],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  prettierConfig,
+  {
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: "module",
+      globals: {
+        ...globals.node,
+        ...globals.jest,
+      },
+      parserOptions: {
+        project: "./tsconfig.json",
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    plugins: {
+      "no-only-tests": noOnlyTests,
+    },
+    rules: {
+      semi: "error",
+      curly: "error",
+      "@typescript-eslint/no-unsafe-return": "warn",
+      "@typescript-eslint/no-unsafe-assignment": "warn",
+      "@typescript-eslint/no-unsafe-call": "warn",
+      "@typescript-eslint/no-unsafe-argument": "warn",
+      "@typescript-eslint/no-unsafe-member-access": "warn",
+      "no-only-tests/no-only-tests": "error",
+      "no-console": "error",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { vars: "all", args: "after-used", ignoreRestSiblings: false },
+      ],
+    },
+  },
+  {
+    files: ["**/*.spec.ts", "**/*.integration.ts", "**/*.e2e.ts"],
+    rules: {
+      "no-only-tests/no-only-tests": "error",
+    },
+  },
+);

package/invariant.json

@@ -0,0 +1,22 @@
+{
+  "name": "foundation",
+  "version": "1.0.0",
+  "targets": [
+    "claude"
+  ],
+  "packages": {
+    "permissions": {
+      "name": "permissions",
+      "version": "1.0.0",
+      "source": "github",
+      "sourceUrl": "github:invariant-guru/permissions"
+    }
+  },
+  "active": [
+    {
+      "package": "permissions",
+      "type": "instructions",
+      "item": "high"
+    }
+  ]
+}

package/jest/jest.config.base.ts

@@ -0,0 +1,30 @@
+export default {
+  roots: ["<rootDir>/src"],
+  moduleDirectories: ["node_modules"],
+  testPathIgnorePatterns: ["./node_modules/"],
+  testEnvironment: "node",
+  preset: "ts-jest/presets/default-esm",
+  transform: {
+    "^.+\\.[tj]s$": [
+      "ts-jest",
+      {
+        tsconfig: "<rootDir>/tsconfig.spec.json",
+        useESM: true,
+      },
+    ],
+  },
+  // These modules will be excluded from transformIgnorePatterns configuration which means they will be transformed.
+  transformIgnorePatterns: ["/node_modules/(?!(jose)/)"],
+  moduleNameMapper: {
+    "^src/(.*)$": "<rootDir>/src/$1",
+    "^(\\.{1,2}/.*)\\.js$": "$1",
+  },
+  extensionsToTreatAsEsm: [".ts"],
+  maxWorkers: "25%",
+  moduleFileExtensions: ["ts", "js"],
+  restoreMocks: true,
+  workerIdleMemoryLimit: "1024MB",
+  testEnvironmentOptions: {
+    globalsCleanup: "on",
+  },
+};

package/jest/jest.spec.base.ts

@@ -0,0 +1,7 @@
+import sharedConfig from "./jest.config.base";
+
+export default {
+  ...sharedConfig,
+  testMatch: ["**/*.spec.ts"],
+  workerIdleMemoryLimit: "512MB",
+};