@hot-updater/plugin-core 0.29.4 → 0.29.6

package/dist/index.mjs

@@ -1,13 +1,15 @@
 import { calculatePagination } from "./calculatePagination.mjs";
 import { detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.mjs";
 import { createDatabasePlugin } from "./createDatabasePlugin.mjs";
+import { semverSatisfies } from "./semverSatisfies.mjs";
+import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.mjs";
+import { paginateBundles } from "./paginateBundles.mjs";
 import { createBlobDatabasePlugin } from "./createBlobDatabasePlugin.mjs";
+import { createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.mjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.mjs";
 import { createStoragePlugin } from "./createStoragePlugin.mjs";
-import { semverSatisfies } from "./semverSatisfies.mjs";
-import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
 import { generateMinBundleId } from "./generateMinBundleId.mjs";
 import { parseStorageUri } from "./parseStorageUri.mjs";
 import { supportedIosPlatforms } from "./types/index.mjs";
-export { bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/paginateBundles.cjs

@@ -0,0 +1,53 @@
+const require_calculatePagination = require("./calculatePagination.cjs");
+const require_queryBundles = require("./queryBundles.cjs");
+//#region src/paginateBundles.ts
+function paginateBundles({ bundles, limit, offset, cursor, orderBy }) {
+	const sortedBundles = require_queryBundles.sortBundles(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 = require_calculatePagination.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 = require_calculatePagination.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
+exports.paginateBundles = paginateBundles;

package/dist/paginateBundles.d.cts

@@ -0,0 +1,18 @@
+import { Bundle, DatabaseBundleCursor, DatabaseBundleQueryOrder, Paginated } from "./types/index.cjs";
+
+//#region src/paginateBundles.d.ts
+declare function paginateBundles({
+  bundles,
+  limit,
+  offset,
+  cursor,
+  orderBy
+}: {
+  bundles: Bundle[];
+  limit: number;
+  offset?: number;
+  cursor?: DatabaseBundleCursor;
+  orderBy?: DatabaseBundleQueryOrder;
+}): Paginated<Bundle[]>;
+//#endregion
+export { paginateBundles };

package/dist/paginateBundles.d.mts

@@ -0,0 +1,18 @@
+import { Bundle, DatabaseBundleCursor, DatabaseBundleQueryOrder, Paginated } from "./types/index.mjs";
+
+//#region src/paginateBundles.d.ts
+declare function paginateBundles({
+  bundles,
+  limit,
+  offset,
+  cursor,
+  orderBy
+}: {
+  bundles: Bundle[];
+  limit: number;
+  offset?: number;
+  cursor?: DatabaseBundleCursor;
+  orderBy?: DatabaseBundleQueryOrder;
+}): Paginated<Bundle[]>;
+//#endregion
+export { paginateBundles };

package/dist/paginateBundles.mjs

@@ -0,0 +1,53 @@
+import { calculatePagination } from "./calculatePagination.mjs";
+import { sortBundles } from "./queryBundles.mjs";
+//#region src/paginateBundles.ts
+function paginateBundles({ bundles, limit, offset, cursor, orderBy }) {
+	const sortedBundles = sortBundles(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
+export { paginateBundles };

package/dist/types/index.d.cts

@@ -1,5 +1,5 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./utils.cjs";
-import { Bundle, Bundle as Bundle$1, Platform, Platform as Platform$1 } from "@hot-updater/core";
+import { AppVersionGetBundlesArgs as AppVersionGetBundlesArgs$1, Bundle, Bundle as Bundle$1, FingerprintGetBundlesArgs as FingerprintGetBundlesArgs$1, GetBundlesArgs, GetBundlesArgs as GetBundlesArgs$1, Platform, Platform as Platform$1, UpdateInfo, UpdateInfo as UpdateInfo$1 } from "@hot-updater/core";
 
 //#region src/types/index.d.ts
 interface BasePluginArgs {
@@ -11,6 +11,8 @@ interface PaginationInfo {
   hasPreviousPage: boolean;
   currentPage: number;
   totalPages: number;
+  nextCursor?: string | null;
+  previousCursor?: string | null;
 }
 interface Paginated<TData> {
   data: TData;
@@ -39,10 +41,32 @@ interface DatabaseBundleQueryOrder {
   field: "id";
   direction: "asc" | "desc";
 }
+interface DatabaseBundleCursor {
+  /**
+   * Fetch the next window after this bundle ID.
+   *
+   * This is the preferred pagination mode for bundle-management queries.
+   */
+  after?: string;
+  /**
+   * Fetch the previous window before this bundle ID.
+   *
+   * This is the preferred pagination mode for bundle-management queries.
+   */
+  before?: string;
+}
 interface DatabaseBundleQueryOptions {
   where?: DatabaseBundleQueryWhere;
   limit: number;
-  offset: number;
+  /**
+   * Optional page number used by management UIs to keep page boundaries stable
+   * even when new bundles are inserted ahead of the current cursor window.
+   */
+  page?: number;
+  /**
+   * Preferred cursor-based pagination for bundle-management queries.
+   */
+  cursor?: DatabaseBundleCursor;
   orderBy?: DatabaseBundleQueryOrder;
 }
 interface BuildPluginConfig {
@@ -51,6 +75,7 @@ interface BuildPluginConfig {
 interface DatabasePlugin<TContext = unknown> {
   getChannels: (context?: HotUpdaterContext<TContext>) => Promise<string[]>;
   getBundleById: (bundleId: string, context?: HotUpdaterContext<TContext>) => Promise<Bundle | null>;
+  getUpdateInfo?: (args: GetBundlesArgs, context?: HotUpdaterContext<TContext>) => Promise<UpdateInfo | null>;
   getBundles: (options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>) => Promise<Paginated<Bundle[]>>;
   updateBundle: (targetBundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>) => Promise<void>;
   appendBundle: (insertBundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
@@ -391,4 +416,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, supportedIosPlatforms };
+export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/dist/types/index.d.mts

@@ -1,5 +1,5 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./utils.mjs";
-import { Bundle, Bundle as Bundle$1, Platform, Platform as Platform$1 } from "@hot-updater/core";
+import { AppVersionGetBundlesArgs as AppVersionGetBundlesArgs$1, Bundle, Bundle as Bundle$1, FingerprintGetBundlesArgs as FingerprintGetBundlesArgs$1, GetBundlesArgs, GetBundlesArgs as GetBundlesArgs$1, Platform, Platform as Platform$1, UpdateInfo, UpdateInfo as UpdateInfo$1 } from "@hot-updater/core";
 
 //#region src/types/index.d.ts
 interface BasePluginArgs {
@@ -11,6 +11,8 @@ interface PaginationInfo {
   hasPreviousPage: boolean;
   currentPage: number;
   totalPages: number;
+  nextCursor?: string | null;
+  previousCursor?: string | null;
 }
 interface Paginated<TData> {
   data: TData;
@@ -39,10 +41,32 @@ interface DatabaseBundleQueryOrder {
   field: "id";
   direction: "asc" | "desc";
 }
+interface DatabaseBundleCursor {
+  /**
+   * Fetch the next window after this bundle ID.
+   *
+   * This is the preferred pagination mode for bundle-management queries.
+   */
+  after?: string;
+  /**
+   * Fetch the previous window before this bundle ID.
+   *
+   * This is the preferred pagination mode for bundle-management queries.
+   */
+  before?: string;
+}
 interface DatabaseBundleQueryOptions {
   where?: DatabaseBundleQueryWhere;
   limit: number;
-  offset: number;
+  /**
+   * Optional page number used by management UIs to keep page boundaries stable
+   * even when new bundles are inserted ahead of the current cursor window.
+   */
+  page?: number;
+  /**
+   * Preferred cursor-based pagination for bundle-management queries.
+   */
+  cursor?: DatabaseBundleCursor;
   orderBy?: DatabaseBundleQueryOrder;
 }
 interface BuildPluginConfig {
@@ -51,6 +75,7 @@ interface BuildPluginConfig {
 interface DatabasePlugin<TContext = unknown> {
   getChannels: (context?: HotUpdaterContext<TContext>) => Promise<string[]>;
   getBundleById: (bundleId: string, context?: HotUpdaterContext<TContext>) => Promise<Bundle | null>;
+  getUpdateInfo?: (args: GetBundlesArgs, context?: HotUpdaterContext<TContext>) => Promise<UpdateInfo | null>;
   getBundles: (options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>) => Promise<Paginated<Bundle[]>>;
   updateBundle: (targetBundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>) => Promise<void>;
   appendBundle: (insertBundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
@@ -391,4 +416,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, supportedIosPlatforms };
+export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/plugin-core",
-  "version": "0.29.4",
+  "version": "0.29.6",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -42,13 +42,14 @@
     "es-toolkit": "^1.32.0",
     "mime": "^4.0.4",
     "semver": "^7.7.2",
-    "@hot-updater/core": "0.29.4"
+    "@hot-updater/core": "0.29.6",
+    "@hot-updater/js": "0.29.6"
   },
   "devDependencies": {
     "@types/node": "^20",
     "@types/semver": "^7.5.8",
     "typescript": "6.0.2",
-    "@hot-updater/test-utils": "0.29.4"
+    "@hot-updater/test-utils": "0.29.6"
   },
   "scripts": {
     "build": "tsdown",