@hot-updater/server 1.0.0-rc.18 → 1.0.0-rc.21

package/src/db/index.spec.ts

@@ -1,554 +0,0 @@
-import { PGlite } from "@electric-sql/pglite";
-import type { Bundle } from "@hot-updater/core";
-import { NIL_UUID } from "@hot-updater/core";
-import { createStoragePlugin } from "@hot-updater/plugin-core";
-import { Kysely } from "kysely";
-import { PGliteDialect } from "kysely-pglite-dialect";
-import {
-  afterAll,
-  afterEach,
-  beforeAll,
-  beforeEach,
-  describe,
-  expect,
-  it,
-  vi,
-} from "vitest";
-
-import { drizzleAdapter } from "../adapters/drizzle";
-import { kyselyAdapter } from "../adapters/kysely";
-import { prismaAdapter } from "../adapters/prisma";
-import { HotUpdaterSchemaMigrationRequiredError } from "../database/fence";
-import {
-  createHotUpdater as createRuntimeHotUpdater,
-  type CreateHotUpdaterOptions,
-} from "../index";
-import { createMigrator, generateSchema } from "./index";
-
-const createHotUpdater = (
-  options: Omit<CreateHotUpdaterOptions, "clientAccess">,
-) =>
-  createRuntimeHotUpdater({
-    ...options,
-    clientAccess: "public",
-  });
-
-function createTestStoragePlugin(
-  protocol: string,
-  readText: (storageUri: string) => Promise<string | null> = async () => null,
-) {
-  return createStoragePlugin({
-    name: `${protocol}TestStorage`,
-    protocol,
-    async get({ storageUri }) {
-      const text = await readText(storageUri);
-      return { response: text === null ? null : new Response(text) };
-    },
-    async getDownloadUrl({ storageUri }) {
-      const prefixes: Record<string, string> = {
-        gs: "https://firebase.example.com/",
-        r2: "https://r2.example.com/",
-        s3: "https://s3.example.com/",
-        "supabase-storage":
-          "https://supabase.example.com/storage/v1/object/sign/",
-      };
-      return {
-        url: storageUri
-          .replace(`${protocol}://`, prefixes[protocol] ?? "")
-          .replace(/([^:]\/)\/+/g, "$1"),
-      };
-    },
-  });
-}
-
-describe("server/db hotUpdater (PGlite + Kysely)", async () => {
-  const db = new PGlite();
-
-  const kysely = new Kysely<object>({ dialect: new PGliteDialect(db) });
-  const storageTexts = new Map<string, string | Error>();
-  const readStoredText = async (storageUri: string) => {
-    const text = storageTexts.get(storageUri);
-    if (text instanceof Error) {
-      throw text;
-    }
-    return text ?? null;
-  };
-
-  const hotUpdater = createHotUpdater({
-    database: kyselyAdapter({
-      db: kysely,
-      provider: "postgresql",
-    }),
-    storage: [
-      createTestStoragePlugin("s3", readStoredText),
-      createTestStoragePlugin("r2", readStoredText),
-      createTestStoragePlugin("supabase-storage", readStoredText),
-      createTestStoragePlugin("gs", readStoredText),
-    ],
-  });
-  it("uses the default generated schema artifact path for Drizzle", () => {
-    const adapter = drizzleAdapter({ db: {}, provider: "sqlite" });
-
-    expect(adapter.generateSchema?.("latest").path).toBe(
-      "hot-updater-schema.ts",
-    );
-  });
-
-  beforeAll(async () => {
-    const migrator = createMigrator(hotUpdater);
-    const result = await migrator.migrateToLatest({
-      mode: "from-schema",
-      updateSettings: true,
-    });
-    await result.execute();
-  });
-
-  beforeEach(async () => {
-    storageTexts.clear();
-    // Every table but the settings rows, aggregates included.
-    const { rows } = await db.query<{ tablename: string }>(
-      "SELECT tablename FROM pg_tables WHERE schemaname = 'public' AND tablename <> 'private_hot_updater_settings'",
-    );
-    await db.exec(
-      `TRUNCATE ${rows.map(({ tablename }) => `"${tablename}"`).join(", ")}`,
-    );
-  });
-
-  /** Stores a bundle with a disabled release, one deploy each. */
-  const deployBundle = (bundle: Bundle) =>
-    hotUpdater.core.deploy([
-      {
-        bundle,
-        release: {
-          channel: "production",
-          enabled: false,
-          fingerprintHash: null,
-          message: null,
-          shouldForceUpdate: false,
-          targetAppVersion: "*",
-        },
-      },
-    ]);
-
-  afterAll(async () => {
-    await kysely.destroy();
-    await db.close();
-  });
-
-  describe("schema generation", () => {
-    it("passes the Prisma adapter's engine models through unchanged", () => {
-      const database = prismaAdapter({ prisma: {}, provider: "postgresql" });
-      const code = generateSchema(
-        createHotUpdater({ database }),
-        "latest",
-      ).code;
-
-      expect(code).toBe(database.generateSchema?.("latest").code);
-      expect(code).toContain("model bundle_totals {");
-      expect(code).toContain("model private_hot_updater_settings {");
-    });
-
-    it("rejects generating a retired schema snapshot", () => {
-      const database = prismaAdapter({ prisma: {}, provider: "postgresql" });
-      expect(() =>
-        generateSchema(createHotUpdater({ database }), "0.21.0"),
-      ).toThrow("Invalid version 0.21.0");
-    });
-
-    it("passes the Drizzle adapter's engine schema through unchanged", () => {
-      const database = drizzleAdapter({ db: {}, provider: "postgresql" });
-      const code = generateSchema(
-        createHotUpdater({ database }),
-        "latest",
-      ).code;
-
-      expect(code).toBe(database.generateSchema?.("latest").code);
-      expect(code).toContain('pgTable("bundle_totals"');
-      expect(code).toContain('pgTable("private_hot_updater_settings"');
-    });
-  });
-
-  describe("migrator enhancements", () => {
-    it("generates the engine's tables, indexes, and settings rows, without foreign keys", async () => {
-      const migrationDb = new PGlite();
-      const migrationKysely = new Kysely<object>({
-        dialect: new PGliteDialect(migrationDb),
-      });
-      const migrationHotUpdater = createHotUpdater({
-        database: kyselyAdapter({
-          db: migrationKysely,
-          provider: "postgresql",
-        }),
-      });
-
-      try {
-        const migrator = createMigrator(migrationHotUpdater);
-        const result = await migrator.migrateToLatest({
-          mode: "from-schema",
-          updateSettings: false,
-        });
-        const sql = result.getSQL?.() ?? "";
-
-        expect(sql).toContain(
-          'CREATE INDEX IF NOT EXISTS "releases_byScope" ON "releases" ("scope_key", "id")',
-        );
-        expect(sql).not.toContain("FOREIGN KEY");
-        expect(sql).toContain(
-          `INSERT INTO "private_hot_updater_settings" ("key", "value", "_v") VALUES ('schema.engine', '1', 0)`,
-        );
-        // `updateSettings: false` leaves the settings step out of the plan only
-        expect(result.operations).not.toContainEqual(
-          expect.objectContaining({ type: "custom" }),
-        );
-      } finally {
-        await migrationKysely.destroy();
-        await migrationDb.close();
-      }
-    });
-
-    it("rejects an existing v0 Kysely schema instead of upgrading it", async () => {
-      const migrationDb = new PGlite();
-      const migrationKysely = new Kysely<object>({
-        dialect: new PGliteDialect(migrationDb),
-      });
-      const migrationHotUpdater = createHotUpdater({
-        database: kyselyAdapter({
-          db: migrationKysely,
-          provider: "postgresql",
-        }),
-      });
-
-      try {
-        await migrationDb.exec(`
-          create table private_hot_updater_settings (
-            key varchar(255) primary key,
-            value text not null
-          );
-          insert into private_hot_updater_settings (key, value)
-          values ('version', '0.21.0');
-        `);
-
-        const migrator = createMigrator(migrationHotUpdater);
-        await expect(
-          migrator.migrateToLatest({
-            mode: "from-schema",
-            updateSettings: true,
-          }),
-        ).rejects.toThrow("Hot Updater v1 cannot migrate schema 0.21.0");
-      } finally {
-        await migrationKysely.destroy();
-        await migrationDb.close();
-      }
-    });
-
-    it("rejects from-database migrations explicitly", async () => {
-      const migrationDb = new PGlite();
-      const migrationKysely = new Kysely<object>({
-        dialect: new PGliteDialect(migrationDb),
-      });
-      const migrationHotUpdater = createHotUpdater({
-        database: kyselyAdapter({
-          db: migrationKysely,
-          provider: "postgresql",
-        }),
-      });
-
-      try {
-        await expect(
-          createMigrator(migrationHotUpdater).migrateToLatest({
-            mode: "from-database",
-          }),
-        ).rejects.toThrow(
-          "Hot Updater migrations support only mode: 'from-schema'.",
-        );
-      } finally {
-        await migrationKysely.destroy();
-        await migrationDb.close();
-      }
-    });
-
-    it("rejects runtime access when a Kysely schema is not initialized", async () => {
-      const migrationDb = new PGlite();
-      const migrationKysely = new Kysely<object>({
-        dialect: new PGliteDialect(migrationDb),
-      });
-      const migrationHotUpdater = createHotUpdater({
-        database: kyselyAdapter({
-          db: migrationKysely,
-          provider: "postgresql",
-        }),
-      });
-
-      try {
-        await expect(
-          migrationHotUpdater.core.listBundles({ limit: 10 }),
-        ).rejects.toThrow(
-          'Hot Updater schema setting "schema.engine" for kysely is missing',
-        );
-      } finally {
-        await migrationKysely.destroy();
-        await migrationDb.close();
-      }
-    });
-
-    it("rejects runtime access when a Kysely schema is stale", async () => {
-      const migrationDb = new PGlite();
-      const migrationKysely = new Kysely<object>({
-        dialect: new PGliteDialect(migrationDb),
-      });
-      const migrationHotUpdater = createHotUpdater({
-        database: kyselyAdapter({
-          db: migrationKysely,
-          provider: "postgresql",
-        }),
-      });
-
-      try {
-        await migrationDb.exec(`
-          create table private_hot_updater_settings (
-            key varchar(255) primary key,
-            value text not null
-          );
-          insert into private_hot_updater_settings (key, value)
-          values ('version', '0.21.0');
-        `);
-
-        await expect(
-          migrationHotUpdater.core.listChannels(),
-        ).rejects.toBeInstanceOf(HotUpdaterSchemaMigrationRequiredError);
-      } finally {
-        await migrationKysely.destroy();
-        await migrationDb.close();
-      }
-    });
-  });
-
-  describe("getBundle", () => {
-    it("should retrieve bundle by id without Prisma validation errors", async () => {
-      const bundle: Bundle = {
-        id: "00000000-0000-0000-0000-000000000010",
-        platform: "ios",
-        gitCommitHash: null,
-        manifestStorageUri: "s3://test-bucket/test/manifest.json",
-        manifestFileHash: "test-manifest-hash",
-        assetBaseStorageUri: "s3://test-bucket/assets",
-      };
-
-      await deployBundle(bundle);
-
-      const retrieved = await hotUpdater.core.getBundle(bundle.id);
-
-      expect(retrieved?.bundle).toMatchObject({
-        id: bundle.id,
-        platform: bundle.platform,
-        manifest_file_hash: bundle.manifestFileHash,
-      });
-    });
-
-    it("should return null for non-existent bundle id", async () => {
-      const retrieved = await hotUpdater.core.getBundle(
-        "99999999-9999-9999-9999-999999999999",
-      );
-
-      expect(retrieved).toBeNull();
-    });
-  });
-
-  describe("listChannels", () => {
-    it("lists channel rows by name", async () => {
-      await hotUpdater.core.ensureChannel("staging");
-      await hotUpdater.core.ensureChannel("production");
-
-      const channels = await hotUpdater.core.listChannels();
-
-      expect(channels).toHaveLength(2);
-      expect(channels.map(({ name }) => name)).toEqual([
-        "production",
-        "staging",
-      ]);
-    });
-
-    it("should return empty array when no channels exist", async () => {
-      const channels = await hotUpdater.core.listChannels();
-      expect(channels).toEqual([]);
-    });
-  });
-
-  describe("getArtifactInfo 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 manifest and asset URIs via s3StoragePlugin", async () => {
-      const bundle: Bundle = {
-        id: "00000000-0000-0000-0000-000000000001",
-        platform: "ios",
-        gitCommitHash: null,
-        manifestStorageUri: "s3://test-bucket/bundles/bundle/manifest.json",
-        manifestFileHash: "manifest-hash",
-        assetBaseStorageUri: "s3://test-bucket/assets",
-      };
-      storageTexts.set(
-        bundle.manifestStorageUri,
-        JSON.stringify({
-          bundleId: bundle.id,
-          assets: { "assets/logo.png": { fileHash: "logo-hash" } },
-        }),
-      );
-
-      await deployBundle(bundle);
-
-      const updateInfo = await hotUpdater.core.getArtifactInfo(
-        bundle.id,
-        NIL_UUID,
-        1,
-      );
-
-      expect(updateInfo).not.toBeNull();
-      expect(updateInfo?.manifestUrl).toBe(
-        "https://s3.example.com/test-bucket/bundles/bundle/manifest.json",
-      );
-    });
-
-    it("returns manifest metadata and hbc patch descriptors", async () => {
-      const currentManifestStorageUri =
-        "s3://test-bucket/releases/bundles/00000000-0000-0000-0000-000000000101/manifest.json";
-      const nextManifestStorageUri =
-        "s3://test-bucket/releases/bundles/00000000-0000-0000-0000-000000000102/manifest.json";
-      const olderBundle: Bundle = {
-        id: "00000000-0000-0000-0000-000000000100",
-        platform: "ios",
-        gitCommitHash: null,
-        assetBaseStorageUri: "s3://test-bucket/releases/assets",
-        manifestFileHash: "manifest-older",
-        manifestStorageUri:
-          "s3://test-bucket/releases/bundles/00000000-0000-0000-0000-000000000100/manifest.json",
-      };
-      const currentBundle: Bundle = {
-        id: "00000000-0000-0000-0000-000000000101",
-        platform: "ios",
-        gitCommitHash: null,
-        assetBaseStorageUri: "s3://test-bucket/releases/assets",
-        manifestFileHash: "sig:manifest-current",
-        manifestStorageUri: currentManifestStorageUri,
-      };
-      const nextBundle: Bundle = {
-        id: "00000000-0000-0000-0000-000000000102",
-        platform: "ios",
-        gitCommitHash: null,
-        assetBaseStorageUri: "s3://test-bucket/releases/assets",
-        manifestFileHash: "sig:manifest-next",
-        manifestStorageUri: nextManifestStorageUri,
-        patches: [
-          {
-            baseBundleId: "00000000-0000-0000-0000-000000000100",
-            baseFileHash: "hash-older-bundle",
-            byteSize: 48,
-            patchFileHash: "hash-older-bsdiff",
-            patchStorageUri:
-              "s3://test-bucket/releases/bundles/00000000-0000-0000-0000-000000000102/patches/00000000-0000-0000-0000-000000000100/index.ios.bundle.bsdiff",
-          },
-          {
-            baseBundleId: currentBundle.id,
-            baseFileHash: "hash-old-bundle",
-            byteSize: 48,
-            patchFileHash: "hash-bsdiff",
-            patchStorageUri:
-              "s3://test-bucket/releases/bundles/00000000-0000-0000-0000-000000000102/patches/00000000-0000-0000-0000-000000000101/index.ios.bundle.bsdiff",
-          },
-        ],
-      };
-      storageTexts.set(
-        currentManifestStorageUri,
-        JSON.stringify({
-          assets: {
-            "assets/logo.png": {
-              fileHash: "hash-logo",
-            },
-            "index.ios.bundle": {
-              fileHash: "hash-old-bundle",
-            },
-          },
-          bundleId: currentBundle.id,
-        }),
-      );
-      storageTexts.set(
-        nextManifestStorageUri,
-        JSON.stringify({
-          assets: {
-            "assets/logo.png": {
-              fileHash: "hash-logo",
-            },
-            "index.ios.bundle": {
-              fileHash: "hash-new-bundle",
-            },
-          },
-          bundleId: nextBundle.id,
-        }),
-      );
-      const fetchMock = vi.fn<typeof fetch>(async () => {
-        return new Response("manifest fetch should not be used", {
-          status: 500,
-        });
-      });
-
-      await deployBundle(olderBundle);
-      await deployBundle(currentBundle);
-      await deployBundle(nextBundle);
-      vi.stubGlobal("fetch", fetchMock);
-
-      try {
-        await expect(
-          hotUpdater.core.getArtifactInfo(nextBundle.id, currentBundle.id, 1),
-        ).resolves.toMatchObject({
-          artifactProtocolVersion: 1,
-          assets: {
-            "assets/logo.png": {
-              file: { url: expect.any(String) },
-              fileHash: "hash-logo",
-            },
-            "index.ios.bundle": {
-              file: { url: expect.any(String) },
-              fileHash: "hash-new-bundle",
-            },
-          },
-          manifestFileHash: "sig:manifest-next",
-          manifestUrl:
-            "https://s3.example.com/test-bucket/releases/bundles/00000000-0000-0000-0000-000000000102/manifest.json",
-        });
-        expect(fetchMock).not.toHaveBeenCalled();
-      } finally {
-        vi.unstubAllGlobals();
-      }
-    });
-
-    it("propagates manifest storage read failures", async () => {
-      const nextManifestStorageUri =
-        "s3://test-bucket/releases/bundles/00000000-0000-0000-0000-000000000109/manifest.json";
-      const nextBundle: Bundle = {
-        id: "00000000-0000-0000-0000-000000000109",
-        platform: "ios",
-        gitCommitHash: null,
-        assetBaseStorageUri: "s3://test-bucket/releases/assets",
-        manifestFileHash: "sig:manifest-next",
-        manifestStorageUri: nextManifestStorageUri,
-      };
-
-      await deployBundle(nextBundle);
-      storageTexts.set(
-        nextManifestStorageUri,
-        new Error("storage read failed"),
-      );
-
-      await expect(
-        hotUpdater.core.getArtifactInfo(nextBundle.id, NIL_UUID, 1),
-      ).rejects.toThrow("storage read failed");
-    });
-  });
-});

package/src/db/index.ts

@@ -1,93 +0,0 @@
-import {
-  getHotUpdaterCoreMetadata,
-  type RuntimeHotUpdaterAPI,
-} from "../createHotUpdaterCore";
-import type { AnyHotUpdaterPlugin } from "../plugins/definePlugin";
-import { type Migrator, type SchemaGenerator } from "./types";
-
-export { createDatabaseCoreApi, type CoreApi } from "../core/api";
-export {
-  createDatabasePluginApis,
-  createMeasuredDatabase,
-  type MeasuredDatabase,
-  type MeasuredDatabaseOptions,
-} from "../assembly/databasePlugins";
-export {
-  clientAuthOf,
-  clientPluginsOf,
-  generateClientCredential,
-  pluginCommandsOf,
-  provisionClientCredential,
-  type ClientAuthSpec,
-  type ClientCredentialSpec,
-  type ClientPluginSpec,
-  type PluginCommandEntry,
-  type ProvisionedClientCredential,
-} from "../assembly/pluginCli";
-export { targetBaseCandidateKey } from "../core/baseCandidates";
-export {
-  generateEngineSql,
-  settingsStatements,
-  type EngineSqlOptions,
-} from "./engineSql";
-export type {
-  DatabaseTooling,
-  Migrator,
-  SchemaGenerator,
-  ToolingDatabase,
-  ToolingTarget,
-} from "./types";
-export { HotUpdaterSchemaMigrationRequiredError } from "../database/fence";
-export { HOT_UPDATER_SERVER_VERSION } from "../version";
-
-export type HotUpdaterDBTarget = {
-  readonly adapterName: string;
-};
-
-const getDBMetadata = (hotUpdater: HotUpdaterDBTarget) => {
-  const metadata = getHotUpdaterCoreMetadata(
-    hotUpdater as RuntimeHotUpdaterAPI,
-  );
-  if (!metadata) {
-    throw new Error(
-      "Database tooling requires a hotUpdater instance created by @hot-updater/server.",
-    );
-  }
-  return metadata;
-};
-
-/** A server's plugins as configured, whose commands the CLI adds. */
-export const serverPluginsOf = (
-  hotUpdater: HotUpdaterDBTarget,
-): readonly AnyHotUpdaterPlugin[] => getDBMetadata(hotUpdater).plugins;
-
-/** Whether `hot-updater db generate` writes schema files for a server's database. */
-export const generatesSchema = (hotUpdater: HotUpdaterDBTarget): boolean =>
-  getDBMetadata(hotUpdater).database.generateSchema !== undefined;
-
-/** The migrator for a server's database: core's tables and its plugins' tables. */
-export function createMigrator(hotUpdater: HotUpdaterDBTarget): Migrator {
-  const { database, target } = getDBMetadata(hotUpdater);
-  if (database.createMigrator === undefined) {
-    throw new Error(
-      database.generateSchema === undefined
-        ? `The ${database.name} database has no migrator; its provider applies the schema.`
-        : `The ${database.name} database applies its schema from migration files: run \`hot-updater db generate\`, then apply the file with the provider's tooling.`,
-    );
-  }
-  return database.createMigrator(target);
-}
-
-export function generateSchema(
-  hotUpdater: HotUpdaterDBTarget,
-  ...args: Parameters<SchemaGenerator>
-): ReturnType<SchemaGenerator> {
-  const { database, target } = getDBMetadata(hotUpdater);
-  if (database.generateSchema === undefined) {
-    throw new Error(
-      `The ${database.name} database has no schema generator; run \`hot-updater db migrate\` instead.`,
-    );
-  }
-  const [version, name] = args;
-  return database.generateSchema(version, name, target);
-}

package/src/db/node-sqlite.d.ts

@@ -1,25 +0,0 @@
-declare module "node:sqlite" {
-  export type SqliteValue = bigint | null | number | string | Uint8Array;
-
-  export interface StatementSync {
-    all: (...parameters: SqliteValue[]) => Record<string, SqliteValue>[];
-    columns: () => readonly unknown[];
-    get: (
-      ...parameters: SqliteValue[]
-    ) => Record<string, SqliteValue> | undefined;
-    iterate: (
-      ...parameters: SqliteValue[]
-    ) => IterableIterator<Record<string, SqliteValue>>;
-    run: (...parameters: SqliteValue[]) => {
-      readonly changes: number | bigint;
-      readonly lastInsertRowid: number | bigint;
-    };
-  }
-
-  export class DatabaseSync {
-    constructor(location: string);
-    close(): void;
-    exec(sql: string): void;
-    prepare(sql: string): StatementSync;
-  }
-}