endia 0.0.0-stage → 0.0.2

package/dist/transport/service-address.js

@@ -0,0 +1,37 @@
+/** The prefix of a named pipe address, as Docker writes `npipe:////./pipe/docker_engine`. */
+const PipePrefix = "npipe://";
+/** The pipe part of a named pipe address: `//./pipe/` and then the pipe's name, which holds no slash or backslash. */
+const PipePath = /^\/\/\.\/pipe\/(?<name>[^/\\]+)$/u;
+/**
+ * Reads an address in the forms the CLI and `EASTINDIA_HOST` take: `tcp://<host>:<port>`, over which TLS is always used and always
+ * verified, or `npipe:////./pipe/<name>`, a named pipe on this PC.
+ *
+ * @param host - The address, for example `tcp://host.docker.internal:7443` or `npipe:////./pipe/eastindia_engine`.
+ * @param setting - Where the address came from, which the error message names, for example `EASTINDIA_HOST`.
+ * @returns Where the client connects.
+ * @throws Error when the address has neither form.
+ */
+export function parseServiceAddress(host, setting) {
+    if (host.startsWith(PipePrefix)) {
+        const pipe = PipePath.exec(host.slice(PipePrefix.length));
+        if (pipe?.groups?.["name"] === undefined) {
+            throw new Error(`${setting} must be npipe:////./pipe/<name>; found '${host}'.`);
+        }
+        return { kind: "socket", path: `\\\\.\\pipe\\${pipe.groups["name"]}` };
+    }
+    const parsed = URL.canParse(host) ? new URL(host) : undefined;
+    if (parsed?.protocol !== "tcp:" || parsed.port === "" || !["", "/"].includes(parsed.pathname) || parsed.search !== "" || parsed.hash !== "") {
+        throw new Error(`${setting} must be tcp://<host>:<port> or npipe:////./pipe/<name>; found '${host}'.`);
+    }
+    // URL keeps an IPv6 address in brackets; the TLS check and the connection take it without them.
+    return { kind: "https", hostname: parsed.hostname.replace(/^\[(?<inner>.*)\]$/u, "$<inner>"), port: Number(parsed.port) };
+}
+/**
+ * Names an address as messages name it: the host and port, or the socket's path.
+ *
+ * @param address - The address.
+ * @returns For example `host.docker.internal:7443` or `\\.\pipe\eastindia_engine`.
+ */
+export function describeServiceAddress(address) {
+    return address.kind === "https" ? `${address.hostname.includes(":") ? `[${address.hostname}]` : address.hostname}:${String(address.port)}` : address.path;
+}

package/dist/transport/tls-files.d.ts

@@ -0,0 +1,9 @@
+/** The PEM text of the three files a caller over HTTPS holds. */
+export interface TlsFiles {
+    /** EastIndia's certificate authority, `ca.pem`: the only authority the client trusts for the server's certificate. */
+    readonly ca: string | Buffer;
+    /** The client certificate EastIndia issued, `cert.pem`. */
+    readonly cert: string | Buffer;
+    /** The client certificate's private key, `key.pem`. */
+    readonly key: string | Buffer;
+}

package/dist/transport/tls-files.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,45 @@
 {
-  "name": "endia",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "endia",
+	"version": "0.0.2",
+	"description": "Client for EastIndia, which runs Windows desktop test machines that tests drive like Docker containers. Early preview.",
+	"license": "Apache-2.0",
+	"author": "teaToolkit",
+	"private": false,
+	"type": "module",
+	"engines": {
+		"node": ">=20"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"lint": "eslint --max-warnings 0 .",
+		"check": "tsc -p tsconfig.json && eslint --max-warnings 0 .",
+		"test": "npm run check && node --test --test-reporter=spec \"build/test/unit/**/*.test.js\" \"build/test/integration/**/*.test.js\"",
+		"test:live": "npm run check && node --test --test-reporter=spec --test-concurrency=1 \"build/test/live/**/*.test.js\"",
+		"prepack": "npm run build",
+		"package": "node scripts/package.mjs"
+	},
+	"dependencies": {
+		"tar": "7.5.22",
+		"ws": "8.22.1"
+	},
+	"devDependencies": {
+		"@eslint/js": "10.0.1",
+		"@types/node": "20.19.43",
+		"@types/ws": "8.18.2",
+		"eslint": "10.14.0",
+		"typescript": "6.0.3",
+		"typescript-eslint": "8.72.1"
+	}
+}