@rsdk/s3 4.2.0-next.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [4.2.0-next.0](https://github.com/R-Vision/rsdk/compare/v4.1.0...v4.2.0-next.0) (2024-02-02)
+
+### Features
+
+* **s3:** added @rsdk/s3 package ([03bd9ea](https://github.com/R-Vision/rsdk/commit/03bd9ea7e5f78be6c93b1a2547fe7c2639ca0146))

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+export * from './s3.client';
+export * from './types';

package/dist/client/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("./s3.client"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}

package/dist/client/s3.client.d.ts

@@ -0,0 +1,89 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { Timespan } from '@rsdk/common';
+import { Readable } from 'node:stream';
+import type { File, ObjectInfo, S3ClientOptions, UploadOptions } from './types';
+/**
+ * Object storage client
+ */
+export declare class S3Client {
+    readonly storageName: string;
+    readonly bucket: string;
+    private readonly s3;
+    private readonly defaultTTL;
+    private readonly logger;
+    constructor({ url, defaultTTL, bucket, storageName, logger, }: S3ClientOptions);
+    /**
+     * Throws error if server is not responding
+     * or bucket doesn't exist
+     */
+    checkBucket(): Promise<void>;
+    /**
+     * Returns true if bucket is reachable
+     * @returns Promise<boolean>
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * Creates temporary download link for object
+     * @param key Object key
+     * @param ttl Time too live for the presigned url (defaults to 48h)
+     * @returns Promise<string>
+     */
+    getPresignedUrl(key: string, ttl?: Timespan): Promise<string>;
+    /**
+     * Get object metadata
+     * @param key Key to save object to
+     * @returns Promise<ObjectInfo>
+     */
+    getObjectInfo(key: string): Promise<ObjectInfo>;
+    /**
+     * Retrieves object from storage
+     * @param key string
+     * @returns Promise<File>
+     */
+    getObject(key: string): Promise<File>;
+    /**
+     * Get object stream from storage
+     * @param key Object key
+     * @returns Promise<Readable>
+     */
+    getObjectStream(key: string): Promise<Readable>;
+    /**
+     * Upload object to storage
+     * @param key Object key
+     * @param content Buffer
+     * @param options UploadOptions
+     */
+    addObject(key: string, content: Buffer | Readable, options?: UploadOptions): Promise<void>;
+    /**
+     * Removes object by key
+     * @param key Object key
+     */
+    removeObject(key: string): Promise<void>;
+    /**
+     * Tries to determine content type by file name
+     * @param filename filename
+     * @returns string
+     */
+    private tryGetContentType;
+    /**
+     * Parses metadata from S3 response
+     * @param key Object key
+     * @param response Object storage response
+     * @returns
+     */
+    private parseMetadata;
+    /**
+     * S3 storage can reply with different kinds of body
+     * @param key Object key
+     * @param response Object storage response
+     * @returns
+     */
+    private parseBody;
+    /**
+     * Create short hash of object key if there is no filename
+     * @param key Object key
+     * @returns string
+     */
+    private hashKey;
+}

package/dist/client/s3.client.js

@@ -0,0 +1,216 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Client = void 0;
+const common_1 = require("@rsdk/common");
+const common_node_1 = require("@rsdk/common.node");
+const aws_sdk_1 = require("aws-sdk");
+const mime_types_1 = __importDefault(require("mime-types"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_crypto_1 = require("node:crypto");
+const node_stream_1 = require("node:stream");
+const DEFAULT_CONTENT_TYPE = 'application/octet-stream';
+/**
+ * Object storage client
+ */
+class S3Client {
+    storageName;
+    bucket;
+    s3;
+    defaultTTL;
+    logger;
+    constructor({ url, defaultTTL, bucket, storageName, logger, }) {
+        this.s3 = new aws_sdk_1.S3({
+            accessKeyId: url.username,
+            secretAccessKey: url.password,
+            endpoint: `${url.protocol}//${url.host}${url.pathname}`,
+            s3ForcePathStyle: true,
+        });
+        this.bucket = bucket;
+        this.defaultTTL = defaultTTL;
+        this.storageName = storageName;
+        this.logger = logger;
+    }
+    /**
+     * Throws error if server is not responding
+     * or bucket doesn't exist
+     */
+    async checkBucket() {
+        await this.s3.headBucket({ Bucket: this.bucket }).promise();
+        /**
+         * TODO: Добавить более информативную обработку ошибок.
+         * Сейчас в целом терпимо, но может быть лучше.
+         */
+    }
+    /**
+     * Returns true if bucket is reachable
+     * @returns Promise<boolean>
+     */
+    async isHealthy() {
+        try {
+            await this.checkBucket();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Creates temporary download link for object
+     * @param key Object key
+     * @param ttl Time too live for the presigned url (defaults to 48h)
+     * @returns Promise<string>
+     */
+    async getPresignedUrl(key, ttl = this.defaultTTL) {
+        return this.s3.getSignedUrlPromise('getObject', {
+            Bucket: this.bucket,
+            Key: key,
+            Expires: ttl.millis(),
+        });
+    }
+    /**
+     * Get object metadata
+     * @param key Key to save object to
+     * @returns Promise<ObjectInfo>
+     */
+    async getObjectInfo(key) {
+        const response = await this.s3
+            .headObject({ Bucket: this.bucket, Key: key })
+            .promise();
+        return this.parseMetadata(key, response);
+    }
+    /**
+     * Retrieves object from storage
+     * @param key string
+     * @returns Promise<File>
+     */
+    async getObject(key) {
+        const response = await this.s3
+            .getObject({
+            Bucket: this.bucket,
+            Key: key,
+        })
+            .promise();
+        return {
+            ...this.parseMetadata(key, response),
+            content: await this.parseBody(key, response),
+        };
+    }
+    /**
+     * Get object stream from storage
+     * @param key Object key
+     * @returns Promise<Readable>
+     */
+    async getObjectStream(key) {
+        const stream = this.s3
+            .getObject({
+            Bucket: this.bucket,
+            Key: key,
+        })
+            .createReadStream();
+        return stream;
+    }
+    /**
+     * Upload object to storage
+     * @param key Object key
+     * @param content Buffer
+     * @param options UploadOptions
+     */
+    async addObject(key, content, options) {
+        const { filename, contentType, metadata = {}, isAttachment = false, } = options || {};
+        const encodedFilenameOrHash = filename
+            ? encodeURIComponent(filename)
+            : this.hashKey(key);
+        await this.s3
+            .upload({
+            Key: key,
+            Body: content,
+            Bucket: this.bucket,
+            ContentType: contentType ||
+                this.tryGetContentType(encodedFilenameOrHash) ||
+                DEFAULT_CONTENT_TYPE,
+            ContentDisposition: `${isAttachment ? 'attachment; ' : ''}filename=${encodedFilenameOrHash}`,
+            Metadata: { ...metadata, filename: encodedFilenameOrHash },
+        })
+            .promise();
+    }
+    /**
+     * Removes object by key
+     * @param key Object key
+     */
+    async removeObject(key) {
+        await this.s3
+            .deleteObject({
+            Bucket: this.bucket,
+            Key: key,
+        })
+            .promise();
+    }
+    /**
+     * Tries to determine content type by file name
+     * @param filename filename
+     * @returns string
+     */
+    tryGetContentType(filename) {
+        const contentType = mime_types_1.default.contentType(filename);
+        if (contentType === false) {
+            this.logger.warn(`Can not detect content type of file: ${filename}`);
+            return undefined;
+        }
+        return contentType;
+    }
+    /**
+     * Parses metadata from S3 response
+     * @param key Object key
+     * @param response Object storage response
+     * @returns
+     */
+    parseMetadata(key, response) {
+        const { Metadata, ContentLength, ContentType } = response;
+        (0, node_assert_1.default)(Metadata, `Object <${key}> missing Metadata`);
+        (0, node_assert_1.default)(ContentLength, `Object <${key}> missing ContentLength`);
+        const { filename, ...metadata } = Metadata;
+        return {
+            size: new common_1.Size(ContentLength, 'b'),
+            contentType: ContentType,
+            filename: filename ? decodeURIComponent(filename) : this.hashKey(key),
+            metadata,
+        };
+    }
+    /**
+     * S3 storage can reply with different kinds of body
+     * @param key Object key
+     * @param response Object storage response
+     * @returns
+     */
+    async parseBody(key, response) {
+        const { Body } = response;
+        if (Buffer.isBuffer(Body)) {
+            return Body;
+        }
+        if (typeof Body === 'string' || Body instanceof Uint8Array) {
+            return Buffer.from(Body);
+        }
+        if (Body instanceof Blob) {
+            return Buffer.from(await Body.text());
+        }
+        if (Body instanceof node_stream_1.Readable) {
+            return (0, common_node_1.streamToBuffer)(Body);
+        }
+        throw new Error(`Object <${key}> missing Body or it is invalid`);
+    }
+    /**
+     * Create short hash of object key if there is no filename
+     * @param key Object key
+     * @returns string
+     */
+    hashKey(key) {
+        return (0, node_crypto_1.createHash)('shake256', { outputLength: 4 })
+            .update(key)
+            .digest('hex');
+    }
+}
+exports.S3Client = S3Client;
+//# sourceMappingURL=s3.client.js.map

package/dist/client/s3.client.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,68 @@
+/// <reference types="node" />
+import type { Size, Timespan } from '@rsdk/common';
+import type { ILogger } from '@rsdk/logging';
+export interface UploadOptions {
+    /**
+     * File name that will be added to object metadata.
+     * If not provided, filename will be calculated from
+     * object key
+     */
+    filename?: string;
+    /**
+     * File attachment flag that will be added to object metadata.
+     * If provided, the browser will interpret the file as downloadable
+     * object key
+     */
+    isAttachment?: string;
+    /**
+     * Mime type of the object. If not provided, client
+     * will try to determine content type from filename.
+     * Default: application/octet-stream
+     */
+    contentType?: string | undefined;
+    /**
+     * Key/value data that will be attached to object
+     * and returned as headers
+     *
+     * NOTE: All keys will be lowercase'ed. So use
+     * snake_case or kebab-case for keys
+     */
+    metadata?: Record<string, string>;
+}
+export interface S3ClientOptions {
+    storageName: string;
+    url: URL;
+    bucket: string;
+    defaultTTL: Timespan;
+    logger: ILogger;
+}
+/**
+ * Object metadata
+ */
+export interface ObjectInfo {
+    /**
+     * File name of object
+     */
+    filename: string;
+    /**
+     * Content type of object
+     */
+    contentType: string | undefined;
+    /**
+     * Size of object
+     */
+    size: Size;
+    /**
+     * Key/value data attached to object
+     */
+    metadata: Record<string, string>;
+}
+/**
+ * Object metadata with the object itself
+ */
+export interface File extends ObjectInfo {
+    /**
+     * Blob
+     */
+    content: Buffer;
+}

package/dist/client/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const S3_CLIENTS_RSDK_METADATA_SCOPE = "s3-clients";

package/dist/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3_CLIENTS_RSDK_METADATA_SCOPE = void 0;
+exports.S3_CLIENTS_RSDK_METADATA_SCOPE = 's3-clients';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,8BAA8B,GAAG,YAAY,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1 @@
+export * from './inject-client.decorator';

package/dist/decorators/index.js

@@ -0,0 +1,18 @@
+"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("./inject-client.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

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

package/dist/decorators/inject-client.decorator.d.ts

@@ -0,0 +1,8 @@
+export interface InjectBucketOptions {
+    storageName?: string;
+}
+/**
+ * @returns ParameterDecorator
+ * @param connectionName
+ */
+export declare const InjectBucket: (bucketName: string, options?: InjectBucketOptions) => ParameterDecorator;

package/dist/decorators/inject-client.decorator.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectBucket = void 0;
+const common_1 = require("@nestjs/common");
+const token_factories_1 = require("../token.factories");
+const set_client_metadata_fn_1 = require("./set-client-metadata.fn");
+/**
+ * @returns ParameterDecorator
+ * @param connectionName
+ */
+const InjectBucket = (bucketName, options) => {
+    return (target, propertyKey, parameterIndex) => {
+        const storageName = options?.storageName ?? 'default';
+        (0, common_1.Inject)((0, token_factories_1.getClientToken)(storageName, bucketName))(target, propertyKey, parameterIndex);
+        (0, set_client_metadata_fn_1.setClientMetadata)(target, storageName, bucketName);
+    };
+};
+exports.InjectBucket = InjectBucket;
+//# sourceMappingURL=inject-client.decorator.js.map

package/dist/decorators/inject-client.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-client.decorator.js","sourceRoot":"","sources":["../../src/decorators/inject-client.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,wDAAoD;AAEpD,qEAA6D;AAM7D;;;GAGG;AACI,MAAM,YAAY,GAAG,CAC1B,UAAkB,EAClB,OAA6B,EACT,EAAE;IACtB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC7C,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,SAAS,CAAC;QAEtD,IAAA,eAAM,EAAC,IAAA,gCAAc,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAC7C,MAAM,EACN,WAAW,EACX,cAAc,CACf,CAAC;QACF,IAAA,0CAAiB,EAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,YAAY,gBAcvB"}

package/dist/decorators/set-client-metadata.fn.d.ts

@@ -0,0 +1 @@
+export declare const setClientMetadata: (target: object, storageName: string, bucketName: string) => void;

package/dist/decorators/set-client-metadata.fn.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setClientMetadata = void 0;
+const metadata_1 = require("@rsdk/metadata");
+const module_generator_1 = require("../module.generator");
+const setClientMetadata = (target, storageName, bucketName) => {
+    const key = `s3:${storageName}:${bucketName}`;
+    const moduleDefinition = module_generator_1.ModuleGenerator.createClientModuleDefinition(target, storageName, bucketName);
+    metadata_1.RsdkMetadata.setWithScope(target, metadata_1.PLATFORM_RAW_GLOBAL_METADATA_SCOPE, key, moduleDefinition, true);
+};
+exports.setClientMetadata = setClientMetadata;
+//# sourceMappingURL=set-client-metadata.fn.js.map

package/dist/decorators/set-client-metadata.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-client-metadata.fn.js","sourceRoot":"","sources":["../../src/decorators/set-client-metadata.fn.ts"],"names":[],"mappings":";;;AAAA,6CAGwB;AAExB,0DAAsD;AAE/C,MAAM,iBAAiB,GAAG,CAC/B,MAAc,EACd,WAAmB,EACnB,UAAkB,EACZ,EAAE;IACR,MAAM,GAAG,GAAG,MAAM,WAAW,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAAG,kCAAe,CAAC,4BAA4B,CACnE,MAAM,EACN,WAAW,EACX,UAAU,CACX,CAAC;IAEF,uBAAY,CAAC,YAAY,CACvB,MAAM,EACN,6CAAkC,EAClC,GAAG,EACH,gBAAgB,EAChB,IAAI,CACL,CAAC;AACJ,CAAC,CAAC;AAnBW,QAAA,iBAAiB,qBAmB5B"}

package/dist/generate-key.fn.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Генерирует ключ для S3 из текущей даты и случайного UUID
+ * @returns string
+ */
+export declare const generateKey: () => string;

package/dist/generate-key.fn.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateKey = void 0;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Генерирует ключ для S3 из текущей даты и случайного UUID
+ * @returns string
+ */
+const generateKey = () => {
+    return `${Date.now()}/${(0, node_crypto_1.randomUUID)()}`;
+};
+exports.generateKey = generateKey;
+//# sourceMappingURL=generate-key.fn.js.map

package/dist/generate-key.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-key.fn.js","sourceRoot":"","sources":["../src/generate-key.fn.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAEzC;;;GAGG;AACI,MAAM,WAAW,GAAG,GAAW,EAAE;IACtC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAA,wBAAU,GAAE,EAAE,CAAC;AACzC,CAAC,CAAC;AAFW,QAAA,WAAW,eAEtB"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './decorators';
+export * from './module';
+export * from './client';
+export * from './generate-key.fn';

package/dist/index.js

@@ -0,0 +1,21 @@
+"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("./decorators"), exports);
+__exportStar(require("./module"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./generate-key.fn"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,2CAAyB;AACzB,2CAAyB;AACzB,oDAAkC"}

package/dist/module/index.d.ts

@@ -0,0 +1,2 @@
+export * from './s3-clients.plugin';
+export * from './s3-clients.service';

package/dist/module/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("./s3-clients.plugin"), exports);
+__exportStar(require("./s3-clients.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,uDAAqC"}

package/dist/module/s3-clients.config.d.ts

@@ -0,0 +1,5 @@
+import { Timespan } from '@rsdk/common';
+import { Config } from '@rsdk/core';
+export declare class S3ClientsConfig extends Config {
+    readonly defaultTTL: Timespan;
+}

package/dist/module/s3-clients.config.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3ClientsConfig = void 0;
+const common_1 = require("@rsdk/common");
+const core_1 = require("@rsdk/core");
+let S3ClientsConfig = class S3ClientsConfig extends core_1.Config {
+    defaultTTL;
+};
+exports.S3ClientsConfig = S3ClientsConfig;
+__decorate([
+    (0, core_1.Property)('S3_PRESIGNED_URL_DEFAULT_TTL', new core_1.TimespanParser(), {
+        description: (0, common_1.text) `
+      Время валидности подписанных ссылок по умолчанию. Может быть
+      переопределено при создании отдельных ссылок.
+    `,
+        defaultValue: new common_1.Timespan(48, 'h'),
+    }),
+    __metadata("design:type", common_1.Timespan)
+], S3ClientsConfig.prototype, "defaultTTL", void 0);
+exports.S3ClientsConfig = S3ClientsConfig = __decorate([
+    (0, core_1.ConfigSection)()
+], S3ClientsConfig);
+//# sourceMappingURL=s3-clients.config.js.map

package/dist/module/s3-clients.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-clients.config.js","sourceRoot":"","sources":["../../src/module/s3-clients.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAA8C;AAC9C,qCAA6E;AAGtE,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,aAAM;IAQhC,UAAU,CAAY;CAChC,CAAA;AATY,0CAAe;AAQjB;IAPR,IAAA,eAAQ,EAAC,8BAA8B,EAAE,IAAI,qBAAc,EAAE,EAAE;QAC9D,WAAW,EAAE,IAAA,aAAI,EAAA;;;KAGhB;QACD,YAAY,EAAE,IAAI,iBAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;KACpC,CAAC;8BACoB,iBAAQ;mDAAC;0BARpB,eAAe;IAD3B,IAAA,oBAAa,GAAE;GACH,eAAe,CAS3B"}

package/dist/module/s3-clients.indicator.d.ts

@@ -0,0 +1,13 @@
+import type { OnApplicationBootstrap } from '@nestjs/common';
+import type { HealthIndicator } from '@rsdk/core';
+import { CheckResult } from '@rsdk/core';
+import { ILogger } from '@rsdk/logging';
+import { S3ClientsService } from './s3-clients.service';
+export declare class S3HealthIndicator implements HealthIndicator, OnApplicationBootstrap {
+    private readonly logger;
+    private readonly service;
+    private clients;
+    constructor(logger: ILogger, service: S3ClientsService);
+    onApplicationBootstrap(): void;
+    check(): Promise<CheckResult>;
+}

package/dist/module/s3-clients.indicator.js

@@ -0,0 +1,52 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3HealthIndicator = void 0;
+const core_1 = require("@rsdk/core");
+const s3_clients_service_1 = require("./s3-clients.service");
+let S3HealthIndicator = class S3HealthIndicator {
+    logger;
+    service;
+    clients;
+    constructor(logger, service) {
+        this.logger = logger;
+        this.service = service;
+    }
+    onApplicationBootstrap() {
+        this.clients = this.service.clients();
+    }
+    async check() {
+        if (!this.clients) {
+            throw new core_1.InternalException('S3 healthchecks are not ready!');
+        }
+        this.logger.trace('Checking S3 clients health...');
+        this.logger.trace(`Found ${this.clients.length} clients.`);
+        const results = await Promise.all([...this.clients].map(async (client) => ({
+            client: `${client.storageName}`,
+            isHealty: await client.isHealthy(),
+        })));
+        const isHealthy = results.every((r) => r.isHealty);
+        this.logger.trace(`Is up: ${isHealthy}`);
+        return isHealthy
+            ? core_1.CheckResult.up({ results })
+            : core_1.CheckResult.down({ results });
+    }
+};
+exports.S3HealthIndicator = S3HealthIndicator;
+exports.S3HealthIndicator = S3HealthIndicator = __decorate([
+    (0, core_1.Indicator)('s3'),
+    __param(0, (0, core_1.InjectLogger)(S3HealthIndicator)),
+    __metadata("design:paramtypes", [Object, s3_clients_service_1.S3ClientsService])
+], S3HealthIndicator);
+//# sourceMappingURL=s3-clients.indicator.js.map

package/dist/module/s3-clients.indicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-clients.indicator.js","sourceRoot":"","sources":["../../src/module/s3-clients.indicator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,qCAKoB;AAKpB,6DAAwD;AAGjD,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAMwB;IACjC;IAJX,OAAO,CAA6C;IAE5D,YACoD,MAAe,EAChD,OAAyB;QADQ,WAAM,GAAN,MAAM,CAAS;QAChD,YAAO,GAAP,OAAO,CAAkB;IACzC,CAAC;IAEJ,sBAAsB;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,wBAAiB,CAAC,gCAAgC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACvC,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE;YAC/B,QAAQ,EAAE,MAAM,MAAM,CAAC,SAAS,EAAE;SACnC,CAAC,CAAC,CACJ,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;QAEzC,OAAO,SAAS;YACd,CAAC,CAAC,kBAAW,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7B,CAAC,CAAC,kBAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AArCY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,gBAAS,EAAC,IAAI,CAAC;IAOX,WAAA,IAAA,mBAAY,EAAC,iBAAiB,CAAC,CAAA;6CACN,qCAAgB;GAPjC,iBAAiB,CAqC7B"}

package/dist/module/s3-clients.module.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Вынесено в отдельный модуль для того чтобы не было дублирования внутри DI
+ * Но при этом чтобы не надо было делать `forRoot` в корне приложения
+ */
+export declare class S3ClientsModule {
+}

package/dist/module/s3-clients.module.js

@@ -0,0 +1,27 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3ClientsModule = void 0;
+const common_1 = require("@nestjs/common");
+const s3_clients_indicator_1 = require("./s3-clients.indicator");
+const s3_clients_service_1 = require("./s3-clients.service");
+/**
+ * Вынесено в отдельный модуль для того чтобы не было дублирования внутри DI
+ * Но при этом чтобы не надо было делать `forRoot` в корне приложения
+ */
+let S3ClientsModule = class S3ClientsModule {
+};
+exports.S3ClientsModule = S3ClientsModule;
+exports.S3ClientsModule = S3ClientsModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [s3_clients_service_1.S3ClientsService, s3_clients_indicator_1.S3HealthIndicator],
+        exports: [s3_clients_service_1.S3ClientsService],
+    })
+], S3ClientsModule);
+//# sourceMappingURL=s3-clients.module.js.map

package/dist/module/s3-clients.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-clients.module.js","sourceRoot":"","sources":["../../src/module/s3-clients.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAEhD,iEAA2D;AAC3D,6DAAwD;AAExD;;;GAGG;AAMI,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAL3B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,qCAAgB,EAAE,wCAAiB,CAAC;QAChD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,eAAe,CAAG"}

package/dist/module/s3-clients.plugin.d.ts

@@ -0,0 +1,10 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { Constructor } from '@rsdk/common';
+import type { AppropriateTransports, PlatformAppPlugin } from '@rsdk/core';
+/**
+ * На данный момент требуется только для работы хелсчеков
+ */
+export declare class S3Plugin implements PlatformAppPlugin {
+    forTransports(): AppropriateTransports;
+    modules?(): (DynamicModule | Constructor)[];
+}

package/dist/module/s3-clients.plugin.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Plugin = void 0;
+const s3_clients_module_1 = require("./s3-clients.module");
+/**
+ * На данный момент требуется только для работы хелсчеков
+ */
+class S3Plugin {
+    forTransports() {
+        return 'any';
+    }
+    modules() {
+        return [s3_clients_module_1.S3ClientsModule];
+    }
+}
+exports.S3Plugin = S3Plugin;
+//# sourceMappingURL=s3-clients.plugin.js.map

package/dist/module/s3-clients.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-clients.plugin.js","sourceRoot":"","sources":["../../src/module/s3-clients.plugin.ts"],"names":[],"mappings":";;;AAIA,2DAAsD;AAEtD;;GAEG;AACH,MAAa,QAAQ;IACnB,aAAa;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,CAAC,mCAAe,CAAC,CAAC;IAC3B,CAAC;CACF;AARD,4BAQC"}

package/dist/module/s3-clients.service.d.ts

@@ -0,0 +1,25 @@
+import type { OnApplicationBootstrap } from '@nestjs/common';
+import { ILogger } from '@rsdk/logging';
+import { S3Client } from '../client/s3.client';
+import { S3ClientsConfig } from './s3-clients.config';
+/**
+ * Простое кеш хранилище внутри DI для кеширования на замену статике
+ */
+export declare class S3ClientsService implements OnApplicationBootstrap {
+    private readonly config;
+    private readonly logger;
+    private readonly cache;
+    constructor(config: S3ClientsConfig, logger: ILogger);
+    /**
+     * Blocking application start if one of storages is unreachable.
+     *
+     * NOTE: Not sure that this is correct. Maybe it's better to
+     * print errors if exist and start app.
+     */
+    onApplicationBootstrap(): Promise<void>;
+    clients(): Readonly<Readonly<S3Client>[]>;
+    resolveClient(storageUrl: URL, storageName: string, bucket: string): S3Client;
+    getClient(storageName: string, bucket: string): S3Client | undefined;
+    private getExisting;
+    private setCache;
+}

package/dist/module/s3-clients.service.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3ClientsService = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@rsdk/common");
+const core_1 = require("@rsdk/core");
+const logging_1 = require("@rsdk/logging");
+const s3_client_1 = require("../client/s3.client");
+const s3_clients_config_1 = require("./s3-clients.config");
+/**
+ * Простое кеш хранилище внутри DI для кеширования на замену статике
+ */
+let S3ClientsService = class S3ClientsService {
+    config;
+    logger;
+    cache = new Map();
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+    }
+    /**
+     * Blocking application start if one of storages is unreachable.
+     *
+     * NOTE: Not sure that this is correct. Maybe it's better to
+     * print errors if exist and start app.
+     */
+    async onApplicationBootstrap() {
+        const clients = this.clients();
+        const interval = new common_2.Timespan(1, 's');
+        this.logger.debug(`Checking connections to ${clients.length} S3 buckets.`);
+        for (const client of clients) {
+            const metadata = {
+                storage: client.storageName,
+                bucket: client.bucket,
+            };
+            while (true) {
+                try {
+                    this.logger.debug('Checking connection to bucket...', metadata);
+                    await client.checkBucket();
+                    break;
+                }
+                catch (error) {
+                    common_2.Assert.isError(error);
+                    this.logger.fatal(`Connection check failed. Retry in ${interval.millis()}ms`, error);
+                }
+                await (0, common_2.delay)(interval);
+            }
+        }
+    }
+    clients() {
+        const clients = [];
+        for (const buckets of this.cache.values()) {
+            for (const client of buckets.values()) {
+                clients.push(client);
+            }
+        }
+        return clients;
+    }
+    resolveClient(storageUrl, storageName, bucket) {
+        const client = this.getExisting(storageName, bucket) ??
+            new s3_client_1.S3Client({
+                storageName,
+                bucket,
+                url: storageUrl,
+                defaultTTL: this.config.defaultTTL,
+                logger: logging_1.LoggerFactory.create(`s3/${storageName}/${bucket}`),
+            });
+        this.setCache(storageName, bucket, client);
+        return client;
+    }
+    getClient(storageName, bucket) {
+        return this.getExisting(storageName, bucket);
+    }
+    getExisting(storageName, bucket) {
+        return this.cache.get(storageName)?.get(bucket);
+    }
+    setCache(storageName, bucket, client) {
+        const existing = this.cache.get(storageName);
+        const updated = (existing || new Map())?.set(bucket, client);
+        this.cache.set(storageName, updated);
+    }
+};
+exports.S3ClientsService = S3ClientsService;
+exports.S3ClientsService = S3ClientsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, core_1.InjectLogger)(S3ClientsService)),
+    __metadata("design:paramtypes", [s3_clients_config_1.S3ClientsConfig, Object])
+], S3ClientsService);
+//# sourceMappingURL=s3-clients.service.js.map

package/dist/module/s3-clients.service.js.map

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

package/dist/module.generator.d.ts

@@ -0,0 +1,9 @@
+import type { DynamicModule } from '@nestjs/common';
+export type S3ClientMetadataValue = {
+    storageName: string;
+    bucketName: string;
+};
+export declare class ModuleGenerator {
+    static createClientModuleDefinition(target: object, storageName: string, bucketName: string): DynamicModule;
+    private static createClientProvider;
+}

package/dist/module.generator.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleGenerator = void 0;
+const common_1 = require("@rsdk/common");
+const core_1 = require("@rsdk/core");
+const metadata_1 = require("@rsdk/metadata");
+const s3_clients_module_1 = require("./module/s3-clients.module");
+const s3_clients_service_1 = require("./module/s3-clients.service");
+const constants_1 = require("./constants");
+const token_factories_1 = require("./token.factories");
+class ModuleGenerator {
+    static createClientModuleDefinition(target, storageName, bucketName) {
+        const CONFIG_PROPERTY_ALIAS = (0, token_factories_1.getPropertyKey)(storageName);
+        const propertyToken = (0, core_1.getPropertyToken)(CONFIG_PROPERTY_ALIAS);
+        const provider = ModuleGenerator.createClientProvider(storageName, bucketName, propertyToken);
+        const moduleDefinition = {
+            global: true,
+            imports: [
+                core_1.PlatformConfigModule.forProperty(CONFIG_PROPERTY_ALIAS),
+                s3_clients_module_1.S3ClientsModule,
+            ],
+            module: ModuleGenerator,
+            providers: [provider],
+            exports: [provider],
+        };
+        const key = (0, token_factories_1.getPropertyKey)(storageName);
+        core_1.ConfigMetadataRegistry.registerProperty(target, key, {
+            key: key,
+            parser: new core_1.UrlParser(),
+            description: (0, common_1.text) `
+        URL S3-совместимого хранилища (${storageName}),
+        включая access key и secret key (в username и password соответственно).
+        Например: https://{ACCESS_KEY}:{SECRET_KEY}@s3.domain.cloud
+      `,
+            expectedInEnv: false,
+        });
+        metadata_1.RsdkMetadata.add(target, { storageName, bucketName }, constants_1.S3_CLIENTS_RSDK_METADATA_SCOPE);
+        // AutodocMetadata.defineResolver(
+        //   moduleDefinition,
+        //   REDIS_CLIENTS_RSDK_METADATA_SCOPE,
+        //   new RedisClientsAutodocResolver(),
+        // );
+        return moduleDefinition;
+    }
+    static createClientProvider(storageName, bucketName, propertyToken) {
+        const clientToken = (0, token_factories_1.getClientToken)(storageName, bucketName);
+        return {
+            provide: clientToken,
+            inject: [propertyToken, s3_clients_service_1.S3ClientsService, core_1.APP_SCOPE],
+            useFactory: (url, clients, appScope) => clients.resolveClient(url, storageName, `${appScope.toLowerCase()}.${bucketName}`),
+        };
+    }
+}
+exports.ModuleGenerator = ModuleGenerator;
+//# sourceMappingURL=module.generator.js.map

package/dist/module.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.generator.js","sourceRoot":"","sources":["../src/module.generator.ts"],"names":[],"mappings":";;;AACA,yCAAoC;AACpC,qCAMoB;AACpB,6CAA8C;AAG9C,kEAA6D;AAC7D,oEAA+D;AAC/D,2CAA6D;AAC7D,uDAAmE;AAOnE,MAAa,eAAe;IAC1B,MAAM,CAAC,4BAA4B,CACjC,MAAc,EACd,WAAmB,EACnB,UAAkB;QAElB,MAAM,qBAAqB,GAAG,IAAA,gCAAc,EAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,IAAA,uBAAgB,EAAC,qBAAqB,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAG,eAAe,CAAC,oBAAoB,CACnD,WAAW,EACX,UAAU,EACV,aAAa,CACd,CAAC;QAEF,MAAM,gBAAgB,GAAkB;YACtC,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,2BAAoB,CAAC,WAAW,CAAC,qBAAqB,CAAC;gBACvD,mCAAe;aAChB;YACD,MAAM,EAAE,eAAe;YACvB,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,OAAO,EAAE,CAAC,QAAQ,CAAC;SACpB,CAAC;QAEF,MAAM,GAAG,GAAG,IAAA,gCAAc,EAAC,WAAW,CAAC,CAAC;QAExC,6BAAsB,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YACnD,GAAG,EAAE,GAAG;YACR,MAAM,EAAE,IAAI,gBAAS,EAAE;YACvB,WAAW,EAAE,IAAA,aAAI,EAAA;yCACkB,WAAW;;;OAG7C;YACD,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;QAEH,uBAAY,CAAC,GAAG,CACd,MAAM,EACN,EAAE,WAAW,EAAE,UAAU,EAAE,EAC3B,0CAA8B,CAC/B,CAAC;QAEF,kCAAkC;QAClC,sBAAsB;QACtB,uCAAuC;QACvC,uCAAuC;QACvC,KAAK;QAEL,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAEO,MAAM,CAAC,oBAAoB,CACjC,WAAmB,EACnB,UAAkB,EAClB,aAAqD;QAErD,MAAM,WAAW,GAAG,IAAA,gCAAc,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAE5D,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,CAAC,aAAa,EAAE,qCAAgB,EAAE,gBAAS,CAAC;YACpD,UAAU,EAAE,CACV,GAAQ,EACR,OAAyB,EACzB,QAAgB,EACN,EAAE,CACZ,OAAO,CAAC,aAAa,CACnB,GAAG,EACH,WAAW,EACX,GAAG,QAAQ,CAAC,WAAW,EAAE,IAAI,UAAU,EAAE,CAC1C;SACJ,CAAC;IACJ,CAAC;CACF;AA5ED,0CA4EC"}

package/dist/s3-clients.autodoc.d.ts

@@ -0,0 +1,6 @@
+import type { DocumentNode, DocumentResolver } from '@rsdk/autodoc.protocol';
+import type { RsdkMetadataProvider } from '@rsdk/metadata';
+import type { Promisable } from 'type-fest';
+export declare class S3ClientsAutodocResolver implements DocumentResolver {
+    getNode(rsdkMetadata: RsdkMetadataProvider): Promisable<DocumentNode | null>;
+}

package/dist/s3-clients.autodoc.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3ClientsAutodocResolver = void 0;
+const autodoc_protocol_1 = require("@rsdk/autodoc.protocol");
+const constants_1 = require("./constants");
+class S3ClientsAutodocResolver {
+    getNode(rsdkMetadata) {
+        const resources = rsdkMetadata.get(constants_1.S3_CLIENTS_RSDK_METADATA_SCOPE);
+        if (!resources) {
+            return null;
+        }
+        return new autodoc_protocol_1.Composite(new autodoc_protocol_1.Table(resources.map(({ value: { storageName, bucketName } }) => ({
+            storageName,
+            bucketName,
+        }))), 'S3 clients');
+    }
+}
+exports.S3ClientsAutodocResolver = S3ClientsAutodocResolver;
+//# sourceMappingURL=s3-clients.autodoc.js.map

package/dist/s3-clients.autodoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-clients.autodoc.js","sourceRoot":"","sources":["../src/s3-clients.autodoc.ts"],"names":[],"mappings":";;;AACA,6DAA0D;AAI1D,2CAA6D;AAG7D,MAAa,wBAAwB;IACnC,OAAO,CAAC,YAAkC;QACxC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAChC,0CAA8B,CAC/B,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,4BAAS,CAClB,IAAI,wBAAK,CACP,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,WAAW;YACX,UAAU;SACX,CAAC,CAAC,CACJ,EACD,YAAY,CACb,CAAC;IACJ,CAAC;CACF;AApBD,4DAoBC"}

package/dist/token.factories.d.ts

@@ -0,0 +1,2 @@
+export declare const getClientToken: (storageName: string, bucketName: string) => string;
+export declare const getPropertyKey: (storageName: string) => string;

package/dist/token.factories.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPropertyKey = exports.getClientToken = void 0;
+const common_1 = require("@rsdk/common");
+const getClientToken = (storageName, bucketName) => `S3_CLIENT_${storageName}:${bucketName}`;
+exports.getClientToken = getClientToken;
+const getPropertyKey = (storageName) => `S3_URL_${common_1.Case.toUpperSnake(storageName)}`;
+exports.getPropertyKey = getPropertyKey;
+//# sourceMappingURL=token.factories.js.map

package/dist/token.factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.factories.js","sourceRoot":"","sources":["../src/token.factories.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AAE7B,MAAM,cAAc,GAAG,CAC5B,WAAmB,EACnB,UAAkB,EACV,EAAE,CAAC,aAAa,WAAW,IAAI,UAAU,EAAE,CAAC;AAHzC,QAAA,cAAc,kBAG2B;AAE/C,MAAM,cAAc,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC5D,UAAU,aAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;AADhC,QAAA,cAAc,kBACkB"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@rsdk/s3",
+  "version": "4.2.0-next.0",
+  "description": "Toolkit for S3 interface",
+  "license": "Apache License 2.0",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "*.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "aws-sdk": "^2.1468.0",
+    "mime-types": "^2.1.35"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@rsdk/autodoc.protocol": "^4.2.0-next.0",
+    "@rsdk/common": "^4.2.0-next.0",
+    "@rsdk/common.node": "^4.2.0-next.0",
+    "@rsdk/core": "^4.2.0-next.0",
+    "@rsdk/logging": "^4.2.0-next.0",
+    "@rsdk/metadata": "^4.2.0-next.0",
+    "reflect-metadata": "^0.1.13",
+    "rxjs": "^7.0.0"
+  },
+  "gitHead": "e4b95e1971841f8492f9df493fa4fe4f13f9bb5f"
+}