hostdb 0.30.0 → 0.31.1

package/dist/databases.d.ts

@@ -0,0 +1,125 @@
+export type Platform = 'linux-x64' | 'linux-arm64' | 'darwin-x64' | 'darwin-arm64' | 'win32-x64';
+export declare const ALL_PLATFORMS: Platform[];
+export type Dependency = {
+    database: string;
+    cascadeDelete: boolean;
+    note?: string;
+};
+export type CliTools = {
+    server: string | null;
+    client: string | null;
+    utilities: string[];
+    enhanced: string[];
+    note?: string;
+};
+export type PlatformConfig = {
+    dependencies?: Dependency[];
+    cliTools?: CliTools;
+};
+export type PlatformEntry = true | PlatformConfig;
+export type VersionConfig = {
+    enabled?: boolean;
+    deprecated?: boolean;
+    note?: string;
+    dependencies?: Dependency[];
+    platforms?: Platform[] | Record<string, PlatformEntry>;
+    cliTools?: CliTools;
+};
+export type VersionEntry = boolean | VersionConfig;
+export type DatabaseEntry = {
+    displayName: string;
+    description: string;
+    type: string;
+    sourceRepo: string;
+    license: string;
+    commercialUse: boolean;
+    hostedServiceAllowed: boolean;
+    protocol: string | null;
+    note?: string;
+    dependencies?: Dependency[];
+    spindbStatus: 'completed' | 'in-progress';
+    /**
+     * Major-version → full-version policy (e.g., '8' → '8.0.23' for MongoDB).
+     * Resolves ambiguous user input to the intended LTS or latest pick.
+     * Optional: engines with single-track majors don't need it; multi-track engines must declare it.
+     */
+    defaults?: Record<string, string>;
+    versions: Record<string, VersionEntry>;
+    platforms: Platform[];
+    cliTools: CliTools;
+    connection: {
+        runtime: 'server' | 'embedded';
+        defaultPort: number | null;
+        scheme: string | null;
+        defaultDatabase: string | null;
+        defaultUser: string | null;
+        queryLanguage: string;
+    };
+};
+export type DatabasesJson = {
+    $schema?: string;
+    _generated?: string;
+    databases: Record<string, DatabaseEntry>;
+};
+export type PlatformAsset = {
+    url: string;
+    sha256: string;
+    size: number;
+};
+export type VersionRelease = {
+    version: string;
+    releaseTag: string;
+    releasedAt: string;
+    deprecated?: boolean;
+    platforms: Partial<Record<Platform, PlatformAsset>>;
+};
+export type ReleasesJson = {
+    $schema?: string;
+    repository: string;
+    databases: Record<string, Record<string, VersionRelease>>;
+};
+export declare function loadDatabasesJson(): DatabasesJson;
+export declare function loadReleasesJson(): ReleasesJson;
+export declare function loadDownloadsJson(): unknown;
+/** Drop loader caches. Tests only — not part of the public API. */
+export declare function _resetLoaderCachesForTests(): void;
+/** Check if a version entry is enabled */
+export declare function isVersionEnabled(entry: VersionEntry): boolean;
+/** Check if a version entry is deprecated */
+export declare function isVersionDeprecated(entry: VersionEntry): boolean;
+/** Get set of enabled version strings for a database */
+export declare function getEnabledVersions(database: string): Set<string>;
+/** Get effective platforms for a version (version overrides or engine defaults) */
+export declare function getVersionPlatforms(engine: DatabaseEntry, version: string): Platform[];
+/**
+ * Get effective dependencies for a version+platform.
+ *
+ * Resolution order (each level fully replaces):
+ * 1. Engine-level dependencies
+ * 2. Version-level dependencies (if specified)
+ * 3. Platform-level dependencies within version (if platforms is object form and platform entry has dependencies)
+ */
+export declare function getVersionDependencies(engine: DatabaseEntry, version: string, platform?: Platform): Dependency[];
+/**
+ * Get effective CLI tools for a version+platform.
+ *
+ * Resolution order (each level fully replaces):
+ * 1. Engine-level cliTools
+ * 2. Version-level cliTools (if specified)
+ * 3. Platform-level cliTools within version (if platforms is object form and platform entry has cliTools)
+ */
+export declare function getVersionCliTools(engine: DatabaseEntry, version: string, platform?: Platform): CliTools;
+/**
+ * Generate databases.json from databases.yml.
+ *
+ * Build-time helper. Uses `yaml` (devDependency) via dynamic import so that
+ * npm consumers of this package (who only call the resolver) don't need
+ * `yaml` in their tree.
+ *
+ * @returns true if the file was changed/created (or needs updating in check mode), false if already up-to-date
+ */
+export declare function generateDatabasesJson(options?: {
+    checkOnly?: boolean;
+    rootDir?: string;
+}): Promise<boolean>;
+//# sourceMappingURL=databases.d.ts.map

package/dist/databases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databases.d.ts","sourceRoot":"","sources":["../lib/databases.ts"],"names":[],"mappings":"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"}

package/dist/databases.js

@@ -0,0 +1,217 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// `yaml` is intentionally NOT statically imported — it's a devDependency only.
+// `generateDatabasesJson` lazy-imports it so npm consumers (who only call the
+// resolver) don't need yaml in their tree.
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+// All supported platforms
+export const ALL_PLATFORMS = [
+    'linux-x64',
+    'linux-arm64',
+    'darwin-x64',
+    'darwin-arm64',
+    'win32-x64',
+];
+// Loader caches. The bundled JSON files are immutable for the lifetime of a
+// process (they ship inside the npm tarball), so we memoize the parse result
+// to avoid re-reading + re-parsing on every call. Tests that need a clean
+// slate can call `_resetLoaderCachesForTests`.
+let _databasesJsonCache = null;
+let _releasesJsonCache = null;
+let _downloadsJsonCache = null;
+export function loadDatabasesJson() {
+    if (_databasesJsonCache !== null)
+        return _databasesJsonCache;
+    const filePath = join(ROOT, 'databases.json');
+    _databasesJsonCache = JSON.parse(readFileSync(filePath, 'utf-8'));
+    return _databasesJsonCache;
+}
+export function loadReleasesJson() {
+    if (_releasesJsonCache !== null)
+        return _releasesJsonCache;
+    const filePath = join(ROOT, 'releases.json');
+    _releasesJsonCache = JSON.parse(readFileSync(filePath, 'utf-8'));
+    return _releasesJsonCache;
+}
+export function loadDownloadsJson() {
+    if (_downloadsJsonCache !== null)
+        return _downloadsJsonCache;
+    const filePath = join(ROOT, 'downloads.json');
+    _downloadsJsonCache = JSON.parse(readFileSync(filePath, 'utf-8'));
+    return _downloadsJsonCache;
+}
+/** Drop loader caches. Tests only — not part of the public API. */
+export function _resetLoaderCachesForTests() {
+    _databasesJsonCache = null;
+    _releasesJsonCache = null;
+    _downloadsJsonCache = null;
+}
+// --- Internal helpers ---
+/** Get the version's platforms field, handling both array and object forms */
+function getVersionPlatformsRaw(versionEntry) {
+    if (!versionEntry.platforms) {
+        return { list: [], map: null };
+    }
+    if (Array.isArray(versionEntry.platforms)) {
+        return { list: versionEntry.platforms, map: null };
+    }
+    // Object form: keys are platforms
+    const map = versionEntry.platforms;
+    return { list: Object.keys(map), map };
+}
+// --- Resolver helpers ---
+/** Check if a version entry is enabled */
+export function isVersionEnabled(entry) {
+    if (typeof entry === 'boolean')
+        return entry;
+    return entry.enabled !== false;
+}
+/** Check if a version entry is deprecated */
+export function isVersionDeprecated(entry) {
+    if (typeof entry === 'boolean')
+        return false;
+    return entry.deprecated === true;
+}
+/** Get set of enabled version strings for a database */
+export function getEnabledVersions(database) {
+    try {
+        const data = loadDatabasesJson();
+        const dbEntry = data.databases[database];
+        if (!dbEntry)
+            return new Set();
+        return new Set(Object.entries(dbEntry.versions)
+            .filter(([, entry]) => isVersionEnabled(entry))
+            .map(([version]) => version));
+    }
+    catch {
+        return new Set();
+    }
+}
+/** Get effective platforms for a version (version overrides or engine defaults) */
+export function getVersionPlatforms(engine, version) {
+    const versionEntry = engine.versions[version];
+    if (!versionEntry || typeof versionEntry === 'boolean') {
+        return [...engine.platforms];
+    }
+    const { list } = getVersionPlatformsRaw(versionEntry);
+    return list.length > 0 ? [...list] : [...engine.platforms];
+}
+/**
+ * Get effective dependencies for a version+platform.
+ *
+ * Resolution order (each level fully replaces):
+ * 1. Engine-level dependencies
+ * 2. Version-level dependencies (if specified)
+ * 3. Platform-level dependencies within version (if platforms is object form and platform entry has dependencies)
+ */
+export function getVersionDependencies(engine, version, platform) {
+    const versionEntry = engine.versions[version];
+    if (!versionEntry || typeof versionEntry === 'boolean') {
+        return engine.dependencies ?? [];
+    }
+    // Version-level replaces engine-level
+    let resolved = versionEntry.dependencies ?? engine.dependencies ?? [];
+    // Platform-level replaces version-level
+    if (platform) {
+        const { map } = getVersionPlatformsRaw(versionEntry);
+        if (map) {
+            const platformEntry = map[platform];
+            if (platformEntry &&
+                typeof platformEntry === 'object' &&
+                platformEntry.dependencies) {
+                resolved = platformEntry.dependencies;
+            }
+        }
+    }
+    return resolved;
+}
+/**
+ * Get effective CLI tools for a version+platform.
+ *
+ * Resolution order (each level fully replaces):
+ * 1. Engine-level cliTools
+ * 2. Version-level cliTools (if specified)
+ * 3. Platform-level cliTools within version (if platforms is object form and platform entry has cliTools)
+ */
+export function getVersionCliTools(engine, version, platform) {
+    const versionEntry = engine.versions[version];
+    if (!versionEntry || typeof versionEntry === 'boolean') {
+        return engine.cliTools;
+    }
+    // Version-level replaces engine-level
+    let resolved = versionEntry.cliTools ?? engine.cliTools;
+    // Platform-level replaces version-level
+    if (platform) {
+        const { map } = getVersionPlatformsRaw(versionEntry);
+        if (map) {
+            const platformEntry = map[platform];
+            if (platformEntry &&
+                typeof platformEntry === 'object' &&
+                platformEntry.cliTools) {
+                resolved = platformEntry.cliTools;
+            }
+        }
+    }
+    return resolved;
+}
+// --- databases.json generation from databases.yml ---
+/** Convert a snake_case string to camelCase */
+function snakeToCamel(str) {
+    return str.replace(/_([a-z0-9])/g, (_, char) => char.toUpperCase());
+}
+/** Recursively convert all object keys from snake_case to camelCase */
+function transformKeys(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(transformKeys);
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[snakeToCamel(key)] = transformKeys(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Generate databases.json from databases.yml.
+ *
+ * Build-time helper. Uses `yaml` (devDependency) via dynamic import so that
+ * npm consumers of this package (who only call the resolver) don't need
+ * `yaml` in their tree.
+ *
+ * @returns true if the file was changed/created (or needs updating in check mode), false if already up-to-date
+ */
+export async function generateDatabasesJson(options) {
+    const { checkOnly = false, rootDir = ROOT } = options ?? {};
+    const yamlPath = join(rootDir, 'databases.yml');
+    const jsonPath = join(rootDir, 'databases.json');
+    if (!existsSync(yamlPath)) {
+        return false;
+    }
+    const { parse: parseYaml } = await import('yaml');
+    const yamlContent = readFileSync(yamlPath, 'utf-8');
+    const parsed = parseYaml(yamlContent);
+    const transformed = transformKeys(parsed);
+    const output = {
+        _generated: 'DO NOT EDIT. Generated from databases.yml by pnpm prep. Edit databases.yml instead.',
+        $schema: './schemas/databases.schema.json',
+        ...transformed,
+    };
+    const newJson = JSON.stringify(output, null, 2) + '\n';
+    let currentJson = '';
+    if (existsSync(jsonPath)) {
+        currentJson = readFileSync(jsonPath, 'utf-8');
+    }
+    if (currentJson === newJson) {
+        return false;
+    }
+    if (checkOnly) {
+        return true;
+    }
+    writeFileSync(jsonPath, newJson);
+    return true;
+}
+//# sourceMappingURL=databases.js.map

package/dist/databases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databases.js","sourceRoot":"","sources":["../lib/databases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,+EAA+E;AAC/E,8EAA8E;AAC9E,2CAA2C;AAE3C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AAUlC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,WAAW;IACX,aAAa;IACb,YAAY;IACZ,cAAc;IACd,WAAW;CACZ,CAAA;AAsGD,4EAA4E;AAC5E,6EAA6E;AAC7E,0EAA0E;AAC1E,+CAA+C;AAC/C,IAAI,mBAAmB,GAAyB,IAAI,CAAA;AACpD,IAAI,kBAAkB,GAAwB,IAAI,CAAA;AAClD,IAAI,mBAAmB,GAAY,IAAI,CAAA;AAEvC,MAAM,UAAU,iBAAiB;IAC/B,IAAI,mBAAmB,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAA;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IAC7C,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAC9B,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CACf,CAAA;IAClB,OAAO,mBAAmB,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,kBAAkB,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAA;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAC5C,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAC7B,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAChB,CAAA;IACjB,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,mBAAmB,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAA;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IAC7C,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IACjE,OAAO,mBAAmB,CAAA;AAC5B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,0BAA0B;IACxC,mBAAmB,GAAG,IAAI,CAAA;IAC1B,kBAAkB,GAAG,IAAI,CAAA;IACzB,mBAAmB,GAAG,IAAI,CAAA;AAC5B,CAAC;AAED,2BAA2B;AAE3B,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,YAA2B;IAIzD,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;IAChC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,SAAuB,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;IAClE,CAAC;IAED,kCAAkC;IAClC,MAAM,GAAG,GAAG,YAAY,CAAC,SAA0C,CAAA;IACnE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAe,EAAE,GAAG,EAAE,CAAA;AACtD,CAAC;AAED,2BAA2B;AAE3B,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC5C,OAAO,KAAK,CAAC,OAAO,KAAK,KAAK,CAAA;AAChC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC5C,OAAO,KAAK,CAAC,UAAU,KAAK,IAAI,CAAA;AAClC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAA;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,GAAG,EAAE,CAAA;QAE9B,OAAO,IAAI,GAAG,CACZ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;aAC9C,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAC/B,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAA;IAClB,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,OAAe;IAEf,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;QACvD,OAAO,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;IACrD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAqB,EACrB,OAAe,EACf,QAAmB;IAEnB,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,YAAY,IAAI,EAAE,CAAA;IAClC,CAAC;IAED,sCAAsC;IACtC,IAAI,QAAQ,GAAG,YAAY,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,IAAI,EAAE,CAAA;IAErE,wCAAwC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,EAAE,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;QACpD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;YACnC,IACE,aAAa;gBACb,OAAO,aAAa,KAAK,QAAQ;gBACjC,aAAa,CAAC,YAAY,EAC1B,CAAC;gBACD,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAA;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,OAAe,EACf,QAAmB;IAEnB,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,QAAQ,CAAA;IACxB,CAAC;IAED,sCAAsC;IACtC,IAAI,QAAQ,GAAG,YAAY,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAA;IAEvD,wCAAwC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,EAAE,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;QACpD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;YACnC,IACE,aAAa;gBACb,OAAO,aAAa,KAAK,QAAQ;gBACjC,aAAa,CAAC,QAAQ,EACtB,CAAC;gBACD,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAA;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,uDAAuD;AAEvD,+CAA+C;AAC/C,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED,uEAAuE;AACvE,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IAC/B,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YAC1E,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAG3C;IACC,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAEhD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IACjD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAA4B,CAAA;IAEhE,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAA4B,CAAA;IAEpE,MAAM,MAAM,GAAG;QACb,UAAU,EACR,qFAAqF;QACvF,OAAO,EAAE,iCAAiC;QAC1C,GAAG,WAAW;KACf,CAAA;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;IAEtD,IAAI,WAAW,GAAG,EAAE,CAAA;IACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAChC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * hostdb — public npm package surface
+ *
+ * Consumers (spindb, layerbase-cloud, third parties) install this package
+ * and import from it. The package bundles `databases.json` and `releases.json`
+ * snapshotted at publish time, so the resolver works offline with no network
+ * dependency on registry.layerbase.host.
+ *
+ * Quick start:
+ *   import { resolveVersion, getReleaseInfo } from 'hostdb'
+ *
+ *   const full = resolveVersion('postgresql', '17')        // '17.10.0'
+ *   const info = getReleaseInfo('postgresql', full, 'linux-x64')
+ *   //   { url: 'https://registry.layerbase.host/...', sha256: '...', size: ... }
+ *
+ * Anything outside this index is internal and may change without notice.
+ */
+export { resolveVersion, normalizeVersion, listVersions, listEngines, getSupportedMajorVersions, getMajorDefault, getEngineDefaults, getReleaseInfo, getAvailablePlatforms, isVersionDeprecated, getCliTools, getDatabaseEntry, compareVersions, type ListVersionsOptions, } from './resolver.js';
+export { loadDatabasesJson, loadReleasesJson, loadDownloadsJson, isVersionEnabled, getEnabledVersions, } from './databases.js';
+export type { Platform, PlatformEntry, PlatformConfig, PlatformAsset, Dependency, CliTools, VersionConfig, VersionEntry, VersionRelease, DatabaseEntry, DatabasesJson, ReleasesJson, } from './databases.js';
+export { ALL_PLATFORMS } from './databases.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAGvB,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * hostdb — public npm package surface
+ *
+ * Consumers (spindb, layerbase-cloud, third parties) install this package
+ * and import from it. The package bundles `databases.json` and `releases.json`
+ * snapshotted at publish time, so the resolver works offline with no network
+ * dependency on registry.layerbase.host.
+ *
+ * Quick start:
+ *   import { resolveVersion, getReleaseInfo } from 'hostdb'
+ *
+ *   const full = resolveVersion('postgresql', '17')        // '17.10.0'
+ *   const info = getReleaseInfo('postgresql', full, 'linux-x64')
+ *   //   { url: 'https://registry.layerbase.host/...', sha256: '...', size: ... }
+ *
+ * Anything outside this index is internal and may change without notice.
+ */
+// ─── Resolver (the headline API) ────────────────────────────────────────────
+export { resolveVersion, normalizeVersion, listVersions, listEngines, getSupportedMajorVersions, getMajorDefault, getEngineDefaults, getReleaseInfo, getAvailablePlatforms, isVersionDeprecated, getCliTools, getDatabaseEntry, compareVersions, } from './resolver.js';
+// ─── Data-access primitives (lower-level, for power users) ──────────────────
+export { loadDatabasesJson, loadReleasesJson, loadDownloadsJson, isVersionEnabled, getEnabledVersions, } from './databases.js';
+export { ALL_PLATFORMS } from './databases.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,+EAA+E;AAC/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,eAAe,GAEhB,MAAM,eAAe,CAAA;AAEtB,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAkBvB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/r2.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Shared Cloudflare R2 client utilities.
+ *
+ * R2 is S3-compatible, so we use the AWS SDK with a custom endpoint.
+ */
+import { S3Client } from '@aws-sdk/client-s3';
+export type R2Config = {
+    accountId: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucket: string;
+};
+export declare function loadR2Config(): R2Config;
+export declare function createR2Client(config: R2Config): S3Client;
+export declare function uploadToR2(options: {
+    client: S3Client;
+    bucket: string;
+    key: string;
+    body: Buffer | Uint8Array | ReadableStream;
+    contentType?: string;
+    cacheControl?: string;
+}): Promise<void>;
+export declare function objectExists(options: {
+    client: S3Client;
+    bucket: string;
+    key: string;
+}): Promise<boolean>;
+export declare function deleteFromR2(options: {
+    client: S3Client;
+    bucket: string;
+    key: string;
+}): Promise<void>;
+export declare function listR2Objects(options: {
+    client: S3Client;
+    bucket: string;
+    prefix: string;
+}): Promise<string[]>;
+export declare function publishJsonToR2(options: {
+    client: S3Client;
+    bucket: string;
+    rootDir: string;
+    filename: string;
+    cacheControl?: string;
+}): Promise<void>;
+export declare function publishReleasesJson(options: {
+    client: S3Client;
+    bucket: string;
+    rootDir: string;
+}): Promise<void>;
+/**
+ * Purge Cloudflare CDN cache for specific URLs.
+ *
+ * Required env vars: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID
+ * If not set, logs a warning and returns (no-op).
+ */
+export declare function purgeCloudflareCache(urls: string[]): Promise<{
+    purged: boolean;
+    count: number;
+}>;
+//# sourceMappingURL=r2.d.ts.map

package/dist/r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../lib/r2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EAKT,MAAM,oBAAoB,CAAA;AAI3B,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAiBvC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CASzD;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc,CAAA;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAapB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,QAAQ,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC7C"}

package/dist/r2.js

@@ -0,0 +1,127 @@
+/**
+ * Shared Cloudflare R2 client utilities.
+ *
+ * R2 is S3-compatible, so we use the AWS SDK with a custom endpoint.
+ */
+import { S3Client, PutObjectCommand, HeadObjectCommand, DeleteObjectCommand, ListObjectsV2Command, } from '@aws-sdk/client-s3';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+export function loadR2Config() {
+    const accountId = process.env.R2_ACCOUNT_ID;
+    const accessKeyId = process.env.R2_ACCESS_KEY_ID;
+    const secretAccessKey = process.env.R2_SECRET_ACCESS_KEY;
+    const bucket = process.env.R2_BUCKET_NAME;
+    if (!accountId || !accessKeyId || !secretAccessKey || !bucket) {
+        const missing = [
+            !accountId && 'R2_ACCOUNT_ID',
+            !accessKeyId && 'R2_ACCESS_KEY_ID',
+            !secretAccessKey && 'R2_SECRET_ACCESS_KEY',
+            !bucket && 'R2_BUCKET_NAME',
+        ].filter(Boolean);
+        throw new Error(`Missing required R2 env vars: ${missing.join(', ')}`);
+    }
+    return { accountId, accessKeyId, secretAccessKey, bucket };
+}
+export function createR2Client(config) {
+    return new S3Client({
+        region: 'auto',
+        endpoint: `https://${config.accountId}.r2.cloudflarestorage.com`,
+        credentials: {
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
+        },
+    });
+}
+export async function uploadToR2(options) {
+    const { client, bucket, key, body, contentType, cacheControl } = options;
+    await client.send(new PutObjectCommand({
+        Bucket: bucket,
+        Key: key,
+        Body: body,
+        ContentType: contentType ?? 'application/octet-stream',
+        CacheControl: cacheControl ?? 'public, max-age=31536000, immutable',
+    }));
+}
+export async function objectExists(options) {
+    const { client, bucket, key } = options;
+    try {
+        await client.send(new HeadObjectCommand({
+            Bucket: bucket,
+            Key: key,
+        }));
+        return true;
+    }
+    catch (error) {
+        const code = error instanceof Error && 'name' in error ? error.name : undefined;
+        if (code === 'NotFound' || code === '404') {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function deleteFromR2(options) {
+    const { client, bucket, key } = options;
+    await client.send(new DeleteObjectCommand({
+        Bucket: bucket,
+        Key: key,
+    }));
+}
+export async function listR2Objects(options) {
+    const { client, bucket, prefix } = options;
+    const result = await client.send(new ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: prefix,
+    }));
+    return (result.Contents ?? [])
+        .map((obj) => obj.Key)
+        .filter((key) => key !== undefined);
+}
+export async function publishJsonToR2(options) {
+    const { client, bucket, rootDir, filename, cacheControl } = options;
+    const body = readFileSync(resolve(rootDir, filename));
+    await uploadToR2({
+        client,
+        bucket,
+        key: filename,
+        body,
+        contentType: 'application/json',
+        cacheControl: cacheControl ?? 'public, max-age=60',
+    });
+}
+export async function publishReleasesJson(options) {
+    await publishJsonToR2({ ...options, filename: 'releases.json' });
+}
+/**
+ * Purge Cloudflare CDN cache for specific URLs.
+ *
+ * Required env vars: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID
+ * If not set, logs a warning and returns (no-op).
+ */
+export async function purgeCloudflareCache(urls) {
+    const apiToken = process.env.CLOUDFLARE_API_TOKEN;
+    const zoneId = process.env.CLOUDFLARE_ZONE_ID;
+    if (!apiToken || !zoneId) {
+        return { purged: false, count: 0 };
+    }
+    // Cloudflare allows max 30 URLs per purge request
+    const BATCH_SIZE = 30;
+    let totalPurged = 0;
+    for (let i = 0; i < urls.length; i += BATCH_SIZE) {
+        const batch = urls.slice(i, i + BATCH_SIZE);
+        const response = await fetch(`https://api.cloudflare.com/client/v4/zones/${zoneId}/purge_cache`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${apiToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ files: batch }),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Cloudflare cache purge failed: ${response.status} ${body}`);
+        }
+        totalPurged += batch.length;
+    }
+    return { purged: true, count: totalPurged };
+}
+//# sourceMappingURL=r2.js.map

package/dist/r2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.js","sourceRoot":"","sources":["../lib/r2.ts"],"names":[],"mappings":"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"}

package/dist/registry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Configurable registry base URL for binary downloads.
+ *
+ * Switch between providers by changing REGISTRY_BASE_URL:
+ *   R2:     https://registry.layerbase.host
+ *   GitHub: https://github.com/robertjbass/hostdb/releases/download
+ */
+export declare function getDownloadUrl(tag: string, filename: string): string;
+export declare function getRegistryBaseUrl(): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../lib/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/registry.js

@@ -0,0 +1,15 @@
+/**
+ * Configurable registry base URL for binary downloads.
+ *
+ * Switch between providers by changing REGISTRY_BASE_URL:
+ *   R2:     https://registry.layerbase.host
+ *   GitHub: https://github.com/robertjbass/hostdb/releases/download
+ */
+const REGISTRY_BASE_URL = 'https://registry.layerbase.host';
+export function getDownloadUrl(tag, filename) {
+    return `${REGISTRY_BASE_URL}/${tag}/${filename}`;
+}
+export function getRegistryBaseUrl() {
+    return REGISTRY_BASE_URL;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../lib/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,iBAAiB,GAAG,iCAAiC,CAAA;AAE3D,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAAgB;IAC1D,OAAO,GAAG,iBAAiB,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,CAAA;AAC1B,CAAC"}