@uapkg/registry-tools 1.3.1 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"IntegrityCalculator.js","names":[],"sources":["../../src/io/IntegrityCalculator.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { createReadStream } from 'node:fs';\nimport type { AssetHash } from '@uapkg/common-schema';\nimport {\n createIoErrorDiagnostic,\n createRegistryToolsIntegrityMismatchDiagnostic,\n DiagnosticBag,\n ok,\n type Result,\n} from '@uapkg/diagnostics';\nimport { type Integrity, IntegritySchema } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { IntegrityAlgorithm, IntegrityVerificationResult } from '../contracts/RegistryToolsTypes.js';\n\n/**\n * Computes and verifies file integrity locally — never reaches the network.\n */\nexport class IntegrityCalculator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n /** Stream-hash a local file and return a validated `Integrity` record. */\n async compute(filePath: string, algorithm: IntegrityAlgorithm = 'sha256'): Promise<Result<Integrity>> {\n const bag = new DiagnosticBag();\n\n const computed = await this.streamHash(filePath, algorithm);\n if (!computed.ok) {\n bag.mergeArray(computed.diagnostics);\n this.aggregator.addMany(computed.diagnostics);\n return bag.toFailure();\n }\n\n const candidate = {\n hash: `${algorithm}:${computed.value.hex}` as AssetHash,\n size: computed.value.size,\n };\n\n const validated = IntegritySchema.safeParse(candidate);\n if (!validated.success) {\n // Should not happen unless the algorithm output is malformed.\n const reason = validated.error.issues.map((i) => i.message).join('; ');\n const diag = createIoErrorDiagnostic(filePath, `integrity validation failed: ${reason}`);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok(validated.data, bag.all());\n }\n\n /** Recompute a file's integrity and compare it to an expected value. */\n async verify(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>> {\n const bag = new DiagnosticBag();\n const algo = parseAlgorithm(expected.hash) ?? 'sha256';\n\n const computed = await this.compute(filePath, algo);\n if (!computed.ok) {\n bag.mergeArray(computed.diagnostics);\n return bag.toFailure();\n }\n\n const matches = computed.value.hash === expected.hash && computed.value.size === expected.size;\n if (!matches) {\n const diag = createRegistryToolsIntegrityMismatchDiagnostic(\n filePath,\n expected.hash,\n computed.value.hash,\n expected.size,\n computed.value.size,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n\n return ok(\n {\n ok: matches,\n actual: computed.value,\n expected,\n },\n bag.all(),\n );\n }\n\n /** Hash a file by streaming. */\n private streamHash(filePath: string, algorithm: IntegrityAlgorithm): Promise<Result<{ hex: string; size: number }>> {\n return new Promise((resolve) => {\n const bag = new DiagnosticBag();\n const hash = createHash(algorithm);\n let size = 0;\n const stream = createReadStream(filePath);\n\n stream.on('data', (chunk) => {\n if (Buffer.isBuffer(chunk)) {\n hash.update(chunk);\n size += chunk.length;\n } else {\n const buf = Buffer.from(chunk);\n hash.update(buf);\n size += buf.length;\n }\n });\n stream.on('error', (err) => {\n const diag = createIoErrorDiagnostic(filePath, err.message);\n bag.add(diag);\n resolve(bag.toFailure());\n });\n stream.on('end', () => {\n resolve(ok({ hex: hash.digest('hex'), size }));\n });\n });\n }\n}\n\nfunction parseAlgorithm(assetHash: string): IntegrityAlgorithm | null {\n const colon = assetHash.indexOf(':');\n if (colon < 0) return null;\n const algo = assetHash.slice(0, colon);\n if (algo === 'sha256' || algo === 'sha512') return algo;\n return null;\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAa,sBAAb,MAAiC;CACF;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;;CAGnE,MAAM,QAAQ,UAAkB,YAAgC,UAAsC;EACpG,MAAM,MAAM,IAAI,cAAc;EAE9B,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,SAAS;EAC1D,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,WAAW,SAAS,WAAW;GACnC,KAAK,WAAW,QAAQ,SAAS,WAAW;GAC5C,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,YAAY;GAChB,MAAM,GAAG,UAAU,GAAG,SAAS,MAAM;GACrC,MAAM,SAAS,MAAM;EACvB;EAEA,MAAM,YAAY,gBAAgB,UAAU,SAAS;EACrD,IAAI,CAAC,UAAU,SAAS;GAEtB,MAAM,SAAS,UAAU,MAAM,OAAO,KAAK,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI;GACrE,MAAM,OAAO,wBAAwB,UAAU,gCAAgC,QAAQ;GACvF,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,OAAO,GAAG,UAAU,MAAM,IAAI,IAAI,CAAC;CACrC;;CAGA,MAAM,OAAO,UAAkB,UAAmE;EAChG,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,OAAO,eAAe,SAAS,IAAI,KAAK;EAE9C,MAAM,WAAW,MAAM,KAAK,QAAQ,UAAU,IAAI;EAClD,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,WAAW,SAAS,WAAW;GACnC,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,UAAU,SAAS,MAAM,SAAS,SAAS,QAAQ,SAAS,MAAM,SAAS,SAAS;EAC1F,IAAI,CAAC,SAAS;GACZ,MAAM,OAAO,+CACX,UACA,SAAS,MACT,SAAS,MAAM,MACf,SAAS,MACT,SAAS,MAAM,IACjB;GACA,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;EAEA,OAAO,GACL;GACE,IAAI;GACJ,QAAQ,SAAS;GACjB;EACF,GACA,IAAI,IAAI,CACV;CACF;;CAGA,AAAQ,WAAW,UAAkB,WAA+E;EAClH,OAAO,IAAI,SAAS,YAAY;GAC9B,MAAM,MAAM,IAAI,cAAc;GAC9B,MAAM,OAAO,WAAW,SAAS;GACjC,IAAI,OAAO;GACX,MAAM,SAAS,iBAAiB,QAAQ;GAExC,OAAO,GAAG,SAAS,UAAU;IAC3B,IAAI,OAAO,SAAS,KAAK,GAAG;KAC1B,KAAK,OAAO,KAAK;KACjB,QAAQ,MAAM;IAChB,OAAO;KACL,MAAM,MAAM,OAAO,KAAK,KAAK;KAC7B,KAAK,OAAO,GAAG;KACf,QAAQ,IAAI;IACd;GACF,CAAC;GACD,OAAO,GAAG,UAAU,QAAQ;IAC1B,MAAM,OAAO,wBAAwB,UAAU,IAAI,OAAO;IAC1D,IAAI,IAAI,IAAI;IACZ,QAAQ,IAAI,UAAU,CAAC;GACzB,CAAC;GACD,OAAO,GAAG,aAAa;IACrB,QAAQ,GAAG;KAAE,KAAK,KAAK,OAAO,KAAK;KAAG;IAAK,CAAC,CAAC;GAC/C,CAAC;EACH,CAAC;CACH;AACF;AAEA,SAAS,eAAe,WAA8C;CACpE,MAAM,QAAQ,UAAU,QAAQ,GAAG;CACnC,IAAI,QAAQ,GAAG,OAAO;CACtB,MAAM,OAAO,UAAU,MAAM,GAAG,KAAK;CACrC,IAAI,SAAS,YAAY,SAAS,UAAU,OAAO;CACnD,OAAO;AACT"}
1
+ {"version":3,"file":"IntegrityCalculator.js","names":[],"sources":["../../src/io/IntegrityCalculator.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { createReadStream } from 'node:fs';\nimport type { AssetHash } from '@uapkg/common-schema';\nimport {\n createIoErrorDiagnostic,\n createRegistryToolsIntegrityMismatchDiagnostic,\n DiagnosticBag,\n ok,\n type Result,\n} from '@uapkg/diagnostics';\nimport { type Integrity, IntegritySchema } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type { IntegrityAlgorithm, IntegrityVerificationResult } from '#registry-tools/contracts/RegistryToolsTypes.ts';\n\n/**\n * Computes and verifies file integrity locally — never reaches the network.\n */\nexport class IntegrityCalculator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n /** Stream-hash a local file and return a validated `Integrity` record. */\n async compute(filePath: string, algorithm: IntegrityAlgorithm = 'sha256'): Promise<Result<Integrity>> {\n const bag = new DiagnosticBag();\n\n const computed = await this.streamHash(filePath, algorithm);\n if (!computed.ok) {\n bag.mergeArray(computed.diagnostics);\n this.aggregator.addMany(computed.diagnostics);\n return bag.toFailure();\n }\n\n const candidate = {\n hash: `${algorithm}:${computed.value.hex}` as AssetHash,\n size: computed.value.size,\n };\n\n const validated = IntegritySchema.safeParse(candidate);\n if (!validated.success) {\n // Should not happen unless the algorithm output is malformed.\n const reason = validated.error.issues.map((i) => i.message).join('; ');\n const diag = createIoErrorDiagnostic(filePath, `integrity validation failed: ${reason}`);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok(validated.data, bag.all());\n }\n\n /** Recompute a file's integrity and compare it to an expected value. */\n async verify(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>> {\n const bag = new DiagnosticBag();\n const algo = parseAlgorithm(expected.hash) ?? 'sha256';\n\n const computed = await this.compute(filePath, algo);\n if (!computed.ok) {\n bag.mergeArray(computed.diagnostics);\n return bag.toFailure();\n }\n\n const matches = computed.value.hash === expected.hash && computed.value.size === expected.size;\n if (!matches) {\n const diag = createRegistryToolsIntegrityMismatchDiagnostic(\n filePath,\n expected.hash,\n computed.value.hash,\n expected.size,\n computed.value.size,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n\n return ok(\n {\n ok: matches,\n actual: computed.value,\n expected,\n },\n bag.all(),\n );\n }\n\n /** Hash a file by streaming. */\n private streamHash(filePath: string, algorithm: IntegrityAlgorithm): Promise<Result<{ hex: string; size: number }>> {\n return new Promise((resolve) => {\n const bag = new DiagnosticBag();\n const hash = createHash(algorithm);\n let size = 0;\n const stream = createReadStream(filePath);\n\n stream.on('data', (chunk) => {\n if (Buffer.isBuffer(chunk)) {\n hash.update(chunk);\n size += chunk.length;\n } else {\n const buf = Buffer.from(chunk);\n hash.update(buf);\n size += buf.length;\n }\n });\n stream.on('error', (err) => {\n const diag = createIoErrorDiagnostic(filePath, err.message);\n bag.add(diag);\n resolve(bag.toFailure());\n });\n stream.on('end', () => {\n resolve(ok({ hex: hash.digest('hex'), size }));\n });\n });\n }\n}\n\nfunction parseAlgorithm(assetHash: string): IntegrityAlgorithm | null {\n const colon = assetHash.indexOf(':');\n if (colon < 0) return null;\n const algo = assetHash.slice(0, colon);\n if (algo === 'sha256' || algo === 'sha512') return algo;\n return null;\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAa,sBAAb,MAAiC;CACF;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;;CAGnE,MAAM,QAAQ,UAAkB,YAAgC,UAAsC;EACpG,MAAM,MAAM,IAAI,cAAc;EAE9B,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,SAAS;EAC1D,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,WAAW,SAAS,WAAW;GACnC,KAAK,WAAW,QAAQ,SAAS,WAAW;GAC5C,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,YAAY;GAChB,MAAM,GAAG,UAAU,GAAG,SAAS,MAAM;GACrC,MAAM,SAAS,MAAM;EACvB;EAEA,MAAM,YAAY,gBAAgB,UAAU,SAAS;EACrD,IAAI,CAAC,UAAU,SAAS;GAEtB,MAAM,SAAS,UAAU,MAAM,OAAO,KAAK,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI;GACrE,MAAM,OAAO,wBAAwB,UAAU,gCAAgC,QAAQ;GACvF,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,OAAO,GAAG,UAAU,MAAM,IAAI,IAAI,CAAC;CACrC;;CAGA,MAAM,OAAO,UAAkB,UAAmE;EAChG,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,OAAO,eAAe,SAAS,IAAI,KAAK;EAE9C,MAAM,WAAW,MAAM,KAAK,QAAQ,UAAU,IAAI;EAClD,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,WAAW,SAAS,WAAW;GACnC,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,UAAU,SAAS,MAAM,SAAS,SAAS,QAAQ,SAAS,MAAM,SAAS,SAAS;EAC1F,IAAI,CAAC,SAAS;GACZ,MAAM,OAAO,+CACX,UACA,SAAS,MACT,SAAS,MAAM,MACf,SAAS,MACT,SAAS,MAAM,IACjB;GACA,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;EAEA,OAAO,GACL;GACE,IAAI;GACJ,QAAQ,SAAS;GACjB;EACF,GACA,IAAI,IAAI,CACV;CACF;;CAGA,AAAQ,WAAW,UAAkB,WAA+E;EAClH,OAAO,IAAI,SAAS,YAAY;GAC9B,MAAM,MAAM,IAAI,cAAc;GAC9B,MAAM,OAAO,WAAW,SAAS;GACjC,IAAI,OAAO;GACX,MAAM,SAAS,iBAAiB,QAAQ;GAExC,OAAO,GAAG,SAAS,UAAU;IAC3B,IAAI,OAAO,SAAS,KAAK,GAAG;KAC1B,KAAK,OAAO,KAAK;KACjB,QAAQ,MAAM;IAChB,OAAO;KACL,MAAM,MAAM,OAAO,KAAK,KAAK;KAC7B,KAAK,OAAO,GAAG;KACf,QAAQ,IAAI;IACd;GACF,CAAC;GACD,OAAO,GAAG,UAAU,QAAQ;IAC1B,MAAM,OAAO,wBAAwB,UAAU,IAAI,OAAO;IAC1D,IAAI,IAAI,IAAI;IACZ,QAAQ,IAAI,UAAU,CAAC;GACzB,CAAC;GACD,OAAO,GAAG,aAAa;IACrB,QAAQ,GAAG;KAAE,KAAK,KAAK,OAAO,KAAK;KAAG;IAAK,CAAC,CAAC;GAC/C,CAAC;EACH,CAAC;CACH;AACF;AAEA,SAAS,eAAe,WAA8C;CACpE,MAAM,QAAQ,UAAU,QAAQ,GAAG;CACnC,IAAI,QAAQ,GAAG,OAAO;CACtB,MAAM,OAAO,UAAU,MAAM,GAAG,KAAK;CACrC,IAAI,SAAS,YAAY,SAAS,UAAU,OAAO;CACnD,OAAO;AACT"}
@@ -1 +1 @@
1
- {"version":3,"file":"ManifestStore.js","names":[],"sources":["../../src/io/ManifestStore.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { safeJsonParse, stableStringify } from '@uapkg/common';\nimport type { PackageName } from '@uapkg/common-schema';\nimport {\n createIoErrorDiagnostic,\n createManifestReadErrorDiagnostic,\n createManifestWriteErrorDiagnostic,\n createRegistryToolsPackageMissingDiagnostic,\n createSchemaInvalidDiagnostic,\n DiagnosticBag,\n ok,\n type Result,\n} from '@uapkg/diagnostics';\nimport {\n type PackageRegistryManifest,\n PackageRegistryManifestSchema,\n type RegistryVersion,\n} from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { WriteManifestResult } from '../contracts/RegistryToolsTypes.js';\nimport { sortVersionsNewestFirst } from '../mutation/VersionSorter.js';\nimport type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\n\n/**\n * Reads, validates, and writes registry-package manifests on disk.\n *\n * Responsibilities:\n * - Resolve manifest paths for a given package name.\n * - Decode JSON safely.\n * - Validate against `PackageRegistryManifestSchema`.\n * - Write deterministic, sorted, pretty-printed JSON.\n */\nexport class ManifestStore {\n constructor(\n private readonly paths: RegistryRepoPaths,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n /** Resolve the manifest path for a package. Pure path computation. */\n resolveManifestPath(packageName: PackageName): string {\n return this.paths.manifestPath(packageName);\n }\n\n /** True if the manifest file exists on disk. */\n exists(packageName: PackageName): boolean {\n return existsSync(this.paths.manifestPath(packageName));\n }\n\n /** Read and validate a package manifest. Emits a missing-package diagnostic when absent. */\n async read(packageName: PackageName): Promise<Result<PackageRegistryManifest>> {\n const bag = new DiagnosticBag();\n const filePath = this.paths.manifestPath(packageName);\n\n if (!existsSync(filePath)) {\n const diag = createRegistryToolsPackageMissingDiagnostic(packageName, filePath);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return this.readFromPath(filePath);\n }\n\n /** Read and validate a manifest file at an arbitrary path. */\n async readFromPath(filePath: string): Promise<Result<PackageRegistryManifest>> {\n const bag = new DiagnosticBag();\n\n let raw: string;\n try {\n raw = await readFile(filePath, 'utf-8');\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createManifestReadErrorDiagnostic(filePath, reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const parsed = safeJsonParse<unknown>(raw, filePath);\n if (!parsed.ok) {\n bag.mergeArray(parsed.diagnostics);\n this.aggregator.addMany(parsed.diagnostics);\n return bag.toFailure();\n }\n\n const result = PackageRegistryManifestSchema.safeParse(parsed.value);\n if (!result.success) {\n const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);\n const diag = createSchemaInvalidDiagnostic(filePath, issues);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok(result.data, bag.all());\n }\n\n /**\n * Write a package manifest deterministically.\n *\n * Versions are pre-sorted newest-first by SemVer. The on-disk JSON uses\n * stable key ordering and a trailing newline so version control shows\n * minimal diffs.\n */\n async write(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>> {\n const bag = new DiagnosticBag();\n const filePath = this.paths.manifestPath(manifest.name);\n\n const normalized = this.normalize(manifest);\n const body = `${stableStringify(normalized)}\\n`;\n\n try {\n await mkdir(dirname(filePath), { recursive: true });\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createIoErrorDiagnostic(dirname(filePath), reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n try {\n await writeFile(filePath, body, 'utf-8');\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createManifestWriteErrorDiagnostic(filePath, reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok({ manifestPath: filePath, bytesWritten: Buffer.byteLength(body, 'utf-8') }, bag.all());\n }\n\n /** Sort versions newest-first by SemVer; preserves all other fields. */\n normalize(manifest: PackageRegistryManifest): PackageRegistryManifest {\n const sortedKeys = sortVersionsNewestFirst(Object.keys(manifest.versions));\n const source = manifest.versions as unknown as Record<string, RegistryVersion>;\n const versions: Record<string, RegistryVersion> = {};\n for (const k of sortedKeys) {\n const v = source[k];\n if (v !== undefined) {\n versions[k] = v;\n }\n }\n return {\n name: manifest.name,\n packageSource: manifest.packageSource,\n versions: versions as unknown as PackageRegistryManifest['versions'],\n };\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"ManifestStore.js","names":[],"sources":["../../src/io/ManifestStore.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { safeJsonParse, stableStringify } from '@uapkg/common';\nimport type { PackageName } from '@uapkg/common-schema';\nimport {\n createIoErrorDiagnostic,\n createManifestReadErrorDiagnostic,\n createManifestWriteErrorDiagnostic,\n createRegistryToolsPackageMissingDiagnostic,\n createSchemaInvalidDiagnostic,\n DiagnosticBag,\n ok,\n type Result,\n} from '@uapkg/diagnostics';\nimport {\n type PackageRegistryManifest,\n PackageRegistryManifestSchema,\n type RegistryVersion,\n} from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type { WriteManifestResult } from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport { sortVersionsNewestFirst } from '#registry-tools/mutation/VersionSorter.ts';\nimport type { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\n\n/**\n * Reads, validates, and writes registry-package manifests on disk.\n *\n * Responsibilities:\n * - Resolve manifest paths for a given package name.\n * - Decode JSON safely.\n * - Validate against `PackageRegistryManifestSchema`.\n * - Write deterministic, sorted, pretty-printed JSON.\n */\nexport class ManifestStore {\n constructor(\n private readonly paths: RegistryRepoPaths,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n /** Resolve the manifest path for a package. Pure path computation. */\n resolveManifestPath(packageName: PackageName): string {\n return this.paths.manifestPath(packageName);\n }\n\n /** True if the manifest file exists on disk. */\n exists(packageName: PackageName): boolean {\n return existsSync(this.paths.manifestPath(packageName));\n }\n\n /** Read and validate a package manifest. Emits a missing-package diagnostic when absent. */\n async read(packageName: PackageName): Promise<Result<PackageRegistryManifest>> {\n const bag = new DiagnosticBag();\n const filePath = this.paths.manifestPath(packageName);\n\n if (!existsSync(filePath)) {\n const diag = createRegistryToolsPackageMissingDiagnostic(packageName, filePath);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return this.readFromPath(filePath);\n }\n\n /** Read and validate a manifest file at an arbitrary path. */\n async readFromPath(filePath: string): Promise<Result<PackageRegistryManifest>> {\n const bag = new DiagnosticBag();\n\n let raw: string;\n try {\n raw = await readFile(filePath, 'utf-8');\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createManifestReadErrorDiagnostic(filePath, reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const parsed = safeJsonParse<unknown>(raw, filePath);\n if (!parsed.ok) {\n bag.mergeArray(parsed.diagnostics);\n this.aggregator.addMany(parsed.diagnostics);\n return bag.toFailure();\n }\n\n const result = PackageRegistryManifestSchema.safeParse(parsed.value);\n if (!result.success) {\n const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);\n const diag = createSchemaInvalidDiagnostic(filePath, issues);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok(result.data, bag.all());\n }\n\n /**\n * Write a package manifest deterministically.\n *\n * Versions are pre-sorted newest-first by SemVer. The on-disk JSON uses\n * stable key ordering and a trailing newline so version control shows\n * minimal diffs.\n */\n async write(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>> {\n const bag = new DiagnosticBag();\n const filePath = this.paths.manifestPath(manifest.name);\n\n const normalized = this.normalize(manifest);\n const body = `${stableStringify(normalized)}\\n`;\n\n try {\n await mkdir(dirname(filePath), { recursive: true });\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createIoErrorDiagnostic(dirname(filePath), reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n try {\n await writeFile(filePath, body, 'utf-8');\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createManifestWriteErrorDiagnostic(filePath, reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok({ manifestPath: filePath, bytesWritten: Buffer.byteLength(body, 'utf-8') }, bag.all());\n }\n\n /** Sort versions newest-first by SemVer; preserves all other fields. */\n normalize(manifest: PackageRegistryManifest): PackageRegistryManifest {\n const sortedKeys = sortVersionsNewestFirst(Object.keys(manifest.versions));\n const source = manifest.versions as unknown as Record<string, RegistryVersion>;\n const versions: Record<string, RegistryVersion> = {};\n for (const k of sortedKeys) {\n const v = source[k];\n if (v !== undefined) {\n versions[k] = v;\n }\n }\n return {\n name: manifest.name,\n packageSource: manifest.packageSource,\n versions: versions as unknown as PackageRegistryManifest['versions'],\n };\n }\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"PackageLister.js","names":[],"sources":["../../src/listing/PackageLister.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { extname, join } from 'node:path';\nimport type { PackageName } from '@uapkg/common-schema';\nimport { createIoErrorDiagnostic, DiagnosticBag, ok, type Result } from '@uapkg/diagnostics';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { PackageSummary } from '../contracts/RegistryToolsTypes.js';\nimport type { ManifestStore } from '../io/ManifestStore.js';\nimport type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\n\n/**\n * Lists packages in the registry repo by walking `packages/{first-letter}/*.json`.\n */\nexport class PackageLister {\n constructor(\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n /** All package names in the registry repo, sorted alphabetically. */\n async listPackageNames(): Promise<Result<PackageName[]>> {\n const bag = new DiagnosticBag();\n const root = this.paths.packagesDir();\n if (!existsSync(root)) {\n return ok([], bag.all());\n }\n\n let buckets: string[];\n try {\n buckets = await readdir(root);\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createIoErrorDiagnostic(root, reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const names: string[] = [];\n for (const bucket of buckets) {\n const bucketPath = join(root, bucket);\n let entries: string[];\n try {\n entries = await readdir(bucketPath);\n } catch {\n continue; // skip non-directory entries silently\n }\n const isScopeBucket = bucket.startsWith('@');\n for (const entry of entries) {\n if (extname(entry).toLowerCase() === '.json') {\n const bareName = entry.slice(0, -'.json'.length);\n names.push(isScopeBucket ? `${bucket}/${bareName}` : bareName);\n }\n }\n }\n\n names.sort();\n return ok(names as PackageName[], bag.all());\n }\n\n /** Summaries (manifest path + version count) for every package. */\n async listSummaries(): Promise<Result<PackageSummary[]>> {\n const namesResult = await this.listPackageNames();\n if (!namesResult.ok) return namesResult;\n\n const summaries: PackageSummary[] = [];\n const aggregateBag = new DiagnosticBag();\n\n for (const name of namesResult.value) {\n const manifestPath = this.store.resolveManifestPath(name);\n const read = await this.store.read(name);\n if (!read.ok) {\n aggregateBag.mergeArray(read.diagnostics);\n continue;\n }\n summaries.push({\n name,\n manifestPath,\n versionCount: Object.keys(read.value.versions).length,\n });\n }\n\n return ok(summaries, aggregateBag.all());\n }\n}\n"],"mappings":";;;;;;;;;AAaA,IAAa,gBAAb,MAA2B;CAEN;CACA;CACA;CAHnB,YACE,AAAiB,OACjB,AAAiB,OACjB,AAAiB,YACjB;EAHiB;EACA;EACA;CAChB;;CAGH,MAAM,mBAAmD;EACvD,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,OAAO,KAAK,MAAM,YAAY;EACpC,IAAI,CAAC,WAAW,IAAI,GAClB,OAAO,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC;EAGzB,IAAI;EACJ,IAAI;GACF,UAAU,MAAM,QAAQ,IAAI;EAC9B,SAAS,KAAK;GACZ,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,OAAO,wBAAwB,MAAM,MAAM;GACjD,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,QAAkB,CAAC;EACzB,KAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,aAAa,KAAK,MAAM,MAAM;GACpC,IAAI;GACJ,IAAI;IACF,UAAU,MAAM,QAAQ,UAAU;GACpC,QAAQ;IACN;GACF;GACA,MAAM,gBAAgB,OAAO,WAAW,GAAG;GAC3C,KAAK,MAAM,SAAS,SAClB,IAAI,QAAQ,KAAK,CAAC,CAAC,YAAY,MAAM,SAAS;IAC5C,MAAM,WAAW,MAAM,MAAM,GAAG,EAAe;IAC/C,MAAM,KAAK,gBAAgB,GAAG,OAAO,GAAG,aAAa,QAAQ;GAC/D;EAEJ;EAEA,MAAM,KAAK;EACX,OAAO,GAAG,OAAwB,IAAI,IAAI,CAAC;CAC7C;;CAGA,MAAM,gBAAmD;EACvD,MAAM,cAAc,MAAM,KAAK,iBAAiB;EAChD,IAAI,CAAC,YAAY,IAAI,OAAO;EAE5B,MAAM,YAA8B,CAAC;EACrC,MAAM,eAAe,IAAI,cAAc;EAEvC,KAAK,MAAM,QAAQ,YAAY,OAAO;GACpC,MAAM,eAAe,KAAK,MAAM,oBAAoB,IAAI;GACxD,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,IAAI;GACvC,IAAI,CAAC,KAAK,IAAI;IACZ,aAAa,WAAW,KAAK,WAAW;IACxC;GACF;GACA,UAAU,KAAK;IACb;IACA;IACA,cAAc,OAAO,KAAK,KAAK,MAAM,QAAQ,CAAC,CAAC;GACjD,CAAC;EACH;EAEA,OAAO,GAAG,WAAW,aAAa,IAAI,CAAC;CACzC;AACF"}
1
+ {"version":3,"file":"PackageLister.js","names":[],"sources":["../../src/listing/PackageLister.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { extname, join } from 'node:path';\nimport type { PackageName } from '@uapkg/common-schema';\nimport { createIoErrorDiagnostic, DiagnosticBag, ok, type Result } from '@uapkg/diagnostics';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type { PackageSummary } from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport type { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\nimport type { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\n\n/**\n * Lists packages in the registry repo by walking `packages/{first-letter}/*.json`.\n */\nexport class PackageLister {\n constructor(\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n /** All package names in the registry repo, sorted alphabetically. */\n async listPackageNames(): Promise<Result<PackageName[]>> {\n const bag = new DiagnosticBag();\n const root = this.paths.packagesDir();\n if (!existsSync(root)) {\n return ok([], bag.all());\n }\n\n let buckets: string[];\n try {\n buckets = await readdir(root);\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n const diag = createIoErrorDiagnostic(root, reason);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const names: string[] = [];\n for (const bucket of buckets) {\n const bucketPath = join(root, bucket);\n let entries: string[];\n try {\n entries = await readdir(bucketPath);\n } catch {\n continue; // skip non-directory entries silently\n }\n const isScopeBucket = bucket.startsWith('@');\n for (const entry of entries) {\n if (extname(entry).toLowerCase() === '.json') {\n const bareName = entry.slice(0, -'.json'.length);\n names.push(isScopeBucket ? `${bucket}/${bareName}` : bareName);\n }\n }\n }\n\n names.sort();\n return ok(names as PackageName[], bag.all());\n }\n\n /** Summaries (manifest path + version count) for every package. */\n async listSummaries(): Promise<Result<PackageSummary[]>> {\n const namesResult = await this.listPackageNames();\n if (!namesResult.ok) return namesResult;\n\n const summaries: PackageSummary[] = [];\n const aggregateBag = new DiagnosticBag();\n\n for (const name of namesResult.value) {\n const manifestPath = this.store.resolveManifestPath(name);\n const read = await this.store.read(name);\n if (!read.ok) {\n aggregateBag.mergeArray(read.diagnostics);\n continue;\n }\n summaries.push({\n name,\n manifestPath,\n versionCount: Object.keys(read.value.versions).length,\n });\n }\n\n return ok(summaries, aggregateBag.all());\n }\n}\n"],"mappings":";;;;;;;;;AAaA,IAAa,gBAAb,MAA2B;CAEN;CACA;CACA;CAHnB,YACE,AAAiB,OACjB,AAAiB,OACjB,AAAiB,YACjB;EAHiB;EACA;EACA;CAChB;;CAGH,MAAM,mBAAmD;EACvD,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,OAAO,KAAK,MAAM,YAAY;EACpC,IAAI,CAAC,WAAW,IAAI,GAClB,OAAO,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC;EAGzB,IAAI;EACJ,IAAI;GACF,UAAU,MAAM,QAAQ,IAAI;EAC9B,SAAS,KAAK;GACZ,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,OAAO,wBAAwB,MAAM,MAAM;GACjD,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,QAAkB,CAAC;EACzB,KAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,aAAa,KAAK,MAAM,MAAM;GACpC,IAAI;GACJ,IAAI;IACF,UAAU,MAAM,QAAQ,UAAU;GACpC,QAAQ;IACN;GACF;GACA,MAAM,gBAAgB,OAAO,WAAW,GAAG;GAC3C,KAAK,MAAM,SAAS,SAClB,IAAI,QAAQ,KAAK,CAAC,CAAC,YAAY,MAAM,SAAS;IAC5C,MAAM,WAAW,MAAM,MAAM,GAAG,EAAe;IAC/C,MAAM,KAAK,gBAAgB,GAAG,OAAO,GAAG,aAAa,QAAQ;GAC/D;EAEJ;EAEA,MAAM,KAAK;EACX,OAAO,GAAG,OAAwB,IAAI,IAAI,CAAC;CAC7C;;CAGA,MAAM,gBAAmD;EACvD,MAAM,cAAc,MAAM,KAAK,iBAAiB;EAChD,IAAI,CAAC,YAAY,IAAI,OAAO;EAE5B,MAAM,YAA8B,CAAC;EACrC,MAAM,eAAe,IAAI,cAAc;EAEvC,KAAK,MAAM,QAAQ,YAAY,OAAO;GACpC,MAAM,eAAe,KAAK,MAAM,oBAAoB,IAAI;GACxD,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,IAAI;GACvC,IAAI,CAAC,KAAK,IAAI;IACZ,aAAa,WAAW,KAAK,WAAW;IACxC;GACF;GACA,UAAU,KAAK;IACb;IACA;IACA,cAAc,OAAO,KAAK,KAAK,MAAM,QAAQ,CAAC,CAAC;GACjD,CAAC;EACH;EAEA,OAAO,GAAG,WAAW,aAAa,IAAI,CAAC;CACzC;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"AddPackageVersionPlanner.js","names":[],"sources":["../../src/mutation/AddPackageVersionPlanner.ts"],"sourcesContent":["import {\n createRegistryToolsPackageMissingDiagnostic,\n createRegistryToolsPackageSourceMismatchDiagnostic,\n createRegistryToolsPathMismatchDiagnostic,\n createRegistryToolsVersionExistsDiagnostic,\n createSchemaInvalidDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport { type PackageRegistryManifest, type RegistryVersion, RegistryVersionSchema } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type {\n AddPackageVersionRequest,\n RegistryMutationPlan,\n ResolvedRegistryToolsPolicy,\n} from '../contracts/RegistryToolsTypes.js';\nimport type { ManifestStore } from '../io/ManifestStore.js';\nimport type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\nimport type { DependencyReachabilityValidator } from '../validation/DependencyReachabilityValidator.js';\nimport type { ExternalRegistryPolicyValidator } from '../validation/ExternalRegistryPolicyValidator.js';\nimport { sortVersionsNewestFirst } from './VersionSorter.js';\n\n/**\n * Plans the addition of a single package version.\n *\n * Always produces a plan (never throws). Callers inspect the plan's\n * diagnostics — if any are at level `error`, the plan must not be applied.\n */\nexport class AddPackageVersionPlanner {\n constructor(\n _policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly externalRegistry: ExternalRegistryPolicyValidator,\n private readonly dependencyReachability: DependencyReachabilityValidator,\n private readonly aggregator: RegistryToolsAggregator,\n ) {\n // The resolved policy is consumed transitively through the validators we compose.\n void _policy;\n }\n\n async plan(request: AddPackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n const bag = new DiagnosticBag();\n const manifestPath = this.paths.manifestPath(request.packageName);\n\n // 1. Validate the version record before doing anything else.\n const versionResult = RegistryVersionSchema.safeParse(request.registryVersion);\n if (!versionResult.success) {\n const issues = versionResult.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);\n const diag = createSchemaInvalidDiagnostic(`${request.packageName}@${request.version}`, issues);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n // 2. Load existing manifest, if any.\n const existing = this.store.exists(request.packageName) ? await this.store.read(request.packageName) : null;\n\n let baseManifest: PackageRegistryManifest;\n let isCreate = false;\n\n if (existing) {\n if (existing.ok) {\n baseManifest = existing.value;\n\n // Name mismatch — package on disk identifies as a different name.\n if (baseManifest.name !== request.packageName) {\n const diag = createRegistryToolsPathMismatchDiagnostic(\n request.packageName,\n this.paths.manifestPath(baseManifest.name),\n manifestPath,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n\n // Source mismatch — protect against accidental source changes.\n if (\n baseManifest.packageSource.type !== request.packageSource.type ||\n baseManifest.packageSource.url !== request.packageSource.url\n ) {\n const diag = createRegistryToolsPackageSourceMismatchDiagnostic(\n request.packageName,\n baseManifest.packageSource,\n request.packageSource,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n } else {\n // Read error other than \"missing\" — propagate.\n bag.mergeArray(existing.diagnostics);\n return bag.toFailure();\n }\n } else {\n if (!request.createPackageManifestIfMissing) {\n const diag = createRegistryToolsPackageMissingDiagnostic(request.packageName, manifestPath);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n isCreate = true;\n baseManifest = {\n name: request.packageName,\n packageSource: request.packageSource,\n versions: {},\n };\n }\n\n // 3. Duplicate version check.\n const versionsRecord = baseManifest.versions as unknown as Record<string, RegistryVersion>;\n if (versionsRecord[request.version] && !request.overwriteExistingVersion) {\n const diag = createRegistryToolsVersionExistsDiagnostic(request.packageName, request.version);\n bag.add(diag);\n this.aggregator.add(diag);\n // Continue — surface other diagnostics too — but plan will be rejected.\n }\n\n // 4. Build candidate next manifest.\n const nextVersions: Record<string, RegistryVersion> = {\n ...versionsRecord,\n [request.version]: versionResult.data,\n };\n const sortedKeys = sortVersionsNewestFirst(Object.keys(nextVersions));\n const sortedNextVersions: Record<string, RegistryVersion> = {};\n for (const k of sortedKeys) {\n const v = nextVersions[k];\n if (v) sortedNextVersions[k] = v;\n }\n\n const nextManifest: PackageRegistryManifest = {\n name: request.packageName,\n packageSource: request.packageSource,\n versions: sortedNextVersions as unknown as PackageRegistryManifest['versions'],\n };\n\n // 5. External-registry policy on the candidate manifest.\n const ext = this.externalRegistry.validate(nextManifest);\n bag.mergeArray(ext.diagnostics);\n\n // 6. Dependency reachability on the new version only.\n const dep = await this.dependencyReachability.validate(request.packageName, request.version, versionResult.data);\n bag.mergeArray(dep.diagnostics);\n\n const operation = isCreate\n ? ({ kind: 'create-manifest', path: manifestPath } as const)\n : ({ kind: 'update-manifest', path: manifestPath } as const);\n\n return bag.toResult({\n operations: [operation],\n nextManifest,\n diagnostics: bag.all(),\n });\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"AddPackageVersionPlanner.js","names":[],"sources":["../../src/mutation/AddPackageVersionPlanner.ts"],"sourcesContent":["import {\n createRegistryToolsPackageMissingDiagnostic,\n createRegistryToolsPackageSourceMismatchDiagnostic,\n createRegistryToolsPathMismatchDiagnostic,\n createRegistryToolsVersionExistsDiagnostic,\n createSchemaInvalidDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport { type PackageRegistryManifest, type RegistryVersion, RegistryVersionSchema } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n AddPackageVersionRequest,\n RegistryMutationPlan,\n ResolvedRegistryToolsPolicy,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport type { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\nimport type { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\nimport type { DependencyReachabilityValidator } from '#registry-tools/validation/DependencyReachabilityValidator.ts';\nimport type { ExternalRegistryPolicyValidator } from '#registry-tools/validation/ExternalRegistryPolicyValidator.ts';\nimport { sortVersionsNewestFirst } from '#registry-tools/mutation/VersionSorter.ts';\n\n/**\n * Plans the addition of a single package version.\n *\n * Always produces a plan (never throws). Callers inspect the plan's\n * diagnostics — if any are at level `error`, the plan must not be applied.\n */\nexport class AddPackageVersionPlanner {\n constructor(\n _policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly externalRegistry: ExternalRegistryPolicyValidator,\n private readonly dependencyReachability: DependencyReachabilityValidator,\n private readonly aggregator: RegistryToolsAggregator,\n ) {\n // The resolved policy is consumed transitively through the validators we compose.\n void _policy;\n }\n\n async plan(request: AddPackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n const bag = new DiagnosticBag();\n const manifestPath = this.paths.manifestPath(request.packageName);\n\n // 1. Validate the version record before doing anything else.\n const versionResult = RegistryVersionSchema.safeParse(request.registryVersion);\n if (!versionResult.success) {\n const issues = versionResult.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);\n const diag = createSchemaInvalidDiagnostic(`${request.packageName}@${request.version}`, issues);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n // 2. Load existing manifest, if any.\n const existing = this.store.exists(request.packageName) ? await this.store.read(request.packageName) : null;\n\n let baseManifest: PackageRegistryManifest;\n let isCreate = false;\n\n if (existing) {\n if (existing.ok) {\n baseManifest = existing.value;\n\n // Name mismatch — package on disk identifies as a different name.\n if (baseManifest.name !== request.packageName) {\n const diag = createRegistryToolsPathMismatchDiagnostic(\n request.packageName,\n this.paths.manifestPath(baseManifest.name),\n manifestPath,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n\n // Source mismatch — protect against accidental source changes.\n if (\n baseManifest.packageSource.type !== request.packageSource.type ||\n baseManifest.packageSource.url !== request.packageSource.url\n ) {\n const diag = createRegistryToolsPackageSourceMismatchDiagnostic(\n request.packageName,\n baseManifest.packageSource,\n request.packageSource,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n } else {\n // Read error other than \"missing\" — propagate.\n bag.mergeArray(existing.diagnostics);\n return bag.toFailure();\n }\n } else {\n if (!request.createPackageManifestIfMissing) {\n const diag = createRegistryToolsPackageMissingDiagnostic(request.packageName, manifestPath);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n isCreate = true;\n baseManifest = {\n name: request.packageName,\n packageSource: request.packageSource,\n versions: {},\n };\n }\n\n // 3. Duplicate version check.\n const versionsRecord = baseManifest.versions as unknown as Record<string, RegistryVersion>;\n if (versionsRecord[request.version] && !request.overwriteExistingVersion) {\n const diag = createRegistryToolsVersionExistsDiagnostic(request.packageName, request.version);\n bag.add(diag);\n this.aggregator.add(diag);\n // Continue — surface other diagnostics too — but plan will be rejected.\n }\n\n // 4. Build candidate next manifest.\n const nextVersions: Record<string, RegistryVersion> = {\n ...versionsRecord,\n [request.version]: versionResult.data,\n };\n const sortedKeys = sortVersionsNewestFirst(Object.keys(nextVersions));\n const sortedNextVersions: Record<string, RegistryVersion> = {};\n for (const k of sortedKeys) {\n const v = nextVersions[k];\n if (v) sortedNextVersions[k] = v;\n }\n\n const nextManifest: PackageRegistryManifest = {\n name: request.packageName,\n packageSource: request.packageSource,\n versions: sortedNextVersions as unknown as PackageRegistryManifest['versions'],\n };\n\n // 5. External-registry policy on the candidate manifest.\n const ext = this.externalRegistry.validate(nextManifest);\n bag.mergeArray(ext.diagnostics);\n\n // 6. Dependency reachability on the new version only.\n const dep = await this.dependencyReachability.validate(request.packageName, request.version, versionResult.data);\n bag.mergeArray(dep.diagnostics);\n\n const operation = isCreate\n ? ({ kind: 'create-manifest', path: manifestPath } as const)\n : ({ kind: 'update-manifest', path: manifestPath } as const);\n\n return bag.toResult({\n operations: [operation],\n nextManifest,\n diagnostics: bag.all(),\n });\n }\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"RemovePackagePlanner.js","names":[],"sources":["../../src/mutation/RemovePackagePlanner.ts"],"sourcesContent":["import { createRegistryToolsRemovalDeniedDiagnostic, DiagnosticBag, type Result } from '@uapkg/diagnostics';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type {\n RegistryMutationPlan,\n RemovePackageRequest,\n ResolvedRegistryToolsPolicy,\n} from '../contracts/RegistryToolsTypes.js';\nimport type { ManifestStore } from '../io/ManifestStore.js';\nimport type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\n\n/**\n * Plans the deletion of a package's manifest entirely.\n *\n * Requires `policy.removals === 'allow-package-remove'`. Any weaker setting\n * blocks the plan.\n */\nexport class RemovePackagePlanner {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async plan(request: RemovePackageRequest): Promise<Result<RegistryMutationPlan>> {\n const bag = new DiagnosticBag();\n const manifestPath = this.paths.manifestPath(request.packageName);\n\n if (this.policy.removals !== 'allow-package-remove') {\n const diag = createRegistryToolsRemovalDeniedDiagnostic('package', request.packageName, this.policy.removals);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const read = await this.store.read(request.packageName);\n if (!read.ok) {\n bag.mergeArray(read.diagnostics);\n return bag.toFailure();\n }\n\n return bag.toResult({\n operations: [{ kind: 'delete-manifest', path: manifestPath }],\n diagnostics: bag.all(),\n });\n }\n}\n"],"mappings":";;;;;;;;;AAgBA,IAAa,uBAAb,MAAkC;CAEb;CACA;CACA;CACA;CAJnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,OACjB,AAAiB,YACjB;EAJiB;EACA;EACA;EACA;CAChB;CAEH,MAAM,KAAK,SAAsE;EAC/E,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,eAAe,KAAK,MAAM,aAAa,QAAQ,WAAW;EAEhE,IAAI,KAAK,OAAO,aAAa,wBAAwB;GACnD,MAAM,OAAO,2CAA2C,WAAW,QAAQ,aAAa,KAAK,OAAO,QAAQ;GAC5G,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,QAAQ,WAAW;EACtD,IAAI,CAAC,KAAK,IAAI;GACZ,IAAI,WAAW,KAAK,WAAW;GAC/B,OAAO,IAAI,UAAU;EACvB;EAEA,OAAO,IAAI,SAAS;GAClB,YAAY,CAAC;IAAE,MAAM;IAAmB,MAAM;GAAa,CAAC;GAC5D,aAAa,IAAI,IAAI;EACvB,CAAC;CACH;AACF"}
1
+ {"version":3,"file":"RemovePackagePlanner.js","names":[],"sources":["../../src/mutation/RemovePackagePlanner.ts"],"sourcesContent":["import { createRegistryToolsRemovalDeniedDiagnostic, DiagnosticBag, type Result } from '@uapkg/diagnostics';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n RegistryMutationPlan,\n RemovePackageRequest,\n ResolvedRegistryToolsPolicy,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport type { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\nimport type { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\n\n/**\n * Plans the deletion of a package's manifest entirely.\n *\n * Requires `policy.removals === 'allow-package-remove'`. Any weaker setting\n * blocks the plan.\n */\nexport class RemovePackagePlanner {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async plan(request: RemovePackageRequest): Promise<Result<RegistryMutationPlan>> {\n const bag = new DiagnosticBag();\n const manifestPath = this.paths.manifestPath(request.packageName);\n\n if (this.policy.removals !== 'allow-package-remove') {\n const diag = createRegistryToolsRemovalDeniedDiagnostic('package', request.packageName, this.policy.removals);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const read = await this.store.read(request.packageName);\n if (!read.ok) {\n bag.mergeArray(read.diagnostics);\n return bag.toFailure();\n }\n\n return bag.toResult({\n operations: [{ kind: 'delete-manifest', path: manifestPath }],\n diagnostics: bag.all(),\n });\n }\n}\n"],"mappings":";;;;;;;;;AAgBA,IAAa,uBAAb,MAAkC;CAEb;CACA;CACA;CACA;CAJnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,OACjB,AAAiB,YACjB;EAJiB;EACA;EACA;EACA;CAChB;CAEH,MAAM,KAAK,SAAsE;EAC/E,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,eAAe,KAAK,MAAM,aAAa,QAAQ,WAAW;EAEhE,IAAI,KAAK,OAAO,aAAa,wBAAwB;GACnD,MAAM,OAAO,2CAA2C,WAAW,QAAQ,aAAa,KAAK,OAAO,QAAQ;GAC5G,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,QAAQ,WAAW;EACtD,IAAI,CAAC,KAAK,IAAI;GACZ,IAAI,WAAW,KAAK,WAAW;GAC/B,OAAO,IAAI,UAAU;EACvB;EAEA,OAAO,IAAI,SAAS;GAClB,YAAY,CAAC;IAAE,MAAM;IAAmB,MAAM;GAAa,CAAC;GAC5D,aAAa,IAAI,IAAI;EACvB,CAAC;CACH;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"RemovePackageVersionPlanner.js","names":[],"sources":["../../src/mutation/RemovePackageVersionPlanner.ts"],"sourcesContent":["import {\n createRegistryToolsRemovalDeniedDiagnostic,\n createRegistryToolsVersionNotFoundDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { PackageRegistryManifest, RegistryVersion } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type {\n RegistryMutationPlan,\n RemovePackageVersionRequest,\n ResolvedRegistryToolsPolicy,\n} from '../contracts/RegistryToolsTypes.js';\nimport type { ManifestStore } from '../io/ManifestStore.js';\nimport type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\n\n/**\n * Plans the removal of a single version from a package.\n *\n * Honors `policy.removals` — by default, removals are denied.\n */\nexport class RemovePackageVersionPlanner {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async plan(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n const bag = new DiagnosticBag();\n const manifestPath = this.paths.manifestPath(request.packageName);\n\n if (this.policy.removals === 'deny') {\n const diag = createRegistryToolsRemovalDeniedDiagnostic(\n 'version',\n request.packageName,\n this.policy.removals,\n request.version,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const read = await this.store.read(request.packageName);\n if (!read.ok) {\n bag.mergeArray(read.diagnostics);\n return bag.toFailure();\n }\n\n const manifest = read.value;\n const versions = manifest.versions as unknown as Record<string, RegistryVersion>;\n\n if (!versions[request.version]) {\n const diag = createRegistryToolsVersionNotFoundDiagnostic(request.packageName, request.version);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const nextVersions: Record<string, RegistryVersion> = { ...versions };\n delete nextVersions[request.version];\n\n const nextManifest: PackageRegistryManifest = {\n name: manifest.name,\n packageSource: manifest.packageSource,\n versions: nextVersions as unknown as PackageRegistryManifest['versions'],\n };\n\n return bag.toResult({\n operations: [{ kind: 'update-manifest', path: manifestPath }],\n nextManifest,\n diagnostics: bag.all(),\n });\n }\n}\n"],"mappings":";;;;;;;;AAqBA,IAAa,8BAAb,MAAyC;CAEpB;CACA;CACA;CACA;CAJnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,OACjB,AAAiB,YACjB;EAJiB;EACA;EACA;EACA;CAChB;CAEH,MAAM,KAAK,SAA6E;EACtF,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,eAAe,KAAK,MAAM,aAAa,QAAQ,WAAW;EAEhE,IAAI,KAAK,OAAO,aAAa,QAAQ;GACnC,MAAM,OAAO,2CACX,WACA,QAAQ,aACR,KAAK,OAAO,UACZ,QAAQ,OACV;GACA,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,QAAQ,WAAW;EACtD,IAAI,CAAC,KAAK,IAAI;GACZ,IAAI,WAAW,KAAK,WAAW;GAC/B,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,WAAW,KAAK;EACtB,MAAM,WAAW,SAAS;EAE1B,IAAI,CAAC,SAAS,QAAQ,UAAU;GAC9B,MAAM,OAAO,6CAA6C,QAAQ,aAAa,QAAQ,OAAO;GAC9F,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,eAAgD,EAAE,GAAG,SAAS;EACpE,OAAO,aAAa,QAAQ;EAE5B,MAAM,eAAwC;GAC5C,MAAM,SAAS;GACf,eAAe,SAAS;GACxB,UAAU;EACZ;EAEA,OAAO,IAAI,SAAS;GAClB,YAAY,CAAC;IAAE,MAAM;IAAmB,MAAM;GAAa,CAAC;GAC5D;GACA,aAAa,IAAI,IAAI;EACvB,CAAC;CACH;AACF"}
1
+ {"version":3,"file":"RemovePackageVersionPlanner.js","names":[],"sources":["../../src/mutation/RemovePackageVersionPlanner.ts"],"sourcesContent":["import {\n createRegistryToolsRemovalDeniedDiagnostic,\n createRegistryToolsVersionNotFoundDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { PackageRegistryManifest, RegistryVersion } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n RegistryMutationPlan,\n RemovePackageVersionRequest,\n ResolvedRegistryToolsPolicy,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport type { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\nimport type { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\n\n/**\n * Plans the removal of a single version from a package.\n *\n * Honors `policy.removals` — by default, removals are denied.\n */\nexport class RemovePackageVersionPlanner {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async plan(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n const bag = new DiagnosticBag();\n const manifestPath = this.paths.manifestPath(request.packageName);\n\n if (this.policy.removals === 'deny') {\n const diag = createRegistryToolsRemovalDeniedDiagnostic(\n 'version',\n request.packageName,\n this.policy.removals,\n request.version,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const read = await this.store.read(request.packageName);\n if (!read.ok) {\n bag.mergeArray(read.diagnostics);\n return bag.toFailure();\n }\n\n const manifest = read.value;\n const versions = manifest.versions as unknown as Record<string, RegistryVersion>;\n\n if (!versions[request.version]) {\n const diag = createRegistryToolsVersionNotFoundDiagnostic(request.packageName, request.version);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n const nextVersions: Record<string, RegistryVersion> = { ...versions };\n delete nextVersions[request.version];\n\n const nextManifest: PackageRegistryManifest = {\n name: manifest.name,\n packageSource: manifest.packageSource,\n versions: nextVersions as unknown as PackageRegistryManifest['versions'],\n };\n\n return bag.toResult({\n operations: [{ kind: 'update-manifest', path: manifestPath }],\n nextManifest,\n diagnostics: bag.all(),\n });\n }\n}\n"],"mappings":";;;;;;;;AAqBA,IAAa,8BAAb,MAAyC;CAEpB;CACA;CACA;CACA;CAJnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,OACjB,AAAiB,YACjB;EAJiB;EACA;EACA;EACA;CAChB;CAEH,MAAM,KAAK,SAA6E;EACtF,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,eAAe,KAAK,MAAM,aAAa,QAAQ,WAAW;EAEhE,IAAI,KAAK,OAAO,aAAa,QAAQ;GACnC,MAAM,OAAO,2CACX,WACA,QAAQ,aACR,KAAK,OAAO,UACZ,QAAQ,OACV;GACA,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,QAAQ,WAAW;EACtD,IAAI,CAAC,KAAK,IAAI;GACZ,IAAI,WAAW,KAAK,WAAW;GAC/B,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,WAAW,KAAK;EACtB,MAAM,WAAW,SAAS;EAE1B,IAAI,CAAC,SAAS,QAAQ,UAAU;GAC9B,MAAM,OAAO,6CAA6C,QAAQ,aAAa,QAAQ,OAAO;GAC9F,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,eAAgD,EAAE,GAAG,SAAS;EACpE,OAAO,aAAa,QAAQ;EAE5B,MAAM,eAAwC;GAC5C,MAAM,SAAS;GACf,eAAe,SAAS;GACxB,UAAU;EACZ;EAEA,OAAO,IAAI,SAAS;GAClB,YAAY,CAAC;IAAE,MAAM;IAAmB,MAAM;GAAa,CAAC;GAC5D;GACA,aAAa,IAAI,IAAI;EACvB,CAAC;CACH;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"RegistryRepoPaths.js","names":[],"sources":["../../src/paths/RegistryRepoPaths.ts"],"sourcesContent":["import { join } from 'node:path';\nimport type { PackageName } from '@uapkg/common-schema';\nimport { getRegistryPackagePathSegments } from '@uapkg/registry-schema';\nimport { REGISTRY_TOOLS_PACKAGES_DIR } from '../contracts/RegistryToolsTypes.js';\n\n/**\n * Pure path helpers for the registry repo layout used by `@uapkg/registry-tools`.\n *\n * The `cwd` passed in is the root of the registry repo, NOT a package dir.\n * Layout: `{cwd}/packages/{first-letter}/{name}.json` for unscoped names and\n * `{cwd}/packages/@{scope}/{name}.json` for scoped names.\n */\nexport class RegistryRepoPaths {\n constructor(private readonly cwd: string) {}\n\n /** Absolute path to the `packages` directory in the registry repo. */\n packagesDir(): string {\n return join(this.cwd, REGISTRY_TOOLS_PACKAGES_DIR);\n }\n\n /** Absolute path to the bucket dir for the given package, e.g. `packages/a` or `packages/@acme`. */\n bucketDir(packageName: PackageName): string {\n const segments = getRegistryPackagePathSegments(packageName);\n return join(this.cwd, ...segments.slice(0, -1));\n }\n\n /** Absolute path to a package's manifest JSON file. */\n manifestPath(packageName: PackageName): string {\n return join(this.cwd, ...getRegistryPackagePathSegments(packageName));\n }\n\n /** Bucket folder name: the scope directory for scoped names, else the first lowercase character. */\n firstLetter(packageName: PackageName): string {\n const segments = getRegistryPackagePathSegments(packageName);\n return segments[segments.length - 2];\n }\n}\n"],"mappings":";;;;;;;;;;;;AAYA,IAAa,oBAAb,MAA+B;CACA;CAA7B,YAAY,AAAiB,KAAa;EAAb;CAAc;;CAG3C,cAAsB;EACpB,OAAO,KAAK,KAAK,KAAK,2BAA2B;CACnD;;CAGA,UAAU,aAAkC;EAC1C,MAAM,WAAW,+BAA+B,WAAW;EAC3D,OAAO,KAAK,KAAK,KAAK,GAAG,SAAS,MAAM,GAAG,EAAE,CAAC;CAChD;;CAGA,aAAa,aAAkC;EAC7C,OAAO,KAAK,KAAK,KAAK,GAAG,+BAA+B,WAAW,CAAC;CACtE;;CAGA,YAAY,aAAkC;EAC5C,MAAM,WAAW,+BAA+B,WAAW;EAC3D,OAAO,SAAS,SAAS,SAAS;CACpC;AACF"}
1
+ {"version":3,"file":"RegistryRepoPaths.js","names":[],"sources":["../../src/paths/RegistryRepoPaths.ts"],"sourcesContent":["import { join } from 'node:path';\nimport type { PackageName } from '@uapkg/common-schema';\nimport { getRegistryPackagePathSegments } from '@uapkg/registry-schema';\nimport { REGISTRY_TOOLS_PACKAGES_DIR } from '#registry-tools/contracts/RegistryToolsTypes.ts';\n\n/**\n * Pure path helpers for the registry repo layout used by `@uapkg/registry-tools`.\n *\n * The `cwd` passed in is the root of the registry repo, NOT a package dir.\n * Layout: `{cwd}/packages/{first-letter}/{name}.json` for unscoped names and\n * `{cwd}/packages/@{scope}/{name}.json` for scoped names.\n */\nexport class RegistryRepoPaths {\n constructor(private readonly cwd: string) {}\n\n /** Absolute path to the `packages` directory in the registry repo. */\n packagesDir(): string {\n return join(this.cwd, REGISTRY_TOOLS_PACKAGES_DIR);\n }\n\n /** Absolute path to the bucket dir for the given package, e.g. `packages/a` or `packages/@acme`. */\n bucketDir(packageName: PackageName): string {\n const segments = getRegistryPackagePathSegments(packageName);\n return join(this.cwd, ...segments.slice(0, -1));\n }\n\n /** Absolute path to a package's manifest JSON file. */\n manifestPath(packageName: PackageName): string {\n return join(this.cwd, ...getRegistryPackagePathSegments(packageName));\n }\n\n /** Bucket folder name: the scope directory for scoped names, else the first lowercase character. */\n firstLetter(packageName: PackageName): string {\n const segments = getRegistryPackagePathSegments(packageName);\n return segments[segments.length - 2];\n }\n}\n"],"mappings":";;;;;;;;;;;;AAYA,IAAa,oBAAb,MAA+B;CACA;CAA7B,YAAY,AAAiB,KAAa;EAAb;CAAc;;CAG3C,cAAsB;EACpB,OAAO,KAAK,KAAK,KAAK,2BAA2B;CACnD;;CAGA,UAAU,aAAkC;EAC1C,MAAM,WAAW,+BAA+B,WAAW;EAC3D,OAAO,KAAK,KAAK,KAAK,GAAG,SAAS,MAAM,GAAG,EAAE,CAAC;CAChD;;CAGA,aAAa,aAAkC;EAC7C,OAAO,KAAK,KAAK,KAAK,GAAG,+BAA+B,WAAW,CAAC;CACtE;;CAGA,YAAY,aAAkC;EAC5C,MAAM,WAAW,+BAA+B,WAAW;EAC3D,OAAO,SAAS,SAAS,SAAS;CACpC;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"RegistryTools.js","names":[],"sources":["../../src/tools/RegistryTools.ts"],"sourcesContent":["import { rm } from 'node:fs/promises';\nimport type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport { type Diagnostic, DiagnosticBag, fail, ok, type Result } from '@uapkg/diagnostics';\nimport type { Integrity, PackageRegistryManifest, RegistryVersion } from '@uapkg/registry-schema';\nimport { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type {\n AddPackageVersionRequest,\n ChangedManifestValidation,\n DependencyValidationReport,\n ExternalRegistryPolicyReport,\n IntegrityAlgorithm,\n IntegrityVerificationResult,\n OfficialPackagePolicyReport,\n PackageSummary,\n RegistryLintReport,\n RegistryMutationPlan,\n RegistryMutationSummary,\n RegistryToolsOptions,\n RegistryValidationReport,\n ReleaseFileNameReport,\n RemovePackageRequest,\n RemovePackageVersionRequest,\n ResolvedRegistryToolsPolicy,\n WriteManifestResult,\n} from '../contracts/RegistryToolsTypes.js';\nimport { IntegrityCalculator } from '../io/IntegrityCalculator.js';\nimport { ManifestStore } from '../io/ManifestStore.js';\nimport { PackageLister } from '../listing/PackageLister.js';\nimport { AddPackageVersionPlanner } from '../mutation/AddPackageVersionPlanner.js';\nimport { RemovePackagePlanner } from '../mutation/RemovePackagePlanner.js';\nimport { RemovePackageVersionPlanner } from '../mutation/RemovePackageVersionPlanner.js';\nimport { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\nimport { DependencyReachabilityValidator } from '../validation/DependencyReachabilityValidator.js';\nimport { ExternalRegistryPolicyValidator } from '../validation/ExternalRegistryPolicyValidator.js';\nimport { ManifestValidator } from '../validation/ManifestValidator.js';\nimport {\n type OfficialRegistryPolicyRequest,\n OfficialRegistryPolicyValidator,\n} from '../validation/OfficialRegistryPolicyValidator.js';\nimport { RegistryValidator } from '../validation/RegistryValidator.js';\nimport { ReleaseFileNameValidator } from '../validation/ReleaseFileNameValidator.js';\n\n/**\n * Programmatic toolkit for registry-owner workflows over a uapkg registry repo.\n *\n * Always returns `Result<T>`. Never throws for expected failures. Diagnostics\n * are also pushed into a process-wide singleton aggregator (with `once`\n * deduplication) so a CI run can surface a single consolidated list.\n *\n * The `cwd` constructor option is the **registry repo root**, never a package\n * directory inside it.\n */\nexport class RegistryTools {\n private readonly policy: ResolvedRegistryToolsPolicy;\n private readonly paths: RegistryRepoPaths;\n private readonly aggregator: RegistryToolsAggregator;\n\n private readonly store: ManifestStore;\n private readonly manifestValidator: ManifestValidator;\n private readonly externalRegistry: ExternalRegistryPolicyValidator;\n private readonly dependencyReachability: DependencyReachabilityValidator;\n private readonly releaseFileNames: ReleaseFileNameValidator;\n private readonly officialPolicy: OfficialRegistryPolicyValidator;\n private readonly integrity: IntegrityCalculator;\n private readonly lister: PackageLister;\n private readonly registryValidator: RegistryValidator;\n private readonly addPlanner: AddPackageVersionPlanner;\n private readonly removeVersionPlanner: RemovePackageVersionPlanner;\n private readonly removePackagePlanner: RemovePackagePlanner;\n\n constructor(options: RegistryToolsOptions) {\n this.policy = resolvePolicy(options.policy);\n this.paths = new RegistryRepoPaths(options.cwd);\n this.aggregator = RegistryToolsAggregator.getInstance();\n\n this.store = new ManifestStore(this.paths, this.aggregator);\n this.manifestValidator = new ManifestValidator(this.aggregator);\n this.externalRegistry = new ExternalRegistryPolicyValidator(this.policy, this.aggregator);\n this.dependencyReachability = new DependencyReachabilityValidator(this.policy, this.store, this.aggregator);\n this.releaseFileNames = new ReleaseFileNameValidator(this.aggregator);\n this.officialPolicy = new OfficialRegistryPolicyValidator(this.aggregator);\n this.integrity = new IntegrityCalculator(this.aggregator);\n this.lister = new PackageLister(this.paths, this.store, this.aggregator);\n this.registryValidator = new RegistryValidator(\n this.policy,\n this.paths,\n this.store,\n this.lister,\n this.externalRegistry,\n this.dependencyReachability,\n this.aggregator,\n );\n this.addPlanner = new AddPackageVersionPlanner(\n this.policy,\n this.paths,\n this.store,\n this.externalRegistry,\n this.dependencyReachability,\n this.aggregator,\n );\n this.removeVersionPlanner = new RemovePackageVersionPlanner(this.policy, this.paths, this.store, this.aggregator);\n this.removePackagePlanner = new RemovePackagePlanner(this.policy, this.paths, this.store, this.aggregator);\n }\n\n // ---------------------------------------------------------------------\n // Read / list\n // ---------------------------------------------------------------------\n\n getManifestPath(packageName: PackageName): Result<string> {\n return ok(this.paths.manifestPath(packageName));\n }\n\n readPackageManifest(packageName: PackageName): Promise<Result<PackageRegistryManifest>> {\n return this.store.read(packageName);\n }\n\n writePackageManifest(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>> {\n return this.store.write(manifest);\n }\n\n packageExists(packageName: PackageName): Result<boolean> {\n return ok(this.store.exists(packageName));\n }\n\n listPackages(): Promise<Result<PackageSummary[]>> {\n return this.lister.listSummaries();\n }\n\n async listVersions(packageName: PackageName): Promise<Result<PackageVersion[]>> {\n const read = await this.store.read(packageName);\n if (!read.ok) return read;\n return ok(Object.keys(read.value.versions) as PackageVersion[], read.diagnostics);\n }\n\n // ---------------------------------------------------------------------\n // Validation / lint\n // ---------------------------------------------------------------------\n\n validatePackageManifest(manifest: unknown): Result<PackageRegistryManifest> {\n return this.manifestValidator.validate(manifest);\n }\n\n validateManifestFile(path: string): Promise<Result<PackageRegistryManifest>> {\n return this.store.readFromPath(path);\n }\n\n validateRegistry(): Promise<Result<RegistryValidationReport>> {\n return this.registryValidator.validateRegistry();\n }\n\n validatePackages(packageNames: readonly PackageName[]): Promise<Result<RegistryValidationReport>> {\n return this.registryValidator.validatePackages(packageNames);\n }\n\n async validateChangedManifestFiles(paths: readonly string[]): Promise<Result<ChangedManifestValidation>> {\n const perFile: { path: string; diagnostics: readonly Diagnostic[] }[] = [];\n const overall = new DiagnosticBag();\n for (const path of paths) {\n const r = await this.store.readFromPath(path);\n perFile.push({ path, diagnostics: r.diagnostics });\n overall.mergeArray(r.diagnostics);\n }\n return ok({ perFile }, overall.all());\n }\n\n async validateDependencyReachability(\n packageName: PackageName,\n version: PackageVersion,\n ): Promise<Result<DependencyValidationReport>> {\n const read = await this.store.read(packageName);\n if (!read.ok) return read;\n const entry = (read.value.versions as unknown as Record<string, RegistryVersion>)[version];\n if (!entry) {\n const bag = new DiagnosticBag();\n bag.mergeArray(read.diagnostics);\n return fail(bag.all());\n }\n return this.dependencyReachability.validate(packageName, version, entry);\n }\n\n validateExternalRegistryPolicy(manifest: PackageRegistryManifest): Result<ExternalRegistryPolicyReport> {\n return this.externalRegistry.validate(manifest);\n }\n\n validateReleaseFileNames(\n packageName: PackageName,\n version: PackageVersion,\n fileNames: readonly string[],\n ): Result<ReleaseFileNameReport> {\n return this.releaseFileNames.validate(packageName, version, fileNames);\n }\n\n validateOfficialRegistryPolicy(request: OfficialRegistryPolicyRequest): Promise<Result<OfficialPackagePolicyReport>> {\n return this.officialPolicy.validate(request);\n }\n\n /** Run lint-style checks across the whole registry. Currently equivalent to a full validation. */\n async lintRegistry(): Promise<Result<RegistryLintReport>> {\n const r = await this.registryValidator.validateRegistry();\n if (!r.ok) return r;\n return ok({ diagnostics: r.value.diagnostics }, r.diagnostics);\n }\n\n /** Lint a single in-memory manifest. */\n lintPackageManifest(manifest: PackageRegistryManifest): Result<RegistryLintReport> {\n const ext = this.externalRegistry.validate(manifest);\n return ok({ diagnostics: ext.diagnostics }, ext.diagnostics);\n }\n\n // ---------------------------------------------------------------------\n // Mutation\n // ---------------------------------------------------------------------\n\n planAddPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n return this.addPlanner.plan(request);\n }\n\n async addPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationSummary>> {\n const plan = await this.addPlanner.plan(request);\n if (!plan.ok) return plan;\n return this.applyPlan(plan.value);\n }\n\n planRemovePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n return this.removeVersionPlanner.plan(request);\n }\n\n async removePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationSummary>> {\n const plan = await this.removeVersionPlanner.plan(request);\n if (!plan.ok) return plan;\n return this.applyPlan(plan.value);\n }\n\n planRemovePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationPlan>> {\n return this.removePackagePlanner.plan(request);\n }\n\n async removePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationSummary>> {\n const plan = await this.removePackagePlanner.plan(request);\n if (!plan.ok) return plan;\n return this.applyPlan(plan.value);\n }\n\n // ---------------------------------------------------------------------\n // Integrity\n // ---------------------------------------------------------------------\n\n computeFileIntegrity(filePath: string, algorithm?: IntegrityAlgorithm): Promise<Result<Integrity>> {\n return this.integrity.compute(filePath, algorithm);\n }\n\n verifyFileIntegrity(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>> {\n return this.integrity.verify(filePath, expected);\n }\n\n // ---------------------------------------------------------------------\n // Internals\n // ---------------------------------------------------------------------\n\n private async applyPlan(plan: RegistryMutationPlan): Promise<Result<RegistryMutationSummary>> {\n const bag = new DiagnosticBag();\n bag.mergeArray(plan.diagnostics);\n\n for (const op of plan.operations) {\n if (op.kind === 'delete-manifest') {\n try {\n await rm(op.path, { force: true });\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n bag.addError('IO_ERROR', `Failed to delete ${op.path}: ${reason}`, { path: op.path, reason });\n this.aggregator.addMany(bag.all());\n return bag.toFailure();\n }\n } else if (plan.nextManifest) {\n const write = await this.store.write(plan.nextManifest);\n if (!write.ok) {\n bag.mergeArray(write.diagnostics);\n return bag.toFailure();\n }\n }\n }\n\n return ok(\n {\n operations: plan.operations,\n diagnostics: bag.all(),\n },\n bag.all(),\n );\n }\n}\n\nfunction resolvePolicy(policy: RegistryToolsOptions['policy']): ResolvedRegistryToolsPolicy {\n return {\n externalRegistries: policy?.externalRegistries ?? 'deny',\n allowedExternalRegistryNames: policy?.allowedExternalRegistryNames ?? [],\n removals: policy?.removals ?? 'deny',\n unknownKeys: policy?.unknownKeys ?? 'warn',\n requireExistingDependencies: policy?.requireExistingDependencies ?? true,\n requireReachableDependencyRanges: policy?.requireReachableDependencyRanges ?? true,\n requireSortedVersions: policy?.requireSortedVersions ?? true,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"RegistryTools.js","names":[],"sources":["../../src/tools/RegistryTools.ts"],"sourcesContent":["import { rm } from 'node:fs/promises';\nimport type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport { type Diagnostic, DiagnosticBag, fail, ok, type Result } from '@uapkg/diagnostics';\nimport type { Integrity, PackageRegistryManifest, RegistryVersion } from '@uapkg/registry-schema';\nimport { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n AddPackageVersionRequest,\n ChangedManifestValidation,\n DependencyValidationReport,\n ExternalRegistryPolicyReport,\n IntegrityAlgorithm,\n IntegrityVerificationResult,\n OfficialPackagePolicyReport,\n PackageSummary,\n RegistryLintReport,\n RegistryMutationPlan,\n RegistryMutationSummary,\n RegistryToolsOptions,\n RegistryValidationReport,\n ReleaseFileNameReport,\n RemovePackageRequest,\n RemovePackageVersionRequest,\n ResolvedRegistryToolsPolicy,\n WriteManifestResult,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport { IntegrityCalculator } from '#registry-tools/io/IntegrityCalculator.ts';\nimport { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\nimport { PackageLister } from '#registry-tools/listing/PackageLister.ts';\nimport { AddPackageVersionPlanner } from '#registry-tools/mutation/AddPackageVersionPlanner.ts';\nimport { RemovePackagePlanner } from '#registry-tools/mutation/RemovePackagePlanner.ts';\nimport { RemovePackageVersionPlanner } from '#registry-tools/mutation/RemovePackageVersionPlanner.ts';\nimport { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\nimport { DependencyReachabilityValidator } from '#registry-tools/validation/DependencyReachabilityValidator.ts';\nimport { ExternalRegistryPolicyValidator } from '#registry-tools/validation/ExternalRegistryPolicyValidator.ts';\nimport { ManifestValidator } from '#registry-tools/validation/ManifestValidator.ts';\nimport {\n type OfficialRegistryPolicyRequest,\n OfficialRegistryPolicyValidator,\n} from '#registry-tools/validation/OfficialRegistryPolicyValidator.ts';\nimport { RegistryValidator } from '#registry-tools/validation/RegistryValidator.ts';\nimport { ReleaseFileNameValidator } from '#registry-tools/validation/ReleaseFileNameValidator.ts';\n\n/**\n * Programmatic toolkit for registry-owner workflows over a uapkg registry repo.\n *\n * Always returns `Result<T>`. Never throws for expected failures. Diagnostics\n * are also pushed into a process-wide singleton aggregator (with `once`\n * deduplication) so a CI run can surface a single consolidated list.\n *\n * The `cwd` constructor option is the **registry repo root**, never a package\n * directory inside it.\n */\nexport class RegistryTools {\n private readonly policy: ResolvedRegistryToolsPolicy;\n private readonly paths: RegistryRepoPaths;\n private readonly aggregator: RegistryToolsAggregator;\n\n private readonly store: ManifestStore;\n private readonly manifestValidator: ManifestValidator;\n private readonly externalRegistry: ExternalRegistryPolicyValidator;\n private readonly dependencyReachability: DependencyReachabilityValidator;\n private readonly releaseFileNames: ReleaseFileNameValidator;\n private readonly officialPolicy: OfficialRegistryPolicyValidator;\n private readonly integrity: IntegrityCalculator;\n private readonly lister: PackageLister;\n private readonly registryValidator: RegistryValidator;\n private readonly addPlanner: AddPackageVersionPlanner;\n private readonly removeVersionPlanner: RemovePackageVersionPlanner;\n private readonly removePackagePlanner: RemovePackagePlanner;\n\n constructor(options: RegistryToolsOptions) {\n this.policy = resolvePolicy(options.policy);\n this.paths = new RegistryRepoPaths(options.cwd);\n this.aggregator = RegistryToolsAggregator.getInstance();\n\n this.store = new ManifestStore(this.paths, this.aggregator);\n this.manifestValidator = new ManifestValidator(this.aggregator);\n this.externalRegistry = new ExternalRegistryPolicyValidator(this.policy, this.aggregator);\n this.dependencyReachability = new DependencyReachabilityValidator(this.policy, this.store, this.aggregator);\n this.releaseFileNames = new ReleaseFileNameValidator(this.aggregator);\n this.officialPolicy = new OfficialRegistryPolicyValidator(this.aggregator);\n this.integrity = new IntegrityCalculator(this.aggregator);\n this.lister = new PackageLister(this.paths, this.store, this.aggregator);\n this.registryValidator = new RegistryValidator(\n this.policy,\n this.paths,\n this.store,\n this.lister,\n this.externalRegistry,\n this.dependencyReachability,\n this.aggregator,\n );\n this.addPlanner = new AddPackageVersionPlanner(\n this.policy,\n this.paths,\n this.store,\n this.externalRegistry,\n this.dependencyReachability,\n this.aggregator,\n );\n this.removeVersionPlanner = new RemovePackageVersionPlanner(this.policy, this.paths, this.store, this.aggregator);\n this.removePackagePlanner = new RemovePackagePlanner(this.policy, this.paths, this.store, this.aggregator);\n }\n\n // ---------------------------------------------------------------------\n // Read / list\n // ---------------------------------------------------------------------\n\n getManifestPath(packageName: PackageName): Result<string> {\n return ok(this.paths.manifestPath(packageName));\n }\n\n readPackageManifest(packageName: PackageName): Promise<Result<PackageRegistryManifest>> {\n return this.store.read(packageName);\n }\n\n writePackageManifest(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>> {\n return this.store.write(manifest);\n }\n\n packageExists(packageName: PackageName): Result<boolean> {\n return ok(this.store.exists(packageName));\n }\n\n listPackages(): Promise<Result<PackageSummary[]>> {\n return this.lister.listSummaries();\n }\n\n async listVersions(packageName: PackageName): Promise<Result<PackageVersion[]>> {\n const read = await this.store.read(packageName);\n if (!read.ok) return read;\n return ok(Object.keys(read.value.versions) as PackageVersion[], read.diagnostics);\n }\n\n // ---------------------------------------------------------------------\n // Validation / lint\n // ---------------------------------------------------------------------\n\n validatePackageManifest(manifest: unknown): Result<PackageRegistryManifest> {\n return this.manifestValidator.validate(manifest);\n }\n\n validateManifestFile(path: string): Promise<Result<PackageRegistryManifest>> {\n return this.store.readFromPath(path);\n }\n\n validateRegistry(): Promise<Result<RegistryValidationReport>> {\n return this.registryValidator.validateRegistry();\n }\n\n validatePackages(packageNames: readonly PackageName[]): Promise<Result<RegistryValidationReport>> {\n return this.registryValidator.validatePackages(packageNames);\n }\n\n async validateChangedManifestFiles(paths: readonly string[]): Promise<Result<ChangedManifestValidation>> {\n const perFile: { path: string; diagnostics: readonly Diagnostic[] }[] = [];\n const overall = new DiagnosticBag();\n for (const path of paths) {\n const r = await this.store.readFromPath(path);\n perFile.push({ path, diagnostics: r.diagnostics });\n overall.mergeArray(r.diagnostics);\n }\n return ok({ perFile }, overall.all());\n }\n\n async validateDependencyReachability(\n packageName: PackageName,\n version: PackageVersion,\n ): Promise<Result<DependencyValidationReport>> {\n const read = await this.store.read(packageName);\n if (!read.ok) return read;\n const entry = (read.value.versions as unknown as Record<string, RegistryVersion>)[version];\n if (!entry) {\n const bag = new DiagnosticBag();\n bag.mergeArray(read.diagnostics);\n return fail(bag.all());\n }\n return this.dependencyReachability.validate(packageName, version, entry);\n }\n\n validateExternalRegistryPolicy(manifest: PackageRegistryManifest): Result<ExternalRegistryPolicyReport> {\n return this.externalRegistry.validate(manifest);\n }\n\n validateReleaseFileNames(\n packageName: PackageName,\n version: PackageVersion,\n fileNames: readonly string[],\n ): Result<ReleaseFileNameReport> {\n return this.releaseFileNames.validate(packageName, version, fileNames);\n }\n\n validateOfficialRegistryPolicy(request: OfficialRegistryPolicyRequest): Promise<Result<OfficialPackagePolicyReport>> {\n return this.officialPolicy.validate(request);\n }\n\n /** Run lint-style checks across the whole registry. Currently equivalent to a full validation. */\n async lintRegistry(): Promise<Result<RegistryLintReport>> {\n const r = await this.registryValidator.validateRegistry();\n if (!r.ok) return r;\n return ok({ diagnostics: r.value.diagnostics }, r.diagnostics);\n }\n\n /** Lint a single in-memory manifest. */\n lintPackageManifest(manifest: PackageRegistryManifest): Result<RegistryLintReport> {\n const ext = this.externalRegistry.validate(manifest);\n return ok({ diagnostics: ext.diagnostics }, ext.diagnostics);\n }\n\n // ---------------------------------------------------------------------\n // Mutation\n // ---------------------------------------------------------------------\n\n planAddPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n return this.addPlanner.plan(request);\n }\n\n async addPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationSummary>> {\n const plan = await this.addPlanner.plan(request);\n if (!plan.ok) return plan;\n return this.applyPlan(plan.value);\n }\n\n planRemovePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationPlan>> {\n return this.removeVersionPlanner.plan(request);\n }\n\n async removePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationSummary>> {\n const plan = await this.removeVersionPlanner.plan(request);\n if (!plan.ok) return plan;\n return this.applyPlan(plan.value);\n }\n\n planRemovePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationPlan>> {\n return this.removePackagePlanner.plan(request);\n }\n\n async removePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationSummary>> {\n const plan = await this.removePackagePlanner.plan(request);\n if (!plan.ok) return plan;\n return this.applyPlan(plan.value);\n }\n\n // ---------------------------------------------------------------------\n // Integrity\n // ---------------------------------------------------------------------\n\n computeFileIntegrity(filePath: string, algorithm?: IntegrityAlgorithm): Promise<Result<Integrity>> {\n return this.integrity.compute(filePath, algorithm);\n }\n\n verifyFileIntegrity(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>> {\n return this.integrity.verify(filePath, expected);\n }\n\n // ---------------------------------------------------------------------\n // Internals\n // ---------------------------------------------------------------------\n\n private async applyPlan(plan: RegistryMutationPlan): Promise<Result<RegistryMutationSummary>> {\n const bag = new DiagnosticBag();\n bag.mergeArray(plan.diagnostics);\n\n for (const op of plan.operations) {\n if (op.kind === 'delete-manifest') {\n try {\n await rm(op.path, { force: true });\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n bag.addError('IO_ERROR', `Failed to delete ${op.path}: ${reason}`, { path: op.path, reason });\n this.aggregator.addMany(bag.all());\n return bag.toFailure();\n }\n } else if (plan.nextManifest) {\n const write = await this.store.write(plan.nextManifest);\n if (!write.ok) {\n bag.mergeArray(write.diagnostics);\n return bag.toFailure();\n }\n }\n }\n\n return ok(\n {\n operations: plan.operations,\n diagnostics: bag.all(),\n },\n bag.all(),\n );\n }\n}\n\nfunction resolvePolicy(policy: RegistryToolsOptions['policy']): ResolvedRegistryToolsPolicy {\n return {\n externalRegistries: policy?.externalRegistries ?? 'deny',\n allowedExternalRegistryNames: policy?.allowedExternalRegistryNames ?? [],\n removals: policy?.removals ?? 'deny',\n unknownKeys: policy?.unknownKeys ?? 'warn',\n requireExistingDependencies: policy?.requireExistingDependencies ?? true,\n requireReachableDependencyRanges: policy?.requireReachableDependencyRanges ?? true,\n requireSortedVersions: policy?.requireSortedVersions ?? true,\n };\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"DependencyReachabilityValidator.d.ts","names":[],"sources":["../../src/validation/DependencyReachabilityValidator.ts"],"mappings":";;;;;;;;;;;;;;;cAqBa;mBAEQ;mBACA;mBACA;EAHnB,YACmB,QAAQ,6BACR,OAAO,eACP,YAAY;EAGzB,SACJ,aAAa,aACb,SAAS,gBACT,iBAAiB,kBAChB,QAAQ,OAAO"}
1
+ {"version":3,"file":"DependencyReachabilityValidator.d.ts","names":[],"sources":["../../src/validation/DependencyReachabilityValidator.ts"],"mappings":";;;;;;;;;;;;;;;cAwBa;mBAEQ;mBACA;mBACA;EAHnB,YACmB,QAAQ,6BACR,OAAO,eACP,YAAY;EAGzB,SACJ,aAAa,aACb,SAAS,gBACT,iBAAiB,kBAChB,QAAQ,OAAO"}
@@ -1 +1 @@
1
- {"version":3,"file":"DependencyReachabilityValidator.js","names":[],"sources":["../../src/validation/DependencyReachabilityValidator.ts"],"sourcesContent":["import type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport {\n createRegistryToolsDependencyNotInRegistryDiagnostic,\n createRegistryToolsDependencyRangeUnreachableDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { RegistryDependency, RegistryVersion } from '@uapkg/registry-schema';\nimport { satisfies } from 'semver';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { DependencyValidationReport, ResolvedRegistryToolsPolicy } from '../contracts/RegistryToolsTypes.js';\nimport type { ManifestStore } from '../io/ManifestStore.js';\n\n/**\n * Verifies that the in-registry (non-external) dependencies of a single\n * registry version both **exist** in the registry and have at least one\n * published version that satisfies their declared range.\n *\n * Only `dependencies` are checked. `devDependencies` and `peerDependencies` are\n * intentionally not enforced here (per spec).\n */\nexport class DependencyReachabilityValidator {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async validate(\n packageName: PackageName,\n version: PackageVersion,\n registryVersion: RegistryVersion,\n ): Promise<Result<DependencyValidationReport>> {\n const bag = new DiagnosticBag();\n\n if (!this.policy.requireExistingDependencies && !this.policy.requireReachableDependencyRanges) {\n return bag.toResult({ packageName, version, diagnostics: bag.all() });\n }\n\n const deps = registryVersion.dependencies ?? {};\n\n for (const [dependency, dep] of Object.entries(deps) as [string, RegistryDependency][]) {\n if (dep.registry) continue; // external — not our concern here\n\n const target = await this.store.read(dependency as PackageName);\n\n if (!target.ok) {\n if (this.policy.requireExistingDependencies) {\n const diag = createRegistryToolsDependencyNotInRegistryDiagnostic(packageName, version, dependency);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n continue;\n }\n\n if (!this.policy.requireReachableDependencyRanges) continue;\n\n const available = Object.keys(target.value.versions);\n const matches = available.some((v) => safeSatisfies(v, dep.version));\n if (!matches) {\n const diag = createRegistryToolsDependencyRangeUnreachableDiagnostic(\n packageName,\n version,\n dependency,\n dep.version,\n available,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n\n return bag.toResult({ packageName, version, diagnostics: bag.all() });\n }\n}\n\nfunction safeSatisfies(version: string, range: string): boolean {\n try {\n return satisfies(version, range);\n } catch {\n return false;\n }\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,IAAa,kCAAb,MAA6C;CAExB;CACA;CACA;CAHnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,YACjB;EAHiB;EACA;EACA;CAChB;CAEH,MAAM,SACJ,aACA,SACA,iBAC6C;EAC7C,MAAM,MAAM,IAAI,cAAc;EAE9B,IAAI,CAAC,KAAK,OAAO,+BAA+B,CAAC,KAAK,OAAO,kCAC3D,OAAO,IAAI,SAAS;GAAE;GAAa;GAAS,aAAa,IAAI,IAAI;EAAE,CAAC;EAGtE,MAAM,OAAO,gBAAgB,gBAAgB,CAAC;EAE9C,KAAK,MAAM,CAAC,YAAY,QAAQ,OAAO,QAAQ,IAAI,GAAqC;GACtF,IAAI,IAAI,UAAU;GAElB,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,UAAyB;GAE9D,IAAI,CAAC,OAAO,IAAI;IACd,IAAI,KAAK,OAAO,6BAA6B;KAC3C,MAAM,OAAO,qDAAqD,aAAa,SAAS,UAAU;KAClG,IAAI,IAAI,IAAI;KACZ,KAAK,WAAW,IAAI,IAAI;IAC1B;IACA;GACF;GAEA,IAAI,CAAC,KAAK,OAAO,kCAAkC;GAEnD,MAAM,YAAY,OAAO,KAAK,OAAO,MAAM,QAAQ;GAEnD,IAAI,CADY,UAAU,MAAM,MAAM,cAAc,GAAG,IAAI,OAAO,CACvD,GAAG;IACZ,MAAM,OAAO,wDACX,aACA,SACA,YACA,IAAI,SACJ,SACF;IACA,IAAI,IAAI,IAAI;IACZ,KAAK,WAAW,IAAI,IAAI;GAC1B;EACF;EAEA,OAAO,IAAI,SAAS;GAAE;GAAa;GAAS,aAAa,IAAI,IAAI;EAAE,CAAC;CACtE;AACF;AAEA,SAAS,cAAc,SAAiB,OAAwB;CAC9D,IAAI;EACF,OAAO,UAAU,SAAS,KAAK;CACjC,QAAQ;EACN,OAAO;CACT;AACF"}
1
+ {"version":3,"file":"DependencyReachabilityValidator.js","names":[],"sources":["../../src/validation/DependencyReachabilityValidator.ts"],"sourcesContent":["import type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport {\n createRegistryToolsDependencyNotInRegistryDiagnostic,\n createRegistryToolsDependencyRangeUnreachableDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { RegistryDependency, RegistryVersion } from '@uapkg/registry-schema';\nimport { satisfies } from 'semver';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n DependencyValidationReport,\n ResolvedRegistryToolsPolicy,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport type { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\n\n/**\n * Verifies that the in-registry (non-external) dependencies of a single\n * registry version both **exist** in the registry and have at least one\n * published version that satisfies their declared range.\n *\n * Only `dependencies` are checked. `devDependencies` and `peerDependencies` are\n * intentionally not enforced here (per spec).\n */\nexport class DependencyReachabilityValidator {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly store: ManifestStore,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async validate(\n packageName: PackageName,\n version: PackageVersion,\n registryVersion: RegistryVersion,\n ): Promise<Result<DependencyValidationReport>> {\n const bag = new DiagnosticBag();\n\n if (!this.policy.requireExistingDependencies && !this.policy.requireReachableDependencyRanges) {\n return bag.toResult({ packageName, version, diagnostics: bag.all() });\n }\n\n const deps = registryVersion.dependencies ?? {};\n\n for (const [dependency, dep] of Object.entries(deps) as [string, RegistryDependency][]) {\n if (dep.registry) continue; // external — not our concern here\n\n const target = await this.store.read(dependency as PackageName);\n\n if (!target.ok) {\n if (this.policy.requireExistingDependencies) {\n const diag = createRegistryToolsDependencyNotInRegistryDiagnostic(packageName, version, dependency);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n continue;\n }\n\n if (!this.policy.requireReachableDependencyRanges) continue;\n\n const available = Object.keys(target.value.versions);\n const matches = available.some((v) => safeSatisfies(v, dep.version));\n if (!matches) {\n const diag = createRegistryToolsDependencyRangeUnreachableDiagnostic(\n packageName,\n version,\n dependency,\n dep.version,\n available,\n );\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n\n return bag.toResult({ packageName, version, diagnostics: bag.all() });\n }\n}\n\nfunction safeSatisfies(version: string, range: string): boolean {\n try {\n return satisfies(version, range);\n } catch {\n return false;\n }\n}\n"],"mappings":";;;;;;;;;;;;AAwBA,IAAa,kCAAb,MAA6C;CAExB;CACA;CACA;CAHnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,YACjB;EAHiB;EACA;EACA;CAChB;CAEH,MAAM,SACJ,aACA,SACA,iBAC6C;EAC7C,MAAM,MAAM,IAAI,cAAc;EAE9B,IAAI,CAAC,KAAK,OAAO,+BAA+B,CAAC,KAAK,OAAO,kCAC3D,OAAO,IAAI,SAAS;GAAE;GAAa;GAAS,aAAa,IAAI,IAAI;EAAE,CAAC;EAGtE,MAAM,OAAO,gBAAgB,gBAAgB,CAAC;EAE9C,KAAK,MAAM,CAAC,YAAY,QAAQ,OAAO,QAAQ,IAAI,GAAqC;GACtF,IAAI,IAAI,UAAU;GAElB,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,UAAyB;GAE9D,IAAI,CAAC,OAAO,IAAI;IACd,IAAI,KAAK,OAAO,6BAA6B;KAC3C,MAAM,OAAO,qDAAqD,aAAa,SAAS,UAAU;KAClG,IAAI,IAAI,IAAI;KACZ,KAAK,WAAW,IAAI,IAAI;IAC1B;IACA;GACF;GAEA,IAAI,CAAC,KAAK,OAAO,kCAAkC;GAEnD,MAAM,YAAY,OAAO,KAAK,OAAO,MAAM,QAAQ;GAEnD,IAAI,CADY,UAAU,MAAM,MAAM,cAAc,GAAG,IAAI,OAAO,CACvD,GAAG;IACZ,MAAM,OAAO,wDACX,aACA,SACA,YACA,IAAI,SACJ,SACF;IACA,IAAI,IAAI,IAAI;IACZ,KAAK,WAAW,IAAI,IAAI;GAC1B;EACF;EAEA,OAAO,IAAI,SAAS;GAAE;GAAa;GAAS,aAAa,IAAI,IAAI;EAAE,CAAC;CACtE;AACF;AAEA,SAAS,cAAc,SAAiB,OAAwB;CAC9D,IAAI;EACF,OAAO,UAAU,SAAS,KAAK;CACjC,QAAQ;EACN,OAAO;CACT;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"ExternalRegistryPolicyValidator.d.ts","names":[],"sources":["../../src/validation/ExternalRegistryPolicyValidator.ts"],"mappings":";;;;;;;;;;;;;cAoBa;mBAEQ;mBACA;EAFnB,YACmB,QAAQ,6BACR,YAAY;EAG/B,SAAS,UAAU,0BAA0B,OAAO;UAa5C"}
1
+ {"version":3,"file":"ExternalRegistryPolicyValidator.d.ts","names":[],"sources":["../../src/validation/ExternalRegistryPolicyValidator.ts"],"mappings":";;;;;;;;;;;;;cAuBa;mBAEQ;mBACA;EAFnB,YACmB,QAAQ,6BACR,YAAY;EAG/B,SAAS,UAAU,0BAA0B,OAAO;UAa5C"}
@@ -1 +1 @@
1
- {"version":3,"file":"ExternalRegistryPolicyValidator.js","names":[],"sources":["../../src/validation/ExternalRegistryPolicyValidator.ts"],"sourcesContent":["import {\n createRegistryToolsExternalRegistryDeniedDiagnostic,\n createRegistryToolsExternalRegistryNotAllowedDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { PackageRegistryManifest, RegistryDependency } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { ExternalRegistryPolicyReport, ResolvedRegistryToolsPolicy } from '../contracts/RegistryToolsTypes.js';\n\ntype Bucket = 'dependencies' | 'devDependencies' | 'peerDependencies';\n\n/**\n * Enforces the external-registry policy on every dependency record of every\n * version inside a package manifest.\n *\n * \"External\" means a dependency record whose normalized `registry` field is\n * set. Records without a `registry` field belong to this registry and are\n * intentionally untouched here.\n */\nexport class ExternalRegistryPolicyValidator {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n validate(manifest: PackageRegistryManifest): Result<ExternalRegistryPolicyReport> {\n const bag = new DiagnosticBag();\n\n for (const [version, entry] of Object.entries(manifest.versions)) {\n if (!entry) continue;\n this.checkBucket(bag, manifest.name, version, 'dependencies', entry.dependencies);\n this.checkBucket(bag, manifest.name, version, 'devDependencies', entry.devDependencies);\n this.checkBucket(bag, manifest.name, version, 'peerDependencies', entry.peerDependencies);\n }\n\n return bag.toResult({ diagnostics: bag.all() } satisfies ExternalRegistryPolicyReport);\n }\n\n private checkBucket(\n bag: DiagnosticBag,\n packageName: string,\n version: string,\n bucket: Bucket,\n deps: Record<string, RegistryDependency> | undefined,\n ): void {\n if (!deps) return;\n for (const [dependency, dep] of Object.entries(deps)) {\n const registryName = dep.registry;\n if (!registryName) continue; // in-registry dep, not external\n\n if (this.policy.externalRegistries === 'allow-any') continue;\n\n if (this.policy.externalRegistries === 'deny') {\n const diag = createRegistryToolsExternalRegistryDeniedDiagnostic({\n packageName,\n version,\n dependency,\n registryName,\n bucket,\n });\n bag.add(diag);\n this.aggregator.add(diag);\n continue;\n }\n\n // allow-listed\n if (!this.policy.allowedExternalRegistryNames.includes(registryName)) {\n const diag = createRegistryToolsExternalRegistryNotAllowedDiagnostic({\n packageName,\n version,\n dependency,\n registryName,\n allowList: this.policy.allowedExternalRegistryNames,\n bucket,\n });\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;AAoBA,IAAa,kCAAb,MAA6C;CAExB;CACA;CAFnB,YACE,AAAiB,QACjB,AAAiB,YACjB;EAFiB;EACA;CAChB;CAEH,SAAS,UAAyE;EAChF,MAAM,MAAM,IAAI,cAAc;EAE9B,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,SAAS,QAAQ,GAAG;GAChE,IAAI,CAAC,OAAO;GACZ,KAAK,YAAY,KAAK,SAAS,MAAM,SAAS,gBAAgB,MAAM,YAAY;GAChF,KAAK,YAAY,KAAK,SAAS,MAAM,SAAS,mBAAmB,MAAM,eAAe;GACtF,KAAK,YAAY,KAAK,SAAS,MAAM,SAAS,oBAAoB,MAAM,gBAAgB;EAC1F;EAEA,OAAO,IAAI,SAAS,EAAE,aAAa,IAAI,IAAI,EAAE,CAAwC;CACvF;CAEA,AAAQ,YACN,KACA,aACA,SACA,QACA,MACM;EACN,IAAI,CAAC,MAAM;EACX,KAAK,MAAM,CAAC,YAAY,QAAQ,OAAO,QAAQ,IAAI,GAAG;GACpD,MAAM,eAAe,IAAI;GACzB,IAAI,CAAC,cAAc;GAEnB,IAAI,KAAK,OAAO,uBAAuB,aAAa;GAEpD,IAAI,KAAK,OAAO,uBAAuB,QAAQ;IAC7C,MAAM,OAAO,oDAAoD;KAC/D;KACA;KACA;KACA;KACA;IACF,CAAC;IACD,IAAI,IAAI,IAAI;IACZ,KAAK,WAAW,IAAI,IAAI;IACxB;GACF;GAGA,IAAI,CAAC,KAAK,OAAO,6BAA6B,SAAS,YAAY,GAAG;IACpE,MAAM,OAAO,wDAAwD;KACnE;KACA;KACA;KACA;KACA,WAAW,KAAK,OAAO;KACvB;IACF,CAAC;IACD,IAAI,IAAI,IAAI;IACZ,KAAK,WAAW,IAAI,IAAI;GAC1B;EACF;CACF;AACF"}
1
+ {"version":3,"file":"ExternalRegistryPolicyValidator.js","names":[],"sources":["../../src/validation/ExternalRegistryPolicyValidator.ts"],"sourcesContent":["import {\n createRegistryToolsExternalRegistryDeniedDiagnostic,\n createRegistryToolsExternalRegistryNotAllowedDiagnostic,\n DiagnosticBag,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { PackageRegistryManifest, RegistryDependency } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n ExternalRegistryPolicyReport,\n ResolvedRegistryToolsPolicy,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\n\ntype Bucket = 'dependencies' | 'devDependencies' | 'peerDependencies';\n\n/**\n * Enforces the external-registry policy on every dependency record of every\n * version inside a package manifest.\n *\n * \"External\" means a dependency record whose normalized `registry` field is\n * set. Records without a `registry` field belong to this registry and are\n * intentionally untouched here.\n */\nexport class ExternalRegistryPolicyValidator {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n validate(manifest: PackageRegistryManifest): Result<ExternalRegistryPolicyReport> {\n const bag = new DiagnosticBag();\n\n for (const [version, entry] of Object.entries(manifest.versions)) {\n if (!entry) continue;\n this.checkBucket(bag, manifest.name, version, 'dependencies', entry.dependencies);\n this.checkBucket(bag, manifest.name, version, 'devDependencies', entry.devDependencies);\n this.checkBucket(bag, manifest.name, version, 'peerDependencies', entry.peerDependencies);\n }\n\n return bag.toResult({ diagnostics: bag.all() } satisfies ExternalRegistryPolicyReport);\n }\n\n private checkBucket(\n bag: DiagnosticBag,\n packageName: string,\n version: string,\n bucket: Bucket,\n deps: Record<string, RegistryDependency> | undefined,\n ): void {\n if (!deps) return;\n for (const [dependency, dep] of Object.entries(deps)) {\n const registryName = dep.registry;\n if (!registryName) continue; // in-registry dep, not external\n\n if (this.policy.externalRegistries === 'allow-any') continue;\n\n if (this.policy.externalRegistries === 'deny') {\n const diag = createRegistryToolsExternalRegistryDeniedDiagnostic({\n packageName,\n version,\n dependency,\n registryName,\n bucket,\n });\n bag.add(diag);\n this.aggregator.add(diag);\n continue;\n }\n\n // allow-listed\n if (!this.policy.allowedExternalRegistryNames.includes(registryName)) {\n const diag = createRegistryToolsExternalRegistryNotAllowedDiagnostic({\n packageName,\n version,\n dependency,\n registryName,\n allowList: this.policy.allowedExternalRegistryNames,\n bucket,\n });\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;AAuBA,IAAa,kCAAb,MAA6C;CAExB;CACA;CAFnB,YACE,AAAiB,QACjB,AAAiB,YACjB;EAFiB;EACA;CAChB;CAEH,SAAS,UAAyE;EAChF,MAAM,MAAM,IAAI,cAAc;EAE9B,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,SAAS,QAAQ,GAAG;GAChE,IAAI,CAAC,OAAO;GACZ,KAAK,YAAY,KAAK,SAAS,MAAM,SAAS,gBAAgB,MAAM,YAAY;GAChF,KAAK,YAAY,KAAK,SAAS,MAAM,SAAS,mBAAmB,MAAM,eAAe;GACtF,KAAK,YAAY,KAAK,SAAS,MAAM,SAAS,oBAAoB,MAAM,gBAAgB;EAC1F;EAEA,OAAO,IAAI,SAAS,EAAE,aAAa,IAAI,IAAI,EAAE,CAAwC;CACvF;CAEA,AAAQ,YACN,KACA,aACA,SACA,QACA,MACM;EACN,IAAI,CAAC,MAAM;EACX,KAAK,MAAM,CAAC,YAAY,QAAQ,OAAO,QAAQ,IAAI,GAAG;GACpD,MAAM,eAAe,IAAI;GACzB,IAAI,CAAC,cAAc;GAEnB,IAAI,KAAK,OAAO,uBAAuB,aAAa;GAEpD,IAAI,KAAK,OAAO,uBAAuB,QAAQ;IAC7C,MAAM,OAAO,oDAAoD;KAC/D;KACA;KACA;KACA;KACA;IACF,CAAC;IACD,IAAI,IAAI,IAAI;IACZ,KAAK,WAAW,IAAI,IAAI;IACxB;GACF;GAGA,IAAI,CAAC,KAAK,OAAO,6BAA6B,SAAS,YAAY,GAAG;IACpE,MAAM,OAAO,wDAAwD;KACnE;KACA;KACA;KACA;KACA,WAAW,KAAK,OAAO;KACvB;IACF,CAAC;IACD,IAAI,IAAI,IAAI;IACZ,KAAK,WAAW,IAAI,IAAI;GAC1B;EACF;CACF;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"ManifestValidator.js","names":[],"sources":["../../src/validation/ManifestValidator.ts"],"sourcesContent":["import { createSchemaInvalidDiagnostic, DiagnosticBag, ok, type Result } from '@uapkg/diagnostics';\nimport { type PackageRegistryManifest, PackageRegistryManifestSchema } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\n\n/**\n * Validates raw, untrusted manifest data against the registry schema.\n * This is the trust boundary for any manifest content from disk or callers.\n */\nexport class ManifestValidator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n /** Validate an in-memory candidate manifest. */\n validate(input: unknown, sourceLabel = '<input>'): Result<PackageRegistryManifest> {\n const bag = new DiagnosticBag();\n const result = PackageRegistryManifestSchema.safeParse(input);\n\n if (!result.success) {\n const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);\n const diag = createSchemaInvalidDiagnostic(sourceLabel, issues);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok(result.data, bag.all());\n }\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,oBAAb,MAA+B;CACA;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;;CAGnE,SAAS,OAAgB,cAAc,WAA4C;EACjF,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,SAAS,8BAA8B,UAAU,KAAK;EAE5D,IAAI,CAAC,OAAO,SAAS;GACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS;GACjF,MAAM,OAAO,8BAA8B,aAAa,MAAM;GAC9D,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,OAAO,GAAG,OAAO,MAAM,IAAI,IAAI,CAAC;CAClC;AACF"}
1
+ {"version":3,"file":"ManifestValidator.js","names":[],"sources":["../../src/validation/ManifestValidator.ts"],"sourcesContent":["import { createSchemaInvalidDiagnostic, DiagnosticBag, ok, type Result } from '@uapkg/diagnostics';\nimport { type PackageRegistryManifest, PackageRegistryManifestSchema } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\n\n/**\n * Validates raw, untrusted manifest data against the registry schema.\n * This is the trust boundary for any manifest content from disk or callers.\n */\nexport class ManifestValidator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n /** Validate an in-memory candidate manifest. */\n validate(input: unknown, sourceLabel = '<input>'): Result<PackageRegistryManifest> {\n const bag = new DiagnosticBag();\n const result = PackageRegistryManifestSchema.safeParse(input);\n\n if (!result.success) {\n const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);\n const diag = createSchemaInvalidDiagnostic(sourceLabel, issues);\n bag.add(diag);\n this.aggregator.add(diag);\n return bag.toFailure();\n }\n\n return ok(result.data, bag.all());\n }\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,oBAAb,MAA+B;CACA;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;;CAGnE,SAAS,OAAgB,cAAc,WAA4C;EACjF,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,SAAS,8BAA8B,UAAU,KAAK;EAE5D,IAAI,CAAC,OAAO,SAAS;GACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS;GACjF,MAAM,OAAO,8BAA8B,aAAa,MAAM;GAC9D,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;GACxB,OAAO,IAAI,UAAU;EACvB;EAEA,OAAO,GAAG,OAAO,MAAM,IAAI,IAAI,CAAC;CAClC;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"OfficialRegistryPolicyValidator.js","names":[],"sources":["../../src/validation/OfficialRegistryPolicyValidator.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { safeJsonParse } from '@uapkg/common';\nimport type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport { createRegistryToolsOfficialPolicyViolationDiagnostic, DiagnosticBag, type Result } from '@uapkg/diagnostics';\nimport { BaseManifestSchema } from '@uapkg/package-manifest-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { OfficialPackagePolicyReport } from '../contracts/RegistryToolsTypes.js';\n\nconst UAPKG_MANIFEST = 'uapkg.json';\nconst UAPKG_LOCKFILE = 'uapkg.lock';\n\nexport interface OfficialRegistryPolicyRequest {\n /** Absolute path to the extracted package's root directory. */\n readonly extractedPackageDir: string;\n readonly expectedPackageName: PackageName;\n readonly expectedVersion: PackageVersion;\n}\n\n/**\n * Local-only validator for \"official registry\" rules on an already-extracted\n * package directory.\n *\n * Rules:\n * - `uapkg.json` must exist.\n * - `uapkg.json#name` must match the registry-declared package name.\n * - `uapkg.json#version` must match the registry-declared version.\n * - `uapkg.json#private: true` is rejected.\n * - `uapkg.lock` must not be present.\n * - Dependencies must not target external registries.\n *\n * Never makes network calls. Never checks publish authority.\n */\nexport class OfficialRegistryPolicyValidator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n async validate(request: OfficialRegistryPolicyRequest): Promise<Result<OfficialPackagePolicyReport>> {\n const bag = new DiagnosticBag();\n const dir = request.extractedPackageDir;\n const manifestPath = join(dir, UAPKG_MANIFEST);\n\n if (!existsSync(manifestPath)) {\n this.report(bag, 'manifest-missing', `Missing ${UAPKG_MANIFEST} in extracted package`, manifestPath);\n return bag.toFailure();\n }\n\n const lockPath = join(dir, UAPKG_LOCKFILE);\n if (existsSync(lockPath)) {\n this.report(bag, 'lockfile-forbidden', `${UAPKG_LOCKFILE} must not be packaged`, lockPath);\n }\n\n let raw: string;\n try {\n raw = await readFile(manifestPath, 'utf-8');\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n this.report(bag, 'manifest-unreadable', reason, manifestPath);\n return bag.toFailure();\n }\n\n const parsed = safeJsonParse<unknown>(raw, manifestPath);\n if (!parsed.ok) {\n bag.mergeArray(parsed.diagnostics);\n this.aggregator.addMany(parsed.diagnostics);\n return bag.toFailure();\n }\n\n const validated = BaseManifestSchema.safeParse(parsed.value);\n if (!validated.success) {\n const detail = validated.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');\n this.report(bag, 'manifest-invalid', detail, manifestPath);\n return bag.toFailure();\n }\n\n const manifest = validated.data;\n\n if (manifest.private === true) {\n this.report(bag, 'private-package', '`private: true` packages are not publishable', manifestPath);\n }\n\n if (manifest.name !== request.expectedPackageName) {\n this.report(\n bag,\n 'name-mismatch',\n `manifest name \"${manifest.name}\" does not match registry name \"${request.expectedPackageName}\"`,\n manifestPath,\n );\n }\n\n if (manifest.version !== request.expectedVersion) {\n this.report(\n bag,\n 'version-mismatch',\n `manifest version \"${manifest.version}\" does not match registry version \"${request.expectedVersion}\"`,\n manifestPath,\n );\n }\n\n this.checkExternalDeps(bag, manifest.dependencies, 'dependencies', manifestPath);\n this.checkExternalDeps(bag, manifest.devDependencies, 'devDependencies', manifestPath);\n this.checkExternalDeps(bag, manifest.peerDependencies, 'peerDependencies', manifestPath);\n\n return bag.toResult({ diagnostics: bag.all() });\n }\n\n private checkExternalDeps(\n bag: DiagnosticBag,\n deps: Record<string, { readonly registry?: string }> | undefined,\n bucket: 'dependencies' | 'devDependencies' | 'peerDependencies',\n manifestPath: string,\n ): void {\n if (!deps) return;\n for (const [name, dep] of Object.entries(deps)) {\n if (dep && typeof dep === 'object' && dep.registry) {\n this.report(\n bag,\n 'external-registry-dependency',\n `dependency \"${name}\" in ${bucket} targets external registry \"${dep.registry}\"`,\n manifestPath,\n );\n }\n }\n }\n\n private report(bag: DiagnosticBag, rule: string, detail: string, path?: string): void {\n const diag = createRegistryToolsOfficialPolicyViolationDiagnostic(rule, detail, path);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,iBAAiB;AACvB,MAAM,iBAAiB;;;;;;;;;;;;;;;AAuBvB,IAAa,kCAAb,MAA6C;CACd;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;CAEnE,MAAM,SAAS,SAAsF;EACnG,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,MAAM,QAAQ;EACpB,MAAM,eAAe,KAAK,KAAK,cAAc;EAE7C,IAAI,CAAC,WAAW,YAAY,GAAG;GAC7B,KAAK,OAAO,KAAK,oBAAoB,WAAW,eAAe,wBAAwB,YAAY;GACnG,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,WAAW,KAAK,KAAK,cAAc;EACzC,IAAI,WAAW,QAAQ,GACrB,KAAK,OAAO,KAAK,sBAAsB,GAAG,eAAe,wBAAwB,QAAQ;EAG3F,IAAI;EACJ,IAAI;GACF,MAAM,MAAM,SAAS,cAAc,OAAO;EAC5C,SAAS,KAAK;GACZ,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,KAAK,OAAO,KAAK,uBAAuB,QAAQ,YAAY;GAC5D,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,SAAS,cAAuB,KAAK,YAAY;EACvD,IAAI,CAAC,OAAO,IAAI;GACd,IAAI,WAAW,OAAO,WAAW;GACjC,KAAK,WAAW,QAAQ,OAAO,WAAW;GAC1C,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,YAAY,mBAAmB,UAAU,OAAO,KAAK;EAC3D,IAAI,CAAC,UAAU,SAAS;GACtB,MAAM,SAAS,UAAU,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;GAC/F,KAAK,OAAO,KAAK,oBAAoB,QAAQ,YAAY;GACzD,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,WAAW,UAAU;EAE3B,IAAI,SAAS,YAAY,MACvB,KAAK,OAAO,KAAK,mBAAmB,gDAAgD,YAAY;EAGlG,IAAI,SAAS,SAAS,QAAQ,qBAC5B,KAAK,OACH,KACA,iBACA,kBAAkB,SAAS,KAAK,kCAAkC,QAAQ,oBAAoB,IAC9F,YACF;EAGF,IAAI,SAAS,YAAY,QAAQ,iBAC/B,KAAK,OACH,KACA,oBACA,qBAAqB,SAAS,QAAQ,qCAAqC,QAAQ,gBAAgB,IACnG,YACF;EAGF,KAAK,kBAAkB,KAAK,SAAS,cAAc,gBAAgB,YAAY;EAC/E,KAAK,kBAAkB,KAAK,SAAS,iBAAiB,mBAAmB,YAAY;EACrF,KAAK,kBAAkB,KAAK,SAAS,kBAAkB,oBAAoB,YAAY;EAEvF,OAAO,IAAI,SAAS,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;CAChD;CAEA,AAAQ,kBACN,KACA,MACA,QACA,cACM;EACN,IAAI,CAAC,MAAM;EACX,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI,GAC3C,IAAI,OAAO,OAAO,QAAQ,YAAY,IAAI,UACxC,KAAK,OACH,KACA,gCACA,eAAe,KAAK,OAAO,OAAO,8BAA8B,IAAI,SAAS,IAC7E,YACF;CAGN;CAEA,AAAQ,OAAO,KAAoB,MAAc,QAAgB,MAAqB;EACpF,MAAM,OAAO,qDAAqD,MAAM,QAAQ,IAAI;EACpF,IAAI,IAAI,IAAI;EACZ,KAAK,WAAW,IAAI,IAAI;CAC1B;AACF"}
1
+ {"version":3,"file":"OfficialRegistryPolicyValidator.js","names":[],"sources":["../../src/validation/OfficialRegistryPolicyValidator.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { safeJsonParse } from '@uapkg/common';\nimport type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport { createRegistryToolsOfficialPolicyViolationDiagnostic, DiagnosticBag, type Result } from '@uapkg/diagnostics';\nimport { BaseManifestSchema } from '@uapkg/package-manifest-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type { OfficialPackagePolicyReport } from '#registry-tools/contracts/RegistryToolsTypes.ts';\n\nconst UAPKG_MANIFEST = 'uapkg.json';\nconst UAPKG_LOCKFILE = 'uapkg.lock';\n\nexport interface OfficialRegistryPolicyRequest {\n /** Absolute path to the extracted package's root directory. */\n readonly extractedPackageDir: string;\n readonly expectedPackageName: PackageName;\n readonly expectedVersion: PackageVersion;\n}\n\n/**\n * Local-only validator for \"official registry\" rules on an already-extracted\n * package directory.\n *\n * Rules:\n * - `uapkg.json` must exist.\n * - `uapkg.json#name` must match the registry-declared package name.\n * - `uapkg.json#version` must match the registry-declared version.\n * - `uapkg.json#private: true` is rejected.\n * - `uapkg.lock` must not be present.\n * - Dependencies must not target external registries.\n *\n * Never makes network calls. Never checks publish authority.\n */\nexport class OfficialRegistryPolicyValidator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n async validate(request: OfficialRegistryPolicyRequest): Promise<Result<OfficialPackagePolicyReport>> {\n const bag = new DiagnosticBag();\n const dir = request.extractedPackageDir;\n const manifestPath = join(dir, UAPKG_MANIFEST);\n\n if (!existsSync(manifestPath)) {\n this.report(bag, 'manifest-missing', `Missing ${UAPKG_MANIFEST} in extracted package`, manifestPath);\n return bag.toFailure();\n }\n\n const lockPath = join(dir, UAPKG_LOCKFILE);\n if (existsSync(lockPath)) {\n this.report(bag, 'lockfile-forbidden', `${UAPKG_LOCKFILE} must not be packaged`, lockPath);\n }\n\n let raw: string;\n try {\n raw = await readFile(manifestPath, 'utf-8');\n } catch (err) {\n const reason = err instanceof Error ? err.message : String(err);\n this.report(bag, 'manifest-unreadable', reason, manifestPath);\n return bag.toFailure();\n }\n\n const parsed = safeJsonParse<unknown>(raw, manifestPath);\n if (!parsed.ok) {\n bag.mergeArray(parsed.diagnostics);\n this.aggregator.addMany(parsed.diagnostics);\n return bag.toFailure();\n }\n\n const validated = BaseManifestSchema.safeParse(parsed.value);\n if (!validated.success) {\n const detail = validated.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');\n this.report(bag, 'manifest-invalid', detail, manifestPath);\n return bag.toFailure();\n }\n\n const manifest = validated.data;\n\n if (manifest.private === true) {\n this.report(bag, 'private-package', '`private: true` packages are not publishable', manifestPath);\n }\n\n if (manifest.name !== request.expectedPackageName) {\n this.report(\n bag,\n 'name-mismatch',\n `manifest name \"${manifest.name}\" does not match registry name \"${request.expectedPackageName}\"`,\n manifestPath,\n );\n }\n\n if (manifest.version !== request.expectedVersion) {\n this.report(\n bag,\n 'version-mismatch',\n `manifest version \"${manifest.version}\" does not match registry version \"${request.expectedVersion}\"`,\n manifestPath,\n );\n }\n\n this.checkExternalDeps(bag, manifest.dependencies, 'dependencies', manifestPath);\n this.checkExternalDeps(bag, manifest.devDependencies, 'devDependencies', manifestPath);\n this.checkExternalDeps(bag, manifest.peerDependencies, 'peerDependencies', manifestPath);\n\n return bag.toResult({ diagnostics: bag.all() });\n }\n\n private checkExternalDeps(\n bag: DiagnosticBag,\n deps: Record<string, { readonly registry?: string }> | undefined,\n bucket: 'dependencies' | 'devDependencies' | 'peerDependencies',\n manifestPath: string,\n ): void {\n if (!deps) return;\n for (const [name, dep] of Object.entries(deps)) {\n if (dep && typeof dep === 'object' && dep.registry) {\n this.report(\n bag,\n 'external-registry-dependency',\n `dependency \"${name}\" in ${bucket} targets external registry \"${dep.registry}\"`,\n manifestPath,\n );\n }\n }\n }\n\n private report(bag: DiagnosticBag, rule: string, detail: string, path?: string): void {\n const diag = createRegistryToolsOfficialPolicyViolationDiagnostic(rule, detail, path);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,iBAAiB;AACvB,MAAM,iBAAiB;;;;;;;;;;;;;;;AAuBvB,IAAa,kCAAb,MAA6C;CACd;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;CAEnE,MAAM,SAAS,SAAsF;EACnG,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,MAAM,QAAQ;EACpB,MAAM,eAAe,KAAK,KAAK,cAAc;EAE7C,IAAI,CAAC,WAAW,YAAY,GAAG;GAC7B,KAAK,OAAO,KAAK,oBAAoB,WAAW,eAAe,wBAAwB,YAAY;GACnG,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,WAAW,KAAK,KAAK,cAAc;EACzC,IAAI,WAAW,QAAQ,GACrB,KAAK,OAAO,KAAK,sBAAsB,GAAG,eAAe,wBAAwB,QAAQ;EAG3F,IAAI;EACJ,IAAI;GACF,MAAM,MAAM,SAAS,cAAc,OAAO;EAC5C,SAAS,KAAK;GACZ,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,KAAK,OAAO,KAAK,uBAAuB,QAAQ,YAAY;GAC5D,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,SAAS,cAAuB,KAAK,YAAY;EACvD,IAAI,CAAC,OAAO,IAAI;GACd,IAAI,WAAW,OAAO,WAAW;GACjC,KAAK,WAAW,QAAQ,OAAO,WAAW;GAC1C,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,YAAY,mBAAmB,UAAU,OAAO,KAAK;EAC3D,IAAI,CAAC,UAAU,SAAS;GACtB,MAAM,SAAS,UAAU,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,IAAI;GAC/F,KAAK,OAAO,KAAK,oBAAoB,QAAQ,YAAY;GACzD,OAAO,IAAI,UAAU;EACvB;EAEA,MAAM,WAAW,UAAU;EAE3B,IAAI,SAAS,YAAY,MACvB,KAAK,OAAO,KAAK,mBAAmB,gDAAgD,YAAY;EAGlG,IAAI,SAAS,SAAS,QAAQ,qBAC5B,KAAK,OACH,KACA,iBACA,kBAAkB,SAAS,KAAK,kCAAkC,QAAQ,oBAAoB,IAC9F,YACF;EAGF,IAAI,SAAS,YAAY,QAAQ,iBAC/B,KAAK,OACH,KACA,oBACA,qBAAqB,SAAS,QAAQ,qCAAqC,QAAQ,gBAAgB,IACnG,YACF;EAGF,KAAK,kBAAkB,KAAK,SAAS,cAAc,gBAAgB,YAAY;EAC/E,KAAK,kBAAkB,KAAK,SAAS,iBAAiB,mBAAmB,YAAY;EACrF,KAAK,kBAAkB,KAAK,SAAS,kBAAkB,oBAAoB,YAAY;EAEvF,OAAO,IAAI,SAAS,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;CAChD;CAEA,AAAQ,kBACN,KACA,MACA,QACA,cACM;EACN,IAAI,CAAC,MAAM;EACX,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI,GAC3C,IAAI,OAAO,OAAO,QAAQ,YAAY,IAAI,UACxC,KAAK,OACH,KACA,gCACA,eAAe,KAAK,OAAO,OAAO,8BAA8B,IAAI,SAAS,IAC7E,YACF;CAGN;CAEA,AAAQ,OAAO,KAAoB,MAAc,QAAgB,MAAqB;EACpF,MAAM,OAAO,qDAAqD,MAAM,QAAQ,IAAI;EACpF,IAAI,IAAI,IAAI;EACZ,KAAK,WAAW,IAAI,IAAI;CAC1B;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"RegistryValidator.js","names":["actual"],"sources":["../../src/validation/RegistryValidator.ts"],"sourcesContent":["import type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport {\n createRegistryToolsPathMismatchDiagnostic,\n createRegistryToolsVersionsUnsortedDiagnostic,\n DiagnosticBag,\n ok,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { PackageRegistryManifest } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type {\n PackageValidationReport,\n RegistryValidationReport,\n ResolvedRegistryToolsPolicy,\n} from '../contracts/RegistryToolsTypes.js';\nimport type { ManifestStore } from '../io/ManifestStore.js';\nimport type { PackageLister } from '../listing/PackageLister.js';\nimport { sortVersionsNewestFirst } from '../mutation/VersionSorter.js';\nimport type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';\nimport type { DependencyReachabilityValidator } from './DependencyReachabilityValidator.js';\nimport type { ExternalRegistryPolicyValidator } from './ExternalRegistryPolicyValidator.js';\n\n/**\n * High-level validator that runs every cross-cutting check across one or more\n * packages in the registry. Composes per-concern validators rather than doing\n * the work itself (SRP).\n */\nexport class RegistryValidator {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly lister: PackageLister,\n private readonly externalRegistry: ExternalRegistryPolicyValidator,\n private readonly dependencyReachability: DependencyReachabilityValidator,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async validateRegistry(): Promise<Result<RegistryValidationReport>> {\n const namesResult = await this.lister.listPackageNames();\n if (!namesResult.ok) {\n return namesResult;\n }\n return this.validatePackages(namesResult.value);\n }\n\n async validatePackages(packageNames: readonly PackageName[]): Promise<Result<RegistryValidationReport>> {\n const reports: PackageValidationReport[] = [];\n const overall = new DiagnosticBag();\n\n for (const name of packageNames) {\n const report = await this.validateSinglePackage(name);\n reports.push(report);\n overall.mergeArray(report.diagnostics);\n }\n\n return ok(\n {\n packageReports: reports,\n diagnostics: overall.all(),\n },\n overall.all(),\n );\n }\n\n async validateSinglePackage(packageName: PackageName): Promise<PackageValidationReport> {\n const manifestPath = this.store.resolveManifestPath(packageName);\n const bag = new DiagnosticBag();\n\n const read = await this.store.read(packageName);\n if (!read.ok) {\n bag.mergeArray(read.diagnostics);\n return { packageName, manifestPath, diagnostics: bag.all() };\n }\n\n const manifest = read.value;\n\n // Path/name mismatch\n if (manifest.name !== packageName) {\n const expected = this.paths.manifestPath(manifest.name);\n const actual = manifestPath;\n const diag = createRegistryToolsPathMismatchDiagnostic(packageName, expected, actual);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n\n // Version sort order\n if (this.policy.requireSortedVersions) {\n this.checkVersionsSorted(bag, manifest);\n }\n\n // External registry policy\n const ext = this.externalRegistry.validate(manifest);\n bag.mergeArray(ext.diagnostics);\n\n // Dependency reachability per version\n for (const [version, entry] of Object.entries(manifest.versions)) {\n if (!entry) continue;\n const dep = await this.dependencyReachability.validate(packageName, version as PackageVersion, entry);\n bag.mergeArray(dep.diagnostics);\n }\n\n return { packageName, manifestPath, diagnostics: bag.all() };\n }\n\n private checkVersionsSorted(bag: DiagnosticBag, manifest: PackageRegistryManifest): void {\n const actual = Object.keys(manifest.versions);\n const expected = sortVersionsNewestFirst(actual);\n const isSorted = actual.length === expected.length && actual.every((v, i) => v === expected[i]);\n if (!isSorted) {\n const diag = createRegistryToolsVersionsUnsortedDiagnostic(manifest.name, actual, expected);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n}\n"],"mappings":";;;;;;;;;AA2BA,IAAa,oBAAb,MAA+B;CAEV;CACA;CACA;CACA;CACA;CACA;CACA;CAPnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,OACjB,AAAiB,QACjB,AAAiB,kBACjB,AAAiB,wBACjB,AAAiB,YACjB;EAPiB;EACA;EACA;EACA;EACA;EACA;EACA;CAChB;CAEH,MAAM,mBAA8D;EAClE,MAAM,cAAc,MAAM,KAAK,OAAO,iBAAiB;EACvD,IAAI,CAAC,YAAY,IACf,OAAO;EAET,OAAO,KAAK,iBAAiB,YAAY,KAAK;CAChD;CAEA,MAAM,iBAAiB,cAAiF;EACtG,MAAM,UAAqC,CAAC;EAC5C,MAAM,UAAU,IAAI,cAAc;EAElC,KAAK,MAAM,QAAQ,cAAc;GAC/B,MAAM,SAAS,MAAM,KAAK,sBAAsB,IAAI;GACpD,QAAQ,KAAK,MAAM;GACnB,QAAQ,WAAW,OAAO,WAAW;EACvC;EAEA,OAAO,GACL;GACE,gBAAgB;GAChB,aAAa,QAAQ,IAAI;EAC3B,GACA,QAAQ,IAAI,CACd;CACF;CAEA,MAAM,sBAAsB,aAA4D;EACtF,MAAM,eAAe,KAAK,MAAM,oBAAoB,WAAW;EAC/D,MAAM,MAAM,IAAI,cAAc;EAE9B,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,WAAW;EAC9C,IAAI,CAAC,KAAK,IAAI;GACZ,IAAI,WAAW,KAAK,WAAW;GAC/B,OAAO;IAAE;IAAa;IAAc,aAAa,IAAI,IAAI;GAAE;EAC7D;EAEA,MAAM,WAAW,KAAK;EAGtB,IAAI,SAAS,SAAS,aAAa;GACjC,MAAM,WAAW,KAAK,MAAM,aAAa,SAAS,IAAI;GAEtD,MAAM,OAAO,0CAA0C,aAAa,UAAUA,YAAM;GACpF,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;EAGA,IAAI,KAAK,OAAO,uBACd,KAAK,oBAAoB,KAAK,QAAQ;EAIxC,MAAM,MAAM,KAAK,iBAAiB,SAAS,QAAQ;EACnD,IAAI,WAAW,IAAI,WAAW;EAG9B,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,SAAS,QAAQ,GAAG;GAChE,IAAI,CAAC,OAAO;GACZ,MAAM,MAAM,MAAM,KAAK,uBAAuB,SAAS,aAAa,SAA2B,KAAK;GACpG,IAAI,WAAW,IAAI,WAAW;EAChC;EAEA,OAAO;GAAE;GAAa;GAAc,aAAa,IAAI,IAAI;EAAE;CAC7D;CAEA,AAAQ,oBAAoB,KAAoB,UAAyC;EACvF,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;EAC5C,MAAM,WAAW,wBAAwB,MAAM;EAE/C,IAAI,EADa,OAAO,WAAW,SAAS,UAAU,OAAO,OAAO,GAAG,MAAM,MAAM,SAAS,EAAE,IAC/E;GACb,MAAM,OAAO,8CAA8C,SAAS,MAAM,QAAQ,QAAQ;GAC1F,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;CACF;AACF"}
1
+ {"version":3,"file":"RegistryValidator.js","names":["actual"],"sources":["../../src/validation/RegistryValidator.ts"],"sourcesContent":["import type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport {\n createRegistryToolsPathMismatchDiagnostic,\n createRegistryToolsVersionsUnsortedDiagnostic,\n DiagnosticBag,\n ok,\n type Result,\n} from '@uapkg/diagnostics';\nimport type { PackageRegistryManifest } from '@uapkg/registry-schema';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type {\n PackageValidationReport,\n RegistryValidationReport,\n ResolvedRegistryToolsPolicy,\n} from '#registry-tools/contracts/RegistryToolsTypes.ts';\nimport type { ManifestStore } from '#registry-tools/io/ManifestStore.ts';\nimport type { PackageLister } from '#registry-tools/listing/PackageLister.ts';\nimport { sortVersionsNewestFirst } from '#registry-tools/mutation/VersionSorter.ts';\nimport type { RegistryRepoPaths } from '#registry-tools/paths/RegistryRepoPaths.ts';\nimport type { DependencyReachabilityValidator } from '#registry-tools/validation/DependencyReachabilityValidator.ts';\nimport type { ExternalRegistryPolicyValidator } from '#registry-tools/validation/ExternalRegistryPolicyValidator.ts';\n\n/**\n * High-level validator that runs every cross-cutting check across one or more\n * packages in the registry. Composes per-concern validators rather than doing\n * the work itself (SRP).\n */\nexport class RegistryValidator {\n constructor(\n private readonly policy: ResolvedRegistryToolsPolicy,\n private readonly paths: RegistryRepoPaths,\n private readonly store: ManifestStore,\n private readonly lister: PackageLister,\n private readonly externalRegistry: ExternalRegistryPolicyValidator,\n private readonly dependencyReachability: DependencyReachabilityValidator,\n private readonly aggregator: RegistryToolsAggregator,\n ) {}\n\n async validateRegistry(): Promise<Result<RegistryValidationReport>> {\n const namesResult = await this.lister.listPackageNames();\n if (!namesResult.ok) {\n return namesResult;\n }\n return this.validatePackages(namesResult.value);\n }\n\n async validatePackages(packageNames: readonly PackageName[]): Promise<Result<RegistryValidationReport>> {\n const reports: PackageValidationReport[] = [];\n const overall = new DiagnosticBag();\n\n for (const name of packageNames) {\n const report = await this.validateSinglePackage(name);\n reports.push(report);\n overall.mergeArray(report.diagnostics);\n }\n\n return ok(\n {\n packageReports: reports,\n diagnostics: overall.all(),\n },\n overall.all(),\n );\n }\n\n async validateSinglePackage(packageName: PackageName): Promise<PackageValidationReport> {\n const manifestPath = this.store.resolveManifestPath(packageName);\n const bag = new DiagnosticBag();\n\n const read = await this.store.read(packageName);\n if (!read.ok) {\n bag.mergeArray(read.diagnostics);\n return { packageName, manifestPath, diagnostics: bag.all() };\n }\n\n const manifest = read.value;\n\n // Path/name mismatch\n if (manifest.name !== packageName) {\n const expected = this.paths.manifestPath(manifest.name);\n const actual = manifestPath;\n const diag = createRegistryToolsPathMismatchDiagnostic(packageName, expected, actual);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n\n // Version sort order\n if (this.policy.requireSortedVersions) {\n this.checkVersionsSorted(bag, manifest);\n }\n\n // External registry policy\n const ext = this.externalRegistry.validate(manifest);\n bag.mergeArray(ext.diagnostics);\n\n // Dependency reachability per version\n for (const [version, entry] of Object.entries(manifest.versions)) {\n if (!entry) continue;\n const dep = await this.dependencyReachability.validate(packageName, version as PackageVersion, entry);\n bag.mergeArray(dep.diagnostics);\n }\n\n return { packageName, manifestPath, diagnostics: bag.all() };\n }\n\n private checkVersionsSorted(bag: DiagnosticBag, manifest: PackageRegistryManifest): void {\n const actual = Object.keys(manifest.versions);\n const expected = sortVersionsNewestFirst(actual);\n const isSorted = actual.length === expected.length && actual.every((v, i) => v === expected[i]);\n if (!isSorted) {\n const diag = createRegistryToolsVersionsUnsortedDiagnostic(manifest.name, actual, expected);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n}\n"],"mappings":";;;;;;;;;AA2BA,IAAa,oBAAb,MAA+B;CAEV;CACA;CACA;CACA;CACA;CACA;CACA;CAPnB,YACE,AAAiB,QACjB,AAAiB,OACjB,AAAiB,OACjB,AAAiB,QACjB,AAAiB,kBACjB,AAAiB,wBACjB,AAAiB,YACjB;EAPiB;EACA;EACA;EACA;EACA;EACA;EACA;CAChB;CAEH,MAAM,mBAA8D;EAClE,MAAM,cAAc,MAAM,KAAK,OAAO,iBAAiB;EACvD,IAAI,CAAC,YAAY,IACf,OAAO;EAET,OAAO,KAAK,iBAAiB,YAAY,KAAK;CAChD;CAEA,MAAM,iBAAiB,cAAiF;EACtG,MAAM,UAAqC,CAAC;EAC5C,MAAM,UAAU,IAAI,cAAc;EAElC,KAAK,MAAM,QAAQ,cAAc;GAC/B,MAAM,SAAS,MAAM,KAAK,sBAAsB,IAAI;GACpD,QAAQ,KAAK,MAAM;GACnB,QAAQ,WAAW,OAAO,WAAW;EACvC;EAEA,OAAO,GACL;GACE,gBAAgB;GAChB,aAAa,QAAQ,IAAI;EAC3B,GACA,QAAQ,IAAI,CACd;CACF;CAEA,MAAM,sBAAsB,aAA4D;EACtF,MAAM,eAAe,KAAK,MAAM,oBAAoB,WAAW;EAC/D,MAAM,MAAM,IAAI,cAAc;EAE9B,MAAM,OAAO,MAAM,KAAK,MAAM,KAAK,WAAW;EAC9C,IAAI,CAAC,KAAK,IAAI;GACZ,IAAI,WAAW,KAAK,WAAW;GAC/B,OAAO;IAAE;IAAa;IAAc,aAAa,IAAI,IAAI;GAAE;EAC7D;EAEA,MAAM,WAAW,KAAK;EAGtB,IAAI,SAAS,SAAS,aAAa;GACjC,MAAM,WAAW,KAAK,MAAM,aAAa,SAAS,IAAI;GAEtD,MAAM,OAAO,0CAA0C,aAAa,UAAUA,YAAM;GACpF,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;EAGA,IAAI,KAAK,OAAO,uBACd,KAAK,oBAAoB,KAAK,QAAQ;EAIxC,MAAM,MAAM,KAAK,iBAAiB,SAAS,QAAQ;EACnD,IAAI,WAAW,IAAI,WAAW;EAG9B,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,SAAS,QAAQ,GAAG;GAChE,IAAI,CAAC,OAAO;GACZ,MAAM,MAAM,MAAM,KAAK,uBAAuB,SAAS,aAAa,SAA2B,KAAK;GACpG,IAAI,WAAW,IAAI,WAAW;EAChC;EAEA,OAAO;GAAE;GAAa;GAAc,aAAa,IAAI,IAAI;EAAE;CAC7D;CAEA,AAAQ,oBAAoB,KAAoB,UAAyC;EACvF,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;EAC5C,MAAM,WAAW,wBAAwB,MAAM;EAE/C,IAAI,EADa,OAAO,WAAW,SAAS,UAAU,OAAO,OAAO,GAAG,MAAM,MAAM,SAAS,EAAE,IAC/E;GACb,MAAM,OAAO,8CAA8C,SAAS,MAAM,QAAQ,QAAQ;GAC1F,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;CACF;AACF"}
@@ -1 +1 @@
1
- {"version":3,"file":"ReleaseFileNameValidator.js","names":[],"sources":["../../src/validation/ReleaseFileNameValidator.ts"],"sourcesContent":["import type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport { createRegistryToolsReleaseFileNameInvalidDiagnostic, DiagnosticBag, type Result } from '@uapkg/diagnostics';\nimport type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';\nimport type { ReleaseFileNameReport } from '../contracts/RegistryToolsTypes.js';\n\n/**\n * Validates that release file names follow one of the accepted shapes.\n *\n * Accepted file names for `{packageName}@{version}`:\n * - `package.tgz`\n * - `${packageName}.tgz`\n * - `${packageName}@${version}.tgz`\n */\nexport class ReleaseFileNameValidator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n validate(\n packageName: PackageName,\n version: PackageVersion,\n fileNames: readonly string[],\n ): Result<ReleaseFileNameReport> {\n const bag = new DiagnosticBag();\n const accepted = this.acceptedNames(packageName, version);\n\n for (const name of fileNames) {\n if (!accepted.includes(name)) {\n const diag = createRegistryToolsReleaseFileNameInvalidDiagnostic(packageName, version, name, accepted);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n\n return bag.toResult({ diagnostics: bag.all() });\n }\n\n acceptedNames(packageName: PackageName, version: PackageVersion): readonly string[] {\n return ['package.tgz', `${packageName}.tgz`, `${packageName}@${version}.tgz`];\n }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,2BAAb,MAAsC;CACP;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;CAEnE,SACE,aACA,SACA,WAC+B;EAC/B,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,WAAW,KAAK,cAAc,aAAa,OAAO;EAExD,KAAK,MAAM,QAAQ,WACjB,IAAI,CAAC,SAAS,SAAS,IAAI,GAAG;GAC5B,MAAM,OAAO,oDAAoD,aAAa,SAAS,MAAM,QAAQ;GACrG,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;EAGF,OAAO,IAAI,SAAS,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;CAChD;CAEA,cAAc,aAA0B,SAA4C;EAClF,OAAO;GAAC;GAAe,GAAG,YAAY;GAAO,GAAG,YAAY,GAAG,QAAQ;EAAK;CAC9E;AACF"}
1
+ {"version":3,"file":"ReleaseFileNameValidator.js","names":[],"sources":["../../src/validation/ReleaseFileNameValidator.ts"],"sourcesContent":["import type { PackageName, PackageVersion } from '@uapkg/common-schema';\nimport { createRegistryToolsReleaseFileNameInvalidDiagnostic, DiagnosticBag, type Result } from '@uapkg/diagnostics';\nimport type { RegistryToolsAggregator } from '#registry-tools/aggregator/RegistryToolsAggregator.ts';\nimport type { ReleaseFileNameReport } from '#registry-tools/contracts/RegistryToolsTypes.ts';\n\n/**\n * Validates that release file names follow one of the accepted shapes.\n *\n * Accepted file names for `{packageName}@{version}`:\n * - `package.tgz`\n * - `${packageName}.tgz`\n * - `${packageName}@${version}.tgz`\n */\nexport class ReleaseFileNameValidator {\n constructor(private readonly aggregator: RegistryToolsAggregator) {}\n\n validate(\n packageName: PackageName,\n version: PackageVersion,\n fileNames: readonly string[],\n ): Result<ReleaseFileNameReport> {\n const bag = new DiagnosticBag();\n const accepted = this.acceptedNames(packageName, version);\n\n for (const name of fileNames) {\n if (!accepted.includes(name)) {\n const diag = createRegistryToolsReleaseFileNameInvalidDiagnostic(packageName, version, name, accepted);\n bag.add(diag);\n this.aggregator.add(diag);\n }\n }\n\n return bag.toResult({ diagnostics: bag.all() });\n }\n\n acceptedNames(packageName: PackageName, version: PackageVersion): readonly string[] {\n return ['package.tgz', `${packageName}.tgz`, `${packageName}@${version}.tgz`];\n }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,2BAAb,MAAsC;CACP;CAA7B,YAAY,AAAiB,YAAqC;EAArC;CAAsC;CAEnE,SACE,aACA,SACA,WAC+B;EAC/B,MAAM,MAAM,IAAI,cAAc;EAC9B,MAAM,WAAW,KAAK,cAAc,aAAa,OAAO;EAExD,KAAK,MAAM,QAAQ,WACjB,IAAI,CAAC,SAAS,SAAS,IAAI,GAAG;GAC5B,MAAM,OAAO,oDAAoD,aAAa,SAAS,MAAM,QAAQ;GACrG,IAAI,IAAI,IAAI;GACZ,KAAK,WAAW,IAAI,IAAI;EAC1B;EAGF,OAAO,IAAI,SAAS,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;CAChD;CAEA,cAAc,aAA0B,SAA4C;EAClF,OAAO;GAAC;GAAe,GAAG,YAAY;GAAO,GAAG,YAAY,GAAG,QAAQ;EAAK;CAC9E;AACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@uapkg/registry-tools",
3
- "version": "1.3.1",
3
+ "version": "1.4.0",
4
4
  "engines": {
5
5
  "node": ">=22"
6
6
  },
@@ -25,15 +25,22 @@
25
25
  "dependencies": {
26
26
  "semver": "7.7.1",
27
27
  "zod": "4.3.6",
28
- "@uapkg/common": "^1.3.1",
29
- "@uapkg/common-schema": "^1.3.1",
30
- "@uapkg/diagnostics": "^1.3.1",
31
- "@uapkg/package-manifest-schema": "^1.3.1",
32
- "@uapkg/registry-schema": "^1.3.1"
28
+ "@uapkg/common": "^1.4.0",
29
+ "@uapkg/diagnostics": "^1.4.0",
30
+ "@uapkg/common-schema": "^1.4.0",
31
+ "@uapkg/registry-schema": "^1.4.0",
32
+ "@uapkg/package-manifest-schema": "^1.4.0"
33
33
  },
34
34
  "devDependencies": {
35
35
  "@types/semver": "7.7.0"
36
36
  },
37
+ "imports": {
38
+ "#registry-tools/*.ts": {
39
+ "uapkg-source": "./src/*.ts",
40
+ "types": "./dist/*.d.ts",
41
+ "default": "./dist/*.js"
42
+ }
43
+ },
37
44
  "scripts": {
38
45
  "build": "vp pack",
39
46
  "build:watch": "vp pack --watch"