@hot-updater/server 0.36.6 → 1.0.0-rc.0

package/src/db/schema/sqlMigrations.ts

@@ -1,219 +0,0 @@
-import { hotUpdaterSchemaVersions } from "../../schema";
-import type {
-  HotUpdaterCheckSchema,
-  HotUpdaterForeignKeySchema,
-  HotUpdaterTableSchema,
-} from "../../schema/types";
-import type { ORMSQLProvider, RelationMode } from "../types";
-import {
-  getSchemaVersionIndex,
-  schemaIndexAppliesToProvider,
-} from "./registry";
-import {
-  createIndexSql,
-  createTableStatement,
-  sqlColumnDefinition,
-} from "./sql";
-
-const nameMap = <T extends { readonly name: string }>(
-  items: readonly T[] | undefined,
-): Map<string, T> => new Map((items ?? []).map((item) => [item.name, item]));
-
-const columnMap = (
-  table: HotUpdaterTableSchema,
-): Map<string, { readonly ormName: string }> =>
-  new Map(table.columns.map((column) => [column.ormName, column]));
-
-const stableStringify = (value: unknown): string => JSON.stringify(value);
-
-const assertSameSchemaValue = (
-  location: string,
-  left: unknown,
-  right: unknown,
-) => {
-  if (stableStringify(left) !== stableStringify(right)) {
-    throw new Error(
-      `Unsupported Hot Updater schema change at ${location}. Add an explicit migration step before changing existing schema metadata.`,
-    );
-  }
-};
-
-const compareNamedItems = <T extends { readonly name: string }>(
-  location: string,
-  previousItems: readonly T[] | undefined,
-  nextItems: readonly T[] | undefined,
-) => {
-  const nextItemsByName = nameMap(nextItems);
-  for (const previousItem of previousItems ?? []) {
-    const nextItem = nextItemsByName.get(previousItem.name);
-    if (!nextItem) {
-      throw new Error(
-        `Unsupported Hot Updater schema change at ${location}.${previousItem.name}. Removing schema metadata requires an explicit migration step.`,
-      );
-    }
-    assertSameSchemaValue(
-      `${location}.${previousItem.name}`,
-      previousItem,
-      nextItem,
-    );
-  }
-};
-
-const assertNoUnsupportedTableChanges = (
-  previous: HotUpdaterTableSchema,
-  next: HotUpdaterTableSchema,
-  provider: ORMSQLProvider,
-) => {
-  const nextColumns = columnMap(next);
-  for (const previousColumn of previous.columns) {
-    const nextColumn = nextColumns.get(previousColumn.ormName);
-    if (!nextColumn) {
-      throw new Error(
-        `Unsupported Hot Updater schema change at ${previous.ormName}.${previousColumn.ormName}. Dropping columns requires an explicit migration step.`,
-      );
-    }
-    assertSameSchemaValue(
-      `${previous.ormName}.${previousColumn.ormName}`,
-      previousColumn,
-      nextColumn,
-    );
-  }
-  compareNamedItems(
-    `${previous.ormName}.indexes`,
-    previous.indexes?.filter((index) =>
-      schemaIndexAppliesToProvider(index, provider),
-    ),
-    next.indexes?.filter((index) =>
-      schemaIndexAppliesToProvider(index, provider),
-    ),
-  );
-  compareNamedItems(`${previous.ormName}.checks`, previous.checks, next.checks);
-  compareNamedItems(
-    `${previous.ormName}.foreignKeys`,
-    previous.foreignKeys,
-    next.foreignKeys,
-  );
-};
-
-const createForeignKeySql = (
-  table: HotUpdaterTableSchema,
-  foreignKey: HotUpdaterForeignKeySchema,
-): string =>
-  `alter table ${table.ormName} add constraint ${foreignKey.name} foreign key (${foreignKey.columns.join(", ")}) references ${foreignKey.referencedTable}(${foreignKey.referencedColumns.join(", ")}) on update ${foreignKey.onUpdate} on delete ${foreignKey.onDelete}`;
-
-const createCheckSql = (
-  table: HotUpdaterTableSchema,
-  check: HotUpdaterCheckSchema,
-): string =>
-  `alter table ${table.ormName} add constraint ${check.name} check (${check.expression})`;
-
-const createAddedTableSql = (
-  table: HotUpdaterTableSchema,
-  provider: ORMSQLProvider,
-  relationMode: RelationMode,
-): readonly string[] => [
-  createTableStatement(table, provider),
-  ...(table.indexes ?? [])
-    .filter((index) => schemaIndexAppliesToProvider(index, provider))
-    .map((index) => createIndexSql(table, index, provider)),
-  ...(provider === "sqlite"
-    ? []
-    : (table.checks ?? []).map((check) => createCheckSql(table, check))),
-  ...(relationMode === "foreign-keys" && provider !== "sqlite"
-    ? (table.foreignKeys ?? []).map((foreignKey) =>
-        createForeignKeySql(table, foreignKey),
-      )
-    : []),
-];
-
-const createChangedTableSql = (
-  previous: HotUpdaterTableSchema,
-  next: HotUpdaterTableSchema,
-  provider: ORMSQLProvider,
-  relationMode: RelationMode,
-): readonly string[] => {
-  assertNoUnsupportedTableChanges(previous, next, provider);
-  const previousColumns = columnMap(previous);
-  const previousIndexes = nameMap(
-    previous.indexes?.filter((index) =>
-      schemaIndexAppliesToProvider(index, provider),
-    ),
-  );
-  const previousChecks = nameMap(previous.checks);
-  const previousForeignKeys = nameMap(previous.foreignKeys);
-
-  return [
-    ...next.columns
-      .filter((column) => !previousColumns.has(column.ormName))
-      .map(
-        (column) =>
-          `alter table ${next.ormName} add column ${sqlColumnDefinition(
-            next,
-            column,
-            provider,
-          )}`,
-      ),
-    ...(next.indexes ?? [])
-      .filter((index) => schemaIndexAppliesToProvider(index, provider))
-      .filter((index) => !previousIndexes.has(index.name))
-      .map((index) => createIndexSql(next, index, provider)),
-    ...(provider === "sqlite"
-      ? []
-      : (next.checks ?? [])
-          .filter((check) => !previousChecks.has(check.name))
-          .map((check) => createCheckSql(next, check))),
-    ...(relationMode === "foreign-keys" && provider !== "sqlite"
-      ? (next.foreignKeys ?? [])
-          .filter((foreignKey) => !previousForeignKeys.has(foreignKey.name))
-          .map((foreignKey) => createForeignKeySql(next, foreignKey))
-      : []),
-  ];
-};
-
-export const createSchemaMigrationSql = (
-  fromVersion: string,
-  toVersion: string,
-  provider: ORMSQLProvider,
-  relationMode: RelationMode = "foreign-keys",
-): readonly string[] => {
-  const fromIndex = getSchemaVersionIndex(fromVersion);
-  const toIndex = getSchemaVersionIndex(toVersion);
-  if (fromIndex === -1) {
-    throw new Error(`Unsupported Hot Updater schema version: ${fromVersion}`);
-  }
-  if (toIndex === -1) {
-    throw new Error(`Unsupported Hot Updater schema version: ${toVersion}`);
-  }
-  if (fromIndex > toIndex) {
-    throw new Error(`Cannot migrate Hot Updater schema down to ${toVersion}.`);
-  }
-
-  const statements: string[] = [];
-  for (let index = fromIndex + 1; index <= toIndex; index += 1) {
-    const previous = hotUpdaterSchemaVersions[index - 1]!;
-    const next = hotUpdaterSchemaVersions[index]!;
-    const previousTables = new Map(
-      previous.tables.map((table) => [table.ormName, table]),
-    );
-    for (const table of next.tables) {
-      if (table.internal) continue;
-      const previousTable = previousTables.get(table.ormName);
-      statements.push(
-        ...(previousTable
-          ? createChangedTableSql(previousTable, table, provider, relationMode)
-          : createAddedTableSql(table, provider, relationMode)),
-      );
-    }
-  }
-  return statements;
-};
-
-export const createV029AlterSql = (
-  provider: ORMSQLProvider,
-): readonly string[] => createSchemaMigrationSql("0.21.0", "0.29.0", provider);
-
-export const createV031AlterSql = (
-  provider: ORMSQLProvider,
-  relationMode: RelationMode = "foreign-keys",
-): readonly string[] =>
-  createSchemaMigrationSql("0.29.0", "0.31.0", provider, relationMode);

package/src/db/schemaEnhancements.ts

@@ -1,55 +0,0 @@
-import {
-  DEFAULT_ROLLOUT_COHORT_COUNT,
-  INVALID_COHORT_ERROR_MESSAGE,
-  isValidCohort,
-  type Bundle,
-} from "@hot-updater/core";
-
-const normalizeNullableString = (value: string | null | undefined) => {
-  if (value === null || value === undefined) {
-    return null;
-  }
-
-  const normalized = value.trim();
-  return normalized.length > 0 ? normalized : null;
-};
-
-export const assertBundlePersistenceConstraints = (
-  bundle: Pick<
-    Bundle,
-    | "fingerprintHash"
-    | "rolloutCohortCount"
-    | "targetAppVersion"
-    | "targetCohorts"
-  >,
-) => {
-  const targetAppVersion = normalizeNullableString(bundle.targetAppVersion);
-  const fingerprintHash = normalizeNullableString(bundle.fingerprintHash);
-
-  if (!targetAppVersion && !fingerprintHash) {
-    throw new Error(
-      "Bundle must define either targetAppVersion or fingerprintHash.",
-    );
-  }
-
-  const rolloutCohortCount = bundle.rolloutCohortCount;
-  if (rolloutCohortCount !== null && rolloutCohortCount !== undefined) {
-    if (
-      !Number.isInteger(rolloutCohortCount) ||
-      rolloutCohortCount < 0 ||
-      rolloutCohortCount > DEFAULT_ROLLOUT_COHORT_COUNT
-    ) {
-      throw new Error(
-        `rolloutCohortCount must be an integer between 0 and ${DEFAULT_ROLLOUT_COHORT_COUNT}.`,
-      );
-    }
-  }
-
-  for (const cohort of bundle.targetCohorts ?? []) {
-    if (!isValidCohort(cohort)) {
-      throw new Error(
-        `Invalid target cohort "${cohort}". ${INVALID_COHORT_ERROR_MESSAGE}`,
-      );
-    }
-  }
-};

package/src/route.ts

@@ -1,7 +0,0 @@
-export const normalizeBasePath = (basePath?: string) => {
-  if (!basePath || basePath === "/") {
-    return "/";
-  }
-
-  return basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
-};

package/src/schema/v0_21_0.ts

@@ -1,52 +0,0 @@
-import {
-  bool,
-  check,
-  idColumn,
-  index,
-  json,
-  schema,
-  stringColumn,
-  table,
-} from "./dsl";
-import { createSettingsTable } from "./settings";
-import { HOT_UPDATER_SETTINGS_TABLE } from "./types";
-
-export const bundlesV021 = table(
-  "bundles",
-  {
-    id: idColumn("id", "uuid"),
-    platform: stringColumn("platform"),
-    should_force_update: bool("should_force_update"),
-    enabled: bool("enabled"),
-    file_hash: stringColumn("file_hash"),
-    git_commit_hash: stringColumn("git_commit_hash").nullable(),
-    message: stringColumn("message").nullable(),
-    channel: stringColumn("channel").defaultTo("production"),
-    storage_uri: stringColumn("storage_uri"),
-    target_app_version: stringColumn("target_app_version").nullable(),
-    fingerprint_hash: stringColumn("fingerprint_hash").nullable(),
-    metadata: json("metadata").defaultTo({}),
-  },
-  {
-    indexes: [
-      index("bundles_target_app_version_idx", ["target_app_version"]),
-      index("bundles_fingerprint_hash_idx", ["fingerprint_hash"]),
-      index("bundles_channel_idx", ["channel"]),
-      index("bundles_platform_idx", ["platform"], ["mongodb"]),
-    ],
-    checks: [
-      check({
-        name: "check_version_or_fingerprint",
-        expression:
-          "(target_app_version is not null) or (fingerprint_hash is not null)",
-        sqliteInline: true,
-      }),
-    ],
-  },
-);
-
-export const v0_21_0 = schema({
-  version: "0.21.0",
-  settingsTable: HOT_UPDATER_SETTINGS_TABLE,
-  tables: [bundlesV021, createSettingsTable("0.21.0")],
-});

package/src/schema/v0_29_0.ts

@@ -1,62 +0,0 @@
-import {
-  bool,
-  check,
-  idColumn,
-  index,
-  integer,
-  json,
-  schema,
-  stringColumn,
-  table,
-} from "./dsl";
-import { createSettingsTable } from "./settings";
-import { HOT_UPDATER_SETTINGS_TABLE } from "./types";
-
-export const bundlesV029 = table(
-  "bundles",
-  {
-    id: idColumn("id", "uuid"),
-    platform: stringColumn("platform"),
-    should_force_update: bool("should_force_update"),
-    enabled: bool("enabled"),
-    file_hash: stringColumn("file_hash"),
-    git_commit_hash: stringColumn("git_commit_hash").nullable(),
-    message: stringColumn("message").nullable(),
-    channel: stringColumn("channel").defaultTo("production"),
-    storage_uri: stringColumn("storage_uri"),
-    target_app_version: stringColumn("target_app_version").nullable(),
-    fingerprint_hash: stringColumn("fingerprint_hash").nullable(),
-    metadata: json("metadata").defaultTo({}),
-    rollout_cohort_count: integer("rollout_cohort_count").defaultTo(1000),
-    target_cohorts: json("target_cohorts").nullable(),
-  },
-  {
-    indexes: [
-      index("bundles_target_app_version_idx", ["target_app_version"]),
-      index("bundles_fingerprint_hash_idx", ["fingerprint_hash"]),
-      index("bundles_channel_idx", ["channel"]),
-      index("bundles_platform_idx", ["platform"], ["mongodb"]),
-      index("bundles_rollout_idx", ["rollout_cohort_count"]),
-    ],
-    checks: [
-      check({
-        name: "check_version_or_fingerprint",
-        expression:
-          "(target_app_version is not null) or (fingerprint_hash is not null)",
-        sqliteInline: true,
-      }),
-      check({
-        name: "bundles_rollout_cohort_count_check",
-        expression:
-          "rollout_cohort_count >= 0 and rollout_cohort_count <= 1000",
-        sqliteInline: true,
-      }),
-    ],
-  },
-);
-
-export const v0_29_0 = schema({
-  version: "0.29.0",
-  settingsTable: HOT_UPDATER_SETTINGS_TABLE,
-  tables: [bundlesV029, createSettingsTable("0.29.0")],
-});

package/src/schema/v0_31_0.spec.ts

@@ -1,73 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { createTableStatement } from "../db/schema/sql";
-import { bundlePatchesV031, v0_31_0 } from "./v0_31_0";
-
-describe("bundlePatchesV031", () => {
-  it("uses the functional schema DSL for the v0.31.0 bundle patches table", () => {
-    expect(v0_31_0.dsl).toBe("schema");
-    expect(bundlePatchesV031.dsl).toBe("table");
-    expect(bundlePatchesV031.columns).toEqual([
-      { ormName: "id", type: "varchar(255)", primaryKey: true },
-      { ormName: "bundle_id", type: "uuid" },
-      { ormName: "base_bundle_id", type: "uuid" },
-      { ormName: "base_file_hash", type: "string" },
-      { ormName: "patch_file_hash", type: "string" },
-      { ormName: "patch_storage_uri", type: "string" },
-      {
-        ormName: "order_index",
-        type: "integer",
-        default: { type: "literal", value: 0 },
-      },
-    ]);
-    expect(bundlePatchesV031.indexes).toEqual([
-      { name: "bundle_patches_bundle_id_idx", columns: ["bundle_id"] },
-      {
-        name: "bundle_patches_base_bundle_id_idx",
-        columns: ["base_bundle_id"],
-      },
-    ]);
-    expect(bundlePatchesV031.foreignKeys).toEqual([
-      {
-        name: "bundle_patches_bundle_id_fk",
-        columns: ["bundle_id"],
-        referencedTable: "bundles",
-        referencedColumns: ["id"],
-        onUpdate: "restrict",
-        onDelete: "cascade",
-      },
-      {
-        name: "bundle_patches_base_bundle_id_fk",
-        columns: ["base_bundle_id"],
-        referencedTable: "bundles",
-        referencedColumns: ["id"],
-        onUpdate: "restrict",
-        onDelete: "cascade",
-      },
-    ]);
-    expect(bundlePatchesV031.relations).toEqual([
-      {
-        name: "bundle",
-        fieldName: "patches",
-        targetFieldName: "bundle",
-        relationName: "bundle_patches_bundles_patches",
-        columns: ["bundle_id"],
-        referencedTable: "bundles",
-        referencedColumns: ["id"],
-      },
-      {
-        name: "baseBundle",
-        fieldName: "baseForPatches",
-        targetFieldName: "baseBundle",
-        relationName: "bundle_patches_bundles_baseForPatches",
-        columns: ["base_bundle_id"],
-        referencedTable: "bundles",
-        referencedColumns: ["id"],
-      },
-    ]);
-    expect(Object.keys(bundlePatchesV031)).not.toContain("dsl");
-    expect(createTableStatement(bundlePatchesV031, "postgresql")).toContain(
-      "id varchar(255) primary key not null",
-    );
-  });
-});

package/src/schema/v0_31_0.ts

@@ -1,120 +0,0 @@
-import {
-  bool,
-  check,
-  column,
-  foreignKey,
-  idColumn,
-  index,
-  integer,
-  json,
-  relation,
-  schema,
-  stringColumn,
-  table,
-  uuid,
-  varchar,
-} from "./dsl";
-import { createSettingsTable } from "./settings";
-import { HOT_UPDATER_SETTINGS_TABLE } from "./types";
-
-export const bundlesV031 = table(
-  "bundles",
-  {
-    id: idColumn("id", "uuid"),
-    platform: stringColumn("platform"),
-    should_force_update: bool("should_force_update"),
-    enabled: bool("enabled"),
-    file_hash: stringColumn("file_hash"),
-    git_commit_hash: stringColumn("git_commit_hash").nullable(),
-    message: stringColumn("message").nullable(),
-    channel: stringColumn("channel").defaultTo("production"),
-    storage_uri: stringColumn("storage_uri"),
-    target_app_version: stringColumn("target_app_version").nullable(),
-    fingerprint_hash: stringColumn("fingerprint_hash").nullable(),
-    metadata: json("metadata").defaultTo({}),
-    rollout_cohort_count: integer("rollout_cohort_count").defaultTo(1000),
-    target_cohorts: json("target_cohorts").nullable(),
-    manifest_storage_uri: stringColumn("manifest_storage_uri").nullable(),
-    manifest_file_hash: stringColumn("manifest_file_hash").nullable(),
-    asset_base_storage_uri: stringColumn("asset_base_storage_uri").nullable(),
-  },
-  {
-    indexes: [
-      index("bundles_target_app_version_idx", ["target_app_version"]),
-      index("bundles_fingerprint_hash_idx", ["fingerprint_hash"]),
-      index("bundles_channel_idx", ["channel"]),
-      index("bundles_platform_idx", ["platform"], ["mongodb"]),
-      index("bundles_rollout_idx", ["rollout_cohort_count"]),
-    ],
-    checks: [
-      check({
-        name: "check_version_or_fingerprint",
-        expression:
-          "(target_app_version is not null) or (fingerprint_hash is not null)",
-        sqliteInline: true,
-      }),
-      check({
-        name: "bundles_rollout_cohort_count_check",
-        expression:
-          "rollout_cohort_count >= 0 and rollout_cohort_count <= 1000",
-        sqliteInline: true,
-      }),
-    ],
-  },
-);
-
-export const bundlePatchesV031 = table(
-  "bundle_patches",
-  {
-    id: idColumn("id", varchar(255)),
-    bundle_id: uuid("bundle_id"),
-    base_bundle_id: uuid("base_bundle_id"),
-    base_file_hash: column("base_file_hash", "string"),
-    patch_file_hash: column("patch_file_hash", "string"),
-    patch_storage_uri: column("patch_storage_uri", "string"),
-    order_index: integer("order_index").defaultTo(0),
-  },
-  {
-    indexes: [
-      index("bundle_patches_bundle_id_idx", ["bundle_id"]),
-      index("bundle_patches_base_bundle_id_idx", ["base_bundle_id"]),
-    ],
-    foreignKeys: [
-      foreignKey("bundle_patches_bundle_id_fk", ["bundle_id"], "bundles", [
-        "id",
-      ]),
-      foreignKey(
-        "bundle_patches_base_bundle_id_fk",
-        ["base_bundle_id"],
-        "bundles",
-        ["id"],
-      ),
-    ],
-    relations: [
-      relation({
-        name: "bundle",
-        fieldName: "patches",
-        targetFieldName: "bundle",
-        relationName: "bundle_patches_bundles_patches",
-        columns: ["bundle_id"],
-        referencedTable: "bundles",
-        referencedColumns: ["id"],
-      }),
-      relation({
-        name: "baseBundle",
-        fieldName: "baseForPatches",
-        targetFieldName: "baseBundle",
-        relationName: "bundle_patches_bundles_baseForPatches",
-        columns: ["base_bundle_id"],
-        referencedTable: "bundles",
-        referencedColumns: ["id"],
-      }),
-    ],
-  },
-);
-
-export const v0_31_0 = schema({
-  version: "0.31.0",
-  settingsTable: HOT_UPDATER_SETTINGS_TABLE,
-  tables: [bundlesV031, bundlePatchesV031, createSettingsTable("0.31.0")],
-});