@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.
- package/LICENSE +202 -0
- package/NOTICE +4 -0
- package/README.md +2 -2
- package/SPEC.md +3 -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 +158 -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 +29 -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 +46 -0
- package/dist/lifecycle-registration.d.ts.map +1 -0
- package/dist/lifecycle-registration.js +332 -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/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 +19 -0
- package/dist/snapshot.d.ts.map +1 -0
- package/dist/snapshot.js +309 -0
- package/dist/snapshot.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 +174 -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 +305 -3
|
@@ -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":"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"}
|
|
@@ -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"}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
import { DISTRIBUTION_LIMITS, decodeDistributionJson, packageId, range, text, version, } from '@inventarch/db/distribution';
|
|
2
|
+
import { DistributionError, fail, object } from './files.js';
|
|
3
|
+
/** Registry spec §3 and §5.1 bounds. */
|
|
4
|
+
export const REGISTRY_LIMITS = Object.freeze({ indexBytes: 4 * 1024 * 1024, releases: 1000, reads: 256 });
|
|
5
|
+
/** Deep freeze, matching installation-core.ts/minting.ts. */
|
|
6
|
+
function frozen(value) {
|
|
7
|
+
if (value && typeof value === 'object') {
|
|
8
|
+
Object.values(value).forEach(frozen);
|
|
9
|
+
Object.freeze(value);
|
|
10
|
+
}
|
|
11
|
+
return value;
|
|
12
|
+
}
|
|
13
|
+
const hex = (v, what) => {
|
|
14
|
+
if (typeof v !== 'string' || !/^[a-f0-9]{64}$/.test(v))
|
|
15
|
+
fail('INPUT-INVALID', `Invalid registry ${what} digest`);
|
|
16
|
+
return v;
|
|
17
|
+
};
|
|
18
|
+
export const isDbRefusal = (error) => error instanceof Error &&
|
|
19
|
+
'code' in error &&
|
|
20
|
+
typeof error.code === 'string' &&
|
|
21
|
+
/^IA-DB-/.test(error.code);
|
|
22
|
+
/** `DbError.message` is `<IA-DB-code>: Distribution <reason>: <detail>` (packages/db/src/errors.ts:8); strip both so only the detail remains. */
|
|
23
|
+
export const stripDbPrefix = (message) => message.replace(/^IA-DB-[A-Z-]+: (?:Distribution [a-z-]+: )?/, '');
|
|
24
|
+
/** 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. */
|
|
25
|
+
export function relabel(work, prefix, suffix = '') {
|
|
26
|
+
try {
|
|
27
|
+
return work();
|
|
28
|
+
}
|
|
29
|
+
catch (error) {
|
|
30
|
+
if (error instanceof DistributionError)
|
|
31
|
+
fail(error.code.replace(/^IA-DIST-/, ''), `${prefix}${error.message}${suffix}`);
|
|
32
|
+
if (isDbRefusal(error))
|
|
33
|
+
fail('INPUT-INVALID', `${prefix}${stripDbPrefix(error.message)}${suffix}`);
|
|
34
|
+
throw error;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
/** Wraps one named field's decode: on a db-layer refusal, names the field (and the release version, once known) and drops the db code so the caller sees only `IA-DIST-*`. */
|
|
38
|
+
function field(name, context, work) {
|
|
39
|
+
try {
|
|
40
|
+
return work();
|
|
41
|
+
}
|
|
42
|
+
catch (error) {
|
|
43
|
+
if (isDbRefusal(error))
|
|
44
|
+
fail('INPUT-INVALID', `Invalid registry metadata${context !== undefined ? ` for ${context}` : ''}: ${name}: ${stripDbPrefix(error.message)}`);
|
|
45
|
+
throw error;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** Catch-all for db-layer refusals not tied to one named field, e.g. malformed JSON. */
|
|
49
|
+
function dbDecode(work) {
|
|
50
|
+
try {
|
|
51
|
+
return work();
|
|
52
|
+
}
|
|
53
|
+
catch (error) {
|
|
54
|
+
if (isDbRefusal(error))
|
|
55
|
+
fail('INPUT-INVALID', stripDbPrefix(error.message));
|
|
56
|
+
throw error;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
export function packageIndexPath(id) {
|
|
60
|
+
return dbDecode(() => `packages/${packageId(id)}.json`);
|
|
61
|
+
}
|
|
62
|
+
export function decodeRegistryInfo(content) {
|
|
63
|
+
return dbDecode(() => {
|
|
64
|
+
const row = object(decodeDistributionJson(content), ['format', 'name']);
|
|
65
|
+
if (row['format'] !== 'ia.registry.v1')
|
|
66
|
+
fail('INPUT-INVALID', 'Not an ia.registry.v1 registry');
|
|
67
|
+
return frozen({ format: 'ia.registry.v1', name: field('name', undefined, () => text(row['name'], 128)) });
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
export function decodePackageIndex(content, expectedId) {
|
|
71
|
+
return dbDecode(() => {
|
|
72
|
+
const id = field('id', undefined, () => packageId(expectedId));
|
|
73
|
+
const value = decodeDistributionJson(content), keys = value !== null && typeof value === 'object' && Object.hasOwn(value, 'signatures')
|
|
74
|
+
? ['format', 'id', 'releases', 'signatures']
|
|
75
|
+
: ['format', 'id', 'releases'];
|
|
76
|
+
const row = object(value, keys);
|
|
77
|
+
if (row['format'] !== 'ia.registry-package.v1')
|
|
78
|
+
fail('INPUT-INVALID', 'Not an ia.registry-package.v1 index');
|
|
79
|
+
if (row['id'] !== id)
|
|
80
|
+
fail('INPUT-INVALID', `Registry index names a different package than ${id}`);
|
|
81
|
+
if (!Array.isArray(row['releases']))
|
|
82
|
+
fail('INPUT-INVALID', 'Registry releases must be an array');
|
|
83
|
+
if (row['releases'].length > REGISTRY_LIMITS.releases)
|
|
84
|
+
fail('LIMIT-EXCEEDED', 'Registry index exceeds 1000 releases');
|
|
85
|
+
const versions = new Set();
|
|
86
|
+
const releases = row['releases'].map((entry) => {
|
|
87
|
+
if (entry === null || typeof entry !== 'object' || Array.isArray(entry))
|
|
88
|
+
fail('INPUT-INVALID', 'Registry release must be an object');
|
|
89
|
+
const raw = entry, access = raw['access'];
|
|
90
|
+
if (access !== 'public' && access !== 'licensed')
|
|
91
|
+
fail('INPUT-INVALID', 'Registry release access must be "public" or "licensed"');
|
|
92
|
+
const licensed = access === 'licensed';
|
|
93
|
+
// §3: `artifact` is present if and only if `access` is `"public"`; check that up front so the refusal names "artifact" instead of a generic unknown-field message.
|
|
94
|
+
const hasArtifactField = Object.hasOwn(raw, 'artifact');
|
|
95
|
+
if (hasArtifactField === licensed)
|
|
96
|
+
fail('INPUT-INVALID', 'Registry artifact must be present if and only if access is public');
|
|
97
|
+
const r = object(entry, licensed
|
|
98
|
+
? ['version', 'archive', 'manifest', 'engine', 'language', 'dependencies', 'withdrawn', 'access']
|
|
99
|
+
: ['version', 'archive', 'manifest', 'engine', 'language', 'dependencies', 'withdrawn', 'access', 'artifact']);
|
|
100
|
+
// Registry metadata copies the release manifest's own fields (spec §3), so it decodes with the same codecs: `version`, `range` (engine and each dependency range) and the exact `['1.0']` grammar.
|
|
101
|
+
const releaseVersion = field('version', undefined, () => version(r['version']));
|
|
102
|
+
const archive = hex(r['archive'], 'archive');
|
|
103
|
+
if (versions.has(releaseVersion))
|
|
104
|
+
fail('INPUT-INVALID', `Registry lists ${releaseVersion} more than once`);
|
|
105
|
+
versions.add(releaseVersion);
|
|
106
|
+
if (typeof r['withdrawn'] !== 'boolean')
|
|
107
|
+
fail('INPUT-INVALID', 'Invalid registry withdrawn flag');
|
|
108
|
+
if (!licensed && r['artifact'] !== `artifacts/${archive}.ia.tgz`)
|
|
109
|
+
fail('INPUT-INVALID', 'Registry artifact must be artifacts/<archive>.ia.tgz relative to the base');
|
|
110
|
+
if (!Array.isArray(r['language']) || r['language'].length !== 1 || r['language'][0] !== '1.0')
|
|
111
|
+
fail('INPUT-INVALID', 'Registry language must be exactly ["1.0"]');
|
|
112
|
+
if (!Array.isArray(r['dependencies']) || r['dependencies'].length > DISTRIBUTION_LIMITS.bundles)
|
|
113
|
+
fail('INPUT-INVALID', 'Invalid registry dependency list');
|
|
114
|
+
// Duplicate/self dependencies refuse the same way the manifest's own dependency lists do (packages/db/src/distribution/contracts.ts:29,45).
|
|
115
|
+
const seenDependencies = new Set();
|
|
116
|
+
const dependencies = r['dependencies'].map((d) => {
|
|
117
|
+
const dep = object(d, ['id', 'range']);
|
|
118
|
+
const depId = field('dependency id', releaseVersion, () => packageId(dep['id']));
|
|
119
|
+
if (depId === id)
|
|
120
|
+
fail('INPUT-INVALID', `Registry release ${releaseVersion} depends on itself: ${depId}`);
|
|
121
|
+
if (seenDependencies.has(depId))
|
|
122
|
+
fail('INPUT-INVALID', `Registry release ${releaseVersion} lists dependency ${depId} more than once`);
|
|
123
|
+
seenDependencies.add(depId);
|
|
124
|
+
return { id: depId, range: field('dependency range', releaseVersion, () => range(dep['range'])) };
|
|
125
|
+
});
|
|
126
|
+
const engineValue = field('engine', releaseVersion, () => range(r['engine']));
|
|
127
|
+
return {
|
|
128
|
+
version: releaseVersion,
|
|
129
|
+
archive,
|
|
130
|
+
manifest: hex(r['manifest'], 'manifest'),
|
|
131
|
+
engine: engineValue,
|
|
132
|
+
language: ['1.0'],
|
|
133
|
+
dependencies,
|
|
134
|
+
withdrawn: r['withdrawn'],
|
|
135
|
+
access,
|
|
136
|
+
...(licensed ? {} : { artifact: r['artifact'] }),
|
|
137
|
+
};
|
|
138
|
+
});
|
|
139
|
+
return frozen({ format: 'ia.registry-package.v1', id, releases });
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
//# sourceMappingURL=registry-layout.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-layout.js","sourceRoot":"","sources":["../src/registry-layout.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { BundleMetadata, Dependency, DistributionLock } from '@inventarch/db/distribution';
|
|
2
|
+
import type { RegistryChoice } from './registry-config.js';
|
|
3
|
+
import type { ReleaseCandidate } from './resolve.js';
|
|
4
|
+
/** Registry spec §7: delivers the exact bytes of a licensed release into the workspace cache and returns its sha256 location. */
|
|
5
|
+
export interface Acquirer {
|
|
6
|
+
acquire(release: {
|
|
7
|
+
id: string;
|
|
8
|
+
version: string;
|
|
9
|
+
archive: string;
|
|
10
|
+
manifest: string;
|
|
11
|
+
}, signal?: AbortSignal): Promise<{
|
|
12
|
+
location: `sha256:${string}`;
|
|
13
|
+
}>;
|
|
14
|
+
}
|
|
15
|
+
export interface RegistryResolveRequest {
|
|
16
|
+
readonly root: string;
|
|
17
|
+
readonly requests: readonly Dependency[];
|
|
18
|
+
readonly engine: string;
|
|
19
|
+
/** The lock to prefer and to check against (§3 append-only rule). */
|
|
20
|
+
readonly previous?: DistributionLock | undefined;
|
|
21
|
+
/** §6.2 `update <id>`: this id's pin is dropped from the preference, so the newest satisfying release wins. It is always named. */
|
|
22
|
+
readonly preferredExcept?: string | undefined;
|
|
23
|
+
/**
|
|
24
|
+
* §5.1: the ids the command names — `install`'s arguments, `update`'s id. Their indexes are always read. Absent, every
|
|
25
|
+
* request id is named, which reads every request's index.
|
|
26
|
+
*/
|
|
27
|
+
readonly named?: readonly string[] | undefined;
|
|
28
|
+
/** One command's read-once chooser (`registryChooser`). */
|
|
29
|
+
readonly choose: (id: string) => RegistryChoice;
|
|
30
|
+
readonly acquirer?: Acquirer | undefined;
|
|
31
|
+
readonly signal?: AbortSignal | undefined;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* `candidates` are exactly the selected releases, admitted. A selected cached lock pin retains its manifest-level
|
|
35
|
+
* metadata and the lock's own location. `sources` names the registry each selected id came from; a kept lock pin came
|
|
36
|
+
* from none.
|
|
37
|
+
*/
|
|
38
|
+
export interface RegistryResolution {
|
|
39
|
+
readonly candidates: readonly ReleaseCandidate<BundleMetadata>[];
|
|
40
|
+
readonly sources: ReadonlyMap<string, RegistryChoice>;
|
|
41
|
+
}
|
|
42
|
+
/** Registry spec §6.3: the locked ids whose cached archive is unpublished, so restore consults no registry for them. */
|
|
43
|
+
export declare function unpublishedPins(root: string, lock: DistributionLock): ReadonlySet<string>;
|
|
44
|
+
/**
|
|
45
|
+
* Registry spec §5.1-5.3: reads the metadata closure, selects on metadata with the shared search, then fetches and
|
|
46
|
+
* verifies only the selected archives. Feeding `candidates` to the unchanged `resolveReleases` reproduces the selection.
|
|
47
|
+
*/
|
|
48
|
+
export declare function resolveFromRegistries(request: RegistryResolveRequest): Promise<RegistryResolution>;
|
|
49
|
+
/**
|
|
50
|
+
* Registry spec §6.3: reads each locked package's index and returns the `id@version` pins it marks withdrawn. A locked
|
|
51
|
+
* version the index no longer lists, or lists with different digests, is a conflict. A locked package whose cached
|
|
52
|
+
* archive is unpublished (null provenance) is skipped: no registry lists it, so none can withdraw it. A package that is
|
|
53
|
+
* not cached (a fresh clone) is read like any other.
|
|
54
|
+
*/
|
|
55
|
+
export declare function registryWithdrawals(root: string, lock: DistributionLock, choose: (id: string) => RegistryChoice, signal?: AbortSignal): Promise<readonly string[]>;
|
|
56
|
+
//# sourceMappingURL=registry-resolve.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-resolve.d.ts","sourceRoot":"","sources":["../src/registry-resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAMhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,OAAO,KAAK,EAAqB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAExE,iIAAiI;AACjI,MAAM,WAAW,QAAQ;IACvB,OAAO,CACL,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAC3E,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,QAAQ,EAAE,UAAU,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9C;AACD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,mIAAmI;IACnI,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AACD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACvD;AA8CD,wHAAwH;AACxH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAUzF;AA+ED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkBxG;AA0RD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,EACtC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAe5B"}
|