@pulsemcp/air-secrets-file 0.0.10

package/dist/file-transform.d.ts

@@ -0,0 +1,13 @@
+import type { McpConfig, TransformContext } from "@pulsemcp/air-core";
+/**
+ * Transform that resolves ${VAR} patterns from a JSON secrets file.
+ *
+ * The file path is provided via the --secrets-file CLI option (passed
+ * through context.options["secrets-file"]). If the option is not set,
+ * this transform is a no-op.
+ *
+ * The secrets file must be a JSON object of key-value string pairs:
+ * { "MY_SECRET": "value", "ANOTHER": "value2" }
+ */
+export declare function fileTransform(config: McpConfig, context: TransformContext): Promise<McpConfig>;
+//# sourceMappingURL=file-transform.d.ts.map

package/dist/file-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-transform.d.ts","sourceRoot":"","sources":["../src/file-transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,CAAC,CAkBpB"}

package/dist/file-transform.js

@@ -0,0 +1,56 @@
+import { readFileSync } from "fs";
+const ENV_VAR_PATTERN = /\$\{([^}]+)\}/g;
+/**
+ * Transform that resolves ${VAR} patterns from a JSON secrets file.
+ *
+ * The file path is provided via the --secrets-file CLI option (passed
+ * through context.options["secrets-file"]). If the option is not set,
+ * this transform is a no-op.
+ *
+ * The secrets file must be a JSON object of key-value string pairs:
+ * { "MY_SECRET": "value", "ANOTHER": "value2" }
+ */
+export async function fileTransform(config, context) {
+    const secretsFilePath = context.options["secrets-file"];
+    if (!secretsFilePath)
+        return config;
+    let secrets;
+    try {
+        secrets = JSON.parse(readFileSync(secretsFilePath, "utf-8"));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to read secrets file "${secretsFilePath}": ${message}`);
+    }
+    return {
+        ...config,
+        mcpServers: resolveObject(config.mcpServers, secrets),
+    };
+}
+function resolveObject(obj, secrets) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        result[key] = resolveValue(value, secrets);
+    }
+    return result;
+}
+function resolveValue(value, secrets) {
+    if (typeof value === "string") {
+        return value.replace(ENV_VAR_PATTERN, (match, varName) => {
+            const secretVal = secrets[varName];
+            return secretVal !== undefined ? secretVal : match;
+        });
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => resolveValue(v, secrets));
+    }
+    if (value !== null && typeof value === "object") {
+        const resolved = {};
+        for (const [k, v] of Object.entries(value)) {
+            resolved[k] = resolveValue(v, secrets);
+        }
+        return resolved;
+    }
+    return value;
+}
+//# sourceMappingURL=file-transform.js.map

package/dist/file-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-transform.js","sourceRoot":"","sources":["../src/file-transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAGlC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiB,EACjB,OAAyB;IAEzB,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAuB,CAAC;IAC9E,IAAI,CAAC,eAAe;QAAE,OAAO,MAAM,CAAC;IAEpC,IAAI,OAA+B,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,gCAAgC,eAAe,MAAM,OAAO,EAAE,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,GAA4C,EAC5C,OAA+B;IAE/B,MAAM,MAAM,GAA4C,EAAE,CAAC;IAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAA4B,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CACnB,KAAc,EACd,OAA+B;IAE/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACvD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { AirExtension } from "@pulsemcp/air-core";
+export { fileTransform } from "./file-transform.js";
+declare const extension: AirExtension;
+export default extension;
+//# 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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,QAAA,MAAM,SAAS,EAAE,YAUhB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+import { fileTransform } from "./file-transform.js";
+export { fileTransform } from "./file-transform.js";
+const extension = {
+    name: "secrets-file",
+    transform: { transform: fileTransform },
+    prepareOptions: [
+        {
+            flag: "--secrets-file <path>",
+            description: "Path to a JSON file containing secret values for ${VAR} interpolation",
+        },
+    ],
+};
+export default extension;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,SAAS,GAAiB;IAC9B,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE;IACvC,cAAc,EAAE;QACd;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,uEAAuE;SAC1E;KACF;CACF,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@pulsemcp/air-secrets-file",
+  "version": "0.0.10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pulsemcp/air.git",
+    "directory": "packages/extensions/secrets-file"
+  },
+  "description": "AIR transform that resolves ${VAR} patterns from a JSON secrets file in MCP configs",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pulsemcp/air-core": "0.0.10"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}