@russ-b/nestjs-common-tools 2.0.2 → 2.1.1

package/README.md

@@ -14,6 +14,14 @@ npm install @russ-b/nestjs-common-tools
 
 Depending on which features you use, make sure the relevant peer dependencies are also installed in your project.
 
+For TypeORM helpers that integrate with Nest's `TypeOrmModule`, install `@nestjs/typeorm` together with TypeORM and your database driver:
+
+```bash
+npm install @nestjs/typeorm typeorm pg
+# or, for MySQL
+npm install @nestjs/typeorm typeorm mysql2
+```
+
 ## Public entrypoints
 
 This package uses subpath exports for most features.
@@ -211,6 +219,28 @@ It will:
 - trim extra spaces and ignore case
 - leave unsupported values unchanged
 
+### `ToOptionalNumber`
+
+`ToOptionalNumber()` is useful for DTO fields that may arrive as strings such as `'42'`, blank strings, or already parsed numbers.
+
+```typescript
+import { ToOptionalNumber } from '@russ-b/nestjs-common-tools/class-transformer';
+
+export class SearchDto {
+  @ToOptionalNumber()
+  page?: number;
+}
+```
+
+It will:
+
+- convert numeric strings to numbers
+- trim extra spaces before parsing
+- convert empty or blank strings to `undefined`
+- keep `null` as `null`
+- keep `undefined` as `undefined`
+- return `NaN` for unsupported non-string values
+
 ## S3 Module
 
 `S3Module` is a small NestJS wrapper around the AWS SDK v3 S3 client. It gives you a reusable `S3Service` with a simple Nest-friendly setup for uploads, downloads, deletes, and signed URLs.
@@ -483,6 +513,9 @@ export class AppModule {}
 
 ## Usage
 
+> Deprecated: `IsEntity` couples DTO validation to persistence/service concerns.
+> Keep entity existence checks in the service/application layer instead.
+
 ```typescript
 import { IsEntity } from '@russ-b/nestjs-common-tools/validators';
 
@@ -528,6 +561,89 @@ export class AssignRolesDto {
 }
 ```
 
+## TypeORM Options Factories
+
+`createTypeOrmOptions` creates Nest `TypeOrmModuleOptions` using driver-specific defaults. It currently supports PostgreSQL and MySQL.
+
+```typescript
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { createTypeOrmOptions } from '@russ-b/nestjs-common-tools/typeorm';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+    }),
+    TypeOrmModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: (config: ConfigService) =>
+        createTypeOrmOptions({
+          type: 'postgres',
+          appName: 'parking-api',
+          databaseUrl: config.getOrThrow<string>('DATABASE_URL'),
+          schema: config.get<string>('DATABASE_SCHEMA'),
+          sync: config.get<string>('TYPEORM_SYNC'),
+          logging: config.get<string>('TYPEORM_LOGGING'),
+          isProduction: config.get<string>('NODE_ENV') === 'production',
+        }),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+PostgreSQL support is also exposed directly as `createPostgresTypeormOptions`. Its `schema` option is applied both as TypeORM's schema and as `search_path`, and pool options are passed through the `pg` driver via TypeORM's `extra` config.
+
+For managed PostgreSQL providers that require SSL with a CA certificate, you can pass atomic connection fields and `sslCa`. This avoids `pg` overwriting the explicit `ssl` object when `sslmode` or `sslrootcert` exists in the connection string.
+
+```typescript
+TypeOrmModule.forRootAsync({
+  imports: [ConfigModule],
+  inject: [ConfigService],
+  useFactory: (config: ConfigService) =>
+    createTypeOrmOptions({
+      type: 'postgres',
+      database: {
+        host: config.getOrThrow<string>('DB_HOST'),
+        port: config.get<number>('DB_PORT'),
+        username: config.getOrThrow<string>('DB_USER'),
+        password: config.getOrThrow<string>('DB_PASSWORD'),
+        database: config.getOrThrow<string>('DB_NAME'),
+      },
+      sslCa: config.get<string>('DB_CA_CERT'),
+      sync: config.get<string>('TYPEORM_SYNC'),
+      logging: config.get<string>('TYPEORM_LOGGING'),
+      isProduction: config.get<string>('NODE_ENV') === 'production',
+    }),
+});
+```
+
+When `sslCa` is used together with `databaseUrl`, SSL-related query params such as `sslmode` and `sslrootcert` are removed from the URL before TypeORM passes the config to `pg`.
+
+For MySQL, use `type: 'mysql'` or call `createMysqlTypeormOptions` directly:
+
+```typescript
+TypeOrmModule.forRootAsync({
+  imports: [ConfigModule],
+  inject: [ConfigService],
+  useFactory: (config: ConfigService) =>
+    createTypeOrmOptions({
+      type: 'mysql',
+      databaseUrl: config.getOrThrow<string>('DATABASE_URL'),
+      sync: config.get<string>('TYPEORM_SYNC'),
+      logging: config.get<string>('TYPEORM_LOGGING'),
+      isProduction: config.get<string>('NODE_ENV') === 'production',
+      connectorPackage: 'mysql2',
+    }),
+});
+```
+
+The MySQL factory uses TypeORM's `poolSize`, `connectTimeout`, and `acquireTimeout` options instead of PostgreSQL-only `search_path`, `application_name`, or `query_timeout` settings.
+
 ## TypeORM Exception Filter
 
 When you want to convert low-level database errors into meaningful HTTP responses, a TypeORM exception filter helps keep that logic out of controllers and services. You can register it once and optionally override specific constraints with your own domain-friendly messages.

package/dist/class-transformer/index.d.ts

@@ -1,2 +1,4 @@
 export * from './to-string-array.decorator';
 export * from './to-boolean-from-string.decorator';
+export * from './to-optional-string.decorator';
+export * from './to-optional-number.decorator';

package/dist/class-transformer/index.js

@@ -16,4 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./to-string-array.decorator"), exports);
 __exportStar(require("./to-boolean-from-string.decorator"), exports);
+__exportStar(require("./to-optional-string.decorator"), exports);
+__exportStar(require("./to-optional-number.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/dist/class-transformer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/class-transformer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,qEAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/class-transformer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,qEAAmD;AACnD,iEAA+C;AAC/C,iEAA+C"}

package/dist/class-transformer/to-optional-number.decorator.d.ts

@@ -0,0 +1,3 @@
+import { TransformFnParams } from 'class-transformer';
+export declare function ToOptionalNumber(): PropertyDecorator;
+export declare const parseOptionalNumberTransformer: ({ value, }: TransformFnParams) => unknown;

package/dist/class-transformer/to-optional-number.decorator.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOptionalNumberTransformer = void 0;
+exports.ToOptionalNumber = ToOptionalNumber;
+const class_transformer_1 = require("class-transformer");
+function ToOptionalNumber() {
+    return (0, class_transformer_1.Transform)(exports.parseOptionalNumberTransformer);
+}
+const parseOptionalNumberTransformer = ({ value, }) => normalizeOptionalNumber(value);
+exports.parseOptionalNumberTransformer = parseOptionalNumberTransformer;
+function normalizeOptionalNumber(value) {
+    if (value === null) {
+        return null;
+    }
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        const trimmedValue = value.trim();
+        return trimmedValue === '' ? undefined : Number(trimmedValue);
+    }
+    if (typeof value === 'number') {
+        return value;
+    }
+    return Number.NaN;
+}
+//# sourceMappingURL=to-optional-number.decorator.js.map

package/dist/class-transformer/to-optional-number.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-optional-number.decorator.js","sourceRoot":"","sources":["../../src/class-transformer/to-optional-number.decorator.ts"],"names":[],"mappings":";;;AAEA,4CAEC;AAJD,yDAAiE;AAEjE,SAAgB,gBAAgB;IAC9B,OAAO,IAAA,6BAAS,EAAC,sCAA8B,CAAC,CAAC;AACnD,CAAC;AAEM,MAAM,8BAA8B,GAAG,CAAC,EAC7C,KAAK,GACa,EAAW,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;AAFpD,QAAA,8BAA8B,kCAEsB;AAEjE,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAElC,OAAO,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC"}

package/dist/class-transformer/to-optional-string.decorator.d.ts

@@ -0,0 +1,3 @@
+import { TransformFnParams } from 'class-transformer';
+export declare function ToOptionalString(): PropertyDecorator;
+export declare const normalizeOptionalStringTransformer: ({ value, }: TransformFnParams) => unknown;

package/dist/class-transformer/to-optional-string.decorator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptionalStringTransformer = void 0;
+exports.ToOptionalString = ToOptionalString;
+const class_transformer_1 = require("class-transformer");
+function ToOptionalString() {
+    return (0, class_transformer_1.Transform)(exports.normalizeOptionalStringTransformer);
+}
+const normalizeOptionalStringTransformer = ({ value, }) => {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const trimmedValue = value.trim();
+    return trimmedValue === '' ? undefined : trimmedValue;
+};
+exports.normalizeOptionalStringTransformer = normalizeOptionalStringTransformer;
+//# sourceMappingURL=to-optional-string.decorator.js.map

package/dist/class-transformer/to-optional-string.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-optional-string.decorator.js","sourceRoot":"","sources":["../../src/class-transformer/to-optional-string.decorator.ts"],"names":[],"mappings":";;;AAEA,4CAEC;AAJD,yDAAiE;AAEjE,SAAgB,gBAAgB;IAC9B,OAAO,IAAA,6BAAS,EAAC,0CAAkC,CAAC,CAAC;AACvD,CAAC;AAEM,MAAM,kCAAkC,GAAG,CAAC,EACjD,KAAK,GACa,EAAW,EAAE;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAElC,OAAO,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;AACxD,CAAC,CAAC;AAVW,QAAA,kCAAkC,sCAU7C"}

package/dist/common/util/mask-string.util.d.ts

@@ -1 +1,15 @@
+/**
+ * Masks a string, leaving only the last N characters visible
+ *
+ * @param value - The string to mask
+ * @param visibleChars - Number of characters to leave visible at the end (default: 4)
+ * @param maskChar - Character to use for masking (default: '*')
+ * @param preservePrefix - Number of characters to preserve at the start (optional)
+ *
+ * @example
+ * maskString('+37369313123', 4)           // '+373*****3123'
+ * maskString('+37369313123', 4, '*', 4)   // '+373*****3123'
+ * maskString('user@example.com', 4)       // '***********.com'
+ * maskString('1234567890', 4)             // '******7890'
+ */
 export declare function maskString(value: string, visibleChars?: number, maskChar?: string, preservePrefix?: number): string;

package/dist/common/util/mask-string.util.js

@@ -1,10 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.maskString = maskString;
+/**
+ * Masks a string, leaving only the last N characters visible
+ *
+ * @param value - The string to mask
+ * @param visibleChars - Number of characters to leave visible at the end (default: 4)
+ * @param maskChar - Character to use for masking (default: '*')
+ * @param preservePrefix - Number of characters to preserve at the start (optional)
+ *
+ * @example
+ * maskString('+37369313123', 4)           // '+373*****3123'
+ * maskString('+37369313123', 4, '*', 4)   // '+373*****3123'
+ * maskString('user@example.com', 4)       // '***********.com'
+ * maskString('1234567890', 4)             // '******7890'
+ */
 function maskString(value, visibleChars = 4, maskChar = '*', preservePrefix) {
     if (!value || value.length === 0) {
         return '';
     }
+    // If string is too short to mask meaningfully
     if (value.length <= visibleChars) {
         return maskChar.repeat(value.length);
     }

package/dist/common/util/mask-string.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"mask-string.util.js","sourceRoot":"","sources":["../../../src/common/util/mask-string.util.ts"],"names":[],"mappings":";;AAcA,gCA6BC;AA7BD,SAAgB,UAAU,CACxB,KAAa,EACb,eAAuB,CAAC,EACxB,WAAmB,GAAG,EACtB,cAAuB;IAEvB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAGD,IAAI,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,cAAc,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,YAAY,CAAC;QAClE,MAAM,MAAM,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAErE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAE7C,OAAO,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"mask-string.util.js","sourceRoot":"","sources":["../../../src/common/util/mask-string.util.ts"],"names":[],"mappings":";;AAcA,gCA6BC;AA3CD;;;;;;;;;;;;;GAaG;AACH,SAAgB,UAAU,CACxB,KAAa,EACb,eAAuB,CAAC,EACxB,WAAmB,GAAG,EACtB,cAAuB;IAEvB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,8CAA8C;IAC9C,IAAI,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,cAAc,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,YAAY,CAAC;QAClE,MAAM,MAAM,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAErE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAE7C,OAAO,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;AACjC,CAAC"}

package/dist/logger/logger.d.ts

@@ -1,6 +1,19 @@
 import { LogLevelType, TransportOptions, TransportType } from './types';
 import { LoggerBuilder } from './logger-builder';
 export declare class Logger {
+    /**
+     * Creates a fluent logger builder
+     * @param appName - Application name (default: 'NestApp')
+     * @param level - Log level (default: 'debug')
+     * @returns LoggerBuilder instance
+     * @example
+     * ```ts
+     * const logger = Logger.builder('MyApp', 'info')
+     *   .addTransport('json')
+     *   .addTransport('loki', { lokiUrl: 'http://...' })
+     *   .build();
+     * ```
+     */
     static builder(appName?: string, level?: LogLevelType): LoggerBuilder;
     private static normalizeFormats;
     static create(appName: string, level: LogLevelType, formats?: TransportType[] | TransportType, options?: TransportOptions): import("@nestjs/common").LoggerService;

package/dist/logger/logger.js

@@ -3,6 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
 const logger_builder_1 = require("./logger-builder");
 class Logger {
+    /**
+     * Creates a fluent logger builder
+     * @param appName - Application name (default: 'NestApp')
+     * @param level - Log level (default: 'debug')
+     * @returns LoggerBuilder instance
+     * @example
+     * ```ts
+     * const logger = Logger.builder('MyApp', 'info')
+     *   .addTransport('json')
+     *   .addTransport('loki', { lokiUrl: 'http://...' })
+     *   .build();
+     * ```
+     */
     static builder(appName, level) {
         return new logger_builder_1.LoggerBuilder(appName, level);
     }

package/dist/logger/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":";;;AACA,qDAAiD;AAEjD,MAAa,MAAM;IAcjB,MAAM,CAAC,OAAO,CAAC,OAAgB,EAAE,KAAoB;QACnD,OAAO,IAAI,8BAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAC7B,OAAyC;QAEzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,MAAM,CACX,OAAe,EACf,KAAmB,EACnB,OAAyC,EACzC,OAA0B;QAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAE5E,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAClC,OAAsB,EACtB,IAAmB,EACnB,OAA0B;QAE1B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACzE,CAAC;gBACD,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM;QACV,CAAC;IACH,CAAC;CACF;AA/DD,wBA+DC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":";;;AACA,qDAAiD;AAEjD,MAAa,MAAM;IACjB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAgB,EAAE,KAAoB;QACnD,OAAO,IAAI,8BAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAC7B,OAAyC;QAEzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,MAAM,CACX,OAAe,EACf,KAAmB,EACnB,OAAyC,EACzC,OAA0B;QAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAE5E,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAClC,OAAsB,EACtB,IAAmB,EACnB,OAA0B;QAE1B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACzE,CAAC;gBACD,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM;QACV,CAAC;IACH,CAAC;CACF;AA/DD,wBA+DC"}

package/dist/modules/s3/s3.interface.d.ts

@@ -10,6 +10,9 @@ export interface S3ModuleOptions {
     requestChecksumCalculation?: S3ClientConfig['requestChecksumCalculation'];
     responseChecksumValidation?: S3ClientConfig['responseChecksumValidation'];
     defaultBucket?: string;
+    /**
+     * @deprecated Use defaultBucket instead.
+     */
     bucket?: string;
     logger?: boolean | S3ModuleLogger;
 }

package/dist/pagination/dto/paginated-response.dto.d.ts

@@ -19,6 +19,12 @@ export declare class LegacyPaginatedResponseDto<T> implements LegacyPaginatedRes
     pagination: LegacyPaginationMetaDto;
     data: T[];
 }
+/**
+ * @deprecated This DTO preserves the legacy pagination shape
+ * (`totalItems` / `totalPages`).
+ * Use PaginationResponseDto for the standard contract or
+ * LegacyPaginatedResponseDto when you explicitly need the legacy contract.
+ */
 export declare class PaginatedResponseDto<T> extends LegacyPaginatedResponseDto<T> {
 }
 export {};

package/dist/pagination/dto/paginated-response.dto.js

@@ -83,6 +83,12 @@ __decorate([
 exports.LegacyPaginatedResponseDto = LegacyPaginatedResponseDto = __decorate([
     (0, class_transformer_1.Exclude)()
 ], LegacyPaginatedResponseDto);
+/**
+ * @deprecated This DTO preserves the legacy pagination shape
+ * (`totalItems` / `totalPages`).
+ * Use PaginationResponseDto for the standard contract or
+ * LegacyPaginatedResponseDto when you explicitly need the legacy contract.
+ */
 class PaginatedResponseDto extends LegacyPaginatedResponseDto {
 }
 exports.PaginatedResponseDto = PaginatedResponseDto;

package/dist/pagination/dto/paginated-response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"paginated-response.dto.js","sourceRoot":"","sources":["../../../src/pagination/dto/paginated-response.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAA0D;AAS1D,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAYtB,CAAA;AAVC;IADC,IAAA,0BAAM,GAAE;;gDACK;AAGd;IADC,IAAA,0BAAM,GAAE;;gDACK;AAGd;IADC,IAAA,0BAAM,GAAE;;+CACI;AAGb;IADC,IAAA,0BAAM,GAAE;;kDACO;AAXZ,iBAAiB;IADtB,IAAA,2BAAO,GAAE;GACJ,iBAAiB,CAYtB;AAGD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAY5B,CAAA;AAVC;IADC,IAAA,0BAAM,GAAE;;2DACU;AAGnB;IADC,IAAA,0BAAM,GAAE;;2DACU;AAGnB;IADC,IAAA,0BAAM,GAAE;;qDACI;AAGb;IADC,IAAA,0BAAM,GAAE;;wDACO;AAXZ,uBAAuB;IAD5B,IAAA,2BAAO,GAAE;GACJ,uBAAuB,CAY5B;AAGM,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;CAOjC,CAAA;AAPY,sDAAqB;AAGhC;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC;8BAClB,iBAAiB;yDAAC;AAG9B;IADC,IAAA,0BAAM,GAAE;;mDACC;gCANC,qBAAqB;IADjC,IAAA,2BAAO,GAAE;GACG,qBAAqB,CAOjC;AAGM,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;CAStC,CAAA;AATY,gEAA0B;AAKrC;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC;8BACxB,uBAAuB;8DAAC;AAGpC;IADC,IAAA,0BAAM,GAAE;;wDACC;qCARC,0BAA0B;IADtC,IAAA,2BAAO,GAAE;GACG,0BAA0B,CAStC;AAQD,MAAa,oBAAwB,SAAQ,0BAA6B;CAAG;AAA7E,oDAA6E"}
+{"version":3,"file":"paginated-response.dto.js","sourceRoot":"","sources":["../../../src/pagination/dto/paginated-response.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAA0D;AAS1D,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAYtB,CAAA;AAVC;IADC,IAAA,0BAAM,GAAE;;gDACK;AAGd;IADC,IAAA,0BAAM,GAAE;;gDACK;AAGd;IADC,IAAA,0BAAM,GAAE;;+CACI;AAGb;IADC,IAAA,0BAAM,GAAE;;kDACO;AAXZ,iBAAiB;IADtB,IAAA,2BAAO,GAAE;GACJ,iBAAiB,CAYtB;AAGD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAY5B,CAAA;AAVC;IADC,IAAA,0BAAM,GAAE;;2DACU;AAGnB;IADC,IAAA,0BAAM,GAAE;;2DACU;AAGnB;IADC,IAAA,0BAAM,GAAE;;qDACI;AAGb;IADC,IAAA,0BAAM,GAAE;;wDACO;AAXZ,uBAAuB;IAD5B,IAAA,2BAAO,GAAE;GACJ,uBAAuB,CAY5B;AAGM,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;CAOjC,CAAA;AAPY,sDAAqB;AAGhC;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC;8BAClB,iBAAiB;yDAAC;AAG9B;IADC,IAAA,0BAAM,GAAE;;mDACC;gCANC,qBAAqB;IADjC,IAAA,2BAAO,GAAE;GACG,qBAAqB,CAOjC;AAGM,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;CAStC,CAAA;AATY,gEAA0B;AAKrC;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC;8BACxB,uBAAuB;8DAAC;AAGpC;IADC,IAAA,0BAAM,GAAE;;wDACC;qCARC,0BAA0B;IADtC,IAAA,2BAAO,GAAE;GACG,0BAA0B,CAStC;AAED;;;;;GAKG;AACH,MAAa,oBAAwB,SAAQ,0BAA6B;CAAG;AAA7E,oDAA6E"}

package/dist/pagination/pagination.d.ts

@@ -1,10 +1,16 @@
 import { CountableResponse, LegacyPaginatedResponse, PaginatedResponse, PaginationParams, PaginationRequest } from './interfaces/pagination.interface';
 export declare abstract class Pagination {
     static params(page: number, perPage: number): PaginationParams;
+    /**
+     * @deprecated Use params instead.
+     */
     static paginationParams(page: number, perPage: number): PaginationParams;
     static offset(page: number, perPage: number): number;
     static createResponse<T>({ page, perPage }: PaginationRequest, [data, total]: CountableResponse<T>): PaginatedResponse<T>;
     static createLegacyResponse<T>({ page, perPage }: PaginationRequest, [data, total]: CountableResponse<T>): LegacyPaginatedResponse<T>;
+    /**
+     * @deprecated Use createLegacyResponse instead.
+     */
     static response<T>(pagination: PaginationRequest, result: CountableResponse<T>): LegacyPaginatedResponse<T>;
     private static createMeta;
     private static createLegacyMeta;

package/dist/pagination/pagination.js

@@ -7,6 +7,9 @@ class Pagination {
     static params(page, perPage) {
         return { perPage, offset: Pagination.offset(page, perPage) };
     }
+    /**
+     * @deprecated Use params instead.
+     */
     static paginationParams(page, perPage) {
         return Pagination.params(page, perPage);
     }
@@ -25,6 +28,9 @@ class Pagination {
             pagination: Pagination.createLegacyMeta(Pagination.createMeta(page, perPage, total)),
         };
     }
+    /**
+     * @deprecated Use createLegacyResponse instead.
+     */
     static response(pagination, result) {
         try {
             return Pagination.createLegacyResponse(pagination, result);

package/dist/pagination/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/pagination/pagination.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAUrD,6CAA8E;AAE9E,MAAsB,UAAU;IAC9B,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,OAAe;QACzC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IAC/D,CAAC;IAKD,MAAM,CAAC,gBAAgB,CAAC,IAAY,EAAE,OAAe;QACnD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,OAAe;QACzC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,EAAE,IAAI,EAAE,OAAO,EAAqB,EACpC,CAAC,IAAI,EAAE,KAAK,CAAuB;QAEnC,OAAO;YACL,IAAI;YACJ,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CACzB,EAAE,IAAI,EAAE,OAAO,EAAqB,EACpC,CAAC,IAAI,EAAE,KAAK,CAAuB;QAEnC,OAAO;YACL,IAAI;YACJ,UAAU,EAAE,UAAU,CAAC,gBAAgB,CACrC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAC5C;SACF,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,QAAQ,CACb,UAA6B,EAC7B,MAA4B;QAE5B,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,sCAAyB,EAAE,CAAC;gBAC/C,MAAM,IAAI,4BAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,UAAU,CACvB,IAAY,EACZ,OAAe,EACf,KAAa;QAEb,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;QAEzC,IAAI,IAAI,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,gCAAmB,EAAE,CAAC;QAClC,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK;YACL,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,EAC9B,KAAK,EACL,KAAK,EACL,IAAI,EACJ,OAAO,GACQ;QACf,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,KAAK;YACjB,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;CACF;AAxFD,gCAwFC"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/pagination/pagination.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAUrD,6CAA8E;AAE9E,MAAsB,UAAU;IAC9B,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,OAAe;QACzC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAY,EAAE,OAAe;QACnD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,OAAe;QACzC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,EAAE,IAAI,EAAE,OAAO,EAAqB,EACpC,CAAC,IAAI,EAAE,KAAK,CAAuB;QAEnC,OAAO;YACL,IAAI;YACJ,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CACzB,EAAE,IAAI,EAAE,OAAO,EAAqB,EACpC,CAAC,IAAI,EAAE,KAAK,CAAuB;QAEnC,OAAO;YACL,IAAI;YACJ,UAAU,EAAE,UAAU,CAAC,gBAAgB,CACrC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAC5C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,UAA6B,EAC7B,MAA4B;QAE5B,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,sCAAyB,EAAE,CAAC;gBAC/C,MAAM,IAAI,4BAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,UAAU,CACvB,IAAY,EACZ,OAAe,EACf,KAAa;QAEb,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;QAEzC,IAAI,IAAI,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,gCAAmB,EAAE,CAAC;QAClC,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK;YACL,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,EAC9B,KAAK,EACL,KAAK,EACL,IAAI,EACJ,OAAO,GACQ;QACf,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,KAAK;YACjB,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;CACF;AAxFD,gCAwFC"}

package/dist/typeorm/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from './postgres-typeorm-options.factory';
+export * from './mysql-typeorm-options.factory';
+export * from './typeorm-options.factory';

package/dist/typeorm/config/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./postgres-typeorm-options.factory"), exports);
+__exportStar(require("./mysql-typeorm-options.factory"), exports);
+__exportStar(require("./typeorm-options.factory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/typeorm/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/typeorm/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD;AACnD,kEAAgD;AAChD,4DAA0C"}

package/dist/typeorm/config/mysql-typeorm-options.factory.d.ts

@@ -0,0 +1,13 @@
+import type { TypeOrmModuleOptions } from '@nestjs/typeorm';
+import { CommonTypeormConfigOptions } from './typeorm-options.util';
+export interface MysqlTypeormConfigOptions extends CommonTypeormConfigOptions {
+    type?: 'mysql';
+    connectTimeout?: number;
+    acquireTimeout?: number;
+    charset?: string;
+    timezone?: string;
+    connectorPackage?: 'mysql' | 'mysql2';
+    supportBigNumbers?: boolean;
+    bigNumberStrings?: boolean;
+}
+export declare function createMysqlTypeormOptions(options: MysqlTypeormConfigOptions): TypeOrmModuleOptions;

package/dist/typeorm/config/mysql-typeorm-options.factory.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMysqlTypeormOptions = createMysqlTypeormOptions;
+const common_1 = require("@nestjs/common");
+const typeorm_options_util_1 = require("./typeorm-options.util");
+const logger = new common_1.Logger('MysqlTypeormConfig');
+function createMysqlTypeormOptions(options) {
+    const resolvedOptions = {
+        ...typeorm_options_util_1.TYPEORM_CONFIG_DEFAULTS,
+        connectTimeout: 5000,
+        acquireTimeout: 30_000,
+        ...options,
+    };
+    return {
+        type: 'mysql',
+        url: encodeURI(resolvedOptions.databaseUrl),
+        autoLoadEntities: true,
+        maxQueryExecutionTime: resolvedOptions.maxQueryExecutionTime,
+        synchronize: (0, typeorm_options_util_1.useSynchronize)(resolvedOptions, logger),
+        logging: (0, typeorm_options_util_1.useLogging)(resolvedOptions.logging),
+        retryAttempts: 5,
+        poolSize: resolvedOptions.maxConnections,
+        connectTimeout: resolvedOptions.connectTimeout,
+        acquireTimeout: resolvedOptions.acquireTimeout,
+        charset: resolvedOptions.charset,
+        timezone: resolvedOptions.timezone,
+        connectorPackage: resolvedOptions.connectorPackage,
+        supportBigNumbers: resolvedOptions.supportBigNumbers,
+        bigNumberStrings: resolvedOptions.bigNumberStrings,
+    };
+}
+//# sourceMappingURL=mysql-typeorm-options.factory.js.map

package/dist/typeorm/config/mysql-typeorm-options.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-typeorm-options.factory.js","sourceRoot":"","sources":["../../../src/typeorm/config/mysql-typeorm-options.factory.ts"],"names":[],"mappings":";;AAoCA,8DA2BC;AA/DD,2CAAwC;AAExC,iEAMgC;AA0BhC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,oBAAoB,CAAC,CAAC;AAEhD,SAAgB,yBAAyB,CACvC,OAAkC;IAElC,MAAM,eAAe,GAAsC;QACzD,GAAG,8CAAuB;QAC1B,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,MAAM;QACtB,GAAG,OAAO;KACX,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,SAAS,CAAC,eAAe,CAAC,WAAW,CAAC;QAC3C,gBAAgB,EAAE,IAAI;QACtB,qBAAqB,EAAE,eAAe,CAAC,qBAAqB;QAC5D,WAAW,EAAE,IAAA,qCAAc,EAAC,eAAe,EAAE,MAAM,CAAC;QACpD,OAAO,EAAE,IAAA,iCAAU,EAAC,eAAe,CAAC,OAAO,CAAC;QAC5C,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,eAAe,CAAC,cAAc;QACxC,cAAc,EAAE,eAAe,CAAC,cAAc;QAC9C,cAAc,EAAE,eAAe,CAAC,cAAc;QAC9C,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,QAAQ,EAAE,eAAe,CAAC,QAAQ;QAClC,gBAAgB,EAAE,eAAe,CAAC,gBAAgB;QAClD,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;QACpD,gBAAgB,EAAE,eAAe,CAAC,gBAAgB;KACnD,CAAC;AACJ,CAAC"}

package/dist/typeorm/config/postgres-typeorm-options.factory.d.ts

@@ -0,0 +1,19 @@
+import type { TypeOrmModuleOptions } from '@nestjs/typeorm';
+import { CommonTypeormConfigOptions } from './typeorm-options.util';
+export interface PostgresTypeormDatabaseConnectionOptions {
+    host: string;
+    port?: number;
+    username: string;
+    password: string;
+    database: string;
+}
+export interface PostgresTypeormConfigOptions extends Omit<CommonTypeormConfigOptions, 'databaseUrl'> {
+    type?: 'postgres';
+    databaseUrl?: string;
+    database?: PostgresTypeormDatabaseConnectionOptions;
+    appName?: string;
+    schema?: string;
+    sslCa?: string;
+    queryTimeout?: number;
+}
+export declare function createPostgresTypeormOptions(options: PostgresTypeormConfigOptions): TypeOrmModuleOptions;

package/dist/typeorm/config/postgres-typeorm-options.factory.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPostgresTypeormOptions = createPostgresTypeormOptions;
+const common_1 = require("@nestjs/common");
+const typeorm_options_util_1 = require("./typeorm-options.util");
+const logger = new common_1.Logger('PostgresTypeormConfig');
+function createPostgresTypeormOptions(options) {
+    const resolvedOptions = {
+        ...typeorm_options_util_1.TYPEORM_CONFIG_DEFAULTS,
+        queryTimeout: 30_000,
+        ...options,
+    };
+    const connectionOptions = createConnectionOptions(resolvedOptions);
+    const ssl = createSslOptions(resolvedOptions.sslCa);
+    return {
+        type: 'postgres',
+        ...connectionOptions,
+        ...(ssl ? { ssl } : {}),
+        autoLoadEntities: true,
+        schema: resolvedOptions.schema,
+        maxQueryExecutionTime: resolvedOptions.maxQueryExecutionTime,
+        synchronize: (0, typeorm_options_util_1.useSynchronize)(resolvedOptions, logger),
+        logging: (0, typeorm_options_util_1.useLogging)(resolvedOptions.logging),
+        retryAttempts: 5,
+        extra: {
+            options: resolvedOptions.schema
+                ? `-c search_path=${resolvedOptions.schema},public`
+                : undefined,
+            max: resolvedOptions.maxConnections,
+            idleTimeoutMillis: 10000,
+            connectionTimeoutMillis: 5000,
+            maxUses: 10000,
+            keepAlive: true,
+            ...(resolvedOptions.appName
+                ? { application_name: resolvedOptions.appName }
+                : {}),
+            query_timeout: resolvedOptions.queryTimeout,
+        },
+    };
+}
+function createConnectionOptions(options) {
+    if (options.database) {
+        return options.database;
+    }
+    if (!options.databaseUrl) {
+        throw new Error('databaseUrl or database connection options must be configured.');
+    }
+    const databaseUrl = encodeURI(options.databaseUrl);
+    return {
+        url: options.sslCa
+            ? removeConnectionStringSslParams(databaseUrl)
+            : databaseUrl,
+    };
+}
+function createSslOptions(sslCa) {
+    if (!sslCa) {
+        return undefined;
+    }
+    return {
+        ca: sslCa.replace(/\\n/g, '\n'),
+        rejectUnauthorized: true,
+    };
+}
+function removeConnectionStringSslParams(databaseUrl) {
+    const parsedUrl = new URL(databaseUrl);
+    for (const param of ['ssl', 'sslcert', 'sslkey', 'sslmode', 'sslrootcert']) {
+        parsedUrl.searchParams.delete(param);
+    }
+    return parsedUrl.toString();
+}
+//# sourceMappingURL=postgres-typeorm-options.factory.js.map

package/dist/typeorm/config/postgres-typeorm-options.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-typeorm-options.factory.js","sourceRoot":"","sources":["../../../src/typeorm/config/postgres-typeorm-options.factory.ts"],"names":[],"mappings":";;AAuDA,oEAoCC;AA3FD,2CAAwC;AAGxC,iEAKgC;AA6ChC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,uBAAuB,CAAC,CAAC;AAEnD,SAAgB,4BAA4B,CAC1C,OAAqC;IAErC,MAAM,eAAe,GAAyC;QAC5D,GAAG,8CAAuB;QAC1B,YAAY,EAAE,MAAM;QACpB,GAAG,OAAO;KACX,CAAC;IACF,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,eAAe,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,gBAAgB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,GAAG,iBAAiB;QACpB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,qBAAqB,EAAE,eAAe,CAAC,qBAAqB;QAC5D,WAAW,EAAE,IAAA,qCAAc,EAAC,eAAe,EAAE,MAAM,CAAC;QACpD,OAAO,EAAE,IAAA,iCAAU,EAAC,eAAe,CAAC,OAAO,CAAC;QAC5C,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE;YACL,OAAO,EAAE,eAAe,CAAC,MAAM;gBAC7B,CAAC,CAAC,kBAAkB,eAAe,CAAC,MAAM,SAAS;gBACnD,CAAC,CAAC,SAAS;YACb,GAAG,EAAE,eAAe,CAAC,cAAc;YACnC,iBAAiB,EAAE,KAAK;YACxB,uBAAuB,EAAE,IAAI;YAC7B,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,IAAI;YACf,GAAG,CAAC,eAAe,CAAC,OAAO;gBACzB,CAAC,CAAC,EAAE,gBAAgB,EAAE,eAAe,CAAC,OAAO,EAAE;gBAC/C,CAAC,CAAC,EAAE,CAAC;YACP,aAAa,EAAE,eAAe,CAAC,YAAY;SAC5C;KACF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAGC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,KAAK;YAChB,CAAC,CAAC,+BAA+B,CAAC,WAAW,CAAC;YAC9C,CAAC,CAAC,WAAW;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QAC/B,kBAAkB,EAAE,IAAI;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CAAC,WAAmB;IAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC;QAC3E,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/typeorm/config/typeorm-options.factory.d.ts

@@ -0,0 +1,9 @@
+import type { TypeOrmModuleOptions } from '@nestjs/typeorm';
+import { MysqlTypeormConfigOptions } from './mysql-typeorm-options.factory';
+import { PostgresTypeormConfigOptions } from './postgres-typeorm-options.factory';
+export type TypeOrmConfigOptions = (PostgresTypeormConfigOptions & {
+    type: 'postgres';
+}) | (MysqlTypeormConfigOptions & {
+    type: 'mysql';
+});
+export declare function createTypeOrmOptions(options: TypeOrmConfigOptions): TypeOrmModuleOptions;

package/dist/typeorm/config/typeorm-options.factory.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTypeOrmOptions = createTypeOrmOptions;
+const mysql_typeorm_options_factory_1 = require("./mysql-typeorm-options.factory");
+const postgres_typeorm_options_factory_1 = require("./postgres-typeorm-options.factory");
+function createTypeOrmOptions(options) {
+    switch (options.type) {
+        case 'postgres':
+            return (0, postgres_typeorm_options_factory_1.createPostgresTypeormOptions)(options);
+        case 'mysql':
+            return (0, mysql_typeorm_options_factory_1.createMysqlTypeormOptions)(options);
+    }
+}
+//# sourceMappingURL=typeorm-options.factory.js.map

package/dist/typeorm/config/typeorm-options.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-options.factory.js","sourceRoot":"","sources":["../../../src/typeorm/config/typeorm-options.factory.ts"],"names":[],"mappings":";;AAcA,oDASC;AAtBD,mFAGyC;AACzC,yFAG4C;AAM5C,SAAgB,oBAAoB,CAClC,OAA6B;IAE7B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,IAAA,+DAA4B,EAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,OAAO;YACV,OAAO,IAAA,yDAAyB,EAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/typeorm/config/typeorm-options.util.d.ts

@@ -0,0 +1,13 @@
+import { Logger } from '@nestjs/common';
+export interface CommonTypeormConfigOptions {
+    databaseUrl: string;
+    sync?: boolean | string;
+    logging?: boolean | string;
+    isProduction: boolean;
+    maxConnections?: number;
+    maxQueryExecutionTime?: number;
+}
+export type ResolvedCommonTypeormConfigOptions = Required<CommonTypeormConfigOptions>;
+export declare const TYPEORM_CONFIG_DEFAULTS: Pick<ResolvedCommonTypeormConfigOptions, 'sync' | 'logging' | 'maxConnections' | 'maxQueryExecutionTime'>;
+export declare function useSynchronize(options: Pick<ResolvedCommonTypeormConfigOptions, 'isProduction' | 'sync'>, logger: Logger): boolean;
+export declare function useLogging(logging: boolean | string): boolean;

package/dist/typeorm/config/typeorm-options.util.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TYPEORM_CONFIG_DEFAULTS = void 0;
+exports.useSynchronize = useSynchronize;
+exports.useLogging = useLogging;
+exports.TYPEORM_CONFIG_DEFAULTS = {
+    sync: false,
+    logging: false,
+    maxConnections: 20,
+    maxQueryExecutionTime: 500,
+};
+function useSynchronize(options, logger) {
+    const doSync = coerceBoolean(options.sync);
+    if (options.isProduction && doSync) {
+        logger.warn("Your sync is on! But due security reasons it's not allowed to perform in production!");
+        return false;
+    }
+    return doSync;
+}
+function useLogging(logging) {
+    return coerceBoolean(logging);
+}
+function coerceBoolean(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    return !!Number(value);
+}
+//# sourceMappingURL=typeorm-options.util.js.map

package/dist/typeorm/config/typeorm-options.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-options.util.js","sourceRoot":"","sources":["../../../src/typeorm/config/typeorm-options.util.ts"],"names":[],"mappings":";;;AAwBA,wCAeC;AAED,gCAEC;AA7BY,QAAA,uBAAuB,GAGhC;IACF,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,EAAE;IAClB,qBAAqB,EAAE,GAAG;CAC3B,CAAC;AAEF,SAAgB,cAAc,CAC5B,OAA0E,EAC1E,MAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CACT,sFAAsF,CACvF,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,UAAU,CAAC,OAAyB;IAClD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,KAAuB;IAC5C,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/typeorm/index.d.ts

@@ -3,3 +3,4 @@ export * from './errors';
 export * from './transformers';
 export * from './types';
 export * from './utils';
+export * from './config';

package/dist/typeorm/index.js

@@ -19,4 +19,5 @@ __exportStar(require("./errors"), exports);
 __exportStar(require("./transformers"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./config"), exports);
 //# sourceMappingURL=index.js.map

package/dist/typeorm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typeorm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typeorm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB"}

package/dist/validators/entity/entity.decorator.d.ts

@@ -1,3 +1,8 @@
 import { ValidationOptions } from 'class-validator';
 import { EntityValidationOptions } from './entity.interface';
+/**
+ * @deprecated Entity existence checks are not the responsibility of DTO
+ * validation. This validator leaks persistence/service concerns into DTOs; keep
+ * that logic in the service/application layer instead.
+ */
 export declare function IsEntity(entityType: Function, options?: EntityValidationOptions & ValidationOptions): (object: any, propertyName: string) => void;

package/dist/validators/entity/entity.decorator.js

@@ -4,6 +4,11 @@ exports.IsEntity = IsEntity;
 const class_validator_1 = require("class-validator");
 const entity_constant_1 = require("./entity.constant");
 const entity_constraint_1 = require("./entity.constraint");
+/**
+ * @deprecated Entity existence checks are not the responsibility of DTO
+ * validation. This validator leaks persistence/service concerns into DTOs; keep
+ * that logic in the service/application layer instead.
+ */
 function IsEntity(entityType, options) {
     const { isUuid, each, property, ...validationOptions } = options || {};
     return function (object, propertyName) {

package/dist/validators/entity/entity.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.decorator.js","sourceRoot":"","sources":["../../../src/validators/entity/entity.decorator.ts"],"names":[],"mappings":";;AAKA,4BAgBC;AArBD,qDAAuE;AAEvE,uDAA8C;AAC9C,2DAAuD;AAEvD,SAAgB,QAAQ,CACtB,UAAoB,EACpB,OAAqD;IAErD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEvE,OAAO,UAAU,MAAW,EAAE,YAAoB;QAChD,IAAA,mCAAiB,EAAC;YAChB,IAAI,EAAE,2BAAS;YACf,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY;YACZ,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACrD,SAAS,EAAE,oCAAgB;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"entity.decorator.js","sourceRoot":"","sources":["../../../src/validators/entity/entity.decorator.ts"],"names":[],"mappings":";;AAUA,4BAgBC;AA1BD,qDAAuE;AAEvE,uDAA8C;AAC9C,2DAAuD;AAEvD;;;;GAIG;AACH,SAAgB,QAAQ,CACtB,UAAoB,EACpB,OAAqD;IAErD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEvE,OAAO,UAAU,MAAW,EAAE,YAAoB;QAChD,IAAA,mCAAiB,EAAC;YAChB,IAAI,EAAE,2BAAS;YACf,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY;YACZ,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACrD,SAAS,EAAE,oCAAgB;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@russ-b/nestjs-common-tools",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "NestJS utility tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -109,6 +109,7 @@
     "@aws-sdk/s3-request-presigner": "^3.1019.0",
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/config": "^3.0.0 || ^4.0.0",
+    "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
     "nest-winston": "^1.10.2",
     "typeorm": "^0.3.20",
     "winston": "^3.17.0",
@@ -119,6 +120,7 @@
     "@eslint/eslintrc": "^3.2.0",
     "@eslint/js": "^9.18.0",
     "@nestjs/testing": "^11.0.7",
+    "@nestjs/typeorm": "^11.0.0",
     "@types/express": "^5.0.0",
     "@types/jest": "^29.5.14",
     "eslint": "^9.18.0",