@transferx/adapter-s3 0.1.0

package/dist/R2Adapter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @module R2Adapter
+ *
+ * Cloudflare R2 multipart upload adapter for TransferX.
+ *
+ * R2 is S3-compatible but requires three non-standard settings:
+ *
+ *   1. Custom endpoint:    `https://<accountId>.r2.cloudflarestorage.com`
+ *   2. forcePathStyle:     `true`  — avoids virtual-hosted DNS issues with R2
+ *   3. Region:             `"auto"` — R2 ignores region; AWS SDK requires a value
+ *
+ * All multipart upload semantics (5 MiB min part size, ETag tracking,
+ * ListParts-based resume, sorted CompleteMultipartUpload) are inherited
+ * from S3Adapter.
+ *
+ * @example
+ * ```typescript
+ * import { R2Adapter } from '@transferx/adapter-s3';
+ *
+ * const adapter = new R2Adapter({
+ *   accountId:   process.env.CF_ACCOUNT_ID!,
+ *   bucket:      'my-r2-bucket',
+ *   credentials: {
+ *     accessKeyId:     process.env.R2_ACCESS_KEY_ID!,
+ *     secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
+ *   },
+ * });
+ * ```
+ */
+import type { S3Client } from "@aws-sdk/client-s3";
+import type { LogLevel } from "@transferx/core";
+import { S3Adapter } from "./S3Adapter.js";
+export interface R2AdapterOptions {
+    /**
+     * Cloudflare account ID.
+     * Found in the Cloudflare dashboard URL: `dash.cloudflare.com/<accountId>`.
+     */
+    accountId: string;
+    /** R2 bucket name. */
+    bucket: string;
+    /**
+     * R2 API credentials. Generate from Cloudflare Dashboard → R2 → Manage API tokens.
+     * These are **never** logged.
+     */
+    credentials: {
+        /** R2 Access Key ID. */
+        accessKeyId: string;
+        /** R2 Secret Access Key. */
+        secretAccessKey: string;
+    };
+    /**
+     * Per-request HTTP timeout in milliseconds.
+     * Default: `120_000` (2 minutes).
+     */
+    timeoutMs?: number;
+    /**
+     * Optional structured-log callback. Wire to the engine's EventBus for
+     * end-to-end observability.
+     */
+    onLog?: (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Inject a pre-built `S3Client` instance.
+     * **For testing only.**
+     */
+    client?: S3Client;
+}
+/**
+ * R2Adapter delegates all work to S3Adapter, injecting the R2-specific
+ * connection settings in the constructor.  No R2-specific overrides are needed
+ * beyond those three config values.
+ */
+export declare class R2Adapter extends S3Adapter {
+    constructor(opts: R2AdapterOptions);
+}
+//# sourceMappingURL=R2Adapter.d.ts.map

package/dist/R2Adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"R2Adapter.d.ts","sourceRoot":"","sources":["../src/R2Adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,EAAE;QACX,wBAAwB;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,4BAA4B;QAC5B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,CACN,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,IAAI,CAAC;IACV;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAID;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,IAAI,EAAE,gBAAgB;CAoBnC"}

package/dist/R2Adapter.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * @module R2Adapter
+ *
+ * Cloudflare R2 multipart upload adapter for TransferX.
+ *
+ * R2 is S3-compatible but requires three non-standard settings:
+ *
+ *   1. Custom endpoint:    `https://<accountId>.r2.cloudflarestorage.com`
+ *   2. forcePathStyle:     `true`  — avoids virtual-hosted DNS issues with R2
+ *   3. Region:             `"auto"` — R2 ignores region; AWS SDK requires a value
+ *
+ * All multipart upload semantics (5 MiB min part size, ETag tracking,
+ * ListParts-based resume, sorted CompleteMultipartUpload) are inherited
+ * from S3Adapter.
+ *
+ * @example
+ * ```typescript
+ * import { R2Adapter } from '@transferx/adapter-s3';
+ *
+ * const adapter = new R2Adapter({
+ *   accountId:   process.env.CF_ACCOUNT_ID!,
+ *   bucket:      'my-r2-bucket',
+ *   credentials: {
+ *     accessKeyId:     process.env.R2_ACCESS_KEY_ID!,
+ *     secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
+ *   },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R2Adapter = void 0;
+const S3Adapter_js_1 = require("./S3Adapter.js");
+// ── Adapter ───────────────────────────────────────────────────────────────────
+/**
+ * R2Adapter delegates all work to S3Adapter, injecting the R2-specific
+ * connection settings in the constructor.  No R2-specific overrides are needed
+ * beyond those three config values.
+ */
+class R2Adapter extends S3Adapter_js_1.S3Adapter {
+    constructor(opts) {
+        const s3Opts = {
+            bucket: opts.bucket,
+            // R2 does not enforce region routing but the AWS SDK requires a value.
+            region: "auto",
+            // Construct the R2 account-specific endpoint.
+            endpoint: `https://${opts.accountId}.r2.cloudflarestorage.com`,
+            // Path-style addressing is required to avoid virtual-hosted DNS issues.
+            forcePathStyle: true,
+            credentials: {
+                accessKeyId: opts.credentials.accessKeyId,
+                secretAccessKey: opts.credentials.secretAccessKey,
+            },
+            // Forward optional fields only when present (exactOptionalPropertyTypes).
+            ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+            ...(opts.onLog !== undefined ? { onLog: opts.onLog } : {}),
+            ...(opts.client !== undefined ? { client: opts.client } : {}),
+        };
+        super(s3Opts);
+    }
+}
+exports.R2Adapter = R2Adapter;
+//# sourceMappingURL=R2Adapter.js.map

package/dist/R2Adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"R2Adapter.js","sourceRoot":"","sources":["../src/R2Adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAIH,iDAAkE;AA2ClE,iFAAiF;AAEjF;;;;GAIG;AACH,MAAa,SAAU,SAAQ,wBAAS;IACtC,YAAY,IAAsB;QAChC,MAAM,MAAM,GAAqB;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,uEAAuE;YACvE,MAAM,EAAE,MAAM;YACd,8CAA8C;YAC9C,QAAQ,EAAE,WAAW,IAAI,CAAC,SAAS,2BAA2B;YAC9D,wEAAwE;YACxE,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE;gBACX,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW;gBACzC,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,eAAe;aAClD;YACD,0EAA0E;YAC1E,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;CACF;AArBD,8BAqBC"}

package/dist/S3Adapter.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @module S3Adapter
+ *
+ * AWS S3 (and S3-compatible) multipart upload adapter for TransferX.
+ *
+ * Multipart upload lifecycle:
+ *
+ *   1. CreateMultipartUpload  → UploadId  (stored as session.providerSessionId)
+ *   2. UploadPart × N         → ETag      (stored as chunk.providerToken, verbatim
+ *                                           with surrounding quotes, e.g. `"abc123"`)
+ *   3. CompleteMultipartUpload → finalises the object
+ *   (abort path: AbortMultipartUpload)
+ *
+ * Resume support:
+ *   getRemoteState() calls ListParts (with pagination) to discover already-
+ *   uploaded parts, so the engine can skip re-uploading them on resume.
+ *
+ * Cloudflare R2 / S3-compatible stores:
+ *   Pass `endpoint` + `forcePathStyle: true` to target any S3-compatible API.
+ *   See R2Adapter for a purpose-built Cloudflare R2 wrapper.
+ *
+ * Security notes:
+ *   - Credentials are passed to the AWS SDK and NEVER logged or stored in
+ *     instance fields accessible outside this module.
+ *   - The AWS SDK's built-in retry mechanism is disabled (maxAttempts: 1) so
+ *     that TransferX's retry engine is the single source of truth.
+ *
+ * ETag contract:
+ *   S3 returns ETags surrounded by double-quotes (e.g. `"d8e8fca2dc0f896f"`).
+ *   These are stored verbatim as chunk.providerToken and passed back verbatim
+ *   in CompleteMultipartUpload — the AWS SDK serialises them correctly.
+ *
+ * Minimum part size:
+ *   AWS S3 requires each non-final part to be ≥ 5 MiB. TransferX's default
+ *   chunkSize (10 MiB) satisfies this. The engine enforces chunkSize ≥ 5 MiB
+ *   through config validation; this adapter does not re-validate.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import type { ITransferAdapter, ChunkUploadResult, RemoteUploadState, LogLevel } from "@transferx/core";
+import type { TransferSession, ChunkMeta } from "@transferx/core";
+export interface S3AdapterOptions {
+    /** Target S3 bucket name. */
+    bucket: string;
+    /**
+     * AWS region (e.g. `"us-east-1"`).
+     * Ignored when `endpoint` is set and the provider does not require a region
+     * (e.g. Cloudflare R2 — use `"auto"` or omit).
+     * Defaults to `"us-east-1"`.
+     */
+    region?: string;
+    /**
+     * AWS credentials. These are passed directly to the AWS SDK and never logged.
+     * For Cloudflare R2: use the Access Key ID and Secret from an R2 API token.
+     */
+    credentials: {
+        /** AWS Access Key ID (or R2 Access Key). */
+        accessKeyId: string;
+        /** AWS Secret Access Key (or R2 Secret). */
+        secretAccessKey: string;
+        /** AWS STS session token for temporary credentials. Omit for R2. */
+        sessionToken?: string;
+    };
+    /**
+     * Custom endpoint URL for S3-compatible storage providers.
+     * Required for Cloudflare R2:
+     *   `https://<account-id>.r2.cloudflarestorage.com`
+     */
+    endpoint?: string;
+    /**
+     * Use path-style URLs (`/bucket/key`) instead of virtual-hosted style
+     * (`bucket.s3.amazonaws.com/key`).
+     * Required for Cloudflare R2 and most non-AWS S3-compatible stores.
+     * Default: `false`.
+     */
+    forcePathStyle?: boolean;
+    /**
+     * Per-request HTTP timeout in milliseconds. Any request that stalls beyond
+     * this threshold is aborted and throws a retryable `network` error.
+     * Default: `120_000` (2 minutes).
+     */
+    timeoutMs?: number;
+    /**
+     * Optional structured-log callback for observability.
+     * `createS3Engine()` (if using the SDK façade) wires this automatically to
+     * the shared EventBus; for manual use, pass `bus.emit` directly.
+     *
+     * @example
+     * const adapter = new S3Adapter({
+     *   ...,
+     *   onLog: (level, msg, ctx) => bus.emit({ type: 'log', level, message: msg, ...ctx && { context: ctx } }),
+     * });
+     */
+    onLog?: (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Inject a pre-built `S3Client` instance.
+     * **For testing only** — pass a mock client to avoid real AWS calls.
+     * When provided, all other connection options (`region`, `endpoint`, etc.)
+     * are ignored.
+     */
+    client?: S3Client;
+}
+export declare class S3Adapter implements ITransferAdapter {
+    /** @internal exposed as protected so R2Adapter can subclass. */
+    protected readonly _client: S3Client;
+    private readonly _bucket;
+    private readonly _timeoutMs;
+    private readonly _onLog;
+    constructor(opts: S3AdapterOptions);
+    initTransfer(session: TransferSession): Promise<string>;
+    uploadChunk(session: TransferSession, chunk: ChunkMeta, data: Uint8Array, _sha256Hex: string): Promise<ChunkUploadResult>;
+    completeTransfer(session: TransferSession, chunks: ChunkMeta[]): Promise<void>;
+    abortTransfer(session: TransferSession): Promise<void>;
+    getRemoteState(session: TransferSession): Promise<RemoteUploadState>;
+    /**
+     * Send an S3 command with a per-request AbortController timeout and unified
+     * error mapping.  The return type is cast to `T` — callers know the shape of
+     * each command's output.
+     *
+     * The `command` parameter is typed as `unknown` here because AWS SDK v3
+     * Command classes are generic and contravariant — assigning a specific
+     * `CreateMultipartUploadCommand` to `Command<ServiceInputTypes, ...>` fails
+     * TypeScript's structural check due to middlewareStack overloads.  Each call
+     * site already supplies the correctly-typed Command, so the cast is safe.
+     */
+    private _send;
+    /**
+     * Normalise any error thrown by the AWS SDK into a typed TransferError so the
+     * engine can make correct retry/abort decisions.
+     */
+    private _mapError;
+}
+//# sourceMappingURL=S3Adapter.d.ts.map

package/dist/S3Adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3Adapter.d.ts","sourceRoot":"","sources":["../src/S3Adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACL,QAAQ,EAMT,MAAM,oBAAoB,CAAC;AAS5B,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,EAAE;QACX,4CAA4C;QAC5C,WAAW,EAAE,MAAM,CAAC;QACpB,4CAA4C;QAC5C,eAAe,EAAE,MAAM,CAAC;QACxB,oEAAoE;QACpE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,CACN,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,IAAI,CAAC;IACV;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAYD,qBAAa,SAAU,YAAW,gBAAgB;IAChD,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,IAAI,EAAE,gBAAgB;IAuC5B,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBvD,WAAW,CACf,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,UAAU,EAKhB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAuCvB,gBAAgB,CACpB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,SAAS,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAgCV,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IActD,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiD1E;;;;;;;;;;OAUG;YACW,KAAK;IAqBnB;;;OAGG;IACH,OAAO,CAAC,SAAS;CAkDlB"}

package/dist/S3Adapter.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * @module S3Adapter
+ *
+ * AWS S3 (and S3-compatible) multipart upload adapter for TransferX.
+ *
+ * Multipart upload lifecycle:
+ *
+ *   1. CreateMultipartUpload  → UploadId  (stored as session.providerSessionId)
+ *   2. UploadPart × N         → ETag      (stored as chunk.providerToken, verbatim
+ *                                           with surrounding quotes, e.g. `"abc123"`)
+ *   3. CompleteMultipartUpload → finalises the object
+ *   (abort path: AbortMultipartUpload)
+ *
+ * Resume support:
+ *   getRemoteState() calls ListParts (with pagination) to discover already-
+ *   uploaded parts, so the engine can skip re-uploading them on resume.
+ *
+ * Cloudflare R2 / S3-compatible stores:
+ *   Pass `endpoint` + `forcePathStyle: true` to target any S3-compatible API.
+ *   See R2Adapter for a purpose-built Cloudflare R2 wrapper.
+ *
+ * Security notes:
+ *   - Credentials are passed to the AWS SDK and NEVER logged or stored in
+ *     instance fields accessible outside this module.
+ *   - The AWS SDK's built-in retry mechanism is disabled (maxAttempts: 1) so
+ *     that TransferX's retry engine is the single source of truth.
+ *
+ * ETag contract:
+ *   S3 returns ETags surrounded by double-quotes (e.g. `"d8e8fca2dc0f896f"`).
+ *   These are stored verbatim as chunk.providerToken and passed back verbatim
+ *   in CompleteMultipartUpload — the AWS SDK serialises them correctly.
+ *
+ * Minimum part size:
+ *   AWS S3 requires each non-final part to be ≥ 5 MiB. TransferX's default
+ *   chunkSize (10 MiB) satisfies this. The engine enforces chunkSize ≥ 5 MiB
+ *   through config validation; this adapter does not re-validate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Adapter = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const core_1 = require("@transferx/core");
+// ── Adapter ───────────────────────────────────────────────────────────────────
+class S3Adapter {
+    /** @internal exposed as protected so R2Adapter can subclass. */
+    _client;
+    _bucket;
+    _timeoutMs;
+    _onLog;
+    constructor(opts) {
+        this._bucket = opts.bucket;
+        this._timeoutMs = opts.timeoutMs ?? 120_000;
+        this._onLog = opts.onLog;
+        if (opts.client) {
+            // Injected client — used in tests; skip constructing a real one.
+            this._client = opts.client;
+        }
+        else {
+            // Disable SDK-level retries — TransferX owns the retry loop.
+            const clientConfig = {
+                maxAttempts: 1,
+                region: opts.region ?? "us-east-1",
+                credentials: {
+                    accessKeyId: opts.credentials.accessKeyId,
+                    secretAccessKey: opts.credentials.secretAccessKey,
+                    // Conditionally include sessionToken — exactOptionalPropertyTypes safe.
+                    ...(opts.credentials.sessionToken !== undefined
+                        ? { sessionToken: opts.credentials.sessionToken }
+                        : {}),
+                },
+            };
+            // Only set endpoint / forcePathStyle when explicitly provided. Setting
+            // either to undefined would trigger AWS SDK default-resolution paths
+            // that conflict with some S3-compatible providers.
+            if (opts.endpoint !== undefined) {
+                clientConfig.endpoint = opts.endpoint;
+            }
+            if (opts.forcePathStyle === true) {
+                clientConfig.forcePathStyle = true;
+            }
+            this._client = new client_s3_1.S3Client(clientConfig);
+        }
+    }
+    // ── ITransferAdapter ───────────────────────────────────────────────────────
+    async initTransfer(session) {
+        const cmd = new client_s3_1.CreateMultipartUploadCommand({
+            Bucket: this._bucket,
+            Key: session.targetKey,
+            ContentType: session.file.mimeType || "application/octet-stream",
+        });
+        const output = await this._send(cmd, "initTransfer");
+        const uploadId = output.UploadId;
+        if (!uploadId) {
+            throw new core_1.TransferError("S3 CreateMultipartUpload did not return an UploadId", "serverError");
+        }
+        this._onLog?.("info", "[S3] Multipart upload initiated", {
+            sessionId: session.id,
+            uploadId,
+        });
+        return uploadId;
+    }
+    async uploadChunk(session, chunk, data, 
+    // sha256Hex intentionally unused: the engine handles local integrity checks.
+    // S3 computes its own ETag (MD5) for server-side integrity verification.
+    // Attaching ChecksumSHA256 would require coordinating ChecksumAlgorithm
+    // on both CreateMultipartUpload and UploadPart — a future enhancement.
+    _sha256Hex) {
+        if (!session.providerSessionId) {
+            throw new core_1.TransferError("providerSessionId is missing — initTransfer must be called first", "fatal");
+        }
+        // S3 part numbers are 1-based (range: 1–10,000).
+        const partNumber = chunk.index + 1;
+        const cmd = new client_s3_1.UploadPartCommand({
+            Bucket: this._bucket,
+            Key: session.targetKey,
+            UploadId: session.providerSessionId,
+            PartNumber: partNumber,
+            Body: data,
+        });
+        const output = await this._send(cmd, "uploadChunk", chunk.index);
+        const etag = output.ETag;
+        if (!etag) {
+            throw new core_1.TransferError(`S3 UploadPart for part ${partNumber} returned no ETag`, "serverError");
+        }
+        // Store ETag verbatim — AWS returns it with surrounding double-quotes
+        // (e.g. `"d8e8fca2dc0f896fd7cb4cb0031ba249"`).  CompleteMultipartUpload
+        // requires ETags in the same format, so we must NOT strip the quotes here.
+        return { providerToken: etag };
+    }
+    async completeTransfer(session, chunks) {
+        if (!session.providerSessionId) {
+            throw new core_1.TransferError("providerSessionId missing in completeTransfer", "fatal");
+        }
+        // S3 requires Parts sorted ascending by PartNumber; do so defensively even
+        // if the engine already delivers them in order.
+        const sortedParts = [...chunks]
+            .sort((a, b) => a.index - b.index)
+            .map((c) => ({
+            PartNumber: c.index + 1,
+            ETag: c.providerToken ?? "",
+        }));
+        const cmd = new client_s3_1.CompleteMultipartUploadCommand({
+            Bucket: this._bucket,
+            Key: session.targetKey,
+            UploadId: session.providerSessionId,
+            MultipartUpload: { Parts: sortedParts },
+        });
+        await this._send(cmd, "completeTransfer");
+        this._onLog?.("info", "[S3] Multipart upload completed", {
+            sessionId: session.id,
+            partCount: sortedParts.length,
+        });
+    }
+    async abortTransfer(session) {
+        if (!session.providerSessionId)
+            return;
+        try {
+            const cmd = new client_s3_1.AbortMultipartUploadCommand({
+                Bucket: this._bucket,
+                Key: session.targetKey,
+                UploadId: session.providerSessionId,
+            });
+            await this._send(cmd, "abortTransfer");
+        }
+        catch {
+            // Best-effort — swallow errors so cancel/fail never blocks the engine.
+        }
+    }
+    async getRemoteState(session) {
+        if (!session.providerSessionId) {
+            return { uploadedParts: [] };
+        }
+        const uploadedParts = [];
+        // S3 paginates ListParts via PartNumberMarker / NextPartNumberMarker.
+        // IsTruncated === true means there are more pages.
+        let partNumberMarker;
+        do {
+            const cmdInput = {
+                Bucket: this._bucket,
+                Key: session.targetKey,
+                UploadId: session.providerSessionId,
+                MaxParts: 1000,
+            };
+            if (partNumberMarker !== undefined) {
+                // ListPartsCommandInput.PartNumberMarker is typed as string in the
+                // AWS SDK even though S3's API uses an integer marker value.
+                cmdInput.PartNumberMarker = String(partNumberMarker);
+            }
+            const output = await this._send(new client_s3_1.ListPartsCommand(cmdInput), "getRemoteState");
+            for (const part of output.Parts ?? []) {
+                if (part.PartNumber != null && part.ETag) {
+                    uploadedParts.push({
+                        partNumber: part.PartNumber,
+                        providerToken: part.ETag,
+                    });
+                }
+            }
+            partNumberMarker =
+                output.IsTruncated === true && output.NextPartNumberMarker != null
+                    ? output.NextPartNumberMarker
+                    : undefined;
+        } while (partNumberMarker !== undefined);
+        return { uploadedParts };
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    /**
+     * Send an S3 command with a per-request AbortController timeout and unified
+     * error mapping.  The return type is cast to `T` — callers know the shape of
+     * each command's output.
+     *
+     * The `command` parameter is typed as `unknown` here because AWS SDK v3
+     * Command classes are generic and contravariant — assigning a specific
+     * `CreateMultipartUploadCommand` to `Command<ServiceInputTypes, ...>` fails
+     * TypeScript's structural check due to middlewareStack overloads.  Each call
+     * site already supplies the correctly-typed Command, so the cast is safe.
+     */
+    async _send(command, op, chunkIndex) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this._timeoutMs);
+        try {
+            return (await this._client.send(command, { abortSignal: controller.signal }));
+        }
+        catch (err) {
+            throw this._mapError(err, op, chunkIndex);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Normalise any error thrown by the AWS SDK into a typed TransferError so the
+     * engine can make correct retry/abort decisions.
+     */
+    _mapError(err, op, chunkIndex) {
+        // AbortController fired → request timed out.
+        if (err instanceof Error && err.name === "AbortError") {
+            return (0, core_1.networkError)(`[S3] ${op} timed out after ${this._timeoutMs}ms`, err, chunkIndex);
+        }
+        // AWS SDK v3 service exceptions carry $metadata.httpStatusCode.
+        // Duck-type to avoid importing the (internal) base exception class.
+        const sdkErr = err;
+        const status = sdkErr.$metadata?.httpStatusCode ?? 0;
+        const msg = err instanceof Error ? err.message : String(err);
+        const retryAfterHeader = sdkErr.$response?.headers?.["retry-after"];
+        if (status === 401 || status === 403) {
+            this._onLog?.("warn", `[S3] ${op} authorisation error (HTTP ${status})`, {
+                chunkIndex,
+            });
+            return (0, core_1.authError)(`S3 ${status}: ${msg}`);
+        }
+        if (status === 429) {
+            const retryAfterMs = retryAfterHeader
+                ? parseInt(retryAfterHeader, 10) * 1000
+                : undefined;
+            return (0, core_1.rateLimitError)(retryAfterMs);
+        }
+        if (status >= 500) {
+            return (0, core_1.serverError)(status, msg);
+        }
+        if (status >= 400) {
+            return (0, core_1.clientError)(status, msg);
+        }
+        // No HTTP status — treat as a transient network failure.
+        if (err instanceof Error) {
+            return (0, core_1.networkError)(`[S3] ${op} request failed: ${err.message}`, err, chunkIndex);
+        }
+        return new core_1.TransferError(String(err), "unknown", err, chunkIndex);
+    }
+}
+exports.S3Adapter = S3Adapter;
+//# sourceMappingURL=S3Adapter.js.map

package/dist/S3Adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { S3Adapter } from "./S3Adapter.js";
+export type { S3AdapterOptions } from "./S3Adapter.js";
+export { R2Adapter } from "./R2Adapter.js";
+export type { R2AdapterOptions } from "./R2Adapter.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,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R2Adapter = exports.S3Adapter = void 0;
+var S3Adapter_js_1 = require("./S3Adapter.js");
+Object.defineProperty(exports, "S3Adapter", { enumerable: true, get: function () { return S3Adapter_js_1.S3Adapter; } });
+var R2Adapter_js_1 = require("./R2Adapter.js");
+Object.defineProperty(exports, "R2Adapter", { enumerable: true, get: function () { return R2Adapter_js_1.R2Adapter; } });
+//# 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,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAGlB,+CAA2C;AAAlC,yGAAA,SAAS,OAAA"}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@transferx/adapter-s3",
+  "version": "0.1.0",
+  "description": "TransferX adapters for AWS S3 and Cloudflare R2 multipart uploads",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@transferx/core": "0.1.0"
+  }
+}