@ericsanchezok/meta-protocol 1.1.9 → 1.1.11

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@ericsanchezok/meta-protocol",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "type": "module",
   "license": "MIT",
   "types": "./src/index.ts",

package/src/env.ts

@@ -15,13 +15,68 @@ export namespace MetaProtocolEnv {
 
   export type Target = { kind: "local" } | { kind: "remote"; envID: EnvID }
 
+  const LOCAL_ALIASES = new Set([
+    "local",
+    ":local",
+    "localhost",
+    "127.0.0.1",
+    "::1",
+    "loopback",
+    "self",
+    ":self",
+    "current",
+    ":current",
+    "host",
+    ":host",
+    "this",
+    ":this",
+  ])
+
+  const PLACEHOLDER_ALIASES = new Set(["undefined", "null", "none", "nil", "n/a"])
+
+  export class InvalidEnvIDError extends Error {
+    constructor(
+      readonly envID: string,
+      readonly reason: "placeholder_alias",
+    ) {
+      super(
+        `Invalid envID \"${envID}\". This looks like a placeholder value, not a real remote environment ID. ` +
+          `For local execution, omit envID entirely. For remote execution, pass a real remote envID such as \"env_...\".`,
+      )
+      this.name = "MetaProtocolInvalidEnvIDError"
+    }
+  }
+
+  export function normalize(envID?: string): EnvID | undefined {
+    if (envID === undefined) {
+      return undefined
+    }
+
+    const trimmed = envID.trim()
+    if (!trimmed) {
+      return undefined
+    }
+
+    const lowered = trimmed.toLowerCase()
+    if (LOCAL_ALIASES.has(lowered)) {
+      return undefined
+    }
+
+    if (PLACEHOLDER_ALIASES.has(lowered)) {
+      throw new InvalidEnvIDError(trimmed, "placeholder_alias")
+    }
+
+    return trimmed as EnvID
+  }
+
   export function resolve(envID?: string): Target {
-    if (!envID) {
+    const normalized = normalize(envID)
+    if (!normalized) {
       return { kind: "local" }
     }
     return {
       kind: "remote",
-      envID,
+      envID: normalized,
     }
   }
 }

package/test/env.test.ts

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