@executioncontrolprotocol/process-env 0.10.0

package/README.md

@@ -0,0 +1,12 @@
+# @executioncontrolprotocol/process-env
+
+Resolves `env("KEY")` / `{ "$env": "KEY" }` environment bindings from `process.env`.
+
+```ts
+import "@executioncontrolprotocol/process-env"
+import { environment, extension, env } from "@executioncontrolprotocol/node"
+
+const envBuilder = (await environment("demo")).withExtensions([
+  extension("@executioncontrolprotocol/process-env").with({}),
+])
+```

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/** Process environment config extension. @category Extensions */
+export declare const processEnvExtension: import("@executioncontrolprotocol/core").ExtensionDefinition;
+/** Register `@executioncontrolprotocol/process-env`. @category Extensions */
+export declare function registerProcessEnvExtension(registry?: import("@executioncontrolprotocol/core").Registry): Promise<void>;
+export default processEnvExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuCA,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,8DAQtB,CAAA;AAIV,6EAA6E;AAC7E,wBAAsB,2BAA2B,CAAC,QAAQ,oDAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1F;AAED,eAAe,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import { defineExtension, hook, globalRegistry, catalogExtension, PROCESS_ENV_RESOLVER_ID, } from "@executioncontrolprotocol/core";
+import { z } from "zod";
+const EXT_ID = "@executioncontrolprotocol/process-env";
+function keyAllowed(name, allowed, denied) {
+    if (denied.includes(name))
+        return false;
+    if (allowed.includes("*"))
+        return true;
+    return allowed.includes(name);
+}
+function attachProcessEnvResolver(ctx) {
+    const host = ctx.environment;
+    if (!host)
+        return;
+    const cfg = ctx
+        .extensionConfig ?? {};
+    const allowed = cfg.allowedKeys ?? ["*"];
+    const denied = cfg.deniedKeys ?? [];
+    const prefix = cfg.prefix ?? "";
+    const resolver = {
+        id: PROCESS_ENV_RESOLVER_ID,
+        resolve(name) {
+            if (!keyAllowed(name, allowed, denied))
+                return undefined;
+            const envKey = prefix ? `${prefix}${name}` : name;
+            return process.env[envKey];
+        },
+    };
+    host.registerConfigResolver(resolver);
+}
+/** Process environment config extension. @category Extensions */
+export const processEnvExtension = defineExtension("@executioncontrolprotocol", "process-env")
+    .withSupportedRuntimes(["@executioncontrolprotocol/node"])
+    .withConfig({
+    allowedKeys: z.array(z.string()).default(["*"]),
+    deniedKeys: z.array(z.string()).default([]),
+    prefix: z.string().optional(),
+})
+    .withHooks([hook("environment:configuring", attachProcessEnvResolver)])
+    .build();
+catalogExtension(processEnvExtension);
+/** Register `@executioncontrolprotocol/process-env`. @category Extensions */
+export async function registerProcessEnvExtension(registry = globalRegistry) {
+    if (!registry.getExtension(EXT_ID)) {
+        await registry.registerExtension(processEnvExtension);
+    }
+}
+export default processEnvExtension;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,IAAI,EACJ,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GAGxB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,MAAM,GAAG,uCAAuC,CAAA;AAEtD,SAAS,UAAU,CAAC,IAAY,EAAE,OAAiB,EAAE,MAAgB;IACnE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACvC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAqB;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,MAAM,GAAG,GAAI,GAAwE;SAClF,eAAe,IAAI,EAAE,CAAA;IACxB,MAAM,OAAO,GAAI,GAAG,CAAC,WAAoC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClE,MAAM,MAAM,GAAI,GAAG,CAAC,UAAmC,IAAI,EAAE,CAAA;IAC7D,MAAM,MAAM,GAAI,GAAG,CAAC,MAA6B,IAAI,EAAE,CAAA;IAEvD,MAAM,QAAQ,GAA8B;QAC1C,EAAE,EAAE,uBAAuB;QAC3B,OAAO,CAAC,IAAY;YAClB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;gBAAE,OAAO,SAAS,CAAA;YACxD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;YACjD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC5B,CAAC;KACF,CAAA;IACD,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,2BAA2B,EAAE,aAAa,CAAC;KAC3F,qBAAqB,CAAC,CAAC,gCAAgC,CAAC,CAAC;KACzD,UAAU,CAAC;IACV,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,SAAS,CAAC,CAAC,IAAI,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,CAAC,CAAC;KACtE,KAAK,EAAE,CAAA;AAEV,gBAAgB,CAAC,mBAAmB,CAAC,CAAA;AAErC,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,QAAQ,GAAG,cAAc;IACzE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,QAAQ,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED,eAAe,mBAAmB,CAAA"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@executioncontrolprotocol/process-env",
+  "version": "0.10.0",
+  "description": "Process environment config extension for ECP",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "peerDependencies": {
+    "@executioncontrolprotocol/core": "^0.10.0",
+    "@executioncontrolprotocol/types": "^0.10.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@executioncontrolprotocol/core": "0.10.0",
+    "@executioncontrolprotocol/types": "0.10.0",
+    "typescript": "^5.7.0",
+    "zod": "^3.24.0"
+  }
+}