@f5-sales-demo/pi-utils 21.13.0 → 21.13.2

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/pi-utils",
-	"version": "21.13.0",
+	"version": "21.13.2",
 	"description": "Shared utilities for pi packages",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -39,7 +39,7 @@
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3",
-		"@f5-sales-demo/pi-natives": "21.13.0"
+		"@f5-sales-demo/pi-natives": "21.13.2"
 	},
 	"engines": {
 		"bun": ">=1.3.7"

package/src/env.ts

@@ -83,6 +83,29 @@ export function $pickenv(...keys: string[]): string | undefined {
 	return undefined;
 }
 
+/**
+ * Read an environment variable by its exact, case-sensitive name.
+ *
+ * Windows exposes case-insensitive getters for `process.env`, but enumerating
+ * keys preserves their real casing. Only trust a lookup when the requested
+ * spelling is present in that enumeration. This prevents a literal config
+ * value such as `public` from resolving to Windows' built-in `PUBLIC` path.
+ *
+ * @param name Environment variable name to look up.
+ * @param env Environment source; defaults to `process.env`.
+ */
+export function $envExact(
+	name: string,
+	env: Readonly<Record<string, string | undefined>> = process.env,
+): string | undefined {
+	const value = env[name];
+	if (value === undefined) return undefined;
+	for (const key in env) {
+		if (key === name) return value;
+	}
+	return undefined;
+}
+
 /**
  * Parses a positive decimal integer from `$env[name]`.
  * Empty, invalid, NaN, zero, or negative values return `defaultValue`.

package/src/index.ts

@@ -20,6 +20,7 @@ export {
 } from "./i18n";
 export * from "./json";
 export * as logger from "./logger";
+export * from "./materialize-string";
 export * from "./mermaid-ascii";
 export * from "./mermaid-color";
 export * from "./mime";

package/src/materialize-string.ts

@@ -0,0 +1,9 @@
+/**
+ * Copy text into independent UTF-16 backing storage before a bounded substring
+ * outlives its source. The round trip preserves every JavaScript code unit,
+ * including lone surrogates that UTF-8 would replace.
+ */
+export function materializeString(text: string): string {
+	if (text.length === 0) return "";
+	return Buffer.from(text, "utf16le").toString("utf16le");
+}