@inventarch/runtime 3.4.0 → 3.5.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/SPEC.md +7 -1
- 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 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/method/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACb,UAAU,CAAsB;IAChC,GAAG,CAAU;IACb,UAAU,CAAU;IAC7B,YACE,OAAe,EACf,IAAY,EACZ,QAA2G,EAAE;QAE7G,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACvE,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAClD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACzE,CAAC;CACF;AAWD,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,IAAI,GACR,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9F,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,eAAe,CAAC;IACtB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;YAC5E,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;SACxD;KACF,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAuC,EAAE,CAC9E,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
export { MethodError, methodRefusal } from './errors.js';
|
|
2
|
+
export type { MethodRefusal } from './errors.js';
|
|
3
|
+
export { RELEASES_FORMAT, checkFile, checkIndex, compareVersions, expandIndex, expandReleases, readReleases, releaseFile, releaseRecords, } from './releases.js';
|
|
4
|
+
export type { ReleaseIndex, ReleaseRow } from './releases.js';
|
|
5
|
+
export { SIDECARS, assertPinnedKit, carrierOf, declaredAssets, findKit, folderKits, homeKits, iaHome, identityOf, implementationDigest, installedKit, kitBindings, kitChecks, kitDelivery, kitRecordNames, listKits, readDescriptor, readLock, sourcesDigest, } from './kits.js';
|
|
6
|
+
export type { Kit, KitCheck, KitOrigin, KitRecordName, KitSources, LockedPackage, Recommendation } from './kits.js';
|
|
7
|
+
export { INSTALLED_KITS_DIRECTORY, RESTORE_NEEDED, STORE, installedPackageKits, lockedPackageKits, packagedKit, restoreRefusal, workspaceKits, } from './installed-kits.js';
|
|
8
|
+
export type { InstalledKits, LockedKit } from './installed-kits.js';
|
|
9
|
+
export { ENTRIES, PHASES, RENAMED, SCOPE_KEYS, SHAPES, bindingsPath, findWorkspace, readBindings, renamedMessage, scopeKey, selectBinding, } from './bindings.js';
|
|
10
|
+
export type { Binding, Bindings, Entry, SelectedBinding } from './bindings.js';
|
|
11
|
+
export { PIN_FORMAT, kitUpdate, pinRootFor, projectOf, readPin, writePin } from './pin.js';
|
|
12
|
+
export type { Pin, PinnedKey, PinnedKit } from './pin.js';
|
|
13
|
+
export { DIGESTED, EVIDENCE_STATES, PACKET_CONTRACT, assemblePacket, canonical, packetDigest } from './packet.js';
|
|
14
|
+
export type { MethodPacket } from './packet.js';
|
|
15
|
+
export { closureStore, retainKit, retainedKit } from './retained.js';
|
|
16
|
+
export { assertReadable, kitCache, kitReadRoot, userCache } from './kit-root.js';
|
|
17
|
+
export type { KitRestore } from './kit-root.js';
|
|
18
|
+
export { WorkspaceReader } from './reader.js';
|
|
19
|
+
export type { JsonRecord, PositionAnswer } from './reader.js';
|
|
20
|
+
export { RESOLVER, resolveMethod } from './resolve.js';
|
|
21
|
+
export type { MethodContext, MethodRequest } from './resolve.js';
|
|
22
|
+
export { REGISTRY_FILE, REGISTRY_FORMAT, defaultWorkspaceRoot, readRegistry, registerWorkspace, registryPath, samePath, writeRegistry, } from './registry.js';
|
|
23
|
+
export type { RegisteredWorkspace, WorkspaceRegistry } from './registry.js';
|
|
24
|
+
export { DESCRIPTION_LIMIT, capabilityDescriptions, displayName, laneCatalogue } from './catalogue.js';
|
|
25
|
+
export type { Catalogue, CatalogueItem, CatalogueState } from './catalogue.js';
|
|
26
|
+
export { BRIEFING_LIMIT, LANES, SESSION_DIRECTORY, appendSessionEvent, briefing, currentPin, openSession, sessionKits, sessionRestore, } from './session.js';
|
|
27
|
+
export type { Session, SessionClaim, SessionKit, SessionPin, SessionRestore } from './session.js';
|
|
28
|
+
export { checkRoot } from './root.js';
|
|
29
|
+
export type { RootCheck } from './root.js';
|
|
30
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/method/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export { MethodError, methodRefusal } from './errors.js';
|
|
2
|
+
export { RELEASES_FORMAT, checkFile, checkIndex, compareVersions, expandIndex, expandReleases, readReleases, releaseFile, releaseRecords, } from './releases.js';
|
|
3
|
+
export { SIDECARS, assertPinnedKit, carrierOf, declaredAssets, findKit, folderKits, homeKits, iaHome, identityOf, implementationDigest, installedKit, kitBindings, kitChecks, kitDelivery, kitRecordNames, listKits, readDescriptor, readLock, sourcesDigest, } from './kits.js';
|
|
4
|
+
export { INSTALLED_KITS_DIRECTORY, RESTORE_NEEDED, STORE, installedPackageKits, lockedPackageKits, packagedKit, restoreRefusal, workspaceKits, } from './installed-kits.js';
|
|
5
|
+
export { ENTRIES, PHASES, RENAMED, SCOPE_KEYS, SHAPES, bindingsPath, findWorkspace, readBindings, renamedMessage, scopeKey, selectBinding, } from './bindings.js';
|
|
6
|
+
export { PIN_FORMAT, kitUpdate, pinRootFor, projectOf, readPin, writePin } from './pin.js';
|
|
7
|
+
export { DIGESTED, EVIDENCE_STATES, PACKET_CONTRACT, assemblePacket, canonical, packetDigest } from './packet.js';
|
|
8
|
+
export { closureStore, retainKit, retainedKit } from './retained.js';
|
|
9
|
+
export { assertReadable, kitCache, kitReadRoot, userCache } from './kit-root.js';
|
|
10
|
+
export { WorkspaceReader } from './reader.js';
|
|
11
|
+
export { RESOLVER, resolveMethod } from './resolve.js';
|
|
12
|
+
export { REGISTRY_FILE, REGISTRY_FORMAT, defaultWorkspaceRoot, readRegistry, registerWorkspace, registryPath, samePath, writeRegistry, } from './registry.js';
|
|
13
|
+
export { DESCRIPTION_LIMIT, capabilityDescriptions, displayName, laneCatalogue } from './catalogue.js';
|
|
14
|
+
export { BRIEFING_LIMIT, LANES, SESSION_DIRECTORY, appendSessionEvent, briefing, currentPin, openSession, sessionKits, sessionRestore, } from './session.js';
|
|
15
|
+
export { checkRoot } from './root.js';
|
|
16
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/method/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACL,eAAe,EACf,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,SAAS,EACT,cAAc,EACd,OAAO,EACP,UAAU,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,cAAc,EACd,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,KAAK,EACL,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAElH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvG,OAAO,EACL,cAAc,EACd,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { MethodError } from './errors.js';
|
|
2
|
+
import type { Kit, KitSources } from './kits.js';
|
|
3
|
+
/**
|
|
4
|
+
* Kits a workspace installs from an npm package of kits (contract C7b, ia-kb `dec-133`). The lock's `package` entry
|
|
5
|
+
* names each kit's IA release by id, version, archive and manifest digest; the engine installs it like any release,
|
|
6
|
+
* expanded under `.ia/distributions/store/<archive>/` at band 90. npm is transport only, so a kit is read from that
|
|
7
|
+
* store, never from the npm package folder. A store payload is not a kit folder (it has no `releases.json` and no lock
|
|
8
|
+
* of its own), so it is materialized once per archive under `<IA home>/installed-kits-v1/<archive>/`: its pinned files,
|
|
9
|
+
* each checked against the manifest the lock pins, a format 1 `releases.json` of its one release, and a
|
|
10
|
+
* `.ia/distributions.lock.json` pinning its dependencies exactly as the workspace lock does. A kit the lock names that
|
|
11
|
+
* the store lacks is not installed yet: a fresh clone runs `ia restore`.
|
|
12
|
+
*/
|
|
13
|
+
export declare const INSTALLED_KITS_DIRECTORY = "installed-kits-v1";
|
|
14
|
+
export declare const STORE: string;
|
|
15
|
+
/** What a session and a refusal say when the lock names kits the store lacks. */
|
|
16
|
+
export declare const RESTORE_NEEDED = "run ia restore";
|
|
17
|
+
export interface LockedKit {
|
|
18
|
+
readonly id: string;
|
|
19
|
+
readonly version: string;
|
|
20
|
+
readonly archive: string;
|
|
21
|
+
readonly manifest: string;
|
|
22
|
+
readonly dependencies: readonly string[];
|
|
23
|
+
/** `<name>@<version>` of the package entry that names it. */
|
|
24
|
+
readonly package: string;
|
|
25
|
+
}
|
|
26
|
+
/** The kits the lock's package entries name, in lock order; none without entries or a lock. */
|
|
27
|
+
export declare function lockedPackageKits(root: string): LockedKit[];
|
|
28
|
+
/** Whether the lock's package entries name kit `id`. */
|
|
29
|
+
export declare const packagedKit: (root: string, id: string) => LockedKit | undefined;
|
|
30
|
+
export interface InstalledKits {
|
|
31
|
+
/** The kits the lock's package entries name that the store holds, origin `installed`. */
|
|
32
|
+
readonly kits: readonly Kit[];
|
|
33
|
+
/** Those the store lacks: the workspace needs `ia restore`. */
|
|
34
|
+
readonly missing: readonly LockedKit[];
|
|
35
|
+
}
|
|
36
|
+
/** The kits the workspace at root installs from its package entries, read from its store. */
|
|
37
|
+
export declare function installedPackageKits(root: string, env?: NodeJS.ProcessEnv): InstalledKits;
|
|
38
|
+
/** The refusal a binding to a kit the store lacks meets. */
|
|
39
|
+
export declare const restoreRefusal: (kit: LockedKit) => MethodError;
|
|
40
|
+
/**
|
|
41
|
+
* The kits a resolve at a workspace reads: the bundled folder's, then each kit the lock's package entries install, then
|
|
42
|
+
* the IA home's. A kit a package entry names comes only from the store, so one the store lacks is never answered by
|
|
43
|
+
* another copy. Outside a workspace, or with no package entry, it is `listKits` unchanged.
|
|
44
|
+
*/
|
|
45
|
+
export declare function workspaceKits(sources: KitSources, root: string | null, env?: NodeJS.ProcessEnv): {
|
|
46
|
+
readonly kits: Kit[];
|
|
47
|
+
readonly missing: readonly LockedKit[];
|
|
48
|
+
};
|
|
49
|
+
//# sourceMappingURL=installed-kits.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"installed-kits.d.ts","sourceRoot":"","sources":["../../src/method/installed-kits.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAY,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAiB,MAAM,WAAW,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAC5D,eAAO,MAAM,KAAK,QAAwC,CAAC;AAC3D,iFAAiF;AACjF,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAgC3D;AAED,wDAAwD;AACxD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,IAAI,MAAM,KAAG,SAAS,GAAG,SACb,CAAC;AA4GvD,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC;AACD,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAgBtG;AAED,4DAA4D;AAC5D,eAAO,MAAM,cAAc,GAAI,KAAK,SAAS,KAAG,WAI7C,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAelE"}
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
|
|
3
|
+
import { dirname, join } from 'node:path';
|
|
4
|
+
import { MethodError, objectAt } from './errors.js';
|
|
5
|
+
import { iaHome, kitAt, listKits, readLock } from './kits.js';
|
|
6
|
+
/**
|
|
7
|
+
* Kits a workspace installs from an npm package of kits (contract C7b, ia-kb `dec-133`). The lock's `package` entry
|
|
8
|
+
* names each kit's IA release by id, version, archive and manifest digest; the engine installs it like any release,
|
|
9
|
+
* expanded under `.ia/distributions/store/<archive>/` at band 90. npm is transport only, so a kit is read from that
|
|
10
|
+
* store, never from the npm package folder. A store payload is not a kit folder (it has no `releases.json` and no lock
|
|
11
|
+
* of its own), so it is materialized once per archive under `<IA home>/installed-kits-v1/<archive>/`: its pinned files,
|
|
12
|
+
* each checked against the manifest the lock pins, a format 1 `releases.json` of its one release, and a
|
|
13
|
+
* `.ia/distributions.lock.json` pinning its dependencies exactly as the workspace lock does. A kit the lock names that
|
|
14
|
+
* the store lacks is not installed yet: a fresh clone runs `ia restore`.
|
|
15
|
+
*/
|
|
16
|
+
export const INSTALLED_KITS_DIRECTORY = 'installed-kits-v1';
|
|
17
|
+
export const STORE = join('.ia', 'distributions', 'store');
|
|
18
|
+
/** What a session and a refusal say when the lock names kits the store lacks. */
|
|
19
|
+
export const RESTORE_NEEDED = 'run ia restore';
|
|
20
|
+
const HEX = /^[a-f0-9]{64}$/;
|
|
21
|
+
const malformed = (message) => {
|
|
22
|
+
throw new MethodError(`.ia/distributions.lock.json: ${message}`, 'IA-CORE-LOCK-MALFORMED');
|
|
23
|
+
};
|
|
24
|
+
/** The kits the lock's package entries name, in lock order; none without entries or a lock. */
|
|
25
|
+
export function lockedPackageKits(root) {
|
|
26
|
+
const lock = readLock(root);
|
|
27
|
+
if (lock?.entries === undefined)
|
|
28
|
+
return [];
|
|
29
|
+
if (!Array.isArray(lock.entries))
|
|
30
|
+
return malformed('entries must be a list');
|
|
31
|
+
return lock.entries.flatMap((value) => {
|
|
32
|
+
const entry = objectAt(value) ?? malformed('an entry must be an object');
|
|
33
|
+
if (entry['kind'] !== 'package')
|
|
34
|
+
return [];
|
|
35
|
+
const kits = entry['kits'];
|
|
36
|
+
if (!Array.isArray(kits))
|
|
37
|
+
return malformed('a package entry needs a kits list');
|
|
38
|
+
return kits.map((row) => {
|
|
39
|
+
const kit = objectAt(row) ?? malformed('a kit row must be an object');
|
|
40
|
+
const { id, version, archive, manifest } = kit;
|
|
41
|
+
const dependencies = Array.isArray(kit['dependencies']) ? kit['dependencies'].map(String) : [];
|
|
42
|
+
if (typeof id !== 'string' ||
|
|
43
|
+
typeof version !== 'string' ||
|
|
44
|
+
typeof archive !== 'string' ||
|
|
45
|
+
!HEX.test(archive) ||
|
|
46
|
+
typeof manifest !== 'string' ||
|
|
47
|
+
!HEX.test(manifest))
|
|
48
|
+
return malformed('a kit row needs its id, version, archive and manifest digests');
|
|
49
|
+
return {
|
|
50
|
+
id,
|
|
51
|
+
version,
|
|
52
|
+
archive,
|
|
53
|
+
manifest,
|
|
54
|
+
dependencies,
|
|
55
|
+
package: `${String(entry['name'])}@${String(entry['version'])}`,
|
|
56
|
+
};
|
|
57
|
+
});
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
/** Whether the lock's package entries name kit `id`. */
|
|
61
|
+
export const packagedKit = (root, id) => lockedPackageKits(root).find((kit) => kit.id === id);
|
|
62
|
+
const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
|
|
63
|
+
const pinsOf = (manifest) => (manifest['files'] ?? []).map((file) => {
|
|
64
|
+
if (typeof file.path !== 'string' || typeof file.sha256 !== 'string' || file.path.split('/').includes('..'))
|
|
65
|
+
throw new MethodError('an installed manifest names an unsafe file', 'IA-CORE-CLOSURE-INTEGRITY');
|
|
66
|
+
return { path: file.path, sha256: file.sha256 };
|
|
67
|
+
});
|
|
68
|
+
/** The lock that pins a kit's dependencies as the workspace lock does: their rows and theirs, transitively. */
|
|
69
|
+
function kitLock(root, manifest) {
|
|
70
|
+
const lock = readLock(root) ?? {};
|
|
71
|
+
const rows = [...(lock.packages ?? []), ...lockedPackageKits(root)];
|
|
72
|
+
const dependencies = (manifest['dependencies'] ?? []).map(({ id, range }) => ({
|
|
73
|
+
id,
|
|
74
|
+
range,
|
|
75
|
+
}));
|
|
76
|
+
const needed = new Map();
|
|
77
|
+
const visit = (id) => {
|
|
78
|
+
if (needed.has(id))
|
|
79
|
+
return;
|
|
80
|
+
const row = rows.find((candidate) => candidate.id === id);
|
|
81
|
+
if (row === undefined)
|
|
82
|
+
throw new MethodError(`installed kit depends on ${id}, which the workspace lock does not install`, 'IA-CORE-KIT');
|
|
83
|
+
needed.set(id, row);
|
|
84
|
+
(row.dependencies ?? []).forEach(visit);
|
|
85
|
+
};
|
|
86
|
+
dependencies.forEach((dependency) => visit(dependency.id));
|
|
87
|
+
return {
|
|
88
|
+
engine: '0.1.1',
|
|
89
|
+
formatVersion: 1,
|
|
90
|
+
packages: [...needed.values()]
|
|
91
|
+
.sort((a, b) => (a.id < b.id ? -1 : 1))
|
|
92
|
+
.map((row) => ({
|
|
93
|
+
archive: row.archive,
|
|
94
|
+
dependencies: row.dependencies ?? [],
|
|
95
|
+
id: row.id,
|
|
96
|
+
location: row.location ?? `sha256:${row.archive}`,
|
|
97
|
+
manifest: row.manifest,
|
|
98
|
+
version: row.version,
|
|
99
|
+
})),
|
|
100
|
+
requests: dependencies.sort((a, b) => (a.id < b.id ? -1 : 1)),
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
const COMPLETE = '.installed-kit.json';
|
|
104
|
+
/** The materialized kit folder of one installed kit, made from the store once and checked on every read. */
|
|
105
|
+
function materialize(root, kit, home) {
|
|
106
|
+
const store = join(root, STORE, kit.archive);
|
|
107
|
+
const manifestBytes = readFileSync(join(store, 'distribution.json'));
|
|
108
|
+
if (sha256(manifestBytes) !== kit.manifest)
|
|
109
|
+
throw new MethodError(`installed kit ${kit.id} ${kit.version}: ${STORE}/${kit.archive}/distribution.json is not the manifest the lock pins; ${RESTORE_NEEDED}`, 'IA-CORE-CLOSURE-INTEGRITY');
|
|
110
|
+
const manifest = JSON.parse(manifestBytes.toString('utf8'));
|
|
111
|
+
if (manifest['id'] !== kit.id || manifest['version'] !== kit.version)
|
|
112
|
+
throw new MethodError(`installed kit ${kit.id}: its manifest names another release`, 'IA-CORE-CLOSURE-INTEGRITY');
|
|
113
|
+
const pins = pinsOf(manifest);
|
|
114
|
+
const parent = join(home, INSTALLED_KITS_DIRECTORY);
|
|
115
|
+
const target = join(parent, kit.archive);
|
|
116
|
+
const intact = (dir) => existsSync(join(dir, COMPLETE)) &&
|
|
117
|
+
pins.every((pin) => existsSync(join(dir, pin.path)) && sha256(readFileSync(join(dir, pin.path))) === pin.sha256);
|
|
118
|
+
if (intact(target))
|
|
119
|
+
return target;
|
|
120
|
+
mkdirSync(parent, { recursive: true, mode: 0o700 });
|
|
121
|
+
const work = mkdtempSync(join(parent, 'tmp-'));
|
|
122
|
+
try {
|
|
123
|
+
for (const pin of pins) {
|
|
124
|
+
const bytes = readFileSync(join(store, pin.path));
|
|
125
|
+
if (sha256(bytes) !== pin.sha256)
|
|
126
|
+
throw new MethodError(`installed kit ${kit.id}: ${STORE}/${kit.archive}/${pin.path} differs from its pin; ${RESTORE_NEEDED}`, 'IA-CORE-CLOSURE-INTEGRITY');
|
|
127
|
+
mkdirSync(dirname(join(work, pin.path)), { recursive: true });
|
|
128
|
+
writeFileSync(join(work, pin.path), bytes);
|
|
129
|
+
}
|
|
130
|
+
writeFileSync(join(work, 'releases.json'), JSON.stringify({
|
|
131
|
+
kit: kit.id,
|
|
132
|
+
releases: [{ version: kit.version, archive: kit.archive, manifest: kit.manifest, records: [] }],
|
|
133
|
+
}, null, 2) + '\n');
|
|
134
|
+
mkdirSync(join(work, '.ia'), { recursive: true });
|
|
135
|
+
writeFileSync(join(work, '.ia', 'distributions.lock.json'), JSON.stringify(kitLock(root, manifest)) + '\n');
|
|
136
|
+
writeFileSync(join(work, COMPLETE), JSON.stringify({ kit: kit.id, archive: kit.archive, manifest: kit.manifest }));
|
|
137
|
+
rmSync(target, { recursive: true, force: true });
|
|
138
|
+
try {
|
|
139
|
+
renameSync(work, target);
|
|
140
|
+
}
|
|
141
|
+
catch (error) {
|
|
142
|
+
if (!intact(target))
|
|
143
|
+
throw error;
|
|
144
|
+
}
|
|
145
|
+
return target;
|
|
146
|
+
}
|
|
147
|
+
finally {
|
|
148
|
+
rmSync(work, { recursive: true, force: true });
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
/** The kits the workspace at root installs from its package entries, read from its store. */
|
|
152
|
+
export function installedPackageKits(root, env = process.env) {
|
|
153
|
+
const locked = lockedPackageKits(root);
|
|
154
|
+
if (locked.length === 0)
|
|
155
|
+
return { kits: [], missing: [] };
|
|
156
|
+
const home = iaHome(env);
|
|
157
|
+
mkdirSync(home, { recursive: true, mode: 0o700 });
|
|
158
|
+
const kits = [], missing = [];
|
|
159
|
+
for (const kit of locked) {
|
|
160
|
+
if (!existsSync(join(root, STORE, kit.archive, 'distribution.json'))) {
|
|
161
|
+
missing.push(kit);
|
|
162
|
+
continue;
|
|
163
|
+
}
|
|
164
|
+
const dir = materialize(root, kit, realpathSync(home));
|
|
165
|
+
kits.push(kitAt(dir, kit.id.slice(kit.id.indexOf('/') + 1), 'installed'));
|
|
166
|
+
}
|
|
167
|
+
return { kits, missing };
|
|
168
|
+
}
|
|
169
|
+
/** The refusal a binding to a kit the store lacks meets. */
|
|
170
|
+
export const restoreRefusal = (kit) => new MethodError(`kit ${kit.id} ${kit.version} is installed from ${kit.package} by .ia/distributions.lock.json, but ${STORE} does not hold it yet: ${RESTORE_NEEDED}`, 'IA-CORE-KIT-RESTORE-REQUIRED');
|
|
171
|
+
/**
|
|
172
|
+
* The kits a resolve at a workspace reads: the bundled folder's, then each kit the lock's package entries install, then
|
|
173
|
+
* the IA home's. A kit a package entry names comes only from the store, so one the store lacks is never answered by
|
|
174
|
+
* another copy. Outside a workspace, or with no package entry, it is `listKits` unchanged.
|
|
175
|
+
*/
|
|
176
|
+
export function workspaceKits(sources, root, env) {
|
|
177
|
+
const all = listKits(sources);
|
|
178
|
+
if (root === null)
|
|
179
|
+
return { kits: all, missing: [] };
|
|
180
|
+
const installed = installedPackageKits(root, env);
|
|
181
|
+
const named = new Set([...installed.kits.map((kit) => kit.id), ...installed.missing.map((kit) => kit.id)]);
|
|
182
|
+
if (named.size === 0)
|
|
183
|
+
return { kits: all, missing: [] };
|
|
184
|
+
const kept = all.filter((kit) => !named.has(kit.id));
|
|
185
|
+
return {
|
|
186
|
+
kits: [
|
|
187
|
+
...kept.filter((kit) => kit.origin === 'bundled'),
|
|
188
|
+
...installed.kits,
|
|
189
|
+
...kept.filter((kit) => kit.origin !== 'bundled'),
|
|
190
|
+
],
|
|
191
|
+
missing: installed.missing,
|
|
192
|
+
};
|
|
193
|
+
}
|
|
194
|
+
//# sourceMappingURL=installed-kits.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"installed-kits.js","sourceRoot":"","sources":["../../src/method/installed-kits.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { Kit } from './kits.js';
|
|
2
|
+
/**
|
|
3
|
+
* The read root of a kit: a restored copy of its workspace in a per-user cache folder, keyed by its source digests, so
|
|
4
|
+
* any reader opens it with the language base its lock pins. Nothing is written into the kit's own folder. The native
|
|
5
|
+
* restore is the caller's (`KitRestore`): a host that carries the language base installs it in process.
|
|
6
|
+
*/
|
|
7
|
+
export type KitRestore = (root: string, kit: Kit) => void;
|
|
8
|
+
/**
|
|
9
|
+
* The default parent of the read-root cache: `kit-roots-v1` under the IA home, which is this user's, never the shared
|
|
10
|
+
* system temporary folder. The IA home is created when missing and named through its links.
|
|
11
|
+
*/
|
|
12
|
+
export declare function kitCache(env?: NodeJS.ProcessEnv): string;
|
|
13
|
+
/** The folder under `base` that holds this user's restored copies, refused when another user owns it. */
|
|
14
|
+
export declare function userCache(base: string): string;
|
|
15
|
+
/**
|
|
16
|
+
* A kit can be read only by a reader of the major its latest release was packed with, or a later one: a 3.x release
|
|
17
|
+
* locks a 3.x language base. A reader of unknown version is let through.
|
|
18
|
+
*/
|
|
19
|
+
export declare function assertReadable(kit: Kit, reader: {
|
|
20
|
+
readonly version?: string | undefined;
|
|
21
|
+
readonly source: string;
|
|
22
|
+
}): void;
|
|
23
|
+
/**
|
|
24
|
+
* The restored read root of a kit, restoring a fresh copy when the cache holds no complete one. The cache's parent is
|
|
25
|
+
* `options.base`, else `kitCache(options.env)`.
|
|
26
|
+
*/
|
|
27
|
+
export declare function kitReadRoot(kit: Kit, restore: KitRestore, options?: {
|
|
28
|
+
readonly base?: string;
|
|
29
|
+
readonly env?: NodeJS.ProcessEnv;
|
|
30
|
+
}): string;
|
|
31
|
+
//# sourceMappingURL=kit-root.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kit-root.d.ts","sourceRoot":"","sources":["../../src/method/kit-root.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAI1D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIrE;AAED,yGAAyG;AACzG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB9C;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzE,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACzE,MAAM,CA4CR"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
|
|
3
|
+
import { userInfo } from 'node:os';
|
|
4
|
+
import { basename, dirname, join, relative, resolve } from 'node:path';
|
|
5
|
+
import { MethodError } from './errors.js';
|
|
6
|
+
import { declaredAssets, iaHome, isText, lf, sourcesDigest, walk } from './kits.js';
|
|
7
|
+
const NUL = String.fromCharCode(0);
|
|
8
|
+
/**
|
|
9
|
+
* The default parent of the read-root cache: `kit-roots-v1` under the IA home, which is this user's, never the shared
|
|
10
|
+
* system temporary folder. The IA home is created when missing and named through its links.
|
|
11
|
+
*/
|
|
12
|
+
export function kitCache(env = process.env) {
|
|
13
|
+
const home = iaHome(env);
|
|
14
|
+
mkdirSync(home, { recursive: true, mode: 0o700 });
|
|
15
|
+
return join(realpathSync(home), 'kit-roots-v1');
|
|
16
|
+
}
|
|
17
|
+
/** The folder under `base` that holds this user's restored copies, refused when another user owns it. */
|
|
18
|
+
export function userCache(base) {
|
|
19
|
+
const at0 = resolve(base);
|
|
20
|
+
for (let at = at0;; at = dirname(at)) {
|
|
21
|
+
const stat = lstatSync(at, { throwIfNoEntry: false });
|
|
22
|
+
if (stat && (!stat.isDirectory() || stat.isSymbolicLink()))
|
|
23
|
+
throw new MethodError('Aliased or non-directory cache parent', 'IA-CORE-KIT');
|
|
24
|
+
if (at === dirname(at))
|
|
25
|
+
break;
|
|
26
|
+
}
|
|
27
|
+
const who = (typeof process.getuid === 'function' ? String(process.getuid()) : userInfo().username).replace(/[^A-Za-z0-9._-]/g, '_');
|
|
28
|
+
const dir = join(at0, `inventarch-core-${who}`);
|
|
29
|
+
const prior = lstatSync(dir, { throwIfNoEntry: false });
|
|
30
|
+
if (prior && (!prior.isDirectory() || prior.isSymbolicLink()))
|
|
31
|
+
throw new MethodError('Aliased or non-directory cache', 'IA-CORE-KIT');
|
|
32
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
33
|
+
if (typeof process.getuid === 'function' && statSync(dir).uid !== process.getuid())
|
|
34
|
+
throw new MethodError(`${dir} belongs to another user; set IA_HOME to a private folder`, 'IA-CORE-KIT');
|
|
35
|
+
return dir;
|
|
36
|
+
}
|
|
37
|
+
function normalize(dir) {
|
|
38
|
+
for (const path of walk(dir)) {
|
|
39
|
+
if (!isText(path))
|
|
40
|
+
continue;
|
|
41
|
+
const text = readFileSync(path, 'utf8');
|
|
42
|
+
if (text.includes('\r\n'))
|
|
43
|
+
writeFileSync(path, text.replace(/\r\n/g, '\n'));
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
function readSourceDigest(root, normalized = false) {
|
|
47
|
+
const hash = createHash('sha256');
|
|
48
|
+
const ia = join(root, '.ia');
|
|
49
|
+
for (const file of walk(ia)) {
|
|
50
|
+
const path = relative(ia, file).replace(/\\/g, '/');
|
|
51
|
+
if (path.startsWith('distributions/') || path.startsWith('work/'))
|
|
52
|
+
continue;
|
|
53
|
+
const bytes = readFileSync(file);
|
|
54
|
+
hash
|
|
55
|
+
.update(path + NUL)
|
|
56
|
+
.update(normalized && isText(file) ? lf(bytes) : bytes)
|
|
57
|
+
.update(NUL);
|
|
58
|
+
}
|
|
59
|
+
return hash.digest('hex');
|
|
60
|
+
}
|
|
61
|
+
const complete = (dir) => existsSync(join(dir, '.ia', 'distributions', 'active.json'));
|
|
62
|
+
/**
|
|
63
|
+
* A kit can be read only by a reader of the major its latest release was packed with, or a later one: a 3.x release
|
|
64
|
+
* locks a 3.x language base. A reader of unknown version is let through.
|
|
65
|
+
*/
|
|
66
|
+
export function assertReadable(kit, reader) {
|
|
67
|
+
const packed = /^@inventarch\/cli ((\d+)\.\S*)$/.exec(String(kit.latest?.cli ?? ''));
|
|
68
|
+
const major = Number(/^(\d+)\./.exec(reader.version ?? '')?.[1]);
|
|
69
|
+
if (packed && Number.isInteger(major) && major < Number(packed[2]))
|
|
70
|
+
throw new MethodError(`kit ${kit.id} ${kit.latest?.version} was packed with @inventarch/cli ${packed[1]}, whose language base this reader cannot restore: it resolves ${reader.version} (${reader.source})`, 'IA-CORE-CLI-UNSUPPORTED');
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* The restored read root of a kit, restoring a fresh copy when the cache holds no complete one. The cache's parent is
|
|
74
|
+
* `options.base`, else `kitCache(options.env)`.
|
|
75
|
+
*/
|
|
76
|
+
export function kitReadRoot(kit, restore, options = {}) {
|
|
77
|
+
const cache = userCache(options.base ?? kitCache(options.env));
|
|
78
|
+
const target = join(cache, `kit-${basename(kit.folder)}-${createHash('sha256')
|
|
79
|
+
.update(sourcesDigest(kit.dir))
|
|
80
|
+
.update(readSourceDigest(kit.dir, true))
|
|
81
|
+
.digest('hex')}`);
|
|
82
|
+
const verified = () => {
|
|
83
|
+
if (readSourceDigest(target) !== readSourceDigest(kit.dir, true))
|
|
84
|
+
throw new MethodError(`restored method sources were altered at ${target}`, 'IA-CORE-CLOSURE-INTEGRITY');
|
|
85
|
+
for (const { rel, abs } of declaredAssets(kit.dir)) {
|
|
86
|
+
const expected = readFileSync(abs);
|
|
87
|
+
const bytes = isText(abs) ? lf(expected) : expected;
|
|
88
|
+
if (!existsSync(join(target, rel)) || !readFileSync(join(target, rel)).equals(bytes))
|
|
89
|
+
throw new MethodError(`restored method asset was altered: ${rel}`, 'IA-CORE-CLOSURE-INTEGRITY');
|
|
90
|
+
}
|
|
91
|
+
return target;
|
|
92
|
+
};
|
|
93
|
+
if (complete(target))
|
|
94
|
+
return verified();
|
|
95
|
+
const work = mkdtempSync(join(cache, 'tmp-'));
|
|
96
|
+
try {
|
|
97
|
+
cpSync(join(kit.dir, '.ia'), join(work, '.ia'), { recursive: true });
|
|
98
|
+
for (const { rel, abs } of declaredAssets(kit.dir)) {
|
|
99
|
+
mkdirSync(dirname(join(work, rel)), { recursive: true });
|
|
100
|
+
copyFileSync(abs, join(work, rel));
|
|
101
|
+
}
|
|
102
|
+
normalize(work);
|
|
103
|
+
restore(work, kit);
|
|
104
|
+
if (existsSync(target) && !complete(target))
|
|
105
|
+
rmSync(target, { recursive: true, force: true });
|
|
106
|
+
try {
|
|
107
|
+
renameSync(work, target);
|
|
108
|
+
}
|
|
109
|
+
catch (error) {
|
|
110
|
+
if (complete(target))
|
|
111
|
+
return verified();
|
|
112
|
+
throw new MethodError(`could not place the restored kit at ${target}: ${error.message}`, 'IA-CORE-KIT');
|
|
113
|
+
}
|
|
114
|
+
return target;
|
|
115
|
+
}
|
|
116
|
+
finally {
|
|
117
|
+
rmSync(work, { recursive: true, force: true });
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
//# sourceMappingURL=kit-root.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kit-root.js","sourceRoot":"","sources":["../../src/method/kit-root.ts"],"names":[],"mappings":"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"}
|