@inventarch/distribution 0.0.0-stage → 1.0.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.
Files changed (166) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +4 -0
  3. package/README.md +2 -2
  4. package/SPEC.md +3 -0
  5. package/assets/host-launcher.mjs +167 -0
  6. package/dist/acquire.d.ts +13 -0
  7. package/dist/acquire.d.ts.map +1 -0
  8. package/dist/acquire.js +46 -0
  9. package/dist/acquire.js.map +1 -0
  10. package/dist/archive.d.ts +20 -0
  11. package/dist/archive.d.ts.map +1 -0
  12. package/dist/archive.js +158 -0
  13. package/dist/archive.js.map +1 -0
  14. package/dist/authoring-assets.d.ts +11 -0
  15. package/dist/authoring-assets.d.ts.map +1 -0
  16. package/dist/authoring-assets.js +251 -0
  17. package/dist/authoring-assets.js.map +1 -0
  18. package/dist/bounded-fetch.d.ts +17 -0
  19. package/dist/bounded-fetch.d.ts.map +1 -0
  20. package/dist/bounded-fetch.js +67 -0
  21. package/dist/bounded-fetch.js.map +1 -0
  22. package/dist/cli.d.ts +3 -0
  23. package/dist/cli.d.ts.map +1 -0
  24. package/dist/cli.js +29 -0
  25. package/dist/cli.js.map +1 -0
  26. package/dist/command.d.ts +6 -0
  27. package/dist/command.d.ts.map +1 -0
  28. package/dist/command.js +189 -0
  29. package/dist/command.js.map +1 -0
  30. package/dist/config.d.ts +4 -0
  31. package/dist/config.d.ts.map +1 -0
  32. package/dist/config.js +43 -0
  33. package/dist/config.js.map +1 -0
  34. package/dist/decisions.d.ts +26 -0
  35. package/dist/decisions.d.ts.map +1 -0
  36. package/dist/decisions.js +119 -0
  37. package/dist/decisions.js.map +1 -0
  38. package/dist/files.d.ts +38 -0
  39. package/dist/files.d.ts.map +1 -0
  40. package/dist/files.js +224 -0
  41. package/dist/files.js.map +1 -0
  42. package/dist/guard-registration.d.ts +95 -0
  43. package/dist/guard-registration.d.ts.map +1 -0
  44. package/dist/guard-registration.js +282 -0
  45. package/dist/guard-registration.js.map +1 -0
  46. package/dist/host-home.d.ts +33 -0
  47. package/dist/host-home.d.ts.map +1 -0
  48. package/dist/host-home.js +116 -0
  49. package/dist/host-home.js.map +1 -0
  50. package/dist/host-modes.d.ts +13 -0
  51. package/dist/host-modes.d.ts.map +1 -0
  52. package/dist/host-modes.js +36 -0
  53. package/dist/host-modes.js.map +1 -0
  54. package/dist/host-observe.d.ts +24 -0
  55. package/dist/host-observe.d.ts.map +1 -0
  56. package/dist/host-observe.js +233 -0
  57. package/dist/host-observe.js.map +1 -0
  58. package/dist/host.d.ts +100 -0
  59. package/dist/host.d.ts.map +1 -0
  60. package/dist/host.js +505 -0
  61. package/dist/host.js.map +1 -0
  62. package/dist/hosts.d.ts +66 -0
  63. package/dist/hosts.d.ts.map +1 -0
  64. package/dist/hosts.js +39 -0
  65. package/dist/hosts.js.map +1 -0
  66. package/dist/ia-home.d.ts +15 -0
  67. package/dist/ia-home.d.ts.map +1 -0
  68. package/dist/ia-home.js +101 -0
  69. package/dist/ia-home.js.map +1 -0
  70. package/dist/install.d.ts +56 -0
  71. package/dist/install.d.ts.map +1 -0
  72. package/dist/install.js +402 -0
  73. package/dist/install.js.map +1 -0
  74. package/dist/installation-core.d.ts +41 -0
  75. package/dist/installation-core.d.ts.map +1 -0
  76. package/dist/installation-core.js +163 -0
  77. package/dist/installation-core.js.map +1 -0
  78. package/dist/inventory.d.ts +3 -0
  79. package/dist/inventory.d.ts.map +1 -0
  80. package/dist/inventory.js +49 -0
  81. package/dist/inventory.js.map +1 -0
  82. package/dist/json-edit.d.ts +19 -0
  83. package/dist/json-edit.d.ts.map +1 -0
  84. package/dist/json-edit.js +81 -0
  85. package/dist/json-edit.js.map +1 -0
  86. package/dist/lifecycle-registration.d.ts +46 -0
  87. package/dist/lifecycle-registration.d.ts.map +1 -0
  88. package/dist/lifecycle-registration.js +332 -0
  89. package/dist/lifecycle-registration.js.map +1 -0
  90. package/dist/minting.d.ts +46 -0
  91. package/dist/minting.d.ts.map +1 -0
  92. package/dist/minting.js +192 -0
  93. package/dist/minting.js.map +1 -0
  94. package/dist/native-command.d.ts +6 -0
  95. package/dist/native-command.d.ts.map +1 -0
  96. package/dist/native-command.js +273 -0
  97. package/dist/native-command.js.map +1 -0
  98. package/dist/pack.d.ts +4 -0
  99. package/dist/pack.d.ts.map +1 -0
  100. package/dist/pack.js +30 -0
  101. package/dist/pack.js.map +1 -0
  102. package/dist/plugin-home.d.ts +45 -0
  103. package/dist/plugin-home.d.ts.map +1 -0
  104. package/dist/plugin-home.js +371 -0
  105. package/dist/plugin-home.js.map +1 -0
  106. package/dist/projection.d.ts +45 -0
  107. package/dist/projection.d.ts.map +1 -0
  108. package/dist/projection.js +218 -0
  109. package/dist/projection.js.map +1 -0
  110. package/dist/publication.d.ts +20 -0
  111. package/dist/publication.d.ts.map +1 -0
  112. package/dist/publication.js +284 -0
  113. package/dist/publication.js.map +1 -0
  114. package/dist/registry-admission.d.ts +5 -0
  115. package/dist/registry-admission.d.ts.map +1 -0
  116. package/dist/registry-admission.js +17 -0
  117. package/dist/registry-admission.js.map +1 -0
  118. package/dist/registry-build.d.ts +35 -0
  119. package/dist/registry-build.d.ts.map +1 -0
  120. package/dist/registry-build.js +156 -0
  121. package/dist/registry-build.js.map +1 -0
  122. package/dist/registry-config.d.ts +32 -0
  123. package/dist/registry-config.d.ts.map +1 -0
  124. package/dist/registry-config.js +191 -0
  125. package/dist/registry-config.js.map +1 -0
  126. package/dist/registry-layout.d.ts +41 -0
  127. package/dist/registry-layout.d.ts.map +1 -0
  128. package/dist/registry-layout.js +142 -0
  129. package/dist/registry-layout.js.map +1 -0
  130. package/dist/registry-resolve.d.ts +56 -0
  131. package/dist/registry-resolve.d.ts.map +1 -0
  132. package/dist/registry-resolve.js +406 -0
  133. package/dist/registry-resolve.js.map +1 -0
  134. package/dist/registry-source.d.ts +37 -0
  135. package/dist/registry-source.d.ts.map +1 -0
  136. package/dist/registry-source.js +101 -0
  137. package/dist/registry-source.js.map +1 -0
  138. package/dist/registry.d.ts +10 -0
  139. package/dist/registry.d.ts.map +1 -0
  140. package/dist/registry.js +6 -0
  141. package/dist/registry.js.map +1 -0
  142. package/dist/resolve.d.ts +31 -0
  143. package/dist/resolve.d.ts.map +1 -0
  144. package/dist/resolve.js +115 -0
  145. package/dist/resolve.js.map +1 -0
  146. package/dist/services.d.ts +179 -0
  147. package/dist/services.d.ts.map +1 -0
  148. package/dist/services.js +290 -0
  149. package/dist/services.js.map +1 -0
  150. package/dist/snapshot.d.ts +19 -0
  151. package/dist/snapshot.d.ts.map +1 -0
  152. package/dist/snapshot.js +309 -0
  153. package/dist/snapshot.js.map +1 -0
  154. package/dist/transfer.d.ts +22 -0
  155. package/dist/transfer.d.ts.map +1 -0
  156. package/dist/transfer.js +98 -0
  157. package/dist/transfer.js.map +1 -0
  158. package/dist/updates.d.ts +57 -0
  159. package/dist/updates.d.ts.map +1 -0
  160. package/dist/updates.js +174 -0
  161. package/dist/updates.js.map +1 -0
  162. package/dist/ustar.d.ts +28 -0
  163. package/dist/ustar.d.ts.map +1 -0
  164. package/dist/ustar.js +145 -0
  165. package/dist/ustar.js.map +1 -0
  166. package/package.json +305 -3
@@ -0,0 +1,31 @@
1
+ import { deriveGenerationInputs } from '@inventarch/db/distribution';
2
+ import type { BundleMetadata, Dependency, DistributionLock, GenerationInputs } from '@inventarch/db/distribution';
3
+ import type { VerifiedArchive } from './archive.js';
4
+ /** `release` is a verified archive by default; resolution reads only its manifest-level metadata, so a caller may hold just that. */
5
+ export interface ReleaseCandidate<R extends BundleMetadata = VerifiedArchive> {
6
+ readonly release: R;
7
+ readonly location: string;
8
+ readonly withdrawn: boolean;
9
+ }
10
+ export interface Resolution<R extends BundleMetadata = VerifiedArchive> {
11
+ readonly lock: DistributionLock;
12
+ readonly releases: ReadonlyMap<string, R>;
13
+ readonly inputs: GenerationInputs;
14
+ readonly assignments: number;
15
+ }
16
+ export declare const generationInputs: typeof deriveGenerationInputs;
17
+ /** One candidate view the search needs; archives and registry metadata both provide it. */
18
+ export interface Choice {
19
+ readonly id: string;
20
+ readonly version: string;
21
+ readonly engine: string;
22
+ readonly dependencies: readonly Dependency[];
23
+ readonly archive: string;
24
+ readonly withdrawn: boolean;
25
+ }
26
+ export type MetadataCandidate = Choice;
27
+ /** Deterministic finite search; no channels, fetches or mutation occur here. */
28
+ export declare function resolveReleases<R extends BundleMetadata = VerifiedArchive>(requestsInput: readonly Dependency[], catalog: readonly ReleaseCandidate<R>[], engine: string, existing?: DistributionLock): Resolution<R>;
29
+ /** Selects a complete release set from registry metadata alone; the caller fetches only the chosen archives. `preferred` maps id to the pinned archive. */
30
+ export declare function selectReleases(requestsInput: readonly Dependency[], candidates: readonly MetadataCandidate[], engine: string, preferred?: ReadonlyMap<string, string>): ReadonlyMap<string, MetadataCandidate>;
31
+ //# sourceMappingURL=resolve.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,sBAAsB,EAGvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,qIAAqI;AACrI,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,eAAe;IAC1E,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AACD,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,cAAc,GAAG,eAAe;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AACD,eAAO,MAAM,gBAAgB,+BAAyB,CAAC;AACvD,2FAA2F;AAC3F,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AACD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AA8EvC,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,CAAC,SAAS,cAAc,GAAG,eAAe,EACxE,aAAa,EAAE,SAAS,UAAU,EAAE,EACpC,OAAO,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,EACvC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,UAAU,CAAC,CAAC,CAAC,CA4Cf;AACD,2JAA2J;AAC3J,wBAAgB,cAAc,CAC5B,aAAa,EAAE,SAAS,UAAU,EAAE,EACpC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GACjD,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAWxC"}
@@ -0,0 +1,115 @@
1
+ import { compareVersions, decodeDistributionLock, decodeDistributionRequests, deriveGenerationInputs, DISTRIBUTION_LIMITS, satisfies, } from '@inventarch/db/distribution';
2
+ import { fail } from './files.js';
3
+ export const generationInputs = deriveGenerationInputs;
4
+ const archiveChoice = (c) => ({
5
+ id: c.release.manifest.id,
6
+ version: c.release.manifest.version,
7
+ engine: c.release.manifest.engine,
8
+ dependencies: c.release.manifest.dependencies,
9
+ archive: c.release.archiveDigest,
10
+ withdrawn: c.withdrawn,
11
+ });
12
+ /**
13
+ * Registry spec §5.2: the one search shared by metadata selection and archive resolution. The existing pin sorts
14
+ * first, then the highest version. `accept` sees each complete leaf and returns true, or a reason that is recorded
15
+ * before the search backtracks; anything it throws propagates.
16
+ */
17
+ function searchChoices(requests, candidates, view, engine, preferred, accept) {
18
+ let assignments = 0;
19
+ const reasons = new Set(), views = new Map(candidates.map((c) => [c, view(c)])), see = (c) => views.get(c);
20
+ const search = (selected, constraints) => {
21
+ for (const [id, c] of selected)
22
+ if (constraints.some((k) => k.id === id && !satisfies(see(c).version, k.range)))
23
+ return undefined;
24
+ const unresolved = [...new Set(constraints.map((k) => k.id))].filter((id) => !selected.has(id)).sort();
25
+ if (!unresolved.length) {
26
+ const verdict = accept(selected, assignments);
27
+ if (verdict === true)
28
+ return selected;
29
+ reasons.add(verdict);
30
+ return undefined;
31
+ }
32
+ const id = unresolved[0], needed = constraints.filter((k) => k.id === id), old = preferred.get(id);
33
+ const options = candidates
34
+ .filter((c) => {
35
+ const v = see(c);
36
+ return (v.id === id &&
37
+ !v.withdrawn &&
38
+ satisfies(engine, v.engine) &&
39
+ needed.every((n) => satisfies(v.version, n.range)));
40
+ })
41
+ .sort((a, b) => Number(see(b).archive === old) - Number(see(a).archive === old) ||
42
+ compareVersions(see(a).version, see(b).version)); // rcompare: highest first
43
+ if (!options.length)
44
+ reasons.add(`${id}: ${needed.map((k) => `${k.range} from ${k.by}`).join('; ')}`);
45
+ for (const c of options) {
46
+ if (++assignments > DISTRIBUTION_LIMITS.assignments)
47
+ fail('RESOLUTION-LIMIT', 'Dependency solving exceeded 1000 candidate assignments');
48
+ const next = new Map(selected);
49
+ next.set(id, c);
50
+ const result = search(next, [
51
+ ...constraints,
52
+ ...see(c).dependencies.map((d) => ({ ...d, by: `${id}@${see(c).version}` })),
53
+ ]);
54
+ if (result)
55
+ return result;
56
+ }
57
+ return undefined;
58
+ };
59
+ const result = search(new Map(), requests.map((r) => ({ ...r, by: 'direct request' })));
60
+ if (!result)
61
+ fail('CONFLICT', `No compatible complete release set: ${[...reasons].slice(0, 30).join(' | ')}`);
62
+ return result;
63
+ }
64
+ /** Deterministic finite search; no channels, fetches or mutation occur here. */
65
+ export function resolveReleases(requestsInput, catalog, engine, existing) {
66
+ const requests = decodeDistributionRequests(requestsInput);
67
+ if (catalog.length > 1000)
68
+ fail('LIMIT-EXCEEDED', 'Release catalog exceeds 1000 candidates');
69
+ const seen = new Map();
70
+ for (const candidate of [...catalog].sort((a, b) => a.location < b.location ? -1 : a.location > b.location ? 1 : 0)) {
71
+ const key = `${candidate.release.manifest.id}@${candidate.release.manifest.version}`, prior = seen.get(key);
72
+ if (prior &&
73
+ (prior.release.archiveDigest !== candidate.release.archiveDigest || prior.withdrawn !== candidate.withdrawn))
74
+ fail('CONFLICT', `Immutable release identity has different bytes/status: ${key}`);
75
+ if (!prior)
76
+ seen.set(key, candidate);
77
+ }
78
+ const unique = [...seen.values()], pins = new Map();
79
+ for (const p of existing?.packages ?? [])
80
+ if (!pins.has(p.id))
81
+ pins.set(p.id, p.archive);
82
+ let built;
83
+ searchChoices(requests, unique, archiveChoice, engine, pins, (selected, assignments) => {
84
+ const entries = [...selected].sort(([a], [b]) => (a < b ? -1 : 1)), releases = new Map(entries.map(([id, c]) => [id, c.release]));
85
+ const lock = decodeDistributionLock({
86
+ formatVersion: 1,
87
+ engine,
88
+ requests,
89
+ packages: entries.map(([id, c]) => ({
90
+ id,
91
+ version: c.release.manifest.version,
92
+ archive: c.release.archiveDigest,
93
+ manifest: c.release.manifestDigest,
94
+ location: c.location,
95
+ dependencies: c.release.manifest.dependencies.map((d) => d.id),
96
+ })),
97
+ });
98
+ try {
99
+ built = { lock, releases, inputs: generationInputs(lock, releases), assignments };
100
+ return true;
101
+ }
102
+ catch (error) {
103
+ return String(error);
104
+ }
105
+ });
106
+ return built;
107
+ }
108
+ /** Selects a complete release set from registry metadata alone; the caller fetches only the chosen archives. `preferred` maps id to the pinned archive. */
109
+ export function selectReleases(requestsInput, candidates, engine, preferred = new Map()) {
110
+ const requests = decodeDistributionRequests(requestsInput);
111
+ if (candidates.length > 1000)
112
+ fail('LIMIT-EXCEEDED', 'Release catalog exceeds 1000 candidates');
113
+ return searchChoices(requests, candidates, (c) => c, engine, preferred, () => true);
114
+ }
115
+ //# sourceMappingURL=resolve.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,179 @@
1
+ import type { Handle } from '@inventarch/db';
2
+ import type { ActivationPointer, BundleMetadata, DistributionLock, GenerationInputs } from '@inventarch/db/distribution';
3
+ import type { DraftResult } from '@inventarch/authoring-system';
4
+ import type { InstallationPlan } from './install.js';
5
+ import type { PackedDistribution } from './snapshot.js';
6
+ import type { ReleaseCandidate } from './resolve.js';
7
+ import type { HostObservation } from './host-observe.js';
8
+ export { createFile, json, replace, sha256, DistributionError } from './files.js';
9
+ export { acquireArtifact } from './acquire.js';
10
+ export type { ArtifactRequest } from './acquire.js';
11
+ export type { HostObservation } from './host-observe.js';
12
+ /**
13
+ * The language identity a compiled artifact is produced under. It travels as a service value because a
14
+ * presentation host may not depend on @inventarch/language, and because the two constants belong together: a digest
15
+ * without its version names nothing.
16
+ */
17
+ export declare const LANGUAGE_IDENTITY: {
18
+ readonly language: string;
19
+ readonly kernelDigest: string;
20
+ };
21
+ export type { InstallationPlan } from './install.js';
22
+ export type { ReleaseCandidate } from './resolve.js';
23
+ export type { BundleMetadata } from '@inventarch/db/distribution';
24
+ export type { DraftResult } from '@inventarch/authoring-system';
25
+ type Findings = Handle['report']['findings'];
26
+ /**
27
+ * Every exported service resolves its own `root` through workspace(), so no caller inherits an
28
+ * unstated precondition about which of the two meanings a root string carries. The resolution is
29
+ * idempotent, and services that compose re-resolve an already-resolved root rather than trusting it.
30
+ */
31
+ export interface WorkspaceFileRequest {
32
+ readonly root: string;
33
+ readonly path: string;
34
+ readonly limit?: number;
35
+ }
36
+ export declare function readWorkspaceFile(request: WorkspaceFileRequest): Buffer;
37
+ export declare function readWorkspaceJson(request: WorkspaceFileRequest): unknown;
38
+ export declare function readWorkspaceLock(options: {
39
+ readonly root: string;
40
+ }): DistributionLock;
41
+ export interface WorkOutputRequest {
42
+ readonly root: string;
43
+ readonly path: string;
44
+ /** Authoring drafts accept an absolute path inside the explicit root; saved plans never do. */
45
+ readonly acceptAbsolute?: boolean;
46
+ /** The whole refusal message, used as given. Every absolute spelling is refused by portable() first. */
47
+ readonly refusal?: string;
48
+ }
49
+ export declare function workOutputPath(request: WorkOutputRequest): string;
50
+ /**
51
+ * Newness is a separate rule from placement: createFile refuses an existing entry with
52
+ * LOCAL-MODIFICATION. Content resolves after the placement check so serializing a value that can
53
+ * itself refuse never preempts an unsafe destination.
54
+ */
55
+ export declare function writeWorkOutput(request: WorkOutputRequest & {
56
+ readonly content: Buffer | (() => Buffer);
57
+ }): string;
58
+ export interface InstalledState {
59
+ readonly status: 'installed' | 'uninstalled';
60
+ readonly pointer?: ActivationPointer;
61
+ readonly lock?: DistributionLock;
62
+ readonly inputs?: GenerationInputs;
63
+ /**
64
+ * Spec §7: observed per host, only when the caller opts in via `hosts: true`. Absent — never `[]` — when not
65
+ * requested, so a caller cannot mistake "didn't ask" for "asked, and none are registered". Observation walks
66
+ * every managed file under `.ia/distributions/hosts/`, so callers that don't need it (`distribute.ts`, `init.ts`,
67
+ * the native `list`/`doctor` body) must not pay for it.
68
+ */
69
+ readonly hosts?: readonly HostObservation[];
70
+ }
71
+ export declare function readInstalledState(options: {
72
+ readonly root: string;
73
+ readonly hosts?: boolean;
74
+ readonly hostRelease?: string | null;
75
+ }): InstalledState;
76
+ export interface CatalogRequest {
77
+ readonly root: string;
78
+ readonly entries: unknown;
79
+ readonly offline?: boolean;
80
+ readonly signal?: AbortSignal | undefined;
81
+ }
82
+ export declare function resolveCatalog(request: CatalogRequest): Promise<readonly ReleaseCandidate[]>;
83
+ export interface CachedCandidatesRequest {
84
+ readonly root: string;
85
+ /**
86
+ * The ids to start from (a command's request ids and locked ids). Given, only cached releases whose id is in the dependency
87
+ * closure of these ids over every cached manifest (all versions) are returned, so a stale duplicate of an unrelated
88
+ * `id@version` never reaches resolution. Absent, every cached release is returned.
89
+ */
90
+ readonly reach?: readonly string[];
91
+ }
92
+ /**
93
+ * Registry spec §5.4: `--offline` without a catalog resolves from the workspace cache. Every `<digest>.ia.tgz` file there,
94
+ * in name order, passes canonical byte-integrity checks against the digest its name carries and is offered at `sha256:<digest>`; the cache holds no
95
+ * withdrawal state, so none is withdrawn. Other names and subdirectories are ignored; a link or hard link refuses (`bytes`).
96
+ * Only manifest-level metadata is kept: planning re-reads and re-verifies the selected archives, so holding up to 1,000
97
+ * archives' files here would buy nothing. Every cached archive has its byte integrity checked, reachable or not. Authoring readiness belongs only to final selected-closure planning, not metadata enumeration.
98
+ */
99
+ export declare function cachedCandidates(options: CachedCandidatesRequest): readonly ReleaseCandidate<BundleMetadata>[];
100
+ export interface RestoreRequest {
101
+ readonly root: string;
102
+ readonly lock?: DistributionLock;
103
+ readonly catalog?: unknown;
104
+ /**
105
+ * Registry spec §6.3: the locked `id@version` pins the registry marks withdrawn (`registryWithdrawals`). Supplied, it
106
+ * replaces the catalog: no catalog is read or matched, and the pins name the refusal verbatim. It excludes `catalog`
107
+ * (INPUT-INVALID when both are given), and offline ignores it as it ignores the catalog.
108
+ */
109
+ readonly withdrawn?: readonly string[];
110
+ readonly signal?: AbortSignal | undefined;
111
+ readonly offline?: boolean;
112
+ readonly allowWithdrawn?: boolean;
113
+ /** Prefix only; the service appends `: <ids>`. The caller owns it because it names its own opt-in. */
114
+ readonly withdrawnRefusalPrefix?: string;
115
+ }
116
+ export interface RestorePlan {
117
+ readonly plan: InstallationPlan;
118
+ readonly withdrawn: readonly string[];
119
+ }
120
+ /** Planning only: acquisition and the withdrawal decision happen here, activation does not. */
121
+ export declare function planRestore(request: RestoreRequest): Promise<RestorePlan>;
122
+ export declare function pruneLockRequest(options: {
123
+ readonly lock: DistributionLock;
124
+ readonly id: string;
125
+ }): DistributionLock;
126
+ export interface PackRequest {
127
+ readonly sourceRoot: string;
128
+ readonly descriptorPath: string;
129
+ /** Resolved after packing, so no destination is selected or created for an archive that never exists. */
130
+ readonly outputRoot: string | (() => string);
131
+ }
132
+ export interface PackedArchive {
133
+ readonly status: 'packed';
134
+ readonly path: string;
135
+ readonly archive: string;
136
+ readonly manifestDigest: string;
137
+ readonly manifest: PackedDistribution['manifest'];
138
+ readonly sourceFingerprint: string;
139
+ }
140
+ export declare function packToDirectory(request: PackRequest): PackedArchive;
141
+ export interface WorkspaceAdmission {
142
+ readonly status: 'admitted' | 'refused';
143
+ readonly revision: string;
144
+ readonly findings: Findings;
145
+ readonly records: number;
146
+ }
147
+ export interface WorkspaceSession {
148
+ readonly reader: Handle;
149
+ /** The complete disclosed workspace scope; refuses while admission has errors. */
150
+ within(): string;
151
+ admission(): WorkspaceAdmission;
152
+ close(): void;
153
+ }
154
+ export declare function openWorkspaceSession(options: {
155
+ readonly root: string;
156
+ }): WorkspaceSession;
157
+ export declare function validateWorkspace(options: {
158
+ readonly root: string;
159
+ }): WorkspaceAdmission;
160
+ export type FormatOutcome = {
161
+ readonly status: 'draft';
162
+ readonly path: string;
163
+ readonly text: string;
164
+ readonly baseRevision: string;
165
+ readonly candidateRevision: string;
166
+ readonly findings: DraftResult['evidence']['findings'];
167
+ } | {
168
+ readonly status: 'refused';
169
+ readonly diagnostics: readonly unknown[];
170
+ };
171
+ export interface FormatRequest {
172
+ readonly session: WorkspaceSession;
173
+ readonly path: string;
174
+ readonly text: string;
175
+ /** Re-reads the caller's source; a differing value means the returned draft describes stale input. */
176
+ readonly reread?: () => string;
177
+ }
178
+ export declare function formatSource(request: FormatRequest): FormatOutcome;
179
+ //# sourceMappingURL=services.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,290 @@
1
+ import { existsSync, lstatSync, readdirSync } from 'node:fs';
2
+ import { isAbsolute, relative, resolve } from 'node:path';
3
+ import { open } from '@inventarch/db';
4
+ import { decodeDistributionJson, decodeDistributionLock, DISTRIBUTION_LIMITS, INSTALL_PATHS, readInstalledGeneration, } from '@inventarch/db/distribution';
5
+ import { DraftError, formatDraft } from '@inventarch/authoring-system';
6
+ import { KERNEL_DIGEST, LANGUAGE_VERSION } from '@inventarch/language';
7
+ import { acquireArtifact, readArtifactBytes } from './acquire.js';
8
+ import { inspectArchiveMetadata } from './archive.js';
9
+ import { ARCHIVE_CACHE, cacheArchive, cacheSelectedArchiveClosure, CACHED_ARCHIVE_NAME, cachePath, planInstallation, } from './install.js';
10
+ import { packDistribution } from './pack.js';
11
+ import { bytes, contained, createFile, fail, locate, object, portable, utf8, workspace } from './files.js';
12
+ import { observeHosts } from './host-observe.js';
13
+ export { createFile, json, replace, sha256, DistributionError } from './files.js';
14
+ export { acquireArtifact } from './acquire.js';
15
+ /**
16
+ * The language identity a compiled artifact is produced under. It travels as a service value because a
17
+ * presentation host may not depend on @inventarch/language, and because the two constants belong together: a digest
18
+ * without its version names nothing.
19
+ */
20
+ export const LANGUAGE_IDENTITY = Object.freeze({
21
+ language: LANGUAGE_VERSION,
22
+ kernelDigest: KERNEL_DIGEST,
23
+ });
24
+ export function readWorkspaceFile(request) {
25
+ const path = portable(request.path), root = workspace(request.root);
26
+ return (bytes(root, path, request.limit ?? DISTRIBUTION_LIMITS.metadata) ??
27
+ fail('INPUT-INVALID', `Missing input ${request.path}`));
28
+ }
29
+ export function readWorkspaceJson(request) {
30
+ return decodeDistributionJson(utf8(readWorkspaceFile(request)));
31
+ }
32
+ export function readWorkspaceLock(options) {
33
+ return decodeDistributionLock(readWorkspaceJson({ root: options.root, path: INSTALL_PATHS.lock }));
34
+ }
35
+ const placement = (root, request) => {
36
+ const supplied = request.acceptAbsolute === true && isAbsolute(request.path)
37
+ ? relative(root, resolve(request.path)).replaceAll('\\', '/')
38
+ : request.path;
39
+ const path = portable(supplied);
40
+ if (!path.startsWith('.ia/work/'))
41
+ fail('PATH-UNSAFE', request.refusal ?? 'Saved plans require a new .ia/work file');
42
+ return path;
43
+ };
44
+ export function workOutputPath(request) {
45
+ return placement(workspace(request.root), request);
46
+ }
47
+ /**
48
+ * Newness is a separate rule from placement: createFile refuses an existing entry with
49
+ * LOCAL-MODIFICATION. Content resolves after the placement check so serializing a value that can
50
+ * itself refuse never preempts an unsafe destination.
51
+ */
52
+ export function writeWorkOutput(request) {
53
+ const root = workspace(request.root), path = placement(root, request);
54
+ createFile(root, path, typeof request.content === 'function' ? request.content() : request.content);
55
+ return path;
56
+ }
57
+ export function readInstalledState(options) {
58
+ const root = workspace(options.root), installed = readInstalledGeneration(root);
59
+ const hosts = options.hosts === true ? { hosts: observeHosts(root, options.hostRelease ?? null) } : {};
60
+ return installed
61
+ ? { status: 'installed', pointer: installed.pointer, lock: installed.lock, inputs: installed.inputs, ...hosts }
62
+ : { status: 'uninstalled', ...hosts };
63
+ }
64
+ export async function resolveCatalog(request) {
65
+ request.signal?.throwIfAborted();
66
+ const { entries } = request, offline = request.offline === true;
67
+ if (!Array.isArray(entries) || entries.length > 1000)
68
+ fail('INPUT-INVALID', 'Expected bounded release catalog');
69
+ const root = workspace(request.root), result = [];
70
+ for (const entry of entries) {
71
+ request.signal?.throwIfAborted();
72
+ const row = object(entry, Object.hasOwn(entry ?? {}, 'path') ? ['path', 'withdrawn'] : ['url', 'digest', 'withdrawn']);
73
+ if (typeof row['withdrawn'] !== 'boolean')
74
+ fail('INPUT-INVALID', 'Expected withdrawal flag');
75
+ if (typeof row['path'] === 'string') {
76
+ const content = bytes(root, portable(row['path']), DISTRIBUTION_LIMITS.compressed);
77
+ if (!content)
78
+ fail('ARTIFACT-UNAVAILABLE', 'Missing selected local archive');
79
+ const release = cacheArchive(root, content);
80
+ result.push({ release, location: `sha256:${release.archiveDigest}`, withdrawn: row['withdrawn'] });
81
+ }
82
+ else {
83
+ if (typeof row['url'] !== 'string' || typeof row['digest'] !== 'string')
84
+ fail('INPUT-INVALID', 'Invalid remote catalog entry');
85
+ result.push({
86
+ ...(await acquireArtifact({ root, url: row['url'], digest: row['digest'], offline, signal: request.signal })),
87
+ withdrawn: row['withdrawn'],
88
+ });
89
+ }
90
+ }
91
+ return result;
92
+ }
93
+ /**
94
+ * Registry spec §5.4: `--offline` without a catalog resolves from the workspace cache. Every `<digest>.ia.tgz` file there,
95
+ * in name order, passes canonical byte-integrity checks against the digest its name carries and is offered at `sha256:<digest>`; the cache holds no
96
+ * withdrawal state, so none is withdrawn. Other names and subdirectories are ignored; a link or hard link refuses (`bytes`).
97
+ * Only manifest-level metadata is kept: planning re-reads and re-verifies the selected archives, so holding up to 1,000
98
+ * archives' files here would buy nothing. Every cached archive has its byte integrity checked, reachable or not. Authoring readiness belongs only to final selected-closure planning, not metadata enumeration.
99
+ */
100
+ export function cachedCandidates(options) {
101
+ const { reach } = options;
102
+ if (reach !== undefined && (!Array.isArray(reach) || !reach.every((id) => typeof id === 'string')))
103
+ fail('INPUT-INVALID', 'Expected a list of distribution ids to reach');
104
+ const root = workspace(options.root), directory = contained(root, ARCHIVE_CACHE);
105
+ if (!existsSync(directory))
106
+ return [];
107
+ if (!lstatSync(directory).isDirectory())
108
+ fail('PATH-UNSAFE', `Archive cache is not a directory: ${ARCHIVE_CACHE}`);
109
+ const digests = readdirSync(directory, { withFileTypes: true })
110
+ .filter((e) => !e.isDirectory())
111
+ .map((e) => CACHED_ARCHIVE_NAME.exec(e.name)?.[1])
112
+ .filter((d) => d !== undefined)
113
+ .sort();
114
+ // Checked before any archive is read, the same bound a catalog carries.
115
+ if (digests.length > 1000)
116
+ fail('LIMIT-EXCEEDED', 'Archive cache holds more than 1000 archives');
117
+ const candidates = digests.map((digest) => {
118
+ const path = cachePath(digest);
119
+ return locate(path, () => {
120
+ const content = bytes(root, path, DISTRIBUTION_LIMITS.compressed) ??
121
+ fail('SOURCE-CHANGED', `Archive cache changed while reading: ${path}`);
122
+ const { manifest, archiveDigest, manifestDigest } = inspectArchiveMetadata(content, digest).pending;
123
+ return {
124
+ release: Object.freeze({ manifest, archiveDigest, manifestDigest }),
125
+ location: `sha256:${digest}`,
126
+ withdrawn: false,
127
+ };
128
+ });
129
+ });
130
+ if (reach === undefined)
131
+ return candidates;
132
+ const closure = new Set(reach), pending = [...closure];
133
+ while (pending.length) {
134
+ const id = pending.pop();
135
+ for (const c of candidates)
136
+ if (c.release.manifest.id === id)
137
+ for (const d of c.release.manifest.dependencies)
138
+ if (!closure.has(d.id)) {
139
+ closure.add(d.id);
140
+ pending.push(d.id);
141
+ }
142
+ }
143
+ return candidates.filter((c) => closure.has(c.release.manifest.id));
144
+ }
145
+ /** Withdrawal pins are distinct locked `id@version` strings, at most one per locked package. */
146
+ function registryPins(lock, input) {
147
+ const locked = new Set(lock.packages.map((p) => `${p.id}@${p.version}`));
148
+ if (!Array.isArray(input) ||
149
+ input.length > locked.size ||
150
+ new Set(input).size !== input.length ||
151
+ !input.every((pin) => typeof pin === 'string' && locked.has(pin)))
152
+ fail('INPUT-INVALID', 'Expected distinct locked id@version withdrawal pins');
153
+ return input;
154
+ }
155
+ /** Planning only: acquisition and the withdrawal decision happen here, activation does not. */
156
+ export async function planRestore(request) {
157
+ request.signal?.throwIfAborted();
158
+ const root = workspace(request.root), offline = request.offline === true;
159
+ if (request.catalog !== undefined && request.withdrawn !== undefined)
160
+ fail('INPUT-INVALID', 'Restore takes a catalog or registry withdrawals, not both');
161
+ const lock = decodeDistributionLock(request.lock ?? readWorkspaceLock({ root })), withdrawn = [];
162
+ if (!offline && request.withdrawn !== undefined)
163
+ withdrawn.push(...registryPins(lock, request.withdrawn));
164
+ else if (!offline) {
165
+ const entries = await resolveCatalog({ root, entries: request.catalog, offline: false, signal: request.signal });
166
+ for (const pkg of lock.packages) {
167
+ const matches = entries.filter((e) => e.release.archiveDigest === pkg.archive &&
168
+ e.release.manifestDigest === pkg.manifest &&
169
+ e.release.manifest.id === pkg.id &&
170
+ e.release.manifest.version === pkg.version);
171
+ if (!matches.length)
172
+ fail('RESTORE-REQUIRED', `Connected catalog lacks locked ${pkg.id}; use exact offline artifacts or supply the release entry`);
173
+ if (matches.some((e) => e.withdrawn))
174
+ withdrawn.push(pkg.id);
175
+ }
176
+ }
177
+ if (withdrawn.length && request.allowWithdrawn !== true)
178
+ fail('RELEASE-WITHDRAWN', `${request.withdrawnRefusalPrefix ?? 'Explicit withdrawal acceptance is required for'}: ${withdrawn.join(', ')}`);
179
+ const archives = new Map();
180
+ let total = 0;
181
+ for (const pkg of lock.packages) {
182
+ request.signal?.throwIfAborted();
183
+ const content = pkg.location.startsWith('https:')
184
+ ? await readArtifactBytes({ root, url: pkg.location, digest: pkg.archive, offline, signal: request.signal })
185
+ : (bytes(root, cachePath(pkg.archive), DISTRIBUTION_LIMITS.compressed) ??
186
+ fail('RESTORE-REQUIRED', `Missing cached archive ${pkg.archive}; supply its exact bytes`));
187
+ total += content.length;
188
+ if (total > DISTRIBUTION_LIMITS.expanded)
189
+ fail('LIMIT-EXCEEDED', 'Combined restore archive selection exceeds its ceiling');
190
+ archives.set(pkg.archive, content);
191
+ }
192
+ request.signal?.throwIfAborted();
193
+ cacheSelectedArchiveClosure(root, lock, archives);
194
+ return { plan: planInstallation(root, lock, 'restore'), withdrawn };
195
+ }
196
+ export function pruneLockRequest(options) {
197
+ const { lock, id } = options;
198
+ if (!lock.requests.some((r) => r.id === id))
199
+ fail('INPUT-INVALID', 'Removal must name a directly requested distribution');
200
+ const requests = lock.requests.filter((r) => r.id !== id), keep = new Set(), byId = new Map(lock.packages.map((p) => [p.id, p]));
201
+ const visit = (key) => {
202
+ if (keep.has(key))
203
+ return;
204
+ keep.add(key);
205
+ byId.get(key).dependencies.forEach(visit);
206
+ };
207
+ requests.forEach((r) => visit(r.id));
208
+ if (keep.has(id))
209
+ fail('CONFLICT', 'Distribution is still required by another direct request');
210
+ return decodeDistributionLock({ ...lock, requests, packages: lock.packages.filter((p) => keep.has(p.id)) });
211
+ }
212
+ export function packToDirectory(request) {
213
+ const root = workspace(request.sourceRoot), path = request.descriptorPath, descriptor = readWorkspaceFile({ root, path });
214
+ const packed = packDistribution(root, utf8(descriptor));
215
+ const out = workspace(typeof request.outputRoot === 'function' ? request.outputRoot() : request.outputRoot);
216
+ if (!readWorkspaceFile({ root, path }).equals(descriptor))
217
+ fail('SOURCE-CHANGED', 'Release descriptor changed during packing');
218
+ const name = `${packed.archiveDigest}.ia.tgz`;
219
+ createFile(out, name, packed.bytes);
220
+ return {
221
+ status: 'packed',
222
+ path: name,
223
+ archive: packed.archiveDigest,
224
+ manifestDigest: packed.manifestDigest,
225
+ manifest: packed.manifest,
226
+ sourceFingerprint: packed.sourceFingerprint,
227
+ };
228
+ }
229
+ export function openWorkspaceSession(options) {
230
+ const reader = open(workspace(options.root), { cache: false });
231
+ // Nothing is captured. formatSource refreshes this same handle, and reader.report is a live getter
232
+ // over the state refresh() replaces, so a captured verdict beside a live revision could report an
233
+ // admitted status next to error findings. The scope token is minted per call for the same reason:
234
+ // refresh() builds a new view, an older token stays bound to the records of the older one, and a
235
+ // draft admitted against those is admitted against a workspace the handle no longer reports.
236
+ const errors = () => reader.report.findings.filter((f) => f.severity === 'error');
237
+ return {
238
+ reader,
239
+ within: () => {
240
+ if (errors().length)
241
+ fail('CLOSURE-INCOMPLETE', 'Workspace admission failed; run validate for diagnostics');
242
+ return reader.resolveScope().token;
243
+ },
244
+ admission: () => {
245
+ const findings = reader.report.findings;
246
+ return {
247
+ status: findings.some((f) => f.severity === 'error') ? 'refused' : 'admitted',
248
+ revision: reader.revision,
249
+ findings,
250
+ records: reader.records().length,
251
+ };
252
+ },
253
+ close: () => reader.close(),
254
+ };
255
+ }
256
+ export function validateWorkspace(options) {
257
+ const session = openWorkspaceSession(options);
258
+ try {
259
+ return session.admission();
260
+ }
261
+ finally {
262
+ session.close();
263
+ }
264
+ }
265
+ export function formatSource(request) {
266
+ const reader = request.session.reader, within = request.session.within();
267
+ const path = portable(request.path), baseRevision = reader.revision;
268
+ let formatted;
269
+ try {
270
+ formatted = formatDraft({ reader, within, revision: baseRevision }, { path, text: request.text });
271
+ }
272
+ catch (error) {
273
+ if (!(error instanceof DraftError))
274
+ throw error;
275
+ if (error.code === 'IA-EXEC-OUTPUT-UNSAFE')
276
+ fail('PATH-UNSAFE', error.message);
277
+ return { status: 'refused', diagnostics: error.diagnostics };
278
+ }
279
+ if (reader.refresh().revision !== baseRevision || (request.reread?.() ?? request.text) !== request.text)
280
+ fail('PLAN-STALE', 'Formatting inputs changed before returning the draft');
281
+ return {
282
+ status: 'draft',
283
+ path,
284
+ text: formatted.artifacts[0].text,
285
+ baseRevision,
286
+ candidateRevision: formatted.candidateRevision,
287
+ findings: formatted.evidence.findings,
288
+ };
289
+ }
290
+ //# sourceMappingURL=services.js.map