@boristype/ws-client 0.1.0-alpha.3 → 0.1.0-alpha.5
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 +71 -13
- package/build/hcm/api.d.ts +17 -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 +6 -0
- package/build/hcm/xquery.d.ts.map +1 -0
- package/build/hcm/xquery.js +33 -0
- package/build/hcm/xquery.js.map +1 -0
- package/build/index.d.ts +9 -0
- package/build/index.d.ts.map +1 -1
- package/build/index.js +5 -0
- package/build/index.js.map +1 -1
- package/package.json +6 -3
- 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 +30 -0
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { buildScript } from "./load.js";
|
|
3
|
+
import { fileError, MAX_FILE_JSON_BYTES } from "./file-contract.js";
|
|
4
|
+
const template = readFileSync(new URL("../../resources/file-operation.bs", import.meta.url), "utf8");
|
|
5
|
+
/** Call the unique managed ABI method after BS resolves the URL; validate both carrier stages and result. */
|
|
6
|
+
export async function callManagedFile(evaluator, method, path, options, schema) {
|
|
7
|
+
const request = JSON.stringify(options);
|
|
8
|
+
if (Buffer.byteLength(request, "utf8") > MAX_FILE_JSON_BYTES)
|
|
9
|
+
throw new Error("Request JSON exceeds 8 MiB");
|
|
10
|
+
const destination = method === "MoveJson" && "destination" in options && typeof options.destination === "string" ? options.destination : "";
|
|
11
|
+
const wire = await evaluator.eval(buildScript(template, { path, request, method, destination }));
|
|
12
|
+
if (typeof wire !== "string")
|
|
13
|
+
throw new Error("Expected a string file operation carrier from WSHCM");
|
|
14
|
+
if (wire.length > 2 * MAX_FILE_JSON_BYTES + 2)
|
|
15
|
+
throw new Error("File operation carrier exceeds its limit");
|
|
16
|
+
const json = JSON.parse(wire);
|
|
17
|
+
if (typeof json !== "string")
|
|
18
|
+
throw new Error("Expected a string DLL response inside the file operation carrier");
|
|
19
|
+
if (Buffer.byteLength(json, "utf8") > MAX_FILE_JSON_BYTES)
|
|
20
|
+
throw new Error("Response JSON exceeds 8 MiB");
|
|
21
|
+
const body = JSON.parse(json);
|
|
22
|
+
const failure = fileError.safeParse(body);
|
|
23
|
+
if (failure.success) {
|
|
24
|
+
const { code, message, editIndex } = failure.data.error;
|
|
25
|
+
throw new Error(`${editIndex === undefined ? "" : `Edit #${editIndex}: `}${code}: ${message}`);
|
|
26
|
+
}
|
|
27
|
+
return schema.parse(body);
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=managed-files.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"managed-files.js","sourceRoot":"","sources":["../../src/hcm/managed-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC,mCAAmC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AAGrG,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAyB,EACzB,MAAkB,EAClB,IAAY,EACZ,OAAe,EACf,MAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,mBAAmB;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC5G,MAAM,WAAW,GACf,MAAM,KAAK,UAAU,IAAI,aAAa,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1H,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IACjG,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,mBAAmB,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAClH,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,mBAAmB;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC1G,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,SAAS,IAAI,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Structured native/local diagnostics preserve the known mutation outcome and identity. */
|
|
2
|
+
export interface WshcmObjectErrorDetails {
|
|
3
|
+
ok?: false;
|
|
4
|
+
id?: string;
|
|
5
|
+
phase: "input" | "transport" | "read" | "validate" | "load" | "bind" | "save" | "readback";
|
|
6
|
+
writeStatus: "not_attempted" | "unknown" | "saved";
|
|
7
|
+
error: {
|
|
8
|
+
code: string;
|
|
9
|
+
message: string;
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
export declare class WshcmObjectError extends Error {
|
|
13
|
+
readonly details: WshcmObjectErrorDetails;
|
|
14
|
+
constructor(details: WshcmObjectErrorDetails);
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=object-error.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"object-error.d.ts","sourceRoot":"","sources":["../../src/hcm/object-error.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,WAAW,uBAAuB;IACtC,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3F,WAAW,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;IACnD,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aACb,OAAO,EAAE,uBAAuB;gBAAhC,OAAO,EAAE,uBAAuB;CAI7D"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"object-error.js","sourceRoot":"","sources":["../../src/hcm/object-error.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACb;IAA5B,YAA4B,OAAgC;QAC1D,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAD/B,YAAO,GAAP,OAAO,CAAyB;QAE1D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/** Full object/schema snapshot returned to a client, scoped to one API instance. */
|
|
2
|
+
export interface ObjectSnapshot {
|
|
3
|
+
id: string;
|
|
4
|
+
formUrl: string;
|
|
5
|
+
xml: string;
|
|
6
|
+
schemaXml: string;
|
|
7
|
+
token: string;
|
|
8
|
+
readAt: number;
|
|
9
|
+
}
|
|
10
|
+
/** Bounded full-read grants, with local serialization but no external atomic CAS guarantee. */
|
|
11
|
+
export declare class ObjectReadState {
|
|
12
|
+
private readonly now;
|
|
13
|
+
private readonly snapshots;
|
|
14
|
+
private tail;
|
|
15
|
+
constructor(now?: () => number);
|
|
16
|
+
/** Serialize local object operations so a grant cannot be consumed concurrently. */
|
|
17
|
+
run<T>(action: () => Promise<T>): Promise<T>;
|
|
18
|
+
/** Record only a complete, validated response. A new read invalidates the old token. */
|
|
19
|
+
record(read: Omit<ObjectSnapshot, "token" | "readAt">): string;
|
|
20
|
+
/** Require and consume an exact-ID grant, including for a rejected/uncertain replace attempt. */
|
|
21
|
+
consume(id: string, token: string): ObjectSnapshot;
|
|
22
|
+
private prune;
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=object-state.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"object-state.d.ts","sourceRoot":"","sources":["../../src/hcm/object-state.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+FAA+F;AAC/F,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,IAAI,CAAuC;gBACtB,GAAG,GAAE,MAAM,MAAgC;IAExE,oFAAoF;IACpF,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAM5C,wFAAwF;IACxF,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,CAAC,GAAG,MAAM;IAS9D,iGAAiG;IACjG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;IAQlD,OAAO,CAAC,KAAK;CAGd"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
/** Bounded full-read grants, with local serialization but no external atomic CAS guarantee. */
|
|
3
|
+
export class ObjectReadState {
|
|
4
|
+
now;
|
|
5
|
+
snapshots = new Map();
|
|
6
|
+
tail = Promise.resolve();
|
|
7
|
+
constructor(now = () => performance.now()) {
|
|
8
|
+
this.now = now;
|
|
9
|
+
}
|
|
10
|
+
/** Serialize local object operations so a grant cannot be consumed concurrently. */
|
|
11
|
+
run(action) {
|
|
12
|
+
const result = this.tail.then(action);
|
|
13
|
+
this.tail = result.catch(() => { });
|
|
14
|
+
return result;
|
|
15
|
+
}
|
|
16
|
+
/** Record only a complete, validated response. A new read invalidates the old token. */
|
|
17
|
+
record(read) {
|
|
18
|
+
this.prune();
|
|
19
|
+
const snapshot = { ...read, token: randomUUID(), readAt: this.now() };
|
|
20
|
+
this.snapshots.delete(read.id);
|
|
21
|
+
this.snapshots.set(read.id, snapshot);
|
|
22
|
+
while (this.snapshots.size > 32)
|
|
23
|
+
this.snapshots.delete(this.snapshots.keys().next().value);
|
|
24
|
+
return snapshot.token;
|
|
25
|
+
}
|
|
26
|
+
/** Require and consume an exact-ID grant, including for a rejected/uncertain replace attempt. */
|
|
27
|
+
consume(id, token) {
|
|
28
|
+
this.prune();
|
|
29
|
+
const snapshot = this.snapshots.get(id);
|
|
30
|
+
if (!snapshot || snapshot.token !== token)
|
|
31
|
+
throw new Error("ReadRequired: Read the full object in this MCP instance before replace");
|
|
32
|
+
this.snapshots.delete(id);
|
|
33
|
+
return snapshot;
|
|
34
|
+
}
|
|
35
|
+
prune() {
|
|
36
|
+
for (const [id, snapshot] of this.snapshots)
|
|
37
|
+
if (this.now() - snapshot.readAt >= 30 * 60 * 1000)
|
|
38
|
+
this.snapshots.delete(id);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=object-state.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"object-state.js","sourceRoot":"","sources":["../../src/hcm/object-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC,+FAA+F;AAC/F,MAAM,OAAO,eAAe;IAGG;IAFZ,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IACvD,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IACnD,YAA6B,MAAoB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAA3C,QAAG,GAAH,GAAG,CAAwC;IAAG,CAAC;IAE5E,oFAAoF;IACpF,GAAG,CAAI,MAAwB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,IAA8C;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACtE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,EAAE;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;QAC5F,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,iGAAiG;IACjG,OAAO,CAAC,EAAU,EAAE,KAAa;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QACrI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK;QACX,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7H,CAAC;CACF"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/** Bounded input metadata used only to check native XmlForm paths; never reserialized as data. */
|
|
2
|
+
export interface ObjectXmlNode {
|
|
3
|
+
path: string[];
|
|
4
|
+
count: number;
|
|
5
|
+
hasElements: boolean;
|
|
6
|
+
hasText: boolean;
|
|
7
|
+
text: string;
|
|
8
|
+
integerValid: boolean;
|
|
9
|
+
}
|
|
10
|
+
/** XML transport bounds; an oversized document is rejected in full. */
|
|
11
|
+
export declare const objectXmlBytes = 262144;
|
|
12
|
+
/** Validate strict XML 1.0 and identity; collect only bounded native validation metadata. */
|
|
13
|
+
export declare function inspectObjectXml(xml: string, identity: {
|
|
14
|
+
formUrl: string;
|
|
15
|
+
id?: string;
|
|
16
|
+
}): {
|
|
17
|
+
root: string;
|
|
18
|
+
id?: string;
|
|
19
|
+
nodes: ObjectXmlNode[];
|
|
20
|
+
};
|
|
21
|
+
//# sourceMappingURL=object-xml.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"object-xml.d.ts","sourceRoot":"","sources":["../../src/hcm/object-xml.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,uEAAuE;AACvE,eAAO,MAAM,cAAc,SAAS,CAAC;AAYrC,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAgEvD"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { SaxesParser } from "saxes";
|
|
2
|
+
/** XML transport bounds; an oversized document is rejected in full. */
|
|
3
|
+
export const objectXmlBytes = 262144;
|
|
4
|
+
/** Recognize native decimal/hex integer values without passing through Number. */
|
|
5
|
+
function integerValue(text) {
|
|
6
|
+
const value = text.replace(/^[\x20\t\r\n]+|[\x20\t\r\n]+$/g, "");
|
|
7
|
+
if (!/^(?:[+-]?\d+|0[xX][\da-fA-F]+)$/.test(value))
|
|
8
|
+
return undefined;
|
|
9
|
+
const normalized = value.replace(/^([+-]?)0+(?=\d)/, "$1").replace(/^(0[xX])0+(?=[\da-fA-F])/, "$1");
|
|
10
|
+
if (normalized.length > 21)
|
|
11
|
+
return undefined;
|
|
12
|
+
const integer = BigInt(normalized);
|
|
13
|
+
return integer >= -9223372036854775808n && integer <= 18446744073709551615n ? integer : undefined;
|
|
14
|
+
}
|
|
15
|
+
/** Validate strict XML 1.0 and identity; collect only bounded native validation metadata. */
|
|
16
|
+
export function inspectObjectXml(xml, identity) {
|
|
17
|
+
if (!xml.trim() || Buffer.byteLength(xml, "utf8") > objectXmlBytes)
|
|
18
|
+
throw new Error("XML size limit: provide 1–256 KiB of XML");
|
|
19
|
+
if (!xml.isWellFormed())
|
|
20
|
+
throw new Error("Invalid XML character");
|
|
21
|
+
const nodes = [];
|
|
22
|
+
const stack = [];
|
|
23
|
+
let root = "";
|
|
24
|
+
let id;
|
|
25
|
+
const parser = new SaxesParser({ xmlns: false, defaultXMLVersion: "1.0" });
|
|
26
|
+
parser.on("error", (error) => {
|
|
27
|
+
throw new Error(`Invalid XML: ${error.message}`);
|
|
28
|
+
});
|
|
29
|
+
parser.on("doctype", () => {
|
|
30
|
+
throw new Error("XML DTD/entity definitions are not supported");
|
|
31
|
+
});
|
|
32
|
+
parser.on("processinginstruction", () => {
|
|
33
|
+
throw new Error("XML processing instructions are not supported");
|
|
34
|
+
});
|
|
35
|
+
parser.on("xmldecl", (declaration) => {
|
|
36
|
+
if (declaration.version !== "1.0")
|
|
37
|
+
throw new Error("Only XML 1.0 is supported");
|
|
38
|
+
});
|
|
39
|
+
parser.on("opentag", (tag) => {
|
|
40
|
+
if (nodes.length >= 8192)
|
|
41
|
+
throw new Error("XML element limit: at most 8192 elements");
|
|
42
|
+
if (stack.length >= 64)
|
|
43
|
+
throw new Error("XML depth limit: at most 64 levels");
|
|
44
|
+
const parent = stack.at(-1);
|
|
45
|
+
if (!parent)
|
|
46
|
+
root = tag.name;
|
|
47
|
+
const path = parent ? [...parent.node.path, tag.name] : [];
|
|
48
|
+
for (const [name, value] of Object.entries(tag.attributes)) {
|
|
49
|
+
if (parent || name !== "SPXML-FORM")
|
|
50
|
+
throw new Error(`Unsupported XML attribute ${name}`);
|
|
51
|
+
if (value !== identity.formUrl)
|
|
52
|
+
throw new Error("XML form attribute does not match selected form");
|
|
53
|
+
}
|
|
54
|
+
const node = { path, count: 1, hasElements: false, hasText: false, text: "", integerValid: true };
|
|
55
|
+
nodes.push(node);
|
|
56
|
+
if (parent) {
|
|
57
|
+
parent.node.hasElements = true;
|
|
58
|
+
const siblings = parent.children.get(tag.name) ?? [];
|
|
59
|
+
siblings.push(node);
|
|
60
|
+
parent.children.set(tag.name, siblings);
|
|
61
|
+
}
|
|
62
|
+
stack.push({ node, children: new Map() });
|
|
63
|
+
});
|
|
64
|
+
const appendText = (text) => {
|
|
65
|
+
const frame = stack.at(-1);
|
|
66
|
+
if (frame)
|
|
67
|
+
frame.node.text += text;
|
|
68
|
+
else if (/[^\x20\t\r\n]/.test(text))
|
|
69
|
+
throw new Error("Invalid XML text outside root");
|
|
70
|
+
};
|
|
71
|
+
parser.on("text", appendText);
|
|
72
|
+
parser.on("cdata", (text) => {
|
|
73
|
+
if (!stack.length)
|
|
74
|
+
throw new Error("Invalid XML CDATA outside root");
|
|
75
|
+
appendText(text);
|
|
76
|
+
});
|
|
77
|
+
parser.on("closetag", () => {
|
|
78
|
+
const { node, children } = stack.pop();
|
|
79
|
+
node.hasText = /[^\x20\t\r\n]/.test(node.text);
|
|
80
|
+
node.integerValid = !node.hasText || integerValue(node.text) !== undefined;
|
|
81
|
+
for (const siblings of children.values())
|
|
82
|
+
for (const sibling of siblings)
|
|
83
|
+
sibling.count = siblings.length;
|
|
84
|
+
if (node.path.length === 1 && node.path[0] === "id") {
|
|
85
|
+
if (id !== undefined || node.hasElements || identity.id === undefined || integerValue(node.text)?.toString() !== identity.id)
|
|
86
|
+
throw new Error("XML ID must match replace identity; create must omit ID");
|
|
87
|
+
id = identity.id;
|
|
88
|
+
}
|
|
89
|
+
});
|
|
90
|
+
parser.write(xml).close();
|
|
91
|
+
if (!root || stack.length)
|
|
92
|
+
throw new Error("XML must contain exactly one complete root");
|
|
93
|
+
return { root, ...(id === undefined ? {} : { id }), nodes };
|
|
94
|
+
}
|
|
95
|
+
//# sourceMappingURL=object-xml.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"object-xml.js","sourceRoot":"","sources":["../../src/hcm/object-xml.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { WshcmEvaluator } from "./types.js";
|
|
3
|
+
import { wshcmSchemas } from "./schemas.js";
|
|
4
|
+
type Input<K extends keyof typeof wshcmSchemas.objects> = z.input<(typeof wshcmSchemas.objects)[K]>;
|
|
5
|
+
/** Native XML operations; no evaluator initialization, disposal or managed file dependency. */
|
|
6
|
+
export declare class WshcmObjects {
|
|
7
|
+
private readonly evaluator;
|
|
8
|
+
private readonly reads;
|
|
9
|
+
constructor(evaluator: WshcmEvaluator);
|
|
10
|
+
getForm(input: Input<"getForm">): Promise<{
|
|
11
|
+
formUrl: string;
|
|
12
|
+
root: string;
|
|
13
|
+
xml: string;
|
|
14
|
+
}>;
|
|
15
|
+
get(input: Input<"get">): Promise<{
|
|
16
|
+
readToken: string;
|
|
17
|
+
id: string;
|
|
18
|
+
formUrl: string;
|
|
19
|
+
root: string;
|
|
20
|
+
xml: string;
|
|
21
|
+
}>;
|
|
22
|
+
save(input: Input<"save">): Promise<{
|
|
23
|
+
id: string;
|
|
24
|
+
formUrl: string;
|
|
25
|
+
root: string;
|
|
26
|
+
xml: string;
|
|
27
|
+
writeStatus: "saved";
|
|
28
|
+
}>;
|
|
29
|
+
}
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=objects.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/hcm/objects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAoD5C,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,OAAO,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpG,+FAA+F;AAC/F,qBAAa,YAAY;IAEX,OAAO,CAAC,QAAQ,CAAC,SAAS;IADtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;gBAClB,SAAS,EAAE,cAAc;IAEhD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;;;;;IAkB/B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;;;;;;;IAoBvB,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;;;;;;;CA6ChC"}
|
|
@@ -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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC,qCAAqC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACvG,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;AACxD,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;AACvD,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,cAAc,CAAC;KACnB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,cAAc,CAAC,CAAC;AAC3F,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,EAAE,EAAE,QAAQ;IACZ,OAAO;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,GAAG,EAAE,UAAU;IACf,SAAS,EAAE,UAAU;CACtB,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;AACzH,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,EAAE,EAAE,QAAQ;IACZ,OAAO;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,GAAG,EAAE,UAAU;IACf,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;CAChC,CAAC,CAAC;AACH,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC;IAC7B,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACvE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1D,4EAA4E;IAC5E,sEAAsE;IACtE,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CAC1E,CAAC,CAAC;AAEH,iGAAiG;AACjG,KAAK,UAAU,OAAO,CAAC,SAAyB,EAAE,OAAgC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC1I,MAAM,IAAI,GAAY,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxI,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,OAAO;QAChB,MAAM,IAAI,gBAAgB,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACrI,OAAO,MAAM,CAAC;AAChB,CAAC;AAID,+FAA+F;AAC/F,MAAM,OAAO,YAAY;IAEM;IADZ,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IAC/C,YAA6B,SAAyB;QAAzB,cAAS,GAAT,SAAS,CAAgB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;gBACjF,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,gBAAgB;oBAAE,MAAM,KAAK,CAAC;gBACnD,MAAM,IAAI,gBAAgB,CAAC;oBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;oBACnE,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,eAAe;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAmB;QAC3B,MAAM,EAAE,EAAE,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9E,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACjE,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACzE,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;YAC3E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,gBAAgB;oBAAE,MAAM,KAAK,CAAC;gBACnD,MAAM,IAAI,gBAAgB,CAAC;oBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;oBACnE,EAAE;oBACF,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,eAAe;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAoB;QAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,IAAI,KAAK,GAAuC,OAAO,CAAC;YACxD,IAAI,WAAW,GAA0C,eAAe,CAAC;YACzE,IAAI,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAG,EAAE,IAAI,CAAC,SAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrG,MAAM,YAAY,GAAG,QAAQ,EAAE,OAAO,IAAI,IAAI,CAAC,OAAQ,CAAC;gBACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC3H,MAAM,OAAO,GAAG;oBACd,SAAS,EAAE,aAAa;oBACxB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,YAAY;oBACrB,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;oBACjB,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnH,CAAC;gBACF,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO;oBAC9D,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;gBAC1E,KAAK,GAAG,WAAW,CAAC;gBACpB,WAAW,GAAG,SAAS,CAAC;gBACxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC3H,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;oBAC5B,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,WAAW,GAAG,OAAO,CAAC;oBACtB,KAAK,GAAG,UAAU,CAAC;gBACrB,CAAC;gBACD,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBAC/G,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,gBAAgB;oBAAE,MAAM,KAAK,CAAC;gBACnD,MAAM,IAAI,gBAAgB,CAAC;oBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;oBAC7G,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnC,KAAK;oBACL,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
|
|
@@ -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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"}
|