Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

12.5 KB
Raw Blame
import driverVersions from "../../agents/versions.json";

export interface ArtifactInfo {
  url: string;
  size: number;
}

export type DownloadSource = "github" | "cnb" | "official";

export interface DownloadLink {
  source: DownloadSource;
  url: string;
}

export interface GitHubReleaseAsset {
  name: string;
  size: number;
  browser_download_url: string;
}

export interface AgentRegistryArtifact {
  url: string;
  sha256?: string;
  size: number;
  format?: "tar_zstd";
}

export interface AgentRegistryDriver {
  version?: string;
  label?: string;
  min_app_version?: string;
  jre?: string;
  jar?: AgentRegistryArtifact;
  native?: Record<string, AgentRegistryArtifact>;
}

export interface AgentRegistry {
  jres?: Record<string, { version?: string; platforms?: Record<string, AgentRegistryArtifact> }>;
  drivers?: Record<string, AgentRegistryDriver>;
}

export interface OfflineBundleEntry {
  platformKey: string;
  platformLabel: string;
  filename: string;
  size: number;
  url: string;
}

export interface JreDisplayEntry {
  platformKey: string;
  platformLabel: string;
  info: ArtifactInfo;
  jreVersion: string;
  jreKey: string;
}

export interface DriverDisplayEntry {
  key: string;
  label: string;
  version: string;
  minAppVersion: string;
  jar: ArtifactInfo;
  jre: string;
}

export interface NativeAgentDisplayEntry {
  key: string;
  label: string;
  version: string;
  platformKey: string;
  platformLabel: string;
  filename: string;
  info: ArtifactInfo;
}

export function selectNativeAgentPlatform(options: ReadonlyArray<Pick<NativeAgentDisplayEntry, "platformKey">>, detectedPlatform: string | null, selectedPlatform?: string, manuallySelected = false): string | undefined {
  if (manuallySelected && options.some((option) => option.platformKey === selectedPlatform)) return selectedPlatform;
  return options.find((option) => option.platformKey === detectedPlatform)?.platformKey ?? options[0]?.platformKey;
}

export interface JdbcPluginDownloadEntry {
  label: string;
  filename: string;
  url: string;
}

export interface AgentDownloadCatalog {
  jdbcPlugin: JdbcPluginDownloadEntry;
  bundles: OfflineBundleEntry[];
  drivers: DriverDisplayEntry[];
  jres: JreDisplayEntry[];
  nativeAgents: NativeAgentDisplayEntry[];
}

const JDBC_PLUGIN_DOWNLOAD_URL = "https://dl.dbxio.com/releases/latest/dbx-jdbc-plugin-latest.zip";
const GITHUB_RELEASE_DOWNLOAD_PREFIX = "https://github.com/t8y2/dbx/releases/download/";
const CNB_RELEASE_DOWNLOAD_PREFIX = "https://cnb.cool/dbxio.com/dbx/-/releases/download/";
const MIN_APP_VERSION = "0.6.0";
const driverVersionMap = driverVersions as Record<string, string>;

export const platformLabels: Record<string, string> = {
  "macos-aarch64": "macOS (Apple Silicon)",
  "macos-x64": "macOS (Intel)",
  "linux-aarch64": "Linux (ARM64)",
  "linux-x64": "Linux (x64)",
  "windows-aarch64": "Windows (ARM64)",
  "windows-x64": "Windows (x64)",
};

const driverLabels: Record<string, string> = {
  access: "Microsoft Access",
  bigquery: "BigQuery",
  cassandra: "Apache Cassandra",
  dameng: "Dameng",
  databend: "Databend",
  databricks: "Databricks",
  db2: "DB2",
  duckdb: "DuckDB",
  etcd: "etcd",
  exasol: "Exasol",
  firebird: "Firebird",
  gbase8a: "GBase 8a",
  gbase8c: "GBase 8c",
  gbase8s: "GBase 8s",
  goldendb: "GoldenDB",
  h2: "H2",
  highgo: "HighGo",
  hive: "Apache Hive",
  ignite: "Apache Ignite",
  ignite3: "Apache Ignite 3",
  informix: "Informix",
  iotdb: "Apache IoTDB",
  iris: "InterSystems IRIS",
  kingbase: "KingbaseES",
  kylin: "Apache Kylin",
  mongodb: "MongoDB (Legacy)",
  neo4j: "Neo4j",
  "oceanbase-oracle": "OceanBase Oracle Mode",
  oracle: "Oracle",
  "oracle-oci": "Oracle (OCI)",
  rabbitmq: "RabbitMQ",
  rocketmq: "Apache RocketMQ",
  saphana: "SAP HANA",
  snowflake: "Snowflake",
  spanner: "Cloud Spanner",
  sundb: "SunDB",
  tdengine: "TDengine",
  teradata: "Teradata",
  trino: "Trino",
  uxdb: "优炫 UXDB",
  vastbase: "Vastbase",
  vertica: "Vertica",
  xugu: "虚谷 XuguDB",
  yashandb: "YashanDB",
  zookeeper: "Apache ZooKeeper",
};

const currentDriverKeys = Object.keys(driverVersionMap).sort((a, b) => labelForDriver(a).localeCompare(labelForDriver(b)));
const currentDriverKeyPattern = [...currentDriverKeys]
  .sort((a, b) => b.length - a.length)
  .map(escapeRegExp)
  .join("|");

const jreVersions: Record<string, string> = {
  "21": "21",
};

export function labelForDriver(key: string): string {
  return driverLabels[key] ?? key.replace(/-/g, " ");
}

function escapeRegExp(value: string): string {
  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
}

function assetInfo(asset: GitHubReleaseAsset): ArtifactInfo {
  return {
    url: asset.browser_download_url,
    size: asset.size,
  };
}

function releaseAssetName(url: string, fallback: string): string {
  try {
    return decodeURIComponent(new URL(url).pathname.split("/").pop() || fallback);
  } catch {
    return fallback;
  }
}

function siblingReleaseAssetUrl(url: string, filename: string): string {
  const separator = url.lastIndexOf("/");
  return separator >= 0 ? `${url.slice(0, separator + 1)}${filename}` : filename;
}

function registryReleaseAssets(registry: AgentRegistry): GitHubReleaseAsset[] {
  const assets = new Map<string, GitHubReleaseAsset>();
  let releaseAssetUrl: string | undefined;
  const addArtifact = (artifact: AgentRegistryArtifact | undefined, fallbackName: string) => {
    if (!artifact?.url) return;
    releaseAssetUrl ??= artifact.url.startsWith(GITHUB_RELEASE_DOWNLOAD_PREFIX) ? artifact.url : undefined;
    const name = releaseAssetName(artifact.url, fallbackName);
    assets.set(name, { name, size: artifact.size || 0, browser_download_url: artifact.url });
  };

  for (const [jreKey, jre] of Object.entries(registry.jres ?? {})) {
    for (const [platformKey, artifact] of Object.entries(jre.platforms ?? {})) {
      addArtifact(artifact, `dbx-jre-${jreKey}-${platformKey}.tar.zst`);
    }
  }

  for (const [driverKey, driver] of Object.entries(registry.drivers ?? {})) {
    addArtifact(driver.jar, `dbx-agent-${driverKey}-${driver.version ?? "latest"}.tar.zst`);
    for (const [platformKey, artifact] of Object.entries(driver.native ?? {})) {
      addArtifact(artifact, `dbx-agent-${driverKey}-${driver.version ?? "latest"}-${platformKey}.tar.zst`);
    }
  }

  if (releaseAssetUrl) {
    for (const platformKey of Object.keys(registry.jres?.["21"]?.platforms ?? {})) {
      const name = `dbx-agents-offline-${platformKey}.zip`;
      assets.set(name, {
        name,
        size: 0,
        browser_download_url: siblingReleaseAssetUrl(releaseAssetUrl, name),
      });
    }
  }

  return Array.from(assets.values());
}

export function downloadLinksFor(url: string): DownloadLink[] {
  const releasePath = url.startsWith(GITHUB_RELEASE_DOWNLOAD_PREFIX) ? url.slice(GITHUB_RELEASE_DOWNLOAD_PREFIX.length) : null;
  if (!releasePath) return [{ source: "official", url }];

  return [
    { source: "github", url },
    { source: "cnb", url: `${CNB_RELEASE_DOWNLOAD_PREFIX}${releasePath}` },
  ];
}

function assetMap(assets: GitHubReleaseAsset[]): Map<string, GitHubReleaseAsset> {
  return new Map(assets.map((asset) => [asset.name, asset]));
}

export function buildAgentDownloadCatalogFromRegistry(registry: AgentRegistry): AgentDownloadCatalog {
  const assets = registryReleaseAssets(registry);
  return {
    jdbcPlugin: buildJdbcPluginDownloadEntry(),
    bundles: buildOfflineBundleEntries(assets),
    drivers: buildDriverEntriesFromRegistry(registry),
    jres: buildJreEntries(assets),
    nativeAgents: buildNativeAgentEntries(assets),
  };
}

export function buildAgentDownloadCatalog(assets: GitHubReleaseAsset[]): AgentDownloadCatalog {
  return {
    jdbcPlugin: buildJdbcPluginDownloadEntry(),
    bundles: buildOfflineBundleEntries(assets),
    drivers: buildDriverEntries(assets),
    jres: buildJreEntries(assets),
    nativeAgents: buildNativeAgentEntries(assets),
  };
}

export function buildJdbcPluginDownloadEntry(): JdbcPluginDownloadEntry {
  return {
    label: "DBX JDBC Plugin",
    filename: "dbx-jdbc-plugin-latest.zip",
    url: JDBC_PLUGIN_DOWNLOAD_URL,
  };
}

export function buildJreEntries(assets: GitHubReleaseAsset[]): JreDisplayEntry[] {
  return assets
    .map((asset) => {
      const match = /^dbx-jre-(\d+)-(.+)\.tar\.(?:zst|gz)$/.exec(asset.name);
      if (!match) return null;

      const [, jreKey, platformKey] = match;
      if (!jreVersions[jreKey]) return null;

      return {
        platformKey,
        platformLabel: platformLabels[platformKey] ?? platformKey,
        info: assetInfo(asset),
        jreVersion: jreVersions[jreKey],
        jreKey,
      };
    })
    .filter((entry): entry is JreDisplayEntry => entry !== null)
    .sort((a, b) => a.platformLabel.localeCompare(b.platformLabel));
}

export function buildDriverEntries(assets: GitHubReleaseAsset[]): DriverDisplayEntry[] {
  const byName = assetMap(assets);

  return currentDriverKeys
    .map((key) => {
      const version = driverVersionMap[key] ?? "";
      const asset = byName.get(`dbx-agent-${key}-${version}.tar.zst`) ?? byName.get(`dbx-agent-${key}-${version}.zip`) ?? byName.get(`dbx-agent-${key}-${version}.jar`) ?? byName.get(`dbx-agent-${key}.jar`);
      if (!asset) return null;

      return {
        key,
        label: labelForDriver(key),
        version,
        minAppVersion: MIN_APP_VERSION,
        jar: assetInfo(asset),
        jre: "21",
      };
    })
    .filter((entry): entry is DriverDisplayEntry => entry !== null);
}

function buildDriverEntriesFromRegistry(registry: AgentRegistry): DriverDisplayEntry[] {
  return Object.entries(registry.drivers ?? {})
    .map(([key, driver]) => {
      const jar = driver.jar;
      if (!jar?.url || jar.size <= 0) return null;

      return {
        key,
        label: labelForDriver(key),
        version: driver.version ?? driverVersionMap[key] ?? "",
        minAppVersion: driver.min_app_version ?? MIN_APP_VERSION,
        jar: { url: jar.url, size: jar.size },
        jre: driver.jre ?? "21",
      };
    })
    .filter((entry): entry is DriverDisplayEntry => entry !== null)
    .sort((a, b) => a.label.localeCompare(b.label));
}

export function buildNativeAgentEntries(assets: GitHubReleaseAsset[]): NativeAgentDisplayEntry[] {
  const entries = new Map<string, NativeAgentDisplayEntry & { packaged: boolean }>();
  const platforms = "macos-aarch64|macos-x64|linux-aarch64|linux-x64|windows-aarch64|windows-x64";

  for (const asset of assets) {
    const packageMatch = new RegExp(`^dbx-agent-(${currentDriverKeyPattern})-(.+)-(${platforms})\\.(?:tar\\.zst|zip)$`).exec(asset.name);
    const versionedMatch = new RegExp(`^dbx-agent-(${currentDriverKeyPattern})-(.+)-(${platforms})(?:\\.exe)?$`).exec(asset.name);
    const legacyMatch = new RegExp(`^dbx-agent-(${currentDriverKeyPattern})-(${platforms})(?:\\.exe)?$`).exec(asset.name);
    const match = packageMatch ?? versionedMatch ?? legacyMatch;
    if (!match) continue;

    const packaged = packageMatch !== null;
    const key = match[1];
    const version = legacyMatch ? (driverVersionMap[key] ?? "") : match[2];
    const platformKey = legacyMatch ? match[2] : match[3];
    const entryKey = `${key}:${platformKey}`;
    const existing = entries.get(entryKey);
    if (existing?.packaged && !packaged) continue;
    entries.set(entryKey, {
      key,
      label: labelForDriver(key),
      version,
      platformKey,
      platformLabel: platformLabels[platformKey] ?? platformKey,
      filename: asset.name,
      info: assetInfo(asset),
      packaged,
    });
  }

  return Array.from(entries.values())
    .map(({ packaged: _, ...entry }) => entry)
    .sort((a, b) => a.label.localeCompare(b.label) || a.platformLabel.localeCompare(b.platformLabel));
}

export function buildOfflineBundleEntries(assets: GitHubReleaseAsset[]): OfflineBundleEntry[] {
  return assets
    .map((asset) => {
      const match = /^dbx-agents-offline-(.+)\.zip$/.exec(asset.name);
      if (!match) return null;
      const platformKey = match[1];
      return {
        platformKey,
        platformLabel: platformLabels[platformKey] ?? platformKey,
        filename: asset.name,
        size: asset.size,
        url: asset.browser_download_url,
      };
    })
    .filter((entry): entry is OfflineBundleEntry => entry !== null)
    .sort((a, b) => a.platformLabel.localeCompare(b.platformLabel));
}

export function formatSize(bytes: number): string {
  if (bytes <= 0) return "—";
  if (bytes >= 1024 * 1024 * 1024) {
    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
  }
  if (bytes >= 1024 * 1024) {
    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
  }
  if (bytes >= 1024) {
    return `${(bytes / 1024).toFixed(1)} KB`;
  }
  return `${bytes} B`;
}