@inventarch/distribution 0.0.0-stage → 1.1.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.
- package/LANGUAGE.md +56 -0
- package/LICENSE +202 -0
- package/NOTICE +4 -0
- package/README.md +2 -2
- package/SPEC.md +5 -0
- package/assets/host-launcher.mjs +167 -0
- package/dist/acquire.d.ts +13 -0
- package/dist/acquire.d.ts.map +1 -0
- package/dist/acquire.js +46 -0
- package/dist/acquire.js.map +1 -0
- package/dist/archive.d.ts +20 -0
- package/dist/archive.d.ts.map +1 -0
- package/dist/archive.js +165 -0
- package/dist/archive.js.map +1 -0
- package/dist/authoring-assets.d.ts +11 -0
- package/dist/authoring-assets.d.ts.map +1 -0
- package/dist/authoring-assets.js +251 -0
- package/dist/authoring-assets.js.map +1 -0
- package/dist/bounded-fetch.d.ts +17 -0
- package/dist/bounded-fetch.d.ts.map +1 -0
- package/dist/bounded-fetch.js +67 -0
- package/dist/bounded-fetch.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +51 -0
- package/dist/cli.js.map +1 -0
- package/dist/command.d.ts +6 -0
- package/dist/command.d.ts.map +1 -0
- package/dist/command.js +189 -0
- package/dist/command.js.map +1 -0
- package/dist/config.d.ts +4 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +43 -0
- package/dist/config.js.map +1 -0
- package/dist/decisions.d.ts +26 -0
- package/dist/decisions.d.ts.map +1 -0
- package/dist/decisions.js +119 -0
- package/dist/decisions.js.map +1 -0
- package/dist/files.d.ts +38 -0
- package/dist/files.d.ts.map +1 -0
- package/dist/files.js +224 -0
- package/dist/files.js.map +1 -0
- package/dist/guard-registration.d.ts +95 -0
- package/dist/guard-registration.d.ts.map +1 -0
- package/dist/guard-registration.js +282 -0
- package/dist/guard-registration.js.map +1 -0
- package/dist/host-home.d.ts +33 -0
- package/dist/host-home.d.ts.map +1 -0
- package/dist/host-home.js +116 -0
- package/dist/host-home.js.map +1 -0
- package/dist/host-modes.d.ts +13 -0
- package/dist/host-modes.d.ts.map +1 -0
- package/dist/host-modes.js +36 -0
- package/dist/host-modes.js.map +1 -0
- package/dist/host-observe.d.ts +24 -0
- package/dist/host-observe.d.ts.map +1 -0
- package/dist/host-observe.js +233 -0
- package/dist/host-observe.js.map +1 -0
- package/dist/host.d.ts +100 -0
- package/dist/host.d.ts.map +1 -0
- package/dist/host.js +505 -0
- package/dist/host.js.map +1 -0
- package/dist/hosts.d.ts +66 -0
- package/dist/hosts.d.ts.map +1 -0
- package/dist/hosts.js +39 -0
- package/dist/hosts.js.map +1 -0
- package/dist/ia-home.d.ts +15 -0
- package/dist/ia-home.d.ts.map +1 -0
- package/dist/ia-home.js +101 -0
- package/dist/ia-home.js.map +1 -0
- package/dist/install.d.ts +56 -0
- package/dist/install.d.ts.map +1 -0
- package/dist/install.js +402 -0
- package/dist/install.js.map +1 -0
- package/dist/installation-core.d.ts +41 -0
- package/dist/installation-core.d.ts.map +1 -0
- package/dist/installation-core.js +163 -0
- package/dist/installation-core.js.map +1 -0
- package/dist/inventory.d.ts +3 -0
- package/dist/inventory.d.ts.map +1 -0
- package/dist/inventory.js +49 -0
- package/dist/inventory.js.map +1 -0
- package/dist/json-edit.d.ts +19 -0
- package/dist/json-edit.d.ts.map +1 -0
- package/dist/json-edit.js +81 -0
- package/dist/json-edit.js.map +1 -0
- package/dist/lifecycle-registration.d.ts +47 -0
- package/dist/lifecycle-registration.d.ts.map +1 -0
- package/dist/lifecycle-registration.js +351 -0
- package/dist/lifecycle-registration.js.map +1 -0
- package/dist/minting.d.ts +46 -0
- package/dist/minting.d.ts.map +1 -0
- package/dist/minting.js +192 -0
- package/dist/minting.js.map +1 -0
- package/dist/native-command.d.ts +6 -0
- package/dist/native-command.d.ts.map +1 -0
- package/dist/native-command.js +273 -0
- package/dist/native-command.js.map +1 -0
- package/dist/pack.d.ts +4 -0
- package/dist/pack.d.ts.map +1 -0
- package/dist/pack.js +30 -0
- package/dist/pack.js.map +1 -0
- package/dist/plugin-home.d.ts +45 -0
- package/dist/plugin-home.d.ts.map +1 -0
- package/dist/plugin-home.js +371 -0
- package/dist/plugin-home.js.map +1 -0
- package/dist/program.d.ts +64 -0
- package/dist/program.d.ts.map +1 -0
- package/dist/program.js +126 -0
- package/dist/program.js.map +1 -0
- package/dist/projection.d.ts +45 -0
- package/dist/projection.d.ts.map +1 -0
- package/dist/projection.js +218 -0
- package/dist/projection.js.map +1 -0
- package/dist/publication.d.ts +20 -0
- package/dist/publication.d.ts.map +1 -0
- package/dist/publication.js +284 -0
- package/dist/publication.js.map +1 -0
- package/dist/registry-admission.d.ts +5 -0
- package/dist/registry-admission.d.ts.map +1 -0
- package/dist/registry-admission.js +17 -0
- package/dist/registry-admission.js.map +1 -0
- package/dist/registry-build.d.ts +35 -0
- package/dist/registry-build.d.ts.map +1 -0
- package/dist/registry-build.js +156 -0
- package/dist/registry-build.js.map +1 -0
- package/dist/registry-config.d.ts +32 -0
- package/dist/registry-config.d.ts.map +1 -0
- package/dist/registry-config.js +191 -0
- package/dist/registry-config.js.map +1 -0
- package/dist/registry-layout.d.ts +41 -0
- package/dist/registry-layout.d.ts.map +1 -0
- package/dist/registry-layout.js +142 -0
- package/dist/registry-layout.js.map +1 -0
- package/dist/registry-resolve.d.ts +56 -0
- package/dist/registry-resolve.d.ts.map +1 -0
- package/dist/registry-resolve.js +406 -0
- package/dist/registry-resolve.js.map +1 -0
- package/dist/registry-source.d.ts +37 -0
- package/dist/registry-source.d.ts.map +1 -0
- package/dist/registry-source.js +101 -0
- package/dist/registry-source.js.map +1 -0
- package/dist/registry.d.ts +10 -0
- package/dist/registry.d.ts.map +1 -0
- package/dist/registry.js +6 -0
- package/dist/registry.js.map +1 -0
- package/dist/resolve.d.ts +31 -0
- package/dist/resolve.d.ts.map +1 -0
- package/dist/resolve.js +115 -0
- package/dist/resolve.js.map +1 -0
- package/dist/services.d.ts +179 -0
- package/dist/services.d.ts.map +1 -0
- package/dist/services.js +290 -0
- package/dist/services.js.map +1 -0
- package/dist/snapshot.d.ts +24 -0
- package/dist/snapshot.d.ts.map +1 -0
- package/dist/snapshot.js +343 -0
- package/dist/snapshot.js.map +1 -0
- package/dist/system-package.d.ts +71 -0
- package/dist/system-package.d.ts.map +1 -0
- package/dist/system-package.js +169 -0
- package/dist/system-package.js.map +1 -0
- package/dist/transfer.d.ts +22 -0
- package/dist/transfer.d.ts.map +1 -0
- package/dist/transfer.js +98 -0
- package/dist/transfer.js.map +1 -0
- package/dist/updates.d.ts +57 -0
- package/dist/updates.d.ts.map +1 -0
- package/dist/updates.js +201 -0
- package/dist/updates.js.map +1 -0
- package/dist/ustar.d.ts +28 -0
- package/dist/ustar.d.ts.map +1 -0
- package/dist/ustar.js +145 -0
- package/dist/ustar.js.map +1 -0
- package/package.json +323 -3
- package/references/system-package.md +13 -0
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { DistributionLock } from '@inventarch/db/distribution';
|
|
2
|
+
/** Registry spec §8: the layout builder. Writes stay inside the registry directory and refuse links (files.ts); it never contacts a network. */
|
|
3
|
+
export interface RegistryAddRequest {
|
|
4
|
+
readonly dir: string;
|
|
5
|
+
readonly archive: string;
|
|
6
|
+
readonly name?: string | undefined;
|
|
7
|
+
/** Exact target/dependency closure. Dependencies must already be published publicly in this registry. */
|
|
8
|
+
readonly selection?: {
|
|
9
|
+
readonly lock: DistributionLock;
|
|
10
|
+
readonly archives: ReadonlyMap<string, Uint8Array>;
|
|
11
|
+
};
|
|
12
|
+
}
|
|
13
|
+
export interface RegistryWithdrawRequest {
|
|
14
|
+
readonly dir: string;
|
|
15
|
+
readonly id: string;
|
|
16
|
+
readonly version: string;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Adds one verified, published archive: `artifacts/<archive>.ia.tgz`, then `ia-registry.json` if absent, then the package
|
|
20
|
+
* index, so an index never names a missing artifact. Releases stay in `compareVersions` order (highest first). The same
|
|
21
|
+
* version with the same digests is a no-op; with different digests it refuses `CONFLICT` (§3 append-only).
|
|
22
|
+
*/
|
|
23
|
+
export declare function registryAdd(request: RegistryAddRequest): {
|
|
24
|
+
readonly status: 'registry-added';
|
|
25
|
+
readonly id: string;
|
|
26
|
+
readonly version: string;
|
|
27
|
+
readonly archive: string;
|
|
28
|
+
};
|
|
29
|
+
/** Marks one listed release withdrawn (§8); removes nothing and never touches artifacts. Withdrawing a withdrawn release is a no-op. */
|
|
30
|
+
export declare function registryWithdraw(request: RegistryWithdrawRequest): {
|
|
31
|
+
readonly status: 'registry-withdrawn';
|
|
32
|
+
readonly id: string;
|
|
33
|
+
readonly version: string;
|
|
34
|
+
};
|
|
35
|
+
//# sourceMappingURL=registry-build.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-build.d.ts","sourceRoot":"","sources":["../src/registry-build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAyBpE,gJAAgJ;AAChJ,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,yGAAyG;IACzG,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;CAC9G;AACD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAyFD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG;IACxD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAuDA;AACD,wIAAwI;AACxI,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG;IAClE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAuBA"}
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
import { existsSync, lstatSync } from 'node:fs';
|
|
2
|
+
import { basename, dirname, isAbsolute } from 'node:path';
|
|
3
|
+
import { compareVersions, DISTRIBUTION_LIMITS, packageId, version as semverVersion } from '@inventarch/db/distribution';
|
|
4
|
+
import { inspectArchiveMetadata, verifyArchive, verifySelectedArchiveClosure } from './archive.js';
|
|
5
|
+
import { matchRegistryRelease } from './registry-admission.js';
|
|
6
|
+
import { resolveReleases } from './resolve.js';
|
|
7
|
+
import { bytes, contained, createFile, DistributionError, fail, json, locate, replace, utf8, workspace, } from './files.js';
|
|
8
|
+
import { decodePackageIndex, decodeRegistryInfo, packageIndexPath, REGISTRY_LIMITS, relabel, } from './registry-layout.js';
|
|
9
|
+
const INFO = 'ia-registry.json';
|
|
10
|
+
/** Canonical registry JSON: `json()`'s sorted keys, re-indented by 2 spaces with a trailing newline, so built files diff cleanly. */
|
|
11
|
+
const encode = (value) => Buffer.from(JSON.stringify(JSON.parse(json(value)), null, 2) + '\n');
|
|
12
|
+
/** Registry files are public static data, served or mirrored by other users: world-readable, unlike install state. */
|
|
13
|
+
const PUBLIC = 0o644;
|
|
14
|
+
/** The `--registry` directory: absolute, existing, reached without links. */
|
|
15
|
+
function registryRoot(dir) {
|
|
16
|
+
if (!isAbsolute(dir))
|
|
17
|
+
fail('INPUT-INVALID', 'An absolute --registry is required');
|
|
18
|
+
const path = contained(dir);
|
|
19
|
+
if (!existsSync(path) || !lstatSync(path).isDirectory())
|
|
20
|
+
fail('INPUT-INVALID', `Registry directory must already exist: ${dir}`);
|
|
21
|
+
return workspace(dir);
|
|
22
|
+
}
|
|
23
|
+
/** Decodes one existing registry document, naming its path; never rewrites a file that does not decode. */
|
|
24
|
+
const existing = (root, path, decode) => locate(path, () => {
|
|
25
|
+
const content = bytes(root, path, REGISTRY_LIMITS.indexBytes);
|
|
26
|
+
return content === null ? null : relabel(() => decode(utf8(content)), '', `: ${path}`);
|
|
27
|
+
});
|
|
28
|
+
const readInfo = (root) => existing(root, INFO, decodeRegistryInfo);
|
|
29
|
+
/** `signed`: the index carries the reserved `signatures` field (§3), which decodes but which this builder cannot maintain. */
|
|
30
|
+
const readIndex = (root, id) => existing(root, packageIndexPath(id), (text) => ({
|
|
31
|
+
index: decodePackageIndex(text, id),
|
|
32
|
+
signed: Object.hasOwn(JSON.parse(text), 'signatures'),
|
|
33
|
+
}));
|
|
34
|
+
const unsigned = (read, path) => {
|
|
35
|
+
if (read?.signed)
|
|
36
|
+
fail('INPUT-INVALID', `${path} carries reserved signatures this builder cannot maintain`);
|
|
37
|
+
};
|
|
38
|
+
/** Creates one new registry file. A file that appeared meanwhile is accepted only if it holds exactly these bytes; the result is read back either way. */
|
|
39
|
+
function create(root, path, content) {
|
|
40
|
+
try {
|
|
41
|
+
createFile(root, path, content, PUBLIC);
|
|
42
|
+
}
|
|
43
|
+
catch (error) {
|
|
44
|
+
if (!(error instanceof DistributionError && error.code === 'IA-DIST-LOCAL-MODIFICATION'))
|
|
45
|
+
throw error;
|
|
46
|
+
}
|
|
47
|
+
if (!bytes(root, path, DISTRIBUTION_LIMITS.compressed)?.equals(content))
|
|
48
|
+
fail('CONFLICT', `Registry changed while adding: ${path}`);
|
|
49
|
+
}
|
|
50
|
+
/** Encodes an index and round-trips it through the Task 2 decoder under the §3 bounds before any write. */
|
|
51
|
+
function indexContent(id, releases) {
|
|
52
|
+
if (releases.length > REGISTRY_LIMITS.releases)
|
|
53
|
+
fail('LIMIT-EXCEEDED', `Registry index exceeds ${REGISTRY_LIMITS.releases} releases`);
|
|
54
|
+
const content = encode({ format: 'ia.registry-package.v1', id, releases });
|
|
55
|
+
if (content.length > REGISTRY_LIMITS.indexBytes)
|
|
56
|
+
fail('LIMIT-EXCEEDED', `Registry index exceeds ${REGISTRY_LIMITS.indexBytes} bytes`);
|
|
57
|
+
relabel(() => decodePackageIndex(utf8(content), id), 'Built registry index does not decode: ');
|
|
58
|
+
return content;
|
|
59
|
+
}
|
|
60
|
+
/** Contextual admission never permits a registry entry to rely on unpublished or substituted dependency bytes. */
|
|
61
|
+
function selectedArchive(root, content, selection) {
|
|
62
|
+
const pending = inspectArchiveMetadata(content).pending;
|
|
63
|
+
const admitted = verifySelectedArchiveClosure(selection.lock, selection.archives);
|
|
64
|
+
const target = admitted.get(pending.manifest.id);
|
|
65
|
+
if (!target || target.archiveDigest !== pending.archiveDigest || target.manifestDigest !== pending.manifestDigest)
|
|
66
|
+
fail('INTEGRITY-MISMATCH', 'Selected registry target differs from the supplied archive');
|
|
67
|
+
const resolved = resolveReleases([{ id: target.manifest.id, range: target.manifest.version }], [...admitted.values()].map((release) => ({
|
|
68
|
+
release,
|
|
69
|
+
location: `sha256:${release.archiveDigest}`,
|
|
70
|
+
withdrawn: false,
|
|
71
|
+
})), selection.lock.engine);
|
|
72
|
+
if (resolved.releases.size !== admitted.size)
|
|
73
|
+
fail('INPUT-INVALID', 'Supply only the target and its declared dependency closure');
|
|
74
|
+
for (const [id, dependency] of admitted) {
|
|
75
|
+
if (id === target.manifest.id)
|
|
76
|
+
continue;
|
|
77
|
+
const listed = readIndex(root, id)?.index.releases.find((row) => row.version === dependency.manifest.version);
|
|
78
|
+
if (!listed ||
|
|
79
|
+
listed.withdrawn ||
|
|
80
|
+
listed.access !== 'public' ||
|
|
81
|
+
listed.archive !== dependency.archiveDigest ||
|
|
82
|
+
listed.manifest !== dependency.manifestDigest)
|
|
83
|
+
fail('CONFLICT', `Selected dependency is not an available exact public registry release: ${id}@${dependency.manifest.version}`);
|
|
84
|
+
matchRegistryRelease(id, listed, dependency);
|
|
85
|
+
const stored = bytes(root, `artifacts/${dependency.archiveDigest}.ia.tgz`, DISTRIBUTION_LIMITS.compressed);
|
|
86
|
+
if (!stored || !stored.equals(Buffer.from(selection.archives.get(dependency.archiveDigest))))
|
|
87
|
+
fail('INTEGRITY-MISMATCH', `Registry dependency bytes differ: ${id}@${dependency.manifest.version}`);
|
|
88
|
+
}
|
|
89
|
+
return target;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Adds one verified, published archive: `artifacts/<archive>.ia.tgz`, then `ia-registry.json` if absent, then the package
|
|
93
|
+
* index, so an index never names a missing artifact. Releases stay in `compareVersions` order (highest first). The same
|
|
94
|
+
* version with the same digests is a no-op; with different digests it refuses `CONFLICT` (§3 append-only).
|
|
95
|
+
*/
|
|
96
|
+
export function registryAdd(request) {
|
|
97
|
+
const root = registryRoot(request.dir);
|
|
98
|
+
if (!isAbsolute(request.archive))
|
|
99
|
+
fail('INPUT-INVALID', 'An absolute --archive is required');
|
|
100
|
+
const content = locate(request.archive, () => relabel(() => bytes(dirname(request.archive), basename(request.archive), DISTRIBUTION_LIMITS.compressed), `Input archive ${request.archive}: `)) ?? fail('INPUT-INVALID', `Missing input archive: ${request.archive}`);
|
|
101
|
+
const verified = request.selection ? selectedArchive(root, content, request.selection) : verifyArchive(content), manifest = verified.manifest, digest = verified.archiveDigest;
|
|
102
|
+
if (manifest.source.repository === null)
|
|
103
|
+
fail('INPUT-INVALID', 'An unpublished local archive carries no source provenance and cannot be published');
|
|
104
|
+
const info = readInfo(root);
|
|
105
|
+
if (info !== null && request.name !== undefined && request.name !== info.name)
|
|
106
|
+
fail('CONFLICT', `Registry is already named "${info.name}", not "${request.name}"`);
|
|
107
|
+
const infoContent = info === null ? encode({ format: 'ia.registry.v1', name: request.name ?? basename(root) }) : null;
|
|
108
|
+
if (infoContent !== null)
|
|
109
|
+
relabel(() => decodeRegistryInfo(utf8(infoContent)), 'Invalid registry name: ');
|
|
110
|
+
const id = manifest.id, path = packageIndexPath(id), artifact = `artifacts/${digest}.ia.tgz`, read = readIndex(root, id), releases = read?.index.releases ?? [];
|
|
111
|
+
const entry = {
|
|
112
|
+
version: manifest.version,
|
|
113
|
+
archive: digest,
|
|
114
|
+
manifest: verified.manifestDigest,
|
|
115
|
+
engine: manifest.engine,
|
|
116
|
+
language: manifest.language,
|
|
117
|
+
dependencies: manifest.dependencies.map((d) => ({ id: d.id, range: d.range })),
|
|
118
|
+
withdrawn: false,
|
|
119
|
+
access: 'public',
|
|
120
|
+
artifact,
|
|
121
|
+
};
|
|
122
|
+
const listed = releases.find((r) => r.version === entry.version);
|
|
123
|
+
if (listed && (listed.archive !== entry.archive || listed.manifest !== entry.manifest))
|
|
124
|
+
fail('CONFLICT', `Registry already lists ${id}@${entry.version} with different bytes`);
|
|
125
|
+
if (listed && listed.access !== 'public')
|
|
126
|
+
fail('CONFLICT', `Registry already lists ${id}@${entry.version} as licensed`);
|
|
127
|
+
if (!listed)
|
|
128
|
+
unsigned(read, path);
|
|
129
|
+
const indexed = listed
|
|
130
|
+
? null
|
|
131
|
+
: indexContent(id, [...releases, entry].sort((a, b) => compareVersions(a.version, b.version)));
|
|
132
|
+
const present = bytes(root, artifact, DISTRIBUTION_LIMITS.compressed);
|
|
133
|
+
if (present !== null && !present.equals(content))
|
|
134
|
+
fail('CONFLICT', `Registry ${artifact} differs from the bytes its name pins`);
|
|
135
|
+
if (present === null)
|
|
136
|
+
create(root, artifact, content);
|
|
137
|
+
if (infoContent !== null)
|
|
138
|
+
create(root, INFO, infoContent);
|
|
139
|
+
if (indexed !== null)
|
|
140
|
+
replace(root, path, indexed, PUBLIC);
|
|
141
|
+
return { status: 'registry-added', id, version: entry.version, archive: digest };
|
|
142
|
+
}
|
|
143
|
+
/** Marks one listed release withdrawn (§8); removes nothing and never touches artifacts. Withdrawing a withdrawn release is a no-op. */
|
|
144
|
+
export function registryWithdraw(request) {
|
|
145
|
+
const root = registryRoot(request.dir), id = relabel(() => packageId(request.id), 'Invalid --id: '), version = relabel(() => semverVersion(request.version), 'Invalid --version: ');
|
|
146
|
+
if (readInfo(root) === null)
|
|
147
|
+
fail('INPUT-INVALID', `Not a registry: ${request.dir} has no ${INFO}`);
|
|
148
|
+
const read = readIndex(root, id) ?? fail('INPUT-INVALID', `Registry lists no package ${id}`), index = read.index, path = packageIndexPath(id);
|
|
149
|
+
const listed = index.releases.find((r) => r.version === version) ?? fail('INPUT-INVALID', `Registry lists no ${id}@${version}`);
|
|
150
|
+
if (!listed.withdrawn) {
|
|
151
|
+
unsigned(read, path);
|
|
152
|
+
replace(root, path, indexContent(id, index.releases.map((r) => (r === listed ? { ...r, withdrawn: true } : r))), PUBLIC);
|
|
153
|
+
}
|
|
154
|
+
return { status: 'registry-withdrawn', id, version };
|
|
155
|
+
}
|
|
156
|
+
//# sourceMappingURL=registry-build.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-build.js","sourceRoot":"","sources":["../src/registry-build.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { RegistryBase } from './registry-source.js';
|
|
2
|
+
/** Registry spec §4 level 5. */
|
|
3
|
+
export declare const DEFAULT_REGISTRIES: Readonly<Record<string, string>>;
|
|
4
|
+
export type RegistryLevel = 'flag' | 'env' | 'workspace' | 'user' | 'default';
|
|
5
|
+
/** `source` names what chose the base (`doctor`, §4): the flag, the variable, the file or the built-in default. */
|
|
6
|
+
export interface RegistryChoice {
|
|
7
|
+
readonly provider: string;
|
|
8
|
+
readonly base: RegistryBase;
|
|
9
|
+
readonly level: RegistryLevel;
|
|
10
|
+
readonly source: string;
|
|
11
|
+
}
|
|
12
|
+
/** `cwd` (default `process.cwd()`) anchors relative `--registry` and `IA_REGISTRY` directories; `platform` and `home` pick the user file (§4 level 4). */
|
|
13
|
+
export interface RegistryOptions {
|
|
14
|
+
readonly root: string;
|
|
15
|
+
readonly env: Readonly<Record<string, string | undefined>>;
|
|
16
|
+
readonly flag?: string;
|
|
17
|
+
readonly cwd?: string;
|
|
18
|
+
readonly platform?: string;
|
|
19
|
+
readonly home?: string;
|
|
20
|
+
}
|
|
21
|
+
type Env = Readonly<Record<string, string | undefined>>;
|
|
22
|
+
/** Registry spec §4 level 4: `IA_CONFIG_HOME`, else the per-OS configuration directory. */
|
|
23
|
+
export declare function userConfigDir(env: Env, platform?: string, home?: string): string;
|
|
24
|
+
/**
|
|
25
|
+
* Registry spec §4 for one command: each level is read and validated at most once, and only when every higher level
|
|
26
|
+
* leaves a provider unanswered, so one command sees one configuration. The returned function picks per id.
|
|
27
|
+
*/
|
|
28
|
+
export declare function registryChooser(options: RegistryOptions): (id: string) => RegistryChoice;
|
|
29
|
+
/** Registry spec §4 for one id; a command choosing for several ids uses one `registryChooser`. */
|
|
30
|
+
export declare const registryFor: (id: string, options: RegistryOptions) => RegistryChoice;
|
|
31
|
+
export {};
|
|
32
|
+
//# sourceMappingURL=registry-config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-config.d.ts","sourceRoot":"","sources":["../src/registry-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,gCAAgC;AAChC,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9D,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAC9E,mHAAmH;AACnH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,0JAA0J;AAC1J,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AACD,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAYxD,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAyB,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAW7G;AAgGD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,CA4DxF;AACD,kGAAkG;AAClG,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,EAAE,SAAS,eAAe,KAAG,cAA8C,CAAC"}
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
import { closeSync, fstatSync, openSync, readSync, realpathSync } from 'node:fs';
|
|
2
|
+
import { homedir } from 'node:os';
|
|
3
|
+
import { isAbsolute, join, relative } from 'node:path';
|
|
4
|
+
import { decodeDistributionJson, packageId } from '@inventarch/db/distribution';
|
|
5
|
+
import { bytes, DistributionError, fail, locate, object, utf8, workspace } from './files.js';
|
|
6
|
+
import { relabel } from './registry-layout.js';
|
|
7
|
+
import { parseRegistryBase } from './registry-source.js';
|
|
8
|
+
/** Registry spec §4 level 5. */
|
|
9
|
+
export const DEFAULT_REGISTRIES = Object.freeze({
|
|
10
|
+
inventarch: 'https://api.inventarch.dev/registry',
|
|
11
|
+
});
|
|
12
|
+
const WORKSPACE_FILE = '.ia/registries.json';
|
|
13
|
+
/** A mapping key is `*` or a provider exactly as `packageId` (packages/db/src/distribution/codec.ts:34) accepts it before the `/`. */
|
|
14
|
+
const providerKey = (key) => {
|
|
15
|
+
if (key === '*')
|
|
16
|
+
return true;
|
|
17
|
+
try {
|
|
18
|
+
packageId(`${key}/p`);
|
|
19
|
+
return true;
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
return false;
|
|
23
|
+
}
|
|
24
|
+
};
|
|
25
|
+
/** Registry spec §4 level 4: `IA_CONFIG_HOME`, else the per-OS configuration directory. */
|
|
26
|
+
export function userConfigDir(env, platform = process.platform, home = homedir()) {
|
|
27
|
+
const configured = env['IA_CONFIG_HOME'];
|
|
28
|
+
if (configured) {
|
|
29
|
+
if (!isAbsolute(configured))
|
|
30
|
+
fail('INPUT-INVALID', 'IA_CONFIG_HOME must be absolute');
|
|
31
|
+
return configured;
|
|
32
|
+
}
|
|
33
|
+
if (platform === 'win32')
|
|
34
|
+
return join(env['APPDATA'] || join(home, 'AppData', 'Roaming'), 'ia');
|
|
35
|
+
if (platform === 'darwin')
|
|
36
|
+
return join(home, 'Library/Preferences', 'ia');
|
|
37
|
+
// XDG Base Directory: a relative $XDG_CONFIG_HOME is invalid and ignored.
|
|
38
|
+
const xdg = env['XDG_CONFIG_HOME'];
|
|
39
|
+
return join(xdg && isAbsolute(xdg) ? xdg : join(home, '.config'), 'ia');
|
|
40
|
+
}
|
|
41
|
+
const FILE_LIMIT = 64 * 1024;
|
|
42
|
+
/**
|
|
43
|
+
* The user file, or null when it or its directory is absent. It is operator-owned config outside the workspace, so links
|
|
44
|
+
* and junctions on its path are followed (a redirected profile, macOS `/var`); `bytes` refuses them to guard committed
|
|
45
|
+
* workspace content only. It must resolve to a regular file within the bound; filesystem failures never escape raw.
|
|
46
|
+
*/
|
|
47
|
+
function userBytes(file) {
|
|
48
|
+
let fd;
|
|
49
|
+
try {
|
|
50
|
+
fd = openSync(realpathSync(file), 'r');
|
|
51
|
+
const stat = fstatSync(fd);
|
|
52
|
+
if (!stat.isFile())
|
|
53
|
+
fail('INPUT-INVALID', `Expected a regular file: ${file}`);
|
|
54
|
+
if (stat.size > FILE_LIMIT)
|
|
55
|
+
fail('LIMIT-EXCEEDED', `File exceeds ${FILE_LIMIT} bytes: ${file}`);
|
|
56
|
+
const buffer = Buffer.alloc(FILE_LIMIT + 1);
|
|
57
|
+
let size = 0, read;
|
|
58
|
+
while (size < buffer.length && (read = readSync(fd, buffer, size, buffer.length - size, null)) > 0)
|
|
59
|
+
size += read;
|
|
60
|
+
if (size > FILE_LIMIT)
|
|
61
|
+
fail('LIMIT-EXCEEDED', `File grew beyond its bound: ${file}`);
|
|
62
|
+
return buffer.subarray(0, size);
|
|
63
|
+
}
|
|
64
|
+
catch (error) {
|
|
65
|
+
if (error instanceof DistributionError)
|
|
66
|
+
throw error;
|
|
67
|
+
const code = error.code;
|
|
68
|
+
// A config home that is a file reads as ENOENT on Windows and ENOTDIR elsewhere; both mean the directory is absent.
|
|
69
|
+
if (code === 'ENOENT' || code === 'ENOTDIR')
|
|
70
|
+
return null;
|
|
71
|
+
if (code === 'ELOOP')
|
|
72
|
+
fail('PATH-UNSAFE', `Link loop on the path to ${file}`);
|
|
73
|
+
if (code === 'EISDIR')
|
|
74
|
+
fail('INPUT-INVALID', `Expected a regular file: ${file}`);
|
|
75
|
+
return fail('INPUT-INVALID', `Cannot read ${file}: ${code ?? (error instanceof Error ? error.message : String(error))}`);
|
|
76
|
+
}
|
|
77
|
+
finally {
|
|
78
|
+
if (fd !== undefined)
|
|
79
|
+
closeSync(fd);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
/** One `ia.registries.v1` file, or null when `content` is (the file is absent). Every entry is checked with the level's rule (`check`), not only the one a lookup picks: §4 forbids credentials and escaping directories anywhere in the file. */
|
|
83
|
+
function mappings(content, label, check) {
|
|
84
|
+
if (content === null)
|
|
85
|
+
return null;
|
|
86
|
+
const row = relabel(() => object(decodeDistributionJson(utf8(content)), ['format', 'registries']), `Invalid ${label}: `);
|
|
87
|
+
const registries = row['registries'];
|
|
88
|
+
if (row['format'] !== 'ia.registries.v1')
|
|
89
|
+
fail('INPUT-INVALID', `Invalid ${label}: format must be ia.registries.v1`);
|
|
90
|
+
if (registries === null || typeof registries !== 'object' || Array.isArray(registries))
|
|
91
|
+
fail('INPUT-INVALID', `Invalid ${label}: registries must be an object`);
|
|
92
|
+
const map = new Map();
|
|
93
|
+
for (const [key, value] of Object.entries(registries)) {
|
|
94
|
+
if (!providerKey(key))
|
|
95
|
+
fail('INPUT-INVALID', `Invalid ${label} entry ${key}: expected a provider name or *`);
|
|
96
|
+
if (typeof value !== 'string' || !value)
|
|
97
|
+
fail('INPUT-INVALID', `Invalid ${label} entry ${key}: expected a non-empty URL or directory`);
|
|
98
|
+
map.set(key, Object.freeze(relabel(() => check(value), `${label} ${key}: `)));
|
|
99
|
+
}
|
|
100
|
+
return map;
|
|
101
|
+
}
|
|
102
|
+
/** Within levels 3 and 4 an exact provider key beats `*` (§4). */
|
|
103
|
+
const pick = (map, provider) => map?.get(provider) ?? map?.get('*');
|
|
104
|
+
/** §4 level 3: a committed file, so a directory must stay inside the workspace (and must not be the workspace itself). */
|
|
105
|
+
function insideWorkspace(root, value) {
|
|
106
|
+
const base = parseRegistryBase(value, root);
|
|
107
|
+
if (base.kind === 'https')
|
|
108
|
+
return base;
|
|
109
|
+
const away = relative(root, base.path);
|
|
110
|
+
const absolute = isAbsolute(value), driveQualified = /^[A-Za-z]:/.test(value), network = /^[\\/]{2}/.test(value);
|
|
111
|
+
const isRoot = away === '', escapes = away === '..' || /^\.\.[\\/]/.test(away) || isAbsolute(away);
|
|
112
|
+
if (absolute || driveQualified || network || isRoot || escapes)
|
|
113
|
+
fail('INPUT-INVALID', `Workspace registry directories must be relative paths inside the workspace: ${value}`);
|
|
114
|
+
return base;
|
|
115
|
+
}
|
|
116
|
+
/** §4 level 4: a per-user file, so a directory must be absolute. */
|
|
117
|
+
function absoluteOnly(dir, value) {
|
|
118
|
+
const base = parseRegistryBase(value, dir);
|
|
119
|
+
if (base.kind === 'dir' && !isAbsolute(value))
|
|
120
|
+
fail('INPUT-INVALID', `User registry directories must be absolute: ${value}`);
|
|
121
|
+
return base;
|
|
122
|
+
}
|
|
123
|
+
/** Runs `work` on first use only; a refusal is not cached. */
|
|
124
|
+
function once(work) {
|
|
125
|
+
let done = false, value;
|
|
126
|
+
return () => {
|
|
127
|
+
if (!done) {
|
|
128
|
+
value = work();
|
|
129
|
+
done = true;
|
|
130
|
+
}
|
|
131
|
+
return value;
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Registry spec §4 for one command: each level is read and validated at most once, and only when every higher level
|
|
136
|
+
* leaves a provider unanswered, so one command sees one configuration. The returned function picks per id.
|
|
137
|
+
*/
|
|
138
|
+
export function registryChooser(options) {
|
|
139
|
+
// §4 levels 1-2 are typed on the command line, so a relative directory is relative to the caller's cwd, not the workspace.
|
|
140
|
+
const cwd = options.cwd ?? process.cwd(), flag = options.flag, variable = options.env['IA_REGISTRY'];
|
|
141
|
+
const commandLine = once(() => {
|
|
142
|
+
if (flag !== undefined)
|
|
143
|
+
return {
|
|
144
|
+
level: 'flag',
|
|
145
|
+
source: '--registry',
|
|
146
|
+
base: Object.freeze(relabel(() => parseRegistryBase(flag, cwd), '--registry: ')),
|
|
147
|
+
};
|
|
148
|
+
if (variable)
|
|
149
|
+
return {
|
|
150
|
+
level: 'env',
|
|
151
|
+
source: 'IA_REGISTRY',
|
|
152
|
+
base: Object.freeze(relabel(() => parseRegistryBase(variable, cwd), 'IA_REGISTRY: ')),
|
|
153
|
+
};
|
|
154
|
+
return null;
|
|
155
|
+
});
|
|
156
|
+
const root = once(() => workspace(options.root));
|
|
157
|
+
// Links on the workspace file's path refuse (`bytes`), and its refusals are located at the file (`locate`); only the user file follows links (`userBytes`).
|
|
158
|
+
const local = once(() => {
|
|
159
|
+
const at = root();
|
|
160
|
+
return locate(WORKSPACE_FILE, () => mappings(bytes(at, WORKSPACE_FILE, FILE_LIMIT), WORKSPACE_FILE, (value) => insideWorkspace(at, value)));
|
|
161
|
+
});
|
|
162
|
+
const user = once(() => {
|
|
163
|
+
const dir = userConfigDir(options.env, options.platform, options.home), file = join(dir, 'registries.json');
|
|
164
|
+
return { file, map: mappings(userBytes(file), file, (value) => absoluteOnly(dir, value)) };
|
|
165
|
+
});
|
|
166
|
+
const defaults = once(() => new Map(Object.entries(DEFAULT_REGISTRIES).map(([key, value]) => [key, Object.freeze(parseRegistryBase(value, cwd))])));
|
|
167
|
+
const choose = (id) => {
|
|
168
|
+
const provider = relabel(() => packageId(id), `Invalid distribution id ${id}: `).split('/')[0];
|
|
169
|
+
const fixed = commandLine();
|
|
170
|
+
if (fixed !== null)
|
|
171
|
+
return fixed;
|
|
172
|
+
const workspaceBase = pick(local(), provider);
|
|
173
|
+
if (workspaceBase !== undefined)
|
|
174
|
+
return { level: 'workspace', source: WORKSPACE_FILE, base: workspaceBase };
|
|
175
|
+
const { file, map } = user(), userBase = pick(map, provider);
|
|
176
|
+
if (userBase !== undefined)
|
|
177
|
+
return { level: 'user', source: file, base: userBase };
|
|
178
|
+
const fallback = defaults().get(provider);
|
|
179
|
+
if (fallback !== undefined)
|
|
180
|
+
return { level: 'default', source: 'built-in default', base: fallback };
|
|
181
|
+
// The id is named too: a locked package, not only a requested one, can be the id that needs the provider.
|
|
182
|
+
return fail('REGISTRY-UNMAPPED', `No registry is configured for provider ${provider} (needed for ${id}); map it in ${WORKSPACE_FILE} or pass --registry`);
|
|
183
|
+
};
|
|
184
|
+
return (id) => {
|
|
185
|
+
const { level, source, base } = choose(id);
|
|
186
|
+
return Object.freeze({ provider: id.split('/')[0], base, level, source });
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
/** Registry spec §4 for one id; a command choosing for several ids uses one `registryChooser`. */
|
|
190
|
+
export const registryFor = (id, options) => registryChooser(options)(id);
|
|
191
|
+
//# sourceMappingURL=registry-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-config.js","sourceRoot":"","sources":["../src/registry-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,gCAAgC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAqC,MAAM,CAAC,MAAM,CAAC;IAChF,UAAU,EAAE,qCAAqC;CAClD,CAAC,CAAC;AAmBH,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAC7C,sIAAsI;AACtI,MAAM,WAAW,GAAG,CAAC,GAAW,EAAW,EAAE;IAC3C,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AACF,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,GAAQ,EAAE,WAAmB,OAAO,CAAC,QAAQ,EAAE,OAAe,OAAO,EAAE;IACnG,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,IAAI,CAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;QACtF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAChG,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;IAC1E,0EAA0E;IAC1E,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC;AACD,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAC7B;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,eAAe,EAAE,4BAA4B,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,IAAI,GAAG,UAAU;YAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,UAAU,WAAW,IAAI,EAAE,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,IAAI,GAAG,CAAC,EACV,IAAY,CAAC;QACf,OAAO,IAAI,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,IAAI,IAAI,IAAI,CAAC;QACjH,IAAI,IAAI,GAAG,UAAU;YAAE,IAAI,CAAC,gBAAgB,EAAE,+BAA+B,IAAI,EAAE,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,iBAAiB;YAAE,MAAM,KAAK,CAAC;QACpD,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,oHAAoH;QACpH,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzD,IAAI,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,aAAa,EAAE,4BAA4B,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,eAAe,EAAE,4BAA4B,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,IAAI,CACT,eAAe,EACf,eAAe,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,kPAAkP;AAClP,SAAS,QAAQ,CAAC,OAAsB,EAAE,KAAa,EAAE,KAAsC;IAC7F,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,EAC7E,WAAW,KAAK,IAAI,CACrB,CAAC;IACF,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,kBAAkB;QAAE,IAAI,CAAC,eAAe,EAAE,WAAW,KAAK,mCAAmC,CAAC,CAAC;IACrH,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACpF,IAAI,CAAC,eAAe,EAAE,WAAW,KAAK,gCAAgC,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,eAAe,EAAE,WAAW,KAAK,UAAU,GAAG,iCAAiC,CAAC,CAAC;QAC7G,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK;YACrC,IAAI,CAAC,eAAe,EAAE,WAAW,KAAK,UAAU,GAAG,yCAAyC,CAAC,CAAC;QAChG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AACD,kEAAkE;AAClE,MAAM,IAAI,GAAG,CAAC,GAAoB,EAAE,QAAgB,EAA4B,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AACvH,0HAA0H;AAC1H,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,EAChC,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EACzC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,KAAK,EAAE,EACxB,OAAO,GAAG,IAAI,KAAK,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,QAAQ,IAAI,cAAc,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO;QAC5D,IAAI,CAAC,eAAe,EAAE,+EAA+E,KAAK,EAAE,CAAC,CAAC;IAChH,OAAO,IAAI,CAAC;AACd,CAAC;AACD,oEAAoE;AACpE,SAAS,YAAY,CAAC,GAAW,EAAE,KAAa;IAC9C,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,IAAI,CAAC,eAAe,EAAE,+CAA+C,KAAK,EAAE,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC;AACd,CAAC;AACD,8DAA8D;AAC9D,SAAS,IAAI,CAAI,IAAa;IAC5B,IAAI,IAAI,GAAG,KAAK,EACd,KAAQ,CAAC;IACX,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,KAAK,GAAG,IAAI,EAAE,CAAC;YACf,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,2HAA2H;IAC3H,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EACtC,IAAI,GAAG,OAAO,CAAC,IAAI,EACnB,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAiB,EAAE;QAC1C,IAAI,IAAI,KAAK,SAAS;YACpB,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,YAAY;gBACpB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;aACjF,CAAC;QACJ,IAAI,QAAQ;YACV,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,aAAa;gBACrB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;aACtF,CAAC;QACJ,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,4JAA4J;IAC5J,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,CACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CACvG,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EACpE,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;IAC7F,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,CACnB,GAAG,EAAE,CACH,IAAI,GAAG,CACL,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAC9G,CACJ,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,EAAU,EAAS,EAAE;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,2BAA2B,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAChG,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAC5G,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAC1B,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACjC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACnF,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACpG,0GAA0G;QAC1G,OAAO,IAAI,CACT,mBAAmB,EACnB,0CAA0C,QAAQ,gBAAgB,EAAE,gBAAgB,cAAc,qBAAqB,CACxH,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC;AACD,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,OAAwB,EAAkB,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/** Registry spec §3 and §5.1 bounds. */
|
|
2
|
+
export declare const REGISTRY_LIMITS: Readonly<{
|
|
3
|
+
indexBytes: number;
|
|
4
|
+
releases: 1000;
|
|
5
|
+
reads: 256;
|
|
6
|
+
}>;
|
|
7
|
+
export interface RegistryInfo {
|
|
8
|
+
readonly format: 'ia.registry.v1';
|
|
9
|
+
readonly name: string;
|
|
10
|
+
}
|
|
11
|
+
export interface RegistryDependency {
|
|
12
|
+
readonly id: string;
|
|
13
|
+
readonly range: string;
|
|
14
|
+
}
|
|
15
|
+
export interface RegistryRelease {
|
|
16
|
+
readonly version: string;
|
|
17
|
+
readonly archive: string;
|
|
18
|
+
readonly manifest: string;
|
|
19
|
+
readonly engine: string;
|
|
20
|
+
readonly language: readonly string[];
|
|
21
|
+
readonly dependencies: readonly RegistryDependency[];
|
|
22
|
+
readonly withdrawn: boolean;
|
|
23
|
+
readonly access: 'public' | 'licensed';
|
|
24
|
+
readonly artifact?: string;
|
|
25
|
+
}
|
|
26
|
+
export interface PackageIndex {
|
|
27
|
+
readonly format: 'ia.registry-package.v1';
|
|
28
|
+
readonly id: string;
|
|
29
|
+
readonly releases: readonly RegistryRelease[];
|
|
30
|
+
}
|
|
31
|
+
export declare const isDbRefusal: (error: unknown) => error is Error & {
|
|
32
|
+
code: string;
|
|
33
|
+
};
|
|
34
|
+
/** `DbError.message` is `<IA-DB-code>: Distribution <reason>: <detail>` (packages/db/src/errors.ts:8); strip both so only the detail remains. */
|
|
35
|
+
export declare const stripDbPrefix: (message: string) => string;
|
|
36
|
+
/** Re-raises a refusal from `work` with `prefix` and `suffix` around its message: a distribution refusal keeps its code, a db-layer refusal becomes INPUT-INVALID with its db prefix stripped. */
|
|
37
|
+
export declare function relabel<T>(work: () => T, prefix: string, suffix?: string): T;
|
|
38
|
+
export declare function packageIndexPath(id: string): string;
|
|
39
|
+
export declare function decodeRegistryInfo(content: string): RegistryInfo;
|
|
40
|
+
export declare function decodePackageIndex(content: string, expectedId: string): PackageIndex;
|
|
41
|
+
//# sourceMappingURL=registry-layout.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-layout.d.ts","sourceRoot":"","sources":["../src/registry-layout.ts"],"names":[],"mappings":"AAUA,wCAAwC;AACxC,eAAO,MAAM,eAAe;;;;EAA6E,CAAC;AAC1G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAaD,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAI1B,CAAC;AACnD,iJAAiJ;AACjJ,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MACoB,CAAC;AACrE,kMAAkM;AAClM,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,CAAC,CASxE;AAuBD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AACD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAMhE;AACD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAuEpF"}
|