@russ-b/nestjs-common-tools 1.13.1 → 1.14.1

package/README.md

@@ -1,5 +1,4 @@
 # nestjs-common-tools
-NestJS Common Tools
 
 A small toolbox for NestJS with helpers that often come up in day-to-day development.
 
@@ -15,6 +14,239 @@ 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.
 
+## Public entrypoints
+
+This package uses subpath exports for most features.
+
+| Import path | What it contains |
+|-------------|------------------|
+| `@russ-b/nestjs-common-tools` | root exports such as `services` |
+| `@russ-b/nestjs-common-tools/class-transformer` | reusable `class-transformer` decorators and helpers |
+| `@russ-b/nestjs-common-tools/modules` | NestJS modules such as `S3Module` |
+| `@russ-b/nestjs-common-tools/validators` | validation decorators and constraints |
+| `@russ-b/nestjs-common-tools/typeorm` | TypeORM filters, helpers, transformers, and types |
+| `@russ-b/nestjs-common-tools/logger` | logger builder and logger-related interfaces/types |
+| `@russ-b/nestjs-common-tools/common/util` | generic utility helpers |
+| `@russ-b/nestjs-common-tools/common/pagination` | pagination DTOs and helpers |
+| `@russ-b/nestjs-common-tools/common/filters` | shared filter exports |
+
+## Class Transformer Helpers
+
+This package also exposes small reusable decorators for `class-transformer`.
+
+### `ToStringArray`
+
+`ToStringArray()` is useful for DTO query fields that may arrive as a comma-separated string such as `"cars, bikes, boats"` or as an array.
+
+```typescript
+import { ToStringArray } from '@russ-b/nestjs-common-tools/class-transformer';
+
+export class SearchDto {
+  @ToStringArray()
+  tags?: string[];
+}
+```
+
+It will:
+
+- split string values by comma
+- trim extra spaces around items
+- remove empty values
+- normalize a string like `'cars, bikes, boats'` into `['cars', 'bikes', 'boats']`
+
+### `ToBooleanFromString`
+
+`ToBooleanFromString()` is useful for DTO fields that may arrive as `'true'` or `'false'` strings and should become real booleans.
+
+```typescript
+import { ToBooleanFromString } from '@russ-b/nestjs-common-tools/class-transformer';
+
+export class SearchDto {
+  @ToBooleanFromString()
+  archived?: boolean;
+}
+```
+
+It will:
+
+- convert `'true'` to `true`
+- convert `'false'` to `false`
+- trim extra spaces and ignore case
+- leave unsupported values unchanged
+
+## 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.
+
+### Install S3 peer dependencies
+
+If you want to use the S3 module, install the required AWS peer dependencies in your application:
+
+```bash
+npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner
+```
+
+### Register the module
+
+Import the module from `@russ-b/nestjs-common-tools/modules` and configure it with `forRootAsync`.
+
+```typescript
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { S3Module } from '@russ-b/nestjs-common-tools/modules';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+    }),
+    S3Module.forRootAsync({
+      global: true,
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: (config: ConfigService) => ({
+        region: config.get<string>('AWS_REGION') ?? 'eu-central-1',
+        bucket: config.get<string>('S3_BUCKET'),
+        endpoint: config.get<string>('S3_ENDPOINT'),
+        logger: config.get<string>('S3_DEBUG') === 'true',
+      }),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### Credentials
+
+The module does not accept `accessKeyId` or `secretAccessKey` directly. It relies on the AWS SDK default credential chain instead, which means credentials can come from:
+
+- `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY`
+- local AWS profiles and shared config
+- IAM roles in AWS environments
+
+Example environment variables:
+
+```env
+AWS_REGION=eu-central-1
+AWS_ACCESS_KEY_ID=your-access-key
+AWS_SECRET_ACCESS_KEY=your-secret-key
+S3_BUCKET=my-app-bucket
+```
+
+The AWS SDK reads values from process environment, not directly from a `.env` file, so make sure your application loads those variables before creating the client.
+
+`endpoint` is optional and is mostly useful for S3-compatible providers such as MinIO or LocalStack.
+
+`forcePathStyle` defaults to `true` in this module. That is usually convenient for MinIO and LocalStack. If you want standard AWS virtual-hosted URLs, set `forcePathStyle: false`.
+
+### Optional logging
+
+By default, the module stays silent and does not write S3 operation logs.
+
+If you want extra visibility while testing connectivity with S3 or MinIO, set `logger: true` in the module options. That enables the standard Nest logger for this service.
+
+```typescript
+S3Module.forRootAsync({
+  useFactory: () => ({
+    bucket: 'my-app-bucket',
+    endpoint: 'http://localhost:9000',
+    forcePathStyle: true,
+    logger: true,
+  }),
+});
+```
+
+You can also pass your own Nest-compatible logger object if you want to redirect those logs elsewhere.
+
+### Inject and use the service
+
+```typescript
+// files.service.ts
+import { Injectable } from '@nestjs/common';
+import { Readable } from 'stream';
+import { S3Service } from '@russ-b/nestjs-common-tools/modules';
+
+@Injectable()
+export class FilesService {
+  constructor(private readonly s3Service: S3Service) {}
+
+  async putAvatar(key: string, file: Buffer) {
+    return this.s3Service.putObject(key, file, {
+      contentType: 'image/png',
+      cacheControl: 'public, max-age=31536000, immutable',
+      metadata: {
+        source: 'avatar-service',
+      },
+    });
+  }
+
+  async uploadLargeFile(key: string, stream: Readable) {
+    return this.s3Service.upload(key, stream, {
+      contentType: 'application/pdf',
+      metadata: {
+        source: 'document-service',
+      },
+    });
+  }
+
+  async getAvatar(key: string) {
+    const object = await this.s3Service.getObject(key);
+
+    return {
+      stream: object.body,
+      contentType: object.contentType,
+      cacheControl: object.cacheControl,
+      metadata: object.metadata,
+    };
+  }
+
+  async deleteAvatar(key: string) {
+    return this.s3Service.deleteObject(key);
+  }
+}
+```
+
+### Signed URLs
+
+Use `getSignedUrl` when the client should upload or download directly from S3.
+
+```typescript
+// files.service.ts
+async getAvatarUploadUrl(key: string) {
+  return this.s3Service.getSignedUrl(key, {
+    operation: 'putObject',
+    expiresIn: 300,
+    contentType: 'image/png',
+    cacheControl: 'public, max-age=31536000, immutable',
+    metadata: {
+      source: 'avatar-upload',
+    },
+  });
+}
+
+async getAvatarDownloadUrl(key: string) {
+  return this.s3Service.getSignedUrl(key, {
+    operation: 'getObject',
+    expiresIn: 300,
+  });
+}
+```
+
+When generating a signed `putObject` URL, make sure the client sends the same headers you used during signing, especially `Content-Type` and any custom metadata headers.
+
+### Available methods
+
+| Method | Description |
+|--------|-------------|
+| `putObject(key, body, options)` | Simple upload using `PutObjectCommand` |
+| `upload(key, body, options)` | Managed upload using `@aws-sdk/lib-storage`, useful for larger or streaming payloads |
+| `getObject(key, options)` | Returns the readable stream together with object metadata |
+| `deleteObject(key, options)` | Deletes an object from the configured bucket |
+| `getSignedUrl(key, options)` | Creates a presigned URL for `getObject` or `putObject` |
+
+`uploadObject` is still available as a compatibility alias, but `putObject` is the preferred method name going forward.
+
 ## Entity Validator
 
 A custom validator for NestJS that validates if an entity exists in the database using TypeORM.
@@ -25,7 +257,9 @@ A custom validator for NestJS that validates if an entity exists in the database
 
 ```typescript
 // main.ts
+import { NestFactory } from '@nestjs/core';
 import { useContainer } from 'class-validator';
+import { AppModule } from './app.module';
 
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
@@ -43,7 +277,6 @@ async function bootstrap() {
 ```typescript
 // app.module.ts
 import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
 import { EntityConstraint } from '@russ-b/nestjs-common-tools/validators';
 
 @Module({

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

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

package/dist/class-transformer/index.js

@@ -0,0 +1,19 @@
+"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("./to-string-array.decorator"), exports);
+__exportStar(require("./to-boolean-from-string.decorator"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

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

package/dist/class-transformer/to-boolean-from-string.decorator.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBooleanFromStringTransformer = void 0;
+exports.ToBooleanFromString = ToBooleanFromString;
+const class_transformer_1 = require("class-transformer");
+function ToBooleanFromString() {
+    return (0, class_transformer_1.Transform)(exports.parseBooleanFromStringTransformer);
+}
+const parseBooleanFromStringTransformer = ({ value, }) => normalizeBooleanFromString(value);
+exports.parseBooleanFromStringTransformer = parseBooleanFromStringTransformer;
+function normalizeBooleanFromString(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const normalizedValue = value.trim().toLowerCase();
+        if (normalizedValue === 'true') {
+            return true;
+        }
+        if (normalizedValue === 'false') {
+            return false;
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=to-boolean-from-string.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to-boolean-from-string.decorator.js","sourceRoot":"","sources":["../../src/class-transformer/to-boolean-from-string.decorator.ts"],"names":[],"mappings":";;;AAEA,kDAEC;AAJD,yDAAiE;AAEjE,SAAgB,mBAAmB;IACjC,OAAO,IAAA,6BAAS,EAAC,yCAAiC,CAAC,CAAC;AACtD,CAAC;AAEM,MAAM,iCAAiC,GAAG,CAAC,EAChD,KAAK,GACa,EAAW,EAAE,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC;AAFvD,QAAA,iCAAiC,qCAEsB;AAEpE,SAAS,0BAA0B,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEnD,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1 @@
+export declare function ToStringArray(): PropertyDecorator;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToStringArray = ToStringArray;
+const class_transformer_1 = require("class-transformer");
+function ToStringArray() {
+    return (0, class_transformer_1.Transform)(({ value }) => normalizeToStringArray(value));
+}
+function normalizeToStringArray(value) {
+    if (typeof value === 'string') {
+        return splitAndTrim(value);
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => typeof item === 'string' ? splitAndTrim(item) : []);
+    }
+    return value;
+}
+function splitAndTrim(value) {
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=to-string-array.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to-string-array.decorator.js","sourceRoot":"","sources":["../../src/class-transformer/to-string-array.decorator.ts"],"names":[],"mappings":";;AAEA,sCAEC;AAJD,yDAAiE;AAEjE,SAAgB,aAAa;IAC3B,OAAO,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAqB,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5B,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CACnD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

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

@@ -1,2 +1,3 @@
 export * from './s3.module';
 export * from './s3.service';
+export * from './s3.interface';

package/dist/modules/s3/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./s3.module"), exports);
 __exportStar(require("./s3.service"), exports);
+__exportStar(require("./s3.interface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/modules/s3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/s3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/s3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B"}

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

@@ -1,19 +1,44 @@
-import { ModuleMetadata } from '@nestjs/common';
-import { ObjectCannedACL } from '@aws-sdk/client-s3';
+import type { LoggerService, ModuleMetadata } from '@nestjs/common';
+import type { DeleteObjectCommandOutput, GetObjectCommandOutput, ObjectCannedACL, PutObjectCommandInput, PutObjectCommandOutput } from '@aws-sdk/client-s3';
+import type { CompleteMultipartUploadCommandOutput } from '@aws-sdk/client-s3';
+import type { Readable } from 'stream';
+export type S3ModuleLogger = Pick<LoggerService, 'log' | 'error'>;
 export interface S3ModuleOptions {
     region?: string;
-    endpoint: string;
-    accessKeyId: string;
-    secretAccessKey: string;
+    endpoint?: string;
     forcePathStyle?: boolean;
     bucket?: string;
+    logger?: boolean | S3ModuleLogger;
 }
 export interface S3ModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     useFactory: (...args: any[]) => Promise<S3ModuleOptions> | S3ModuleOptions;
     global?: boolean;
     inject?: any[];
 }
-export interface UploadParams {
+export interface S3ObjectOptions {
     bucket?: string;
+}
+export interface S3UploadOptions extends S3ObjectOptions {
     acl?: ObjectCannedACL;
+    cacheControl?: PutObjectCommandInput['CacheControl'];
+    contentType?: NonNullable<PutObjectCommandInput['ContentType']>;
+    metadata?: PutObjectCommandInput['Metadata'];
+}
+export interface S3SignedUrlOptions extends S3UploadOptions {
+    expiresIn?: number;
+    operation?: 'getObject' | 'putObject';
+}
+export interface S3GetObjectResult {
+    body: Readable;
+    cacheControl?: GetObjectCommandOutput['CacheControl'];
+    contentLength?: GetObjectCommandOutput['ContentLength'];
+    contentType?: GetObjectCommandOutput['ContentType'];
+    eTag?: GetObjectCommandOutput['ETag'];
+    lastModified?: GetObjectCommandOutput['LastModified'];
+    metadata?: GetObjectCommandOutput['Metadata'];
 }
+export type S3UploadResult = CompleteMultipartUploadCommandOutput;
+export type S3PutObjectResult = PutObjectCommandOutput;
+export type S3DeleteObjectResult = DeleteObjectCommandOutput;
+export type S3Body = NonNullable<PutObjectCommandInput['Body']>;
+export type UploadParams = S3UploadOptions;

package/dist/modules/s3/s3.module.js

@@ -9,9 +9,9 @@ var S3Module_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.S3Module = void 0;
 const common_1 = require("@nestjs/common");
-const s3_service_1 = require("./s3.service");
-const s3_constants_1 = require("./s3.constants");
 const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_constants_1 = require("./s3.constants");
+const s3_service_1 = require("./s3.service");
 let S3Module = S3Module_1 = class S3Module {
     static forRootAsync(options) {
         return {
@@ -28,15 +28,12 @@ let S3Module = S3Module_1 = class S3Module {
                     provide: s3_constants_1.S3_CLIENT,
                     inject: [s3_constants_1.S3_MODULE_OPTIONS],
                     useFactory: (opts) => {
-                        return new client_s3_1.S3Client({
+                        const clientConfig = {
                             region: opts.region || 'us-east-1',
                             endpoint: opts.endpoint,
-                            credentials: {
-                                accessKeyId: opts.accessKeyId,
-                                secretAccessKey: opts.secretAccessKey,
-                            },
                             forcePathStyle: opts.forcePathStyle ?? true,
-                        });
+                        };
+                        return new client_s3_1.S3Client(clientConfig);
                     },
                 },
                 s3_service_1.S3Service,

package/dist/modules/s3/s3.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3.module.js","sourceRoot":"","sources":["../../../src/modules/s3/s3.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,6CAAyC;AACzC,iDAA8D;AAC9D,kDAA8C;AAIvC,IAAM,QAAQ,gBAAd,MAAM,QAAQ;IACnB,MAAM,CAAC,YAAY,CAAC,OAA6B;QAC/C,OAAO;YACL,MAAM,EAAE,UAAQ;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,gCAAiB;oBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;iBAC7B;gBACD;oBACE,OAAO,EAAE,wBAAS;oBAClB,MAAM,EAAE,CAAC,gCAAiB,CAAC;oBAC3B,UAAU,EAAE,CAAC,IAAqB,EAAE,EAAE;wBACpC,OAAO,IAAI,oBAAQ,CAAC;4BAClB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW;4BAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;4BACvB,WAAW,EAAE;gCACX,WAAW,EAAE,IAAI,CAAC,WAAW;gCAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;6BACtC;4BACD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;yBAC5C,CAAC,CAAC;oBACL,CAAC;iBACF;gBACD,sBAAS;aACV;YACD,OAAO,EAAE,CAAC,sBAAS,CAAC;SACrB,CAAC;IACJ,CAAC;CACF,CAAA;AAhCY,4BAAQ;mBAAR,QAAQ;IADpB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,QAAQ,CAgCpB"}
+{"version":3,"file":"s3.module.js","sourceRoot":"","sources":["../../../src/modules/s3/s3.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,kDAA8D;AAE9D,iDAA8D;AAC9D,6CAAyC;AAGlC,IAAM,QAAQ,gBAAd,MAAM,QAAQ;IACnB,MAAM,CAAC,YAAY,CAAC,OAA6B;QAC/C,OAAO;YACL,MAAM,EAAE,UAAQ;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,gCAAiB;oBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;iBAC7B;gBACD;oBACE,OAAO,EAAE,wBAAS;oBAClB,MAAM,EAAE,CAAC,gCAAiB,CAAC;oBAC3B,UAAU,EAAE,CAAC,IAAqB,EAAE,EAAE;wBACpC,MAAM,YAAY,GAAmB;4BACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW;4BAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;4BACvB,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;yBAC5C,CAAC;wBAEF,OAAO,IAAI,oBAAQ,CAAC,YAAY,CAAC,CAAC;oBACpC,CAAC;iBACF;gBACD,sBAAS;aACV;YACD,OAAO,EAAE,CAAC,sBAAS,CAAC;SACrB,CAAC;IACJ,CAAC;CACF,CAAA;AA9BY,4BAAQ;mBAAR,QAAQ;IADpB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,QAAQ,CA8BpB"}

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

@@ -1,15 +1,18 @@
 import { S3Client } from '@aws-sdk/client-s3';
-import { Readable } from 'stream';
-import { StreamingBlobPayloadInputTypes } from '@smithy/types/dist-types/streaming-payload/streaming-blob-payload-input-types';
-import { UploadParams } from './s3.interface';
+import { S3Body, S3DeleteObjectResult, S3GetObjectResult, S3ModuleOptions, S3ObjectOptions, S3PutObjectResult, S3SignedUrlOptions, S3UploadOptions, S3UploadResult } from './s3.interface';
 export declare class S3Service {
     private readonly options;
     private readonly s3Client;
-    private readonly logger;
-    private readonly bucket;
-    constructor(options: Record<string, string>, s3Client: S3Client);
-    upload(key: string, body: StreamingBlobPayloadInputTypes, contentType?: string, params?: UploadParams): Promise<void>;
-    uploadObject(key: string, body: StreamingBlobPayloadInputTypes, contentType?: string, params?: UploadParams): Promise<void>;
-    deleteObject(key: string, bucket?: string): Promise<void>;
-    getObject(key: string, bucket?: string): Promise<Readable>;
+    private readonly logger?;
+    constructor(options: S3ModuleOptions, s3Client: S3Client);
+    upload(key: string, body: S3Body, options?: S3UploadOptions): Promise<S3UploadResult>;
+    putObject(key: string, body: S3Body, options?: S3UploadOptions): Promise<S3PutObjectResult>;
+    uploadObject(key: string, body: S3Body, options?: S3UploadOptions): Promise<S3PutObjectResult>;
+    deleteObject(key: string, options?: S3ObjectOptions): Promise<S3DeleteObjectResult>;
+    getObject(key: string, options?: S3ObjectOptions): Promise<S3GetObjectResult>;
+    getSignedUrl(key: string, options?: S3SignedUrlOptions): Promise<string>;
+    private createPutObjectParams;
+    private resolveBucket;
+    private log;
+    private logError;
 }

package/dist/modules/s3/s3.service.js

@@ -11,81 +11,137 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
+var S3Service_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.S3Service = void 0;
 const common_1 = require("@nestjs/common");
 const client_s3_1 = require("@aws-sdk/client-s3");
-const s3_constants_1 = require("./s3.constants");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+const stream_1 = require("stream");
 const lib_storage_1 = require("@aws-sdk/lib-storage");
-let S3Service = class S3Service {
+const s3_constants_1 = require("./s3.constants");
+let S3Service = S3Service_1 = class S3Service {
     constructor(options, s3Client) {
         this.options = options;
         this.s3Client = s3Client;
-        this.logger = new common_1.Logger(this.constructor.name);
-        this.bucket = this.options.bucket;
+        this.logger =
+            options.logger === true ? new common_1.Logger(S3Service_1.name) : options.logger || undefined;
     }
-    async upload(key, body, contentType = 'application/octet-stream', params) {
+    async upload(key, body, options) {
         const upload = new lib_storage_1.Upload({
             client: this.s3Client,
-            params: {
-                Bucket: params?.bucket || this.bucket,
-                Key: key,
-                Body: body,
-                ContentType: contentType,
-                ACL: params?.acl || 'public-read',
-            },
+            params: this.createPutObjectParams(key, body, options, true),
         });
-        await upload.done();
+        const response = await upload.done();
+        this.log(`Uploaded object with multipart upload: ${key}`);
+        return response;
     }
-    async uploadObject(key, body, contentType = 'application/octet-stream', params) {
-        const command = new client_s3_1.PutObjectCommand({
-            Bucket: params?.bucket || this.bucket,
-            Key: key,
-            Body: body,
-            ContentType: contentType,
-            ACL: params?.acl || 'public-read',
-        });
+    async putObject(key, body, options) {
+        const command = new client_s3_1.PutObjectCommand(this.createPutObjectParams(key, body, options, true));
         try {
-            await this.s3Client.send(command);
-            this.logger.log(`Uploaded object: ${key}`);
+            const response = await this.s3Client.send(command);
+            this.log(`Uploaded object: ${key}`);
+            return response;
         }
         catch (error) {
-            this.logger.error(`Failed to upload object: ${key}`, error);
+            this.logError(`Failed to upload object: ${key}`, error);
             throw error;
         }
     }
-    async deleteObject(key, bucket) {
+    async uploadObject(key, body, options) {
+        return this.putObject(key, body, options);
+    }
+    async deleteObject(key, options) {
         const command = new client_s3_1.DeleteObjectCommand({
-            Bucket: bucket || this.bucket,
+            Bucket: this.resolveBucket(options?.bucket),
             Key: key,
         });
         try {
-            await this.s3Client.send(command);
-            this.logger.log(`Deleted object: ${key}`);
+            const response = await this.s3Client.send(command);
+            this.log(`Deleted object: ${key}`);
+            return response;
         }
         catch (error) {
-            this.logger.error(`Failed to delete object: ${key}`, error);
+            this.logError(`Failed to delete object: ${key}`, error);
             throw error;
         }
     }
-    async getObject(key, bucket) {
+    async getObject(key, options) {
         const command = new client_s3_1.GetObjectCommand({
-            Bucket: bucket || this.bucket,
+            Bucket: this.resolveBucket(options?.bucket),
             Key: key,
         });
         try {
             const response = await this.s3Client.send(command);
-            this.logger.log(`Fetched object: ${key}`);
-            return response.Body;
+            this.log(`Fetched object: ${key}`);
+            if (!response.Body) {
+                throw new Error(`S3 object "${key}" returned an empty body.`);
+            }
+            if (!(response.Body instanceof stream_1.Readable)) {
+                throw new Error(`S3 object "${key}" did not return a Node.js readable stream.`);
+            }
+            return {
+                body: response.Body,
+                cacheControl: response.CacheControl,
+                contentLength: response.ContentLength,
+                contentType: response.ContentType,
+                eTag: response.ETag,
+                lastModified: response.LastModified,
+                metadata: response.Metadata,
+            };
         }
         catch (error) {
-            this.logger.error(`Failed to get object: ${key}`, error);
+            this.logError(`Failed to get object: ${key}`, error);
             throw error;
         }
     }
+    async getSignedUrl(key, options) {
+        const expiresIn = options?.expiresIn ?? 900;
+        const operation = options?.operation ?? 'getObject';
+        const command = operation === 'putObject'
+            ? new client_s3_1.PutObjectCommand(this.createPutObjectParams(key, undefined, options))
+            : new client_s3_1.GetObjectCommand({
+                Bucket: this.resolveBucket(options?.bucket),
+                Key: key,
+            });
+        return (0, s3_request_presigner_1.getSignedUrl)(this.s3Client, command, { expiresIn });
+    }
+    createPutObjectParams(key, body, options, useDefaultContentType = false) {
+        const contentType = options?.contentType ??
+            (useDefaultContentType ? 'application/octet-stream' : undefined);
+        return {
+            Bucket: this.resolveBucket(options?.bucket),
+            Key: key,
+            ...(body !== undefined ? { Body: body } : {}),
+            ...(contentType ? { ContentType: contentType } : {}),
+            ...(options?.acl ? { ACL: options.acl } : {}),
+            ...(options?.cacheControl ? { CacheControl: options.cacheControl } : {}),
+            ...(options?.metadata ? { Metadata: options.metadata } : {}),
+        };
+    }
+    resolveBucket(bucket) {
+        const resolvedBucket = bucket ?? this.options.bucket;
+        if (!resolvedBucket) {
+            throw new Error('S3 bucket is not configured. Pass a bucket to the method call or set S3ModuleOptions.bucket.');
+        }
+        return resolvedBucket;
+    }
+    log(message) {
+        this.logger?.log(message);
+    }
+    logError(message, error) {
+        if (!this.logger) {
+            return;
+        }
+        if (error instanceof Error) {
+            this.logger.error(message, error.stack ?? error.message);
+            return;
+        }
+        this.logger.error(message, error);
+    }
 };
 exports.S3Service = S3Service;
-exports.S3Service = S3Service = __decorate([
+exports.S3Service = S3Service = S3Service_1 = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(s3_constants_1.S3_MODULE_OPTIONS)),
     __param(1, (0, common_1.Inject)(s3_constants_1.S3_CLIENT)),

package/dist/modules/s3/s3.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3.service.js","sourceRoot":"","sources":["../../../src/modules/s3/s3.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"s3.service.js","sourceRoot":"","sources":["../../../src/modules/s3/s3.service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@russ-b/nestjs-common-tools",
-  "version": "1.13.1",
+  "version": "1.14.1",
   "description": "NestJS utility tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,6 +47,10 @@
       "types": "./dist/common/filters/index.d.ts",
       "default": "./dist/common/filters/index.js"
     },
+    "./class-transformer": {
+      "types": "./dist/class-transformer/index.d.ts",
+      "default": "./dist/class-transformer/index.js"
+    },
     "./validators": {
       "types": "./dist/validators/index.d.ts",
       "default": "./dist/validators/index.js"
@@ -82,6 +86,9 @@
       "common/filters": [
         "dist/common/filters/index.d.ts"
       ],
+      "class-transformer": [
+        "dist/class-transformer/index.d.ts"
+      ],
       "modules": [
         "dist/modules/index.d.ts"
       ],
@@ -99,6 +106,7 @@
   "peerDependencies": {
     "@aws-sdk/client-s3": "^3.0.0",
     "@aws-sdk/lib-storage": "^3.0.0",
+    "@aws-sdk/s3-request-presigner": "^3.1019.0",
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/config": "^3.0.0 || ^4.0.0",
     "nest-winston": "^1.10.2",