@hot-updater/aws 0.29.5 → 0.29.7

package/dist/iac/index.cjs

@@ -22,8 +22,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-let fs = require("fs");
-fs = __toESM(fs);
 let _aws_sdk_credential_providers = require("@aws-sdk/credential-providers");
 let _hot_updater_cli_tools = require("@hot-updater/cli-tools");
 let node_url = require("node:url");
@@ -826,7 +824,7 @@ const handleCommand = (filePath, rawArguments, rawOptions) => {
 var require_windows = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = isexe;
 	isexe.sync = sync;
-	var fs$5 = require("fs");
+	var fs$3 = require("fs");
 	function checkPathExt(path, options) {
 		var pathext = options.pathExt !== void 0 ? options.pathExt : process.env.PATHEXT;
 		if (!pathext) return true;
@@ -843,12 +841,12 @@ var require_windows = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		return checkPathExt(path, options);
 	}
 	function isexe(path, options, cb) {
-		fs$5.stat(path, function(er, stat) {
+		fs$3.stat(path, function(er, stat) {
 			cb(er, er ? false : checkStat(stat, path, options));
 		});
 	}
 	function sync(path, options) {
-		return checkStat(fs$5.statSync(path), path, options);
+		return checkStat(fs$3.statSync(path), path, options);
 	}
 }));
 //#endregion
@@ -856,14 +854,14 @@ var require_windows = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 var require_mode = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = isexe;
 	isexe.sync = sync;
-	var fs$4 = require("fs");
+	var fs$2 = require("fs");
 	function isexe(path, options, cb) {
-		fs$4.stat(path, function(er, stat) {
+		fs$2.stat(path, function(er, stat) {
 			cb(er, er ? false : checkStat(stat, options));
 		});
 	}
 	function sync(path, options) {
-		return checkStat(fs$4.statSync(path), options);
+		return checkStat(fs$2.statSync(path), options);
 	}
 	function checkStat(stat, options) {
 		return stat.isFile() && checkMode(stat, options);
@@ -1078,16 +1076,16 @@ var require_shebang_command = /* @__PURE__ */ __commonJSMin(((exports, module) =
 //#endregion
 //#region ../../node_modules/.pnpm/cross-spawn@7.0.6/node_modules/cross-spawn/lib/util/readShebang.js
 var require_readShebang = /* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const fs$3 = require("fs");
+	const fs$1 = require("fs");
 	const shebangCommand = require_shebang_command();
 	function readShebang(command) {
 		const size = 150;
 		const buffer = Buffer.alloc(size);
 		let fd;
 		try {
-			fd = fs$3.openSync(command, "r");
-			fs$3.readSync(fd, buffer, 0, size, 0);
-			fs$3.closeSync(fd);
+			fd = fs$1.openSync(command, "r");
+			fs$1.readSync(fd, buffer, 0, size, 0);
+			fs$1.closeSync(fd);
 		} catch (e) {}
 		return shebangCommand(buffer.toString());
 	}
@@ -7327,7 +7325,7 @@ var SSMKeyPairManager = class {
 };
 //#endregion
 //#region iac/templates.ts
-const getConfigTemplate = (build, { profile }) => {
+const getConfigScaffold = (build, { profile }) => {
 	const storageConfig = {
 		imports: [{
 			pkg: "@hot-updater/aws",
@@ -7345,14 +7343,21 @@ const getConfigTemplate = (build, { profile }) => {
     cloudfrontDistributionId: process.env.HOT_UPDATER_CLOUDFRONT_DISTRIBUTION_ID!,
   })`
 	};
-	let intermediate = "";
-	if (profile) intermediate = `
+	let helperStatements = [];
+	if (profile) helperStatements = [{
+		name: "commonOptions",
+		strategy: "merge-object",
+		code: `
 const commonOptions = {
   bucketName: process.env.HOT_UPDATER_S3_BUCKET_NAME!,
   region: process.env.HOT_UPDATER_S3_REGION!,
   credentials: fromSSO({ profile: process.env.HOT_UPDATER_AWS_PROFILE! }),
-};`.trim();
-	else intermediate = `
+};`.trim()
+	}];
+	else helperStatements = [{
+		name: "commonOptions",
+		strategy: "merge-object",
+		code: `
 const commonOptions = {
   bucketName: process.env.HOT_UPDATER_S3_BUCKET_NAME!,
   region: process.env.HOT_UPDATER_S3_REGION!,
@@ -7360,13 +7365,14 @@ const commonOptions = {
     accessKeyId: process.env.HOT_UPDATER_S3_ACCESS_KEY_ID!,
     secretAccessKey: process.env.HOT_UPDATER_S3_SECRET_ACCESS_KEY!,
   },
-};`.trim();
-	const builder = new _hot_updater_cli_tools.ConfigBuilder().setBuildType(build).setStorage(storageConfig).setDatabase(databaseConfig);
+};`.trim()
+	}];
+	const builder = new _hot_updater_cli_tools.ConfigBuilder().setBuildType(build).setStorage(storageConfig).setDatabase(databaseConfig).setIntermediateCode(helperStatements.map((statement) => statement.code.trim()).join("\n\n"));
 	if (profile) builder.addImport({
 		pkg: "@aws-sdk/credential-provider-sso",
 		named: ["fromSSO"]
 	});
-	return builder.setIntermediateCode(intermediate).getResult();
+	return (0, _hot_updater_cli_tools.createHotUpdaterConfigScaffoldFromBuilder)(builder, { helperStatements });
 };
 const SOURCE_TEMPLATE = `// Add this to your App.tsx
 import { HotUpdater } from "@hot-updater/react-native";
@@ -7536,7 +7542,7 @@ const runInit = async ({ build }) => {
 		distributionId,
 		accountId
 	});
-	await fs.default.promises.writeFile("hot-updater.config.ts", getConfigTemplate(build, { profile: ssoProfile }));
+	const configWriteResult = await (0, _hot_updater_cli_tools.writeHotUpdaterConfig)(getConfigScaffold(build, { profile: ssoProfile }));
 	await (0, _hot_updater_cli_tools.makeEnv)({
 		HOT_UPDATER_S3_BUCKET_NAME: bucketName,
 		HOT_UPDATER_S3_REGION: bucketRegion,
@@ -7555,7 +7561,9 @@ const runInit = async ({ build }) => {
 	});
 	if (mode === "sso") await (0, _hot_updater_cli_tools.ensureInstallPackages)({ devDependencies: ["@aws-sdk/credential-provider-sso"] });
 	_hot_updater_cli_tools.p.log.success("Generated '.env.hotupdater' file with AWS settings.");
-	_hot_updater_cli_tools.p.log.success("Generated 'hot-updater.config.ts' file with AWS settings.");
+	if (configWriteResult.status === "created") _hot_updater_cli_tools.p.log.success("Generated 'hot-updater.config.ts' file with AWS settings.");
+	else if (configWriteResult.status === "merged") _hot_updater_cli_tools.p.log.success("Updated 'hot-updater.config.ts' file with AWS settings.");
+	else _hot_updater_cli_tools.p.log.warn(`Kept existing 'hot-updater.config.ts' unchanged: ${configWriteResult.reason}`);
 	const sourceUrl = `https://${distributionDomain}/api/check-update`;
 	_hot_updater_cli_tools.p.note((0, _hot_updater_cli_tools.transformTemplate)(SOURCE_TEMPLATE, { source: sourceUrl }));
 	_hot_updater_cli_tools.p.log.message(`Next step: ${(0, _hot_updater_cli_tools.link)("https://hot-updater.dev/docs/managed/aws#step-4-changeenv-file-optional")}`);

package/dist/iac/index.mjs

@@ -1,7 +1,6 @@
 import { createRequire } from "node:module";
-import fs from "fs";
 import { fromSSO } from "@aws-sdk/credential-providers";
-import { ConfigBuilder, colors, copyDirToTmp, createZip, ensureInstallPackages, getCwd, link, makeEnv, p, transformEnv, transformTemplate } from "@hot-updater/cli-tools";
+import { ConfigBuilder, colors, copyDirToTmp, createHotUpdaterConfigScaffoldFromBuilder, createZip, ensureInstallPackages, getCwd, link, makeEnv, p, transformEnv, transformTemplate, writeHotUpdaterConfig } from "@hot-updater/cli-tools";
 import { fileURLToPath } from "node:url";
 import { ChildProcess, execFile, spawn, spawnSync } from "node:child_process";
 import { StringDecoder } from "node:string_decoder";
@@ -22,7 +21,7 @@ import crypto from "crypto";
 import { CloudFront } from "@aws-sdk/client-cloudfront";
 import { IAM } from "@aws-sdk/client-iam";
 import { STS } from "@aws-sdk/client-sts";
-import fs$1 from "fs/promises";
+import fs from "fs/promises";
 import { Lambda } from "@aws-sdk/client-lambda";
 import { CopyObjectCommand, DeleteObjectCommand, GetObjectCommand, ListObjectsV2Command, S3 } from "@aws-sdk/client-s3";
 import { Upload } from "@aws-sdk/lib-storage";
@@ -820,7 +819,7 @@ const handleCommand = (filePath, rawArguments, rawOptions) => {
 var require_windows = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = isexe;
 	isexe.sync = sync;
-	var fs$4 = __require("fs");
+	var fs$3 = __require("fs");
 	function checkPathExt(path, options) {
 		var pathext = options.pathExt !== void 0 ? options.pathExt : process.env.PATHEXT;
 		if (!pathext) return true;
@@ -837,12 +836,12 @@ var require_windows = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		return checkPathExt(path, options);
 	}
 	function isexe(path, options, cb) {
-		fs$4.stat(path, function(er, stat) {
+		fs$3.stat(path, function(er, stat) {
 			cb(er, er ? false : checkStat(stat, path, options));
 		});
 	}
 	function sync(path, options) {
-		return checkStat(fs$4.statSync(path), path, options);
+		return checkStat(fs$3.statSync(path), path, options);
 	}
 }));
 //#endregion
@@ -850,14 +849,14 @@ var require_windows = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 var require_mode = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = isexe;
 	isexe.sync = sync;
-	var fs$3 = __require("fs");
+	var fs$2 = __require("fs");
 	function isexe(path, options, cb) {
-		fs$3.stat(path, function(er, stat) {
+		fs$2.stat(path, function(er, stat) {
 			cb(er, er ? false : checkStat(stat, options));
 		});
 	}
 	function sync(path, options) {
-		return checkStat(fs$3.statSync(path), options);
+		return checkStat(fs$2.statSync(path), options);
 	}
 	function checkStat(stat, options) {
 		return stat.isFile() && checkMode(stat, options);
@@ -1072,16 +1071,16 @@ var require_shebang_command = /* @__PURE__ */ __commonJSMin(((exports, module) =
 //#endregion
 //#region ../../node_modules/.pnpm/cross-spawn@7.0.6/node_modules/cross-spawn/lib/util/readShebang.js
 var require_readShebang = /* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const fs$2 = __require("fs");
+	const fs$1 = __require("fs");
 	const shebangCommand = require_shebang_command();
 	function readShebang(command) {
 		const size = 150;
 		const buffer = Buffer.alloc(size);
 		let fd;
 		try {
-			fd = fs$2.openSync(command, "r");
-			fs$2.readSync(fd, buffer, 0, size, 0);
-			fs$2.closeSync(fd);
+			fd = fs$1.openSync(command, "r");
+			fs$1.readSync(fd, buffer, 0, size, 0);
+			fs$1.closeSync(fd);
 		} catch (e) {}
 		return shebangCommand(buffer.toString());
 	}
@@ -6750,7 +6749,7 @@ var LambdaEdgeDeployer = class {
 			SSM_REGION: config.ssmRegion,
 			S3_BUCKET_NAME: config.bucketName
 		});
-		await fs$1.writeFile(indexPath, code);
+		await fs.writeFile(indexPath, code);
 		const lambdaClient = new Lambda({
 			region: "us-east-1",
 			credentials: this.credentials
@@ -6784,7 +6783,7 @@ var LambdaEdgeDeployer = class {
 							Runtime: "nodejs22.x",
 							Role: lambdaRoleArn,
 							Handler: "index.handler",
-							Code: { ZipFile: await fs$1.readFile(zipFilePath) },
+							Code: { ZipFile: await fs.readFile(zipFilePath) },
 							Description: "Hot Updater Lambda@Edge function",
 							Publish: true,
 							Timeout: 10
@@ -6797,7 +6796,7 @@ var LambdaEdgeDeployer = class {
 							message(`Function "${lambdaName}" already exists. Updating function code...`);
 							const updateResp = await lambdaClient.updateFunctionCode({
 								FunctionName: lambdaName,
-								ZipFile: await fs$1.readFile(zipFilePath),
+								ZipFile: await fs.readFile(zipFilePath),
 								Publish: true
 							});
 							message("Waiting for Lambda function update to complete...");
@@ -6829,7 +6828,7 @@ var LambdaEdgeDeployer = class {
 						return `Updated Lambda "${lambdaName}" function`;
 					} finally {
 						removeTmpDir();
-						fs$1.rm(zipFilePath, { force: true });
+						fs.rm(zipFilePath, { force: true });
 					}
 				}
 			},
@@ -7321,7 +7320,7 @@ var SSMKeyPairManager = class {
 };
 //#endregion
 //#region iac/templates.ts
-const getConfigTemplate = (build, { profile }) => {
+const getConfigScaffold = (build, { profile }) => {
 	const storageConfig = {
 		imports: [{
 			pkg: "@hot-updater/aws",
@@ -7339,14 +7338,21 @@ const getConfigTemplate = (build, { profile }) => {
     cloudfrontDistributionId: process.env.HOT_UPDATER_CLOUDFRONT_DISTRIBUTION_ID!,
   })`
 	};
-	let intermediate = "";
-	if (profile) intermediate = `
+	let helperStatements = [];
+	if (profile) helperStatements = [{
+		name: "commonOptions",
+		strategy: "merge-object",
+		code: `
 const commonOptions = {
   bucketName: process.env.HOT_UPDATER_S3_BUCKET_NAME!,
   region: process.env.HOT_UPDATER_S3_REGION!,
   credentials: fromSSO({ profile: process.env.HOT_UPDATER_AWS_PROFILE! }),
-};`.trim();
-	else intermediate = `
+};`.trim()
+	}];
+	else helperStatements = [{
+		name: "commonOptions",
+		strategy: "merge-object",
+		code: `
 const commonOptions = {
   bucketName: process.env.HOT_UPDATER_S3_BUCKET_NAME!,
   region: process.env.HOT_UPDATER_S3_REGION!,
@@ -7354,13 +7360,14 @@ const commonOptions = {
     accessKeyId: process.env.HOT_UPDATER_S3_ACCESS_KEY_ID!,
     secretAccessKey: process.env.HOT_UPDATER_S3_SECRET_ACCESS_KEY!,
   },
-};`.trim();
-	const builder = new ConfigBuilder().setBuildType(build).setStorage(storageConfig).setDatabase(databaseConfig);
+};`.trim()
+	}];
+	const builder = new ConfigBuilder().setBuildType(build).setStorage(storageConfig).setDatabase(databaseConfig).setIntermediateCode(helperStatements.map((statement) => statement.code.trim()).join("\n\n"));
 	if (profile) builder.addImport({
 		pkg: "@aws-sdk/credential-provider-sso",
 		named: ["fromSSO"]
 	});
-	return builder.setIntermediateCode(intermediate).getResult();
+	return createHotUpdaterConfigScaffoldFromBuilder(builder, { helperStatements });
 };
 const SOURCE_TEMPLATE = `// Add this to your App.tsx
 import { HotUpdater } from "@hot-updater/react-native";
@@ -7530,7 +7537,7 @@ const runInit = async ({ build }) => {
 		distributionId,
 		accountId
 	});
-	await fs.promises.writeFile("hot-updater.config.ts", getConfigTemplate(build, { profile: ssoProfile }));
+	const configWriteResult = await writeHotUpdaterConfig(getConfigScaffold(build, { profile: ssoProfile }));
 	await makeEnv({
 		HOT_UPDATER_S3_BUCKET_NAME: bucketName,
 		HOT_UPDATER_S3_REGION: bucketRegion,
@@ -7549,7 +7556,9 @@ const runInit = async ({ build }) => {
 	});
 	if (mode === "sso") await ensureInstallPackages({ devDependencies: ["@aws-sdk/credential-provider-sso"] });
 	p.log.success("Generated '.env.hotupdater' file with AWS settings.");
-	p.log.success("Generated 'hot-updater.config.ts' file with AWS settings.");
+	if (configWriteResult.status === "created") p.log.success("Generated 'hot-updater.config.ts' file with AWS settings.");
+	else if (configWriteResult.status === "merged") p.log.success("Updated 'hot-updater.config.ts' file with AWS settings.");
+	else p.log.warn(`Kept existing 'hot-updater.config.ts' unchanged: ${configWriteResult.reason}`);
 	const sourceUrl = `https://${distributionDomain}/api/check-update`;
 	p.note(transformTemplate(SOURCE_TEMPLATE, { source: sourceUrl }));
 	p.log.message(`Next step: ${link("https://hot-updater.dev/docs/managed/aws#step-4-changeenv-file-optional")}`);

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import * as _$_hot_updater_plugin_core0 from "@hot-updater/plugin-core";
-import { StoragePlugin, StoragePluginHooks, StorageResolveContext } from "@hot-updater/plugin-core";
+import { BlobDatabasePluginConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext } from "@hot-updater/plugin-core";
 import { S3ClientConfig } from "@aws-sdk/client-s3";
 
 //#region src/s3Database.d.ts
-interface S3DatabaseConfig extends S3ClientConfig {
+interface S3DatabaseConfig extends S3ClientConfig, BlobDatabasePluginConfig {
   bucketName: string;
   /**
    * CloudFront distribution ID used for cache invalidation.

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import { S3ClientConfig } from "@aws-sdk/client-s3";
 import * as _$_hot_updater_plugin_core0 from "@hot-updater/plugin-core";
-import { StoragePlugin, StoragePluginHooks, StorageResolveContext } from "@hot-updater/plugin-core";
+import { BlobDatabasePluginConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext } from "@hot-updater/plugin-core";
 
 //#region src/s3Database.d.ts
-interface S3DatabaseConfig extends S3ClientConfig {
+interface S3DatabaseConfig extends S3ClientConfig, BlobDatabasePluginConfig {
   bucketName: string;
   /**
    * CloudFront distribution ID used for cache invalidation.

package/dist/lambda/index.cjs

@@ -1577,11 +1577,71 @@ function mergeWith(target, source, merge) {
 //#endregion
 //#region ../plugin-core/dist/createDatabasePlugin.mjs
 const REPLACE_ON_UPDATE_KEYS = ["targetCohorts"];
+const DEFAULT_DESC_ORDER$1 = {
+	field: "id",
+	direction: "desc"
+};
+function normalizePage(value) {
+	if (!Number.isInteger(value) || value === void 0 || value < 1) return;
+	return value;
+}
 function mergeBundleUpdate(baseBundle, patch) {
 	return mergeWith(baseBundle, patch, (_targetValue, sourceValue, key) => {
 		if (REPLACE_ON_UPDATE_KEYS.includes(key)) return sourceValue;
 	});
 }
+function mergeIdFilter(base, patch) {
+	return {
+		...base,
+		...patch
+	};
+}
+function mergeWhereWithIdFilter(where, idFilter) {
+	return {
+		...where,
+		id: mergeIdFilter(where?.id, idFilter)
+	};
+}
+function buildCursorPageQuery(where, cursor, orderBy) {
+	const direction = orderBy.direction;
+	if (cursor.after) return {
+		reverseData: false,
+		where: mergeWhereWithIdFilter(where, { [direction === "desc" ? "lt" : "gt"]: cursor.after }),
+		orderBy
+	};
+	if (cursor.before) return {
+		reverseData: true,
+		where: mergeWhereWithIdFilter(where, { [direction === "desc" ? "gt" : "lt"]: cursor.before }),
+		orderBy: {
+			field: orderBy.field,
+			direction: direction === "desc" ? "asc" : "desc"
+		}
+	};
+	return {
+		reverseData: false,
+		where: where ?? {},
+		orderBy
+	};
+}
+function buildCountBeforeWhere(where, firstBundleId, orderBy) {
+	return mergeWhereWithIdFilter(where, { [orderBy.direction === "desc" ? "gt" : "lt"]: firstBundleId });
+}
+function createPaginatedResult(total, limit, startIndex, data) {
+	const pagination = calculatePagination(total, {
+		limit,
+		offset: startIndex
+	});
+	const nextCursor = data.length > 0 && startIndex + data.length < total ? data.at(-1)?.id : void 0;
+	const previousCursor = data.length > 0 && startIndex > 0 ? data[0]?.id : void 0;
+	return {
+		data,
+		pagination: {
+			...pagination,
+			...nextCursor ? { nextCursor } : {},
+			...previousCursor ? { previousCursor } : {}
+		}
+	};
+}
 /**
 * Creates a database plugin with lazy initialization and automatic hook execution.
 *
@@ -1623,6 +1683,59 @@ function createDatabasePlugin(options) {
 					data
 				});
 			};
+			const runGetBundles = async (options, context) => {
+				if (context === void 0) return getMethods().getBundles(options);
+				return getMethods().getBundles(options, context);
+			};
+			const getBundlesWithLegacyCursorFallback = async (options, context) => {
+				const orderBy = options.orderBy ?? DEFAULT_DESC_ORDER$1;
+				const baseWhere = options.where;
+				const total = (await runGetBundles({
+					where: baseWhere,
+					limit: 1,
+					offset: 0,
+					orderBy
+				}, context)).pagination.total;
+				if (!options.cursor?.after && !options.cursor?.before) {
+					const firstPage = await runGetBundles({
+						where: baseWhere,
+						limit: options.limit,
+						offset: 0,
+						orderBy
+					}, context);
+					return createPaginatedResult(total, options.limit, 0, firstPage.data);
+				}
+				const { where, orderBy: queryOrderBy, reverseData } = buildCursorPageQuery(baseWhere, options.cursor, orderBy);
+				const cursorPage = await runGetBundles({
+					where,
+					limit: options.limit,
+					offset: 0,
+					orderBy: queryOrderBy
+				}, context);
+				const data = reverseData ? cursorPage.data.slice().reverse() : cursorPage.data;
+				if (data.length === 0) {
+					const emptyStartIndex = options.cursor.after ? total : 0;
+					return {
+						data,
+						pagination: {
+							...calculatePagination(total, {
+								limit: options.limit,
+								offset: emptyStartIndex
+							}),
+							...options.cursor.after ? { previousCursor: options.cursor.after } : {},
+							...options.cursor.before ? { nextCursor: options.cursor.before } : {}
+						}
+					};
+				}
+				const firstBundleId = data[0].id;
+				const countBeforeResult = await runGetBundles({
+					where: buildCountBeforeWhere(baseWhere, firstBundleId, orderBy),
+					limit: 1,
+					offset: 0,
+					orderBy
+				}, context);
+				return createPaginatedResult(total, options.limit, countBeforeResult.pagination.total, data);
+			};
 			const plugin = {
 				name: options.name,
 				async getBundleById(bundleId, context) {
@@ -1630,8 +1743,35 @@ function createDatabasePlugin(options) {
 					return getMethods().getBundleById(bundleId, context);
 				},
 				async getBundles(options, context) {
-					if (context === void 0) return getMethods().getBundles(options);
-					return getMethods().getBundles(options, context);
+					if (typeof options === "object" && options !== null && "offset" in options && options.offset !== void 0) throw new Error("Bundle offset pagination has been removed. Use cursor.after or cursor.before instead.");
+					const methods = getMethods();
+					const normalizedOptions = {
+						...options,
+						page: normalizePage(options.page),
+						orderBy: options.orderBy ?? DEFAULT_DESC_ORDER$1
+					};
+					if (normalizedOptions.page !== void 0) {
+						const { page, ...pageOptions } = normalizedOptions;
+						const requestedOffset = (page - 1) * normalizedOptions.limit;
+						let pageResult = await runGetBundles({
+							...pageOptions,
+							offset: requestedOffset
+						}, context);
+						const total = pageResult.pagination.total;
+						const totalPages = total === 0 ? 0 : Math.ceil(total / normalizedOptions.limit);
+						const maxOffset = totalPages === 0 ? 0 : (Math.max(1, totalPages) - 1) * normalizedOptions.limit;
+						const resolvedOffset = Math.min(requestedOffset, maxOffset);
+						if (resolvedOffset !== requestedOffset) pageResult = await runGetBundles({
+							...pageOptions,
+							offset: resolvedOffset
+						}, context);
+						return createPaginatedResult(total, normalizedOptions.limit, resolvedOffset, pageResult.data);
+					}
+					if (methods.supportsCursorPagination) {
+						if (context === void 0) return methods.getBundles(normalizedOptions);
+						return methods.getBundles(normalizedOptions, context);
+					}
+					return getBundlesWithLegacyCursorFallback(normalizedOptions, context);
 				},
 				async getChannels(context) {
 					if (context === void 0) return getMethods().getChannels();
@@ -3084,6 +3224,56 @@ function sortBundles$1(bundles, orderBy) {
 	});
 }
 //#endregion
+//#region ../plugin-core/dist/paginateBundles.mjs
+function paginateBundles({ bundles, limit, offset, cursor, orderBy }) {
+	const sortedBundles = sortBundles$1(bundles, orderBy);
+	const direction = orderBy?.direction ?? "desc";
+	const total = sortedBundles.length;
+	if (offset !== void 0) {
+		const normalizedOffset = Math.max(0, offset);
+		const data = limit > 0 ? sortedBundles.slice(normalizedOffset, normalizedOffset + limit) : sortedBundles.slice(normalizedOffset);
+		const pagination = calculatePagination(total, {
+			limit,
+			offset: normalizedOffset
+		});
+		const nextCursor = data.length > 0 && normalizedOffset + data.length < total ? data.at(-1)?.id : void 0;
+		const previousCursor = data.length > 0 && normalizedOffset > 0 ? data[0]?.id : void 0;
+		return {
+			data,
+			pagination: {
+				...pagination,
+				...nextCursor ? { nextCursor } : {},
+				...previousCursor ? { previousCursor } : {}
+			}
+		};
+	}
+	let data;
+	if (cursor?.after) {
+		const candidates = sortedBundles.filter((bundle) => direction === "desc" ? bundle.id.localeCompare(cursor.after) < 0 : bundle.id.localeCompare(cursor.after) > 0);
+		data = limit > 0 ? candidates.slice(0, limit) : candidates;
+	} else if (cursor?.before) {
+		const candidates = sortedBundles.filter((bundle) => direction === "desc" ? bundle.id.localeCompare(cursor.before) > 0 : bundle.id.localeCompare(cursor.before) < 0);
+		data = limit > 0 ? candidates.slice(Math.max(0, candidates.length - limit)) : candidates;
+	} else data = limit > 0 ? sortedBundles.slice(0, limit) : sortedBundles;
+	const startIndex = data.length > 0 ? sortedBundles.findIndex((bundle) => bundle.id === data[0].id) : cursor?.after ? total : 0;
+	const pagination = calculatePagination(total, {
+		limit,
+		offset: startIndex
+	});
+	const nextCursor = data.length > 0 && startIndex + data.length < total ? data.at(-1)?.id : void 0;
+	const previousCursor = data.length > 0 && startIndex > 0 ? data[0]?.id : void 0;
+	return {
+		data,
+		pagination: {
+			...pagination,
+			...nextCursor ? { nextCursor } : {},
+			...previousCursor ? { previousCursor } : {},
+			...data.length === 0 && cursor?.after ? { previousCursor: cursor.after } : {},
+			...data.length === 0 && cursor?.before ? { nextCursor: cursor.before } : {}
+		}
+	};
+}
+//#endregion
 //#region ../js/dist/index.mjs
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -4490,6 +4680,135 @@ function resolveStorageTarget({ targetAppVersion, fingerprintHash }) {
 	if (!target) throw new Error("target not found");
 	return target;
 }
+const DEFAULT_DESC_ORDER = {
+	field: "id",
+	direction: "desc"
+};
+const MANAGEMENT_INDEX_PREFIX = "_index";
+const MANAGEMENT_INDEX_VERSION = 1;
+const DEFAULT_MANAGEMENT_INDEX_PAGE_SIZE = 128;
+const ALL_SCOPE_CACHE_KEY = "*|*";
+function resolveManagementIndexPageSize(config) {
+	const pageSize = config.managementIndexPageSize ?? DEFAULT_MANAGEMENT_INDEX_PAGE_SIZE;
+	if (!Number.isInteger(pageSize) || pageSize < 1) throw new Error("managementIndexPageSize must be a positive integer.");
+	return pageSize;
+}
+function sortManagedBundles(bundles, orderBy = DEFAULT_DESC_ORDER) {
+	return sortBundles$1(bundles, orderBy);
+}
+function isDefaultManagementOrder(orderBy) {
+	return orderBy === void 0 || orderBy.field === DEFAULT_DESC_ORDER.field && orderBy.direction === DEFAULT_DESC_ORDER.direction;
+}
+function hasUnsupportedManagementFilters(where) {
+	if (!where) return false;
+	return Boolean(where.enabled !== void 0 || where.id !== void 0 || where.targetAppVersion !== void 0 || where.targetAppVersionIn !== void 0 || where.targetAppVersionNotNull !== void 0 || where.fingerprintHash !== void 0);
+}
+function getSupportedManagementScope(where, orderBy) {
+	if (!isDefaultManagementOrder(orderBy) || hasUnsupportedManagementFilters(where)) return null;
+	return {
+		channel: where?.channel,
+		platform: where?.platform
+	};
+}
+function encodeScopePart(value) {
+	return encodeURIComponent(value);
+}
+function getManagementScopeCacheKey({ channel, platform }) {
+	return `${channel ?? "*"}|${platform ?? "*"}`;
+}
+function getManagementScopePrefix({ channel, platform }) {
+	if (channel && platform) return `${MANAGEMENT_INDEX_PREFIX}/channel/${encodeScopePart(channel)}/platform/${platform}`;
+	if (channel) return `${MANAGEMENT_INDEX_PREFIX}/channel/${encodeScopePart(channel)}`;
+	if (platform) return `${MANAGEMENT_INDEX_PREFIX}/platform/${platform}`;
+	return `${MANAGEMENT_INDEX_PREFIX}/all`;
+}
+function getManagementRootKey(scope) {
+	return `${getManagementScopePrefix(scope)}/root.json`;
+}
+function getManagementPageKey(scope, pageIndex) {
+	return `${getManagementScopePrefix(scope)}/pages/${String(pageIndex).padStart(4, "0")}.json`;
+}
+function createBundleWithUpdateJsonKey(bundle) {
+	const target = resolveStorageTarget(bundle);
+	return {
+		...bundle,
+		_updateJsonKey: `${bundle.channel}/${bundle.platform}/${target}/update.json`
+	};
+}
+function getPageStartOffsets(pages) {
+	const startOffsets = [];
+	let offset = 0;
+	for (const page of pages) {
+		startOffsets.push(offset);
+		offset += page.count;
+	}
+	return startOffsets;
+}
+function createEmptyManagementResult(limit) {
+	return {
+		data: [],
+		pagination: calculatePagination(0, {
+			limit,
+			offset: 0
+		})
+	};
+}
+function buildManagementIndexArtifacts(allBundles, pageSize) {
+	const sortedAllBundles = sortManagedBundles(allBundles);
+	const pages = /* @__PURE__ */ new Map();
+	const scopes = [];
+	const channels = [...new Set(sortedAllBundles.map((bundle) => bundle.channel))].sort();
+	const addScope = (scope, scopeBundles, options) => {
+		if (!options?.includeChannels && scopeBundles.length === 0) return;
+		const pageKeys = [];
+		const pageDescriptors = [];
+		for (let pageIndex = 0; pageIndex * pageSize < scopeBundles.length; pageIndex++) {
+			const page = scopeBundles.slice(pageIndex * pageSize, (pageIndex + 1) * pageSize);
+			const key = getManagementPageKey(scope, pageIndex);
+			pages.set(key, page);
+			pageKeys.push(key);
+			pageDescriptors.push({
+				key,
+				count: page.length,
+				firstId: page[0].id,
+				lastId: page.at(-1).id
+			});
+		}
+		const root = {
+			version: MANAGEMENT_INDEX_VERSION,
+			pageSize,
+			total: scopeBundles.length,
+			pages: pageDescriptors,
+			...options?.includeChannels ? { channels } : {}
+		};
+		scopes.push({
+			cacheKey: getManagementScopeCacheKey(scope),
+			rootKey: getManagementRootKey(scope),
+			root,
+			pageKeys
+		});
+	};
+	addScope({}, sortedAllBundles, { includeChannels: true });
+	for (const channel of channels) {
+		const channelBundles = sortedAllBundles.filter((bundle) => bundle.channel === channel);
+		addScope({ channel }, channelBundles);
+		for (const platform of ["ios", "android"]) {
+			const scopedBundles = channelBundles.filter((bundle) => bundle.platform === platform);
+			addScope({
+				channel,
+				platform
+			}, scopedBundles);
+		}
+	}
+	for (const platform of ["ios", "android"]) {
+		const platformBundles = sortedAllBundles.filter((bundle) => bundle.platform === platform);
+		addScope({ platform }, platformBundles);
+	}
+	return {
+		pages,
+		scopes
+	};
+}
 /**
 * Creates a blob storage-based database plugin with lazy initialization.
 *
@@ -4499,22 +4818,282 @@ function resolveStorageTarget({ targetAppVersion, fingerprintHash }) {
 */
 const createBlobDatabasePlugin = ({ name, factory }) => {
 	return (config, hooks) => {
+		const managementIndexPageSize = resolveManagementIndexPageSize(config);
 		const { listObjects, loadObject, uploadObject, deleteObject, invalidatePaths, apiBasePath } = factory(config);
 		const bundlesMap = /* @__PURE__ */ new Map();
 		const pendingBundlesMap = /* @__PURE__ */ new Map();
+		const managementRootCache = /* @__PURE__ */ new Map();
 		const PLATFORMS = ["ios", "android"];
+		const getAllManagementArtifact = (artifacts) => {
+			const allArtifact = artifacts.scopes.find((scope) => scope.cacheKey === ALL_SCOPE_CACHE_KEY);
+			if (!allArtifact) throw new Error("all-bundles management index artifact not found");
+			return allArtifact;
+		};
+		const replaceManagementRootCache = (artifacts) => {
+			managementRootCache.clear();
+			for (const scope of artifacts.scopes) managementRootCache.set(scope.cacheKey, scope.root);
+		};
+		const createHydratedBundle = (bundle) => {
+			const hydratedBundle = createBundleWithUpdateJsonKey(bundle);
+			bundlesMap.set(hydratedBundle.id, hydratedBundle);
+			return hydratedBundle;
+		};
+		const loadStoredManagementRoot = async (scope) => {
+			const cacheKey = getManagementScopeCacheKey(scope);
+			const storedRoot = await loadObject(getManagementRootKey(scope));
+			if (storedRoot) {
+				managementRootCache.set(cacheKey, storedRoot);
+				return storedRoot;
+			}
+			managementRootCache.delete(cacheKey);
+			return null;
+		};
+		const loadManagementPage = async (descriptor, pageCache) => {
+			if (pageCache?.has(descriptor.key)) return pageCache.get(descriptor.key) ?? null;
+			const page = await loadObject(descriptor.key);
+			pageCache?.set(descriptor.key, page);
+			return page;
+		};
+		const loadBundleFromManagementRoot = async (root, bundleId) => {
+			const pageIndex = findPageIndexContainingId(root.pages, bundleId);
+			if (pageIndex < 0) return null;
+			const descriptor = root.pages[pageIndex];
+			const page = await loadManagementPage(descriptor);
+			if (!page) return null;
+			return page.find((item) => item.id === bundleId) ?? null;
+		};
+		const loadAllBundlesFromRoot = async (root) => {
+			const allBundles = [];
+			const pageCache = /* @__PURE__ */ new Map();
+			for (const descriptor of root.pages) {
+				const page = await loadManagementPage(descriptor, pageCache);
+				if (!page) return null;
+				allBundles.push(...page);
+			}
+			return allBundles;
+		};
+		const persistManagementIndexArtifacts = async (nextArtifacts, previousArtifacts) => {
+			for (const [key, page] of nextArtifacts.pages.entries()) await uploadObject(key, page);
+			for (const scope of nextArtifacts.scopes) await uploadObject(scope.rootKey, scope.root);
+			if (!previousArtifacts) return;
+			const nextPageKeys = new Set(nextArtifacts.pages.keys());
+			const nextRootKeys = new Set(nextArtifacts.scopes.map((scope) => scope.rootKey));
+			for (const [key] of previousArtifacts.pages.entries()) if (!nextPageKeys.has(key)) await deleteObject(key).catch(() => {});
+			for (const scope of previousArtifacts.scopes) if (!nextRootKeys.has(scope.rootKey)) await deleteObject(scope.rootKey).catch(() => {});
+		};
+		const ensureAllManagementRoot = async () => {
+			const storedAllRoot = await loadStoredManagementRoot({});
+			if (storedAllRoot && storedAllRoot.pageSize === managementIndexPageSize) return storedAllRoot;
+			const rebuiltBundles = sortManagedBundles((await reloadBundles()).map((bundle) => removeBundleInternalKeys(bundle)));
+			const nextArtifacts = buildManagementIndexArtifacts(rebuiltBundles, managementIndexPageSize);
+			await persistManagementIndexArtifacts(nextArtifacts, storedAllRoot ? buildManagementIndexArtifacts(rebuiltBundles, storedAllRoot.pageSize) : void 0);
+			replaceManagementRootCache(nextArtifacts);
+			return getAllManagementArtifact(nextArtifacts).root;
+		};
+		const loadManagementScopeRoot = async (scope) => {
+			const cacheKey = getManagementScopeCacheKey(scope);
+			if (cacheKey === ALL_SCOPE_CACHE_KEY) return ensureAllManagementRoot();
+			const storedRoot = await loadStoredManagementRoot(scope);
+			if (storedRoot) return storedRoot;
+			await ensureAllManagementRoot();
+			const storedScopedRoot = await loadStoredManagementRoot(scope);
+			if (storedScopedRoot) return storedScopedRoot;
+			managementRootCache.set(cacheKey, null);
+			return null;
+		};
+		const loadAllBundlesForManagementFallback = async () => {
+			const allRoot = await loadManagementScopeRoot({});
+			if (allRoot) {
+				const pagedBundles = await loadAllBundlesFromRoot(allRoot);
+				if (pagedBundles) return pagedBundles;
+			}
+			return sortManagedBundles((await reloadBundles()).map((bundle) => removeBundleInternalKeys(bundle)));
+		};
+		const loadCurrentBundlesForIndexRebuild = async () => {
+			return loadAllBundlesForManagementFallback();
+		};
+		const findPageIndexContainingId = (pages, id) => {
+			return pages.findIndex((page) => id.localeCompare(page.firstId) <= 0 && id.localeCompare(page.lastId) >= 0);
+		};
+		const readPagedBundles = async ({ root, limit, offset, cursor }) => {
+			if (root.total === 0 || root.pages.length === 0) return createEmptyManagementResult(limit);
+			const pageStartOffsets = getPageStartOffsets(root.pages);
+			const pageCache = /* @__PURE__ */ new Map();
+			if (offset !== void 0) {
+				const normalizedOffset = Math.max(0, offset);
+				if (normalizedOffset >= root.total) return {
+					data: [],
+					pagination: calculatePagination(root.total, {
+						limit,
+						offset: normalizedOffset
+					})
+				};
+				let pageIndex = 0;
+				for (let index = pageStartOffsets.length - 1; index >= 0; index--) if ((pageStartOffsets[index] ?? 0) <= normalizedOffset) {
+					pageIndex = index;
+					break;
+				}
+				const startInPage = normalizedOffset - (pageStartOffsets[pageIndex] ?? 0);
+				const data = [];
+				for (let currentPageIndex = pageIndex; currentPageIndex < root.pages.length && (limit <= 0 || data.length < limit); currentPageIndex++) {
+					const descriptor = root.pages[currentPageIndex];
+					const page = await loadManagementPage(descriptor, pageCache);
+					if (!page) return paginateBundles({
+						bundles: await loadAllBundlesForManagementFallback(),
+						limit,
+						offset: normalizedOffset
+					});
+					data.push(...currentPageIndex === pageIndex ? page.slice(startInPage) : page);
+				}
+				const paginatedData = limit > 0 ? data.slice(0, limit) : data;
+				return {
+					data: paginatedData,
+					pagination: {
+						...calculatePagination(root.total, {
+							limit,
+							offset: normalizedOffset
+						}),
+						...paginatedData.length > 0 && normalizedOffset + paginatedData.length < root.total ? { nextCursor: paginatedData.at(-1)?.id } : {},
+						...paginatedData.length > 0 && normalizedOffset > 0 ? { previousCursor: paginatedData[0]?.id } : {}
+					}
+				};
+			}
+			if (cursor?.after) {
+				let pageIndex = root.pages.findIndex((page) => {
+					const containsCursor = cursor.after.localeCompare(page.firstId) <= 0 && cursor.after.localeCompare(page.lastId) >= 0;
+					const wholePageEligible = cursor.after.localeCompare(page.firstId) > 0;
+					return containsCursor || wholePageEligible;
+				});
+				if (pageIndex < 0) return {
+					data: [],
+					pagination: {
+						...calculatePagination(root.total, {
+							limit,
+							offset: root.total
+						}),
+						previousCursor: cursor.after
+					}
+				};
+				const data = [];
+				let startIndex = null;
+				while (pageIndex < root.pages.length && (limit <= 0 || data.length < limit)) {
+					const descriptor = root.pages[pageIndex];
+					const page = await loadManagementPage(descriptor, pageCache);
+					if (!page) return paginateBundles({
+						bundles: await loadAllBundlesForManagementFallback(),
+						limit,
+						cursor
+					});
+					const containsCursor = cursor.after.localeCompare(descriptor.firstId) <= 0 && cursor.after.localeCompare(descriptor.lastId) >= 0;
+					let eligiblePageBundles = page;
+					if (containsCursor) {
+						const startInPage = page.findIndex((bundle) => bundle.id.localeCompare(cursor.after) < 0);
+						if (startInPage < 0) eligiblePageBundles = [];
+						else {
+							eligiblePageBundles = page.slice(startInPage);
+							startIndex ??= (pageStartOffsets[pageIndex] ?? 0) + startInPage;
+						}
+					} else if (eligiblePageBundles.length > 0) startIndex ??= pageStartOffsets[pageIndex] ?? 0;
+					data.push(...eligiblePageBundles);
+					if (limit > 0 && data.length >= limit) break;
+					pageIndex += 1;
+				}
+				const paginatedData = limit > 0 ? data.slice(0, limit) : data;
+				const resolvedStartIndex = startIndex ?? root.total;
+				return {
+					data: paginatedData,
+					pagination: {
+						...calculatePagination(root.total, {
+							limit,
+							offset: resolvedStartIndex
+						}),
+						...paginatedData.length > 0 && resolvedStartIndex + paginatedData.length < root.total ? { nextCursor: paginatedData.at(-1)?.id } : {},
+						...paginatedData.length > 0 && resolvedStartIndex > 0 ? { previousCursor: paginatedData[0]?.id } : {}
+					}
+				};
+			}
+			if (cursor?.before) {
+				let pageIndex = -1;
+				for (let index = root.pages.length - 1; index >= 0; index--) {
+					const page = root.pages[index];
+					const containsCursor = cursor.before.localeCompare(page.firstId) <= 0 && cursor.before.localeCompare(page.lastId) >= 0;
+					const wholePageEligible = cursor.before.localeCompare(page.lastId) < 0;
+					if (containsCursor || wholePageEligible) {
+						pageIndex = index;
+						break;
+					}
+				}
+				if (pageIndex < 0) return createEmptyManagementResult(limit);
+				let startIndex = null;
+				let collected = [];
+				while (pageIndex >= 0 && (limit <= 0 || collected.length < limit)) {
+					const descriptor = root.pages[pageIndex];
+					const page = await loadManagementPage(descriptor, pageCache);
+					if (!page) return paginateBundles({
+						bundles: await loadAllBundlesForManagementFallback(),
+						limit,
+						cursor
+					});
+					const eligiblePageBundles = cursor.before.localeCompare(descriptor.firstId) <= 0 && cursor.before.localeCompare(descriptor.lastId) >= 0 ? page.filter((bundle) => bundle.id.localeCompare(cursor.before) > 0) : page;
+					collected = [...eligiblePageBundles, ...collected];
+					if (eligiblePageBundles.length > 0) startIndex = pageStartOffsets[pageIndex] ?? 0;
+					if (limit > 0 && collected.length >= limit) break;
+					pageIndex -= 1;
+				}
+				if (startIndex === null || collected.length === 0) return createEmptyManagementResult(limit);
+				let paginatedData = collected;
+				if (limit > 0 && collected.length > limit) {
+					const dropCount = collected.length - limit;
+					paginatedData = collected.slice(dropCount);
+					startIndex += dropCount;
+				}
+				const pagination = calculatePagination(root.total, {
+					limit,
+					offset: startIndex
+				});
+				return {
+					data: paginatedData,
+					pagination: {
+						...pagination,
+						...paginatedData.length > 0 && startIndex + paginatedData.length < root.total ? { nextCursor: paginatedData.at(-1)?.id } : {},
+						...paginatedData.length > 0 && startIndex > 0 ? { previousCursor: paginatedData[0]?.id } : {}
+					}
+				};
+			}
+			const pageIndex = 0;
+			const startInPage = 0;
+			const data = [];
+			for (let currentPageIndex = pageIndex; currentPageIndex < root.pages.length && (limit <= 0 || data.length < limit); currentPageIndex++) {
+				const descriptor = root.pages[currentPageIndex];
+				const page = await loadManagementPage(descriptor, pageCache);
+				if (!page) return paginateBundles({
+					bundles: await loadAllBundlesForManagementFallback(),
+					limit,
+					cursor
+				});
+				data.push(...currentPageIndex === pageIndex ? page.slice(startInPage) : page);
+			}
+			const paginatedData = limit > 0 ? data.slice(0, limit) : data;
+			return {
+				data: paginatedData,
+				pagination: {
+					...calculatePagination(root.total, {
+						limit,
+						offset: 0
+					}),
+					...paginatedData.length > 0 && paginatedData.length < root.total ? { nextCursor: paginatedData.at(-1)?.id } : {}
+				}
+			};
+		};
 		async function reloadBundles() {
 			bundlesMap.clear();
-			const platformPromises = PLATFORMS.map(async (platform) => {
-				const filePromises = (await listUpdateJsonKeys(platform)).map(async (key) => {
-					return (await loadObject(key) ?? []).map((bundle) => ({
-						...bundle,
-						_updateJsonKey: key
-					}));
-				});
-				return (await Promise.all(filePromises)).flat();
+			const filePromises = (await listObjects("")).filter((key) => /^[^/]+\/(?:ios|android)\/[^/]+\/update\.json$/.test(key)).map(async (key) => {
+				return (await loadObject(key) ?? []).map((bundle) => ({
+					...bundle,
+					_updateJsonKey: key
+				}));
 			});
-			const allBundles = (await Promise.all(platformPromises)).flat();
+			const allBundles = (await Promise.all(filePromises)).flat();
 			for (const bundle of allBundles) bundlesMap.set(bundle.id, bundle);
 			for (const [id, bundle] of pendingBundlesMap.entries()) bundlesMap.set(id, bundle);
 			return orderBy(allBundles, [(v) => v.id], ["desc"]);
@@ -4549,17 +5128,6 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 				if (JSON.stringify(oldTargetVersions) !== JSON.stringify(newTargetVersions)) await uploadObject(targetKey, newTargetVersions);
 			}
 		}
-		/**
-		* Lists update.json keys for a given platform.
-		*
-		* - If a channel is provided, only that channel's update.json files are listed.
-		* - Otherwise, all channels for the given platform are returned.
-		*/
-		async function listUpdateJsonKeys(platform, channel) {
-			const prefix = channel ? platform ? `${channel}/${platform}/` : `${channel}/` : "";
-			const pattern = channel ? platform ? new RegExp(`^${channel}/${platform}/[^/]+/update\\.json$`) : new RegExp(`^${channel}/[^/]+/[^/]+/update\\.json$`) : platform ? new RegExp(`^[^/]+/${platform}/[^/]+/update\\.json$`) : /^[^/]+\/[^/]+\/[^/]+\/update\.json$/;
-			return listObjects(prefix).then((keys) => keys.filter((key) => pattern.test(key)));
-		}
 		const getAppVersionUpdateInfo = async ({ appVersion, bundleId, channel = "production", cohort, minBundleId, platform }) => {
 			const matchingVersions = filterCompatibleAppVersions(await loadObject(`${channel}/${platform}/target-app-versions.json`) ?? [], appVersion);
 			return getUpdateInfo((await Promise.allSettled(matchingVersions.map(async (targetAppVersion) => {
@@ -4607,41 +5175,56 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 		return createDatabasePlugin({
 			name,
 			factory: () => ({
+				supportsCursorPagination: true,
 				async getBundleById(bundleId) {
 					const pendingBundle = pendingBundlesMap.get(bundleId);
 					if (pendingBundle) return removeBundleInternalKeys(pendingBundle);
 					const bundle = bundlesMap.get(bundleId);
 					if (bundle) return removeBundleInternalKeys(bundle);
-					return (await reloadBundles()).find((bundle) => bundle.id === bundleId) ?? null;
+					const allRoot = await loadManagementScopeRoot({});
+					if (allRoot) {
+						const matchedBundle = await loadBundleFromManagementRoot(allRoot, bundleId);
+						if (matchedBundle) return removeBundleInternalKeys(createHydratedBundle(matchedBundle));
+						managementRootCache.delete(ALL_SCOPE_CACHE_KEY);
+						const refreshedAllRoot = await loadStoredManagementRoot({});
+						if (refreshedAllRoot) {
+							const refreshedBundle = await loadBundleFromManagementRoot(refreshedAllRoot, bundleId);
+							if (refreshedBundle) return removeBundleInternalKeys(createHydratedBundle(refreshedBundle));
+						}
+					}
+					const matchedBundle = (await reloadBundles()).find((item) => item.id === bundleId);
+					if (!matchedBundle) return null;
+					return removeBundleInternalKeys(matchedBundle);
 				},
 				async getUpdateInfo(args) {
 					if (args._updateStrategy === "appVersion") return getAppVersionUpdateInfo(args);
 					return getFingerprintUpdateInfo(args);
 				},
 				async getBundles(options) {
-					let allBundles = await reloadBundles();
-					const { where, limit, offset, orderBy } = options;
-					if (where) allBundles = allBundles.filter((bundle) => bundleMatchesQueryWhere$1(bundle, where));
-					const cleanBundles = sortBundles$1(allBundles.map(removeBundleInternalKeys), orderBy);
-					const total = cleanBundles.length;
-					let paginatedData = cleanBundles;
-					if (offset > 0) paginatedData = paginatedData.slice(offset);
-					if (limit) paginatedData = paginatedData.slice(0, limit);
-					return {
-						data: paginatedData,
-						pagination: calculatePagination(total, {
+					const { where, limit, offset, orderBy, cursor } = options;
+					const scope = getSupportedManagementScope(where, orderBy);
+					if (scope) {
+						const root = await loadManagementScopeRoot(scope);
+						if (!root) return createEmptyManagementResult(limit);
+						return readPagedBundles({
+							root,
 							limit,
-							offset
-						})
-					};
+							offset,
+							cursor
+						});
+					}
+					let allBundles = await loadAllBundlesForManagementFallback();
+					if (where) allBundles = allBundles.filter((bundle) => bundleMatchesQueryWhere$1(bundle, where));
+					return paginateBundles({
+						bundles: allBundles,
+						limit,
+						offset,
+						cursor,
+						orderBy
+					});
 				},
 				async getChannels() {
-					const total = (await reloadBundles()).length;
-					const result = await this.getBundles({
-						limit: total,
-						offset: 0
-					});
-					return [...new Set(result.data.map((bundle) => bundle.channel))];
+					return (await loadManagementScopeRoot({}))?.channels ?? [];
 				},
 				async commitBundle({ changedSets }) {
 					if (changedSets.length === 0) return;
@@ -4738,6 +5321,20 @@ const createBlobDatabasePlugin = ({ name, factory }) => {
 						await uploadObject(key, currentBundles);
 					})();
 					if (isTargetAppVersionChanged || isChannelChanged) for (const platform of PLATFORMS) await updateTargetVersionsForPlatform(platform);
+					const currentIndexBundles = await loadCurrentBundlesForIndexRebuild();
+					const nextIndexMap = new Map(currentIndexBundles.map((bundle) => [bundle.id, bundle]));
+					for (const { operation, data } of changedSets) {
+						if (operation === "delete") {
+							nextIndexMap.delete(data.id);
+							continue;
+						}
+						nextIndexMap.set(data.id, data);
+					}
+					const nextIndexBundles = sortManagedBundles(Array.from(nextIndexMap.values()));
+					const previousArtifacts = buildManagementIndexArtifacts(currentIndexBundles, managementIndexPageSize);
+					const nextArtifacts = buildManagementIndexArtifacts(nextIndexBundles, managementIndexPageSize);
+					await persistManagementIndexArtifacts(nextArtifacts, previousArtifacts);
+					replaceManagementRootCache(nextArtifacts);
 					const encondedPaths = /* @__PURE__ */ new Set();
 					for (const path of pathsToInvalidate) encondedPaths.add(encodeURI(path));
 					await invalidatePaths(Array.from(encondedPaths));
@@ -4908,13 +5505,13 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 		return isCohortEligibleForUpdate(bundle.id, cohort, bundle.rolloutCohortCount, bundle.targetCohorts);
 	};
 	const findUpdateInfoByScanning = async ({ args, queryWhere, isCandidate, context }) => {
-		let offset = 0;
+		let after;
 		while (true) {
 			const { data, pagination } = await getSortedBundlePage({
 				where: queryWhere,
 				limit: PAGE_SIZE,
-				offset,
-				orderBy: DESC_ORDER
+				orderBy: DESC_ORDER,
+				...after ? { cursor: { after } } : {}
 			}, context);
 			for (const bundle of data) {
 				if (!bundleMatchesQueryWhere(bundle, queryWhere) || !isCandidate(bundle)) continue;
@@ -4934,7 +5531,8 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				return makeResponse(bundle, "ROLLBACK");
 			}
 			if (!pagination.hasNextPage) break;
-			offset += PAGE_SIZE;
+			after = data.at(-1)?.id;
+			if (!after) break;
 		}
 		if (args.bundleId === "00000000-0000-0000-0000-000000000000") return null;
 		if (args.minBundleId && args.bundleId.localeCompare(args.minBundleId) <= 0) return null;
@@ -5185,7 +5783,13 @@ const handleGetBundles = async (_params, request, api, context) => {
 	const channel = url.searchParams.get("channel") ?? void 0;
 	const platform = url.searchParams.get("platform");
 	const limit = Number(url.searchParams.get("limit")) || 50;
-	const offset = Number(url.searchParams.get("offset")) || 0;
+	const pageParam = url.searchParams.get("page");
+	const offset = url.searchParams.get("offset");
+	const after = url.searchParams.get("after") ?? void 0;
+	const before = url.searchParams.get("before") ?? void 0;
+	const page = pageParam === null ? void 0 : Number.isInteger(Number(pageParam)) && Number(pageParam) > 0 ? Number(pageParam) : null;
+	if (offset !== null) throw new HandlerBadRequestError("The 'offset' query parameter has been removed. Use 'after' or 'before' cursor pagination instead.");
+	if (page === null) throw new HandlerBadRequestError("The 'page' query parameter must be a positive integer.");
 	if (platform !== null && !isPlatform(platform)) throw new HandlerBadRequestError(`Invalid platform: ${platform}. Expected 'ios' or 'android'.`);
 	const result = await api.getBundles({
 		where: {
@@ -5193,7 +5797,11 @@ const handleGetBundles = async (_params, request, api, context) => {
 			...platform && { platform }
 		},
 		limit,
-		offset
+		page,
+		cursor: after || before ? {
+			after,
+			before
+		} : void 0
 	}, context);
 	return new Response(JSON.stringify(result), {
 		status: 200,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/aws",
   "type": "module",
-  "version": "0.29.5",
+  "version": "0.29.7",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -42,10 +42,10 @@
     "es-toolkit": "^1.32.0",
     "execa": "9.5.2",
     "mime": "^4.0.4",
-    "@hot-updater/core": "0.29.5",
-    "@hot-updater/js": "0.29.5",
-    "@hot-updater/mock": "0.29.5",
-    "@hot-updater/test-utils": "0.29.5"
+    "@hot-updater/core": "0.29.7",
+    "@hot-updater/js": "0.29.7",
+    "@hot-updater/mock": "0.29.7",
+    "@hot-updater/test-utils": "0.29.7"
   },
   "dependencies": {
     "@aws-sdk/client-cloudfront": "3.1008.0",
@@ -60,9 +60,9 @@
     "@aws-sdk/lib-storage": "3.1008.0",
     "hono": "4.12.9",
     "aws-lambda": "1.0.7",
-    "@hot-updater/plugin-core": "0.29.5",
-    "@hot-updater/cli-tools": "0.29.5",
-    "@hot-updater/server": "0.29.5"
+    "@hot-updater/plugin-core": "0.29.7",
+    "@hot-updater/server": "0.29.7",
+    "@hot-updater/cli-tools": "0.29.7"
   },
   "scripts": {
     "build": "tsdown",