@procedures/s3 0.0.0-stage → 0.1.0

package/dist/procedures/s3/list.d.ts

@@ -0,0 +1,28 @@
+/**
+ * s3.list procedure
+ *
+ * List objects in S3 bucket.
+ */
+import type { S3ListInput, S3ListOutput } from "../../types.js";
+/**
+ * List objects in S3 bucket
+ *
+ * @example
+ * // List all objects with prefix
+ * const result = await client.call(["s3", "list"], {
+ *   bucket: "my-bucket",
+ *   prefix: "snapshots/",
+ *   maxKeys: 100,
+ * });
+ *
+ * @example
+ * // Hierarchical listing with delimiter
+ * const result = await client.call(["s3", "list"], {
+ *   bucket: "my-bucket",
+ *   prefix: "data/",
+ *   delimiter: "/",
+ * });
+ * console.log(result.commonPrefixes); // ["data/2024/", "data/2025/"]
+ */
+export declare function s3List(input: S3ListInput): Promise<S3ListOutput>;
+//# sourceMappingURL=list.d.ts.map

package/dist/procedures/s3/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAgCtE"}

package/dist/procedures/s3/list.js

@@ -0,0 +1,56 @@
+/**
+ * s3.list procedure
+ *
+ * List objects in S3 bucket.
+ */
+import { ListObjectsV2Command } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * List objects in S3 bucket
+ *
+ * @example
+ * // List all objects with prefix
+ * const result = await client.call(["s3", "list"], {
+ *   bucket: "my-bucket",
+ *   prefix: "snapshots/",
+ *   maxKeys: 100,
+ * });
+ *
+ * @example
+ * // Hierarchical listing with delimiter
+ * const result = await client.call(["s3", "list"], {
+ *   bucket: "my-bucket",
+ *   prefix: "data/",
+ *   delimiter: "/",
+ * });
+ * console.log(result.commonPrefixes); // ["data/2024/", "data/2025/"]
+ */
+export async function s3List(input) {
+    const client = getS3Client();
+    const command = new ListObjectsV2Command({
+        Bucket: input.bucket,
+        Prefix: input.prefix,
+        MaxKeys: input.maxKeys || 1000,
+        ContinuationToken: input.continuationToken,
+        Delimiter: input.delimiter,
+    });
+    const response = await client.send(command);
+    const contents = (response.Contents || []).map((obj) => ({
+        key: obj.Key || "",
+        size: obj.Size || 0,
+        lastModified: obj.LastModified?.toISOString() || "",
+        etag: obj.ETag?.replace(/"/g, "") || "",
+        storageClass: obj.StorageClass,
+    }));
+    const commonPrefixes = (response.CommonPrefixes || [])
+        .map((cp) => cp.Prefix || "")
+        .filter(Boolean);
+    return {
+        contents,
+        commonPrefixes,
+        isTruncated: response.IsTruncated || false,
+        nextContinuationToken: response.NextContinuationToken,
+        keyCount: response.KeyCount || contents.length,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/procedures/s3/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/procedures/s3/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAkB;IAC7C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC;QACvC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAmB,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;QACnB,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE;QACnD,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QACvC,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B,CAAC,CAAC,CAAC;IAEJ,MAAM,cAAc,GAAG,CAAC,QAAQ,CAAC,cAAc,IAAI,EAAE,CAAC;SACnD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,OAAO;QACL,QAAQ;QACR,cAAc;QACd,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,KAAK;QAC1C,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;QACrD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM;KAC/C,CAAC;AACJ,CAAC"}

package/dist/procedures/s3/multipart-abort.d.ts

@@ -0,0 +1,21 @@
+/**
+ * s3.multipart.abort procedure
+ *
+ * Abort a multipart upload and clean up parts.
+ */
+import type { S3MultipartAbortInput, S3MultipartAbortOutput } from "../../types.js";
+/**
+ * Abort multipart upload
+ *
+ * Use to cancel an in-progress multipart upload.
+ * This cleans up any parts that were already uploaded.
+ *
+ * @example
+ * await client.call(["s3", "multipart", "abort"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   uploadId: "abc123",
+ * });
+ */
+export declare function s3MultipartAbort(input: S3MultipartAbortInput): Promise<S3MultipartAbortOutput>;
+//# sourceMappingURL=multipart-abort.d.ts.map

package/dist/procedures/s3/multipart-abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-abort.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-abort.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/procedures/s3/multipart-abort.js

@@ -0,0 +1,33 @@
+/**
+ * s3.multipart.abort procedure
+ *
+ * Abort a multipart upload and clean up parts.
+ */
+import { AbortMultipartUploadCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * Abort multipart upload
+ *
+ * Use to cancel an in-progress multipart upload.
+ * This cleans up any parts that were already uploaded.
+ *
+ * @example
+ * await client.call(["s3", "multipart", "abort"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   uploadId: "abc123",
+ * });
+ */
+export async function s3MultipartAbort(input) {
+    const client = getS3Client();
+    const command = new AbortMultipartUploadCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        UploadId: input.uploadId,
+    });
+    await client.send(command);
+    return {
+        aborted: true,
+    };
+}
+//# sourceMappingURL=multipart-abort.js.map

package/dist/procedures/s3/multipart-abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-abort.js","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-abort.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA4B;IAE5B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,2BAA2B,CAAC;QAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3B,OAAO;QACL,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/procedures/s3/multipart-complete.d.ts

@@ -0,0 +1,26 @@
+/**
+ * s3.multipart.complete procedure
+ *
+ * Complete a multipart upload by assembling parts.
+ */
+import type { S3MultipartCompleteInput, S3MultipartCompleteOutput } from "../../types.js";
+/**
+ * Complete multipart upload
+ *
+ * Call after all parts have been uploaded. Parts must be provided
+ * in order with their ETags from the upload responses.
+ *
+ * @example
+ * const result = await client.call(["s3", "multipart", "complete"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   uploadId: "abc123",
+ *   parts: [
+ *     { partNumber: 1, etag: "etag1" },
+ *     { partNumber: 2, etag: "etag2" },
+ *     { partNumber: 3, etag: "etag3" },
+ *   ],
+ * });
+ */
+export declare function s3MultipartComplete(input: S3MultipartCompleteInput): Promise<S3MultipartCompleteOutput>;
+//# sourceMappingURL=multipart-complete.d.ts.map

package/dist/procedures/s3/multipart-complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-complete.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE1F;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CA2BpC"}

package/dist/procedures/s3/multipart-complete.js

@@ -0,0 +1,51 @@
+/**
+ * s3.multipart.complete procedure
+ *
+ * Complete a multipart upload by assembling parts.
+ */
+import { CompleteMultipartUploadCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * Complete multipart upload
+ *
+ * Call after all parts have been uploaded. Parts must be provided
+ * in order with their ETags from the upload responses.
+ *
+ * @example
+ * const result = await client.call(["s3", "multipart", "complete"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   uploadId: "abc123",
+ *   parts: [
+ *     { partNumber: 1, etag: "etag1" },
+ *     { partNumber: 2, etag: "etag2" },
+ *     { partNumber: 3, etag: "etag3" },
+ *   ],
+ * });
+ */
+export async function s3MultipartComplete(input) {
+    const client = getS3Client();
+    const command = new CompleteMultipartUploadCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        UploadId: input.uploadId,
+        MultipartUpload: {
+            // S3 refuses parts out of order. Parts that were uploaded in parallel can arrive in any
+            // order, so the procedure sorts them by number.
+            Parts: [...input.parts]
+                .sort((a, b) => a.partNumber - b.partNumber)
+                .map((part) => ({
+                ETag: `"${part.etag}"`,
+                PartNumber: part.partNumber,
+            })),
+        },
+    });
+    const response = await client.send(command);
+    return {
+        location: response.Location || `s3://${input.bucket}/${input.key}`,
+        bucket: response.Bucket || input.bucket,
+        key: response.Key || input.key,
+        etag: response.ETag?.replace(/"/g, "") || "",
+    };
+}
+//# sourceMappingURL=multipart-complete.js.map

package/dist/procedures/s3/multipart-complete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-complete.js","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA+B;IAE/B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,8BAA8B,CAAC;QACjD,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,eAAe,EAAE;YACf,wFAAwF;YACxF,gDAAgD;YAChD,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;iBACpB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;iBAC3C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACd,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG;gBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;SACN;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE;QAClE,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;QACvC,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG;QAC9B,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;KAC7C,CAAC;AACJ,CAAC"}

package/dist/procedures/s3/multipart-init.d.ts

@@ -0,0 +1,24 @@
+/**
+ * s3.multipart.init procedure
+ *
+ * Initialize a multipart upload for large files.
+ */
+import type { S3MultipartInitInput, S3MultipartInitOutput } from "../../types.js";
+/**
+ * Initialize multipart upload
+ *
+ * Use this for files larger than 5MB. Workflow:
+ * 1. s3.multipart.init - get uploadId
+ * 2. s3.multipart.upload - upload each part (5MB min, except last)
+ * 3. s3.multipart.complete - finalize with part ETags
+ *
+ * @example
+ * const init = await client.call(["s3", "multipart", "init"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   contentType: "application/gzip",
+ * });
+ * console.log(init.uploadId); // Use for subsequent part uploads
+ */
+export declare function s3MultipartInit(input: S3MultipartInitInput): Promise<S3MultipartInitOutput>;
+//# sourceMappingURL=multipart-init.d.ts.map

package/dist/procedures/s3/multipart-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-init.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAElF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAqBhC"}

package/dist/procedures/s3/multipart-init.js

@@ -0,0 +1,42 @@
+/**
+ * s3.multipart.init procedure
+ *
+ * Initialize a multipart upload for large files.
+ */
+import { CreateMultipartUploadCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * Initialize multipart upload
+ *
+ * Use this for files larger than 5MB. Workflow:
+ * 1. s3.multipart.init - get uploadId
+ * 2. s3.multipart.upload - upload each part (5MB min, except last)
+ * 3. s3.multipart.complete - finalize with part ETags
+ *
+ * @example
+ * const init = await client.call(["s3", "multipart", "init"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   contentType: "application/gzip",
+ * });
+ * console.log(init.uploadId); // Use for subsequent part uploads
+ */
+export async function s3MultipartInit(input) {
+    const client = getS3Client();
+    const command = new CreateMultipartUploadCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        ContentType: input.contentType,
+        Metadata: input.metadata,
+    });
+    const response = await client.send(command);
+    if (!response.UploadId) {
+        throw new Error("Failed to initialize multipart upload: no UploadId returned");
+    }
+    return {
+        uploadId: response.UploadId,
+        bucket: input.bucket,
+        key: input.key,
+    };
+}
+//# sourceMappingURL=multipart-init.js.map

package/dist/procedures/s3/multipart-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-init.js","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2B;IAE3B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,4BAA4B,CAAC;QAC/C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/procedures/s3/multipart-upload.d.ts

@@ -0,0 +1,24 @@
+/**
+ * s3.multipart.upload procedure
+ *
+ * Upload a part in a multipart upload.
+ */
+import type { S3MultipartUploadInput, S3MultipartUploadOutput } from "../../types.js";
+/**
+ * Upload a single part in multipart upload
+ *
+ * Parts must be at least 5MB (except the last part).
+ * Part numbers range from 1 to 10000.
+ *
+ * @example
+ * const part1 = await client.call(["s3", "multipart", "upload"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   uploadId: "abc123",
+ *   partNumber: 1,
+ *   body: base64EncodedChunk1,
+ * });
+ * // Store part1.etag for complete call
+ */
+export declare function s3MultipartUpload(input: S3MultipartUploadInput): Promise<S3MultipartUploadOutput>;
+//# sourceMappingURL=multipart-upload.d.ts.map

package/dist/procedures/s3/multipart-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-upload.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEtF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAwBlC"}

package/dist/procedures/s3/multipart-upload.js

@@ -0,0 +1,44 @@
+/**
+ * s3.multipart.upload procedure
+ *
+ * Upload a part in a multipart upload.
+ */
+import { UploadPartCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * Upload a single part in multipart upload
+ *
+ * Parts must be at least 5MB (except the last part).
+ * Part numbers range from 1 to 10000.
+ *
+ * @example
+ * const part1 = await client.call(["s3", "multipart", "upload"], {
+ *   bucket: "my-bucket",
+ *   key: "large-file.tar.gz",
+ *   uploadId: "abc123",
+ *   partNumber: 1,
+ *   body: base64EncodedChunk1,
+ * });
+ * // Store part1.etag for complete call
+ */
+export async function s3MultipartUpload(input) {
+    const client = getS3Client();
+    // Body is always base64 encoded for multipart
+    const body = Buffer.from(input.body, "base64");
+    const command = new UploadPartCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        UploadId: input.uploadId,
+        PartNumber: input.partNumber,
+        Body: body,
+    });
+    const response = await client.send(command);
+    if (!response.ETag) {
+        throw new Error(`Failed to upload part ${input.partNumber}: no ETag returned`);
+    }
+    return {
+        etag: response.ETag.replace(/"/g, ""),
+        partNumber: input.partNumber,
+    };
+}
+//# sourceMappingURL=multipart-upload.js.map

package/dist/procedures/s3/multipart-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-upload.js","sourceRoot":"","sources":["../../../src/procedures/s3/multipart-upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAA6B;IAE7B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,8CAA8C;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC;QACpC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,UAAU,oBAAoB,CAAC,CAAC;IACjF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/dist/procedures/s3/upload.d.ts

@@ -0,0 +1,30 @@
+/**
+ * s3.upload procedure
+ *
+ * Upload content to S3 bucket.
+ */
+import type { S3UploadInput, S3UploadOutput } from "../../types.js";
+/**
+ * Upload content to S3
+ *
+ * @example
+ * // Upload text content
+ * await client.call(["s3", "upload"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ *   body: JSON.stringify({ data: "value" }),
+ *   contentType: "application/json",
+ * });
+ *
+ * @example
+ * // Upload base64 binary
+ * await client.call(["s3", "upload"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/image.png",
+ *   body: base64EncodedData,
+ *   base64: true,
+ *   contentType: "image/png",
+ * });
+ */
+export declare function s3Upload(input: S3UploadInput): Promise<S3UploadOutput>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/procedures/s3/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB5E"}

package/dist/procedures/s3/upload.js

@@ -0,0 +1,50 @@
+/**
+ * s3.upload procedure
+ *
+ * Upload content to S3 bucket.
+ */
+import { PutObjectCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * Upload content to S3
+ *
+ * @example
+ * // Upload text content
+ * await client.call(["s3", "upload"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ *   body: JSON.stringify({ data: "value" }),
+ *   contentType: "application/json",
+ * });
+ *
+ * @example
+ * // Upload base64 binary
+ * await client.call(["s3", "upload"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/image.png",
+ *   body: base64EncodedData,
+ *   base64: true,
+ *   contentType: "image/png",
+ * });
+ */
+export async function s3Upload(input) {
+    const client = getS3Client();
+    // Convert body to Buffer if base64
+    const body = input.base64
+        ? Buffer.from(input.body, "base64")
+        : input.body;
+    const command = new PutObjectCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        Body: body,
+        ContentType: input.contentType,
+        Metadata: input.metadata,
+    });
+    const response = await client.send(command);
+    return {
+        etag: response.ETag?.replace(/"/g, "") || "",
+        versionId: response.VersionId,
+        location: `s3://${input.bucket}/${input.key}`,
+    };
+}
+//# sourceMappingURL=upload.js.map

package/dist/procedures/s3/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/procedures/s3/upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB;IACjD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,mCAAmC;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM;QACvB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;QACnC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAEf,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACnC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QAC5C,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @procedures/s3 in the global registry
+ * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
+ * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ */
+export * from "./module.js";
+export declare function registerS3Procedures(): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,aAAa,CAAC;AAE5B,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/register.js

@@ -0,0 +1,14 @@
+/**
+ * Importing this file registers the procedures of @procedures/s3 in the global registry
+ * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
+ * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ */
+import { registerProcedures } from "@procedures/client";
+import { s3Module } from "./module.js";
+export * from "./module.js";
+export function registerS3Procedures() {
+    registerProcedures(s3Module.procedures);
+}
+// Auto-register when this module is loaded
+registerS3Procedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,oBAAoB;IAClC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,2CAA2C;AAC3C,oBAAoB,EAAE,CAAC"}

package/dist/s3-client.d.ts

@@ -0,0 +1,38 @@
+/**
+ * S3 Client Factory
+ *
+ * Creates an S3 client. Static credentials are read from environment variables
+ * when present; otherwise the AWS SDK's default credential provider chain
+ * (SSO, IAM roles/IMDS, shared config profiles, env, etc.) resolves them.
+ * NEVER hardcode credentials - always use environment variables or an IAM role.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import type { S3Config } from "./types.js";
+/**
+ * Get S3 configuration from environment variables.
+ *
+ * Static credentials are optional: when `AWS_ACCESS_KEY_ID` /
+ * `AWS_SECRET_ACCESS_KEY` are absent, the returned config carries no
+ * credentials and the AWS SDK default provider chain is used instead.
+ * `AWS_SESSION_TOKEN` is included when present (STS/SSO temporary creds).
+ */
+export declare function getS3Config(): S3Config;
+/**
+ * Create an S3 client.
+ *
+ * Explicit credentials are passed ONLY when both `AWS_ACCESS_KEY_ID` and
+ * `AWS_SECRET_ACCESS_KEY` are set (including `AWS_SESSION_TOKEN` when present).
+ * Otherwise `credentials` is omitted so the AWS SDK default credential
+ * provider chain resolves SSO / IAM-role / profile credentials.
+ */
+export declare function createS3Client(): S3Client;
+/**
+ * Get singleton S3 client instance
+ * Creates client on first call, reuses on subsequent calls
+ */
+export declare function getS3Client(): S3Client;
+/**
+ * Reset the singleton client (useful for testing or credential refresh)
+ */
+export declare function resetS3Client(): void;
+//# sourceMappingURL=s3-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"s3-client.d.ts","sourceRoot":"","sources":["../src/s3-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CActC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAyBzC;AAKD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/s3-client.js

@@ -0,0 +1,83 @@
+/**
+ * S3 Client Factory
+ *
+ * Creates an S3 client. Static credentials are read from environment variables
+ * when present; otherwise the AWS SDK's default credential provider chain
+ * (SSO, IAM roles/IMDS, shared config profiles, env, etc.) resolves them.
+ * NEVER hardcode credentials - always use environment variables or an IAM role.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+/**
+ * Get S3 configuration from environment variables.
+ *
+ * Static credentials are optional: when `AWS_ACCESS_KEY_ID` /
+ * `AWS_SECRET_ACCESS_KEY` are absent, the returned config carries no
+ * credentials and the AWS SDK default provider chain is used instead.
+ * `AWS_SESSION_TOKEN` is included when present (STS/SSO temporary creds).
+ */
+export function getS3Config() {
+    const accessKeyId = process.env["AWS_ACCESS_KEY_ID"];
+    const secretAccessKey = process.env["AWS_SECRET_ACCESS_KEY"];
+    const sessionToken = process.env["AWS_SESSION_TOKEN"];
+    const region = process.env["AWS_REGION"] || "us-east-1";
+    const endpoint = process.env["S3_ENDPOINT"];
+    return {
+        region,
+        endpoint,
+        accessKeyId,
+        secretAccessKey,
+        sessionToken,
+    };
+}
+/**
+ * Create an S3 client.
+ *
+ * Explicit credentials are passed ONLY when both `AWS_ACCESS_KEY_ID` and
+ * `AWS_SECRET_ACCESS_KEY` are set (including `AWS_SESSION_TOKEN` when present).
+ * Otherwise `credentials` is omitted so the AWS SDK default credential
+ * provider chain resolves SSO / IAM-role / profile credentials.
+ */
+export function createS3Client() {
+    const config = getS3Config();
+    const clientConfig = {
+        region: config.region,
+    };
+    // Only supply static credentials when the env keys actually exist; otherwise
+    // let the SDK resolve credentials from its default chain (SSO/IMDS/profile).
+    if (config.accessKeyId && config.secretAccessKey) {
+        clientConfig.credentials = {
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
+            // Session token is required for STS/SSO temporary credentials.
+            ...(config.sessionToken ? { sessionToken: config.sessionToken } : {}),
+        };
+    }
+    // Custom endpoint for MinIO, LocalStack, etc.
+    if (config.endpoint) {
+        clientConfig.endpoint = config.endpoint;
+        clientConfig.forcePathStyle = true; // Required for non-AWS S3
+    }
+    return new S3Client(clientConfig);
+}
+// Singleton client instance (lazy initialized)
+let s3ClientInstance = null;
+/**
+ * Get singleton S3 client instance
+ * Creates client on first call, reuses on subsequent calls
+ */
+export function getS3Client() {
+    if (!s3ClientInstance) {
+        s3ClientInstance = createS3Client();
+    }
+    return s3ClientInstance;
+}
+/**
+ * Reset the singleton client (useful for testing or credential refresh)
+ */
+export function resetS3Client() {
+    if (s3ClientInstance) {
+        s3ClientInstance.destroy();
+        s3ClientInstance = null;
+    }
+}
+//# sourceMappingURL=s3-client.js.map

package/dist/s3-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-client.js","sourceRoot":"","sources":["../src/s3-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAE5C,OAAO;QACL,MAAM;QACN,QAAQ;QACR,WAAW;QACX,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,MAAM,YAAY,GAA8C;QAC9D,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IAEF,6EAA6E;IAC7E,6EAA6E;IAC7E,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACjD,YAAY,CAAC,WAAW,GAAG;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,+DAA+D;YAC/D,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACxC,YAAY,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,0BAA0B;IAChE,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,+CAA+C;AAC/C,IAAI,gBAAgB,GAAoB,IAAI,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,cAAc,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,gBAAgB,EAAE,CAAC;QACrB,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC3B,gBAAgB,GAAG,IAAI,CAAC;IAC1B,CAAC;AACH,CAAC"}