@uapkg/registry-tools 1.1.9

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 (74) hide show
  1. package/LICENSE +14 -0
  2. package/dist/aggregator/RegistryToolsAggregator.d.ts +43 -0
  3. package/dist/aggregator/RegistryToolsAggregator.d.ts.map +1 -0
  4. package/dist/aggregator/RegistryToolsAggregator.js +77 -0
  5. package/dist/aggregator/RegistryToolsAggregator.js.map +1 -0
  6. package/dist/contracts/RegistryToolsTypes.d.ts +122 -0
  7. package/dist/contracts/RegistryToolsTypes.d.ts.map +1 -0
  8. package/dist/contracts/RegistryToolsTypes.js +5 -0
  9. package/dist/contracts/RegistryToolsTypes.js.map +1 -0
  10. package/dist/index.d.ts +18 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +30 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/io/IntegrityCalculator.d.ts +18 -0
  15. package/dist/io/IntegrityCalculator.d.ts.map +1 -0
  16. package/dist/io/IntegrityCalculator.js +96 -0
  17. package/dist/io/IntegrityCalculator.js.map +1 -0
  18. package/dist/io/ManifestStore.d.ts +39 -0
  19. package/dist/io/ManifestStore.d.ts.map +1 -0
  20. package/dist/io/ManifestStore.js +126 -0
  21. package/dist/io/ManifestStore.js.map +1 -0
  22. package/dist/listing/PackageLister.d.ts +20 -0
  23. package/dist/listing/PackageLister.d.ts.map +1 -0
  24. package/dist/listing/PackageLister.js +77 -0
  25. package/dist/listing/PackageLister.js.map +1 -0
  26. package/dist/mutation/AddPackageVersionPlanner.d.ts +23 -0
  27. package/dist/mutation/AddPackageVersionPlanner.d.ts.map +1 -0
  28. package/dist/mutation/AddPackageVersionPlanner.js +119 -0
  29. package/dist/mutation/AddPackageVersionPlanner.js.map +1 -0
  30. package/dist/mutation/RemovePackagePlanner.d.ts +20 -0
  31. package/dist/mutation/RemovePackagePlanner.d.ts.map +1 -0
  32. package/dist/mutation/RemovePackagePlanner.js +39 -0
  33. package/dist/mutation/RemovePackagePlanner.js.map +1 -0
  34. package/dist/mutation/RemovePackageVersionPlanner.d.ts +19 -0
  35. package/dist/mutation/RemovePackageVersionPlanner.d.ts.map +1 -0
  36. package/dist/mutation/RemovePackageVersionPlanner.js +54 -0
  37. package/dist/mutation/RemovePackageVersionPlanner.js.map +1 -0
  38. package/dist/mutation/VersionSorter.d.ts +8 -0
  39. package/dist/mutation/VersionSorter.d.ts.map +1 -0
  40. package/dist/mutation/VersionSorter.js +31 -0
  41. package/dist/mutation/VersionSorter.js.map +1 -0
  42. package/dist/paths/RegistryRepoPaths.d.ts +20 -0
  43. package/dist/paths/RegistryRepoPaths.d.ts.map +1 -0
  44. package/dist/paths/RegistryRepoPaths.js +31 -0
  45. package/dist/paths/RegistryRepoPaths.js.map +1 -0
  46. package/dist/tools/RegistryTools.d.ts +62 -0
  47. package/dist/tools/RegistryTools.d.ts.map +1 -0
  48. package/dist/tools/RegistryTools.js +224 -0
  49. package/dist/tools/RegistryTools.js.map +1 -0
  50. package/dist/validation/DependencyReachabilityValidator.d.ts +22 -0
  51. package/dist/validation/DependencyReachabilityValidator.d.ts.map +1 -0
  52. package/dist/validation/DependencyReachabilityValidator.js +59 -0
  53. package/dist/validation/DependencyReachabilityValidator.js.map +1 -0
  54. package/dist/validation/ExternalRegistryPolicyValidator.d.ts +20 -0
  55. package/dist/validation/ExternalRegistryPolicyValidator.d.ts.map +1 -0
  56. package/dist/validation/ExternalRegistryPolicyValidator.js +65 -0
  57. package/dist/validation/ExternalRegistryPolicyValidator.js.map +1 -0
  58. package/dist/validation/ManifestValidator.d.ts +14 -0
  59. package/dist/validation/ManifestValidator.d.ts.map +1 -0
  60. package/dist/validation/ManifestValidator.js +26 -0
  61. package/dist/validation/ManifestValidator.js.map +1 -0
  62. package/dist/validation/OfficialRegistryPolicyValidator.d.ts +32 -0
  63. package/dist/validation/OfficialRegistryPolicyValidator.d.ts.map +1 -0
  64. package/dist/validation/OfficialRegistryPolicyValidator.js +91 -0
  65. package/dist/validation/OfficialRegistryPolicyValidator.js.map +1 -0
  66. package/dist/validation/RegistryValidator.d.ts +29 -0
  67. package/dist/validation/RegistryValidator.d.ts.map +1 -0
  68. package/dist/validation/RegistryValidator.js +89 -0
  69. package/dist/validation/RegistryValidator.js.map +1 -0
  70. package/dist/validation/ReleaseFileNameValidator.d.ts +19 -0
  71. package/dist/validation/ReleaseFileNameValidator.d.ts.map +1 -0
  72. package/dist/validation/ReleaseFileNameValidator.js +31 -0
  73. package/dist/validation/ReleaseFileNameValidator.js.map +1 -0
  74. package/package.json +43 -0
package/LICENSE ADDED
@@ -0,0 +1,14 @@
1
+ Copyright 2026 Maxim Devoir
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
4
+ documentation files (the “Software”), to deal in the Software without restriction, including without limitation the
5
+ rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
6
+ persons to whom the Software is furnished to do so, subject to the following conditions:
7
+
8
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
9
+ Software.
10
+
11
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
12
+ WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
13
+ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
14
+ OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,43 @@
1
+ import type { Diagnostic, DiagnosticLevel } from '@uapkg/diagnostics';
2
+ /**
3
+ * Process-wide aggregator for all diagnostics emitted by `@uapkg/registry-tools`.
4
+ *
5
+ * Goals:
6
+ * - Single source of truth for CI consumers that want one consolidated list of
7
+ * warnings and errors across an entire run.
8
+ * - Plan-then-apply flows do not double-report: diagnostics with
9
+ * `emitPolicy: 'once'` are deduplicated by their stable `emitFingerprint`.
10
+ *
11
+ * This is a true singleton — instantiating multiple `RegistryTools` objects in
12
+ * the same process all push into the same aggregator.
13
+ */
14
+ export declare class RegistryToolsAggregator {
15
+ private static instance;
16
+ private readonly items;
17
+ private readonly seenFingerprints;
18
+ /** Get (or lazily create) the process-wide singleton aggregator. */
19
+ static getInstance(): RegistryToolsAggregator;
20
+ /** Replace the singleton — primarily intended for tests. */
21
+ static resetForTests(): void;
22
+ /**
23
+ * Add a diagnostic to the aggregator.
24
+ *
25
+ * If the diagnostic uses `emitPolicy: 'once'` and a matching fingerprint has
26
+ * already been recorded, the call is a no-op and the method returns `false`.
27
+ */
28
+ add(diagnostic: Diagnostic): boolean;
29
+ /** Add many diagnostics. */
30
+ addMany(diagnostics: readonly Diagnostic[]): void;
31
+ /** All diagnostics collected so far, in insertion order. */
32
+ all(): readonly Diagnostic[];
33
+ /** Diagnostics filtered by level. */
34
+ byLevel(level: DiagnosticLevel): readonly Diagnostic[];
35
+ errors(): readonly Diagnostic[];
36
+ warnings(): readonly Diagnostic[];
37
+ hasErrors(): boolean;
38
+ /** Wipe collected diagnostics. */
39
+ clear(): void;
40
+ }
41
+ /** Convenience accessor for the process-wide singleton. */
42
+ export declare function getRegistryToolsAggregator(): RegistryToolsAggregator;
43
+ //# sourceMappingURL=RegistryToolsAggregator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RegistryToolsAggregator.d.ts","sourceRoot":"","sources":["../../src/aggregator/RegistryToolsAggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsC;IAE7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IAEtD,oEAAoE;IACpE,MAAM,CAAC,WAAW,IAAI,uBAAuB;IAO7C,4DAA4D;IAC5D,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAWpC,4BAA4B;IAC5B,OAAO,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAMjD,4DAA4D;IAC5D,GAAG,IAAI,SAAS,UAAU,EAAE;IAI5B,qCAAqC;IACrC,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,UAAU,EAAE;IAItD,MAAM,IAAI,SAAS,UAAU,EAAE;IAI/B,QAAQ,IAAI,SAAS,UAAU,EAAE;IAIjC,SAAS,IAAI,OAAO;IAIpB,kCAAkC;IAClC,KAAK,IAAI,IAAI;CAId;AAED,2DAA2D;AAC3D,wBAAgB,0BAA0B,IAAI,uBAAuB,CAEpE"}
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Process-wide aggregator for all diagnostics emitted by `@uapkg/registry-tools`.
3
+ *
4
+ * Goals:
5
+ * - Single source of truth for CI consumers that want one consolidated list of
6
+ * warnings and errors across an entire run.
7
+ * - Plan-then-apply flows do not double-report: diagnostics with
8
+ * `emitPolicy: 'once'` are deduplicated by their stable `emitFingerprint`.
9
+ *
10
+ * This is a true singleton — instantiating multiple `RegistryTools` objects in
11
+ * the same process all push into the same aggregator.
12
+ */
13
+ export class RegistryToolsAggregator {
14
+ static instance;
15
+ items = [];
16
+ seenFingerprints = new Set();
17
+ /** Get (or lazily create) the process-wide singleton aggregator. */
18
+ static getInstance() {
19
+ if (!RegistryToolsAggregator.instance) {
20
+ RegistryToolsAggregator.instance = new RegistryToolsAggregator();
21
+ }
22
+ return RegistryToolsAggregator.instance;
23
+ }
24
+ /** Replace the singleton — primarily intended for tests. */
25
+ static resetForTests() {
26
+ RegistryToolsAggregator.instance = new RegistryToolsAggregator();
27
+ }
28
+ /**
29
+ * Add a diagnostic to the aggregator.
30
+ *
31
+ * If the diagnostic uses `emitPolicy: 'once'` and a matching fingerprint has
32
+ * already been recorded, the call is a no-op and the method returns `false`.
33
+ */
34
+ add(diagnostic) {
35
+ if (diagnostic.emitPolicy === 'once' && diagnostic.emitFingerprint) {
36
+ if (this.seenFingerprints.has(diagnostic.emitFingerprint)) {
37
+ return false;
38
+ }
39
+ this.seenFingerprints.add(diagnostic.emitFingerprint);
40
+ }
41
+ this.items.push(diagnostic);
42
+ return true;
43
+ }
44
+ /** Add many diagnostics. */
45
+ addMany(diagnostics) {
46
+ for (const d of diagnostics) {
47
+ this.add(d);
48
+ }
49
+ }
50
+ /** All diagnostics collected so far, in insertion order. */
51
+ all() {
52
+ return this.items;
53
+ }
54
+ /** Diagnostics filtered by level. */
55
+ byLevel(level) {
56
+ return this.items.filter((d) => d.level === level);
57
+ }
58
+ errors() {
59
+ return this.byLevel('error');
60
+ }
61
+ warnings() {
62
+ return this.byLevel('warning');
63
+ }
64
+ hasErrors() {
65
+ return this.items.some((d) => d.level === 'error');
66
+ }
67
+ /** Wipe collected diagnostics. */
68
+ clear() {
69
+ this.items.length = 0;
70
+ this.seenFingerprints.clear();
71
+ }
72
+ }
73
+ /** Convenience accessor for the process-wide singleton. */
74
+ export function getRegistryToolsAggregator() {
75
+ return RegistryToolsAggregator.getInstance();
76
+ }
77
+ //# sourceMappingURL=RegistryToolsAggregator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RegistryToolsAggregator.js","sourceRoot":"","sources":["../../src/aggregator/RegistryToolsAggregator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IAC1B,MAAM,CAAC,QAAQ,CAAsC;IAE5C,KAAK,GAAiB,EAAE,CAAC;IACzB,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtD,oEAAoE;IACpE,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC;YACtC,uBAAuB,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,uBAAuB,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,aAAa;QAClB,uBAAuB,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACnE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,UAAsB;QACxB,IAAI,UAAU,CAAC,UAAU,KAAK,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC1D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,OAAO,CAAC,WAAkC;QACxC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,qCAAqC;IACrC,OAAO,CAAC,KAAsB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,kCAAkC;IAClC,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,UAAU,0BAA0B;IACxC,OAAO,uBAAuB,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC"}
@@ -0,0 +1,122 @@
1
+ import type { PackageName, PackageVersion } from '@uapkg/common-schema';
2
+ import type { Diagnostic } from '@uapkg/diagnostics';
3
+ import type { Integrity, PackageRegistryManifest, PackageSource, RegistryVersion } from '@uapkg/registry-schema';
4
+ export type ExternalRegistryPolicyMode = 'deny' | 'allow-listed' | 'allow-any';
5
+ export type RemovalsPolicyMode = 'deny' | 'allow-version-remove' | 'allow-package-remove';
6
+ export type UnknownKeysPolicyMode = 'ignore' | 'warn' | 'error';
7
+ export interface RegistryToolsPolicy {
8
+ readonly externalRegistries?: ExternalRegistryPolicyMode;
9
+ readonly allowedExternalRegistryNames?: readonly string[];
10
+ readonly removals?: RemovalsPolicyMode;
11
+ readonly unknownKeys?: UnknownKeysPolicyMode;
12
+ readonly requireExistingDependencies?: boolean;
13
+ readonly requireReachableDependencyRanges?: boolean;
14
+ readonly requireSortedVersions?: boolean;
15
+ }
16
+ /** Fully resolved policy with defaults applied. */
17
+ export interface ResolvedRegistryToolsPolicy {
18
+ readonly externalRegistries: ExternalRegistryPolicyMode;
19
+ readonly allowedExternalRegistryNames: readonly string[];
20
+ readonly removals: RemovalsPolicyMode;
21
+ readonly unknownKeys: UnknownKeysPolicyMode;
22
+ readonly requireExistingDependencies: boolean;
23
+ readonly requireReachableDependencyRanges: boolean;
24
+ readonly requireSortedVersions: boolean;
25
+ }
26
+ export interface RegistryToolsOptions {
27
+ /** Root directory of the registry repo (NOT a package directory). */
28
+ readonly cwd: string;
29
+ readonly policy?: RegistryToolsPolicy;
30
+ }
31
+ export interface PackageSummary {
32
+ readonly name: PackageName;
33
+ readonly manifestPath: string;
34
+ readonly versionCount: number;
35
+ }
36
+ export interface WriteManifestResult {
37
+ readonly manifestPath: string;
38
+ readonly bytesWritten: number;
39
+ }
40
+ export interface WriteResult {
41
+ readonly path: string;
42
+ readonly bytesWritten: number;
43
+ }
44
+ export interface RegistryVersionValidationReport {
45
+ readonly packageName: PackageName;
46
+ readonly version: PackageVersion;
47
+ readonly diagnostics: readonly Diagnostic[];
48
+ }
49
+ export interface PackageValidationReport {
50
+ readonly packageName: PackageName;
51
+ readonly manifestPath: string;
52
+ readonly diagnostics: readonly Diagnostic[];
53
+ }
54
+ export interface RegistryValidationReport {
55
+ readonly packageReports: readonly PackageValidationReport[];
56
+ readonly diagnostics: readonly Diagnostic[];
57
+ }
58
+ export interface RegistryLintReport {
59
+ readonly diagnostics: readonly Diagnostic[];
60
+ }
61
+ export interface ChangedManifestValidation {
62
+ readonly perFile: readonly {
63
+ readonly path: string;
64
+ readonly diagnostics: readonly Diagnostic[];
65
+ }[];
66
+ }
67
+ export interface DependencyValidationReport {
68
+ readonly packageName: PackageName;
69
+ readonly version: PackageVersion;
70
+ readonly diagnostics: readonly Diagnostic[];
71
+ }
72
+ export interface ExternalRegistryPolicyReport {
73
+ readonly diagnostics: readonly Diagnostic[];
74
+ }
75
+ export interface ReleaseFileNameReport {
76
+ readonly diagnostics: readonly Diagnostic[];
77
+ }
78
+ export interface OfficialPackagePolicyReport {
79
+ readonly diagnostics: readonly Diagnostic[];
80
+ }
81
+ export interface AddPackageVersionRequest {
82
+ readonly packageName: PackageName;
83
+ readonly version: PackageVersion;
84
+ readonly packageSource: PackageSource;
85
+ readonly registryVersion: RegistryVersion;
86
+ readonly createPackageManifestIfMissing?: boolean;
87
+ readonly overwriteExistingVersion?: boolean;
88
+ }
89
+ export interface RemovePackageVersionRequest {
90
+ readonly packageName: PackageName;
91
+ readonly version: PackageVersion;
92
+ }
93
+ export interface RemovePackageRequest {
94
+ readonly packageName: PackageName;
95
+ }
96
+ export type RegistryMutationOperation = {
97
+ readonly kind: 'create-manifest';
98
+ readonly path: string;
99
+ } | {
100
+ readonly kind: 'update-manifest';
101
+ readonly path: string;
102
+ } | {
103
+ readonly kind: 'delete-manifest';
104
+ readonly path: string;
105
+ };
106
+ export interface RegistryMutationPlan {
107
+ readonly operations: readonly RegistryMutationOperation[];
108
+ readonly nextManifest?: PackageRegistryManifest;
109
+ readonly diagnostics: readonly Diagnostic[];
110
+ }
111
+ export interface RegistryMutationSummary {
112
+ readonly operations: readonly RegistryMutationOperation[];
113
+ readonly diagnostics: readonly Diagnostic[];
114
+ }
115
+ export type IntegrityAlgorithm = 'sha256' | 'sha512';
116
+ export interface IntegrityVerificationResult {
117
+ readonly ok: boolean;
118
+ readonly actual: Integrity;
119
+ readonly expected: Integrity;
120
+ }
121
+ export declare const REGISTRY_TOOLS_PACKAGES_DIR = "packages";
122
+ //# sourceMappingURL=RegistryToolsTypes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RegistryToolsTypes.d.ts","sourceRoot":"","sources":["../../src/contracts/RegistryToolsTypes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ // ---------------------------------------------------------------------------
2
+ // Misc
3
+ // ---------------------------------------------------------------------------
4
+ export const REGISTRY_TOOLS_PACKAGES_DIR = 'packages';
5
+ //# sourceMappingURL=RegistryToolsTypes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RegistryToolsTypes.js","sourceRoot":"","sources":["../../src/contracts/RegistryToolsTypes.ts"],"names":[],"mappings":"AAmKA,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC"}
@@ -0,0 +1,18 @@
1
+ export { getRegistryToolsAggregator, RegistryToolsAggregator, } from './aggregator/RegistryToolsAggregator.js';
2
+ export type { AddPackageVersionRequest, ChangedManifestValidation, DependencyValidationReport, ExternalRegistryPolicyMode, ExternalRegistryPolicyReport, IntegrityAlgorithm, IntegrityVerificationResult, OfficialPackagePolicyReport, PackageSummary, PackageValidationReport, RegistryLintReport, RegistryMutationOperation, RegistryMutationPlan, RegistryMutationSummary, RegistryToolsOptions, RegistryToolsPolicy, RegistryValidationReport, RegistryVersionValidationReport, ReleaseFileNameReport, RemovalsPolicyMode, RemovePackageRequest, RemovePackageVersionRequest, ResolvedRegistryToolsPolicy, UnknownKeysPolicyMode, WriteManifestResult, WriteResult, } from './contracts/RegistryToolsTypes.js';
3
+ export { IntegrityCalculator } from './io/IntegrityCalculator.js';
4
+ export { ManifestStore } from './io/ManifestStore.js';
5
+ export { PackageLister } from './listing/PackageLister.js';
6
+ export { AddPackageVersionPlanner } from './mutation/AddPackageVersionPlanner.js';
7
+ export { RemovePackagePlanner } from './mutation/RemovePackagePlanner.js';
8
+ export { RemovePackageVersionPlanner } from './mutation/RemovePackageVersionPlanner.js';
9
+ export { sortVersionsNewestFirst } from './mutation/VersionSorter.js';
10
+ export { RegistryRepoPaths } from './paths/RegistryRepoPaths.js';
11
+ export { RegistryTools } from './tools/RegistryTools.js';
12
+ export { DependencyReachabilityValidator } from './validation/DependencyReachabilityValidator.js';
13
+ export { ExternalRegistryPolicyValidator } from './validation/ExternalRegistryPolicyValidator.js';
14
+ export { ManifestValidator } from './validation/ManifestValidator.js';
15
+ export { type OfficialRegistryPolicyRequest, OfficialRegistryPolicyValidator, } from './validation/OfficialRegistryPolicyValidator.js';
16
+ export { RegistryValidator } from './validation/RegistryValidator.js';
17
+ export { ReleaseFileNameValidator } from './validation/ReleaseFileNameValidator.js';
18
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,yCAAyC,CAAC;AAGjD,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,EAC3B,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,GACZ,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAClG,OAAO,EAAE,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EACL,KAAK,6BAA6B,EAClC,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,30 @@
1
+ // ---------------------------------------------------------------------------
2
+ // @uapkg/registry-tools — public API
3
+ //
4
+ // Programmatic, registry-owner / CI-side toolkit for uapkg registry repos.
5
+ // This package is NOT a CLI and is NOT used by normal `uapkg` consumers.
6
+ // ---------------------------------------------------------------------------
7
+ // Aggregator
8
+ export { getRegistryToolsAggregator, RegistryToolsAggregator, } from './aggregator/RegistryToolsAggregator.js';
9
+ // IO helpers
10
+ export { IntegrityCalculator } from './io/IntegrityCalculator.js';
11
+ export { ManifestStore } from './io/ManifestStore.js';
12
+ // Listing
13
+ export { PackageLister } from './listing/PackageLister.js';
14
+ // Mutation planners
15
+ export { AddPackageVersionPlanner } from './mutation/AddPackageVersionPlanner.js';
16
+ export { RemovePackagePlanner } from './mutation/RemovePackagePlanner.js';
17
+ export { RemovePackageVersionPlanner } from './mutation/RemovePackageVersionPlanner.js';
18
+ export { sortVersionsNewestFirst } from './mutation/VersionSorter.js';
19
+ // Paths
20
+ export { RegistryRepoPaths } from './paths/RegistryRepoPaths.js';
21
+ // Orchestrator
22
+ export { RegistryTools } from './tools/RegistryTools.js';
23
+ // Validators
24
+ export { DependencyReachabilityValidator } from './validation/DependencyReachabilityValidator.js';
25
+ export { ExternalRegistryPolicyValidator } from './validation/ExternalRegistryPolicyValidator.js';
26
+ export { ManifestValidator } from './validation/ManifestValidator.js';
27
+ export { OfficialRegistryPolicyValidator, } from './validation/OfficialRegistryPolicyValidator.js';
28
+ export { RegistryValidator } from './validation/RegistryValidator.js';
29
+ export { ReleaseFileNameValidator } from './validation/ReleaseFileNameValidator.js';
30
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,8EAA8E;AAE9E,aAAa;AACb,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,yCAAyC,CAAC;AAgCjD,aAAa;AACb,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,aAAa;AACb,OAAO,EAAE,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAClG,OAAO,EAAE,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAEL,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC"}
@@ -0,0 +1,18 @@
1
+ import { type Result } from '@uapkg/diagnostics';
2
+ import { type Integrity } from '@uapkg/registry-schema';
3
+ import type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';
4
+ import type { IntegrityAlgorithm, IntegrityVerificationResult } from '../contracts/RegistryToolsTypes.js';
5
+ /**
6
+ * Computes and verifies file integrity locally — never reaches the network.
7
+ */
8
+ export declare class IntegrityCalculator {
9
+ private readonly aggregator;
10
+ constructor(aggregator: RegistryToolsAggregator);
11
+ /** Stream-hash a local file and return a validated `Integrity` record. */
12
+ compute(filePath: string, algorithm?: IntegrityAlgorithm): Promise<Result<Integrity>>;
13
+ /** Recompute a file's integrity and compare it to an expected value. */
14
+ verify(filePath: string, expected: Integrity): Promise<Result<IntegrityVerificationResult>>;
15
+ /** Hash a file by streaming. */
16
+ private streamHash;
17
+ }
18
+ //# sourceMappingURL=IntegrityCalculator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IntegrityCalculator.d.ts","sourceRoot":"","sources":["../../src/io/IntegrityCalculator.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAE1G;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAEhE,0EAA0E;IACpE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,kBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IA4BrG,wEAAwE;IAClE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAiCjG,gCAAgC;IAChC,OAAO,CAAC,UAAU;CA2BnB"}
@@ -0,0 +1,96 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { createReadStream } from 'node:fs';
3
+ import { createIoErrorDiagnostic, createRegistryToolsIntegrityMismatchDiagnostic, DiagnosticBag, ok, } from '@uapkg/diagnostics';
4
+ import { IntegritySchema } from '@uapkg/registry-schema';
5
+ /**
6
+ * Computes and verifies file integrity locally — never reaches the network.
7
+ */
8
+ export class IntegrityCalculator {
9
+ aggregator;
10
+ constructor(aggregator) {
11
+ this.aggregator = aggregator;
12
+ }
13
+ /** Stream-hash a local file and return a validated `Integrity` record. */
14
+ async compute(filePath, algorithm = 'sha256') {
15
+ const bag = new DiagnosticBag();
16
+ const computed = await this.streamHash(filePath, algorithm);
17
+ if (!computed.ok) {
18
+ bag.mergeArray(computed.diagnostics);
19
+ this.aggregator.addMany(computed.diagnostics);
20
+ return bag.toFailure();
21
+ }
22
+ const candidate = {
23
+ hash: `${algorithm}:${computed.value.hex}`,
24
+ size: computed.value.size,
25
+ };
26
+ const validated = IntegritySchema.safeParse(candidate);
27
+ if (!validated.success) {
28
+ // Should not happen unless the algorithm output is malformed.
29
+ const reason = validated.error.issues.map((i) => i.message).join('; ');
30
+ const diag = createIoErrorDiagnostic(filePath, `integrity validation failed: ${reason}`);
31
+ bag.add(diag);
32
+ this.aggregator.add(diag);
33
+ return bag.toFailure();
34
+ }
35
+ return ok(validated.data, bag.all());
36
+ }
37
+ /** Recompute a file's integrity and compare it to an expected value. */
38
+ async verify(filePath, expected) {
39
+ const bag = new DiagnosticBag();
40
+ const algo = parseAlgorithm(expected.hash) ?? 'sha256';
41
+ const computed = await this.compute(filePath, algo);
42
+ if (!computed.ok) {
43
+ bag.mergeArray(computed.diagnostics);
44
+ return bag.toFailure();
45
+ }
46
+ const matches = computed.value.hash === expected.hash && computed.value.size === expected.size;
47
+ if (!matches) {
48
+ const diag = createRegistryToolsIntegrityMismatchDiagnostic(filePath, expected.hash, computed.value.hash, expected.size, computed.value.size);
49
+ bag.add(diag);
50
+ this.aggregator.add(diag);
51
+ }
52
+ return ok({
53
+ ok: matches,
54
+ actual: computed.value,
55
+ expected,
56
+ }, bag.all());
57
+ }
58
+ /** Hash a file by streaming. */
59
+ streamHash(filePath, algorithm) {
60
+ return new Promise((resolve) => {
61
+ const bag = new DiagnosticBag();
62
+ const hash = createHash(algorithm);
63
+ let size = 0;
64
+ const stream = createReadStream(filePath);
65
+ stream.on('data', (chunk) => {
66
+ if (Buffer.isBuffer(chunk)) {
67
+ hash.update(chunk);
68
+ size += chunk.length;
69
+ }
70
+ else {
71
+ const buf = Buffer.from(chunk);
72
+ hash.update(buf);
73
+ size += buf.length;
74
+ }
75
+ });
76
+ stream.on('error', (err) => {
77
+ const diag = createIoErrorDiagnostic(filePath, err.message);
78
+ bag.add(diag);
79
+ resolve(bag.toFailure());
80
+ });
81
+ stream.on('end', () => {
82
+ resolve(ok({ hex: hash.digest('hex'), size }));
83
+ });
84
+ });
85
+ }
86
+ }
87
+ function parseAlgorithm(assetHash) {
88
+ const colon = assetHash.indexOf(':');
89
+ if (colon < 0)
90
+ return null;
91
+ const algo = assetHash.slice(0, colon);
92
+ if (algo === 'sha256' || algo === 'sha512')
93
+ return algo;
94
+ return null;
95
+ }
96
+ //# sourceMappingURL=IntegrityCalculator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IntegrityCalculator.js","sourceRoot":"","sources":["../../src/io/IntegrityCalculator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import type { PackageName } from '@uapkg/common-schema';
2
+ import { type Result } from '@uapkg/diagnostics';
3
+ import { type PackageRegistryManifest } from '@uapkg/registry-schema';
4
+ import type { RegistryToolsAggregator } from '../aggregator/RegistryToolsAggregator.js';
5
+ import type { WriteManifestResult } from '../contracts/RegistryToolsTypes.js';
6
+ import type { RegistryRepoPaths } from '../paths/RegistryRepoPaths.js';
7
+ /**
8
+ * Reads, validates, and writes registry-package manifests on disk.
9
+ *
10
+ * Responsibilities:
11
+ * - Resolve manifest paths for a given package name.
12
+ * - Decode JSON safely.
13
+ * - Validate against `PackageRegistryManifestSchema`.
14
+ * - Write deterministic, sorted, pretty-printed JSON.
15
+ */
16
+ export declare class ManifestStore {
17
+ private readonly paths;
18
+ private readonly aggregator;
19
+ constructor(paths: RegistryRepoPaths, aggregator: RegistryToolsAggregator);
20
+ /** Resolve the manifest path for a package. Pure path computation. */
21
+ resolveManifestPath(packageName: PackageName): string;
22
+ /** True if the manifest file exists on disk. */
23
+ exists(packageName: PackageName): boolean;
24
+ /** Read and validate a package manifest. Emits a missing-package diagnostic when absent. */
25
+ read(packageName: PackageName): Promise<Result<PackageRegistryManifest>>;
26
+ /** Read and validate a manifest file at an arbitrary path. */
27
+ readFromPath(filePath: string): Promise<Result<PackageRegistryManifest>>;
28
+ /**
29
+ * Write a package manifest deterministically.
30
+ *
31
+ * Versions are pre-sorted newest-first by SemVer. The on-disk JSON uses
32
+ * stable key ordering and a trailing newline so version control shows
33
+ * minimal diffs.
34
+ */
35
+ write(manifest: PackageRegistryManifest): Promise<Result<WriteManifestResult>>;
36
+ /** Sort versions newest-first by SemVer; preserves all other fields. */
37
+ normalize(manifest: PackageRegistryManifest): PackageRegistryManifest;
38
+ }
39
+ //# sourceMappingURL=ManifestStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ManifestStore.d.ts","sourceRoot":"","sources":["../../src/io/ManifestStore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAQL,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,uBAAuB,EAG7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;;;GAQG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,uBAAuB;IAGtD,sEAAsE;IACtE,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM;IAIrD,gDAAgD;IAChD,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAIzC,4FAA4F;IACtF,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAc9E,8DAA8D;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAiC9E;;;;;;OAMG;IACG,KAAK,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IA8BpF,wEAAwE;IACxE,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,uBAAuB;CAgBtE"}
@@ -0,0 +1,126 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { mkdir, readFile, writeFile } from 'node:fs/promises';
3
+ import { dirname } from 'node:path';
4
+ import { safeJsonParse, stableStringify } from '@uapkg/common';
5
+ import { createIoErrorDiagnostic, createManifestReadErrorDiagnostic, createManifestWriteErrorDiagnostic, createRegistryToolsPackageMissingDiagnostic, createSchemaInvalidDiagnostic, DiagnosticBag, ok, } from '@uapkg/diagnostics';
6
+ import { PackageRegistryManifestSchema, } from '@uapkg/registry-schema';
7
+ import { sortVersionsNewestFirst } from '../mutation/VersionSorter.js';
8
+ /**
9
+ * Reads, validates, and writes registry-package manifests on disk.
10
+ *
11
+ * Responsibilities:
12
+ * - Resolve manifest paths for a given package name.
13
+ * - Decode JSON safely.
14
+ * - Validate against `PackageRegistryManifestSchema`.
15
+ * - Write deterministic, sorted, pretty-printed JSON.
16
+ */
17
+ export class ManifestStore {
18
+ paths;
19
+ aggregator;
20
+ constructor(paths, aggregator) {
21
+ this.paths = paths;
22
+ this.aggregator = aggregator;
23
+ }
24
+ /** Resolve the manifest path for a package. Pure path computation. */
25
+ resolveManifestPath(packageName) {
26
+ return this.paths.manifestPath(packageName);
27
+ }
28
+ /** True if the manifest file exists on disk. */
29
+ exists(packageName) {
30
+ return existsSync(this.paths.manifestPath(packageName));
31
+ }
32
+ /** Read and validate a package manifest. Emits a missing-package diagnostic when absent. */
33
+ async read(packageName) {
34
+ const bag = new DiagnosticBag();
35
+ const filePath = this.paths.manifestPath(packageName);
36
+ if (!existsSync(filePath)) {
37
+ const diag = createRegistryToolsPackageMissingDiagnostic(packageName, filePath);
38
+ bag.add(diag);
39
+ this.aggregator.add(diag);
40
+ return bag.toFailure();
41
+ }
42
+ return this.readFromPath(filePath);
43
+ }
44
+ /** Read and validate a manifest file at an arbitrary path. */
45
+ async readFromPath(filePath) {
46
+ const bag = new DiagnosticBag();
47
+ let raw;
48
+ try {
49
+ raw = await readFile(filePath, 'utf-8');
50
+ }
51
+ catch (err) {
52
+ const reason = err instanceof Error ? err.message : String(err);
53
+ const diag = createManifestReadErrorDiagnostic(filePath, reason);
54
+ bag.add(diag);
55
+ this.aggregator.add(diag);
56
+ return bag.toFailure();
57
+ }
58
+ const parsed = safeJsonParse(raw, filePath);
59
+ if (!parsed.ok) {
60
+ bag.mergeArray(parsed.diagnostics);
61
+ this.aggregator.addMany(parsed.diagnostics);
62
+ return bag.toFailure();
63
+ }
64
+ const result = PackageRegistryManifestSchema.safeParse(parsed.value);
65
+ if (!result.success) {
66
+ const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);
67
+ const diag = createSchemaInvalidDiagnostic(filePath, issues);
68
+ bag.add(diag);
69
+ this.aggregator.add(diag);
70
+ return bag.toFailure();
71
+ }
72
+ return ok(result.data, bag.all());
73
+ }
74
+ /**
75
+ * Write a package manifest deterministically.
76
+ *
77
+ * Versions are pre-sorted newest-first by SemVer. The on-disk JSON uses
78
+ * stable key ordering and a trailing newline so version control shows
79
+ * minimal diffs.
80
+ */
81
+ async write(manifest) {
82
+ const bag = new DiagnosticBag();
83
+ const filePath = this.paths.manifestPath(manifest.name);
84
+ const normalized = this.normalize(manifest);
85
+ const body = `${stableStringify(normalized)}\n`;
86
+ try {
87
+ await mkdir(dirname(filePath), { recursive: true });
88
+ }
89
+ catch (err) {
90
+ const reason = err instanceof Error ? err.message : String(err);
91
+ const diag = createIoErrorDiagnostic(dirname(filePath), reason);
92
+ bag.add(diag);
93
+ this.aggregator.add(diag);
94
+ return bag.toFailure();
95
+ }
96
+ try {
97
+ await writeFile(filePath, body, 'utf-8');
98
+ }
99
+ catch (err) {
100
+ const reason = err instanceof Error ? err.message : String(err);
101
+ const diag = createManifestWriteErrorDiagnostic(filePath, reason);
102
+ bag.add(diag);
103
+ this.aggregator.add(diag);
104
+ return bag.toFailure();
105
+ }
106
+ return ok({ manifestPath: filePath, bytesWritten: Buffer.byteLength(body, 'utf-8') }, bag.all());
107
+ }
108
+ /** Sort versions newest-first by SemVer; preserves all other fields. */
109
+ normalize(manifest) {
110
+ const sortedKeys = sortVersionsNewestFirst(Object.keys(manifest.versions));
111
+ const source = manifest.versions;
112
+ const versions = {};
113
+ for (const k of sortedKeys) {
114
+ const v = source[k];
115
+ if (v !== undefined) {
116
+ versions[k] = v;
117
+ }
118
+ }
119
+ return {
120
+ name: manifest.name,
121
+ packageSource: manifest.packageSource,
122
+ versions: versions,
123
+ };
124
+ }
125
+ }
126
+ //# sourceMappingURL=ManifestStore.js.map