typebulb 0.12.0 → 0.13.0

package/dist/resolver/peerResolver.d.ts

@@ -0,0 +1,33 @@
+import { CdnClient, type PackageMeta } from './cdnClient.js';
+export type ResolvedRoot = {
+    name: string;
+    version: string;
+    meta?: PackageMeta;
+};
+export type PackageFlags = {
+    isPeerRoot: boolean;
+    hasPeers: boolean;
+    isSharedDep: boolean;
+};
+export type AutoAddedPeer = {
+    name: string;
+    requiredBy: string;
+};
+export declare const peerNames: (meta?: PackageMeta) => string[];
+export declare const depNames: (meta?: PackageMeta) => string[];
+export declare class PeerResolver {
+    private cdn;
+    constructor(cdn: CdnClient);
+    resolve(roots: Array<{
+        name: string;
+        version: string;
+    }>, resolveVersion: (name: string) => Promise<string>): Promise<{
+        allRoots: ResolvedRoot[];
+        flags: Map<string, PackageFlags>;
+        autoAddedPeers: AutoAddedPeer[];
+    }>;
+    private fetchMeta;
+    private expandWithPeers;
+    private computeFlags;
+}
+//# sourceMappingURL=peerResolver.d.ts.map

package/dist/resolver/peerResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peerResolver.d.ts","sourceRoot":"","sources":["../../resolver/src/peerResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5D,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE,CAAA;AAChF,MAAM,MAAM,YAAY,GAAG;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAA;AAC3F,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAGhE,eAAO,MAAM,SAAS,GAAI,OAAO,WAAW,aAA8E,CAAA;AAC1H,eAAO,MAAM,QAAQ,GAAI,OAAO,WAAW,aAA0E,CAAA;AAMrH,qBAAa,YAAY;IAEX,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE5B,OAAO,CACX,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC/C,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;;;;;YAQrC,SAAS;YAMT,eAAe;IA6B7B,OAAO,CAAC,YAAY;CAyBrB"}

package/dist/resolver/peerResolver.js

@@ -0,0 +1,66 @@
+const isTypesPackage = (name) => name.startsWith('@types/');
+export const peerNames = (meta) => Object.keys(meta?.peerDependencies || {}).filter(n => !isTypesPackage(n));
+export const depNames = (meta) => Object.keys(meta?.dependencies || {}).filter(n => !isTypesPackage(n));
+/** Only peers NOT marked as optional in peerDependenciesMeta */
+const requiredPeerNames = (meta) => peerNames(meta).filter(name => !meta?.peerDependenciesMeta?.[name]?.optional);
+export class PeerResolver {
+    constructor(cdn) {
+        this.cdn = cdn;
+    }
+    async resolve(roots, resolveVersion) {
+        const initialRoots = await this.fetchMeta(roots);
+        const { allRoots, autoAddedPeers } = await this.expandWithPeers(initialRoots, resolveVersion);
+        const flags = this.computeFlags(allRoots);
+        return { allRoots, flags, autoAddedPeers };
+    }
+    async fetchMeta(roots) {
+        return Promise.all(roots.map(async ({ name, version }) => ({
+            name, version, meta: await this.cdn.fetchPackageMeta(name, version)
+        })));
+    }
+    async expandWithPeers(initialRoots, resolveVersion) {
+        const rootMap = new Map(initialRoots.map(r => [r.name, r]));
+        const autoAddedPeers = [];
+        for (const root of initialRoots) {
+            for (const name of requiredPeerNames(root.meta)) {
+                if (!rootMap.has(name) && !autoAddedPeers.some(p => p.name === name)) {
+                    autoAddedPeers.push({ name, requiredBy: root.name });
+                }
+            }
+        }
+        // Resolve peers sequentially
+        for (const { name, requiredBy } of autoAddedPeers) {
+            try {
+                const version = await resolveVersion(name);
+                const meta = await this.cdn.fetchPackageMeta(name, version);
+                rootMap.set(name, { name, version, meta });
+            }
+            catch (err) {
+                console.warn(`[typebulb] Failed to resolve peer "${name}" for "${requiredBy}":`, err);
+            }
+        }
+        return { allRoots: [...rootMap.values()], autoAddedPeers: autoAddedPeers.filter(p => rootMap.has(p.name)) };
+    }
+    computeFlags(roots) {
+        // Packages appearing in peerDependencies of any imported package
+        const peerRootSet = new Set(roots.flatMap(r => peerNames(r.meta)));
+        // Packages appearing in dependencies of 2+ imported packages (shared deps)
+        // These need singleton behavior even if not declared as peers (e.g., @codemirror/state)
+        const depCounts = new Map();
+        for (const root of roots) {
+            for (const dep of depNames(root.meta)) {
+                depCounts.set(dep, (depCounts.get(dep) || 0) + 1);
+            }
+        }
+        const sharedDepSet = new Set([...depCounts.entries()].filter(([, count]) => count >= 2).map(([name]) => name));
+        return new Map(roots.map(root => [
+            root.name,
+            {
+                isPeerRoot: peerRootSet.has(root.name),
+                hasPeers: peerNames(root.meta).length > 0,
+                isSharedDep: sharedDepSet.has(root.name)
+            }
+        ]));
+    }
+}
+//# sourceMappingURL=peerResolver.js.map

package/dist/resolver/peerResolver.js.map

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

package/dist/resolver/semver.d.ts

@@ -0,0 +1,17 @@
+export type Version = string;
+export declare class SemverService {
+    cmp(a: Version, b: Version): number;
+    satisfies(range: string, v: Version): boolean;
+    pickMaxSatisfying(versions: Version[], range: string): Version | undefined;
+    pickLatest(versions: Version[]): Version | undefined;
+    selectBestVersion(versions: Version[], options?: {
+        distTags?: Record<string, string>;
+        range?: string;
+        preferStable?: boolean;
+    }): Version | undefined;
+    majorOf(v: Version): number;
+    isPrerelease(version: Version): boolean;
+    isExactVersion(version: string): boolean;
+}
+export declare const semverService: SemverService;
+//# sourceMappingURL=semver.d.ts.map

package/dist/resolver/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../resolver/src/semver.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA;AAI5B,qBAAa,aAAa;IAExB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM;IAKnC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAK7C,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAM1E,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,GAAG,SAAS;IAMpD,iBAAiB,CACf,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACjC,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,GACA,OAAO,GAAG,SAAS;IAuBtB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM;IAI3B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAIvC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AACD,eAAO,MAAM,aAAa,eAAsB,CAAA"}

package/dist/resolver/semver.js

@@ -0,0 +1,56 @@
+import { gt, satisfies as satisfiesFn, maxSatisfying, major, prerelease, rsort, valid } from 'semver';
+export class SemverService {
+    cmp(a, b) {
+        if (a === b)
+            return 0;
+        return gt(a, b) ? 1 : (gt(b, a) ? -1 : 0);
+    }
+    satisfies(range, v) {
+        if (!range || !range.trim())
+            return true;
+        return Boolean(satisfiesFn(v, range, { includePrerelease: true }));
+    }
+    pickMaxSatisfying(versions, range) {
+        if (!versions?.length)
+            return undefined;
+        const res = maxSatisfying(versions, range, { includePrerelease: true });
+        return res === null ? undefined : res;
+    }
+    pickLatest(versions) {
+        if (!versions?.length)
+            return undefined;
+        const sorted = rsort(versions);
+        return sorted[0];
+    }
+    selectBestVersion(versions, options) {
+        if (!versions?.length)
+            return undefined;
+        const range = options?.range?.trim() || '*';
+        const preferStable = options?.preferStable ?? true;
+        // Priority 1: distTags.latest if available and satisfies range
+        const latest = options?.distTags?.latest;
+        if (latest && versions.includes(latest) && this.satisfies(range, latest)) {
+            return latest;
+        }
+        // Priority 2: Best stable version satisfying range
+        if (preferStable) {
+            const stable = maxSatisfying(versions, range, { includePrerelease: false });
+            if (stable)
+                return stable;
+        }
+        // Priority 3: Best version (including prereleases) satisfying range
+        const any = maxSatisfying(versions, range, { includePrerelease: true });
+        return any ?? undefined;
+    }
+    majorOf(v) {
+        return major(v);
+    }
+    isPrerelease(version) {
+        return prerelease(version) !== null;
+    }
+    isExactVersion(version) {
+        return valid(version) !== null;
+    }
+}
+export const semverService = new SemverService();
+//# sourceMappingURL=semver.js.map

package/dist/resolver/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../resolver/src/semver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,SAAS,IAAI,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAErG,MAAM,OAAO,aAAa;IAExB,GAAG,CAAC,CAAU,EAAE,CAAU;QACxB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAA;QACrB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,CAAU;QACjC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAA;QACxC,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACpE,CAAC;IAED,iBAAiB,CAAC,QAAmB,EAAE,KAAa;QAClD,IAAI,CAAC,QAAQ,EAAE,MAAM;YAAE,OAAO,SAAS,CAAA;QACvC,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAkB,CAAA;QACxF,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA;IACvC,CAAC;IAED,UAAU,CAAC,QAAmB;QAC5B,IAAI,CAAC,QAAQ,EAAE,MAAM;YAAE,OAAO,SAAS,CAAA;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC;IAED,iBAAiB,CACf,QAAmB,EACnB,OAIC;QAED,IAAI,CAAC,QAAQ,EAAE,MAAM;YAAE,OAAO,SAAS,CAAA;QAEvC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAA;QAC3C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAA;QAElD,+DAA+D;QAC/D,MAAM,MAAM,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAA;QACxC,IAAI,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YACzE,OAAO,MAAM,CAAA;QACf,CAAC;QAED,mDAAmD;QACnD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAkB,CAAA;YAC5F,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;QAC3B,CAAC;QAED,oEAAoE;QACpE,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAkB,CAAA;QACxF,OAAO,GAAG,IAAI,SAAS,CAAA;IACzB,CAAC;IAED,OAAO,CAAC,CAAU;QAChB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,YAAY,CAAC,OAAgB;QAC3B,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IACrC,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IAChC,CAAC;CACF;AACD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAA"}

package/dist/resolver/types.d.ts

@@ -0,0 +1,33 @@
+export type PeerMeta = {
+    optional?: boolean;
+};
+export type PackageRanges = Record<string, string>;
+export interface PackageCache {
+    getPinnedExact(name: string, range: string): Promise<string | undefined>;
+    setPinnedExact(name: string, range: string, exact: string): Promise<unknown>;
+    getIndex(name: string): Promise<{
+        versions: string[];
+        distTags?: Record<string, string>;
+        updatedAt: number;
+    } | undefined>;
+    setIndex(name: string, versions: string[], distTags?: Record<string, string>): Promise<unknown>;
+    invalidateVersionsCache(name: string): Promise<unknown>;
+    isNegative(name: string): Promise<boolean>;
+    recordNegative(name: string): Promise<unknown>;
+    clearNegative(name: string): Promise<unknown>;
+    getMeta(name: string, version: string): Promise<{
+        dependencies?: Record<string, string>;
+        peerDependencies?: Record<string, string>;
+        peerDependenciesMeta?: Record<string, PeerMeta>;
+        updatedAt: number;
+    } | undefined>;
+    setMeta(name: string, version: string, dependencies?: Record<string, string>, peerDependencies?: Record<string, string>, peerDependenciesMeta?: Record<string, PeerMeta>): Promise<unknown>;
+}
+export interface HttpClient {
+    getJson<T>(url: string): Promise<T | undefined>;
+    head(url: string): Promise<{
+        ok: boolean;
+        url: string;
+    } | undefined>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resolver/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../resolver/src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACxE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IACzH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/F,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IACrN,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5L;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;CACrE"}

package/dist/resolver/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/resolver/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../resolver/src/types.ts"],"names":[],"mappings":""}

package/dist/resolver/versionResolver.d.ts

@@ -0,0 +1,29 @@
+import type { PackageCache, PackageRanges } from './types.js';
+import { CdnClient } from './cdnClient.js';
+import { SemverService } from './semver.js';
+export type EffectivePackageResult = {
+    effectivePackage: string;
+    root: string;
+    range?: string;
+    pinned?: string;
+};
+export declare class VersionResolver {
+    private cache;
+    private cdn;
+    private semver;
+    constructor(cache: PackageCache, cdn: CdnClient, semver: SemverService);
+    private selectVersionFromIndex;
+    /**
+     * Learns the best available version for a package (no caching).
+     * Used by packageAuto to determine what version we'd assign fresh.
+     */
+    learnExactVersion(name: string): Promise<string | undefined>;
+    resolveExactForRoot(root: string, range?: string): Promise<string | undefined>;
+    effectivePackage(pkg: string, ranges: PackageRanges): Promise<{
+        effectivePackage: string;
+        root: string;
+        range: string;
+        pinned: string | undefined;
+    }>;
+}
+//# sourceMappingURL=versionResolver.d.ts.map

package/dist/resolver/versionResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionResolver.d.ts","sourceRoot":"","sources":["../../resolver/src/versionResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,MAAM,MAAM,sBAAsB,GAAG;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,KAAK;IAAgB,OAAO,CAAC,GAAG;IAAa,OAAO,CAAC,MAAM;gBAA3D,KAAK,EAAE,YAAY,EAAU,GAAG,EAAE,SAAS,EAAU,MAAM,EAAE,aAAa;IAE9F,OAAO,CAAC,sBAAsB;IAI9B;;;OAGG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAS5D,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAyChD,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;;;;;;CAgB1D"}

package/dist/resolver/versionResolver.js

@@ -0,0 +1,79 @@
+import { PackageRef } from './packageRef.js';
+import { attempt } from './attempt.js';
+export class VersionResolver {
+    constructor(cache, cdn, semver) {
+        this.cache = cache;
+        this.cdn = cdn;
+        this.semver = semver;
+    }
+    selectVersionFromIndex(versions, range, distTags) {
+        return this.semver.selectBestVersion(versions, { range, distTags });
+    }
+    /**
+     * Learns the best available version for a package (no caching).
+     * Used by packageAuto to determine what version we'd assign fresh.
+     */
+    async learnExactVersion(name) {
+        const idx = await attempt(() => this.cdn.fetchVersionsIndex(name));
+        if (idx?.versions?.length) {
+            const version = this.semver.selectBestVersion(idx.versions, { distTags: idx.distTags });
+            if (version)
+                return version;
+        }
+        return this.cdn.resolveExactVersion(name);
+    }
+    async resolveExactForRoot(root, range) {
+        if (!range)
+            return this.learnExactVersion(root);
+        const pinned = await this.cache.getPinnedExact(root, range);
+        if (pinned) {
+            if (this.semver.isExactVersion(pinned))
+                return pinned;
+            // Routine, not an error: a cached pin that isn't an exact version just gets re-resolved below.
+            console.debug('[typebulb] cached version for', root, 'is not exact (', pinned, '); re-resolving from registry');
+        }
+        const idx = await attempt(() => this.cdn.fetchVersionsIndex(root));
+        if (idx?.versions?.length) {
+            const chosen = this.selectVersionFromIndex(idx.versions, range, idx.distTags);
+            if (!chosen) {
+                // Routine cache refresh after a new release: the cached version set predates a release that
+                // satisfies `range`, so drop it and re-fetch. Not an error — expected right after an upgrade.
+                console.debug('[typebulb] refreshing version cache for', root, '(', range, 'not in cached set — likely a new release)');
+                await this.cache.invalidateVersionsCache(root);
+                const freshIdx = await attempt(() => this.cdn.fetchVersionsIndex(root));
+                if (freshIdx?.versions?.length) {
+                    const freshChosen = this.selectVersionFromIndex(freshIdx.versions, range, freshIdx.distTags);
+                    if (freshChosen && this.semver.isExactVersion(freshChosen)) {
+                        await this.cache.setPinnedExact(root, range, freshChosen);
+                        return freshChosen;
+                    }
+                }
+            }
+            else if (this.semver.isExactVersion(chosen)) {
+                await this.cache.setPinnedExact(root, range, chosen);
+                return chosen;
+            }
+        }
+        const exact = await this.cdn.resolveExactVersion(`${root}@${range}`);
+        if (exact && this.semver.isExactVersion(exact)) {
+            await this.cache.setPinnedExact(root, range, exact);
+            return exact;
+        }
+        return undefined;
+    }
+    async effectivePackage(pkg, ranges) {
+        const parsed = new PackageRef(pkg);
+        const root = parsed.root();
+        const range = ranges[root];
+        const pinned = range
+            ? await attempt(() => this.cache.getPinnedExact(root, range)) ?? await attempt(() => this.resolveExactForRoot(root, range))
+            : undefined;
+        return {
+            effectivePackage: pinned ? parsed.withVersion(pinned).format() : pkg,
+            root,
+            range,
+            pinned
+        };
+    }
+}
+//# sourceMappingURL=versionResolver.js.map

package/dist/resolver/versionResolver.js.map

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