@hot-updater/aws 1.1.4 → 1.1.6

package/dist/index.cjs

@@ -5,8 +5,7 @@ let _aws_sdk_client_cloudfront = require("@aws-sdk/client-cloudfront");
 let _aws_sdk_lib_dynamodb = require("@aws-sdk/lib-dynamodb");
 let _aws_sdk_client_ssm = require("@aws-sdk/client-ssm");
 let _aws_sdk_cloudfront_signer = require("@aws-sdk/cloudfront-signer");
-let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
-let _aws_sdk_lib_storage = require("@aws-sdk/lib-storage");
+let _hot_updater_storage_s3 = require("@hot-updater/storage-s3");
 //#region src/cloudFrontInvalidation.ts
 const DEFAULT_POLL_INTERVAL_MS = 2e3;
 const DEFAULT_TIMEOUT_MS = 3e5;
@@ -486,153 +485,16 @@ const cloudFrontDownloadUrl = (config) => {
 };
 //#endregion
 //#region src/s3Storage.ts
-/** Devices download right after the update check that returns the URL. */
-const PRESIGNED_URL_EXPIRES_IN_SECONDS = 3600;
-const isObjectNotFoundError = (error) => error instanceof Error && (error.name === "NotFound" || error.name === "NoSuchKey");
 function s3Storage(config) {
 	const { bucketName, basePath, getDownloadUrl, ...s3Config } = config;
-	const client = new _aws_sdk_client_s3.S3Client(applyS3RuntimeAwsConfig(s3Config));
-	const normalizedBasePath = basePath?.replace(/^\/+|\/+$/g, "") ?? "";
-	const getStorageKey = (0, _hot_updater_plugin_core.createStorageKeyBuilder)(normalizedBasePath);
-	const getListPrefix = (prefix = "") => {
-		const normalizedPrefix = prefix.replace(/^\/+|\/+$/g, "");
-		const value = [normalizedBasePath, normalizedPrefix].filter(Boolean).join("/");
-		return value ? `${value}/` : "";
-	};
-	/**
-	* The URI `put` returns for the key, or null for a key no `put` writes,
-	* such as a folder marker that ends in "/".
-	*/
-	const getListedStorageUri = (key) => {
-		try {
-			return (0, _hot_updater_plugin_core.createStorageUri)({
-				bucket: bucketName,
-				key,
-				protocol: "s3"
-			});
-		} catch {
-			return null;
-		}
-	};
-	const getRelativeKey = (key) => {
-		if (!normalizedBasePath) return key;
-		const basePrefix = `${normalizedBasePath}/`;
-		return key.startsWith(basePrefix) ? key.slice(basePrefix.length) : key;
-	};
-	const parseAndValidate = (storageUri) => {
-		const parsed = (0, _hot_updater_plugin_core.parseStorageUri)(storageUri, "s3");
-		if (parsed.bucket !== bucketName) throw new Error(`Bucket name mismatch: expected "${bucketName}", but found "${parsed.bucket}".`);
-		return parsed;
-	};
-	return (0, _hot_updater_plugin_core.createStorageAdapter)({
+	return (0, _hot_updater_storage_s3.createS3Storage)({
 		name: "s3Storage",
-		protocol: "s3",
-		async listObjects(prefix) {
-			const objects = [];
-			let continuationToken;
-			do {
-				const response = await client.send(new _aws_sdk_client_s3.ListObjectsV2Command({
-					Bucket: bucketName,
-					ContinuationToken: continuationToken,
-					Prefix: getListPrefix(prefix)
-				}));
-				for (const object of response.Contents ?? []) {
-					if (!object.Key) continue;
-					const storageUri = getListedStorageUri(object.Key);
-					if (storageUri === null) continue;
-					objects.push({
-						key: getRelativeKey(object.Key),
-						lastModifiedAt: object.LastModified,
-						size: object.Size ?? 0,
-						storageUri
-					});
-				}
-				continuationToken = response.NextContinuationToken;
-			} while (continuationToken);
-			return objects;
-		},
-		async deleteObjects(relativeKeys) {
-			const keys = relativeKeys.map((key) => getStorageKey(key));
-			for (let offset = 0; offset < keys.length; offset += 1e3) {
-				const batch = keys.slice(offset, offset + 1e3);
-				if (batch.length === 0) continue;
-				const response = await client.send(new _aws_sdk_client_s3.DeleteObjectsCommand({
-					Bucket: bucketName,
-					Delete: {
-						Objects: batch.map((Key) => ({ Key })),
-						Quiet: true
-					}
-				}));
-				if (response.Errors && response.Errors.length > 0) throw new Error(`Failed to delete ${response.Errors.length} S3 object(s).`);
-			}
-		},
-		async put({ key, body, contentLength, contentType }) {
-			const storageKey = getStorageKey(key);
-			const response = await new _aws_sdk_lib_storage.Upload({
-				client,
-				params: {
-					Body: body,
-					Bucket: bucketName,
-					CacheControl: "max-age=31536000",
-					...contentLength === void 0 ? {} : { ContentLength: contentLength },
-					ContentType: contentType,
-					Key: storageKey
-				}
-			}).done();
-			if (!response.Bucket || !response.Key) throw new Error("Upload failed");
-			return { storageUri: (0, _hot_updater_plugin_core.createStorageUri)({
-				bucket: bucketName,
-				key: storageKey,
-				protocol: "s3"
-			}) };
-		},
-		async get({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			try {
-				const response = await client.send(new _aws_sdk_client_s3.GetObjectCommand({
-					Bucket: bucketName,
-					Key: key
-				}));
-				if (!response.Body) return { response: null };
-				const headers = new Headers();
-				if (response.ContentType) headers.set("content-type", response.ContentType);
-				if (response.ContentLength !== void 0) headers.set("content-length", String(response.ContentLength));
-				return { response: new Response(response.Body.transformToWebStream(), { headers }) };
-			} catch (error) {
-				if (isObjectNotFoundError(error)) return { response: null };
-				throw error;
-			}
-		},
-		async getDownloadUrl({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			if (getDownloadUrl) return getDownloadUrl({ storageUri });
-			const { getSignedUrl } = await import("@aws-sdk/s3-request-presigner");
-			return { url: await getSignedUrl(client, new _aws_sdk_client_s3.GetObjectCommand({
-				Bucket: bucketName,
-				Key: key
-			}), { expiresIn: PRESIGNED_URL_EXPIRES_IN_SECONDS }) };
-		},
-		async exists({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			try {
-				await client.send(new _aws_sdk_client_s3.HeadObjectCommand({
-					Bucket: bucketName,
-					Key: key
-				}));
-				return { exists: true };
-			} catch (error) {
-				if (isObjectNotFoundError(error)) return { exists: false };
-				throw error;
-			}
-		},
-		async delete({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			await client.send(new _aws_sdk_client_s3.DeleteObjectCommand({
-				Bucket: bucketName,
-				Key: key
-			}));
-			return { deleted: true };
-		}
+		protocol: "s3"
+	}, {
+		...applyS3RuntimeAwsConfig(s3Config),
+		bucketName,
+		basePath,
+		getDownloadUrl
 	});
 }
 //#endregion

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import { DynamoDBClientConfig } from "@aws-sdk/client-dynamodb";
 import { EngineDatabase, PluginTables, StorageAdapter, StorageAdapterWith } from "@hot-updater/plugin-core";
 import { S3ClientConfig } from "@aws-sdk/client-s3";
+import { S3StorageOperations } from "@hot-updater/storage-s3";
 //#region src/dynamoDB.d.ts
 interface DynamoDBConfig extends DynamoDBClientConfig {
   readonly apiBasePath?: string;
@@ -70,7 +71,6 @@ interface S3StorageConfig extends S3ClientConfig {
    */
   getDownloadUrl?: StorageAdapter["getDownloadUrl"];
 }
-type S3StorageOperations = "put" | "get" | "getDownloadUrl" | "exists" | "delete" | "listObjects" | "deleteObjects";
 declare function s3Storage(config: S3StorageConfig): StorageAdapterWith<S3StorageOperations>;
 //#endregion
 export { CloudFrontDownloadUrlOptions, type DynamoDBConfig, S3StorageConfig, cloudFrontDownloadUrl, dynamoDB, migrateDynamoDB, s3Storage };

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { DynamoDBClientConfig } from "@aws-sdk/client-dynamodb";
 import { EngineDatabase, PluginTables, StorageAdapter, StorageAdapterWith } from "@hot-updater/plugin-core";
+import { S3StorageOperations } from "@hot-updater/storage-s3";
 import { S3ClientConfig } from "@aws-sdk/client-s3";
 //#region src/dynamoDB.d.ts
 interface DynamoDBConfig extends DynamoDBClientConfig {
@@ -70,7 +71,6 @@ interface S3StorageConfig extends S3ClientConfig {
    */
   getDownloadUrl?: StorageAdapter["getDownloadUrl"];
 }
-type S3StorageOperations = "put" | "get" | "getDownloadUrl" | "exists" | "delete" | "listObjects" | "deleteObjects";
 declare function s3Storage(config: S3StorageConfig): StorageAdapterWith<S3StorageOperations>;
 //#endregion
 export { CloudFrontDownloadUrlOptions, type DynamoDBConfig, S3StorageConfig, cloudFrontDownloadUrl, dynamoDB, migrateDynamoDB, s3Storage };

package/dist/index.mjs

@@ -1,11 +1,10 @@
 import { CreateTableCommand, DescribeTableCommand, DescribeTimeToLiveCommand, DynamoDBClient, UpdateTimeToLiveCommand, waitUntilTableExists } from "@aws-sdk/client-dynamodb";
-import { BUNDLE_STORAGE_PREFIX, CONTENT_ADDRESSED_ASSET_PREFIX, createEngineDatabase, createKvAdapter, createStorageAdapter, createStorageKeyBuilder, createStorageUri, migrateCoreSchema, parseStorageUri } from "@hot-updater/plugin-core";
+import { BUNDLE_STORAGE_PREFIX, CONTENT_ADDRESSED_ASSET_PREFIX, createEngineDatabase, createKvAdapter, migrateCoreSchema } from "@hot-updater/plugin-core";
 import { CloudFrontClient, CreateInvalidationCommand, GetInvalidationCommand } from "@aws-sdk/client-cloudfront";
 import { BatchGetCommand, BatchWriteCommand, DynamoDBDocumentClient, QueryCommand, TransactWriteCommand } from "@aws-sdk/lib-dynamodb";
 import { SSM } from "@aws-sdk/client-ssm";
 import { getSignedUrl } from "@aws-sdk/cloudfront-signer";
-import { DeleteObjectCommand, DeleteObjectsCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, S3Client } from "@aws-sdk/client-s3";
-import { Upload } from "@aws-sdk/lib-storage";
+import { createS3Storage } from "@hot-updater/storage-s3";
 //#region src/cloudFrontInvalidation.ts
 const DEFAULT_POLL_INTERVAL_MS = 2e3;
 const DEFAULT_TIMEOUT_MS = 3e5;
@@ -485,153 +484,16 @@ const cloudFrontDownloadUrl = (config) => {
 };
 //#endregion
 //#region src/s3Storage.ts
-/** Devices download right after the update check that returns the URL. */
-const PRESIGNED_URL_EXPIRES_IN_SECONDS = 3600;
-const isObjectNotFoundError = (error) => error instanceof Error && (error.name === "NotFound" || error.name === "NoSuchKey");
 function s3Storage(config) {
 	const { bucketName, basePath, getDownloadUrl, ...s3Config } = config;
-	const client = new S3Client(applyS3RuntimeAwsConfig(s3Config));
-	const normalizedBasePath = basePath?.replace(/^\/+|\/+$/g, "") ?? "";
-	const getStorageKey = createStorageKeyBuilder(normalizedBasePath);
-	const getListPrefix = (prefix = "") => {
-		const normalizedPrefix = prefix.replace(/^\/+|\/+$/g, "");
-		const value = [normalizedBasePath, normalizedPrefix].filter(Boolean).join("/");
-		return value ? `${value}/` : "";
-	};
-	/**
-	* The URI `put` returns for the key, or null for a key no `put` writes,
-	* such as a folder marker that ends in "/".
-	*/
-	const getListedStorageUri = (key) => {
-		try {
-			return createStorageUri({
-				bucket: bucketName,
-				key,
-				protocol: "s3"
-			});
-		} catch {
-			return null;
-		}
-	};
-	const getRelativeKey = (key) => {
-		if (!normalizedBasePath) return key;
-		const basePrefix = `${normalizedBasePath}/`;
-		return key.startsWith(basePrefix) ? key.slice(basePrefix.length) : key;
-	};
-	const parseAndValidate = (storageUri) => {
-		const parsed = parseStorageUri(storageUri, "s3");
-		if (parsed.bucket !== bucketName) throw new Error(`Bucket name mismatch: expected "${bucketName}", but found "${parsed.bucket}".`);
-		return parsed;
-	};
-	return createStorageAdapter({
+	return createS3Storage({
 		name: "s3Storage",
-		protocol: "s3",
-		async listObjects(prefix) {
-			const objects = [];
-			let continuationToken;
-			do {
-				const response = await client.send(new ListObjectsV2Command({
-					Bucket: bucketName,
-					ContinuationToken: continuationToken,
-					Prefix: getListPrefix(prefix)
-				}));
-				for (const object of response.Contents ?? []) {
-					if (!object.Key) continue;
-					const storageUri = getListedStorageUri(object.Key);
-					if (storageUri === null) continue;
-					objects.push({
-						key: getRelativeKey(object.Key),
-						lastModifiedAt: object.LastModified,
-						size: object.Size ?? 0,
-						storageUri
-					});
-				}
-				continuationToken = response.NextContinuationToken;
-			} while (continuationToken);
-			return objects;
-		},
-		async deleteObjects(relativeKeys) {
-			const keys = relativeKeys.map((key) => getStorageKey(key));
-			for (let offset = 0; offset < keys.length; offset += 1e3) {
-				const batch = keys.slice(offset, offset + 1e3);
-				if (batch.length === 0) continue;
-				const response = await client.send(new DeleteObjectsCommand({
-					Bucket: bucketName,
-					Delete: {
-						Objects: batch.map((Key) => ({ Key })),
-						Quiet: true
-					}
-				}));
-				if (response.Errors && response.Errors.length > 0) throw new Error(`Failed to delete ${response.Errors.length} S3 object(s).`);
-			}
-		},
-		async put({ key, body, contentLength, contentType }) {
-			const storageKey = getStorageKey(key);
-			const response = await new Upload({
-				client,
-				params: {
-					Body: body,
-					Bucket: bucketName,
-					CacheControl: "max-age=31536000",
-					...contentLength === void 0 ? {} : { ContentLength: contentLength },
-					ContentType: contentType,
-					Key: storageKey
-				}
-			}).done();
-			if (!response.Bucket || !response.Key) throw new Error("Upload failed");
-			return { storageUri: createStorageUri({
-				bucket: bucketName,
-				key: storageKey,
-				protocol: "s3"
-			}) };
-		},
-		async get({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			try {
-				const response = await client.send(new GetObjectCommand({
-					Bucket: bucketName,
-					Key: key
-				}));
-				if (!response.Body) return { response: null };
-				const headers = new Headers();
-				if (response.ContentType) headers.set("content-type", response.ContentType);
-				if (response.ContentLength !== void 0) headers.set("content-length", String(response.ContentLength));
-				return { response: new Response(response.Body.transformToWebStream(), { headers }) };
-			} catch (error) {
-				if (isObjectNotFoundError(error)) return { response: null };
-				throw error;
-			}
-		},
-		async getDownloadUrl({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			if (getDownloadUrl) return getDownloadUrl({ storageUri });
-			const { getSignedUrl } = await import("@aws-sdk/s3-request-presigner");
-			return { url: await getSignedUrl(client, new GetObjectCommand({
-				Bucket: bucketName,
-				Key: key
-			}), { expiresIn: PRESIGNED_URL_EXPIRES_IN_SECONDS }) };
-		},
-		async exists({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			try {
-				await client.send(new HeadObjectCommand({
-					Bucket: bucketName,
-					Key: key
-				}));
-				return { exists: true };
-			} catch (error) {
-				if (isObjectNotFoundError(error)) return { exists: false };
-				throw error;
-			}
-		},
-		async delete({ storageUri }) {
-			const { key } = parseAndValidate(storageUri);
-			await client.send(new DeleteObjectCommand({
-				Bucket: bucketName,
-				Key: key
-			}));
-			return { deleted: true };
-		}
+		protocol: "s3"
+	}, {
+		...applyS3RuntimeAwsConfig(s3Config),
+		bucketName,
+		basePath,
+		getDownloadUrl
 	});
 }
 //#endregion

package/dist/lambda/index.cjs

@@ -30,6 +30,7 @@ let _aws_sdk_client_cloudfront = require("@aws-sdk/client-cloudfront");
 let _aws_sdk_lib_dynamodb = require("@aws-sdk/lib-dynamodb");
 let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
 let _aws_sdk_lib_storage = require("@aws-sdk/lib-storage");
+let _aws_sdk_s3_request_presigner = require("@aws-sdk/s3-request-presigner");
 const SHA256_FILE_HASH_RE = /^[0-9a-f]{64}$/;
 const isContentAddressedAssetFileHash = (value) => {
 	return typeof value === "string" && SHA256_FILE_HASH_RE.test(value);
@@ -4549,7 +4550,7 @@ const createKvAdapter = ({ store, tablePrefix = "" }) => {
 };
 //#endregion
 //#region ../../packages/server/dist/version.mjs
-const HOT_UPDATER_SERVER_VERSION = "1.1.4";
+const HOT_UPDATER_SERVER_VERSION = "1.1.6";
 //#endregion
 //#region ../../packages/server/dist/handlerVersionRoutes.mjs
 /**
@@ -13829,18 +13830,31 @@ const dynamoDB = (config) => {
 	};
 };
 //#endregion
-//#region src/s3Storage.ts
+//#region ../storage-s3/dist/index.mjs
 /** Devices download right after the update check that returns the URL. */
-const PRESIGNED_URL_EXPIRES_IN_SECONDS = 3600;
-const isObjectNotFoundError = (error) => error instanceof Error && (error.name === "NotFound" || error.name === "NoSuchKey");
-function s3Storage(config) {
-	const { bucketName, basePath, getDownloadUrl, ...s3Config } = config;
-	const client = new _aws_sdk_client_s3.S3Client(applyS3RuntimeAwsConfig(s3Config));
-	const normalizedBasePath = basePath?.replace(/^\/+|\/+$/g, "") ?? "";
+const DEFAULT_SIGNED_LIFETIME_SECONDS = 3600;
+/** SigV4's limit on a presigned URL. */
+const MAX_SIGNED_LIFETIME_SECONDS = 604800;
+/** DeleteObjects takes at most 1000 keys a request. */
+const DELETE_BATCH_SIZE = 1e3;
+const isObjectNotFoundError = (error) => {
+	if (error instanceof Error && (error.name === "NotFound" || error.name === "NoSuchKey")) return true;
+	return typeof error === "object" && error !== null && "$metadata" in error && error.$metadata?.httpStatusCode === 404;
+};
+const trimSlashes = (value) => value.replace(/^\/+|\/+$/g, "");
+/**
+* A storage adapter over a bucket's S3 API, which AWS S3, Cloudflare R2, and
+* Neon Object Storage all serve. Each provider package passes its own name,
+* URI protocol, and client defaults.
+*/
+const createS3Storage = ({ name, protocol }, config) => {
+	const { bucketName, basePath, getDownloadUrl, signedUrlExpiresIn = DEFAULT_SIGNED_LIFETIME_SECONDS, ...clientConfig } = config;
+	if (!Number.isFinite(signedUrlExpiresIn) || signedUrlExpiresIn <= 0 || signedUrlExpiresIn > MAX_SIGNED_LIFETIME_SECONDS) throw new Error(`${name} signedUrlExpiresIn must be between 1 and ${MAX_SIGNED_LIFETIME_SECONDS} seconds (seven days).`);
+	const client = new _aws_sdk_client_s3.S3Client(clientConfig);
+	const normalizedBasePath = trimSlashes(basePath ?? "");
 	const getStorageKey = createStorageKeyBuilder(normalizedBasePath);
 	const getListPrefix = (prefix = "") => {
-		const normalizedPrefix = prefix.replace(/^\/+|\/+$/g, "");
-		const value = [normalizedBasePath, normalizedPrefix].filter(Boolean).join("/");
+		const value = [normalizedBasePath, trimSlashes(prefix)].filter(Boolean).join("/");
 		return value ? `${value}/` : "";
 	};
 	/**
@@ -13852,7 +13866,7 @@ function s3Storage(config) {
 			return createStorageUri({
 				bucket: bucketName,
 				key,
-				protocol: "s3"
+				protocol
 			});
 		} catch {
 			return null;
@@ -13864,55 +13878,16 @@ function s3Storage(config) {
 		return key.startsWith(basePrefix) ? key.slice(basePrefix.length) : key;
 	};
 	const parseAndValidate = (storageUri) => {
-		const parsed = parseStorageUri(storageUri, "s3");
+		const parsed = parseStorageUri(storageUri, protocol);
 		if (parsed.bucket !== bucketName) throw new Error(`Bucket name mismatch: expected "${bucketName}", but found "${parsed.bucket}".`);
 		return parsed;
 	};
 	return createStorageAdapter({
-		name: "s3Storage",
-		protocol: "s3",
-		async listObjects(prefix) {
-			const objects = [];
-			let continuationToken;
-			do {
-				const response = await client.send(new _aws_sdk_client_s3.ListObjectsV2Command({
-					Bucket: bucketName,
-					ContinuationToken: continuationToken,
-					Prefix: getListPrefix(prefix)
-				}));
-				for (const object of response.Contents ?? []) {
-					if (!object.Key) continue;
-					const storageUri = getListedStorageUri(object.Key);
-					if (storageUri === null) continue;
-					objects.push({
-						key: getRelativeKey(object.Key),
-						lastModifiedAt: object.LastModified,
-						size: object.Size ?? 0,
-						storageUri
-					});
-				}
-				continuationToken = response.NextContinuationToken;
-			} while (continuationToken);
-			return objects;
-		},
-		async deleteObjects(relativeKeys) {
-			const keys = relativeKeys.map((key) => getStorageKey(key));
-			for (let offset = 0; offset < keys.length; offset += 1e3) {
-				const batch = keys.slice(offset, offset + 1e3);
-				if (batch.length === 0) continue;
-				const response = await client.send(new _aws_sdk_client_s3.DeleteObjectsCommand({
-					Bucket: bucketName,
-					Delete: {
-						Objects: batch.map((Key) => ({ Key })),
-						Quiet: true
-					}
-				}));
-				if (response.Errors && response.Errors.length > 0) throw new Error(`Failed to delete ${response.Errors.length} S3 object(s).`);
-			}
-		},
+		name,
+		protocol,
 		async put({ key, body, contentLength, contentType }) {
 			const storageKey = getStorageKey(key);
-			const response = await new _aws_sdk_lib_storage.Upload({
+			await new _aws_sdk_lib_storage.Upload({
 				client,
 				params: {
 					Body: body,
@@ -13923,11 +13898,10 @@ function s3Storage(config) {
 					Key: storageKey
 				}
 			}).done();
-			if (!response.Bucket || !response.Key) throw new Error("Upload failed");
 			return { storageUri: createStorageUri({
 				bucket: bucketName,
 				key: storageKey,
-				protocol: "s3"
+				protocol
 			}) };
 		},
 		async get({ storageUri }) {
@@ -13950,11 +13924,10 @@ function s3Storage(config) {
 		async getDownloadUrl({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
 			if (getDownloadUrl) return getDownloadUrl({ storageUri });
-			const { getSignedUrl } = await import("@aws-sdk/s3-request-presigner");
-			return { url: await getSignedUrl(client, new _aws_sdk_client_s3.GetObjectCommand({
+			return { url: await (0, _aws_sdk_s3_request_presigner.getSignedUrl)(client, new _aws_sdk_client_s3.GetObjectCommand({
 				Bucket: bucketName,
 				Key: key
-			}), { expiresIn: PRESIGNED_URL_EXPIRES_IN_SECONDS }) };
+			}), { expiresIn: signedUrlExpiresIn }) };
 		},
 		async exists({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
@@ -13976,8 +13949,60 @@ function s3Storage(config) {
 				Key: key
 			}));
 			return { deleted: true };
+		},
+		async listObjects(prefix) {
+			const objects = [];
+			let continuationToken;
+			do {
+				const response = await client.send(new _aws_sdk_client_s3.ListObjectsV2Command({
+					Bucket: bucketName,
+					ContinuationToken: continuationToken,
+					Prefix: getListPrefix(prefix)
+				}));
+				for (const object of response.Contents ?? []) {
+					if (!object.Key) continue;
+					const storageUri = getListedStorageUri(object.Key);
+					if (storageUri === null) continue;
+					objects.push({
+						key: getRelativeKey(object.Key),
+						lastModifiedAt: object.LastModified,
+						size: object.Size ?? 0,
+						storageUri
+					});
+				}
+				continuationToken = response.NextContinuationToken;
+			} while (continuationToken);
+			return objects;
+		},
+		async deleteObjects(relativeKeys) {
+			const keys = relativeKeys.map((key) => getStorageKey(key));
+			for (let offset = 0; offset < keys.length; offset += DELETE_BATCH_SIZE) {
+				const batch = keys.slice(offset, offset + DELETE_BATCH_SIZE);
+				const response = await client.send(new _aws_sdk_client_s3.DeleteObjectsCommand({
+					Bucket: bucketName,
+					Delete: {
+						Objects: batch.map((Key) => ({ Key })),
+						Quiet: true
+					}
+				}));
+				if (response.Errors && response.Errors.length > 0) throw new Error(`Failed to delete ${response.Errors.length} S3 object(s) from bucket "${bucketName}".`);
+			}
 		}
 	});
+};
+//#endregion
+//#region src/s3Storage.ts
+function s3Storage(config) {
+	const { bucketName, basePath, getDownloadUrl, ...s3Config } = config;
+	return createS3Storage({
+		name: "s3Storage",
+		protocol: "s3"
+	}, {
+		...applyS3RuntimeAwsConfig(s3Config),
+		bucketName,
+		basePath,
+		getDownloadUrl
+	});
 }
 //#endregion
 //#region lambda/index.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/aws",
   "type": "module",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -45,9 +45,9 @@
     "es-toolkit": "^1.32.0",
     "execa": "9.5.2",
     "mime": "^4.0.4",
-    "@hot-updater/protocol": "1.1.4",
-    "@hot-updater/mock": "1.1.4",
-    "@hot-updater/test-utils": "1.1.4"
+    "@hot-updater/protocol": "1.1.6",
+    "@hot-updater/mock": "1.1.6",
+    "@hot-updater/test-utils": "1.1.6"
   },
   "dependencies": {
     "@aws-sdk/client-cloudfront": "3.1066.0",
@@ -63,9 +63,10 @@
     "@aws-sdk/lib-dynamodb": "3.1066.0",
     "@aws-sdk/s3-request-presigner": "3.1066.0",
     "hono": "4.12.34",
-    "@hot-updater/cli-tools": "1.1.4",
-    "@hot-updater/plugin-core": "1.1.4",
-    "@hot-updater/server": "1.1.4"
+    "@hot-updater/cli-tools": "1.1.6",
+    "@hot-updater/plugin-core": "1.1.6",
+    "@hot-updater/server": "1.1.6",
+    "@hot-updater/storage-s3": "1.1.6"
   },
   "scripts": {
     "build": "tsdown",