@hot-updater/server 0.34.0 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/server",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -28,14 +28,14 @@
       "import": "./dist/adapters/prisma.mjs",
       "require": "./dist/adapters/prisma.cjs"
     },
+    "./db": {
+      "import": "./dist/db/index.mjs",
+      "require": "./dist/db/index.cjs"
+    },
     "./node": {
       "import": "./dist/node.mjs",
       "require": "./dist/node.cjs"
     },
-    "./runtime": {
-      "import": "./dist/runtime.mjs",
-      "require": "./dist/runtime.cjs"
-    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -55,10 +55,10 @@
   "dependencies": {
     "rou3": "0.7.9",
     "semver": "^7.7.2",
-    "@hot-updater/bsdiff": "0.34.0",
-    "@hot-updater/core": "0.34.0",
-    "@hot-updater/js": "0.34.0",
-    "@hot-updater/plugin-core": "0.34.0"
+    "@hot-updater/bsdiff": "0.35.0",
+    "@hot-updater/core": "0.35.0",
+    "@hot-updater/plugin-core": "0.35.0",
+    "@hot-updater/js": "0.35.0"
   },
   "peerDependencies": {
     "@prisma/client": "*",
@@ -91,8 +91,8 @@
     "mongodb": "6.20.0",
     "msw": "^2.7.0",
     "uuidv7": "^1.0.2",
-    "@hot-updater/standalone": "0.34.0",
-    "@hot-updater/test-utils": "0.34.0"
+    "@hot-updater/standalone": "0.35.0",
+    "@hot-updater/test-utils": "0.35.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/adapters/drizzle.spec.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it, vi } from "vitest";
 
-import { createHotUpdater } from "../db";
+import { generateSchema } from "../db";
+import { createHotUpdater } from "../index";
 import { drizzleAdapter } from "./drizzle";
 
 describe("drizzleAdapter", () => {
@@ -16,7 +17,7 @@ describe("drizzleAdapter", () => {
       }),
     });
 
-    const schema = hotUpdater.generateSchema("latest");
+    const schema = generateSchema(hotUpdater, "latest");
 
     expect(schema.path).toBe("hot-updater-schema.ts");
     expect(schema.code).toContain("pgTable");

package/src/adapters/kysely.spec.ts

@@ -4,7 +4,7 @@ import { Kysely } from "kysely";
 import { PGliteDialect } from "kysely-pglite-dialect";
 import { afterEach, describe, expect, it } from "vitest";
 
-import { createHotUpdater } from "../db";
+import { createHotUpdater } from "../index";
 import {
   HOT_UPDATER_SCHEMA_VERSION,
   HOT_UPDATER_SETTINGS_TABLE,

package/src/{runtime.ts → createHotUpdaterCore.ts}

@@ -19,33 +19,70 @@ import { createHandler, type HandlerRoutes } from "./handler";
 import { normalizeBasePath } from "./route";
 import { createStorageAccess } from "./storageAccess";
 
-export type HotUpdaterAPI<TContext = unknown> = DatabaseAPI<TContext> & {
-  basePath: string;
-  handler: (
+export type RuntimeHotUpdaterAPI<TContext = unknown> = DatabaseAPI<TContext> & {
+  readonly basePath: string;
+  readonly handler: (
     request: Request,
     context?: HotUpdaterContext<TContext>,
   ) => Promise<Response>;
-  adapterName: string;
+  readonly adapterName: string;
 };
 
+export type HotUpdaterAPI<TContext = unknown> = RuntimeHotUpdaterAPI<TContext>;
+
 export interface CreateHotUpdaterOptions<TContext = unknown> {
-  database: DatabaseAdapter<TContext>;
-  storages?: (
+  readonly database: DatabaseAdapter<TContext>;
+  readonly storages?: readonly (
     | RuntimeStoragePlugin<TContext>
     | StoragePluginFactory<TContext>
   )[];
-  storagePlugins?: (
+  /**
+   * @deprecated Use `storages` instead. This field will be removed in a future version.
+   */
+  readonly storagePlugins?: readonly (
     | RuntimeStoragePlugin<TContext>
     | StoragePluginFactory<TContext>
   )[];
-  basePath?: string;
-  cwd?: string;
-  routes?: HandlerRoutes;
+  readonly basePath?: string;
+  readonly cwd?: string;
+  readonly routes?: HandlerRoutes;
 }
 
-export function createHotUpdater<TContext = unknown>(
+type PluginDatabaseCore<TContext> = {
+  readonly api: DatabaseAPI<TContext>;
+  readonly adapterName: string;
+  readonly createMigrator: () => never;
+  readonly generateSchema: () => never;
+};
+
+export const hotUpdaterCoreMetadata = Symbol.for(
+  "@hot-updater/server/core-metadata",
+);
+
+export type HotUpdaterCoreMetadata<TContext = unknown> = {
+  readonly adapterCapabilities: DatabaseAdapterCapabilities;
+  readonly core: PluginDatabaseCore<TContext>;
+};
+
+export type HotUpdaterCore<TContext = unknown> = {
+  readonly api: RuntimeHotUpdaterAPI<TContext>;
+  readonly adapterCapabilities: DatabaseAdapterCapabilities;
+  readonly core: PluginDatabaseCore<TContext>;
+};
+
+export function getHotUpdaterCoreMetadata<TContext = unknown>(
+  hotUpdater: RuntimeHotUpdaterAPI<TContext>,
+): HotUpdaterCoreMetadata<TContext> | undefined {
+  return (
+    hotUpdater as RuntimeHotUpdaterAPI<TContext> & {
+      readonly [hotUpdaterCoreMetadata]?: HotUpdaterCoreMetadata<TContext>;
+    }
+  )[hotUpdaterCoreMetadata];
+}
+
+export function createHotUpdaterCore<TContext = unknown>(
   options: CreateHotUpdaterOptions<TContext>,
-): HotUpdaterAPI<TContext> {
+): HotUpdaterCore<TContext> {
   const database = options.database;
   const basePath = normalizeBasePath(options.basePath ?? "/api");
   const storagePlugins = (options.storages ?? options.storagePlugins ?? []).map(
@@ -59,19 +96,17 @@ export function createHotUpdater<TContext = unknown>(
     createStorageAccess(storagePlugins);
 
   if (!isDatabasePluginFactory(database) && !isDatabasePlugin(database)) {
-    throw new Error(
-      "@hot-updater/server/runtime only supports database plugins.",
-    );
+    throw new Error("@hot-updater/server only supports database plugins.");
   }
 
-  const capabilities = database as DatabaseAdapterCapabilities;
+  const adapterCapabilities = database as DatabaseAdapterCapabilities;
   const plugin: DatabasePlugin<TContext> = isDatabasePluginFactory(database)
     ? database()
     : database;
-  const adapterName = capabilities.adapterName ?? plugin.name;
+  const adapterName = adapterCapabilities.adapterName ?? plugin.name;
   const assertSchemaReady = createSchemaReadinessChecker(
     adapterName,
-    capabilities.createMigrator,
+    adapterCapabilities.createMigrator,
   );
   const core = createPluginDatabaseCore<TContext>(
     () => plugin,
@@ -93,7 +128,7 @@ export function createHotUpdater<TContext = unknown>(
   // Some framework adapters strip the mounted base path or pass extra
   // bindings/execution context arguments. Ignore those extras here so the
   // handler can still be mounted directly as a plain Request handler.
-  const handler: HotUpdaterAPI<TContext>["handler"] = (
+  const handler: RuntimeHotUpdaterAPI<TContext>["handler"] = (
     request,
     context,
     ...extraArgs: unknown[]
@@ -107,12 +142,27 @@ export function createHotUpdater<TContext = unknown>(
 
   const api = {
     basePath,
-    adapterName: core.adapterName,
+    adapterName: adapterCapabilities.adapterName ?? core.adapterName,
     handler,
   };
   Object.defineProperties(api, Object.getOwnPropertyDescriptors(core.api));
-  return api as HotUpdaterAPI<TContext>;
+  Object.defineProperty(api, hotUpdaterCoreMetadata, {
+    enumerable: false,
+    value: {
+      adapterCapabilities,
+      core,
+    } satisfies HotUpdaterCoreMetadata<TContext>,
+  });
+
+  return {
+    api: api as RuntimeHotUpdaterAPI<TContext>,
+    adapterCapabilities,
+    core,
+  };
 }
 
-export { createHandler };
-export { HOT_UPDATER_SERVER_VERSION } from "./version";
+export function createHotUpdater<TContext = unknown>(
+  options: CreateHotUpdaterOptions<TContext>,
+): RuntimeHotUpdaterAPI<TContext> {
+  return createHotUpdaterCore(options).api;
+}

package/src/db/index.spec.ts

@@ -28,13 +28,14 @@ import { drizzleAdapter } from "../adapters/drizzle";
 import { kyselyAdapter } from "../adapters/kysely";
 import { mongoAdapter } from "../adapters/mongodb";
 import { prismaAdapter } from "../adapters/prisma";
+import { createHotUpdater } from "../index";
 import { bundleToRow } from "./bundleRows";
 import {
   createSchemaMigrationSql,
   createTableSql,
   hotUpdaterSchemaVersions,
 } from "./hotUpdaterSchema";
-import { createHotUpdater } from "./index";
+import { createMigrator, generateSchema } from "./index";
 import { generateDrizzleSchema } from "./schemaGenerators";
 import type { DatabasePluginFactory, ORMProvider } from "./types";
 
@@ -340,7 +341,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
   });
 
   beforeAll(async () => {
-    const migrator = hotUpdater.createMigrator();
+    const migrator = createMigrator(hotUpdater);
     const result = await migrator.migrateToLatest({
       mode: "from-schema",
       updateSettings: true,
@@ -382,7 +383,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
 
   describe("schema generation", () => {
     it("includes relations, defaults, and indexes in Prisma output", () => {
-      const code = prismaSchemaHotUpdater.generateSchema("latest").code;
+      const code = generateSchema(prismaSchemaHotUpdater, "latest").code;
 
       expect(code).toContain('channel String @default("production")');
       expect(code).toContain('metadata Json @default("{}")');
@@ -407,14 +408,14 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
     });
 
     it("omits the metadata JSON default for SQLite Prisma output", () => {
-      const code = sqlitePrismaSchemaHotUpdater.generateSchema("latest").code;
+      const code = generateSchema(sqlitePrismaSchemaHotUpdater, "latest").code;
 
       expect(code).toContain("metadata Json");
       expect(code).not.toContain('metadata Json @default("{}")');
     });
 
     it("generates ORM schema from the requested version snapshot", () => {
-      const code = prismaSchemaHotUpdater.generateSchema("0.21.0").code;
+      const code = generateSchema(prismaSchemaHotUpdater, "0.21.0").code;
 
       expect(code).toContain('value String @default("0.21.0")');
       expect(code).not.toContain("rollout_cohort_count");
@@ -422,7 +423,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
     });
 
     it("includes foreign keys and indexes in Drizzle output", () => {
-      const code = drizzleSchemaHotUpdater.generateSchema("latest").code;
+      const code = generateSchema(drizzleSchemaHotUpdater, "latest").code;
       const bundlesBlock = code.match(
         /export const bundles = [\s\S]*?(?=\n\nexport const bundle_patches = )/,
       )?.[0];
@@ -526,7 +527,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
       });
 
       try {
-        const migrator = migrationHotUpdater.createMigrator();
+        const migrator = createMigrator(migrationHotUpdater);
         const result = await migrator.migrateToLatest({
           mode: "from-schema",
           updateSettings: false,
@@ -593,7 +594,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
           values ('version', '0.21.0');
         `);
 
-        const migrator = migrationHotUpdater.createMigrator();
+        const migrator = createMigrator(migrationHotUpdater);
         const result = await migrator.migrateToLatest({
           mode: "from-schema",
           updateSettings: true,
@@ -639,7 +640,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
       });
 
       try {
-        const migrator = migrationHotUpdater.createMigrator();
+        const migrator = createMigrator(migrationHotUpdater);
         const result = await migrator.migrateToLatest({
           mode: "from-schema",
           updateSettings: false,
@@ -671,7 +672,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
       });
 
       try {
-        const migrator = migrationHotUpdater.createMigrator();
+        const migrator = createMigrator(migrationHotUpdater);
         const result = await migrator.migrateToLatest({
           mode: "from-schema",
           updateSettings: false,
@@ -703,9 +704,9 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
       const mongoHotUpdater = createHotUpdater({
         database: mongoAdapter({ client }),
       });
-      const result = await mongoHotUpdater
-        .createMigrator()
-        .migrateToLatest({ mode: "from-schema" });
+      const result = await createMigrator(mongoHotUpdater).migrateToLatest({
+        mode: "from-schema",
+      });
 
       expect(result.operations).toEqual(
         expect.arrayContaining([
@@ -742,7 +743,7 @@ describe("server/db hotUpdater getUpdateInfo (PGlite + Kysely)", async () => {
 
       try {
         await expect(
-          migrationHotUpdater.createMigrator().migrateToLatest({
+          createMigrator(migrationHotUpdater).migrateToLatest({
             mode: "from-database",
           }),
         ).rejects.toThrow(

package/src/db/index.ts

@@ -1,119 +1,47 @@
-import type {
-  DatabasePlugin,
-  HotUpdaterContext,
-  RuntimeStoragePlugin,
-} from "@hot-updater/plugin-core";
-import { assertRuntimeStoragePlugin } from "@hot-updater/plugin-core";
-
-export * from "./createBundleDiff";
-import { createHandler, type HandlerRoutes } from "../handler";
-import { normalizeBasePath } from "../route";
-import { createStorageAccess } from "../storageAccess";
-import { createPluginDatabaseCore } from "./pluginCore";
-import { generateSchemaFromHotUpdaterSchema } from "./schemaGenerators";
-import { createSchemaReadinessChecker } from "./schemaReadiness";
 import {
-  type DatabaseAdapterCapabilities,
-  type DatabaseAdapter,
-  type DatabaseAPI,
-  type Migrator,
-  type SchemaGenerator,
-  isDatabasePluginFactory,
-  type StoragePluginFactory,
-} from "./types";
+  getHotUpdaterCoreMetadata,
+  type RuntimeHotUpdaterAPI,
+} from "../createHotUpdaterCore";
+import { generateSchemaFromHotUpdaterSchema } from "./schemaGenerators";
+import { type Migrator, type SchemaGenerator } from "./types";
 
+export * from "./createBundleDiff";
 export type { Migrator, SchemaGenerator } from "./types";
 export { HotUpdaterSchemaMigrationRequiredError } from "./schemaReadiness";
 export { HOT_UPDATER_SERVER_VERSION } from "../version";
 
-export type HotUpdaterAPI<TContext = unknown> = DatabaseAPI<TContext> & {
-  basePath: string;
-  handler: (
-    request: Request,
-    context?: HotUpdaterContext<TContext>,
-  ) => Promise<Response>;
-  adapterName: string;
-  createMigrator: () => Migrator;
-  generateSchema: SchemaGenerator;
+export type HotUpdaterDBTarget = {
+  readonly adapterName: string;
 };
 
-export interface CreateHotUpdaterOptions<TContext = unknown> {
-  database: DatabaseAdapter<TContext>;
-  /**
-   * Storage plugins for handling file uploads and downloads.
-   */
-  storages?: (
-    | RuntimeStoragePlugin<TContext>
-    | StoragePluginFactory<TContext>
-  )[];
-  /**
-   * @deprecated Use `storages` instead. This field will be removed in a future version.
-   */
-  storagePlugins?: (
-    | RuntimeStoragePlugin<TContext>
-    | StoragePluginFactory<TContext>
-  )[];
-  basePath?: string;
-  cwd?: string;
-  routes?: HandlerRoutes;
-}
-
-export function createHotUpdater<TContext = unknown>(
-  options: CreateHotUpdaterOptions<TContext>,
-): HotUpdaterAPI<TContext> {
-  const basePath = normalizeBasePath(options.basePath ?? "/api");
-
-  // Initialize storage plugins - call factories if they are functions
-  const storagePlugins = (options.storages ?? options.storagePlugins ?? []).map(
-    (plugin) => {
-      const storagePlugin = typeof plugin === "function" ? plugin() : plugin;
-      assertRuntimeStoragePlugin(storagePlugin);
-      return storagePlugin;
-    },
+const getDBMetadata = (hotUpdater: HotUpdaterDBTarget) => {
+  const metadata = getHotUpdaterCoreMetadata(
+    hotUpdater as RuntimeHotUpdaterAPI,
   );
-  const { readStorageText, resolveFileUrl } =
-    createStorageAccess(storagePlugins);
+  if (!metadata) {
+    throw new Error(
+      "Database tooling requires a hotUpdater instance created by @hot-updater/server.",
+    );
+  }
+  return metadata;
+};
 
-  const database = options.database;
+export function createMigrator(hotUpdater: HotUpdaterDBTarget): Migrator {
+  const { adapterCapabilities, core } = getDBMetadata(hotUpdater);
+  return (adapterCapabilities.createMigrator ?? core.createMigrator)();
+}
 
-  const capabilities = database as DatabaseAdapterCapabilities;
-  const plugin: DatabasePlugin<TContext> = isDatabasePluginFactory(database)
-    ? database()
-    : database;
-  const adapterName = capabilities.adapterName ?? plugin.name;
-  const assertSchemaReady = createSchemaReadinessChecker(
-    adapterName,
-    capabilities.createMigrator,
-  );
-  const core = createPluginDatabaseCore<TContext>(
-    () => plugin,
-    resolveFileUrl,
-    isDatabasePluginFactory(database)
-      ? {
-          createMutationPlugin: () => database(),
-          beforeOperation: assertSchemaReady,
-          readStorageText,
-        }
-      : { beforeOperation: assertSchemaReady, readStorageText },
+export function generateSchema(
+  hotUpdater: HotUpdaterDBTarget,
+  ...args: Parameters<SchemaGenerator>
+): ReturnType<SchemaGenerator> {
+  const { adapterCapabilities, core } = getDBMetadata(hotUpdater);
+  const schemaGenerator =
+    adapterCapabilities.generateSchema ?? core.generateSchema;
+  return generateSchemaFromHotUpdaterSchema(
+    hotUpdater.adapterName,
+    adapterCapabilities.provider,
+    args[0],
+    schemaGenerator(...args),
   );
-
-  const generateSchema = capabilities.generateSchema ?? core.generateSchema;
-  const api = {
-    basePath,
-    adapterName: capabilities.adapterName ?? core.adapterName,
-    createMigrator: capabilities.createMigrator ?? core.createMigrator,
-    generateSchema: (...args: Parameters<SchemaGenerator>) =>
-      generateSchemaFromHotUpdaterSchema(
-        api.adapterName,
-        capabilities.provider,
-        args[0],
-        generateSchema(...args),
-      ),
-    handler: createHandler(core.api, {
-      basePath,
-      routes: options.routes,
-    }),
-  };
-  Object.defineProperties(api, Object.getOwnPropertyDescriptors(core.api));
-  return api as HotUpdaterAPI<TContext>;
 }

package/src/handler-standalone.integration.spec.ts

@@ -11,7 +11,8 @@ import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
 
 import { standaloneRepository } from "../../../plugins/standalone/src";
 import { kyselyAdapter } from "./adapters/kysely";
-import { createHotUpdater } from "./db";
+import { createMigrator } from "./db";
+import { createHotUpdater } from "./index";
 
 /**
  * Integration tests between @hot-updater/server handler and @hot-updater/standalone repository
@@ -46,7 +47,7 @@ const server = setupServer();
 
 beforeAll(async () => {
   // Initialize database
-  const migrator = api.createMigrator();
+  const migrator = createMigrator(api);
   const result = await migrator.migrateToLatest({
     mode: "from-schema",
     updateSettings: true,

package/src/index.ts

@@ -1,4 +1,10 @@
-export * from "./db";
-export * from "./handler";
+export { createHandler } from "./handler";
+export type { HandlerAPI, HandlerOptions, HandlerRoutes } from "./handler";
+export { createHotUpdater } from "./createHotUpdaterCore";
+export type {
+  CreateHotUpdaterOptions,
+  HotUpdaterAPI,
+  RuntimeHotUpdaterAPI,
+} from "./createHotUpdaterCore";
 export * from "./types";
-export * from "./version";
+export { HOT_UPDATER_SERVER_VERSION } from "./version";

package/src/node.spec.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it } from "vitest";
+
+import { toNodeHandler } from "./node";
+
+describe("server node entry", () => {
+  it("converts a Web Request handler to Node middleware", async () => {
+    const hotUpdater = {
+      handler: async (request: Request) =>
+        Response.json({
+          method: request.method,
+          pathname: new URL(request.url).pathname,
+        }),
+    };
+    const middleware = toNodeHandler(hotUpdater);
+    const headers = new Map<string, string | string[]>();
+    const response = {
+      body: "",
+      statusCode: 0,
+      status(code: number) {
+        this.statusCode = code;
+        return this;
+      },
+      setHeader(name: string, value: string | string[]) {
+        headers.set(name, value);
+      },
+      send(body: string) {
+        this.body = body;
+      },
+      end() {},
+    };
+
+    await middleware(
+      {
+        method: "GET",
+        url: "/api/check",
+        headers: { host: "example.com" },
+        protocol: "https",
+        get: (name: string) => (name === "host" ? "example.com" : undefined),
+      },
+      response,
+    );
+
+    expect(response.statusCode).toBe(200);
+    expect(headers.get("content-type")).toContain("application/json");
+    expect(JSON.parse(response.body)).toEqual({
+      method: "GET",
+      pathname: "/api/check",
+    });
+  });
+});

package/src/node.ts

@@ -1,5 +1,3 @@
-import type { HotUpdaterAPI } from "./types";
-
 /**
  * Node.js request/response types (compatible with Express, Connect, etc.)
  */
@@ -21,6 +19,12 @@ interface NodeResponse {
   [key: string]: unknown;
 }
 
+type HandlerHotUpdaterAPI = {
+  readonly handler: (request: Request) => Promise<Response>;
+};
+
+export { HOT_UPDATER_SERVER_VERSION } from "./version";
+
 /**
  * Converts a Hot Updater handler to a Node.js-compatible middleware
  * Works with Express, Connect, and other frameworks using Node.js req/res
@@ -40,7 +44,7 @@ interface NodeResponse {
  * ```
  */
 export function toNodeHandler(
-  hotUpdater: HotUpdaterAPI,
+  hotUpdater: HandlerHotUpdaterAPI,
 ): (req: any, res: any, next?: any) => Promise<void> {
   return async (req: NodeRequest, res: NodeResponse) => {
     try {