@vankyle/storage-s3 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# @vankyle-hub/storage-s3
+
+`IStorage` implementation for any S3-compatible object storage backend.
+
+## Supported backends
+
+- AWS S3
+- Cloudflare R2 (S3-compatible HTTP API)
+- MinIO
+- DigitalOcean Spaces
+- Backblaze B2 (S3-compatible)
+- Any storage that speaks the S3 signature protocol
+
+> **Cloudflare R2 Worker Binding:** If you are running inside a Cloudflare Worker and want to use `env.BUCKET` directly, use [`@vankyle-hub/storage-cloudflare`](../cloudflare/README.md) instead.
+
+## Installation
+
+```bash
+pnpm add @vankyle-hub/storage-s3 @vankyle-hub/storage-core @vankyle-hub/storage-shared
+```
+
+## Usage
+
+### AWS S3
+
+```typescript
+import { S3Storage } from "@vankyle-hub/storage-s3";
+
+const storage = new S3Storage({
+  clientConfig: {
+    region: "us-east-1",
+    credentials: {
+      accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
+      secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
+    },
+  },
+});
+```
+
+### Cloudflare R2 (S3 API)
+
+```typescript
+const storage = new S3Storage({
+  clientConfig: {
+    region: "auto",
+    endpoint: `https://${process.env.CF_ACCOUNT_ID}.r2.cloudflarestorage.com`,
+    credentials: {
+      accessKeyId: process.env.R2_ACCESS_KEY_ID!,
+      secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
+    },
+  },
+  forcePathStyle: true,
+});
+```
+
+### MinIO
+
+```typescript
+const storage = new S3Storage({
+  clientConfig: {
+    region: "us-east-1",
+    endpoint: "http://localhost:9000",
+    credentials: {
+      accessKeyId: "minioadmin",
+      secretAccessKey: "minioadmin",
+    },
+  },
+  forcePathStyle: true,
+});
+```
+
+## Capabilities
+
+| Capability | Supported |
+|---|---|
+| `multipartUpload` | ✓ |
+| `signedReadUrl` | ✓ |
+| `signedPutUrl` | ✓ |
+| `signedPartUrl` | ✓ |
+| `serverSideCopy` | ✗ |
+
+All four URL types use `@aws-sdk/s3-request-presigner`.
+
+## Options reference
+
+```typescript
+interface S3StorageOptions {
+  /**
+   * Passed directly to the AWS SDK S3Client constructor.
+   * Set endpoint, region, credentials, etc. here.
+   */
+  clientConfig: S3ClientConfig;
+
+  /**
+   * Use path-style URLs instead of virtual-hosted style.
+   * Required for MinIO and some S3-compatible services.
+   * Default: false
+   */
+  forcePathStyle?: boolean;
+}
+```
+
+## Multipart upload
+
+`S3Storage` maps the `IStorage` multipart lifecycle directly to S3 multipart:
+
+| `IStorage` method | S3 API |
+|---|---|
+| `initUploadSession` | `CreateMultipartUpload` |
+| `uploadPart` | `UploadPart` |
+| `completeUploadSession` | `CompleteMultipartUpload` |
+| `abortUploadSession` | `AbortMultipartUpload` |
+
+The `providerUploadId` field on `InitUploadSessionResult` is the S3 `UploadId`.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { S3Storage } from "./storage/index.js";
+export type { S3StorageOptions } from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { S3Storage } from "./storage/index.js";
+//# 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,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mappers/index.d.ts

@@ -0,0 +1,2 @@
+export { mapS3HeadToCore } from "./s3-head-to-core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mappers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mappers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mappers/index.js

@@ -0,0 +1,2 @@
+export { mapS3HeadToCore } from "./s3-head-to-core.js";
+//# sourceMappingURL=index.js.map

package/dist/mappers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mappers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mappers/s3-head-to-core.d.ts

@@ -0,0 +1,4 @@
+import type { HeadObjectCommandOutput } from "@aws-sdk/client-s3";
+import type { HeadObjectResult } from "@vankyle-hub/storage-core";
+export declare function mapS3HeadToCore(output: HeadObjectCommandOutput): HeadObjectResult;
+//# sourceMappingURL=s3-head-to-core.d.ts.map

package/dist/mappers/s3-head-to-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-head-to-core.d.ts","sourceRoot":"","sources":["../../src/mappers/s3-head-to-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,wBAAgB,eAAe,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAQjF"}

package/dist/mappers/s3-head-to-core.js

@@ -0,0 +1,10 @@
+export function mapS3HeadToCore(output) {
+    return {
+        contentType: output.ContentType,
+        contentLength: output.ContentLength,
+        etag: output.ETag,
+        lastModified: output.LastModified,
+        metadata: output.Metadata,
+    };
+}
+//# sourceMappingURL=s3-head-to-core.js.map

package/dist/mappers/s3-head-to-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-head-to-core.js","sourceRoot":"","sources":["../../src/mappers/s3-head-to-core.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,2 @@
+export { S3Storage } from "./s3-storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,2 @@
+export { S3Storage } from "./s3-storage.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/storage/s3-storage.d.ts

@@ -0,0 +1,20 @@
+import { type IStorage, type StorageCapabilities, type PutObjectInput, type PutObjectResult, type GetObjectInput, type GetObjectResult, type HeadObjectInput, type HeadObjectResult, type DeleteObjectInput, type InitUploadSessionInput, type InitUploadSessionResult, type UploadPartInput, type UploadPartResult, type CompleteUploadSessionInput, type CompleteUploadSessionResult, type AbortUploadSessionInput, type CreateReadUrlInput, type CreatePutUrlInput, type CreateUploadPartUrlInput, type SignedAccess } from "@vankyle-hub/storage-core";
+import type { S3StorageOptions } from "../types/s3-options.js";
+export declare class S3Storage implements IStorage {
+    readonly provider: "s3";
+    readonly capabilities: StorageCapabilities;
+    private readonly client;
+    constructor(options: S3StorageOptions);
+    putObject(input: PutObjectInput): Promise<PutObjectResult>;
+    getObject(input: GetObjectInput): Promise<GetObjectResult>;
+    headObject(input: HeadObjectInput): Promise<HeadObjectResult>;
+    deleteObject(input: DeleteObjectInput): Promise<void>;
+    initUploadSession(input: InitUploadSessionInput): Promise<InitUploadSessionResult>;
+    uploadPart(input: UploadPartInput): Promise<UploadPartResult>;
+    completeUploadSession(input: CompleteUploadSessionInput): Promise<CompleteUploadSessionResult>;
+    abortUploadSession(input: AbortUploadSessionInput): Promise<void>;
+    createReadUrl(input: CreateReadUrlInput): Promise<SignedAccess>;
+    createPutUrl(input: CreatePutUrlInput): Promise<SignedAccess>;
+    createUploadPartUrl(input: CreateUploadPartUrlInput): Promise<SignedAccess>;
+}
+//# sourceMappingURL=s3-storage.d.ts.map

package/dist/storage/s3-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-storage.d.ts","sourceRoot":"","sources":["../../src/storage/s3-storage.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK/D,qBAAa,SAAU,YAAW,QAAQ;IACxC,QAAQ,CAAC,QAAQ,OAAsB;IACvC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAKxC;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEtB,OAAO,EAAE,gBAAgB;IAU/B,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB1D,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA0B1D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiB7D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,iBAAiB,CACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;IAmB7B,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4B7D,qBAAqB,CACzB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC;IAqBjC,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAkB/D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB7D,mBAAmB,CACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,YAAY,CAAC;CAiBzB"}

package/dist/storage/s3-storage.js

@@ -0,0 +1,214 @@
+import { S3Client, PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand, CreateMultipartUploadCommand, UploadPartCommand, CompleteMultipartUploadCommand, AbortMultipartUploadCommand, } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+import { StorageProvider, } from "@vankyle-hub/storage-core";
+import { StorageError, StorageObjectNotFoundError, } from "@vankyle-hub/storage-shared";
+import { mapS3HeadToCore } from "../mappers/s3-head-to-core.js";
+const DEFAULT_EXPIRES_IN = 3600; // 1 hour
+export class S3Storage {
+    provider = StorageProvider.S3;
+    capabilities = {
+        multipartUpload: true,
+        signedReadUrl: true,
+        signedPutUrl: true,
+        signedPartUrl: true,
+    };
+    client;
+    constructor(options) {
+        const config = {
+            ...options.clientConfig,
+        };
+        if (options.forcePathStyle !== undefined) {
+            config.forcePathStyle = options.forcePathStyle;
+        }
+        this.client = new S3Client(config);
+    }
+    async putObject(input) {
+        const body = input.body instanceof Uint8Array
+            ? input.body
+            : await streamToBuffer(input.body);
+        const result = await this.client.send(new PutObjectCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            Body: body,
+            ContentType: input.contentType,
+            ContentLength: input.contentLength,
+            ChecksumSHA256: input.sha256,
+            Metadata: input.metadata,
+        }));
+        return {
+            etag: result.ETag,
+            versionId: result.VersionId,
+        };
+    }
+    async getObject(input) {
+        const range = input.range
+            ? `bytes=${input.range.start}-${input.range.end ?? ""}`
+            : undefined;
+        const result = await this.client.send(new GetObjectCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            Range: range,
+        }));
+        if (!result.Body) {
+            throw new StorageObjectNotFoundError(input.bucket, input.objectKey);
+        }
+        return {
+            body: result.Body.transformToWebStream(),
+            contentType: result.ContentType,
+            contentLength: result.ContentLength,
+            etag: result.ETag,
+            metadata: result.Metadata,
+        };
+    }
+    async headObject(input) {
+        try {
+            const result = await this.client.send(new HeadObjectCommand({
+                Bucket: input.bucket,
+                Key: input.objectKey,
+            }));
+            return mapS3HeadToCore(result);
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                throw new StorageObjectNotFoundError(input.bucket, input.objectKey, { cause: error });
+            }
+            throw new StorageError("Failed to head object", { cause: error });
+        }
+    }
+    async deleteObject(input) {
+        await this.client.send(new DeleteObjectCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+        }));
+    }
+    async initUploadSession(input) {
+        const result = await this.client.send(new CreateMultipartUploadCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            ContentType: input.contentType,
+            Metadata: input.metadata,
+        }));
+        if (!result.UploadId) {
+            throw new StorageError("Failed to create multipart upload: no UploadId returned");
+        }
+        return {
+            providerUploadId: result.UploadId,
+        };
+    }
+    async uploadPart(input) {
+        const body = input.body instanceof Uint8Array
+            ? input.body
+            : await streamToBuffer(input.body);
+        const result = await this.client.send(new UploadPartCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            UploadId: input.providerUploadId,
+            PartNumber: input.partNumber,
+            Body: body,
+            ContentLength: input.contentLength,
+        }));
+        if (!result.ETag) {
+            throw new StorageError("Failed to upload part: no ETag returned");
+        }
+        return {
+            etag: result.ETag,
+            partNumber: input.partNumber,
+            size: body.byteLength,
+            checksumSha256: result.ChecksumSHA256,
+        };
+    }
+    async completeUploadSession(input) {
+        const result = await this.client.send(new CompleteMultipartUploadCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            UploadId: input.providerUploadId,
+            MultipartUpload: {
+                Parts: input.parts.map((p) => ({
+                    PartNumber: p.partNumber,
+                    ETag: p.etag,
+                })),
+            },
+        }));
+        return {
+            etag: result.ETag,
+            versionId: result.VersionId,
+        };
+    }
+    async abortUploadSession(input) {
+        await this.client.send(new AbortMultipartUploadCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            UploadId: input.providerUploadId,
+        }));
+    }
+    async createReadUrl(input) {
+        const expiresIn = input.expiresInSeconds ?? DEFAULT_EXPIRES_IN;
+        const command = new GetObjectCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            ResponseContentType: input.responseContentType,
+            ResponseContentDisposition: input.responseContentDisposition,
+        });
+        const url = await getSignedUrl(this.client, command, { expiresIn });
+        return {
+            url,
+            method: "GET",
+            expiresAt: new Date(Date.now() + expiresIn * 1000),
+        };
+    }
+    async createPutUrl(input) {
+        const expiresIn = input.expiresInSeconds ?? DEFAULT_EXPIRES_IN;
+        const command = new PutObjectCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            ContentType: input.contentType,
+        });
+        const url = await getSignedUrl(this.client, command, { expiresIn });
+        return {
+            url,
+            method: "PUT",
+            expiresAt: new Date(Date.now() + expiresIn * 1000),
+        };
+    }
+    async createUploadPartUrl(input) {
+        const expiresIn = input.expiresInSeconds ?? DEFAULT_EXPIRES_IN;
+        const command = new UploadPartCommand({
+            Bucket: input.bucket,
+            Key: input.objectKey,
+            UploadId: input.providerUploadId,
+            PartNumber: input.partNumber,
+        });
+        const url = await getSignedUrl(this.client, command, { expiresIn });
+        return {
+            url,
+            method: "PUT",
+            expiresAt: new Date(Date.now() + expiresIn * 1000),
+        };
+    }
+}
+async function streamToBuffer(stream) {
+    const reader = stream.getReader();
+    const chunks = [];
+    let totalLength = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+        totalLength += value.byteLength;
+    }
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return result;
+}
+function isNotFoundError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "name" in error &&
+        error.name === "NotFound");
+}
+//# sourceMappingURL=s3-storage.js.map

package/dist/storage/s3-storage.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type { S3StorageOptions } from "./s3-options.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/s3-options.d.ts

@@ -0,0 +1,6 @@
+import type { S3ClientConfig } from "@aws-sdk/client-s3";
+export interface S3StorageOptions {
+    readonly clientConfig: S3ClientConfig;
+    readonly forcePathStyle?: boolean | undefined;
+}
+//# sourceMappingURL=s3-options.d.ts.map

package/dist/types/s3-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-options.d.ts","sourceRoot":"","sources":["../../src/types/s3-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/C"}

package/dist/types/s3-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=s3-options.js.map

package/dist/types/s3-options.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@vankyle/storage-s3",
+  "version": "0.1.0",
+  "description": "S3-compatible object storage adapter for vankyle-storage.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b tsconfig.json --force",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vankyle-Hub/storage-ts.git",
+    "directory": "packages/s3"
+  },
+  "bugs": {
+    "url": "https://github.com/Vankyle-Hub/storage-ts/issues"
+  },
+  "homepage": "https://github.com/Vankyle-Hub/storage-ts",
+  "packageManager": "pnpm@10.28.2",
+  "dependencies": {
+    "@vankyle/storage-core": "0.1.0",
+    "@vankyle/storage-shared": "0.1.0",
+    "@aws-sdk/client-s3": "^3.1006.0",
+    "@aws-sdk/s3-request-presigner": "^3.1006.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}