@boristype/ws-client 0.1.0-alpha.4 → 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.
Files changed (85) hide show
  1. package/README.md +71 -13
  2. package/build/hcm/api.d.ts +17 -0
  3. package/build/hcm/api.d.ts.map +1 -0
  4. package/build/hcm/api.js +31 -0
  5. package/build/hcm/api.js.map +1 -0
  6. package/build/hcm/file-contract.d.ts +67 -0
  7. package/build/hcm/file-contract.d.ts.map +1 -0
  8. package/build/hcm/file-contract.js +93 -0
  9. package/build/hcm/file-contract.js.map +1 -0
  10. package/build/hcm/files.d.ts +90 -0
  11. package/build/hcm/files.d.ts.map +1 -0
  12. package/build/hcm/files.js +122 -0
  13. package/build/hcm/files.js.map +1 -0
  14. package/build/hcm/load.d.ts +14 -0
  15. package/build/hcm/load.d.ts.map +1 -0
  16. package/build/hcm/load.js +24 -0
  17. package/build/hcm/load.js.map +1 -0
  18. package/build/hcm/managed-files.d.ts +7 -0
  19. package/build/hcm/managed-files.d.ts.map +1 -0
  20. package/build/hcm/managed-files.js +29 -0
  21. package/build/hcm/managed-files.js.map +1 -0
  22. package/build/hcm/object-error.d.ts +16 -0
  23. package/build/hcm/object-error.d.ts.map +1 -0
  24. package/build/hcm/object-error.js +9 -0
  25. package/build/hcm/object-error.js.map +1 -0
  26. package/build/hcm/object-state.d.ts +24 -0
  27. package/build/hcm/object-state.d.ts.map +1 -0
  28. package/build/hcm/object-state.js +41 -0
  29. package/build/hcm/object-state.js.map +1 -0
  30. package/build/hcm/object-xml.d.ts +21 -0
  31. package/build/hcm/object-xml.d.ts.map +1 -0
  32. package/build/hcm/object-xml.js +95 -0
  33. package/build/hcm/object-xml.js.map +1 -0
  34. package/build/hcm/objects.d.ts +31 -0
  35. package/build/hcm/objects.d.ts.map +1 -0
  36. package/build/hcm/objects.js +155 -0
  37. package/build/hcm/objects.js.map +1 -0
  38. package/build/hcm/read-state.d.ts +32 -0
  39. package/build/hcm/read-state.d.ts.map +1 -0
  40. package/build/hcm/read-state.js +65 -0
  41. package/build/hcm/read-state.js.map +1 -0
  42. package/build/hcm/runtime/bundle.d.ts +43 -0
  43. package/build/hcm/runtime/bundle.d.ts.map +1 -0
  44. package/build/hcm/runtime/bundle.js +49 -0
  45. package/build/hcm/runtime/bundle.js.map +1 -0
  46. package/build/hcm/runtime/contracts.d.ts +107 -0
  47. package/build/hcm/runtime/contracts.d.ts.map +1 -0
  48. package/build/hcm/runtime/contracts.js +98 -0
  49. package/build/hcm/runtime/contracts.js.map +1 -0
  50. package/build/hcm/runtime/runtime.d.ts +23 -0
  51. package/build/hcm/runtime/runtime.d.ts.map +1 -0
  52. package/build/hcm/runtime/runtime.js +130 -0
  53. package/build/hcm/runtime/runtime.js.map +1 -0
  54. package/build/hcm/schemas.d.ts +86 -0
  55. package/build/hcm/schemas.d.ts.map +1 -0
  56. package/build/hcm/schemas.js +90 -0
  57. package/build/hcm/schemas.js.map +1 -0
  58. package/build/hcm/search-contract.d.ts +50 -0
  59. package/build/hcm/search-contract.d.ts.map +1 -0
  60. package/build/hcm/search-contract.js +66 -0
  61. package/build/hcm/search-contract.js.map +1 -0
  62. package/build/hcm/types.d.ts +5 -0
  63. package/build/hcm/types.d.ts.map +1 -0
  64. package/build/hcm/types.js +2 -0
  65. package/build/hcm/types.js.map +1 -0
  66. package/build/hcm/xquery.d.ts +6 -0
  67. package/build/hcm/xquery.d.ts.map +1 -0
  68. package/build/hcm/xquery.js +33 -0
  69. package/build/hcm/xquery.js.map +1 -0
  70. package/build/index.d.ts +9 -0
  71. package/build/index.d.ts.map +1 -1
  72. package/build/index.js +5 -0
  73. package/build/index.js.map +1 -1
  74. package/package.json +6 -3
  75. package/resources/dotnet/bootstrap/BorisType.RuntimeBootstrap.B53a9ea0c1f41b578b4bb88a9389553a72996846f7a15fed29f0c3358e12525a0.deps.json +23 -0
  76. package/resources/dotnet/bootstrap/BorisType.RuntimeBootstrap.B53a9ea0c1f41b578b4bb88a9389553a72996846f7a15fed29f0c3358e12525a0.dll +0 -0
  77. package/resources/dotnet/component/BorisType.FileSystem.deps.json +23 -0
  78. package/resources/dotnet/component/BorisType.FileSystem.dll +0 -0
  79. package/resources/dotnet/manifest.json +43 -0
  80. package/resources/file-operation.bs +10 -0
  81. package/resources/object-operation.bs +102 -0
  82. package/resources/runtime-bootstrap.bs +27 -0
  83. package/resources/runtime-operation.bs +10 -0
  84. package/resources/search-files.bs +7 -0
  85. package/resources/xquery.bs +30 -0
@@ -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"}
@@ -0,0 +1,130 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { fileURLToPath } from "node:url";
3
+ import { randomUUID } from "node:crypto";
4
+ import { z } from "zod";
5
+ import { buildScript } from "../load.js";
6
+ import { BundleFailure, loadBundle, matchesArtifact } from "./bundle.js";
7
+ import { compareVersions, identity, runtimeStatusSchema, WshcmRuntimeError, } from "./contracts.js";
8
+ const bootstrapTemplate = readFileSync(new URL("../../../resources/runtime-bootstrap.bs", import.meta.url), "utf8");
9
+ const operationTemplate = readFileSync(new URL("../../../resources/runtime-operation.bs", import.meta.url), "utf8");
10
+ const bootstrapResponse = z.strictObject({ schemaVersion: z.literal(1), files: z.record(z.string(), z.string()) });
11
+ function localFailure(reason, expected, error) {
12
+ return new WshcmRuntimeError({ schemaVersion: 1, status: "blocked", reason, expected, installed: null, loaded: null, changed: false, process: null }, error instanceof Error ? error.message : String(error));
13
+ }
14
+ function parseCarrier(wire, maxBytes) {
15
+ if (typeof wire !== "string" || Buffer.byteLength(wire, "utf8") > maxBytes * 6 + 2)
16
+ throw new Error("Invalid runtime response carrier");
17
+ const text = JSON.parse(wire);
18
+ if (typeof text !== "string" || Buffer.byteLength(text, "utf8") > maxBytes)
19
+ throw new Error("Invalid runtime response size");
20
+ return JSON.parse(text);
21
+ }
22
+ /** Automatically installs packaged dependencies and reports actual loaded code in the answering process. */
23
+ export class WshcmRuntime {
24
+ evaluator;
25
+ pending;
26
+ verifiedBootstrap;
27
+ inspectNext = false;
28
+ directory;
29
+ installationName;
30
+ constructor(evaluator, options = {}) {
31
+ this.evaluator = evaluator;
32
+ this.directory = options.bundleDirectory ?? fileURLToPath(new URL("../../../resources/dotnet/", import.meta.url));
33
+ this.installationName = options.installationName ?? ".boristype-runtime";
34
+ }
35
+ /** Coalesce concurrent preparations, then recheck the answering process on every later call. */
36
+ ensure() {
37
+ if (!this.pending) {
38
+ this.pending = this.prepare().finally(() => {
39
+ this.pending = undefined;
40
+ });
41
+ }
42
+ return this.pending;
43
+ }
44
+ async requireReady() {
45
+ const status = await this.ensure();
46
+ if (status.status !== "ready")
47
+ throw new WshcmRuntimeError(status);
48
+ return status;
49
+ }
50
+ async prepare() {
51
+ let expected = null;
52
+ try {
53
+ if (!/^\.?[A-Za-z0-9][A-Za-z0-9._-]{0,95}$/.test(this.installationName) ||
54
+ ["native", "runtimes", "refs"].includes(this.installationName.toLowerCase()))
55
+ throw new BundleFailure("InvalidInstallationName", "Expected a non-reserved directory name under AppDirectoryPath()/dotnetcore/shared");
56
+ const { manifest, bootstrapPayload, componentPayload } = await loadBundle(this.directory);
57
+ expected = identity(manifest.component);
58
+ const fingerprint = JSON.stringify(manifest.bootstrap);
59
+ if (this.verifiedBootstrap !== fingerprint) {
60
+ this.inspectNext = false;
61
+ const request = {
62
+ installationName: this.installationName,
63
+ id: manifest.bootstrap.id,
64
+ uploadId: randomUUID(),
65
+ files: manifest.bootstrap.files.map((file) => ({ path: file.path, base64: bootstrapPayload[file.path] })),
66
+ };
67
+ let response;
68
+ try {
69
+ response = bootstrapResponse.parse(parseCarrier(await this.evaluator.eval(buildScript(bootstrapTemplate, { request: JSON.stringify(request) })), 12582912));
70
+ }
71
+ catch (error) {
72
+ throw localFailure("BootstrapTransportError", expected, error);
73
+ }
74
+ if (Object.keys(response.files).length !== manifest.bootstrap.files.length)
75
+ throw localFailure("BootstrapArtifactMismatch", expected, "Unexpected helper files");
76
+ for (const file of manifest.bootstrap.files) {
77
+ const encoded = response.files[file.path];
78
+ if (encoded === undefined ||
79
+ !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(encoded) ||
80
+ !matchesArtifact(Buffer.from(encoded, "base64"), file))
81
+ throw localFailure("BootstrapArtifactMismatch", expected, "Helper readback does not match packaged bytes");
82
+ }
83
+ this.verifiedBootstrap = fingerprint;
84
+ }
85
+ const execute = async (method) => {
86
+ const request = {
87
+ installationName: this.installationName,
88
+ bootstrapId: manifest.bootstrap.id,
89
+ method,
90
+ descriptorJson: JSON.stringify(manifest.component),
91
+ ...(method === "EnsureJson" ? { payloadJson: JSON.stringify(componentPayload) } : {}),
92
+ };
93
+ try {
94
+ const result = runtimeStatusSchema.parse(parseCarrier(await this.evaluator.eval(buildScript(operationTemplate, { request: JSON.stringify(request) })), 65536));
95
+ if (JSON.stringify(result.expected) !== JSON.stringify(expected))
96
+ throw new Error("Runtime expected identity mismatch");
97
+ if (result.status === "ready") {
98
+ if (!result.loaded || result.loaded.id !== expected.id || result.loaded.apiVersion !== expected.apiVersion)
99
+ throw new Error("Ready status lacks compatible loaded identity");
100
+ const version = compareVersions(result.loaded.version, expected.version);
101
+ if (version < 0 ||
102
+ (version === 0 && (result.loaded.buildId !== expected.buildId || result.loaded.version !== expected.version)))
103
+ throw new Error("Ready status contradicts loaded build identity");
104
+ }
105
+ return result;
106
+ }
107
+ catch (error) {
108
+ this.verifiedBootstrap = undefined;
109
+ this.inspectNext = false;
110
+ throw localFailure("RuntimeTransportError", expected, error);
111
+ }
112
+ };
113
+ let status = await execute(this.inspectNext ? "InspectJson" : "EnsureJson");
114
+ const inspected = this.inspectNext;
115
+ this.inspectNext = true;
116
+ if (inspected &&
117
+ (status.status === "missing" ||
118
+ status.status === "installed" ||
119
+ (status.status === "restart_required" && status.installed === null)))
120
+ status = await execute("EnsureJson");
121
+ return status;
122
+ }
123
+ catch (error) {
124
+ if (error instanceof WshcmRuntimeError)
125
+ throw error;
126
+ throw localFailure(error instanceof BundleFailure ? error.reason : "RuntimeError", expected, error);
127
+ }
128
+ }
129
+ }
130
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/hcm/runtime/runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,86 @@
1
+ import { z } from "zod";
2
+ /** Shared SDK and MCP input contracts; defaults are applied by every SDK operation. */
3
+ export declare const wshcmSchemas: {
4
+ readonly files: {
5
+ readonly read: z.ZodObject<{
6
+ path: z.ZodString;
7
+ startLine: z.ZodOptional<z.ZodNumber>;
8
+ endLine: z.ZodOptional<z.ZodNumber>;
9
+ readToken: z.ZodOptional<z.ZodString>;
10
+ }, z.core.$strict>;
11
+ readonly write: z.ZodObject<{
12
+ path: z.ZodString;
13
+ content: z.ZodString;
14
+ mode: z.ZodDefault<z.ZodEnum<{
15
+ overwrite: "overwrite";
16
+ create: "create";
17
+ }>>;
18
+ readToken: z.ZodOptional<z.ZodString>;
19
+ }, z.core.$strict>;
20
+ readonly edit: z.ZodObject<{
21
+ path: z.ZodString;
22
+ readToken: z.ZodString;
23
+ edits: z.ZodArray<z.ZodObject<{
24
+ oldText: z.ZodString;
25
+ newText: z.ZodString;
26
+ }, z.core.$strict>>;
27
+ dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
28
+ expectedSha256: z.ZodOptional<z.ZodString>;
29
+ }, z.core.$strict>;
30
+ readonly list: z.ZodObject<{
31
+ path: z.ZodString;
32
+ }, z.core.$strict>;
33
+ readonly delete: z.ZodObject<{
34
+ path: z.ZodString;
35
+ }, z.core.$strict>;
36
+ readonly mkdir: z.ZodObject<{
37
+ path: z.ZodString;
38
+ }, z.core.$strict>;
39
+ readonly move: z.ZodObject<{
40
+ source: z.ZodString;
41
+ destination: z.ZodString;
42
+ }, z.core.$strict>;
43
+ readonly info: z.ZodObject<{
44
+ path: z.ZodString;
45
+ }, z.core.$strict>;
46
+ readonly search: z.ZodObject<{
47
+ path: z.ZodString;
48
+ pattern: z.ZodOptional<z.ZodString>;
49
+ excludePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
50
+ query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
51
+ regex: z.ZodOptional<z.ZodBoolean>;
52
+ ignoreCase: z.ZodOptional<z.ZodBoolean>;
53
+ maxResults: z.ZodOptional<z.ZodNumber>;
54
+ maxEntries: z.ZodOptional<z.ZodNumber>;
55
+ maxDepth: z.ZodOptional<z.ZodNumber>;
56
+ maxFileBytes: z.ZodOptional<z.ZodNumber>;
57
+ maxTotalBytes: z.ZodOptional<z.ZodNumber>;
58
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
59
+ maxLineLength: z.ZodOptional<z.ZodNumber>;
60
+ }, z.core.$strict>;
61
+ };
62
+ readonly objects: {
63
+ readonly getForm: z.ZodObject<{
64
+ formUrl: z.ZodString;
65
+ }, z.core.$strict>;
66
+ readonly get: z.ZodObject<{
67
+ id: z.ZodString;
68
+ }, z.core.$strict>;
69
+ readonly save: z.ZodObject<{
70
+ mode: z.ZodEnum<{
71
+ replace: "replace";
72
+ create: "create";
73
+ }>;
74
+ formUrl: z.ZodOptional<z.ZodString>;
75
+ id: z.ZodOptional<z.ZodString>;
76
+ readToken: z.ZodOptional<z.ZodUUID>;
77
+ xml: z.ZodString;
78
+ }, z.core.$strict>;
79
+ };
80
+ readonly xquery: z.ZodObject<{
81
+ query: z.ZodString;
82
+ maxRows: z.ZodDefault<z.ZodNumber>;
83
+ }, z.core.$strict>;
84
+ readonly runtimeStatus: z.ZodObject<{}, z.core.$strict>;
85
+ };
86
+ //# sourceMappingURL=schemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/hcm/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwFxB,uFAAuF;AACvF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKf,CAAC"}