@inventarch/runtime 3.4.1 → 3.5.1
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/SPEC.md +8 -2
- package/dist/method/bindings.d.ts +51 -0
- package/dist/method/bindings.d.ts.map +1 -0
- package/dist/method/bindings.js +166 -0
- package/dist/method/bindings.js.map +1 -0
- package/dist/method/catalogue.d.ts +39 -0
- package/dist/method/catalogue.d.ts.map +1 -0
- package/dist/method/catalogue.js +126 -0
- package/dist/method/catalogue.js.map +1 -0
- package/dist/method/errors.d.ts +28 -0
- package/dist/method/errors.d.ts.map +1 -0
- package/dist/method/errors.js +39 -0
- package/dist/method/errors.js.map +1 -0
- package/dist/method/index.d.ts +30 -0
- package/dist/method/index.d.ts.map +1 -0
- package/dist/method/index.js +16 -0
- package/dist/method/index.js.map +1 -0
- package/dist/method/installed-kits.d.ts +49 -0
- package/dist/method/installed-kits.d.ts.map +1 -0
- package/dist/method/installed-kits.js +194 -0
- package/dist/method/installed-kits.js.map +1 -0
- package/dist/method/kit-root.d.ts +31 -0
- package/dist/method/kit-root.d.ts.map +1 -0
- package/dist/method/kit-root.js +120 -0
- package/dist/method/kit-root.js.map +1 -0
- package/dist/method/kits.d.ts +130 -0
- package/dist/method/kits.d.ts.map +1 -0
- package/dist/method/kits.js +381 -0
- package/dist/method/kits.js.map +1 -0
- package/dist/method/packet.d.ts +51 -0
- package/dist/method/packet.d.ts.map +1 -0
- package/dist/method/packet.js +62 -0
- package/dist/method/packet.js.map +1 -0
- package/dist/method/pin.d.ts +71 -0
- package/dist/method/pin.d.ts.map +1 -0
- package/dist/method/pin.js +164 -0
- package/dist/method/pin.js.map +1 -0
- package/dist/method/reader.d.ts +38 -0
- package/dist/method/reader.d.ts.map +1 -0
- package/dist/method/reader.js +97 -0
- package/dist/method/reader.js.map +1 -0
- package/dist/method/registry.d.ts +39 -0
- package/dist/method/registry.d.ts.map +1 -0
- package/dist/method/registry.js +129 -0
- package/dist/method/registry.js.map +1 -0
- package/dist/method/releases.d.ts +47 -0
- package/dist/method/releases.d.ts.map +1 -0
- package/dist/method/releases.js +104 -0
- package/dist/method/releases.js.map +1 -0
- package/dist/method/resolve.d.ts +44 -0
- package/dist/method/resolve.d.ts.map +1 -0
- package/dist/method/resolve.js +448 -0
- package/dist/method/resolve.js.map +1 -0
- package/dist/method/retained.d.ts +8 -0
- package/dist/method/retained.d.ts.map +1 -0
- package/dist/method/retained.js +182 -0
- package/dist/method/retained.js.map +1 -0
- package/dist/method/root.d.ts +12 -0
- package/dist/method/root.d.ts.map +1 -0
- package/dist/method/root.js +43 -0
- package/dist/method/root.js.map +1 -0
- package/dist/method/session.d.ts +64 -0
- package/dist/method/session.d.ts.map +1 -0
- package/dist/method/session.js +109 -0
- package/dist/method/session.js.map +1 -0
- package/dist/packet-host.d.ts +1 -1
- package/dist/packet-host.d.ts.map +1 -1
- package/dist/packet.d.ts +1 -1
- package/dist/packet.d.ts.map +1 -1
- package/dist/packet.js +3 -2
- package/dist/packet.js.map +1 -1
- package/package.json +8 -4
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
|
|
2
|
+
import { homedir } from 'node:os';
|
|
3
|
+
import { isAbsolute, join, resolve } from 'node:path';
|
|
4
|
+
import { MethodError } from './errors.js';
|
|
5
|
+
/**
|
|
6
|
+
* The workspace registry: `<IA home>/workspace-locations.json`, the workspace roots one person keeps. Format 2 is
|
|
7
|
+
* `{ format: "ia-workspace-locations-2", workspaces: [{ id, root, label?, added }] }`. Readers also accept the two
|
|
8
|
+
* earlier files and normalise them: `personal-workspace-locations-1`, whose `workspaces` object maps an id to
|
|
9
|
+
* `{ root, ... }`, and Studio's `format: 1`, whose `locations` object maps an id to `{ path, ... }`. Writers write
|
|
10
|
+
* format 2 only. User-facing workspaces default to `~/Documents/ia/<domain>`; the IA home holds the registry, never a
|
|
11
|
+
* workspace.
|
|
12
|
+
*/
|
|
13
|
+
export const REGISTRY_FORMAT = 'ia-workspace-locations-2';
|
|
14
|
+
export const REGISTRY_FILE = 'workspace-locations.json';
|
|
15
|
+
const ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
|
|
16
|
+
export const registryPath = (home) => join(home, REGISTRY_FILE);
|
|
17
|
+
/** The default root of a user-facing workspace for a domain: `~/Documents/ia/<domain>`. */
|
|
18
|
+
export const defaultWorkspaceRoot = (domain, home = homedir()) => {
|
|
19
|
+
if (!ID.test(domain))
|
|
20
|
+
throw new MethodError(`a workspace domain must be a slug: ${domain}`, 'IA-CORE-USAGE');
|
|
21
|
+
return join(home, 'Documents', 'ia', domain);
|
|
22
|
+
};
|
|
23
|
+
const malformed = (path, why) => new MethodError(`${path} is not a workspace registry: ${why}`, 'IA-CORE-REGISTRY');
|
|
24
|
+
/** The registry, normalised to format 2 whichever format the file holds; an empty one when there is no file. */
|
|
25
|
+
export function readRegistry(home) {
|
|
26
|
+
const path = registryPath(home);
|
|
27
|
+
if (!existsSync(path))
|
|
28
|
+
return { format: REGISTRY_FORMAT, workspaces: [] };
|
|
29
|
+
let parsed;
|
|
30
|
+
try {
|
|
31
|
+
parsed = JSON.parse(readFileSync(path, 'utf8'));
|
|
32
|
+
}
|
|
33
|
+
catch (error) {
|
|
34
|
+
throw malformed(path, error.message);
|
|
35
|
+
}
|
|
36
|
+
const fallback = statSync(path).mtime.toISOString();
|
|
37
|
+
const entry = (id, value, rootKey) => {
|
|
38
|
+
const row = (value ?? {});
|
|
39
|
+
const root = row[rootKey];
|
|
40
|
+
if (typeof root !== 'string' || !isAbsolute(root))
|
|
41
|
+
throw malformed(path, `${id} names no absolute ${rootKey}`);
|
|
42
|
+
const label = typeof row['label'] === 'string' ? row['label'] : undefined;
|
|
43
|
+
const added = typeof row['added'] === 'string' ? row['added'] : fallback;
|
|
44
|
+
return { id, root, ...(label === undefined ? {} : { label }), added };
|
|
45
|
+
};
|
|
46
|
+
const keyed = (value, rootKey) => {
|
|
47
|
+
if (value === null || typeof value !== 'object' || Array.isArray(value))
|
|
48
|
+
throw malformed(path, 'no object of ids');
|
|
49
|
+
return Object.entries(value).map(([id, row]) => entry(id, row, rootKey));
|
|
50
|
+
};
|
|
51
|
+
let workspaces;
|
|
52
|
+
if (parsed['format'] === REGISTRY_FORMAT) {
|
|
53
|
+
if (!Array.isArray(parsed['workspaces']))
|
|
54
|
+
throw malformed(path, 'format 2 needs a workspaces list');
|
|
55
|
+
workspaces = parsed['workspaces'].map((row) => {
|
|
56
|
+
if (typeof row?.['id'] !== 'string')
|
|
57
|
+
throw malformed(path, 'a workspace has no id');
|
|
58
|
+
return entry(row['id'], row, 'root');
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
else if (parsed['format'] === 'personal-workspace-locations-1')
|
|
62
|
+
workspaces = keyed(parsed['workspaces'], 'root');
|
|
63
|
+
else if (parsed['format'] === 1)
|
|
64
|
+
workspaces = keyed(parsed['locations'], 'path');
|
|
65
|
+
else
|
|
66
|
+
throw malformed(path, `unknown format ${JSON.stringify(parsed['format'])}`);
|
|
67
|
+
const ids = new Set();
|
|
68
|
+
for (const workspace of workspaces) {
|
|
69
|
+
if (ids.has(workspace.id))
|
|
70
|
+
throw malformed(path, `${workspace.id} is listed twice`);
|
|
71
|
+
ids.add(workspace.id);
|
|
72
|
+
}
|
|
73
|
+
return { format: REGISTRY_FORMAT, workspaces };
|
|
74
|
+
}
|
|
75
|
+
/** Writes the registry as format 2, atomically. */
|
|
76
|
+
export function writeRegistry(home, registry) {
|
|
77
|
+
const path = registryPath(home);
|
|
78
|
+
mkdirSync(home, { recursive: true });
|
|
79
|
+
const temporary = `${path}.${process.pid}.${Date.now()}.tmp`;
|
|
80
|
+
const body = { format: REGISTRY_FORMAT, workspaces: registry.workspaces };
|
|
81
|
+
try {
|
|
82
|
+
writeFileSync(temporary, JSON.stringify(body, null, 2) + '\n', { flag: 'wx' });
|
|
83
|
+
renameSync(temporary, path);
|
|
84
|
+
}
|
|
85
|
+
finally {
|
|
86
|
+
rmSync(temporary, { force: true });
|
|
87
|
+
}
|
|
88
|
+
return path;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Adds or replaces one workspace and writes the registry as format 2, keeping every other row. A root inside the IA
|
|
92
|
+
* home is refused: the home holds configuration and state, never a workspace.
|
|
93
|
+
*/
|
|
94
|
+
export function registerWorkspace(home, workspace, now = new Date()) {
|
|
95
|
+
if (!ID.test(workspace.id))
|
|
96
|
+
throw new MethodError(`a workspace id must be a slug: ${workspace.id}`, 'IA-CORE-USAGE');
|
|
97
|
+
if (!isAbsolute(workspace.root))
|
|
98
|
+
throw new MethodError(`a workspace root must be absolute: ${workspace.root}`, 'IA-CORE-USAGE');
|
|
99
|
+
const root = resolve(workspace.root);
|
|
100
|
+
if (sameOrInside(root, home))
|
|
101
|
+
throw new MethodError(`${root} is inside the IA home ${home}; a workspace lives elsewhere`, 'IA-CORE-USAGE');
|
|
102
|
+
const current = readRegistry(home);
|
|
103
|
+
const prior = current.workspaces.find((row) => row.id === workspace.id);
|
|
104
|
+
const row = {
|
|
105
|
+
id: workspace.id,
|
|
106
|
+
root,
|
|
107
|
+
...(workspace.label === undefined ? {} : { label: workspace.label }),
|
|
108
|
+
added: prior?.added ?? now.toISOString(),
|
|
109
|
+
};
|
|
110
|
+
writeRegistry(home, {
|
|
111
|
+
workspaces: [...current.workspaces.filter((other) => other.id !== workspace.id), row],
|
|
112
|
+
});
|
|
113
|
+
return row;
|
|
114
|
+
}
|
|
115
|
+
/** The text without its trailing slashes, in one pass: a pattern anchored only at its end backtracks on a run of them. */
|
|
116
|
+
const trimSlashes = (text) => {
|
|
117
|
+
let end = text.length;
|
|
118
|
+
while (end > 0 && text[end - 1] === '/')
|
|
119
|
+
end -= 1;
|
|
120
|
+
return text.slice(0, end);
|
|
121
|
+
};
|
|
122
|
+
const key = (path) => {
|
|
123
|
+
const plain = trimSlashes(resolve(path).replace(/\\/g, '/'));
|
|
124
|
+
return process.platform === 'win32' || process.platform === 'darwin' ? plain.toLowerCase() : plain;
|
|
125
|
+
};
|
|
126
|
+
/** Whether two paths name one folder, case folded where the platform folds it. */
|
|
127
|
+
export const samePath = (a, b) => key(a) === key(b);
|
|
128
|
+
const sameOrInside = (path, parent) => samePath(path, parent) || key(path).startsWith(key(parent) + '/');
|
|
129
|
+
//# sourceMappingURL=registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/method/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A kit's recorded releases, in either layout.
|
|
3
|
+
*
|
|
4
|
+
* Format 1: `releases.json` is `{ kit, releases: [{ version, archive, manifest, sources, language, cli, records }] }`.
|
|
5
|
+
* Format 2: `releases.json` is an index `{ format: 2, kit, latest, releases }` whose rows keep every format 1 field in
|
|
6
|
+
* order but name `releases/<version>.json` in `file` where `records` was, and each per-version file is
|
|
7
|
+
* `{ format: 2, kit, version, archive, records, offers? }`. Expanding an index rebuilds the format 1 document.
|
|
8
|
+
*/
|
|
9
|
+
export declare const RELEASES_FORMAT = 2;
|
|
10
|
+
export interface ReleaseRow {
|
|
11
|
+
readonly version: string;
|
|
12
|
+
readonly archive?: string;
|
|
13
|
+
readonly cli?: string;
|
|
14
|
+
readonly file?: string;
|
|
15
|
+
readonly records?: readonly unknown[];
|
|
16
|
+
readonly [field: string]: unknown;
|
|
17
|
+
}
|
|
18
|
+
export interface ReleaseIndex {
|
|
19
|
+
readonly format?: number;
|
|
20
|
+
readonly kit: string;
|
|
21
|
+
readonly latest?: string;
|
|
22
|
+
readonly releases: readonly ReleaseRow[];
|
|
23
|
+
}
|
|
24
|
+
interface ReleaseFile {
|
|
25
|
+
readonly format: number;
|
|
26
|
+
readonly kit: string;
|
|
27
|
+
readonly version: string;
|
|
28
|
+
readonly archive: string;
|
|
29
|
+
readonly records: readonly unknown[];
|
|
30
|
+
}
|
|
31
|
+
export declare const releaseFile: (version: string) => string;
|
|
32
|
+
/** Checks a format 2 index: its latest is its last row, and every row names its own file. */
|
|
33
|
+
export declare function checkIndex(index: ReleaseIndex): ReleaseIndex;
|
|
34
|
+
/** One per-version file, checked against its index row. */
|
|
35
|
+
export declare function checkFile(index: ReleaseIndex, row: ReleaseRow, file: unknown): ReleaseFile;
|
|
36
|
+
/** Format 2 to format 1; `readFile` returns the parsed per-version file at a relative path. */
|
|
37
|
+
export declare function expandIndex(index: ReleaseIndex, readFile: (path: string) => unknown): ReleaseIndex;
|
|
38
|
+
/** The kit folder's release index as read: format 1, or a checked format 2 index. */
|
|
39
|
+
export declare function readReleases(kitDir: string): ReleaseIndex;
|
|
40
|
+
/** One release's record names: embedded (format 1) or its per-version file (format 2), checked against the row. */
|
|
41
|
+
export declare function releaseRecords(kitDir: string, release: ReleaseRow): readonly unknown[];
|
|
42
|
+
/** The whole history as format 1; a format 1 document passes through unchanged. */
|
|
43
|
+
export declare function expandReleases(kitDir: string): ReleaseIndex;
|
|
44
|
+
/** Release order: numeric parts numerically, others as text; a missing part sorts first. */
|
|
45
|
+
export declare function compareVersions(a: string, b: string): number;
|
|
46
|
+
export {};
|
|
47
|
+
//# sourceMappingURL=releases.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../src/method/releases.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C;AACD,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAAoC,CAAC;AAGnF,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAe5D;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,WAAW,CAc1F;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,YAAY,CASlG;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAiBzD;AAED,mHAAmH;AACnH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,OAAO,EAAE,CAgBtF;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAS3D;AAID,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5D"}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { MethodError } from './errors.js';
|
|
4
|
+
/**
|
|
5
|
+
* A kit's recorded releases, in either layout.
|
|
6
|
+
*
|
|
7
|
+
* Format 1: `releases.json` is `{ kit, releases: [{ version, archive, manifest, sources, language, cli, records }] }`.
|
|
8
|
+
* Format 2: `releases.json` is an index `{ format: 2, kit, latest, releases }` whose rows keep every format 1 field in
|
|
9
|
+
* order but name `releases/<version>.json` in `file` where `records` was, and each per-version file is
|
|
10
|
+
* `{ format: 2, kit, version, archive, records, offers? }`. Expanding an index rebuilds the format 1 document.
|
|
11
|
+
*/
|
|
12
|
+
export const RELEASES_FORMAT = 2;
|
|
13
|
+
export const releaseFile = (version) => `releases/${version}.json`;
|
|
14
|
+
const readJson = (path) => JSON.parse(readFileSync(path, 'utf8'));
|
|
15
|
+
/** Checks a format 2 index: its latest is its last row, and every row names its own file. */
|
|
16
|
+
export function checkIndex(index) {
|
|
17
|
+
if (index.format !== RELEASES_FORMAT || typeof index.kit !== 'string' || !Array.isArray(index.releases))
|
|
18
|
+
throw new MethodError('not a format 2 releases.json index', 'IA-CORE-RELEASES');
|
|
19
|
+
if (index.latest !== (index.releases.at(-1)?.version ?? null))
|
|
20
|
+
throw new MethodError(`index latest ${index.latest} is not its last release ${index.releases.at(-1)?.version}`, 'IA-CORE-RELEASES');
|
|
21
|
+
for (const row of index.releases)
|
|
22
|
+
if (row.file !== releaseFile(row.version))
|
|
23
|
+
throw new MethodError(`release ${row.version} names file ${row.file}, expected ${releaseFile(row.version)}`, 'IA-CORE-RELEASES');
|
|
24
|
+
return index;
|
|
25
|
+
}
|
|
26
|
+
/** One per-version file, checked against its index row. */
|
|
27
|
+
export function checkFile(index, row, file) {
|
|
28
|
+
const value = file;
|
|
29
|
+
if (value?.format !== RELEASES_FORMAT ||
|
|
30
|
+
value.kit !== index.kit ||
|
|
31
|
+
value.version !== row.version ||
|
|
32
|
+
value.archive !== row.archive ||
|
|
33
|
+
!Array.isArray(value.records))
|
|
34
|
+
throw new MethodError(`${row.file} does not belong to ${index.kit} ${row.version} ${row.archive}`, 'IA-CORE-RELEASES');
|
|
35
|
+
return value;
|
|
36
|
+
}
|
|
37
|
+
/** Format 2 to format 1; `readFile` returns the parsed per-version file at a relative path. */
|
|
38
|
+
export function expandIndex(index, readFile) {
|
|
39
|
+
checkIndex(index);
|
|
40
|
+
const releases = index.releases.map((row) => {
|
|
41
|
+
const file = checkFile(index, row, readFile(row.file));
|
|
42
|
+
return Object.fromEntries(Object.entries(row).map(([key, value]) => (key === 'file' ? ['records', file.records] : [key, value])));
|
|
43
|
+
});
|
|
44
|
+
return { kit: index.kit, releases };
|
|
45
|
+
}
|
|
46
|
+
/** The kit folder's release index as read: format 1, or a checked format 2 index. */
|
|
47
|
+
export function readReleases(kitDir) {
|
|
48
|
+
const path = join(kitDir, 'releases.json');
|
|
49
|
+
if (!existsSync(path))
|
|
50
|
+
throw new MethodError(`${kitDir} carries no releases.json`, 'IA-CORE-KIT');
|
|
51
|
+
const releases = readJson(path);
|
|
52
|
+
if (!releases.kit || !Array.isArray(releases.releases))
|
|
53
|
+
throw new MethodError(`${path} is malformed`, 'IA-CORE-KIT');
|
|
54
|
+
if (releases.format !== undefined && releases.format !== RELEASES_FORMAT)
|
|
55
|
+
throw new MethodError(`${path} has format ${releases.format}; this core reads formats 1 and ${RELEASES_FORMAT}`, 'IA-CORE-KIT');
|
|
56
|
+
if (releases.format === RELEASES_FORMAT)
|
|
57
|
+
try {
|
|
58
|
+
checkIndex(releases);
|
|
59
|
+
}
|
|
60
|
+
catch (error) {
|
|
61
|
+
throw new MethodError(`${path}: ${error.message}`, 'IA-CORE-KIT');
|
|
62
|
+
}
|
|
63
|
+
return releases;
|
|
64
|
+
}
|
|
65
|
+
/** One release's record names: embedded (format 1) or its per-version file (format 2), checked against the row. */
|
|
66
|
+
export function releaseRecords(kitDir, release) {
|
|
67
|
+
if (Array.isArray(release.records))
|
|
68
|
+
return release.records;
|
|
69
|
+
const index = readReleases(kitDir);
|
|
70
|
+
const row = index.releases.find((r) => r.version === release.version && r.archive === release.archive);
|
|
71
|
+
if (!row || typeof row.file !== 'string')
|
|
72
|
+
throw new MethodError(`${kitDir} records no release ${release.version} with archive ${release.archive}`, 'IA-CORE-KIT');
|
|
73
|
+
const path = join(kitDir, row.file);
|
|
74
|
+
if (!existsSync(path))
|
|
75
|
+
throw new MethodError(`${kitDir} lacks ${row.file}`, 'IA-CORE-KIT');
|
|
76
|
+
try {
|
|
77
|
+
return checkFile(index, row, readJson(path)).records;
|
|
78
|
+
}
|
|
79
|
+
catch (error) {
|
|
80
|
+
throw new MethodError(error.message, 'IA-CORE-KIT');
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
/** The whole history as format 1; a format 1 document passes through unchanged. */
|
|
84
|
+
export function expandReleases(kitDir) {
|
|
85
|
+
const index = readReleases(kitDir);
|
|
86
|
+
try {
|
|
87
|
+
return index.format === RELEASES_FORMAT ? expandIndex(index, (path) => readJson(join(kitDir, path))) : index;
|
|
88
|
+
}
|
|
89
|
+
catch (error) {
|
|
90
|
+
throw error instanceof MethodError && error.code === 'IA-CORE-KIT'
|
|
91
|
+
? error
|
|
92
|
+
: new MethodError(error.message, 'IA-CORE-KIT');
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
const parts = (version) => version.split(/[.-]/).map((part) => (/^\d+$/.test(part) ? Number(part) : part));
|
|
96
|
+
/** Release order: numeric parts numerically, others as text; a missing part sorts first. */
|
|
97
|
+
export function compareVersions(a, b) {
|
|
98
|
+
const [x, y] = [parts(a), parts(b)];
|
|
99
|
+
for (let i = 0; i < Math.max(x.length, y.length); i++)
|
|
100
|
+
if (x[i] !== y[i])
|
|
101
|
+
return (x[i] ?? -1) < (y[i] ?? -1) ? -1 : 1;
|
|
102
|
+
return 0;
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=releases.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"releases.js","sourceRoot":"","sources":["../../src/method/releases.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { KitRestore } from './kit-root.js';
|
|
2
|
+
import type { KitSources } from './kits.js';
|
|
3
|
+
import type { MethodPacket } from './packet.js';
|
|
4
|
+
/**
|
|
5
|
+
* The method resolver: an entry point's activity to the packet an agent acts on, from the repository's bindings, the
|
|
6
|
+
* task's pin and the bound kit's records, read in process. The order and the packet are the `ia` plugin's
|
|
7
|
+
* `resolve.mjs`: bindings, the pin, the retained kit, its read root, the position at the scope key, the capability's
|
|
8
|
+
* playbooks, checks and effects, the instructions, the packet, then the pin's next revision.
|
|
9
|
+
*/
|
|
10
|
+
export declare const RESOLVER = "inventarch/resolve 0.1.0";
|
|
11
|
+
export interface MethodRequest {
|
|
12
|
+
readonly entry: string;
|
|
13
|
+
readonly activity: string;
|
|
14
|
+
readonly subject?: string;
|
|
15
|
+
readonly seat?: string;
|
|
16
|
+
readonly root?: string;
|
|
17
|
+
readonly shape?: string;
|
|
18
|
+
readonly phase?: string;
|
|
19
|
+
readonly project?: string;
|
|
20
|
+
readonly task?: string;
|
|
21
|
+
readonly run?: string;
|
|
22
|
+
readonly pin?: boolean;
|
|
23
|
+
readonly noPin?: boolean;
|
|
24
|
+
readonly rebind?: boolean;
|
|
25
|
+
readonly host?: string;
|
|
26
|
+
readonly kit?: string;
|
|
27
|
+
readonly capability?: string;
|
|
28
|
+
readonly profile?: string;
|
|
29
|
+
}
|
|
30
|
+
export interface MethodContext {
|
|
31
|
+
/** Where kits are found: the bundled folder and the IA home's kit store. */
|
|
32
|
+
readonly kits: KitSources;
|
|
33
|
+
/** The native restore of a kit's language base into a read root. */
|
|
34
|
+
readonly restore: KitRestore;
|
|
35
|
+
readonly env?: NodeJS.ProcessEnv;
|
|
36
|
+
/** The closure store; `closureStore(env)` by default. */
|
|
37
|
+
readonly store?: string;
|
|
38
|
+
/** The parent of the per-user read-root cache; `<IA home>/kit-roots-v1` (`kitCache(env)`) by default. */
|
|
39
|
+
readonly cache?: string;
|
|
40
|
+
readonly cwd?: string;
|
|
41
|
+
}
|
|
42
|
+
/** Resolves one method packet; a refusal throws a `MethodError` whose `methodRefusal` payload the plugin prints. */
|
|
43
|
+
export declare function resolveMethod(request: MethodRequest, context: MethodContext): MethodPacket;
|
|
44
|
+
//# sourceMappingURL=resolve.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/method/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAahD,OAAO,KAAK,EAAO,UAAU,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,6BAA6B,CAAC;AAKnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AACD,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yGAAyG;IACzG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AA8ED,oHAAoH;AACpH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CA4a1F"}
|