hostdb 0.30.0 → 0.31.1

package/dist/resolver.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Version resolution for the hostdb npm package.
+ *
+ * Consumers (spindb, layerbase-cloud, third parties) call these functions
+ * to translate user-supplied version strings (e.g., '17', '11.4', '8.0.23')
+ * into the full pinned version that's actually built and published on R2.
+ *
+ * Resolution algorithm:
+ *   1. Identity — if the input is already a known full version, return it.
+ *      Deprecated patches still match here; only `enabled: false` excludes a
+ *      version from resolution entirely. The deprecated-but-resolvable case
+ *      is intentional: existing containers keep working when a version is
+ *      deprecation-flagged but not removed.
+ *   2. Defaults — if the input matches a key in the engine's `defaults` block,
+ *      return the explicit policy choice. Preserves LTS-vs-latest decisions
+ *      that previously lived only as comments in spindb's hand-written MAPs.
+ *   3. Major.minor prefix — pick the highest full version (including deprecated)
+ *      that starts with the input prefix.
+ *   4. Major prefix — same, but only when no `defaults['X']` is declared.
+ *   5. Otherwise null.
+ *
+ * "Enabled" vs "deprecated":
+ *   - `enabled: false`  → version is INVISIBLE to the resolver (skipped entirely).
+ *   - `deprecated: true` → version is still resolvable (so containers don't break)
+ *                          but flagged for UI consumers via `isVersionDeprecated`.
+ *   These flags are independent. UI layers like spindb's version picker use
+ *   `getDeprecatedVersions()` to hide deprecated entries from create flows.
+ */
+import { _resetLoaderCachesForTests, type DatabaseEntry, type CliTools, type Platform } from './databases.js';
+/**
+ * Reset the in-process loader cache. Tests only — not part of the public API.
+ * Re-exported here so test files don't need to import from two places.
+ */
+export declare const _resetCacheForTests: typeof _resetLoaderCachesForTests;
+/**
+ * Compare two version strings. Handles:
+ *   - standard semver (X.Y.Z)
+ *   - 4-part ClickHouse-style (25.12.3.21)
+ *   - PostgreSQL-DocumentDB compound format (17-0.107.0)
+ *
+ * Returns positive if a > b, negative if a < b, 0 if equal.
+ */
+export declare function compareVersions(a: string, b: string): number;
+export type ListVersionsOptions = {
+    format?: 'full' | 'major' | 'major-minor';
+};
+/**
+ * List every engine known to the bundled registry.
+ */
+export declare function listEngines(): string[];
+/**
+ * Get the raw database entry from the bundled databases.json.
+ */
+export declare function getDatabaseEntry(engine: string): DatabaseEntry | null;
+/**
+ * Resolve a user-supplied version string to a full pinned version.
+ *
+ * Returns null when no known version matches the input.
+ *
+ * Examples:
+ *   resolveVersion('postgresql', '17')      → '17.10.0'
+ *   resolveVersion('mariadb',    '11')      → '11.8.6'   (from defaults)
+ *   resolveVersion('mongodb',    '8')       → '8.0.23'   (LTS, from defaults)
+ *   resolveVersion('mysql',      '9')       → '9.6.0'    (no defaults; prefix match)
+ *   resolveVersion('sqlite',     '3.53.1')  → '3.53.1'   (identity)
+ *   resolveVersion('postgresql', '99')      → null
+ */
+export declare function resolveVersion(engine: string, version: string): string | null;
+/**
+ * Like resolveVersion, but returns the input unchanged when nothing matches.
+ * Mirrors spindb's per-engine `normalizeVersion` behavior so the wrapper layer
+ * can be a drop-in replacement.
+ */
+export declare function normalizeVersion(engine: string, version: string): string;
+/**
+ * List versions for an engine in the requested format.
+ *
+ * - 'full' (default): every full version, sorted descending.
+ * - 'major-minor': every unique X.Y prefix among full versions, sorted descending.
+ * - 'major': every unique X prefix, sorted descending.
+ */
+export declare function listVersions(engine: string, opts?: ListVersionsOptions): string[];
+/**
+ * The set of supported major versions (1-part keys) for an engine.
+ *
+ * Prefers the engine's `defaults` block (since it represents an explicit policy);
+ * falls back to inferring from the version list if no defaults declared.
+ *
+ * Matches spindb's existing `SUPPORTED_MAJOR_VERSIONS` shape exactly.
+ */
+export declare function getSupportedMajorVersions(engine: string): string[];
+/**
+ * Get the explicit major-version default for an engine, or null when none declared.
+ *
+ * Useful when callers want to know whether `'8'` resolves via policy (LTS pick)
+ * or via prefix-match fallback.
+ */
+export declare function getMajorDefault(engine: string, major: string): string | null;
+/**
+ * Convenience defaults: the engine's overall `defaultVersion` (typically the
+ * highest declared major's resolved value) and `latestVersion` (the highest
+ * enabled full version — deprecated patches are still included; only
+ * `enabled: false` excludes a version).
+ *
+ * For multi-track engines like MongoDB the two can differ:
+ *   - MongoDB defaultVersion = '8.0.23' (LTS pick from defaults['8'])
+ *   - MongoDB latestVersion  = '8.2.9'  (highest full version)
+ */
+export declare function getEngineDefaults(engine: string): {
+    defaultVersion: string | null;
+    latestVersion: string | null;
+};
+/**
+ * Check whether a specific version is marked deprecated in the registry.
+ */
+export declare function isVersionDeprecated(engine: string, version: string): boolean;
+/**
+ * Get the cliTools metadata for a specific version (resolves engine vs. version-level overrides).
+ */
+export declare function getCliTools(engine: string, version: string): CliTools | null;
+/**
+ * Get the platforms supported for a specific version.
+ */
+export declare function getAvailablePlatforms(engine: string, version: string): Platform[];
+/**
+ * Get the download metadata for a specific published-asset version + platform.
+ *
+ * Returns null when the version isn't published (yet), the platform isn't built
+ * for that version, or the engine doesn't exist.
+ *
+ * Note: `sha256` here is the SHA-256 of the published artifact on R2 (computed
+ * by the build pipeline). The build-time *source-tarball* checksum (which is
+ * SHA3-256 for SQLite specifically) lives in `sources.json` and is not exposed
+ * by this resolver.
+ */
+export declare function getReleaseInfo(engine: string, version: string, platform: Platform): {
+    url: string;
+    sha256: string;
+    size: number;
+} | null;
+export type { DatabaseEntry, CliTools, Platform } from './databases.js';
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../lib/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAGL,0BAA0B,EAK1B,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAA;AAQvB;;;GAGG;AACH,eAAO,MAAM,mBAAmB,mCAA6B,CAAA;AAI7D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAmB5D;AAsBD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAA;CAC1C,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAErE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsC7E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,mBAAwB,GAC7B,MAAM,EAAE,CAkCV;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IACjD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAeA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAK5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,QAAQ,EAAE,CAKZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GACjB;IACD,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAYP;AAGD,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/resolver.js

@@ -0,0 +1,306 @@
+/**
+ * Version resolution for the hostdb npm package.
+ *
+ * Consumers (spindb, layerbase-cloud, third parties) call these functions
+ * to translate user-supplied version strings (e.g., '17', '11.4', '8.0.23')
+ * into the full pinned version that's actually built and published on R2.
+ *
+ * Resolution algorithm:
+ *   1. Identity — if the input is already a known full version, return it.
+ *      Deprecated patches still match here; only `enabled: false` excludes a
+ *      version from resolution entirely. The deprecated-but-resolvable case
+ *      is intentional: existing containers keep working when a version is
+ *      deprecation-flagged but not removed.
+ *   2. Defaults — if the input matches a key in the engine's `defaults` block,
+ *      return the explicit policy choice. Preserves LTS-vs-latest decisions
+ *      that previously lived only as comments in spindb's hand-written MAPs.
+ *   3. Major.minor prefix — pick the highest full version (including deprecated)
+ *      that starts with the input prefix.
+ *   4. Major prefix — same, but only when no `defaults['X']` is declared.
+ *   5. Otherwise null.
+ *
+ * "Enabled" vs "deprecated":
+ *   - `enabled: false`  → version is INVISIBLE to the resolver (skipped entirely).
+ *   - `deprecated: true` → version is still resolvable (so containers don't break)
+ *                          but flagged for UI consumers via `isVersionDeprecated`.
+ *   These flags are independent. UI layers like spindb's version picker use
+ *   `getDeprecatedVersions()` to hide deprecated entries from create flows.
+ */
+import { loadDatabasesJson, loadReleasesJson, _resetLoaderCachesForTests, isVersionDeprecated as _isVersionDeprecated, isVersionEnabled, getVersionPlatforms, getVersionCliTools, } from './databases.js';
+// The loader functions cache their parsed result, so calling them on every
+// resolver invocation is O(1) after the first read. No second-layer cache needed.
+const databases = loadDatabasesJson;
+const releases = loadReleasesJson;
+/**
+ * Reset the in-process loader cache. Tests only — not part of the public API.
+ * Re-exported here so test files don't need to import from two places.
+ */
+export const _resetCacheForTests = _resetLoaderCachesForTests;
+// ─── Version comparison ─────────────────────────────────────────────────────
+/**
+ * Compare two version strings. Handles:
+ *   - standard semver (X.Y.Z)
+ *   - 4-part ClickHouse-style (25.12.3.21)
+ *   - PostgreSQL-DocumentDB compound format (17-0.107.0)
+ *
+ * Returns positive if a > b, negative if a < b, 0 if equal.
+ */
+export function compareVersions(a, b) {
+    // Compound format like '17-0.107.0' splits on '-' first.
+    const [aBase, aSuffix = ''] = a.split('-', 2);
+    const [bBase, bSuffix = ''] = b.split('-', 2);
+    const aParts = aBase.split('.').map((n) => parseInt(n, 10) || 0);
+    const bParts = bBase.split('.').map((n) => parseInt(n, 10) || 0);
+    const len = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < len; i++) {
+        const ai = aParts[i] ?? 0;
+        const bi = bParts[i] ?? 0;
+        if (ai !== bi)
+            return ai - bi;
+    }
+    // Bases equal — compare suffix recursively (treats no-suffix as smaller)
+    if (!aSuffix && !bSuffix)
+        return 0;
+    if (!aSuffix)
+        return -1;
+    if (!bSuffix)
+        return 1;
+    return compareVersions(aSuffix, bSuffix);
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function getEntry(engine) {
+    return databases().databases[engine] ?? null;
+}
+/**
+ * Return the engine's full-version list, filtered by the `enabled` flag.
+ * Deprecated versions stay in the list — see resolver-level docstring.
+ */
+function getAvailableFullVersions(engine) {
+    const entry = getEntry(engine);
+    if (!entry)
+        return [];
+    return Object.keys(entry.versions ?? {}).filter((v) => isVersionEnabled(entry.versions[v]));
+}
+/**
+ * List every engine known to the bundled registry.
+ */
+export function listEngines() {
+    return Object.keys(databases().databases).sort();
+}
+/**
+ * Get the raw database entry from the bundled databases.json.
+ */
+export function getDatabaseEntry(engine) {
+    return getEntry(engine);
+}
+/**
+ * Resolve a user-supplied version string to a full pinned version.
+ *
+ * Returns null when no known version matches the input.
+ *
+ * Examples:
+ *   resolveVersion('postgresql', '17')      → '17.10.0'
+ *   resolveVersion('mariadb',    '11')      → '11.8.6'   (from defaults)
+ *   resolveVersion('mongodb',    '8')       → '8.0.23'   (LTS, from defaults)
+ *   resolveVersion('mysql',      '9')       → '9.6.0'    (no defaults; prefix match)
+ *   resolveVersion('sqlite',     '3.53.1')  → '3.53.1'   (identity)
+ *   resolveVersion('postgresql', '99')      → null
+ */
+export function resolveVersion(engine, version) {
+    const entry = getEntry(engine);
+    if (!entry)
+        return null;
+    const versions = getAvailableFullVersions(engine);
+    if (versions.length === 0)
+        return null;
+    // 1. Identity — already a known full version
+    if (versions.includes(version))
+        return version;
+    // 2. Defaults — explicit policy
+    const defaults = entry.defaults ?? {};
+    if (defaults[version]) {
+        const target = defaults[version];
+        // Accept only if the target is actually a known version
+        return versions.includes(target) ? target : null;
+    }
+    // 3. Prefix match — for any input length, pick the highest enabled full
+    //    version that starts with `<input>.`. Deprecated versions are still
+    //    considered enabled (`enabled: false` is the only flag that excludes a
+    //    version from resolution) — see the file-level docstring for the
+    //    enabled-vs-deprecated rationale.
+    //
+    // Skip the major-only case (1-part) when an explicit `defaults` entry exists
+    // for that major: e.g., MongoDB '8' is governed by defaults block; don't
+    // fall through to "highest version starting with '8.'" which would pick
+    // 8.2.9 instead of the intended 8.0.23 LTS.
+    const isOnePart = !version.includes('.');
+    if (isOnePart && defaults[version]) {
+        // already handled above; this case shouldn't fall through
+        return null;
+    }
+    const matches = versions
+        .filter((v) => v.startsWith(version + '.'))
+        .sort((a, b) => compareVersions(b, a));
+    return matches[0] ?? null;
+}
+/**
+ * Like resolveVersion, but returns the input unchanged when nothing matches.
+ * Mirrors spindb's per-engine `normalizeVersion` behavior so the wrapper layer
+ * can be a drop-in replacement.
+ */
+export function normalizeVersion(engine, version) {
+    return resolveVersion(engine, version) ?? version;
+}
+/**
+ * List versions for an engine in the requested format.
+ *
+ * - 'full' (default): every full version, sorted descending.
+ * - 'major-minor': every unique X.Y prefix among full versions, sorted descending.
+ * - 'major': every unique X prefix, sorted descending.
+ */
+export function listVersions(engine, opts = {}) {
+    const versions = getAvailableFullVersions(engine);
+    if (versions.length === 0)
+        return [];
+    const sorted = [...versions].sort((a, b) => compareVersions(b, a));
+    const format = opts.format ?? 'full';
+    if (format === 'full')
+        return sorted;
+    if (format === 'major-minor') {
+        const seen = new Set();
+        const out = [];
+        for (const v of sorted) {
+            const parts = v.split('-')[0].split('.');
+            const key = parts.length >= 2 ? `${parts[0]}.${parts[1]}` : parts[0];
+            if (!seen.has(key)) {
+                seen.add(key);
+                out.push(key);
+            }
+        }
+        return out;
+    }
+    // 'major'
+    const seen = new Set();
+    const out = [];
+    for (const v of sorted) {
+        const major = v.split('-')[0].split('.')[0];
+        if (!seen.has(major)) {
+            seen.add(major);
+            out.push(major);
+        }
+    }
+    return out;
+}
+/**
+ * The set of supported major versions (1-part keys) for an engine.
+ *
+ * Prefers the engine's `defaults` block (since it represents an explicit policy);
+ * falls back to inferring from the version list if no defaults declared.
+ *
+ * Matches spindb's existing `SUPPORTED_MAJOR_VERSIONS` shape exactly.
+ */
+export function getSupportedMajorVersions(engine) {
+    const entry = getEntry(engine);
+    if (!entry)
+        return [];
+    const defaults = entry.defaults ?? {};
+    if (Object.keys(defaults).length > 0) {
+        return Object.keys(defaults).sort((a, b) => compareVersions(b, a));
+    }
+    return listVersions(engine, { format: 'major' });
+}
+/**
+ * Get the explicit major-version default for an engine, or null when none declared.
+ *
+ * Useful when callers want to know whether `'8'` resolves via policy (LTS pick)
+ * or via prefix-match fallback.
+ */
+export function getMajorDefault(engine, major) {
+    const entry = getEntry(engine);
+    return entry?.defaults?.[major] ?? null;
+}
+/**
+ * Convenience defaults: the engine's overall `defaultVersion` (typically the
+ * highest declared major's resolved value) and `latestVersion` (the highest
+ * enabled full version — deprecated patches are still included; only
+ * `enabled: false` excludes a version).
+ *
+ * For multi-track engines like MongoDB the two can differ:
+ *   - MongoDB defaultVersion = '8.0.23' (LTS pick from defaults['8'])
+ *   - MongoDB latestVersion  = '8.2.9'  (highest full version)
+ */
+export function getEngineDefaults(engine) {
+    const versions = getAvailableFullVersions(engine);
+    if (versions.length === 0)
+        return { defaultVersion: null, latestVersion: null };
+    const sortedDesc = [...versions].sort((a, b) => compareVersions(b, a));
+    const latestVersion = sortedDesc[0];
+    const majors = getSupportedMajorVersions(engine);
+    const highestMajor = majors[0];
+    const defaultVersion = highestMajor
+        ? (resolveVersion(engine, highestMajor) ?? latestVersion)
+        : latestVersion;
+    return { defaultVersion, latestVersion };
+}
+/**
+ * Check whether a specific version is marked deprecated in the registry.
+ */
+export function isVersionDeprecated(engine, version) {
+    const entry = getEntry(engine);
+    if (!entry)
+        return false;
+    const ve = entry.versions[version];
+    if (ve === undefined)
+        return false;
+    return _isVersionDeprecated(ve);
+}
+/**
+ * Get the cliTools metadata for a specific version (resolves engine vs. version-level overrides).
+ */
+export function getCliTools(engine, version) {
+    const entry = getEntry(engine);
+    if (!entry)
+        return null;
+    if (entry.versions[version] === undefined)
+        return null;
+    return getVersionCliTools(entry, version);
+}
+/**
+ * Get the platforms supported for a specific version.
+ */
+export function getAvailablePlatforms(engine, version) {
+    const entry = getEntry(engine);
+    if (!entry)
+        return [];
+    if (entry.versions[version] === undefined)
+        return [];
+    return getVersionPlatforms(entry, version);
+}
+/**
+ * Get the download metadata for a specific published-asset version + platform.
+ *
+ * Returns null when the version isn't published (yet), the platform isn't built
+ * for that version, or the engine doesn't exist.
+ *
+ * Note: `sha256` here is the SHA-256 of the published artifact on R2 (computed
+ * by the build pipeline). The build-time *source-tarball* checksum (which is
+ * SHA3-256 for SQLite specifically) lives in `sources.json` and is not exposed
+ * by this resolver.
+ */
+export function getReleaseInfo(engine, version, platform) {
+    const releaseDb = releases().databases[engine];
+    if (!releaseDb)
+        return null;
+    const versionRel = releaseDb[version];
+    if (!versionRel)
+        return null;
+    const asset = versionRel.platforms?.[platform];
+    if (!asset)
+        return null;
+    return {
+        url: asset.url,
+        sha256: asset.sha256,
+        size: asset.size,
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

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

package/package.json

@@ -1,9 +1,20 @@
 {
   "name": "hostdb",
-  "version": "0.30.0",
-  "description": "Source and download pre-built database binaries for multiple platforms, distributed via GitHub Releases",
+  "version": "0.31.1",
+  "description": "Pre-built database binaries for multiple platforms, plus a typed registry library for resolving versions and download URLs offline.",
   "private": false,
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./databases.json": "./databases.json",
+    "./releases.json": "./releases.json",
+    "./downloads.json": "./downloads.json"
+  },
   "bin": {
     "hostdb": "./bin/cli.js"
   },
@@ -20,14 +31,18 @@
   "files": [
     "bin",
     "cli",
-    "lib",
+    "dist",
     "databases.json",
     "releases.json",
     "downloads.json"
   ],
   "scripts": {
     "add:engine": "tsx scripts/add-engine.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node --import tsx --test tests/*.test.ts",
     "build:releases": "tsx scripts/build-releases-json.ts",
+    "prepare": "pnpm build",
+    "prepublishOnly": "pnpm build",
     "check:dylibs": "builds/common/check-macos-dylibs.sh",
     "checksums:populate": "tsx scripts/populate-checksums.ts",
     "dbs": "tsx scripts/list-databases.ts",
@@ -62,10 +77,8 @@
     "repair:checksums": "tsx scripts/repair-checksums.ts",
     "start": "tsx cli/bin.ts",
     "sync:versions": "tsx scripts/sync-versions.ts",
-    "upload:r2": "tsx scripts/upload-to-r2.ts"
-  },
-  "dependencies": {
-    "tsx": "^4.19.0"
+    "upload:r2": "tsx scripts/upload-to-r2.ts",
+    "audit:r2-orphans": "tsx scripts/audit-r2-orphans.ts"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.990.0",
@@ -77,6 +90,7 @@
     "eslint": "^9.17.0",
     "ora": "^9.3.0",
     "prettier": "^3.4.0",
+    "tsx": "^4.19.0",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.18.0",
     "yaml": "^2.8.2"