@procedures/s3 0.0.0-stage → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * client-s3 - AWS S3 procedures for the client ecosystem
+ *
+ * Provides upload, download, list, delete, and multipart upload operations.
+ * Credentials are loaded from environment variables (all optional — when the
+ * static keys are absent the AWS SDK default credential provider chain is used):
+ * - AWS_ACCESS_KEY_ID (optional; pair with AWS_SECRET_ACCESS_KEY)
+ * - AWS_SECRET_ACCESS_KEY (optional)
+ * - AWS_SESSION_TOKEN (optional, for STS/SSO temporary credentials)
+ * - AWS_REGION (optional, defaults to us-east-1)
+ * - S3_ENDPOINT (optional, for MinIO/LocalStack)
+ */
+export * from "./module.js";
+export type { S3Config, S3UploadInput, S3UploadOutput, S3DownloadInput, S3DownloadOutput, S3ListInput, S3ListOutput, S3ListObject, S3ListAllInput, S3ListAllOutput, S3DeleteInput, S3DeleteOutput, S3MultipartInitInput, S3MultipartInitOutput, S3MultipartUploadInput, S3MultipartUploadOutput, S3MultipartCompleteInput, S3MultipartCompleteOutput, S3MultipartAbortInput, S3MultipartAbortOutput, } from "./types.js";
+export { S3UploadInputSchema, S3DownloadInputSchema, S3ListInputSchema, S3ListAllInputSchema, S3DeleteInputSchema, S3MultipartInitInputSchema, S3MultipartUploadInputSchema, S3MultipartCompleteInputSchema, S3MultipartAbortInputSchema, } from "./types.js";
+export { getS3Config, createS3Client, getS3Client, resetS3Client, } from "./s3-client.js";
+export { s3Upload, s3Download, s3List, s3ListAll, s3Delete, s3MultipartInit, s3MultipartUpload, s3MultipartComplete, s3MultipartAbort, } from "./procedures/s3/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * client-s3 - AWS S3 procedures for the client ecosystem
+ *
+ * Provides upload, download, list, delete, and multipart upload operations.
+ * Credentials are loaded from environment variables (all optional — when the
+ * static keys are absent the AWS SDK default credential provider chain is used):
+ * - AWS_ACCESS_KEY_ID (optional; pair with AWS_SECRET_ACCESS_KEY)
+ * - AWS_SECRET_ACCESS_KEY (optional)
+ * - AWS_SESSION_TOKEN (optional, for STS/SSO temporary credentials)
+ * - AWS_REGION (optional, defaults to us-east-1)
+ * - S3_ENDPOINT (optional, for MinIO/LocalStack)
+ */
+export * from "./module.js";
+// Re-export schemas for external use
+export { S3UploadInputSchema, S3DownloadInputSchema, S3ListInputSchema, S3ListAllInputSchema, S3DeleteInputSchema, S3MultipartInitInputSchema, S3MultipartUploadInputSchema, S3MultipartCompleteInputSchema, S3MultipartAbortInputSchema, } from "./types.js";
+// Re-export S3 client utilities
+export { getS3Config, createS3Client, getS3Client, resetS3Client, } from "./s3-client.js";
+// Re-export procedure implementations for direct use
+export { s3Upload, s3Download, s3List, s3ListAll, s3Delete, s3MultipartInit, s3MultipartUpload, s3MultipartComplete, s3MultipartAbort, } from "./procedures/s3/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,aAAa,CAAC;AA0B5B,qCAAqC;AACrC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,gCAAgC;AAChC,OAAO,EACL,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,qDAAqD;AACrD,OAAO,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for S3 operations
+ *
+ * Provides s3.upload, s3.download, s3.list, s3.delete, and s3.multipart.* procedures.
+ * Credentials are loaded from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY).
+ */
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export declare const s3Module: ProcedureModule;
+export default s3Module;
+/**
+ * This function registers the procedures of @procedures/s3, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export declare function registerS3Procedures(registry?: ProcedureRegistry): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA6C,KAAK,eAAe,EAAuC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuMlK;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAUnB,CAAC;eAEU,QAAQ;AAEvB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE3F"}

package/dist/module.js

@@ -0,0 +1,173 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for S3 operations
+ *
+ * Provides s3.upload, s3.download, s3.list, s3.delete, and s3.multipart.* procedures.
+ * Credentials are loaded from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY).
+ */
+import { createProcedure, zodAdapter, defineModule, PROCEDURE_REGISTRY, registerModules } from "@procedures/client";
+import { s3Upload, s3Download, s3List, s3ListAll, s3Delete, s3MultipartInit, s3MultipartUpload, s3MultipartComplete, s3MultipartAbort, } from "./procedures/s3/index.js";
+import { S3UploadInputSchema, S3DownloadInputSchema, S3ListInputSchema, S3ListAllInputSchema, S3DeleteInputSchema, S3MultipartInitInputSchema, S3MultipartUploadInputSchema, S3MultipartCompleteInputSchema, S3MultipartAbortInputSchema, S3UploadOutputSchema, S3DownloadOutputSchema, S3ListOutputSchema, S3ListAllOutputSchema, S3DeleteOutputSchema, S3MultipartInitOutputSchema, S3MultipartUploadOutputSchema, S3MultipartCompleteOutputSchema, S3MultipartAbortOutputSchema, } from "./types.js";
+// =============================================================================
+// Procedures
+// =============================================================================
+const s3UploadProcedure = createProcedure()
+    .path(["s3", "upload"])
+    .input(zodAdapter(S3UploadInputSchema))
+    .output(zodAdapter(S3UploadOutputSchema))
+    .meta({
+    description: "Upload content to S3 bucket",
+    // A put replaces the object of an existing key
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"] },
+    shorts: { bucket: "b", key: "k" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3Upload(input);
+})
+    .build();
+const s3DownloadProcedure = createProcedure()
+    .path(["s3", "download"])
+    .input(zodAdapter(S3DownloadInputSchema))
+    .output(zodAdapter(S3DownloadOutputSchema))
+    .meta({
+    description: "Download content from S3 bucket",
+    // With destPath, it replaces the file at that path
+    effects: { reads: ["s3", "network"], writes: ["fs"], idempotent: true },
+    shorts: { bucket: "b", key: "k", encoding: "e" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3Download(input);
+})
+    .build();
+const s3ListProcedure = createProcedure()
+    .path(["s3", "list"])
+    .input(zodAdapter(S3ListInputSchema))
+    .output(zodAdapter(S3ListOutputSchema))
+    .meta({
+    description: "List objects in S3 bucket",
+    effects: { reads: ["s3", "network"], writes: [] },
+    shorts: { bucket: "b", prefix: "p", maxKeys: "n" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3List(input);
+})
+    .build();
+const s3ListAllProcedure = createProcedure()
+    .path(["s3", "listAll"])
+    .input(zodAdapter(S3ListAllInputSchema))
+    .output(zodAdapter(S3ListAllOutputSchema))
+    .meta({
+    description: "List ALL objects in S3 bucket, following continuation tokens (unbounded by 1000)",
+    effects: { reads: ["s3", "network"], writes: [] },
+    shorts: { bucket: "b", prefix: "p", maxKeys: "n" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3ListAll(input);
+})
+    .build();
+const s3DeleteProcedure = createProcedure()
+    .path(["s3", "delete"])
+    .input(zodAdapter(S3DeleteInputSchema))
+    .output(zodAdapter(S3DeleteOutputSchema))
+    .meta({
+    description: "Delete object from S3 bucket",
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"] },
+    shorts: { bucket: "b", key: "k" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3Delete(input);
+})
+    .build();
+const s3MultipartInitProcedure = createProcedure()
+    .path(["s3", "multipart", "init"])
+    .input(zodAdapter(S3MultipartInitInputSchema))
+    .output(zodAdapter(S3MultipartInitOutputSchema))
+    .meta({
+    description: "Initialize multipart upload for large files",
+    // It starts a new upload: the object of the key does not change before the completion
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"], destructive: false },
+    shorts: { bucket: "b", key: "k" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3MultipartInit(input);
+})
+    .build();
+const s3MultipartUploadProcedure = createProcedure()
+    .path(["s3", "multipart", "upload"])
+    .input(zodAdapter(S3MultipartUploadInputSchema))
+    .output(zodAdapter(S3MultipartUploadOutputSchema))
+    .meta({
+    description: "Upload a part in multipart upload",
+    // A part replaces the earlier part with the same number
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"], idempotent: true },
+    shorts: { bucket: "b", key: "k", partNumber: "n" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3MultipartUpload(input);
+})
+    .build();
+const s3MultipartCompleteProcedure = createProcedure()
+    .path(["s3", "multipart", "complete"])
+    .input(zodAdapter(S3MultipartCompleteInputSchema))
+    .output(zodAdapter(S3MultipartCompleteOutputSchema))
+    .meta({
+    description: "Complete multipart upload by assembling parts",
+    // The assembled object replaces the object of an existing key
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"] },
+    shorts: { bucket: "b", key: "k" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3MultipartComplete(input);
+})
+    .build();
+const s3MultipartAbortProcedure = createProcedure()
+    .path(["s3", "multipart", "abort"])
+    .input(zodAdapter(S3MultipartAbortInputSchema))
+    .output(zodAdapter(S3MultipartAbortOutputSchema))
+    .meta({
+    description: "Abort multipart upload and clean up parts",
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"] },
+    shorts: { bucket: "b", key: "k" },
+    output: "json",
+})
+    .handler(async (input) => {
+    return s3MultipartAbort(input);
+})
+    .build();
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const s3Module = defineModule("@procedures/s3", [
+    s3UploadProcedure,
+    s3DownloadProcedure,
+    s3ListProcedure,
+    s3ListAllProcedure,
+    s3DeleteProcedure,
+    s3MultipartInitProcedure,
+    s3MultipartUploadProcedure,
+    s3MultipartCompleteProcedure,
+    s3MultipartAbortProcedure,
+]);
+export default s3Module;
+/**
+ * This function registers the procedures of @procedures/s3, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export function registerS3Procedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [s3Module]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * s3.delete procedure
+ *
+ * Delete object from S3 bucket.
+ */
+import type { S3DeleteInput, S3DeleteOutput } from "../../types.js";
+/**
+ * Delete object from S3
+ *
+ * @example
+ * // Delete an object
+ * await client.call(["s3", "delete"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ * });
+ *
+ * @example
+ * // Delete specific version
+ * await client.call(["s3", "delete"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ *   versionId: "abc123",
+ * });
+ */
+export declare function s3Delete(input: S3DeleteInput): Promise<S3DeleteOutput>;
+//# sourceMappingURL=delete.d.ts.map

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

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

package/dist/procedures/s3/delete.js

@@ -0,0 +1,40 @@
+/**
+ * s3.delete procedure
+ *
+ * Delete object from S3 bucket.
+ */
+import { DeleteObjectCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/**
+ * Delete object from S3
+ *
+ * @example
+ * // Delete an object
+ * await client.call(["s3", "delete"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ * });
+ *
+ * @example
+ * // Delete specific version
+ * await client.call(["s3", "delete"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ *   versionId: "abc123",
+ * });
+ */
+export async function s3Delete(input) {
+    const client = getS3Client();
+    const command = new DeleteObjectCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        VersionId: input.versionId,
+    });
+    const response = await client.send(command);
+    return {
+        deleted: true,
+        deleteMarker: response.DeleteMarker,
+        versionId: response.VersionId,
+    };
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/procedures/s3/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB;IACjD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * s3.download procedure
+ *
+ * Download content from S3 bucket.
+ */
+import type { S3DownloadInput, S3DownloadOutput } from "../../types.js";
+/**
+ * Download content from S3
+ *
+ * @example
+ * // Download text file
+ * const result = await client.call(["s3", "download"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ *   encoding: "utf8",
+ * });
+ * console.log(result.body); // JSON string
+ *
+ * @example
+ * // Download binary as base64
+ * const result = await client.call(["s3", "download"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/image.png",
+ * });
+ * console.log(result.body); // base64 encoded
+ *
+ * @example
+ * // Download a large object straight to a file
+ * await client.call(["s3", "download"], {
+ *   bucket: "my-bucket",
+ *   key: "backups/archive.tar.gz",
+ *   destPath: "/tmp/archive.tar.gz",
+ * });
+ */
+export declare function s3Download(input: S3DownloadInput): Promise<S3DownloadOutput>;
+//# sourceMappingURL=download.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/download.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA6CxE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoElF"}

package/dist/procedures/s3/download.js

@@ -0,0 +1,143 @@
+/**
+ * s3.download procedure
+ *
+ * Download content from S3 bucket.
+ */
+import { randomUUID } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import { rename, rm } from "node:fs/promises";
+import { Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { GetObjectCommand } from "@aws-sdk/client-s3";
+import { getS3Client } from "../../s3-client.js";
+/** Largest object loaded into memory by default (the base64 body is a third larger again) */
+const DEFAULT_MAX_BYTES = 64 * 1024 * 1024;
+function tooLarge(bytes, maxBytes) {
+    return new Error(`Object is ${bytes} bytes, more than maxBytes (${maxBytes}). Use destPath to download it to a file.`);
+}
+/** A stream step that counts the bytes and fails past `maxBytes`. */
+function byteLimit(maxBytes) {
+    let total = 0;
+    return new Transform({
+        transform(chunk, _encoding, callback) {
+            total += chunk.length;
+            if (total > maxBytes) {
+                callback(tooLarge(`more than ${maxBytes}`, maxBytes));
+                return;
+            }
+            callback(null, chunk);
+        },
+    });
+}
+/**
+ * Read a body into memory, counting the bytes. `Content-Length` can be missing or wrong, so the
+ * count is the limit (deep dive DATA-14).
+ */
+async function readLimited(body, maxBytes) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of body) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        total += buffer.length;
+        if (total > maxBytes) {
+            body.destroy();
+            throw tooLarge(`more than ${maxBytes}`, maxBytes);
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * Download content from S3
+ *
+ * @example
+ * // Download text file
+ * const result = await client.call(["s3", "download"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/file.json",
+ *   encoding: "utf8",
+ * });
+ * console.log(result.body); // JSON string
+ *
+ * @example
+ * // Download binary as base64
+ * const result = await client.call(["s3", "download"], {
+ *   bucket: "my-bucket",
+ *   key: "path/to/image.png",
+ * });
+ * console.log(result.body); // base64 encoded
+ *
+ * @example
+ * // Download a large object straight to a file
+ * await client.call(["s3", "download"], {
+ *   bucket: "my-bucket",
+ *   key: "backups/archive.tar.gz",
+ *   destPath: "/tmp/archive.tar.gz",
+ * });
+ */
+export async function s3Download(input) {
+    const client = getS3Client();
+    const command = new GetObjectCommand({
+        Bucket: input.bucket,
+        Key: input.key,
+        VersionId: input.versionId,
+    });
+    const response = await client.send(command);
+    // To a file: stream the body, nothing is held in memory (BUGS-2026-07 M22)
+    if (input.destPath) {
+        if (!response.Body) {
+            throw new Error("Empty response body");
+        }
+        // Write a part file, then rename it. A failed transfer leaves the previous file
+        // (createWriteStream on destPath truncated it first: deep dive DATA-14).
+        const partPath = `${input.destPath}.${randomUUID().slice(0, 8)}.part`;
+        const source = response.Body;
+        try {
+            if (input.maxBytes !== undefined) {
+                await pipeline(source, byteLimit(input.maxBytes), createWriteStream(partPath));
+            }
+            else {
+                await pipeline(source, createWriteStream(partPath));
+            }
+            await rename(partPath, input.destPath);
+        }
+        catch (error) {
+            await rm(partPath, { force: true });
+            throw error;
+        }
+        return {
+            body: "",
+            path: input.destPath,
+            contentLength: response.ContentLength ?? 0,
+            contentType: response.ContentType,
+            etag: response.ETag?.replace(/"/g, ""),
+            lastModified: response.LastModified?.toISOString(),
+        };
+    }
+    // Into memory: refuse an object that is too large before reading it (BUGS-2026-07 M22)
+    const maxBytes = input.maxBytes ?? DEFAULT_MAX_BYTES;
+    if (response.ContentLength !== undefined && response.ContentLength > maxBytes) {
+        response.Body?.destroy?.();
+        throw tooLarge(response.ContentLength, maxBytes);
+    }
+    if (!response.Body) {
+        throw new Error("Empty response body");
+    }
+    const bodyBytes = await readLimited(response.Body, maxBytes);
+    // Convert to string based on encoding
+    let body;
+    if (input.encoding) {
+        body = bodyBytes.toString(input.encoding);
+    }
+    else {
+        body = bodyBytes.toString("base64");
+    }
+    return {
+        body,
+        contentLength: bodyBytes.length,
+        contentType: response.ContentType,
+        etag: response.ETag?.replace(/"/g, ""),
+        lastModified: response.LastModified?.toISOString(),
+    };
+}
+//# sourceMappingURL=download.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * S3 Procedures Index
+ */
+export { s3Upload } from "./upload.js";
+export { s3Download } from "./download.js";
+export { s3List } from "./list.js";
+export { s3ListAll } from "./list-all.js";
+export { s3Delete } from "./delete.js";
+export { s3MultipartInit } from "./multipart-init.js";
+export { s3MultipartUpload } from "./multipart-upload.js";
+export { s3MultipartComplete } from "./multipart-complete.js";
+export { s3MultipartAbort } from "./multipart-abort.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/procedures/s3/index.js

@@ -0,0 +1,13 @@
+/**
+ * S3 Procedures Index
+ */
+export { s3Upload } from "./upload.js";
+export { s3Download } from "./download.js";
+export { s3List } from "./list.js";
+export { s3ListAll } from "./list-all.js";
+export { s3Delete } from "./delete.js";
+export { s3MultipartInit } from "./multipart-init.js";
+export { s3MultipartUpload } from "./multipart-upload.js";
+export { s3MultipartComplete } from "./multipart-complete.js";
+export { s3MultipartAbort } from "./multipart-abort.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/s3/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * s3.listAll procedure
+ *
+ * List ALL objects in an S3 bucket, transparently following the
+ * ListObjectsV2 continuation token so that buckets/prefixes with more than
+ * 1000 keys are fully reachable in a single call.
+ */
+import type { S3ListAllInput, S3ListAllOutput } from "../../types.js";
+/**
+ * List every object under a bucket/prefix, following pagination automatically.
+ *
+ * Unlike `s3.list` (which returns at most one page — up to 1000 keys — and
+ * exposes `nextContinuationToken` for manual paging), `s3.listAll` loops until
+ * the result is no longer truncated and returns the aggregated contents.
+ *
+ * @example
+ * const { contents, keyCount } = await client.call(["s3", "listAll"], {
+ *   bucket: "my-bucket",
+ *   prefix: "snapshots/",
+ * });
+ * console.log(keyCount); // e.g. 4213, not clamped to 1000
+ */
+export declare function s3ListAll(input: S3ListAllInput): Promise<S3ListAllOutput>;
+//# sourceMappingURL=list-all.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-all.d.ts","sourceRoot":"","sources":["../../../src/procedures/s3/list-all.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,gBAAgB,CAAC;AAEpF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC/E"}

package/dist/procedures/s3/list-all.js

@@ -0,0 +1,57 @@
+/**
+ * s3.listAll procedure
+ *
+ * List ALL objects in an S3 bucket, transparently following the
+ * ListObjectsV2 continuation token so that buckets/prefixes with more than
+ * 1000 keys are fully reachable in a single call.
+ */
+import { s3List } from "./list.js";
+/**
+ * List every object under a bucket/prefix, following pagination automatically.
+ *
+ * Unlike `s3.list` (which returns at most one page — up to 1000 keys — and
+ * exposes `nextContinuationToken` for manual paging), `s3.listAll` loops until
+ * the result is no longer truncated and returns the aggregated contents.
+ *
+ * @example
+ * const { contents, keyCount } = await client.call(["s3", "listAll"], {
+ *   bucket: "my-bucket",
+ *   prefix: "snapshots/",
+ * });
+ * console.log(keyCount); // e.g. 4213, not clamped to 1000
+ */
+export async function s3ListAll(input) {
+    const contents = [];
+    const commonPrefixes = [];
+    const seenPrefixes = new Set();
+    let continuationToken = undefined;
+    let pageCount = 0;
+    do {
+        const page = await s3List({
+            bucket: input.bucket,
+            prefix: input.prefix,
+            delimiter: input.delimiter,
+            maxKeys: input.maxKeys,
+            continuationToken,
+        });
+        pageCount += 1;
+        for (const object of page.contents) {
+            contents.push(object);
+        }
+        for (const prefix of page.commonPrefixes) {
+            if (!seenPrefixes.has(prefix)) {
+                seenPrefixes.add(prefix);
+                commonPrefixes.push(prefix);
+            }
+        }
+        // Only continue while S3 reports more results AND hands back a token.
+        continuationToken = page.isTruncated ? page.nextContinuationToken : undefined;
+    } while (continuationToken);
+    return {
+        contents,
+        commonPrefixes,
+        keyCount: contents.length,
+        pageCount,
+    };
+}
+//# sourceMappingURL=list-all.js.map