@boristype/ws-client 0.1.0-alpha.4 → 0.1.0-alpha.6
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/README.md +162 -13
- package/build/client.d.ts +3 -1
- package/build/client.d.ts.map +1 -1
- package/build/client.js +3 -1
- package/build/client.js.map +1 -1
- package/build/evaluator.d.ts +8 -0
- package/build/evaluator.d.ts.map +1 -1
- package/build/evaluator.js +10 -0
- package/build/evaluator.js.map +1 -1
- package/build/hcm/api.d.ts +18 -0
- package/build/hcm/api.d.ts.map +1 -0
- package/build/hcm/api.js +31 -0
- package/build/hcm/api.js.map +1 -0
- package/build/hcm/file-contract.d.ts +67 -0
- package/build/hcm/file-contract.d.ts.map +1 -0
- package/build/hcm/file-contract.js +93 -0
- package/build/hcm/file-contract.js.map +1 -0
- package/build/hcm/files.d.ts +90 -0
- package/build/hcm/files.d.ts.map +1 -0
- package/build/hcm/files.js +122 -0
- package/build/hcm/files.js.map +1 -0
- package/build/hcm/load.d.ts +14 -0
- package/build/hcm/load.d.ts.map +1 -0
- package/build/hcm/load.js +24 -0
- package/build/hcm/load.js.map +1 -0
- package/build/hcm/managed-files.d.ts +7 -0
- package/build/hcm/managed-files.d.ts.map +1 -0
- package/build/hcm/managed-files.js +29 -0
- package/build/hcm/managed-files.js.map +1 -0
- package/build/hcm/object-error.d.ts +16 -0
- package/build/hcm/object-error.d.ts.map +1 -0
- package/build/hcm/object-error.js +9 -0
- package/build/hcm/object-error.js.map +1 -0
- package/build/hcm/object-state.d.ts +24 -0
- package/build/hcm/object-state.d.ts.map +1 -0
- package/build/hcm/object-state.js +41 -0
- package/build/hcm/object-state.js.map +1 -0
- package/build/hcm/object-xml.d.ts +21 -0
- package/build/hcm/object-xml.d.ts.map +1 -0
- package/build/hcm/object-xml.js +95 -0
- package/build/hcm/object-xml.js.map +1 -0
- package/build/hcm/objects.d.ts +31 -0
- package/build/hcm/objects.d.ts.map +1 -0
- package/build/hcm/objects.js +155 -0
- package/build/hcm/objects.js.map +1 -0
- package/build/hcm/read-state.d.ts +32 -0
- package/build/hcm/read-state.d.ts.map +1 -0
- package/build/hcm/read-state.js +65 -0
- package/build/hcm/read-state.js.map +1 -0
- package/build/hcm/runtime/bundle.d.ts +43 -0
- package/build/hcm/runtime/bundle.d.ts.map +1 -0
- package/build/hcm/runtime/bundle.js +49 -0
- package/build/hcm/runtime/bundle.js.map +1 -0
- package/build/hcm/runtime/contracts.d.ts +107 -0
- package/build/hcm/runtime/contracts.d.ts.map +1 -0
- package/build/hcm/runtime/contracts.js +98 -0
- package/build/hcm/runtime/contracts.js.map +1 -0
- package/build/hcm/runtime/runtime.d.ts +23 -0
- package/build/hcm/runtime/runtime.d.ts.map +1 -0
- package/build/hcm/runtime/runtime.js +130 -0
- package/build/hcm/runtime/runtime.js.map +1 -0
- package/build/hcm/schemas.d.ts +86 -0
- package/build/hcm/schemas.d.ts.map +1 -0
- package/build/hcm/schemas.js +90 -0
- package/build/hcm/schemas.js.map +1 -0
- package/build/hcm/search-contract.d.ts +50 -0
- package/build/hcm/search-contract.d.ts.map +1 -0
- package/build/hcm/search-contract.js +66 -0
- package/build/hcm/search-contract.js.map +1 -0
- package/build/hcm/types.d.ts +5 -0
- package/build/hcm/types.d.ts.map +1 -0
- package/build/hcm/types.js +2 -0
- package/build/hcm/types.js.map +1 -0
- package/build/hcm/xquery.d.ts +7 -0
- package/build/hcm/xquery.d.ts.map +1 -0
- package/build/hcm/xquery.js +8 -0
- package/build/hcm/xquery.js.map +1 -0
- package/build/index.d.ts +12 -1
- package/build/index.d.ts.map +1 -1
- package/build/index.js +6 -0
- package/build/index.js.map +1 -1
- package/build/soap-utils.d.ts +8 -14
- package/build/soap-utils.d.ts.map +1 -1
- package/build/soap-utils.js +205 -169
- package/build/soap-utils.js.map +1 -1
- package/build/types.d.ts +9 -0
- package/build/types.d.ts.map +1 -1
- package/build/xquery.d.ts +28 -0
- package/build/xquery.d.ts.map +1 -0
- package/build/xquery.js +151 -0
- package/build/xquery.js.map +1 -0
- package/package.json +9 -4
- package/resources/dotnet/bootstrap/BorisType.RuntimeBootstrap.B53a9ea0c1f41b578b4bb88a9389553a72996846f7a15fed29f0c3358e12525a0.deps.json +23 -0
- package/resources/dotnet/bootstrap/BorisType.RuntimeBootstrap.B53a9ea0c1f41b578b4bb88a9389553a72996846f7a15fed29f0c3358e12525a0.dll +0 -0
- package/resources/dotnet/component/BorisType.FileSystem.deps.json +23 -0
- package/resources/dotnet/component/BorisType.FileSystem.dll +0 -0
- package/resources/dotnet/manifest.json +43 -0
- package/resources/file-operation.bs +10 -0
- package/resources/object-operation.bs +102 -0
- package/resources/runtime-bootstrap.bs +27 -0
- package/resources/runtime-operation.bs +10 -0
- package/resources/search-files.bs +7 -0
- package/resources/xquery.bs +100 -0
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { buildScript } from "./load.js";
|
|
4
|
+
import { inspectObjectXml, objectXmlBytes } from "./object-xml.js";
|
|
5
|
+
import { ObjectReadState } from "./object-state.js";
|
|
6
|
+
import { wshcmSchemas } from "./schemas.js";
|
|
7
|
+
import { WshcmObjectError } from "./object-error.js";
|
|
8
|
+
const template = readFileSync(new URL("../../resources/object-operation.bs", import.meta.url), "utf8");
|
|
9
|
+
const { id: objectId } = wshcmSchemas.objects.get.shape;
|
|
10
|
+
const { formUrl } = wshcmSchemas.objects.getForm.shape;
|
|
11
|
+
const boundedXml = z
|
|
12
|
+
.string()
|
|
13
|
+
.max(objectXmlBytes)
|
|
14
|
+
.refine((xml) => xml.isWellFormed() && Buffer.byteLength(xml, "utf8") <= objectXmlBytes);
|
|
15
|
+
const readResponse = z.strictObject({
|
|
16
|
+
ok: z.literal(true),
|
|
17
|
+
id: objectId,
|
|
18
|
+
formUrl,
|
|
19
|
+
root: z.string().min(1).max(256),
|
|
20
|
+
xml: boundedXml,
|
|
21
|
+
schemaXml: boundedXml,
|
|
22
|
+
});
|
|
23
|
+
const formResponse = z.strictObject({ ok: z.literal(true), formUrl, root: z.string().min(1).max(256), xml: boundedXml });
|
|
24
|
+
const saveResponse = z.strictObject({
|
|
25
|
+
ok: z.literal(true),
|
|
26
|
+
id: objectId,
|
|
27
|
+
formUrl,
|
|
28
|
+
root: z.string().min(1).max(256),
|
|
29
|
+
xml: boundedXml,
|
|
30
|
+
writeStatus: z.literal("saved"),
|
|
31
|
+
});
|
|
32
|
+
const failure = z.strictObject({
|
|
33
|
+
ok: z.literal(false),
|
|
34
|
+
id: z.string().max(20),
|
|
35
|
+
phase: z.enum(["read", "validate", "load", "bind", "save", "readback"]),
|
|
36
|
+
writeStatus: z.enum(["not_attempted", "unknown", "saved"]),
|
|
37
|
+
// The carrier/envelope bounds diagnostics; truncate after parsing so a long
|
|
38
|
+
// message cannot discard a valid identity/phase/save acknowledgement.
|
|
39
|
+
error: z.strictObject({ code: z.string().max(100), message: z.string() }),
|
|
40
|
+
});
|
|
41
|
+
/** Call the native operation once, checking both string carriers before parsing its envelope. */
|
|
42
|
+
async function execute(evaluator, request) {
|
|
43
|
+
const json = JSON.stringify(request);
|
|
44
|
+
if (Buffer.byteLength(json, "utf8") > 2097152)
|
|
45
|
+
throw new Error("InputLimit: XML and validation metadata exceed the 2 MiB request budget");
|
|
46
|
+
const wire = await evaluator.eval(buildScript(template, { request: json }));
|
|
47
|
+
if (typeof wire !== "string" || Buffer.byteLength(wire, "utf8") > 4 * 1048576 * 6 + 2)
|
|
48
|
+
throw new Error("Invalid platform object response carrier");
|
|
49
|
+
const text = JSON.parse(wire);
|
|
50
|
+
if (typeof text !== "string" || Buffer.byteLength(text, "utf8") > 4 * 1048576)
|
|
51
|
+
throw new Error("Invalid platform object response size");
|
|
52
|
+
const result = JSON.parse(text);
|
|
53
|
+
const failed = failure.safeParse(result);
|
|
54
|
+
if (failed.success)
|
|
55
|
+
throw new WshcmObjectError({ ...failed.data, error: { ...failed.data.error, message: failed.data.error.message.slice(0, 2000) } });
|
|
56
|
+
return result;
|
|
57
|
+
}
|
|
58
|
+
/** Native XML operations; no evaluator initialization, disposal or managed file dependency. */
|
|
59
|
+
export class WshcmObjects {
|
|
60
|
+
evaluator;
|
|
61
|
+
reads = new ObjectReadState();
|
|
62
|
+
constructor(evaluator) {
|
|
63
|
+
this.evaluator = evaluator;
|
|
64
|
+
}
|
|
65
|
+
async getForm(input) {
|
|
66
|
+
const { formUrl } = wshcmSchemas.objects.getForm.parse(input);
|
|
67
|
+
return this.reads.run(async () => {
|
|
68
|
+
try {
|
|
69
|
+
const result = await execute(this.evaluator, { operation: "get_form", formUrl });
|
|
70
|
+
const { ok: _, ...body } = formResponse.parse(result);
|
|
71
|
+
return body;
|
|
72
|
+
}
|
|
73
|
+
catch (error) {
|
|
74
|
+
if (error instanceof WshcmObjectError)
|
|
75
|
+
throw error;
|
|
76
|
+
throw new WshcmObjectError({
|
|
77
|
+
error: { code: "ReadError", message: String(error).slice(0, 2000) },
|
|
78
|
+
phase: "read",
|
|
79
|
+
writeStatus: "not_attempted",
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
async get(input) {
|
|
85
|
+
const { id } = wshcmSchemas.objects.get.parse(input);
|
|
86
|
+
return this.reads.run(async () => {
|
|
87
|
+
try {
|
|
88
|
+
const result = await execute(this.evaluator, { operation: "get_object", id });
|
|
89
|
+
const { ok: _, schemaXml, ...body } = readResponse.parse(result);
|
|
90
|
+
if (body.id !== id)
|
|
91
|
+
throw new Error("Object response identity mismatch");
|
|
92
|
+
return { ...body, readToken: this.reads.record({ ...body, schemaXml }) };
|
|
93
|
+
}
|
|
94
|
+
catch (error) {
|
|
95
|
+
if (error instanceof WshcmObjectError)
|
|
96
|
+
throw error;
|
|
97
|
+
throw new WshcmObjectError({
|
|
98
|
+
error: { code: "ReadError", message: String(error).slice(0, 2000) },
|
|
99
|
+
id,
|
|
100
|
+
phase: "read",
|
|
101
|
+
writeStatus: "not_attempted",
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
});
|
|
105
|
+
}
|
|
106
|
+
async save(input) {
|
|
107
|
+
const args = wshcmSchemas.objects.save.parse(input);
|
|
108
|
+
return this.reads.run(async () => {
|
|
109
|
+
let phase = "input";
|
|
110
|
+
let writeStatus = "not_attempted";
|
|
111
|
+
let knownId = args.id;
|
|
112
|
+
try {
|
|
113
|
+
const expected = args.mode === "replace" ? this.reads.consume(args.id, args.readToken) : undefined;
|
|
114
|
+
const selectedForm = expected?.formUrl ?? args.formUrl;
|
|
115
|
+
const inspected = inspectObjectXml(args.xml, { formUrl: selectedForm, ...(args.id === undefined ? {} : { id: args.id }) });
|
|
116
|
+
const request = {
|
|
117
|
+
operation: "save_object",
|
|
118
|
+
mode: args.mode,
|
|
119
|
+
formUrl: selectedForm,
|
|
120
|
+
id: args.id ?? "",
|
|
121
|
+
xml: args.xml,
|
|
122
|
+
root: inspected.root,
|
|
123
|
+
nodes: inspected.nodes,
|
|
124
|
+
...(expected ? { expected: { xml: expected.xml, formUrl: expected.formUrl, schemaXml: expected.schemaXml } } : {}),
|
|
125
|
+
};
|
|
126
|
+
if (Buffer.byteLength(JSON.stringify(request), "utf8") > 2097152)
|
|
127
|
+
throw new Error("InputLimit: XML and validation metadata exceed 2 MiB");
|
|
128
|
+
phase = "transport";
|
|
129
|
+
writeStatus = "unknown";
|
|
130
|
+
const result = await execute(this.evaluator, request);
|
|
131
|
+
const acknowledgement = z.object({ ok: z.literal(true), id: objectId, writeStatus: z.literal("saved") }).safeParse(result);
|
|
132
|
+
if (acknowledgement.success) {
|
|
133
|
+
knownId = acknowledgement.data.id;
|
|
134
|
+
writeStatus = "saved";
|
|
135
|
+
phase = "readback";
|
|
136
|
+
}
|
|
137
|
+
const { ok: _, ...body } = saveResponse.parse(result);
|
|
138
|
+
if (args.mode === "replace" && body.id !== args.id)
|
|
139
|
+
throw new Error("Saved object response identity mismatch");
|
|
140
|
+
return body;
|
|
141
|
+
}
|
|
142
|
+
catch (error) {
|
|
143
|
+
if (error instanceof WshcmObjectError)
|
|
144
|
+
throw error;
|
|
145
|
+
throw new WshcmObjectError({
|
|
146
|
+
error: { code: phase === "input" ? "InvalidInput" : "TransportError", message: String(error).slice(0, 2000) },
|
|
147
|
+
...(knownId ? { id: knownId } : {}),
|
|
148
|
+
phase,
|
|
149
|
+
writeStatus,
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
//# sourceMappingURL=objects.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/hcm/objects.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { z } from "zod";
|
|
2
|
+
import type { readResponse } from "./file-contract.js";
|
|
3
|
+
/** Original-text UTF-16 interval, with an exclusive end. */
|
|
4
|
+
export interface ReadRange {
|
|
5
|
+
start: number;
|
|
6
|
+
end: number;
|
|
7
|
+
}
|
|
8
|
+
/** A bounded grant of ranges actually returned by read_file in this API instance. */
|
|
9
|
+
export interface ReadSnapshot {
|
|
10
|
+
token: string;
|
|
11
|
+
sha256: string;
|
|
12
|
+
totalLength: number;
|
|
13
|
+
ranges: ReadRange[];
|
|
14
|
+
readAt: number;
|
|
15
|
+
}
|
|
16
|
+
/** Per-API read grants; unrelated to a client's conversation lifecycle. */
|
|
17
|
+
export declare class ReadState {
|
|
18
|
+
private readonly now;
|
|
19
|
+
private readonly snapshots;
|
|
20
|
+
private tail;
|
|
21
|
+
constructor(now?: () => number);
|
|
22
|
+
/** Serialize reads and mutations so concurrent requests cannot consume one grant twice. */
|
|
23
|
+
run<T>(action: () => Promise<T>): Promise<T>;
|
|
24
|
+
/** Record the returned interval, merging only the same URL and original byte version. */
|
|
25
|
+
record(path: string, read: z.infer<typeof readResponse>, previousToken?: string): string;
|
|
26
|
+
/** Require a live grant for this exact URL, optionally checking a hash or full coverage. */
|
|
27
|
+
require(path: string, token: string, expectedSha256?: string, full?: boolean): ReadSnapshot;
|
|
28
|
+
/** Drop a URL grant after a mutation attempt, including an uncertain transport outcome. */
|
|
29
|
+
invalidate(path: string): void;
|
|
30
|
+
private prune;
|
|
31
|
+
}
|
|
32
|
+
//# sourceMappingURL=read-state.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"read-state.d.ts","sourceRoot":"","sources":["../../src/hcm/read-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AACD,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,qBAAa,SAAS;IAGR,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,IAAI,CAAuC;gBACtB,GAAG,GAAE,MAAM,MAAgC;IAExE,2FAA2F;IAC3F,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAM5C,yFAAyF;IACzF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IAwBxF,4FAA4F;IAC5F,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,YAAY;IAYzF,2FAA2F;IAC3F,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,KAAK;CAGd"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
/** Per-API read grants; unrelated to a client's conversation lifecycle. */
|
|
3
|
+
export class ReadState {
|
|
4
|
+
now;
|
|
5
|
+
snapshots = new Map();
|
|
6
|
+
tail = Promise.resolve();
|
|
7
|
+
constructor(now = () => performance.now()) {
|
|
8
|
+
this.now = now;
|
|
9
|
+
}
|
|
10
|
+
/** Serialize reads and mutations so concurrent requests cannot consume one grant twice. */
|
|
11
|
+
run(action) {
|
|
12
|
+
const result = this.tail.then(action);
|
|
13
|
+
this.tail = result.catch(() => { });
|
|
14
|
+
return result;
|
|
15
|
+
}
|
|
16
|
+
/** Record the returned interval, merging only the same URL and original byte version. */
|
|
17
|
+
record(path, read, previousToken) {
|
|
18
|
+
const now = this.now();
|
|
19
|
+
this.prune(now);
|
|
20
|
+
const previous = this.snapshots.get(path);
|
|
21
|
+
const same = previous !== undefined &&
|
|
22
|
+
previousToken === previous.token &&
|
|
23
|
+
previous.sha256 === read.sha256 &&
|
|
24
|
+
previous.totalLength === read.totalLength;
|
|
25
|
+
const sorted = [...(same ? previous.ranges : []), { start: read.startOffset, end: read.endOffset }].sort((a, b) => a.start - b.start);
|
|
26
|
+
const ranges = [];
|
|
27
|
+
for (const range of sorted) {
|
|
28
|
+
const last = ranges.at(-1);
|
|
29
|
+
if (last && range.start <= last.end)
|
|
30
|
+
last.end = Math.max(last.end, range.end);
|
|
31
|
+
else
|
|
32
|
+
ranges.push({ ...range });
|
|
33
|
+
}
|
|
34
|
+
if (ranges.length > 256)
|
|
35
|
+
throw new Error("ReadLimit: Read a wider contiguous range; at most 256 intervals are retained per file");
|
|
36
|
+
const snapshot = { token: randomUUID(), sha256: read.sha256, totalLength: read.totalLength, ranges, readAt: now };
|
|
37
|
+
this.snapshots.delete(path);
|
|
38
|
+
this.snapshots.set(path, snapshot);
|
|
39
|
+
while (this.snapshots.size > 128)
|
|
40
|
+
this.snapshots.delete(this.snapshots.keys().next().value);
|
|
41
|
+
return snapshot.token;
|
|
42
|
+
}
|
|
43
|
+
/** Require a live grant for this exact URL, optionally checking a hash or full coverage. */
|
|
44
|
+
require(path, token, expectedSha256, full = false) {
|
|
45
|
+
this.prune(this.now());
|
|
46
|
+
const snapshot = this.snapshots.get(path);
|
|
47
|
+
if (!snapshot || snapshot.token !== token)
|
|
48
|
+
throw new Error("ReadRequired: Read this file in this MCP instance before editing; the token is missing, expired or invalidated");
|
|
49
|
+
if (expectedSha256 !== undefined && expectedSha256.toLowerCase() !== snapshot.sha256)
|
|
50
|
+
throw new Error("Conflict: expectedSha256 does not match the read token");
|
|
51
|
+
if (full && !(snapshot.ranges.length === 1 && snapshot.ranges[0].start === 0 && snapshot.ranges[0].end === snapshot.totalLength))
|
|
52
|
+
throw new Error("ReadRequired: Read the entire file before overwriting it");
|
|
53
|
+
return snapshot;
|
|
54
|
+
}
|
|
55
|
+
/** Drop a URL grant after a mutation attempt, including an uncertain transport outcome. */
|
|
56
|
+
invalidate(path) {
|
|
57
|
+
this.snapshots.delete(path);
|
|
58
|
+
}
|
|
59
|
+
prune(now) {
|
|
60
|
+
for (const [path, snapshot] of this.snapshots)
|
|
61
|
+
if (now - snapshot.readAt >= 30 * 60 * 1000)
|
|
62
|
+
this.snapshots.delete(path);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=read-state.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"read-state.js","sourceRoot":"","sources":["../../src/hcm/read-state.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
export declare class BundleFailure extends Error {
|
|
2
|
+
readonly reason: string;
|
|
3
|
+
constructor(reason: string, message: string);
|
|
4
|
+
}
|
|
5
|
+
export declare function matchesArtifact(bytes: Buffer, expected: {
|
|
6
|
+
bytes: number;
|
|
7
|
+
sha256: string;
|
|
8
|
+
}): boolean;
|
|
9
|
+
/** Validate package bytes before exposing any payload to the remote process. */
|
|
10
|
+
export declare function loadBundle(directory: string): Promise<{
|
|
11
|
+
manifest: {
|
|
12
|
+
schemaVersion: 1;
|
|
13
|
+
bootstrap: {
|
|
14
|
+
id: string;
|
|
15
|
+
version: string;
|
|
16
|
+
apiVersion: number;
|
|
17
|
+
buildId: string;
|
|
18
|
+
targetFramework: "net9.0";
|
|
19
|
+
entryAssembly: string;
|
|
20
|
+
files: {
|
|
21
|
+
path: string;
|
|
22
|
+
bytes: number;
|
|
23
|
+
sha256: string;
|
|
24
|
+
}[];
|
|
25
|
+
};
|
|
26
|
+
component: {
|
|
27
|
+
id: string;
|
|
28
|
+
version: string;
|
|
29
|
+
apiVersion: number;
|
|
30
|
+
buildId: string;
|
|
31
|
+
targetFramework: "net9.0";
|
|
32
|
+
entryAssembly: string;
|
|
33
|
+
files: {
|
|
34
|
+
path: string;
|
|
35
|
+
bytes: number;
|
|
36
|
+
sha256: string;
|
|
37
|
+
}[];
|
|
38
|
+
};
|
|
39
|
+
};
|
|
40
|
+
bootstrapPayload: Record<string, string>;
|
|
41
|
+
componentPayload: Record<string, string>;
|
|
42
|
+
}>;
|
|
43
|
+
//# sourceMappingURL=bundle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/hcm/runtime/bundle.ts"],"names":[],"mappings":"AAKA,qBAAa,aAAc,SAAQ,KAAK;aAEpB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM;CAIlB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEnG;AAED,gFAAgF;AAChF,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BjD"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { readFile, stat } from "node:fs/promises";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { bundleManifestSchema } from "./contracts.js";
|
|
5
|
+
export class BundleFailure extends Error {
|
|
6
|
+
reason;
|
|
7
|
+
constructor(reason, message) {
|
|
8
|
+
super(message);
|
|
9
|
+
this.reason = reason;
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
export function matchesArtifact(bytes, expected) {
|
|
13
|
+
return bytes.length === expected.bytes && createHash("sha256").update(bytes).digest("hex") === expected.sha256;
|
|
14
|
+
}
|
|
15
|
+
/** Validate package bytes before exposing any payload to the remote process. */
|
|
16
|
+
export async function loadBundle(directory) {
|
|
17
|
+
let manifest;
|
|
18
|
+
try {
|
|
19
|
+
if ((await stat(join(directory, "manifest.json"))).size > 65536)
|
|
20
|
+
throw new Error("Manifest exceeds 64 KiB");
|
|
21
|
+
manifest = bundleManifestSchema.parse(JSON.parse(await readFile(join(directory, "manifest.json"), "utf8")));
|
|
22
|
+
}
|
|
23
|
+
catch (error) {
|
|
24
|
+
throw new BundleFailure("InvalidBundle", String(error));
|
|
25
|
+
}
|
|
26
|
+
async function payload(kind, component) {
|
|
27
|
+
const files = {};
|
|
28
|
+
for (const file of component.files) {
|
|
29
|
+
let bytes;
|
|
30
|
+
try {
|
|
31
|
+
const path = join(directory, kind, file.path);
|
|
32
|
+
if ((await stat(path)).size !== file.bytes)
|
|
33
|
+
throw new Error(`Size mismatch: ${kind}/${file.path}`);
|
|
34
|
+
bytes = await readFile(path);
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
throw new BundleFailure("ArtifactMismatch", String(error));
|
|
38
|
+
}
|
|
39
|
+
if (!matchesArtifact(bytes, file))
|
|
40
|
+
throw new BundleFailure("ArtifactMismatch", `Hash mismatch: ${kind}/${file.path}`);
|
|
41
|
+
files[file.path] = bytes.toString("base64");
|
|
42
|
+
}
|
|
43
|
+
return files;
|
|
44
|
+
}
|
|
45
|
+
const bootstrapPayload = await payload("bootstrap", manifest.bootstrap);
|
|
46
|
+
const componentPayload = await payload("component", manifest.component);
|
|
47
|
+
return { manifest, bootstrapPayload, componentPayload };
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=bundle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/hcm/runtime/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAmC,MAAM,gBAAgB,CAAC;AAEvF,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IADlB,YACkB,MAAc,EAC9B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;IAIhC,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,QAA2C;IACxF,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC;AACjH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC5G,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9G,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,SAAqC;QACxE,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAa,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnG,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,kBAAkB,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACtH,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxE,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AAC1D,CAAC"}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const buildIdentitySchema: z.ZodObject<{
|
|
3
|
+
id: z.ZodString;
|
|
4
|
+
version: z.ZodString;
|
|
5
|
+
apiVersion: z.ZodNumber;
|
|
6
|
+
buildId: z.ZodString;
|
|
7
|
+
}, z.core.$strict>;
|
|
8
|
+
export type RuntimeBuildIdentity = z.infer<typeof buildIdentitySchema>;
|
|
9
|
+
export declare const componentDescriptorSchema: z.ZodObject<{
|
|
10
|
+
id: z.ZodString;
|
|
11
|
+
version: z.ZodString;
|
|
12
|
+
apiVersion: z.ZodNumber;
|
|
13
|
+
buildId: z.ZodString;
|
|
14
|
+
targetFramework: z.ZodLiteral<"net9.0">;
|
|
15
|
+
entryAssembly: z.ZodString;
|
|
16
|
+
files: z.ZodArray<z.ZodObject<{
|
|
17
|
+
path: z.ZodString;
|
|
18
|
+
bytes: z.ZodNumber;
|
|
19
|
+
sha256: z.ZodString;
|
|
20
|
+
}, z.core.$strict>>;
|
|
21
|
+
}, z.core.$strict>;
|
|
22
|
+
export type RuntimeComponentDescriptor = z.infer<typeof componentDescriptorSchema>;
|
|
23
|
+
export declare const bundleManifestSchema: z.ZodObject<{
|
|
24
|
+
schemaVersion: z.ZodLiteral<1>;
|
|
25
|
+
bootstrap: z.ZodObject<{
|
|
26
|
+
id: z.ZodString;
|
|
27
|
+
version: z.ZodString;
|
|
28
|
+
apiVersion: z.ZodNumber;
|
|
29
|
+
buildId: z.ZodString;
|
|
30
|
+
targetFramework: z.ZodLiteral<"net9.0">;
|
|
31
|
+
entryAssembly: z.ZodString;
|
|
32
|
+
files: z.ZodArray<z.ZodObject<{
|
|
33
|
+
path: z.ZodString;
|
|
34
|
+
bytes: z.ZodNumber;
|
|
35
|
+
sha256: z.ZodString;
|
|
36
|
+
}, z.core.$strict>>;
|
|
37
|
+
}, z.core.$strict>;
|
|
38
|
+
component: z.ZodObject<{
|
|
39
|
+
id: z.ZodString;
|
|
40
|
+
version: z.ZodString;
|
|
41
|
+
apiVersion: z.ZodNumber;
|
|
42
|
+
buildId: z.ZodString;
|
|
43
|
+
targetFramework: z.ZodLiteral<"net9.0">;
|
|
44
|
+
entryAssembly: z.ZodString;
|
|
45
|
+
files: z.ZodArray<z.ZodObject<{
|
|
46
|
+
path: z.ZodString;
|
|
47
|
+
bytes: z.ZodNumber;
|
|
48
|
+
sha256: z.ZodString;
|
|
49
|
+
}, z.core.$strict>>;
|
|
50
|
+
}, z.core.$strict>;
|
|
51
|
+
}, z.core.$strict>;
|
|
52
|
+
declare const processSchema: z.ZodObject<{
|
|
53
|
+
pid: z.ZodNumber;
|
|
54
|
+
startedAt: z.ZodString;
|
|
55
|
+
framework: z.ZodString;
|
|
56
|
+
architecture: z.ZodString;
|
|
57
|
+
}, z.core.$strict>;
|
|
58
|
+
export declare const runtimeStatusSchema: z.ZodObject<{
|
|
59
|
+
schemaVersion: z.ZodLiteral<1>;
|
|
60
|
+
status: z.ZodEnum<{
|
|
61
|
+
blocked: "blocked";
|
|
62
|
+
ready: "ready";
|
|
63
|
+
installed: "installed";
|
|
64
|
+
restart_required: "restart_required";
|
|
65
|
+
missing: "missing";
|
|
66
|
+
}>;
|
|
67
|
+
reason: z.ZodString;
|
|
68
|
+
expected: z.ZodNullable<z.ZodObject<{
|
|
69
|
+
id: z.ZodString;
|
|
70
|
+
version: z.ZodString;
|
|
71
|
+
apiVersion: z.ZodNumber;
|
|
72
|
+
buildId: z.ZodString;
|
|
73
|
+
}, z.core.$strict>>;
|
|
74
|
+
installed: z.ZodNullable<z.ZodObject<{
|
|
75
|
+
id: z.ZodString;
|
|
76
|
+
version: z.ZodString;
|
|
77
|
+
apiVersion: z.ZodNumber;
|
|
78
|
+
buildId: z.ZodString;
|
|
79
|
+
}, z.core.$strict>>;
|
|
80
|
+
loaded: z.ZodNullable<z.ZodObject<{
|
|
81
|
+
id: z.ZodString;
|
|
82
|
+
buildId: z.ZodString;
|
|
83
|
+
apiVersion: z.ZodNumber;
|
|
84
|
+
version: z.ZodString;
|
|
85
|
+
}, z.core.$strict>>;
|
|
86
|
+
changed: z.ZodBoolean;
|
|
87
|
+
process: z.ZodObject<{
|
|
88
|
+
pid: z.ZodNumber;
|
|
89
|
+
startedAt: z.ZodString;
|
|
90
|
+
framework: z.ZodString;
|
|
91
|
+
architecture: z.ZodString;
|
|
92
|
+
}, z.core.$strict>;
|
|
93
|
+
}, z.core.$strict>;
|
|
94
|
+
/** A helper status identifies the answering process. Local/transport failures have process:null. */
|
|
95
|
+
export type RuntimeStatus = Omit<z.infer<typeof runtimeStatusSchema>, "process"> & {
|
|
96
|
+
process: z.infer<typeof processSchema> | null;
|
|
97
|
+
};
|
|
98
|
+
/** A dependent operation cannot run safely; status keeps installed and loaded identity distinct. */
|
|
99
|
+
export declare class WshcmRuntimeError extends Error {
|
|
100
|
+
readonly status: RuntimeStatus;
|
|
101
|
+
constructor(status: RuntimeStatus, detail?: string);
|
|
102
|
+
}
|
|
103
|
+
export declare function identity(value: RuntimeComponentDescriptor): RuntimeBuildIdentity;
|
|
104
|
+
/** Compare the bounded semantic version syntax accepted by the managed installer. */
|
|
105
|
+
export declare function compareVersions(left: string, right: string): number;
|
|
106
|
+
export {};
|
|
107
|
+
//# sourceMappingURL=contracts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/hcm/runtime/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;kBAS9B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAOvE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;kBAYnC,CAAC;AACJ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACnF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAI/B,CAAC;AAEH,QAAA,MAAM,aAAa;;;;;kBAKjB,CAAC;AAOH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAS9B,CAAC;AACH,oGAAoG;AACpG,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,EAAE,SAAS,CAAC,GAAG;IACjF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,oGAAoG;AACpG,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,MAAM,EAAE,aAAa;gBAArB,MAAM,EAAE,aAAa,EACrC,MAAM,CAAC,EAAE,MAAM;CAKlB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,0BAA0B,GAAG,oBAAoB,CAGhF;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA2BnE"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export const buildIdentitySchema = z.strictObject({
|
|
3
|
+
id: z.string().regex(/^BorisType\.[A-Za-z0-9.]{1,120}$/),
|
|
4
|
+
version: z.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/),
|
|
5
|
+
apiVersion: z.number().int().min(1).max(64),
|
|
6
|
+
// A PE MVID is a .NET GUID; UUID variant/version bits are not an identity requirement.
|
|
7
|
+
buildId: z
|
|
8
|
+
.string()
|
|
9
|
+
.regex(/^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$/)
|
|
10
|
+
.refine((id) => id !== "00000000-0000-0000-0000-000000000000"),
|
|
11
|
+
});
|
|
12
|
+
const artifactSchema = z.strictObject({
|
|
13
|
+
path: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9_.-]{0,180}$/),
|
|
14
|
+
bytes: z.number().int().min(1).max(4194304),
|
|
15
|
+
sha256: z.string().regex(/^[a-f0-9]{64}$/),
|
|
16
|
+
});
|
|
17
|
+
export const componentDescriptorSchema = buildIdentitySchema
|
|
18
|
+
.extend({
|
|
19
|
+
targetFramework: z.literal("net9.0"),
|
|
20
|
+
entryAssembly: z.string(),
|
|
21
|
+
files: z.array(artifactSchema).min(1).max(16),
|
|
22
|
+
})
|
|
23
|
+
.refine((value) => value.entryAssembly === `${value.id}.dll` &&
|
|
24
|
+
value.files.some((file) => file.path === value.entryAssembly) &&
|
|
25
|
+
new Set(value.files.map((file) => file.path.toLowerCase())).size === value.files.length &&
|
|
26
|
+
value.files.reduce((total, file) => total + file.bytes, 0) <= 8388608);
|
|
27
|
+
export const bundleManifestSchema = z.strictObject({
|
|
28
|
+
schemaVersion: z.literal(1),
|
|
29
|
+
bootstrap: componentDescriptorSchema.refine((value) => /^BorisType\.RuntimeBootstrap\.B[a-fA-F0-9]{64}$/.test(value.id)),
|
|
30
|
+
component: componentDescriptorSchema,
|
|
31
|
+
});
|
|
32
|
+
const processSchema = z.strictObject({
|
|
33
|
+
pid: z.number().int().positive(),
|
|
34
|
+
startedAt: z.string().datetime({ offset: true }),
|
|
35
|
+
framework: z.string().min(1).max(256),
|
|
36
|
+
architecture: z.string().min(1).max(64),
|
|
37
|
+
});
|
|
38
|
+
// Foreign loaded assemblies may lack API metadata or expose AssemblyVersion instead of package SemVer.
|
|
39
|
+
// Preserve their actual diagnostics; readiness separately requires the requested API and build.
|
|
40
|
+
const loadedIdentitySchema = buildIdentitySchema.extend({
|
|
41
|
+
apiVersion: z.number().int().min(0).max(2147483647),
|
|
42
|
+
version: z.string().min(1).max(256),
|
|
43
|
+
});
|
|
44
|
+
export const runtimeStatusSchema = z.strictObject({
|
|
45
|
+
schemaVersion: z.literal(1),
|
|
46
|
+
status: z.enum(["ready", "restart_required", "blocked", "missing", "installed"]),
|
|
47
|
+
reason: z.string().min(1).max(256),
|
|
48
|
+
expected: buildIdentitySchema.nullable(),
|
|
49
|
+
installed: buildIdentitySchema.nullable(),
|
|
50
|
+
loaded: loadedIdentitySchema.nullable(),
|
|
51
|
+
changed: z.boolean(),
|
|
52
|
+
process: processSchema,
|
|
53
|
+
});
|
|
54
|
+
/** A dependent operation cannot run safely; status keeps installed and loaded identity distinct. */
|
|
55
|
+
export class WshcmRuntimeError extends Error {
|
|
56
|
+
status;
|
|
57
|
+
constructor(status, detail) {
|
|
58
|
+
super(`WSHCM runtime ${status.status}: ${status.reason}${detail ? ` (${detail.slice(0, 2000)})` : ""}`);
|
|
59
|
+
this.status = status;
|
|
60
|
+
this.name = "WshcmRuntimeError";
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
export function identity(value) {
|
|
64
|
+
const { id, version, apiVersion, buildId } = value;
|
|
65
|
+
return { id, version, apiVersion, buildId };
|
|
66
|
+
}
|
|
67
|
+
/** Compare the bounded semantic version syntax accepted by the managed installer. */
|
|
68
|
+
export function compareVersions(left, right) {
|
|
69
|
+
const split = (version) => {
|
|
70
|
+
const hyphen = version.indexOf("-");
|
|
71
|
+
return hyphen === -1 ? [version, undefined] : [version.slice(0, hyphen), version.slice(hyphen + 1)];
|
|
72
|
+
};
|
|
73
|
+
const [leftCore, leftPre] = split(left);
|
|
74
|
+
const [rightCore, rightPre] = split(right);
|
|
75
|
+
const a = leftCore.split(".").map(BigInt), b = rightCore.split(".").map(BigInt);
|
|
76
|
+
for (let i = 0; i < 3; i++)
|
|
77
|
+
if (a[i] !== b[i])
|
|
78
|
+
return a[i] > b[i] ? 1 : -1;
|
|
79
|
+
if (leftPre === undefined || rightPre === undefined)
|
|
80
|
+
return leftPre === rightPre ? 0 : leftPre === undefined ? 1 : -1;
|
|
81
|
+
const ap = leftPre.split("."), bp = rightPre.split(".");
|
|
82
|
+
for (let i = 0; i < Math.min(ap.length, bp.length); i++) {
|
|
83
|
+
if (ap[i] === bp[i])
|
|
84
|
+
continue;
|
|
85
|
+
const an = /^\d+$/.test(ap[i]), bn = /^\d+$/.test(bp[i]);
|
|
86
|
+
if (an && bn) {
|
|
87
|
+
const leftNumber = BigInt(ap[i]), rightNumber = BigInt(bp[i]);
|
|
88
|
+
if (leftNumber === rightNumber)
|
|
89
|
+
continue;
|
|
90
|
+
return leftNumber > rightNumber ? 1 : -1;
|
|
91
|
+
}
|
|
92
|
+
if (an !== bn)
|
|
93
|
+
return an ? -1 : 1;
|
|
94
|
+
return ap[i] > bp[i] ? 1 : -1;
|
|
95
|
+
}
|
|
96
|
+
return ap.length === bp.length ? 0 : ap.length > bp.length ? 1 : -1;
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=contracts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/hcm/runtime/contracts.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { WshcmEvaluator } from "../types.js";
|
|
2
|
+
import { type RuntimeStatus } from "./contracts.js";
|
|
3
|
+
export interface WshcmRuntimeOptions {
|
|
4
|
+
/** Directory containing manifest.json and bootstrap/component subdirectories. Defaults to packaged artifacts. */
|
|
5
|
+
bundleDirectory?: string;
|
|
6
|
+
/** A directory name under AppDirectoryPath()/dotnetcore/shared; native/runtimes/refs are reserved. */
|
|
7
|
+
installationName?: string;
|
|
8
|
+
}
|
|
9
|
+
/** Automatically installs packaged dependencies and reports actual loaded code in the answering process. */
|
|
10
|
+
export declare class WshcmRuntime {
|
|
11
|
+
private readonly evaluator;
|
|
12
|
+
private pending;
|
|
13
|
+
private verifiedBootstrap;
|
|
14
|
+
private inspectNext;
|
|
15
|
+
private readonly directory;
|
|
16
|
+
private readonly installationName;
|
|
17
|
+
constructor(evaluator: WshcmEvaluator, options?: WshcmRuntimeOptions);
|
|
18
|
+
/** Coalesce concurrent preparations, then recheck the answering process on every later call. */
|
|
19
|
+
ensure(): Promise<RuntimeStatus>;
|
|
20
|
+
requireReady(): Promise<RuntimeStatus>;
|
|
21
|
+
private prepare;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=runtime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/hcm/runtime/runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,mBAAmB;IAClC,iHAAiH;IACjH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAgBD,4GAA4G;AAC5G,qBAAa,YAAY;IAQrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAGvB,SAAS,EAAE,cAAc,EAC1C,OAAO,GAAE,mBAAwB;IAMnC,gGAAgG;IAChG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAS1B,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;YAM9B,OAAO;CAyFtB"}
|