@hot-updater/server 0.21.0

package/dist/schema/v1.cjs

@@ -0,0 +1,26 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let fumadb_schema = require("fumadb/schema");
+fumadb_schema = require_rolldown_runtime.__toESM(fumadb_schema);
+
+//#region src/schema/v1.ts
+const v1 = (0, fumadb_schema.schema)({
+	version: "1.0.0",
+	tables: { bundles: (0, fumadb_schema.table)("bundles", {
+		id: (0, fumadb_schema.idColumn)("id", "varchar(255)").defaultTo$("auto"),
+		platform: (0, fumadb_schema.column)("platform", "string"),
+		should_force_update: (0, fumadb_schema.column)("should_force_update", "bool"),
+		enabled: (0, fumadb_schema.column)("enabled", "bool"),
+		file_hash: (0, fumadb_schema.column)("file_hash", "string"),
+		git_commit_hash: (0, fumadb_schema.column)("git_commit_hash", "string").nullable(),
+		message: (0, fumadb_schema.column)("message", "string").nullable(),
+		channel: (0, fumadb_schema.column)("channel", "string"),
+		storage_uri: (0, fumadb_schema.column)("storage_uri", "string"),
+		target_app_version: (0, fumadb_schema.column)("target_app_version", "string").nullable(),
+		fingerprint_hash: (0, fumadb_schema.column)("fingerprint_hash", "string").nullable(),
+		metadata: (0, fumadb_schema.column)("metadata", "json")
+	}) },
+	relations: {}
+});
+
+//#endregion
+exports.v1 = v1;

package/dist/schema/v1.js

@@ -0,0 +1,24 @@
+import { column, idColumn, schema, table } from "fumadb/schema";
+
+//#region src/schema/v1.ts
+const v1 = schema({
+	version: "1.0.0",
+	tables: { bundles: table("bundles", {
+		id: idColumn("id", "varchar(255)").defaultTo$("auto"),
+		platform: column("platform", "string"),
+		should_force_update: column("should_force_update", "bool"),
+		enabled: column("enabled", "bool"),
+		file_hash: column("file_hash", "string"),
+		git_commit_hash: column("git_commit_hash", "string").nullable(),
+		message: column("message", "string").nullable(),
+		channel: column("channel", "string"),
+		storage_uri: column("storage_uri", "string"),
+		target_app_version: column("target_app_version", "string").nullable(),
+		fingerprint_hash: column("fingerprint_hash", "string").nullable(),
+		metadata: column("metadata", "json")
+	}) },
+	relations: {}
+});
+
+//#endregion
+export { v1 };

package/dist/types/index.d.cts

@@ -0,0 +1,20 @@
+import { Bundle, Bundle as Bundle$1 } from "@hot-updater/core";
+
+//#region src/types/index.d.ts
+interface PaginationInfo {
+  total: number;
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+  currentPage: number;
+  totalPages: number;
+}
+interface PaginationOptions {
+  limit: number;
+  offset: number;
+}
+interface PaginatedResult {
+  data: Bundle[];
+  pagination: PaginationInfo;
+}
+//#endregion
+export { type Bundle$1 as Bundle, PaginatedResult, PaginationInfo, PaginationOptions };

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+import { Bundle, Bundle as Bundle$1 } from "@hot-updater/core";
+
+//#region src/types/index.d.ts
+interface PaginationInfo {
+  total: number;
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+  currentPage: number;
+  totalPages: number;
+}
+interface PaginationOptions {
+  limit: number;
+  offset: number;
+}
+interface PaginatedResult {
+  data: Bundle[];
+  pagination: PaginationInfo;
+}
+//#endregion
+export { type Bundle$1 as Bundle, PaginatedResult, PaginationInfo, PaginationOptions };

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@hot-updater/server",
+  "version": "0.21.0",
+  "type": "module",
+  "description": "React Native OTA solution for self-hosted",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./adapters/drizzle": {
+      "import": "./dist/adapters/drizzle.js",
+      "require": "./dist/adapters/drizzle.cjs"
+    },
+    "./adapters/kysely": {
+      "import": "./dist/adapters/kysely.js",
+      "require": "./dist/adapters/kysely.cjs"
+    },
+    "./adapters/mongodb": {
+      "import": "./dist/adapters/mongodb.js",
+      "require": "./dist/adapters/mongodb.cjs"
+    },
+    "./adapters/prisma": {
+      "import": "./dist/adapters/prisma.js",
+      "require": "./dist/adapters/prisma.cjs"
+    },
+    "./adapters/typeorm": {
+      "import": "./dist/adapters/typeorm.js",
+      "require": "./dist/adapters/typeorm.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "package.json"
+  ],
+  "license": "MIT",
+  "repository": "https://github.com/gronxb/hot-updater",
+  "author": "gronxb <gron1gh1@gmail.com> (https://github.com/gronxb)",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fumadb": "0.1.1",
+    "semver": "^7.7.2",
+    "@hot-updater/core": "0.21.0",
+    "@hot-updater/plugin-core": "0.21.0"
+  },
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.2.17",
+    "@types/node": "^20",
+    "@types/semver": "^7.5.8",
+    "execa": "^9.5.2",
+    "kysely": "^0.28.5",
+    "kysely-pglite-dialect": "^1.2.0",
+    "msw": "^2.7.0",
+    "@hot-updater/aws": "0.21.0",
+    "@hot-updater/cloudflare": "0.21.0",
+    "@hot-updater/firebase": "0.21.0",
+    "@hot-updater/standalone": "0.21.0",
+    "@hot-updater/supabase": "0.21.0",
+    "@hot-updater/test-utils": "0.21.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test:type": "tsc --noEmit"
+  }
+}

package/src/adapters/drizzle.ts

@@ -0,0 +1 @@
+export * from "fumadb/adapters/drizzle";

package/src/adapters/kysely.ts

@@ -0,0 +1 @@
+export * from "fumadb/adapters/kysely";

package/src/adapters/mongodb.ts

@@ -0,0 +1 @@
+export * from "fumadb/adapters/mongodb";

package/src/adapters/prisma.ts

@@ -0,0 +1 @@
+export * from "fumadb/adapters/prisma";

package/src/adapters/typeorm.ts

@@ -0,0 +1 @@
+export * from "fumadb/adapters/typeorm";

package/src/calculatePagination.ts

@@ -0,0 +1,34 @@
+import type { PaginationInfo, PaginationOptions } from "./types";
+
+/**
+ * Calculate pagination information based on total count, limit, and offset
+ */
+export function calculatePagination(
+  total: number,
+  options: PaginationOptions,
+): PaginationInfo {
+  const { limit, offset } = options;
+
+  if (total === 0) {
+    return {
+      total: 0,
+      hasNextPage: false,
+      hasPreviousPage: false,
+      currentPage: 1,
+      totalPages: 0,
+    };
+  }
+
+  const currentPage = Math.floor(offset / limit) + 1;
+  const totalPages = Math.ceil(total / limit);
+  const hasNextPage = offset + limit < total;
+  const hasPreviousPage = offset > 0;
+
+  return {
+    total,
+    hasNextPage,
+    hasPreviousPage,
+    currentPage,
+    totalPages,
+  };
+}

package/src/db/index.spec.ts

@@ -0,0 +1,231 @@
+import { PGlite } from "@electric-sql/pglite";
+import { s3Storage } from "@hot-updater/aws";
+import { r2Storage } from "@hot-updater/cloudflare";
+import type { Bundle, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
+import { NIL_UUID } from "@hot-updater/core";
+import { firebaseStorage } from "@hot-updater/firebase";
+import { kyselyAdapter } from "@hot-updater/server/adapters/kysely";
+import { supabaseStorage } from "@hot-updater/supabase";
+import { setupGetUpdateInfoTestSuite } from "@hot-updater/test-utils";
+import { Kysely } from "kysely";
+import { PGliteDialect } from "kysely-pglite-dialect";
+import {
+  afterAll,
+  afterEach,
+  beforeAll,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+} from "vitest";
+import { hotUpdater } from "./index";
+
+describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
+  const db = new PGlite();
+
+  const kysely = new Kysely({ dialect: new PGliteDialect(db) });
+
+  const api = hotUpdater({
+    database: kyselyAdapter({
+      db: kysely,
+      provider: "postgresql",
+    }),
+    storagePlugins: [
+      s3Storage({
+        region: "us-east-1",
+        credentials: {
+          accessKeyId: "test-access-key",
+          secretAccessKey: "test-secret-key",
+        },
+        bucketName: "test-bucket",
+      }),
+      r2Storage({
+        cloudflareApiToken: "test-token",
+        accountId: "test-account-id",
+        bucketName: "test-bucket",
+      }),
+      supabaseStorage({
+        supabaseUrl: "https://test.supabase.co",
+        supabaseAnonKey: "test-anon-key",
+        bucketName: "test-bucket",
+      }),
+      firebaseStorage({
+        storageBucket: "test-bucket.appspot.com",
+      }),
+    ],
+  });
+
+  beforeAll(async () => {
+    // Initialize FumaDB schema to latest (creates tables under the hood)
+    const migrator = api.createMigrator();
+    const result = await migrator.migrateToLatest({
+      mode: "from-schema",
+      updateSettings: true,
+    });
+    await result.execute();
+  });
+
+  beforeEach(async () => {
+    await db.exec("DELETE FROM bundles");
+  });
+
+  afterAll(async () => {
+    await kysely.destroy();
+    await db.close();
+  });
+
+  const getUpdateInfo = async (
+    bundles: Bundle[],
+    options: GetBundlesArgs,
+  ): Promise<UpdateInfo | null> => {
+    // Insert fixtures via the server API to exercise its types + mapping
+    for (const b of bundles) {
+      await api.insertBundle(b);
+    }
+    return api.getUpdateInfo(options);
+  };
+
+  setupGetUpdateInfoTestSuite({ getUpdateInfo });
+
+  describe("getAppUpdateInfo with storage plugins", () => {
+    beforeEach(() => {
+      // Fix time for deterministic signed URLs
+      vi.useFakeTimers();
+      vi.setSystemTime(new Date("2025-10-15T12:21:00Z"));
+    });
+
+    afterEach(() => {
+      vi.useRealTimers();
+    });
+
+    it("resolves s3:// storage URI to signed URL via s3StoragePlugin", async () => {
+      const bundle: Bundle = {
+        id: "00000000-0000-0000-0000-000000000001",
+        platform: "ios",
+        shouldForceUpdate: false,
+        enabled: true,
+        fileHash: "hash123",
+        gitCommitHash: null,
+        message: "Test bundle",
+        channel: "production",
+        storageUri: "s3://test-bucket/bundles/bundle.zip",
+        targetAppVersion: "1.0.0",
+        fingerprintHash: null,
+      };
+
+      await api.insertBundle(bundle);
+
+      const updateInfo = await api.getAppUpdateInfo({
+        appVersion: "1.0.0",
+        bundleId: NIL_UUID,
+        platform: "ios",
+        _updateStrategy: "appVersion",
+      });
+
+      expect(updateInfo).not.toBeNull();
+      expect(updateInfo?.fileUrl).toBe(
+        "https://test-bucket.s3.us-east-1.amazonaws.com/bundles/bundle.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=test-access-key%2F20251015%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251015T122100Z&X-Amz-Expires=3600&X-Amz-Signature=4fa782e86a842ce2eacbfa6534d1f5d5145d733092959cf6ad755cc306bbe98e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
+      );
+    });
+
+    it("passes through http:// URLs without plugin resolution", async () => {
+      const bundle: Bundle = {
+        id: "00000000-0000-0000-0000-000000000004",
+        platform: "ios",
+        shouldForceUpdate: false,
+        enabled: true,
+        fileHash: "hashhttp",
+        gitCommitHash: null,
+        message: "HTTP bundle",
+        channel: "production",
+        storageUri: "s3://bundle/bundle.zip",
+        targetAppVersion: "1.0.0",
+        fingerprintHash: null,
+      };
+
+      await api.insertBundle(bundle);
+
+      const updateInfo = await api.getAppUpdateInfo({
+        appVersion: "1.0.0",
+        bundleId: NIL_UUID,
+        platform: "ios",
+        _updateStrategy: "appVersion",
+      });
+
+      expect(updateInfo).not.toBeNull();
+      expect(updateInfo?.fileUrl).toBe(
+        "https://bundle.s3.us-east-1.amazonaws.com/bundle.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=test-access-key%2F20251015%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251015T122100Z&X-Amz-Expires=3600&X-Amz-Signature=b83d9cfc9bd23275e5eb3baf792776fd7b49730f3aa2f5172d067c9dfb10cd94&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
+      );
+    });
+
+    it("passes through https:// URLs without plugin resolution", async () => {
+      const bundle: Bundle = {
+        id: "00000000-0000-0000-0000-000000000005",
+        platform: "ios",
+        shouldForceUpdate: false,
+        enabled: true,
+        fileHash: "hashhttps",
+        gitCommitHash: null,
+        message: "HTTPS bundle",
+        channel: "production",
+        storageUri: "https://cdn.example.com/bundle.zip",
+        targetAppVersion: "1.0.0",
+        fingerprintHash: null,
+      };
+
+      await api.insertBundle(bundle);
+
+      const updateInfo = await api.getAppUpdateInfo({
+        appVersion: "1.0.0",
+        bundleId: NIL_UUID,
+        platform: "ios",
+        _updateStrategy: "appVersion",
+      });
+
+      expect(updateInfo).not.toBeNull();
+      expect(updateInfo?.fileUrl).toBe("https://cdn.example.com/bundle.zip");
+    });
+
+    it("returns null when no update is available", async () => {
+      const updateInfo = await api.getAppUpdateInfo({
+        appVersion: "99.0.0",
+        bundleId: NIL_UUID,
+        platform: "ios",
+        _updateStrategy: "appVersion",
+      });
+
+      expect(updateInfo).toBeNull();
+    });
+
+    it("works with fingerprint strategy", async () => {
+      const bundle: Bundle = {
+        id: "00000000-0000-0000-0000-000000000008",
+        platform: "ios",
+        shouldForceUpdate: false,
+        enabled: true,
+        fileHash: "hashfp",
+        gitCommitHash: null,
+        message: "Fingerprint bundle",
+        channel: "production",
+        storageUri: "s3://test-bucket/fp-bundle.zip",
+        targetAppVersion: null,
+        fingerprintHash: "fingerprint123",
+      };
+
+      await api.insertBundle(bundle);
+
+      const updateInfo = await api.getAppUpdateInfo({
+        fingerprintHash: "fingerprint123",
+        bundleId: NIL_UUID,
+        platform: "ios",
+        _updateStrategy: "fingerprint",
+      });
+
+      expect(updateInfo).not.toBeNull();
+      expect(updateInfo?.fileUrl).toBe(
+        "https://test-bucket.s3.us-east-1.amazonaws.com/fp-bundle.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=test-access-key%2F20251015%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251015T122100Z&X-Amz-Expires=3600&X-Amz-Signature=d70e9b699dccbb51cf32f3e5b7912f2567d38f7e508b1f30091a8fee0d0abb65&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
+      );
+    });
+  });
+});