@cibule/storage-s3 0.1.1

package/README.md

@@ -0,0 +1,242 @@
+# @cibule/storage-s3
+
+AWS S3 storage driver for `@cibule/storage`. Implements the full `FileStorage` contract using `@aws-sdk/client-s3`, with presigned URL and multipart upload support. Works in Node.js, Cloudflare Workers, and any runtime with AWS SDK v3.
+
+## Installation
+
+```bash
+npm install @cibule/storage-s3 @cibule/storage
+# or
+bun add @cibule/storage-s3 @cibule/storage
+# or
+pnpm add @cibule/storage-s3 @cibule/storage
+# or
+yarn add @cibule/storage-s3 @cibule/storage
+```
+
+> **Peer dependency:** `@cibule/storage` provides the abstract `FileStorage` class and shared types.
+
+## Quick Start
+
+```typescript
+import { S3Client } from '@aws-sdk/client-s3';
+import { S3FileStorage } from '@cibule/storage-s3';
+
+const client = new S3Client({ region: 'eu-central-1' });
+const storage = new S3FileStorage({
+  client,
+  bucket: 'my-bucket',
+  publicUrlBase: 'https://cdn.example.com',
+});
+
+await storage.upload('photos/cat.jpg', new Uint8Array([1, 2, 3]), {
+  contentType: 'image/jpeg',
+});
+
+const file = await storage.download('photos/cat.jpg');
+console.log(file.contentType); // 'image/jpeg'
+```
+
+## API Reference
+
+### Constructor
+
+```typescript
+new S3FileStorage(config: S3FileStorageConfig)
+```
+
+| Option                    | Type       | Required | Description                                                  |
+| ------------------------- | ---------- | -------- | ------------------------------------------------------------ |
+| `client`                  | `S3Client` | Yes      | AWS SDK v3 S3 client instance                                |
+| `bucket`                  | `string`   | Yes      | S3 bucket name                                               |
+| `publicUrlBase`           | `string`   | No       | Base URL for public access (trailing slashes are normalized) |
+| `defaultPresignExpiresIn` | `number`   | No       | Default presigned URL expiry in seconds (default: `3600`)    |
+
+### Methods
+
+All methods implement the `FileStorage` contract from `@cibule/storage`.
+
+| Method                     | Signature                                              | Description                                      |
+| -------------------------- | ------------------------------------------------------ | ------------------------------------------------ |
+| `upload`                   | `(key, data, options?) → Promise<void>`                | Store a file with optional metadata              |
+| `download`                 | `(key) → Promise<FileStorageObject>`                   | Retrieve a file with metadata and body stream    |
+| `head`                     | `(key) → Promise<HeadResult \| null>`                  | Get file metadata without body (null if missing) |
+| `delete`                   | `(key) → Promise<void>`                                | Remove a file                                    |
+| `listKeys`                 | `(prefix?) → Promise<string[]>`                        | List all keys, with optional prefix filter       |
+| `getPublicUrl`             | `(key) → string`                                       | Build a public URL (requires `publicUrlBase`)    |
+| `getProtectedUrl`          | `(key) → string`                                       | Always throws (use presigned URLs instead)       |
+| `downloadRange`            | `(key, offset, length) → Promise<ArrayBuffer>`         | Read a fixed-length byte range                   |
+| `downloadPartial`          | `(key, start, end) → Promise<ReadableStream>`          | Stream a byte range (exclusive end)              |
+| `createPresignedUploadUrl` | `(key, options?) → Promise<PresignedUploadUrl>`        | Generate a presigned PUT URL for direct upload   |
+| `initiateMultipartUpload`  | `(key) → Promise<MultipartUploadInit>`                 | Start a multipart upload                         |
+| `createPresignedPartUrls`  | `(key, uploadId, parts) → Promise<PresignedPartUrl[]>` | Generate presigned PUT URLs for each part        |
+| `uploadPart`               | `(key, uploadId, partNumber, data) → Promise<string>`  | Upload one part, returns ETag                    |
+| `completeMultipartUpload`  | `(key, uploadId, parts) → Promise<void>`               | Finalize a multipart upload                      |
+| `abortMultipartUpload`     | `(key, uploadId) → Promise<void>`                      | Cancel and clean up a multipart upload           |
+
+### Upload Options
+
+```typescript
+await storage.upload('file.pdf', data, {
+  contentType: 'application/pdf',
+  cacheControl: 'public, max-age=31536000',
+  contentDisposition: 'attachment; filename="file.pdf"',
+  metadata: { userId: '123', version: '2' },
+});
+```
+
+## Advanced Patterns
+
+### Presigned Upload URLs
+
+Generate presigned PUT URLs for browser-direct uploads without proxying through your server:
+
+```typescript
+const { url, headers } = await storage.createPresignedUploadUrl('uploads/photo.jpg', {
+  expiresInSeconds: 600,
+  contentType: 'image/jpeg',
+});
+
+// Return url + headers to the client for a direct PUT request
+```
+
+### Presigned Download URLs
+
+Use the standalone `createS3PresignedGetUrl` function for time-limited download links:
+
+```typescript
+import { createS3PresignedGetUrl, DEFAULT_PRESIGN_EXPIRES_IN } from '@cibule/storage-s3';
+
+// Uses DEFAULT_PRESIGN_EXPIRES_IN (3600s) when omitted
+const url = await createS3PresignedGetUrl(client, 'my-bucket', 'private/report.pdf');
+
+// Or specify a custom expiry
+const shortUrl = await createS3PresignedGetUrl(client, 'my-bucket', 'private/report.pdf', 900);
+```
+
+### Multipart Uploads
+
+For large files, use S3's multipart upload API:
+
+```typescript
+// 1. Initiate
+const { uploadId, key } = await storage.initiateMultipartUpload('large-file.zip');
+
+// 2. Upload parts (minimum 5 MB per part except the last)
+const etag1 = await storage.uploadPart(key, uploadId, 1, chunk1);
+const etag2 = await storage.uploadPart(key, uploadId, 2, chunk2);
+
+// 3. Complete
+await storage.completeMultipartUpload(key, uploadId, [
+  { partNumber: 1, etag: etag1 },
+  { partNumber: 2, etag: etag2 },
+]);
+
+// Or abort if something goes wrong
+// await storage.abortMultipartUpload(key, uploadId);
+```
+
+### Browser-Direct Multipart Uploads
+
+Generate presigned part URLs so the browser uploads directly to S3:
+
+```typescript
+const { uploadId, key } = await storage.initiateMultipartUpload('large-file.zip');
+
+const partUrls = await storage.createPresignedPartUrls(key, uploadId, [1, 2, 3]);
+// Returns [{ partNumber: 1, url: '...' }, { partNumber: 2, url: '...' }, ...]
+
+// Client PUTs each chunk to the corresponding URL, collects ETags
+// Then server calls completeMultipartUpload with the ETags
+```
+
+### Byte Range Reads
+
+Read specific byte ranges for resumable downloads or media streaming:
+
+```typescript
+// Fixed-length range (returns ArrayBuffer)
+const chunk = await storage.downloadRange('video.mp4', 0, 1024);
+
+// Start-end range, exclusive end (returns ReadableStream of bytes [1024, 2048))
+const stream = await storage.downloadPartial('video.mp4', 1024, 2048);
+```
+
+### DI Integration
+
+Use the accessor pattern with `@cibule/di` for per-request storage instances:
+
+```typescript
+import { Injector } from '@cibule/di';
+import { FILE_STORAGE_ACCESSOR } from '@cibule/storage';
+import { S3FileStorage } from '@cibule/storage-s3';
+
+const storage = new S3FileStorage({ client, bucket: 'my-bucket' });
+
+const injector = Injector.create({
+  providers: [{ provide: FILE_STORAGE_ACCESSOR, useValue: () => storage }],
+});
+
+const accessor = injector.get(FILE_STORAGE_ACCESSOR);
+const fs = accessor(); // S3FileStorage instance
+```
+
+### Paginated Listing
+
+`listKeys()` handles S3's 1000-object pagination limit automatically, fetching all pages via `ContinuationToken`:
+
+```typescript
+const allKeys = await storage.listKeys('uploads/');
+// Returns all matching keys, regardless of count
+```
+
+## Key Behaviors
+
+| Behavior            | S3FileStorage                                                                            |
+| ------------------- | ---------------------------------------------------------------------------------------- |
+| **Platform**        | Node.js, Cloudflare Workers, any runtime with AWS SDK v3                                 |
+| **Persistence**     | Durable (AWS S3 object storage)                                                          |
+| **Content type**    | From `options.contentType` (mapped to S3 `ContentType`)                                  |
+| **Public URLs**     | Requires `publicUrlBase` in config; throws without it                                    |
+| **Protected URLs**  | Always throws (use `createS3PresignedGetUrl()` for download links)                       |
+| **Presigned URLs**  | Full support: upload URLs via `createPresignedUploadUrl`, part URLs, download via helper |
+| **Multipart**       | S3 native multipart API with presigned part URL support for browser-direct uploads       |
+| **List pagination** | Automatic `ContinuationToken`-based pagination (fetches all pages)                       |
+| **Range reads**     | S3 `Range` header (`bytes=offset-end`)                                                   |
+| **Custom metadata** | Stored via S3's `Metadata` field                                                         |
+| **Not found**       | `download`, `downloadRange`, `downloadPartial` throw; `head` returns `null`              |
+
+## Type Exports
+
+```typescript
+import {
+  S3FileStorage,
+  createS3PresignedGetUrl,
+  DEFAULT_PRESIGN_EXPIRES_IN,
+} from '@cibule/storage-s3';
+import type { S3FileStorageConfig } from '@cibule/storage-s3';
+
+// Shared types from @cibule/storage
+import type {
+  CompletedPart,
+  FileStorageAccessor,
+  FileStorageObject,
+  FileUploadOptions,
+  HeadResult,
+  MultipartUploadInit,
+  PresignedPartUrl,
+  PresignedUploadUrl,
+  PresignOptions,
+} from '@cibule/storage';
+```
+
+## Related Packages
+
+| Package                               | Description                                    |
+| ------------------------------------- | ---------------------------------------------- |
+| [`@cibule/storage`](../storage)       | Core abstraction + in-memory and local drivers |
+| [`@cibule/storage-r2`](../storage-r2) | Cloudflare R2 storage driver                   |
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,318 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_PRESIGN_EXPIRES_IN: () => DEFAULT_PRESIGN_EXPIRES_IN,
+  S3FileStorage: () => S3FileStorage,
+  createS3PresignedGetUrl: () => createS3PresignedGetUrl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/s3-file-storage.ts
+var import_client_s34 = require("@aws-sdk/client-s3");
+
+// ../storage/src/lib/file-storage.ts
+var FileStorage = class {
+};
+
+// src/lib/is-not-found-error.ts
+function hasNotFoundMetadata(error) {
+  if (!("$metadata" in error)) return false;
+  const metadata = error.$metadata;
+  if (typeof metadata !== "object" || metadata === null) return false;
+  return metadata.httpStatusCode === 404;
+}
+function isNotFoundError(error) {
+  if (!(error instanceof Error)) return false;
+  const { name } = error;
+  if (name === "NotFound" || name === "NoSuchKey" || name === "404") return true;
+  return hasNotFoundMetadata(error);
+}
+
+// src/lib/s3-download-range.ts
+var import_client_s3 = require("@aws-sdk/client-s3");
+async function downloadS3Range(client, bucket, key, offset, length) {
+  if (offset < 0) {
+    throw new Error("offset must be non-negative");
+  }
+  if (length <= 0) {
+    throw new Error("length must be positive");
+  }
+  const response = await client.send(
+    new import_client_s3.GetObjectCommand({
+      Bucket: bucket,
+      Key: key,
+      Range: `bytes=${String(offset)}-${String(offset + length - 1)}`
+    })
+  );
+  if (!response.Body) {
+    throw new Error(`File not found: ${key}`);
+  }
+  const bytes = await response.Body.transformToByteArray();
+  return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+async function downloadS3Partial(client, bucket, key, start, end) {
+  if (start >= end) {
+    throw new Error("start must be less than end");
+  }
+  const response = await client.send(
+    new import_client_s3.GetObjectCommand({
+      Bucket: bucket,
+      Key: key,
+      Range: `bytes=${String(start)}-${String(end - 1)}`
+    })
+  );
+  if (!response.Body) {
+    throw new Error(`File not found: ${key}`);
+  }
+  return response.Body.transformToWebStream();
+}
+
+// src/lib/s3-multipart.ts
+var import_client_s32 = require("@aws-sdk/client-s3");
+async function initiateS3MultipartUpload(client, bucket, key) {
+  const response = await client.send(
+    new import_client_s32.CreateMultipartUploadCommand({ Bucket: bucket, Key: key })
+  );
+  if (!response.UploadId) {
+    throw new Error(`Failed to initiate multipart upload for key: ${key}`);
+  }
+  return { uploadId: response.UploadId, key };
+}
+async function uploadS3Part(client, bucket, key, uploadId, partNumber, data) {
+  const response = await client.send(
+    new import_client_s32.UploadPartCommand({
+      Bucket: bucket,
+      Key: key,
+      UploadId: uploadId,
+      PartNumber: partNumber,
+      Body: data
+    })
+  );
+  if (!response.ETag) {
+    throw new Error(
+      `Missing ETag in upload part response for key: ${key}, part: ${String(partNumber)}`
+    );
+  }
+  return response.ETag;
+}
+async function completeS3MultipartUpload(client, bucket, key, uploadId, parts) {
+  await client.send(
+    new import_client_s32.CompleteMultipartUploadCommand({
+      Bucket: bucket,
+      Key: key,
+      UploadId: uploadId,
+      MultipartUpload: {
+        Parts: parts.map((p) => ({ PartNumber: p.partNumber, ETag: p.etag }))
+      }
+    })
+  );
+}
+async function abortS3MultipartUpload(client, bucket, key, uploadId) {
+  await client.send(
+    new import_client_s32.AbortMultipartUploadCommand({ Bucket: bucket, Key: key, UploadId: uploadId })
+  );
+}
+
+// src/lib/s3-presigned.ts
+var import_client_s33 = require("@aws-sdk/client-s3");
+var import_s3_request_presigner = require("@aws-sdk/s3-request-presigner");
+var DEFAULT_PRESIGN_EXPIRES_IN = 3600;
+async function createS3PresignedGetUrl(client, bucket, key, expiresIn = DEFAULT_PRESIGN_EXPIRES_IN) {
+  return (0, import_s3_request_presigner.getSignedUrl)(client, new import_client_s33.GetObjectCommand({ Bucket: bucket, Key: key }), { expiresIn });
+}
+async function createS3PresignedPutUrl(client, bucket, key, options, defaultExpiresIn) {
+  const expiresIn = options?.expiresInSeconds ?? defaultExpiresIn ?? DEFAULT_PRESIGN_EXPIRES_IN;
+  const command = new import_client_s33.PutObjectCommand({
+    Bucket: bucket,
+    Key: key,
+    ContentType: options?.contentType
+  });
+  const url = await (0, import_s3_request_presigner.getSignedUrl)(client, command, { expiresIn });
+  const headers = options?.contentType ? { "Content-Type": options.contentType } : void 0;
+  return { url, headers };
+}
+async function createS3PresignedPartUrls(client, bucket, key, uploadId, parts, expiresIn = DEFAULT_PRESIGN_EXPIRES_IN) {
+  return Promise.all(
+    parts.map(async (partNumber) => {
+      const command = new import_client_s33.UploadPartCommand({
+        Bucket: bucket,
+        Key: key,
+        UploadId: uploadId,
+        PartNumber: partNumber
+      });
+      const url = await (0, import_s3_request_presigner.getSignedUrl)(client, command, { expiresIn });
+      return { partNumber, url };
+    })
+  );
+}
+
+// src/lib/s3-response-to-head-result.ts
+function s3ResponseToHeadResult(response) {
+  return {
+    size: response.ContentLength ?? 0,
+    contentType: response.ContentType,
+    etag: response.ETag,
+    lastModified: response.LastModified
+  };
+}
+
+// src/lib/s3-response-to-storage-object.ts
+function s3ResponseToStorageObject(key, response) {
+  if (!response.Body) {
+    throw new Error(`File not found: ${key}`);
+  }
+  return {
+    key,
+    body: response.Body.transformToWebStream(),
+    size: response.ContentLength ?? 0,
+    contentType: response.ContentType,
+    etag: response.ETag,
+    lastModified: response.LastModified
+  };
+}
+
+// src/lib/s3-file-storage.ts
+var S3FileStorage = class extends FileStorage {
+  client;
+  bucket;
+  publicUrlBase;
+  defaultPresignExpiresIn;
+  constructor(config) {
+    super();
+    this.client = config.client;
+    this.bucket = config.bucket;
+    this.publicUrlBase = config.publicUrlBase ? `${config.publicUrlBase.replace(/\/+$/, "")}/` : void 0;
+    this.defaultPresignExpiresIn = config.defaultPresignExpiresIn ?? 3600;
+  }
+  async upload(key, data, options) {
+    await this.client.send(
+      new import_client_s34.PutObjectCommand({
+        Bucket: this.bucket,
+        Key: key,
+        Body: data,
+        ContentType: options?.contentType,
+        CacheControl: options?.cacheControl,
+        ContentDisposition: options?.contentDisposition,
+        Metadata: options?.metadata
+      })
+    );
+  }
+  async download(key) {
+    const response = await this.client.send(
+      new import_client_s34.GetObjectCommand({ Bucket: this.bucket, Key: key })
+    );
+    return s3ResponseToStorageObject(key, response);
+  }
+  async head(key) {
+    try {
+      const response = await this.client.send(
+        new import_client_s34.HeadObjectCommand({ Bucket: this.bucket, Key: key })
+      );
+      return s3ResponseToHeadResult(response);
+    } catch (error) {
+      if (isNotFoundError(error)) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  async delete(key) {
+    await this.client.send(new import_client_s34.DeleteObjectCommand({ Bucket: this.bucket, Key: key }));
+  }
+  async listKeys(prefix) {
+    const keys = [];
+    let continuationToken;
+    do {
+      const response = await this.client.send(
+        new import_client_s34.ListObjectsV2Command({
+          Bucket: this.bucket,
+          Prefix: prefix,
+          ContinuationToken: continuationToken
+        })
+      );
+      if (response.Contents) {
+        for (const obj of response.Contents) {
+          if (obj.Key) {
+            keys.push(obj.Key);
+          }
+        }
+      }
+      continuationToken = response.IsTruncated ? response.NextContinuationToken : void 0;
+    } while (continuationToken);
+    return keys;
+  }
+  getPublicUrl(key) {
+    if (!this.publicUrlBase) {
+      throw new Error("publicUrlBase is required for getPublicUrl");
+    }
+    return `${this.publicUrlBase}${key}`;
+  }
+  getProtectedUrl(_key) {
+    throw new Error(
+      "Use createPresignedUploadUrl() or createS3PresignedGetUrl() for presigned URLs"
+    );
+  }
+  async downloadRange(key, offset, length) {
+    return downloadS3Range(this.client, this.bucket, key, offset, length);
+  }
+  async downloadPartial(key, start, end) {
+    return downloadS3Partial(this.client, this.bucket, key, start, end);
+  }
+  async createPresignedUploadUrl(key, options) {
+    return createS3PresignedPutUrl(
+      this.client,
+      this.bucket,
+      key,
+      options,
+      this.defaultPresignExpiresIn
+    );
+  }
+  async initiateMultipartUpload(key) {
+    return initiateS3MultipartUpload(this.client, this.bucket, key);
+  }
+  async createPresignedPartUrls(key, uploadId, parts) {
+    return createS3PresignedPartUrls(
+      this.client,
+      this.bucket,
+      key,
+      uploadId,
+      parts,
+      this.defaultPresignExpiresIn
+    );
+  }
+  async uploadPart(key, uploadId, partNumber, data) {
+    return uploadS3Part(this.client, this.bucket, key, uploadId, partNumber, data);
+  }
+  async completeMultipartUpload(key, uploadId, parts) {
+    return completeS3MultipartUpload(this.client, this.bucket, key, uploadId, parts);
+  }
+  async abortMultipartUpload(key, uploadId) {
+    return abortS3MultipartUpload(this.client, this.bucket, key, uploadId);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_PRESIGN_EXPIRES_IN,
+  S3FileStorage,
+  createS3PresignedGetUrl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/lib/s3-file-storage.ts", "../../storage/src/lib/file-storage.ts", "../src/lib/is-not-found-error.ts", "../src/lib/s3-download-range.ts", "../src/lib/s3-multipart.ts", "../src/lib/s3-presigned.ts", "../src/lib/s3-response-to-head-result.ts", "../src/lib/s3-response-to-storage-object.ts"],
+  "sourcesContent": ["export { S3FileStorage } from './lib/s3-file-storage';\nexport type { S3FileStorageConfig } from './lib/s3-file-storage-config';\nexport { createS3PresignedGetUrl, DEFAULT_PRESIGN_EXPIRES_IN } from './lib/s3-presigned';\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport {\n  DeleteObjectCommand,\n  GetObjectCommand,\n  HeadObjectCommand,\n  ListObjectsV2Command,\n  PutObjectCommand,\n} from '@aws-sdk/client-s3';\nimport type {\n  CompletedPart,\n  FileStorageObject,\n  FileUploadOptions,\n  HeadResult,\n  MultipartUploadInit,\n  PresignedPartUrl,\n  PresignedUploadUrl,\n  PresignOptions,\n} from '@cibule/storage';\nimport { FileStorage } from '@cibule/storage';\n\nimport { isNotFoundError } from './is-not-found-error';\nimport { downloadS3Partial, downloadS3Range } from './s3-download-range';\nimport type { S3FileStorageConfig } from './s3-file-storage-config';\nimport {\n  abortS3MultipartUpload,\n  completeS3MultipartUpload,\n  initiateS3MultipartUpload,\n  uploadS3Part,\n} from './s3-multipart';\nimport { createS3PresignedPartUrls, createS3PresignedPutUrl } from './s3-presigned';\nimport { s3ResponseToHeadResult } from './s3-response-to-head-result';\nimport { s3ResponseToStorageObject } from './s3-response-to-storage-object';\n\nexport class S3FileStorage extends FileStorage {\n  private readonly client: S3Client;\n  private readonly bucket: string;\n  private readonly publicUrlBase: string | undefined;\n  private readonly defaultPresignExpiresIn: number;\n\n  public constructor(config: S3FileStorageConfig) {\n    super();\n    this.client = config.client;\n    this.bucket = config.bucket;\n    this.publicUrlBase = config.publicUrlBase\n      ? `${config.publicUrlBase.replace(/\\/+$/, '')}/`\n      : undefined;\n    this.defaultPresignExpiresIn = config.defaultPresignExpiresIn ?? 3600;\n  }\n\n  public async upload(\n    key: string,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n    options?: FileUploadOptions,\n  ): Promise<void> {\n    await this.client.send(\n      new PutObjectCommand({\n        Bucket: this.bucket,\n        Key: key,\n        Body: data as PutObjectCommand['input']['Body'],\n        ContentType: options?.contentType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n      }),\n    );\n  }\n\n  public async download(key: string): Promise<FileStorageObject> {\n    const response = await this.client.send(\n      new GetObjectCommand({ Bucket: this.bucket, Key: key }),\n    );\n    return s3ResponseToStorageObject(key, response);\n  }\n\n  public async head(key: string): Promise<HeadResult | null> {\n    try {\n      const response = await this.client.send(\n        new HeadObjectCommand({ Bucket: this.bucket, Key: key }),\n      );\n      return s3ResponseToHeadResult(response);\n    } catch (error: unknown) {\n      if (isNotFoundError(error)) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  public async delete(key: string): Promise<void> {\n    await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: key }));\n  }\n\n  public async listKeys(prefix?: string): Promise<string[]> {\n    const keys: string[] = [];\n    let continuationToken: string | undefined;\n\n    do {\n      const response = await this.client.send(\n        new ListObjectsV2Command({\n          Bucket: this.bucket,\n          Prefix: prefix,\n          ContinuationToken: continuationToken,\n        }),\n      );\n\n      if (response.Contents) {\n        for (const obj of response.Contents) {\n          if (obj.Key) {\n            keys.push(obj.Key);\n          }\n        }\n      }\n\n      continuationToken = response.IsTruncated ? response.NextContinuationToken : undefined;\n    } while (continuationToken);\n\n    return keys;\n  }\n\n  public getPublicUrl(key: string): string {\n    if (!this.publicUrlBase) {\n      throw new Error('publicUrlBase is required for getPublicUrl');\n    }\n    return `${this.publicUrlBase}${key}`;\n  }\n\n  public getProtectedUrl(_key: string): string {\n    throw new Error(\n      'Use createPresignedUploadUrl() or createS3PresignedGetUrl() for presigned URLs',\n    );\n  }\n\n  public async downloadRange(key: string, offset: number, length: number): Promise<ArrayBuffer> {\n    return downloadS3Range(this.client, this.bucket, key, offset, length);\n  }\n\n  public async downloadPartial(\n    key: string,\n    start: number,\n    end: number,\n  ): Promise<ReadableStream<Uint8Array>> {\n    return downloadS3Partial(this.client, this.bucket, key, start, end);\n  }\n\n  public async createPresignedUploadUrl(\n    key: string,\n    options?: PresignOptions,\n  ): Promise<PresignedUploadUrl> {\n    return createS3PresignedPutUrl(\n      this.client,\n      this.bucket,\n      key,\n      options,\n      this.defaultPresignExpiresIn,\n    );\n  }\n\n  public async initiateMultipartUpload(key: string): Promise<MultipartUploadInit> {\n    return initiateS3MultipartUpload(this.client, this.bucket, key);\n  }\n\n  public async createPresignedPartUrls(\n    key: string,\n    uploadId: string,\n    parts: number[],\n  ): Promise<PresignedPartUrl[]> {\n    return createS3PresignedPartUrls(\n      this.client,\n      this.bucket,\n      key,\n      uploadId,\n      parts,\n      this.defaultPresignExpiresIn,\n    );\n  }\n\n  public async uploadPart(\n    key: string,\n    uploadId: string,\n    partNumber: number,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n  ): Promise<string> {\n    return uploadS3Part(this.client, this.bucket, key, uploadId, partNumber, data);\n  }\n\n  public async completeMultipartUpload(\n    key: string,\n    uploadId: string,\n    parts: CompletedPart[],\n  ): Promise<void> {\n    return completeS3MultipartUpload(this.client, this.bucket, key, uploadId, parts);\n  }\n\n  public async abortMultipartUpload(key: string, uploadId: string): Promise<void> {\n    return abortS3MultipartUpload(this.client, this.bucket, key, uploadId);\n  }\n}\n", "import type {\n  CompletedPart,\n  FileStorageObject,\n  FileUploadOptions,\n  HeadResult,\n  MultipartUploadInit,\n  PresignedPartUrl,\n  PresignedUploadUrl,\n  PresignOptions,\n} from './file-storage-types';\n\nexport abstract class FileStorage {\n  abstract upload(\n    key: string,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n    options?: FileUploadOptions,\n  ): Promise<void>;\n\n  abstract download(key: string): Promise<FileStorageObject>;\n\n  abstract head(key: string): Promise<HeadResult | null>;\n\n  abstract delete(key: string): Promise<void>;\n\n  abstract listKeys(prefix?: string): Promise<string[]>;\n\n  abstract getPublicUrl(key: string): string;\n\n  abstract getProtectedUrl(key: string): string;\n\n  abstract downloadRange(key: string, offset: number, length: number): Promise<ArrayBuffer>;\n\n  abstract downloadPartial(\n    key: string,\n    start: number,\n    end: number,\n  ): Promise<ReadableStream<Uint8Array>>;\n\n  abstract createPresignedUploadUrl(\n    key: string,\n    options?: PresignOptions,\n  ): Promise<PresignedUploadUrl | null>;\n\n  abstract initiateMultipartUpload(key: string): Promise<MultipartUploadInit>;\n\n  abstract createPresignedPartUrls(\n    key: string,\n    uploadId: string,\n    parts: number[],\n  ): Promise<PresignedPartUrl[]>;\n\n  abstract uploadPart(\n    key: string,\n    uploadId: string,\n    partNumber: number,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n  ): Promise<string>;\n\n  abstract completeMultipartUpload(\n    key: string,\n    uploadId: string,\n    parts: CompletedPart[],\n  ): Promise<void>;\n\n  abstract abortMultipartUpload(key: string, uploadId: string): Promise<void>;\n}\n", "interface S3ErrorMetadata {\n  readonly httpStatusCode?: number;\n}\n\nfunction hasNotFoundMetadata(error: Error): boolean {\n  if (!('$metadata' in error)) return false;\n\n  const metadata = error.$metadata;\n  if (typeof metadata !== 'object' || metadata === null) return false;\n\n  return (metadata as S3ErrorMetadata).httpStatusCode === 404;\n}\n\nexport function isNotFoundError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n\n  const { name } = error;\n  if (name === 'NotFound' || name === 'NoSuchKey' || name === '404') return true;\n\n  return hasNotFoundMetadata(error);\n}\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport { GetObjectCommand } from '@aws-sdk/client-s3';\n\nexport async function downloadS3Range(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  offset: number,\n  length: number,\n): Promise<ArrayBuffer> {\n  if (offset < 0) {\n    throw new Error('offset must be non-negative');\n  }\n  if (length <= 0) {\n    throw new Error('length must be positive');\n  }\n\n  const response = await client.send(\n    new GetObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Range: `bytes=${String(offset)}-${String(offset + length - 1)}`,\n    }),\n  );\n\n  if (!response.Body) {\n    throw new Error(`File not found: ${key}`);\n  }\n\n  const bytes = await response.Body.transformToByteArray();\n  return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);\n}\n\nexport async function downloadS3Partial(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  start: number,\n  end: number,\n): Promise<ReadableStream<Uint8Array>> {\n  if (start >= end) {\n    throw new Error('start must be less than end');\n  }\n\n  const response = await client.send(\n    new GetObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Range: `bytes=${String(start)}-${String(end - 1)}`,\n    }),\n  );\n\n  if (!response.Body) {\n    throw new Error(`File not found: ${key}`);\n  }\n\n  return response.Body.transformToWebStream() as ReadableStream<Uint8Array>;\n}\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport {\n  AbortMultipartUploadCommand,\n  CompleteMultipartUploadCommand,\n  CreateMultipartUploadCommand,\n  UploadPartCommand,\n} from '@aws-sdk/client-s3';\nimport type { CompletedPart, MultipartUploadInit } from '@cibule/storage';\n\nexport async function initiateS3MultipartUpload(\n  client: S3Client,\n  bucket: string,\n  key: string,\n): Promise<MultipartUploadInit> {\n  const response = await client.send(\n    new CreateMultipartUploadCommand({ Bucket: bucket, Key: key }),\n  );\n\n  if (!response.UploadId) {\n    throw new Error(`Failed to initiate multipart upload for key: ${key}`);\n  }\n\n  return { uploadId: response.UploadId, key };\n}\n\nexport async function uploadS3Part(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n  partNumber: number,\n  data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n): Promise<string> {\n  const response = await client.send(\n    new UploadPartCommand({\n      Bucket: bucket,\n      Key: key,\n      UploadId: uploadId,\n      PartNumber: partNumber,\n      Body: data as UploadPartCommand['input']['Body'],\n    }),\n  );\n\n  if (!response.ETag) {\n    throw new Error(\n      `Missing ETag in upload part response for key: ${key}, part: ${String(partNumber)}`,\n    );\n  }\n\n  return response.ETag;\n}\n\nexport async function completeS3MultipartUpload(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n  parts: CompletedPart[],\n): Promise<void> {\n  await client.send(\n    new CompleteMultipartUploadCommand({\n      Bucket: bucket,\n      Key: key,\n      UploadId: uploadId,\n      MultipartUpload: {\n        Parts: parts.map(p => ({ PartNumber: p.partNumber, ETag: p.etag })),\n      },\n    }),\n  );\n}\n\nexport async function abortS3MultipartUpload(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n): Promise<void> {\n  await client.send(\n    new AbortMultipartUploadCommand({ Bucket: bucket, Key: key, UploadId: uploadId }),\n  );\n}\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport { GetObjectCommand, PutObjectCommand, UploadPartCommand } from '@aws-sdk/client-s3';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\nimport type { PresignedPartUrl, PresignedUploadUrl, PresignOptions } from '@cibule/storage';\n\nexport const DEFAULT_PRESIGN_EXPIRES_IN = 3600;\n\nexport async function createS3PresignedGetUrl(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  expiresIn: number = DEFAULT_PRESIGN_EXPIRES_IN,\n): Promise<string> {\n  return getSignedUrl(client, new GetObjectCommand({ Bucket: bucket, Key: key }), { expiresIn });\n}\n\nexport async function createS3PresignedPutUrl(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  options?: PresignOptions,\n  defaultExpiresIn?: number,\n): Promise<PresignedUploadUrl> {\n  const expiresIn = options?.expiresInSeconds ?? defaultExpiresIn ?? DEFAULT_PRESIGN_EXPIRES_IN;\n  const command = new PutObjectCommand({\n    Bucket: bucket,\n    Key: key,\n    ContentType: options?.contentType,\n  });\n\n  const url = await getSignedUrl(client, command, { expiresIn });\n  const headers = options?.contentType ? { 'Content-Type': options.contentType } : undefined;\n\n  return { url, headers };\n}\n\nexport async function createS3PresignedPartUrls(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n  parts: number[],\n  expiresIn: number = DEFAULT_PRESIGN_EXPIRES_IN,\n): Promise<PresignedPartUrl[]> {\n  return Promise.all(\n    parts.map(async partNumber => {\n      const command = new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      });\n      const url = await getSignedUrl(client, command, { expiresIn });\n      return { partNumber, url };\n    }),\n  );\n}\n", "import type { HeadObjectCommandOutput } from '@aws-sdk/client-s3';\nimport type { HeadResult } from '@cibule/storage';\n\nexport function s3ResponseToHeadResult(response: HeadObjectCommandOutput): HeadResult {\n  return {\n    size: response.ContentLength ?? 0,\n    contentType: response.ContentType,\n    etag: response.ETag,\n    lastModified: response.LastModified,\n  };\n}\n", "import type { GetObjectCommandOutput } from '@aws-sdk/client-s3';\nimport type { FileStorageObject } from '@cibule/storage';\n\nexport function s3ResponseToStorageObject(\n  key: string,\n  response: GetObjectCommandOutput,\n): FileStorageObject {\n  if (!response.Body) {\n    throw new Error(`File not found: ${key}`);\n  }\n\n  return {\n    key,\n    body: response.Body.transformToWebStream() as ReadableStream<Uint8Array>,\n    size: response.ContentLength ?? 0,\n    contentType: response.ContentType,\n    etag: response.ETag,\n    lastModified: response.LastModified,\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["import_client_s3", "import_client_s3", "import_client_s3"]
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { S3FileStorage } from './lib/s3-file-storage';
+export type { S3FileStorageConfig } from './lib/s3-file-storage-config';
+export { createS3PresignedGetUrl, DEFAULT_PRESIGN_EXPIRES_IN } from './lib/s3-presigned';
+//# 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,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,300 @@
+// src/lib/s3-file-storage.ts
+import {
+  DeleteObjectCommand,
+  GetObjectCommand as GetObjectCommand3,
+  HeadObjectCommand,
+  ListObjectsV2Command,
+  PutObjectCommand as PutObjectCommand2
+} from "@aws-sdk/client-s3";
+
+// ../storage/src/lib/file-storage.ts
+var FileStorage = class {
+};
+
+// src/lib/is-not-found-error.ts
+function hasNotFoundMetadata(error) {
+  if (!("$metadata" in error)) return false;
+  const metadata = error.$metadata;
+  if (typeof metadata !== "object" || metadata === null) return false;
+  return metadata.httpStatusCode === 404;
+}
+function isNotFoundError(error) {
+  if (!(error instanceof Error)) return false;
+  const { name } = error;
+  if (name === "NotFound" || name === "NoSuchKey" || name === "404") return true;
+  return hasNotFoundMetadata(error);
+}
+
+// src/lib/s3-download-range.ts
+import { GetObjectCommand } from "@aws-sdk/client-s3";
+async function downloadS3Range(client, bucket, key, offset, length) {
+  if (offset < 0) {
+    throw new Error("offset must be non-negative");
+  }
+  if (length <= 0) {
+    throw new Error("length must be positive");
+  }
+  const response = await client.send(
+    new GetObjectCommand({
+      Bucket: bucket,
+      Key: key,
+      Range: `bytes=${String(offset)}-${String(offset + length - 1)}`
+    })
+  );
+  if (!response.Body) {
+    throw new Error(`File not found: ${key}`);
+  }
+  const bytes = await response.Body.transformToByteArray();
+  return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+async function downloadS3Partial(client, bucket, key, start, end) {
+  if (start >= end) {
+    throw new Error("start must be less than end");
+  }
+  const response = await client.send(
+    new GetObjectCommand({
+      Bucket: bucket,
+      Key: key,
+      Range: `bytes=${String(start)}-${String(end - 1)}`
+    })
+  );
+  if (!response.Body) {
+    throw new Error(`File not found: ${key}`);
+  }
+  return response.Body.transformToWebStream();
+}
+
+// src/lib/s3-multipart.ts
+import {
+  AbortMultipartUploadCommand,
+  CompleteMultipartUploadCommand,
+  CreateMultipartUploadCommand,
+  UploadPartCommand
+} from "@aws-sdk/client-s3";
+async function initiateS3MultipartUpload(client, bucket, key) {
+  const response = await client.send(
+    new CreateMultipartUploadCommand({ Bucket: bucket, Key: key })
+  );
+  if (!response.UploadId) {
+    throw new Error(`Failed to initiate multipart upload for key: ${key}`);
+  }
+  return { uploadId: response.UploadId, key };
+}
+async function uploadS3Part(client, bucket, key, uploadId, partNumber, data) {
+  const response = await client.send(
+    new UploadPartCommand({
+      Bucket: bucket,
+      Key: key,
+      UploadId: uploadId,
+      PartNumber: partNumber,
+      Body: data
+    })
+  );
+  if (!response.ETag) {
+    throw new Error(
+      `Missing ETag in upload part response for key: ${key}, part: ${String(partNumber)}`
+    );
+  }
+  return response.ETag;
+}
+async function completeS3MultipartUpload(client, bucket, key, uploadId, parts) {
+  await client.send(
+    new CompleteMultipartUploadCommand({
+      Bucket: bucket,
+      Key: key,
+      UploadId: uploadId,
+      MultipartUpload: {
+        Parts: parts.map((p) => ({ PartNumber: p.partNumber, ETag: p.etag }))
+      }
+    })
+  );
+}
+async function abortS3MultipartUpload(client, bucket, key, uploadId) {
+  await client.send(
+    new AbortMultipartUploadCommand({ Bucket: bucket, Key: key, UploadId: uploadId })
+  );
+}
+
+// src/lib/s3-presigned.ts
+import { GetObjectCommand as GetObjectCommand2, PutObjectCommand, UploadPartCommand as UploadPartCommand2 } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+var DEFAULT_PRESIGN_EXPIRES_IN = 3600;
+async function createS3PresignedGetUrl(client, bucket, key, expiresIn = DEFAULT_PRESIGN_EXPIRES_IN) {
+  return getSignedUrl(client, new GetObjectCommand2({ Bucket: bucket, Key: key }), { expiresIn });
+}
+async function createS3PresignedPutUrl(client, bucket, key, options, defaultExpiresIn) {
+  const expiresIn = options?.expiresInSeconds ?? defaultExpiresIn ?? DEFAULT_PRESIGN_EXPIRES_IN;
+  const command = new PutObjectCommand({
+    Bucket: bucket,
+    Key: key,
+    ContentType: options?.contentType
+  });
+  const url = await getSignedUrl(client, command, { expiresIn });
+  const headers = options?.contentType ? { "Content-Type": options.contentType } : void 0;
+  return { url, headers };
+}
+async function createS3PresignedPartUrls(client, bucket, key, uploadId, parts, expiresIn = DEFAULT_PRESIGN_EXPIRES_IN) {
+  return Promise.all(
+    parts.map(async (partNumber) => {
+      const command = new UploadPartCommand2({
+        Bucket: bucket,
+        Key: key,
+        UploadId: uploadId,
+        PartNumber: partNumber
+      });
+      const url = await getSignedUrl(client, command, { expiresIn });
+      return { partNumber, url };
+    })
+  );
+}
+
+// src/lib/s3-response-to-head-result.ts
+function s3ResponseToHeadResult(response) {
+  return {
+    size: response.ContentLength ?? 0,
+    contentType: response.ContentType,
+    etag: response.ETag,
+    lastModified: response.LastModified
+  };
+}
+
+// src/lib/s3-response-to-storage-object.ts
+function s3ResponseToStorageObject(key, response) {
+  if (!response.Body) {
+    throw new Error(`File not found: ${key}`);
+  }
+  return {
+    key,
+    body: response.Body.transformToWebStream(),
+    size: response.ContentLength ?? 0,
+    contentType: response.ContentType,
+    etag: response.ETag,
+    lastModified: response.LastModified
+  };
+}
+
+// src/lib/s3-file-storage.ts
+var S3FileStorage = class extends FileStorage {
+  client;
+  bucket;
+  publicUrlBase;
+  defaultPresignExpiresIn;
+  constructor(config) {
+    super();
+    this.client = config.client;
+    this.bucket = config.bucket;
+    this.publicUrlBase = config.publicUrlBase ? `${config.publicUrlBase.replace(/\/+$/, "")}/` : void 0;
+    this.defaultPresignExpiresIn = config.defaultPresignExpiresIn ?? 3600;
+  }
+  async upload(key, data, options) {
+    await this.client.send(
+      new PutObjectCommand2({
+        Bucket: this.bucket,
+        Key: key,
+        Body: data,
+        ContentType: options?.contentType,
+        CacheControl: options?.cacheControl,
+        ContentDisposition: options?.contentDisposition,
+        Metadata: options?.metadata
+      })
+    );
+  }
+  async download(key) {
+    const response = await this.client.send(
+      new GetObjectCommand3({ Bucket: this.bucket, Key: key })
+    );
+    return s3ResponseToStorageObject(key, response);
+  }
+  async head(key) {
+    try {
+      const response = await this.client.send(
+        new HeadObjectCommand({ Bucket: this.bucket, Key: key })
+      );
+      return s3ResponseToHeadResult(response);
+    } catch (error) {
+      if (isNotFoundError(error)) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  async delete(key) {
+    await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: key }));
+  }
+  async listKeys(prefix) {
+    const keys = [];
+    let continuationToken;
+    do {
+      const response = await this.client.send(
+        new ListObjectsV2Command({
+          Bucket: this.bucket,
+          Prefix: prefix,
+          ContinuationToken: continuationToken
+        })
+      );
+      if (response.Contents) {
+        for (const obj of response.Contents) {
+          if (obj.Key) {
+            keys.push(obj.Key);
+          }
+        }
+      }
+      continuationToken = response.IsTruncated ? response.NextContinuationToken : void 0;
+    } while (continuationToken);
+    return keys;
+  }
+  getPublicUrl(key) {
+    if (!this.publicUrlBase) {
+      throw new Error("publicUrlBase is required for getPublicUrl");
+    }
+    return `${this.publicUrlBase}${key}`;
+  }
+  getProtectedUrl(_key) {
+    throw new Error(
+      "Use createPresignedUploadUrl() or createS3PresignedGetUrl() for presigned URLs"
+    );
+  }
+  async downloadRange(key, offset, length) {
+    return downloadS3Range(this.client, this.bucket, key, offset, length);
+  }
+  async downloadPartial(key, start, end) {
+    return downloadS3Partial(this.client, this.bucket, key, start, end);
+  }
+  async createPresignedUploadUrl(key, options) {
+    return createS3PresignedPutUrl(
+      this.client,
+      this.bucket,
+      key,
+      options,
+      this.defaultPresignExpiresIn
+    );
+  }
+  async initiateMultipartUpload(key) {
+    return initiateS3MultipartUpload(this.client, this.bucket, key);
+  }
+  async createPresignedPartUrls(key, uploadId, parts) {
+    return createS3PresignedPartUrls(
+      this.client,
+      this.bucket,
+      key,
+      uploadId,
+      parts,
+      this.defaultPresignExpiresIn
+    );
+  }
+  async uploadPart(key, uploadId, partNumber, data) {
+    return uploadS3Part(this.client, this.bucket, key, uploadId, partNumber, data);
+  }
+  async completeMultipartUpload(key, uploadId, parts) {
+    return completeS3MultipartUpload(this.client, this.bucket, key, uploadId, parts);
+  }
+  async abortMultipartUpload(key, uploadId) {
+    return abortS3MultipartUpload(this.client, this.bucket, key, uploadId);
+  }
+};
+export {
+  DEFAULT_PRESIGN_EXPIRES_IN,
+  S3FileStorage,
+  createS3PresignedGetUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/s3-file-storage.ts", "../../storage/src/lib/file-storage.ts", "../src/lib/is-not-found-error.ts", "../src/lib/s3-download-range.ts", "../src/lib/s3-multipart.ts", "../src/lib/s3-presigned.ts", "../src/lib/s3-response-to-head-result.ts", "../src/lib/s3-response-to-storage-object.ts"],
+  "sourcesContent": ["import type { S3Client } from '@aws-sdk/client-s3';\nimport {\n  DeleteObjectCommand,\n  GetObjectCommand,\n  HeadObjectCommand,\n  ListObjectsV2Command,\n  PutObjectCommand,\n} from '@aws-sdk/client-s3';\nimport type {\n  CompletedPart,\n  FileStorageObject,\n  FileUploadOptions,\n  HeadResult,\n  MultipartUploadInit,\n  PresignedPartUrl,\n  PresignedUploadUrl,\n  PresignOptions,\n} from '@cibule/storage';\nimport { FileStorage } from '@cibule/storage';\n\nimport { isNotFoundError } from './is-not-found-error';\nimport { downloadS3Partial, downloadS3Range } from './s3-download-range';\nimport type { S3FileStorageConfig } from './s3-file-storage-config';\nimport {\n  abortS3MultipartUpload,\n  completeS3MultipartUpload,\n  initiateS3MultipartUpload,\n  uploadS3Part,\n} from './s3-multipart';\nimport { createS3PresignedPartUrls, createS3PresignedPutUrl } from './s3-presigned';\nimport { s3ResponseToHeadResult } from './s3-response-to-head-result';\nimport { s3ResponseToStorageObject } from './s3-response-to-storage-object';\n\nexport class S3FileStorage extends FileStorage {\n  private readonly client: S3Client;\n  private readonly bucket: string;\n  private readonly publicUrlBase: string | undefined;\n  private readonly defaultPresignExpiresIn: number;\n\n  public constructor(config: S3FileStorageConfig) {\n    super();\n    this.client = config.client;\n    this.bucket = config.bucket;\n    this.publicUrlBase = config.publicUrlBase\n      ? `${config.publicUrlBase.replace(/\\/+$/, '')}/`\n      : undefined;\n    this.defaultPresignExpiresIn = config.defaultPresignExpiresIn ?? 3600;\n  }\n\n  public async upload(\n    key: string,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n    options?: FileUploadOptions,\n  ): Promise<void> {\n    await this.client.send(\n      new PutObjectCommand({\n        Bucket: this.bucket,\n        Key: key,\n        Body: data as PutObjectCommand['input']['Body'],\n        ContentType: options?.contentType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n      }),\n    );\n  }\n\n  public async download(key: string): Promise<FileStorageObject> {\n    const response = await this.client.send(\n      new GetObjectCommand({ Bucket: this.bucket, Key: key }),\n    );\n    return s3ResponseToStorageObject(key, response);\n  }\n\n  public async head(key: string): Promise<HeadResult | null> {\n    try {\n      const response = await this.client.send(\n        new HeadObjectCommand({ Bucket: this.bucket, Key: key }),\n      );\n      return s3ResponseToHeadResult(response);\n    } catch (error: unknown) {\n      if (isNotFoundError(error)) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  public async delete(key: string): Promise<void> {\n    await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: key }));\n  }\n\n  public async listKeys(prefix?: string): Promise<string[]> {\n    const keys: string[] = [];\n    let continuationToken: string | undefined;\n\n    do {\n      const response = await this.client.send(\n        new ListObjectsV2Command({\n          Bucket: this.bucket,\n          Prefix: prefix,\n          ContinuationToken: continuationToken,\n        }),\n      );\n\n      if (response.Contents) {\n        for (const obj of response.Contents) {\n          if (obj.Key) {\n            keys.push(obj.Key);\n          }\n        }\n      }\n\n      continuationToken = response.IsTruncated ? response.NextContinuationToken : undefined;\n    } while (continuationToken);\n\n    return keys;\n  }\n\n  public getPublicUrl(key: string): string {\n    if (!this.publicUrlBase) {\n      throw new Error('publicUrlBase is required for getPublicUrl');\n    }\n    return `${this.publicUrlBase}${key}`;\n  }\n\n  public getProtectedUrl(_key: string): string {\n    throw new Error(\n      'Use createPresignedUploadUrl() or createS3PresignedGetUrl() for presigned URLs',\n    );\n  }\n\n  public async downloadRange(key: string, offset: number, length: number): Promise<ArrayBuffer> {\n    return downloadS3Range(this.client, this.bucket, key, offset, length);\n  }\n\n  public async downloadPartial(\n    key: string,\n    start: number,\n    end: number,\n  ): Promise<ReadableStream<Uint8Array>> {\n    return downloadS3Partial(this.client, this.bucket, key, start, end);\n  }\n\n  public async createPresignedUploadUrl(\n    key: string,\n    options?: PresignOptions,\n  ): Promise<PresignedUploadUrl> {\n    return createS3PresignedPutUrl(\n      this.client,\n      this.bucket,\n      key,\n      options,\n      this.defaultPresignExpiresIn,\n    );\n  }\n\n  public async initiateMultipartUpload(key: string): Promise<MultipartUploadInit> {\n    return initiateS3MultipartUpload(this.client, this.bucket, key);\n  }\n\n  public async createPresignedPartUrls(\n    key: string,\n    uploadId: string,\n    parts: number[],\n  ): Promise<PresignedPartUrl[]> {\n    return createS3PresignedPartUrls(\n      this.client,\n      this.bucket,\n      key,\n      uploadId,\n      parts,\n      this.defaultPresignExpiresIn,\n    );\n  }\n\n  public async uploadPart(\n    key: string,\n    uploadId: string,\n    partNumber: number,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n  ): Promise<string> {\n    return uploadS3Part(this.client, this.bucket, key, uploadId, partNumber, data);\n  }\n\n  public async completeMultipartUpload(\n    key: string,\n    uploadId: string,\n    parts: CompletedPart[],\n  ): Promise<void> {\n    return completeS3MultipartUpload(this.client, this.bucket, key, uploadId, parts);\n  }\n\n  public async abortMultipartUpload(key: string, uploadId: string): Promise<void> {\n    return abortS3MultipartUpload(this.client, this.bucket, key, uploadId);\n  }\n}\n", "import type {\n  CompletedPart,\n  FileStorageObject,\n  FileUploadOptions,\n  HeadResult,\n  MultipartUploadInit,\n  PresignedPartUrl,\n  PresignedUploadUrl,\n  PresignOptions,\n} from './file-storage-types';\n\nexport abstract class FileStorage {\n  abstract upload(\n    key: string,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n    options?: FileUploadOptions,\n  ): Promise<void>;\n\n  abstract download(key: string): Promise<FileStorageObject>;\n\n  abstract head(key: string): Promise<HeadResult | null>;\n\n  abstract delete(key: string): Promise<void>;\n\n  abstract listKeys(prefix?: string): Promise<string[]>;\n\n  abstract getPublicUrl(key: string): string;\n\n  abstract getProtectedUrl(key: string): string;\n\n  abstract downloadRange(key: string, offset: number, length: number): Promise<ArrayBuffer>;\n\n  abstract downloadPartial(\n    key: string,\n    start: number,\n    end: number,\n  ): Promise<ReadableStream<Uint8Array>>;\n\n  abstract createPresignedUploadUrl(\n    key: string,\n    options?: PresignOptions,\n  ): Promise<PresignedUploadUrl | null>;\n\n  abstract initiateMultipartUpload(key: string): Promise<MultipartUploadInit>;\n\n  abstract createPresignedPartUrls(\n    key: string,\n    uploadId: string,\n    parts: number[],\n  ): Promise<PresignedPartUrl[]>;\n\n  abstract uploadPart(\n    key: string,\n    uploadId: string,\n    partNumber: number,\n    data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n  ): Promise<string>;\n\n  abstract completeMultipartUpload(\n    key: string,\n    uploadId: string,\n    parts: CompletedPart[],\n  ): Promise<void>;\n\n  abstract abortMultipartUpload(key: string, uploadId: string): Promise<void>;\n}\n", "interface S3ErrorMetadata {\n  readonly httpStatusCode?: number;\n}\n\nfunction hasNotFoundMetadata(error: Error): boolean {\n  if (!('$metadata' in error)) return false;\n\n  const metadata = error.$metadata;\n  if (typeof metadata !== 'object' || metadata === null) return false;\n\n  return (metadata as S3ErrorMetadata).httpStatusCode === 404;\n}\n\nexport function isNotFoundError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n\n  const { name } = error;\n  if (name === 'NotFound' || name === 'NoSuchKey' || name === '404') return true;\n\n  return hasNotFoundMetadata(error);\n}\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport { GetObjectCommand } from '@aws-sdk/client-s3';\n\nexport async function downloadS3Range(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  offset: number,\n  length: number,\n): Promise<ArrayBuffer> {\n  if (offset < 0) {\n    throw new Error('offset must be non-negative');\n  }\n  if (length <= 0) {\n    throw new Error('length must be positive');\n  }\n\n  const response = await client.send(\n    new GetObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Range: `bytes=${String(offset)}-${String(offset + length - 1)}`,\n    }),\n  );\n\n  if (!response.Body) {\n    throw new Error(`File not found: ${key}`);\n  }\n\n  const bytes = await response.Body.transformToByteArray();\n  return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);\n}\n\nexport async function downloadS3Partial(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  start: number,\n  end: number,\n): Promise<ReadableStream<Uint8Array>> {\n  if (start >= end) {\n    throw new Error('start must be less than end');\n  }\n\n  const response = await client.send(\n    new GetObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Range: `bytes=${String(start)}-${String(end - 1)}`,\n    }),\n  );\n\n  if (!response.Body) {\n    throw new Error(`File not found: ${key}`);\n  }\n\n  return response.Body.transformToWebStream() as ReadableStream<Uint8Array>;\n}\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport {\n  AbortMultipartUploadCommand,\n  CompleteMultipartUploadCommand,\n  CreateMultipartUploadCommand,\n  UploadPartCommand,\n} from '@aws-sdk/client-s3';\nimport type { CompletedPart, MultipartUploadInit } from '@cibule/storage';\n\nexport async function initiateS3MultipartUpload(\n  client: S3Client,\n  bucket: string,\n  key: string,\n): Promise<MultipartUploadInit> {\n  const response = await client.send(\n    new CreateMultipartUploadCommand({ Bucket: bucket, Key: key }),\n  );\n\n  if (!response.UploadId) {\n    throw new Error(`Failed to initiate multipart upload for key: ${key}`);\n  }\n\n  return { uploadId: response.UploadId, key };\n}\n\nexport async function uploadS3Part(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n  partNumber: number,\n  data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array,\n): Promise<string> {\n  const response = await client.send(\n    new UploadPartCommand({\n      Bucket: bucket,\n      Key: key,\n      UploadId: uploadId,\n      PartNumber: partNumber,\n      Body: data as UploadPartCommand['input']['Body'],\n    }),\n  );\n\n  if (!response.ETag) {\n    throw new Error(\n      `Missing ETag in upload part response for key: ${key}, part: ${String(partNumber)}`,\n    );\n  }\n\n  return response.ETag;\n}\n\nexport async function completeS3MultipartUpload(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n  parts: CompletedPart[],\n): Promise<void> {\n  await client.send(\n    new CompleteMultipartUploadCommand({\n      Bucket: bucket,\n      Key: key,\n      UploadId: uploadId,\n      MultipartUpload: {\n        Parts: parts.map(p => ({ PartNumber: p.partNumber, ETag: p.etag })),\n      },\n    }),\n  );\n}\n\nexport async function abortS3MultipartUpload(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n): Promise<void> {\n  await client.send(\n    new AbortMultipartUploadCommand({ Bucket: bucket, Key: key, UploadId: uploadId }),\n  );\n}\n", "import type { S3Client } from '@aws-sdk/client-s3';\nimport { GetObjectCommand, PutObjectCommand, UploadPartCommand } from '@aws-sdk/client-s3';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\nimport type { PresignedPartUrl, PresignedUploadUrl, PresignOptions } from '@cibule/storage';\n\nexport const DEFAULT_PRESIGN_EXPIRES_IN = 3600;\n\nexport async function createS3PresignedGetUrl(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  expiresIn: number = DEFAULT_PRESIGN_EXPIRES_IN,\n): Promise<string> {\n  return getSignedUrl(client, new GetObjectCommand({ Bucket: bucket, Key: key }), { expiresIn });\n}\n\nexport async function createS3PresignedPutUrl(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  options?: PresignOptions,\n  defaultExpiresIn?: number,\n): Promise<PresignedUploadUrl> {\n  const expiresIn = options?.expiresInSeconds ?? defaultExpiresIn ?? DEFAULT_PRESIGN_EXPIRES_IN;\n  const command = new PutObjectCommand({\n    Bucket: bucket,\n    Key: key,\n    ContentType: options?.contentType,\n  });\n\n  const url = await getSignedUrl(client, command, { expiresIn });\n  const headers = options?.contentType ? { 'Content-Type': options.contentType } : undefined;\n\n  return { url, headers };\n}\n\nexport async function createS3PresignedPartUrls(\n  client: S3Client,\n  bucket: string,\n  key: string,\n  uploadId: string,\n  parts: number[],\n  expiresIn: number = DEFAULT_PRESIGN_EXPIRES_IN,\n): Promise<PresignedPartUrl[]> {\n  return Promise.all(\n    parts.map(async partNumber => {\n      const command = new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      });\n      const url = await getSignedUrl(client, command, { expiresIn });\n      return { partNumber, url };\n    }),\n  );\n}\n", "import type { HeadObjectCommandOutput } from '@aws-sdk/client-s3';\nimport type { HeadResult } from '@cibule/storage';\n\nexport function s3ResponseToHeadResult(response: HeadObjectCommandOutput): HeadResult {\n  return {\n    size: response.ContentLength ?? 0,\n    contentType: response.ContentType,\n    etag: response.ETag,\n    lastModified: response.LastModified,\n  };\n}\n", "import type { GetObjectCommandOutput } from '@aws-sdk/client-s3';\nimport type { FileStorageObject } from '@cibule/storage';\n\nexport function s3ResponseToStorageObject(\n  key: string,\n  response: GetObjectCommandOutput,\n): FileStorageObject {\n  if (!response.Body) {\n    throw new Error(`File not found: ${key}`);\n  }\n\n  return {\n    key,\n    body: response.Body.transformToWebStream() as ReadableStream<Uint8Array>,\n    size: response.ContentLength ?? 0,\n    contentType: response.ContentType,\n    etag: response.ETag,\n    lastModified: response.LastModified,\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["GetObjectCommand", "PutObjectCommand", "GetObjectCommand", "UploadPartCommand", "PutObjectCommand", "GetObjectCommand"]
+}

package/dist/lib/is-not-found-error.d.ts

@@ -0,0 +1,2 @@
+export declare function isNotFoundError(error: unknown): boolean;
+//# sourceMappingURL=is-not-found-error.d.ts.map

package/dist/lib/is-not-found-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-not-found-error.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/is-not-found-error.ts"],"names":[],"mappings":"AAaA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD"}

package/dist/lib/s3-download-range.d.ts

@@ -0,0 +1,4 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+export declare function downloadS3Range(client: S3Client, bucket: string, key: string, offset: number, length: number): Promise<ArrayBuffer>;
+export declare function downloadS3Partial(client: S3Client, bucket: string, key: string, start: number, end: number): Promise<ReadableStream<Uint8Array>>;
+//# sourceMappingURL=s3-download-range.d.ts.map

package/dist/lib/s3-download-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-download-range.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-download-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,wBAAsB,eAAe,CACnC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CAsBtB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAkBrC"}

package/dist/lib/s3-file-storage-config.d.ts

@@ -0,0 +1,8 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+export interface S3FileStorageConfig {
+    readonly client: S3Client;
+    readonly bucket: string;
+    readonly publicUrlBase?: string;
+    readonly defaultPresignExpiresIn?: number;
+}
+//# sourceMappingURL=s3-file-storage-config.d.ts.map

package/dist/lib/s3-file-storage-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-file-storage-config.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-file-storage-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C"}

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

@@ -0,0 +1,26 @@
+import type { CompletedPart, FileStorageObject, FileUploadOptions, HeadResult, MultipartUploadInit, PresignedPartUrl, PresignedUploadUrl, PresignOptions } from '@cibule/storage';
+import { FileStorage } from '@cibule/storage';
+import type { S3FileStorageConfig } from './s3-file-storage-config';
+export declare class S3FileStorage extends FileStorage {
+    private readonly client;
+    private readonly bucket;
+    private readonly publicUrlBase;
+    private readonly defaultPresignExpiresIn;
+    constructor(config: S3FileStorageConfig);
+    upload(key: string, data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array, options?: FileUploadOptions): Promise<void>;
+    download(key: string): Promise<FileStorageObject>;
+    head(key: string): Promise<HeadResult | null>;
+    delete(key: string): Promise<void>;
+    listKeys(prefix?: string): Promise<string[]>;
+    getPublicUrl(key: string): string;
+    getProtectedUrl(_key: string): string;
+    downloadRange(key: string, offset: number, length: number): Promise<ArrayBuffer>;
+    downloadPartial(key: string, start: number, end: number): Promise<ReadableStream<Uint8Array>>;
+    createPresignedUploadUrl(key: string, options?: PresignOptions): Promise<PresignedUploadUrl>;
+    initiateMultipartUpload(key: string): Promise<MultipartUploadInit>;
+    createPresignedPartUrls(key: string, uploadId: string, parts: number[]): Promise<PresignedPartUrl[]>;
+    uploadPart(key: string, uploadId: string, partNumber: number, data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array): Promise<string>;
+    completeMultipartUpload(key: string, uploadId: string, parts: CompletedPart[]): Promise<void>;
+    abortMultipartUpload(key: string, uploadId: string): Promise<void>;
+}
+//# sourceMappingURL=s3-file-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"s3-file-storage.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-file-storage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAWpE,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;gBAE9B,MAAM,EAAE,mBAAmB;IAUjC,MAAM,CACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,UAAU,EAC3D,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAcH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOjD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAc7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BlD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOjC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM/B,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIhF,eAAe,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAIzB,wBAAwB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAUjB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIlE,uBAAuB,CAClC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAWjB,UAAU,CACrB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,UAAU,GAC1D,OAAO,CAAC,MAAM,CAAC;IAIL,uBAAuB,CAClC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC;IAIH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhF"}

package/dist/lib/s3-multipart.d.ts

@@ -0,0 +1,7 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+import type { CompletedPart, MultipartUploadInit } from '@cibule/storage';
+export declare function initiateS3MultipartUpload(client: S3Client, bucket: string, key: string): Promise<MultipartUploadInit>;
+export declare function uploadS3Part(client: S3Client, bucket: string, key: string, uploadId: string, partNumber: number, data: ReadableStream<Uint8Array> | ArrayBuffer | Uint8Array): Promise<string>;
+export declare function completeS3MultipartUpload(client: S3Client, bucket: string, key: string, uploadId: string, parts: CompletedPart[]): Promise<void>;
+export declare function abortS3MultipartUpload(client: S3Client, bucket: string, key: string, uploadId: string): Promise<void>;
+//# sourceMappingURL=s3-multipart.d.ts.map

package/dist/lib/s3-multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-multipart.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-multipart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAOnD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,UAAU,GAC1D,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/lib/s3-presigned.d.ts

@@ -0,0 +1,7 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+import type { PresignedPartUrl, PresignedUploadUrl, PresignOptions } from '@cibule/storage';
+export declare const DEFAULT_PRESIGN_EXPIRES_IN = 3600;
+export declare function createS3PresignedGetUrl(client: S3Client, bucket: string, key: string, expiresIn?: number): Promise<string>;
+export declare function createS3PresignedPutUrl(client: S3Client, bucket: string, key: string, options?: PresignOptions, defaultExpiresIn?: number): Promise<PresignedUploadUrl>;
+export declare function createS3PresignedPartUrls(client: S3Client, bucket: string, key: string, uploadId: string, parts: number[], expiresIn?: number): Promise<PresignedPartUrl[]>;
+//# sourceMappingURL=s3-presigned.d.ts.map

package/dist/lib/s3-presigned.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-presigned.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-presigned.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,EACxB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAY7B;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAa7B"}

package/dist/lib/s3-response-to-head-result.d.ts

@@ -0,0 +1,4 @@
+import type { HeadObjectCommandOutput } from '@aws-sdk/client-s3';
+import type { HeadResult } from '@cibule/storage';
+export declare function s3ResponseToHeadResult(response: HeadObjectCommandOutput): HeadResult;
+//# sourceMappingURL=s3-response-to-head-result.d.ts.map

package/dist/lib/s3-response-to-head-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-response-to-head-result.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-response-to-head-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,UAAU,CAOpF"}

package/dist/lib/s3-response-to-storage-object.d.ts

@@ -0,0 +1,4 @@
+import type { GetObjectCommandOutput } from '@aws-sdk/client-s3';
+import type { FileStorageObject } from '@cibule/storage';
+export declare function s3ResponseToStorageObject(key: string, response: GetObjectCommandOutput): FileStorageObject;
+//# sourceMappingURL=s3-response-to-storage-object.d.ts.map

package/dist/lib/s3-response-to-storage-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-response-to-storage-object.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-response-to-storage-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,sBAAsB,GAC/B,iBAAiB,CAanB"}

package/dist/lib/s3-test-helpers.d.ts

@@ -0,0 +1,14 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+import { vi } from 'vitest';
+export interface MockS3Client {
+    readonly client: S3Client;
+    readonly sendFn: ReturnType<typeof vi.fn>;
+}
+export declare function createMockClient(sendReturnValue?: unknown): MockS3Client;
+export declare function makeStream(): ReadableStream<Uint8Array>;
+export declare function makeBody(stream?: ReadableStream<Uint8Array>): {
+    transformToWebStream: ReturnType<typeof vi.fn>;
+    transformToByteArray: ReturnType<typeof vi.fn>;
+    transformToString: ReturnType<typeof vi.fn>;
+};
+//# sourceMappingURL=s3-test-helpers.d.ts.map

package/dist/lib/s3-test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-test-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/s3-test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,eAAe,GAAE,OAAY,GAAG,YAAY,CAG5E;AAED,wBAAgB,UAAU,IAAI,cAAc,CAAC,UAAU,CAAC,CAEvD;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAE,cAAc,CAAC,UAAU,CAAgB,GAAG;IAC3E,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/C,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7C,CAMA"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@cibule/storage-s3",
+  "version": "0.1.1",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/LadaBr/cibule",
+    "directory": "packages/storage-s3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1004.0",
+    "@aws-sdk/s3-request-presigner": "^3.1004.0",
+    "@cibule/storage": "workspace:*"
+  }
+}