@uapkg/registry-tools 1.3.0 → 1.3.2

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.
Files changed (73) hide show
  1. package/dist/aggregator/RegistryToolsAggregator.d.ts +31 -28
  2. package/dist/aggregator/RegistryToolsAggregator.d.ts.map +1 -1
  3. package/dist/aggregator/RegistryToolsAggregator.js +71 -73
  4. package/dist/aggregator/RegistryToolsAggregator.js.map +1 -1
  5. package/dist/contracts/RegistryToolsTypes.d.ts +101 -98
  6. package/dist/contracts/RegistryToolsTypes.d.ts.map +1 -1
  7. package/dist/contracts/RegistryToolsTypes.js +5 -4
  8. package/dist/contracts/RegistryToolsTypes.js.map +1 -1
  9. package/dist/index.d.ts +18 -18
  10. package/dist/index.js +18 -30
  11. package/dist/io/IntegrityCalculator.d.ts +16 -13
  12. package/dist/io/IntegrityCalculator.d.ts.map +1 -1
  13. package/dist/io/IntegrityCalculator.js +96 -92
  14. package/dist/io/IntegrityCalculator.js.map +1 -1
  15. package/dist/io/ManifestStore.d.ts +31 -28
  16. package/dist/io/ManifestStore.d.ts.map +1 -1
  17. package/dist/io/ManifestStore.js +127 -124
  18. package/dist/io/ManifestStore.js.map +1 -1
  19. package/dist/listing/PackageLister.d.ts +18 -15
  20. package/dist/listing/PackageLister.d.ts.map +1 -1
  21. package/dist/listing/PackageLister.js +75 -77
  22. package/dist/listing/PackageLister.js.map +1 -1
  23. package/dist/mutation/AddPackageVersionPlanner.d.ts +18 -15
  24. package/dist/mutation/AddPackageVersionPlanner.d.ts.map +1 -1
  25. package/dist/mutation/AddPackageVersionPlanner.js +110 -117
  26. package/dist/mutation/AddPackageVersionPlanner.js.map +1 -1
  27. package/dist/mutation/RemovePackagePlanner.d.ts +15 -12
  28. package/dist/mutation/RemovePackagePlanner.d.ts.map +1 -1
  29. package/dist/mutation/RemovePackagePlanner.js +45 -37
  30. package/dist/mutation/RemovePackagePlanner.js.map +1 -1
  31. package/dist/mutation/RemovePackageVersionPlanner.d.ts +15 -12
  32. package/dist/mutation/RemovePackageVersionPlanner.d.ts.map +1 -1
  33. package/dist/mutation/RemovePackageVersionPlanner.js +60 -52
  34. package/dist/mutation/RemovePackageVersionPlanner.js.map +1 -1
  35. package/dist/mutation/VersionSorter.d.ts +4 -1
  36. package/dist/mutation/VersionSorter.d.ts.map +1 -1
  37. package/dist/mutation/VersionSorter.js +24 -24
  38. package/dist/mutation/VersionSorter.js.map +1 -1
  39. package/dist/paths/RegistryRepoPaths.d.ts +15 -12
  40. package/dist/paths/RegistryRepoPaths.d.ts.map +1 -1
  41. package/dist/paths/RegistryRepoPaths.js +38 -33
  42. package/dist/paths/RegistryRepoPaths.js.map +1 -1
  43. package/dist/tools/RegistryTools.d.ts +53 -50
  44. package/dist/tools/RegistryTools.d.ts.map +1 -1
  45. package/dist/tools/RegistryTools.js +205 -220
  46. package/dist/tools/RegistryTools.js.map +1 -1
  47. package/dist/validation/DependencyReachabilityValidator.d.ts +15 -12
  48. package/dist/validation/DependencyReachabilityValidator.d.ts.map +1 -1
  49. package/dist/validation/DependencyReachabilityValidator.js +62 -55
  50. package/dist/validation/DependencyReachabilityValidator.js.map +1 -1
  51. package/dist/validation/ExternalRegistryPolicyValidator.d.ts +13 -10
  52. package/dist/validation/ExternalRegistryPolicyValidator.d.ts.map +1 -1
  53. package/dist/validation/ExternalRegistryPolicyValidator.js +63 -63
  54. package/dist/validation/ExternalRegistryPolicyValidator.js.map +1 -1
  55. package/dist/validation/ManifestValidator.d.ts +11 -8
  56. package/dist/validation/ManifestValidator.d.ts.map +1 -1
  57. package/dist/validation/ManifestValidator.js +29 -24
  58. package/dist/validation/ManifestValidator.js.map +1 -1
  59. package/dist/validation/OfficialRegistryPolicyValidator.d.ts +18 -15
  60. package/dist/validation/OfficialRegistryPolicyValidator.d.ts.map +1 -1
  61. package/dist/validation/OfficialRegistryPolicyValidator.js +80 -89
  62. package/dist/validation/OfficialRegistryPolicyValidator.js.map +1 -1
  63. package/dist/validation/RegistryValidator.d.ts +25 -22
  64. package/dist/validation/RegistryValidator.d.ts.map +1 -1
  65. package/dist/validation/RegistryValidator.js +89 -87
  66. package/dist/validation/RegistryValidator.js.map +1 -1
  67. package/dist/validation/ReleaseFileNameValidator.d.ts +12 -9
  68. package/dist/validation/ReleaseFileNameValidator.d.ts.map +1 -1
  69. package/dist/validation/ReleaseFileNameValidator.js +36 -29
  70. package/dist/validation/ReleaseFileNameValidator.js.map +1 -1
  71. package/package.json +19 -21
  72. package/dist/index.d.ts.map +0 -1
  73. package/dist/index.js.map +0 -1
@@ -1,8 +1,9 @@
1
- import type { PackageName, PackageVersion } from '@uapkg/common-schema';
2
- import { type Result } from '@uapkg/diagnostics';
3
- import type { Integrity, PackageRegistryManifest } from '@uapkg/registry-schema';
4
- import type { AddPackageVersionRequest, ChangedManifestValidation, DependencyValidationReport, ExternalRegistryPolicyReport, IntegrityAlgorithm, IntegrityVerificationResult, OfficialPackagePolicyReport, PackageSummary, RegistryLintReport, RegistryMutationPlan, RegistryMutationSummary, RegistryToolsOptions, RegistryValidationReport, ReleaseFileNameReport, RemovePackageRequest, RemovePackageVersionRequest, WriteManifestResult } from '../contracts/RegistryToolsTypes.js';
5
- import { type OfficialRegistryPolicyRequest } from '../validation/OfficialRegistryPolicyValidator.js';
1
+ import { AddPackageVersionRequest, ChangedManifestValidation, DependencyValidationReport, ExternalRegistryPolicyReport, IntegrityAlgorithm, IntegrityVerificationResult, OfficialPackagePolicyReport, PackageSummary, RegistryLintReport, RegistryMutationPlan, RegistryMutationSummary, RegistryToolsOptions, RegistryValidationReport, ReleaseFileNameReport, RemovePackageRequest, RemovePackageVersionRequest, WriteManifestResult } from "../contracts/RegistryToolsTypes.js";
2
+ import { OfficialRegistryPolicyRequest } from "../validation/OfficialRegistryPolicyValidator.js";
3
+ import { Result } from "@uapkg/diagnostics";
4
+ import { Integrity, PackageRegistryManifest } from "@uapkg/registry-schema";
5
+ import { PackageName, PackageVersion } from "@uapkg/common-schema";
6
+ //#region src/tools/RegistryTools.d.ts
6
7
  /**
7
8
  * Programmatic toolkit for registry-owner workflows over a uapkg registry repo.
8
9
  *
@@ -13,50 +14,52 @@ import { type OfficialRegistryPolicyRequest } from '../validation/OfficialRegist
13
14
  * The `cwd` constructor option is the **registry repo root**, never a package
14
15
  * directory inside it.
15
16
  */
16
- export declare class RegistryTools {
17
- private readonly policy;
18
- private readonly paths;
19
- private readonly aggregator;
20
- private readonly store;
21
- private readonly manifestValidator;
22
- private readonly externalRegistry;
23
- private readonly dependencyReachability;
24
- private readonly releaseFileNames;
25
- private readonly officialPolicy;
26
- private readonly integrity;
27
- private readonly lister;
28
- private readonly registryValidator;
29
- private readonly addPlanner;
30
- private readonly removeVersionPlanner;
31
- private readonly removePackagePlanner;
32
- constructor(options: RegistryToolsOptions);
33
- getManifestPath(packageName: PackageName): Result<string>;
34
- readPackageManifest(packageName: PackageName): Promise<Result<PackageRegistryManifest>>;
35
- writePackageManifest(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>>;
36
- packageExists(packageName: PackageName): Result<boolean>;
37
- listPackages(): Promise<Result<PackageSummary[]>>;
38
- listVersions(packageName: PackageName): Promise<Result<PackageVersion[]>>;
39
- validatePackageManifest(manifest: unknown): Result<PackageRegistryManifest>;
40
- validateManifestFile(path: string): Promise<Result<PackageRegistryManifest>>;
41
- validateRegistry(): Promise<Result<RegistryValidationReport>>;
42
- validatePackages(packageNames: readonly PackageName[]): Promise<Result<RegistryValidationReport>>;
43
- validateChangedManifestFiles(paths: readonly string[]): Promise<Result<ChangedManifestValidation>>;
44
- validateDependencyReachability(packageName: PackageName, version: PackageVersion): Promise<Result<DependencyValidationReport>>;
45
- validateExternalRegistryPolicy(manifest: PackageRegistryManifest): Result<ExternalRegistryPolicyReport>;
46
- validateReleaseFileNames(packageName: PackageName, version: PackageVersion, fileNames: readonly string[]): Result<ReleaseFileNameReport>;
47
- validateOfficialRegistryPolicy(request: OfficialRegistryPolicyRequest): Promise<Result<OfficialPackagePolicyReport>>;
48
- /** Run lint-style checks across the whole registry. Currently equivalent to a full validation. */
49
- lintRegistry(): Promise<Result<RegistryLintReport>>;
50
- /** Lint a single in-memory manifest. */
51
- lintPackageManifest(manifest: PackageRegistryManifest): Result<RegistryLintReport>;
52
- planAddPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationPlan>>;
53
- addPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationSummary>>;
54
- planRemovePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationPlan>>;
55
- removePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationSummary>>;
56
- planRemovePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationPlan>>;
57
- removePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationSummary>>;
58
- computeFileIntegrity(filePath: string, algorithm?: IntegrityAlgorithm): Promise<Result<Integrity>>;
59
- verifyFileIntegrity(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>>;
60
- private applyPlan;
17
+ declare class RegistryTools {
18
+ private readonly policy;
19
+ private readonly paths;
20
+ private readonly aggregator;
21
+ private readonly store;
22
+ private readonly manifestValidator;
23
+ private readonly externalRegistry;
24
+ private readonly dependencyReachability;
25
+ private readonly releaseFileNames;
26
+ private readonly officialPolicy;
27
+ private readonly integrity;
28
+ private readonly lister;
29
+ private readonly registryValidator;
30
+ private readonly addPlanner;
31
+ private readonly removeVersionPlanner;
32
+ private readonly removePackagePlanner;
33
+ constructor(options: RegistryToolsOptions);
34
+ getManifestPath(packageName: PackageName): Result<string>;
35
+ readPackageManifest(packageName: PackageName): Promise<Result<PackageRegistryManifest>>;
36
+ writePackageManifest(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>>;
37
+ packageExists(packageName: PackageName): Result<boolean>;
38
+ listPackages(): Promise<Result<PackageSummary[]>>;
39
+ listVersions(packageName: PackageName): Promise<Result<PackageVersion[]>>;
40
+ validatePackageManifest(manifest: unknown): Result<PackageRegistryManifest>;
41
+ validateManifestFile(path: string): Promise<Result<PackageRegistryManifest>>;
42
+ validateRegistry(): Promise<Result<RegistryValidationReport>>;
43
+ validatePackages(packageNames: readonly PackageName[]): Promise<Result<RegistryValidationReport>>;
44
+ validateChangedManifestFiles(paths: readonly string[]): Promise<Result<ChangedManifestValidation>>;
45
+ validateDependencyReachability(packageName: PackageName, version: PackageVersion): Promise<Result<DependencyValidationReport>>;
46
+ validateExternalRegistryPolicy(manifest: PackageRegistryManifest): Result<ExternalRegistryPolicyReport>;
47
+ validateReleaseFileNames(packageName: PackageName, version: PackageVersion, fileNames: readonly string[]): Result<ReleaseFileNameReport>;
48
+ validateOfficialRegistryPolicy(request: OfficialRegistryPolicyRequest): Promise<Result<OfficialPackagePolicyReport>>;
49
+ /** Run lint-style checks across the whole registry. Currently equivalent to a full validation. */
50
+ lintRegistry(): Promise<Result<RegistryLintReport>>;
51
+ /** Lint a single in-memory manifest. */
52
+ lintPackageManifest(manifest: PackageRegistryManifest): Result<RegistryLintReport>;
53
+ planAddPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationPlan>>;
54
+ addPackageVersion(request: AddPackageVersionRequest): Promise<Result<RegistryMutationSummary>>;
55
+ planRemovePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationPlan>>;
56
+ removePackageVersion(request: RemovePackageVersionRequest): Promise<Result<RegistryMutationSummary>>;
57
+ planRemovePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationPlan>>;
58
+ removePackage(request: RemovePackageRequest): Promise<Result<RegistryMutationSummary>>;
59
+ computeFileIntegrity(filePath: string, algorithm?: IntegrityAlgorithm): Promise<Result<Integrity>>;
60
+ verifyFileIntegrity(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>>;
61
+ private applyPlan;
61
62
  }
63
+ //#endregion
64
+ export { RegistryTools };
62
65
  //# sourceMappingURL=RegistryTools.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"RegistryTools.d.ts","sourceRoot":"","sources":["../../src/tools/RegistryTools.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"RegistryTools.d.ts","names":[],"sources":["../../src/tools/RegistryTools.ts"],"mappings":";;;;;;;;;;;;;;;;cAoDa;mBACM;mBACA;mBACA;mBAEA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;EAEjB,YAAY,SAAS;EAsCrB,gBAAgB,aAAa,cAAc;EAI3C,oBAAoB,aAAa,cAAc,QAAQ,OAAO;EAI9D,qBAAqB,UAAU,0BAA0B,QAAQ,OAAO;EAIxE,cAAc,aAAa,cAAc;EAIzC,gBAAgB,QAAQ,OAAO;EAIzB,aAAa,aAAa,cAAc,QAAQ,OAAO;EAU7D,wBAAwB,oBAAoB,OAAO;EAInD,qBAAqB,eAAe,QAAQ,OAAO;EAInD,oBAAoB,QAAQ,OAAO;EAInC,iBAAiB,uBAAuB,gBAAgB,QAAQ,OAAO;EAIjE,6BAA6B,2BAA2B,QAAQ,OAAO;EAWvE,+BACJ,aAAa,aACb,SAAS,iBACR,QAAQ,OAAO;EAYlB,+BAA+B,UAAU,0BAA0B,OAAO;EAI1E,yBACE,aAAa,aACb,SAAS,gBACT,+BACC,OAAO;EAIV,+BAA+B,SAAS,gCAAgC,QAAQ,OAAO;;EAKjF,gBAAgB,QAAQ,OAAO;;EAOrC,oBAAoB,UAAU,0BAA0B,OAAO;EAS/D,sBAAsB,SAAS,2BAA2B,QAAQ,OAAO;EAInE,kBAAkB,SAAS,2BAA2B,QAAQ,OAAO;EAM3E,yBAAyB,SAAS,8BAA8B,QAAQ,OAAO;EAIzE,qBAAqB,SAAS,8BAA8B,QAAQ,OAAO;EAMjF,kBAAkB,SAAS,uBAAuB,QAAQ,OAAO;EAI3D,cAAc,SAAS,uBAAuB,QAAQ,OAAO;EAUnE,qBAAqB,kBAAkB,YAAY,qBAAqB,QAAQ,OAAO;EAIvF,oBAAoB,kBAAkB,UAAU,YAAY,QAAQ,OAAO;UAQ7D"}
@@ -1,224 +1,209 @@
1
- import { rm } from 'node:fs/promises';
2
- import { DiagnosticBag, fail, ok } from '@uapkg/diagnostics';
3
- import { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';
4
- import { IntegrityCalculator } from '../io/IntegrityCalculator.js';
5
- import { ManifestStore } from '../io/ManifestStore.js';
6
- import { PackageLister } from '../listing/PackageLister.js';
7
- import { AddPackageVersionPlanner } from '../mutation/AddPackageVersionPlanner.js';
8
- import { RemovePackagePlanner } from '../mutation/RemovePackagePlanner.js';
9
- import { RemovePackageVersionPlanner } from '../mutation/RemovePackageVersionPlanner.js';
10
- import { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';
11
- import { DependencyReachabilityValidator } from '../validation/DependencyReachabilityValidator.js';
12
- import { ExternalRegistryPolicyValidator } from '../validation/ExternalRegistryPolicyValidator.js';
13
- import { ManifestValidator } from '../validation/ManifestValidator.js';
14
- import { OfficialRegistryPolicyValidator, } from '../validation/OfficialRegistryPolicyValidator.js';
15
- import { RegistryValidator } from '../validation/RegistryValidator.js';
16
- import { ReleaseFileNameValidator } from '../validation/ReleaseFileNameValidator.js';
1
+ import { RegistryToolsAggregator } from "../aggregator/RegistryToolsAggregator.js";
2
+ import { IntegrityCalculator } from "../io/IntegrityCalculator.js";
3
+ import { ManifestStore } from "../io/ManifestStore.js";
4
+ import { PackageLister } from "../listing/PackageLister.js";
5
+ import { AddPackageVersionPlanner } from "../mutation/AddPackageVersionPlanner.js";
6
+ import { RemovePackagePlanner } from "../mutation/RemovePackagePlanner.js";
7
+ import { RemovePackageVersionPlanner } from "../mutation/RemovePackageVersionPlanner.js";
8
+ import { RegistryRepoPaths } from "../paths/RegistryRepoPaths.js";
9
+ import { DependencyReachabilityValidator } from "../validation/DependencyReachabilityValidator.js";
10
+ import { ExternalRegistryPolicyValidator } from "../validation/ExternalRegistryPolicyValidator.js";
11
+ import { ManifestValidator } from "../validation/ManifestValidator.js";
12
+ import { OfficialRegistryPolicyValidator } from "../validation/OfficialRegistryPolicyValidator.js";
13
+ import { RegistryValidator } from "../validation/RegistryValidator.js";
14
+ import { ReleaseFileNameValidator } from "../validation/ReleaseFileNameValidator.js";
15
+ import { DiagnosticBag, fail, ok } from "@uapkg/diagnostics";
16
+ import { rm } from "node:fs/promises";
17
+
18
+ //#region src/tools/RegistryTools.ts
17
19
  /**
18
- * Programmatic toolkit for registry-owner workflows over a uapkg registry repo.
19
- *
20
- * Always returns `Result<T>`. Never throws for expected failures. Diagnostics
21
- * are also pushed into a process-wide singleton aggregator (with `once`
22
- * deduplication) so a CI run can surface a single consolidated list.
23
- *
24
- * The `cwd` constructor option is the **registry repo root**, never a package
25
- * directory inside it.
26
- */
27
- export class RegistryTools {
28
- policy;
29
- paths;
30
- aggregator;
31
- store;
32
- manifestValidator;
33
- externalRegistry;
34
- dependencyReachability;
35
- releaseFileNames;
36
- officialPolicy;
37
- integrity;
38
- lister;
39
- registryValidator;
40
- addPlanner;
41
- removeVersionPlanner;
42
- removePackagePlanner;
43
- constructor(options) {
44
- this.policy = resolvePolicy(options.policy);
45
- this.paths = new RegistryRepoPaths(options.cwd);
46
- this.aggregator = RegistryToolsAggregator.getInstance();
47
- this.store = new ManifestStore(this.paths, this.aggregator);
48
- this.manifestValidator = new ManifestValidator(this.aggregator);
49
- this.externalRegistry = new ExternalRegistryPolicyValidator(this.policy, this.aggregator);
50
- this.dependencyReachability = new DependencyReachabilityValidator(this.policy, this.store, this.aggregator);
51
- this.releaseFileNames = new ReleaseFileNameValidator(this.aggregator);
52
- this.officialPolicy = new OfficialRegistryPolicyValidator(this.aggregator);
53
- this.integrity = new IntegrityCalculator(this.aggregator);
54
- this.lister = new PackageLister(this.paths, this.store, this.aggregator);
55
- this.registryValidator = new RegistryValidator(this.policy, this.paths, this.store, this.lister, this.externalRegistry, this.dependencyReachability, this.aggregator);
56
- this.addPlanner = new AddPackageVersionPlanner(this.policy, this.paths, this.store, this.externalRegistry, this.dependencyReachability, this.aggregator);
57
- this.removeVersionPlanner = new RemovePackageVersionPlanner(this.policy, this.paths, this.store, this.aggregator);
58
- this.removePackagePlanner = new RemovePackagePlanner(this.policy, this.paths, this.store, this.aggregator);
59
- }
60
- // ---------------------------------------------------------------------
61
- // Read / list
62
- // ---------------------------------------------------------------------
63
- getManifestPath(packageName) {
64
- return ok(this.paths.manifestPath(packageName));
65
- }
66
- readPackageManifest(packageName) {
67
- return this.store.read(packageName);
68
- }
69
- writePackageManifest(manifest) {
70
- return this.store.write(manifest);
71
- }
72
- packageExists(packageName) {
73
- return ok(this.store.exists(packageName));
74
- }
75
- listPackages() {
76
- return this.lister.listSummaries();
77
- }
78
- async listVersions(packageName) {
79
- const read = await this.store.read(packageName);
80
- if (!read.ok)
81
- return read;
82
- return ok(Object.keys(read.value.versions), read.diagnostics);
83
- }
84
- // ---------------------------------------------------------------------
85
- // Validation / lint
86
- // ---------------------------------------------------------------------
87
- validatePackageManifest(manifest) {
88
- return this.manifestValidator.validate(manifest);
89
- }
90
- validateManifestFile(path) {
91
- return this.store.readFromPath(path);
92
- }
93
- validateRegistry() {
94
- return this.registryValidator.validateRegistry();
95
- }
96
- validatePackages(packageNames) {
97
- return this.registryValidator.validatePackages(packageNames);
98
- }
99
- async validateChangedManifestFiles(paths) {
100
- const perFile = [];
101
- const overall = new DiagnosticBag();
102
- for (const path of paths) {
103
- const r = await this.store.readFromPath(path);
104
- perFile.push({ path, diagnostics: r.diagnostics });
105
- overall.mergeArray(r.diagnostics);
106
- }
107
- return ok({ perFile }, overall.all());
108
- }
109
- async validateDependencyReachability(packageName, version) {
110
- const read = await this.store.read(packageName);
111
- if (!read.ok)
112
- return read;
113
- const entry = read.value.versions[version];
114
- if (!entry) {
115
- const bag = new DiagnosticBag();
116
- bag.mergeArray(read.diagnostics);
117
- return fail(bag.all());
118
- }
119
- return this.dependencyReachability.validate(packageName, version, entry);
120
- }
121
- validateExternalRegistryPolicy(manifest) {
122
- return this.externalRegistry.validate(manifest);
123
- }
124
- validateReleaseFileNames(packageName, version, fileNames) {
125
- return this.releaseFileNames.validate(packageName, version, fileNames);
126
- }
127
- validateOfficialRegistryPolicy(request) {
128
- return this.officialPolicy.validate(request);
129
- }
130
- /** Run lint-style checks across the whole registry. Currently equivalent to a full validation. */
131
- async lintRegistry() {
132
- const r = await this.registryValidator.validateRegistry();
133
- if (!r.ok)
134
- return r;
135
- return ok({ diagnostics: r.value.diagnostics }, r.diagnostics);
136
- }
137
- /** Lint a single in-memory manifest. */
138
- lintPackageManifest(manifest) {
139
- const ext = this.externalRegistry.validate(manifest);
140
- return ok({ diagnostics: ext.diagnostics }, ext.diagnostics);
141
- }
142
- // ---------------------------------------------------------------------
143
- // Mutation
144
- // ---------------------------------------------------------------------
145
- planAddPackageVersion(request) {
146
- return this.addPlanner.plan(request);
147
- }
148
- async addPackageVersion(request) {
149
- const plan = await this.addPlanner.plan(request);
150
- if (!plan.ok)
151
- return plan;
152
- return this.applyPlan(plan.value);
153
- }
154
- planRemovePackageVersion(request) {
155
- return this.removeVersionPlanner.plan(request);
156
- }
157
- async removePackageVersion(request) {
158
- const plan = await this.removeVersionPlanner.plan(request);
159
- if (!plan.ok)
160
- return plan;
161
- return this.applyPlan(plan.value);
162
- }
163
- planRemovePackage(request) {
164
- return this.removePackagePlanner.plan(request);
165
- }
166
- async removePackage(request) {
167
- const plan = await this.removePackagePlanner.plan(request);
168
- if (!plan.ok)
169
- return plan;
170
- return this.applyPlan(plan.value);
171
- }
172
- // ---------------------------------------------------------------------
173
- // Integrity
174
- // ---------------------------------------------------------------------
175
- computeFileIntegrity(filePath, algorithm) {
176
- return this.integrity.compute(filePath, algorithm);
177
- }
178
- verifyFileIntegrity(filePath, expected) {
179
- return this.integrity.verify(filePath, expected);
180
- }
181
- // ---------------------------------------------------------------------
182
- // Internals
183
- // ---------------------------------------------------------------------
184
- async applyPlan(plan) {
185
- const bag = new DiagnosticBag();
186
- bag.mergeArray(plan.diagnostics);
187
- for (const op of plan.operations) {
188
- if (op.kind === 'delete-manifest') {
189
- try {
190
- await rm(op.path, { force: true });
191
- }
192
- catch (err) {
193
- const reason = err instanceof Error ? err.message : String(err);
194
- bag.addError('IO_ERROR', `Failed to delete ${op.path}: ${reason}`, { path: op.path, reason });
195
- this.aggregator.addMany(bag.all());
196
- return bag.toFailure();
197
- }
198
- }
199
- else if (plan.nextManifest) {
200
- const write = await this.store.write(plan.nextManifest);
201
- if (!write.ok) {
202
- bag.mergeArray(write.diagnostics);
203
- return bag.toFailure();
204
- }
205
- }
206
- }
207
- return ok({
208
- operations: plan.operations,
209
- diagnostics: bag.all(),
210
- }, bag.all());
211
- }
212
- }
20
+ * Programmatic toolkit for registry-owner workflows over a uapkg registry repo.
21
+ *
22
+ * Always returns `Result<T>`. Never throws for expected failures. Diagnostics
23
+ * are also pushed into a process-wide singleton aggregator (with `once`
24
+ * deduplication) so a CI run can surface a single consolidated list.
25
+ *
26
+ * The `cwd` constructor option is the **registry repo root**, never a package
27
+ * directory inside it.
28
+ */
29
+ var RegistryTools = class {
30
+ policy;
31
+ paths;
32
+ aggregator;
33
+ store;
34
+ manifestValidator;
35
+ externalRegistry;
36
+ dependencyReachability;
37
+ releaseFileNames;
38
+ officialPolicy;
39
+ integrity;
40
+ lister;
41
+ registryValidator;
42
+ addPlanner;
43
+ removeVersionPlanner;
44
+ removePackagePlanner;
45
+ constructor(options) {
46
+ this.policy = resolvePolicy(options.policy);
47
+ this.paths = new RegistryRepoPaths(options.cwd);
48
+ this.aggregator = RegistryToolsAggregator.getInstance();
49
+ this.store = new ManifestStore(this.paths, this.aggregator);
50
+ this.manifestValidator = new ManifestValidator(this.aggregator);
51
+ this.externalRegistry = new ExternalRegistryPolicyValidator(this.policy, this.aggregator);
52
+ this.dependencyReachability = new DependencyReachabilityValidator(this.policy, this.store, this.aggregator);
53
+ this.releaseFileNames = new ReleaseFileNameValidator(this.aggregator);
54
+ this.officialPolicy = new OfficialRegistryPolicyValidator(this.aggregator);
55
+ this.integrity = new IntegrityCalculator(this.aggregator);
56
+ this.lister = new PackageLister(this.paths, this.store, this.aggregator);
57
+ this.registryValidator = new RegistryValidator(this.policy, this.paths, this.store, this.lister, this.externalRegistry, this.dependencyReachability, this.aggregator);
58
+ this.addPlanner = new AddPackageVersionPlanner(this.policy, this.paths, this.store, this.externalRegistry, this.dependencyReachability, this.aggregator);
59
+ this.removeVersionPlanner = new RemovePackageVersionPlanner(this.policy, this.paths, this.store, this.aggregator);
60
+ this.removePackagePlanner = new RemovePackagePlanner(this.policy, this.paths, this.store, this.aggregator);
61
+ }
62
+ getManifestPath(packageName) {
63
+ return ok(this.paths.manifestPath(packageName));
64
+ }
65
+ readPackageManifest(packageName) {
66
+ return this.store.read(packageName);
67
+ }
68
+ writePackageManifest(manifest) {
69
+ return this.store.write(manifest);
70
+ }
71
+ packageExists(packageName) {
72
+ return ok(this.store.exists(packageName));
73
+ }
74
+ listPackages() {
75
+ return this.lister.listSummaries();
76
+ }
77
+ async listVersions(packageName) {
78
+ const read = await this.store.read(packageName);
79
+ if (!read.ok) return read;
80
+ return ok(Object.keys(read.value.versions), read.diagnostics);
81
+ }
82
+ validatePackageManifest(manifest) {
83
+ return this.manifestValidator.validate(manifest);
84
+ }
85
+ validateManifestFile(path) {
86
+ return this.store.readFromPath(path);
87
+ }
88
+ validateRegistry() {
89
+ return this.registryValidator.validateRegistry();
90
+ }
91
+ validatePackages(packageNames) {
92
+ return this.registryValidator.validatePackages(packageNames);
93
+ }
94
+ async validateChangedManifestFiles(paths) {
95
+ const perFile = [];
96
+ const overall = new DiagnosticBag();
97
+ for (const path of paths) {
98
+ const r = await this.store.readFromPath(path);
99
+ perFile.push({
100
+ path,
101
+ diagnostics: r.diagnostics
102
+ });
103
+ overall.mergeArray(r.diagnostics);
104
+ }
105
+ return ok({ perFile }, overall.all());
106
+ }
107
+ async validateDependencyReachability(packageName, version) {
108
+ const read = await this.store.read(packageName);
109
+ if (!read.ok) return read;
110
+ const entry = read.value.versions[version];
111
+ if (!entry) {
112
+ const bag = new DiagnosticBag();
113
+ bag.mergeArray(read.diagnostics);
114
+ return fail(bag.all());
115
+ }
116
+ return this.dependencyReachability.validate(packageName, version, entry);
117
+ }
118
+ validateExternalRegistryPolicy(manifest) {
119
+ return this.externalRegistry.validate(manifest);
120
+ }
121
+ validateReleaseFileNames(packageName, version, fileNames) {
122
+ return this.releaseFileNames.validate(packageName, version, fileNames);
123
+ }
124
+ validateOfficialRegistryPolicy(request) {
125
+ return this.officialPolicy.validate(request);
126
+ }
127
+ /** Run lint-style checks across the whole registry. Currently equivalent to a full validation. */
128
+ async lintRegistry() {
129
+ const r = await this.registryValidator.validateRegistry();
130
+ if (!r.ok) return r;
131
+ return ok({ diagnostics: r.value.diagnostics }, r.diagnostics);
132
+ }
133
+ /** Lint a single in-memory manifest. */
134
+ lintPackageManifest(manifest) {
135
+ const ext = this.externalRegistry.validate(manifest);
136
+ return ok({ diagnostics: ext.diagnostics }, ext.diagnostics);
137
+ }
138
+ planAddPackageVersion(request) {
139
+ return this.addPlanner.plan(request);
140
+ }
141
+ async addPackageVersion(request) {
142
+ const plan = await this.addPlanner.plan(request);
143
+ if (!plan.ok) return plan;
144
+ return this.applyPlan(plan.value);
145
+ }
146
+ planRemovePackageVersion(request) {
147
+ return this.removeVersionPlanner.plan(request);
148
+ }
149
+ async removePackageVersion(request) {
150
+ const plan = await this.removeVersionPlanner.plan(request);
151
+ if (!plan.ok) return plan;
152
+ return this.applyPlan(plan.value);
153
+ }
154
+ planRemovePackage(request) {
155
+ return this.removePackagePlanner.plan(request);
156
+ }
157
+ async removePackage(request) {
158
+ const plan = await this.removePackagePlanner.plan(request);
159
+ if (!plan.ok) return plan;
160
+ return this.applyPlan(plan.value);
161
+ }
162
+ computeFileIntegrity(filePath, algorithm) {
163
+ return this.integrity.compute(filePath, algorithm);
164
+ }
165
+ verifyFileIntegrity(filePath, expected) {
166
+ return this.integrity.verify(filePath, expected);
167
+ }
168
+ async applyPlan(plan) {
169
+ const bag = new DiagnosticBag();
170
+ bag.mergeArray(plan.diagnostics);
171
+ for (const op of plan.operations) if (op.kind === "delete-manifest") try {
172
+ await rm(op.path, { force: true });
173
+ } catch (err) {
174
+ const reason = err instanceof Error ? err.message : String(err);
175
+ bag.addError("IO_ERROR", `Failed to delete ${op.path}: ${reason}`, {
176
+ path: op.path,
177
+ reason
178
+ });
179
+ this.aggregator.addMany(bag.all());
180
+ return bag.toFailure();
181
+ }
182
+ else if (plan.nextManifest) {
183
+ const write = await this.store.write(plan.nextManifest);
184
+ if (!write.ok) {
185
+ bag.mergeArray(write.diagnostics);
186
+ return bag.toFailure();
187
+ }
188
+ }
189
+ return ok({
190
+ operations: plan.operations,
191
+ diagnostics: bag.all()
192
+ }, bag.all());
193
+ }
194
+ };
213
195
  function resolvePolicy(policy) {
214
- return {
215
- externalRegistries: policy?.externalRegistries ?? 'deny',
216
- allowedExternalRegistryNames: policy?.allowedExternalRegistryNames ?? [],
217
- removals: policy?.removals ?? 'deny',
218
- unknownKeys: policy?.unknownKeys ?? 'warn',
219
- requireExistingDependencies: policy?.requireExistingDependencies ?? true,
220
- requireReachableDependencyRanges: policy?.requireReachableDependencyRanges ?? true,
221
- requireSortedVersions: policy?.requireSortedVersions ?? true,
222
- };
196
+ return {
197
+ externalRegistries: policy?.externalRegistries ?? "deny",
198
+ allowedExternalRegistryNames: policy?.allowedExternalRegistryNames ?? [],
199
+ removals: policy?.removals ?? "deny",
200
+ unknownKeys: policy?.unknownKeys ?? "warn",
201
+ requireExistingDependencies: policy?.requireExistingDependencies ?? true,
202
+ requireReachableDependencyRanges: policy?.requireReachableDependencyRanges ?? true,
203
+ requireSortedVersions: policy?.requireSortedVersions ?? true
204
+ };
223
205
  }
206
+
207
+ //#endregion
208
+ export { RegistryTools };
224
209
  //# sourceMappingURL=RegistryTools.js.map