{"_id":"@autonoma-ai/occultus","_rev":"6-c7d177959ee30b622d8656a9d384576f","name":"@autonoma-ai/occultus","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@autonoma-ai/occultus","version":"1.0.0","author":{"url":"https://github.com/sfmullen","name":"Simon Mullen","email":"sfmullen@autonoma.app"},"license":"MIT","_id":"@autonoma-ai/occultus@1.0.0","maintainers":[{"name":"sfmullen","email":"sfmullen@autonoma.app"}],"homepage":"https://github.com/Autonoma-AI/occultus#readme","bugs":{"url":"https://github.com/Autonoma-AI/occultus/issues"},"dist":{"shasum":"0493b1126e2e722027be7da124d4909fe8b80464","tarball":"https://registry.npmjs.org/@autonoma-ai/occultus/-/occultus-1.0.0.tgz","fileCount":5,"integrity":"sha512-OxDufQgDvIjF1a3bKk/zcxhwcuwVf9EMOPjoSCXDK+nmayiWX7GbTxJhby6yNCwtCOLW3X/KjxTr6cDbwtL0jg==","signatures":[{"sig":"MEUCICVd1PTEF4e9IT8IzEArMXIVmco/k8rgo947DGiGxDJsAiEAyAI4U+p/s/0Ns9QLc5GBQ7ezUyBXIo5sUzqA1y5FbH8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7282},"main":"index.js","gitHead":"97687ea104721191ae1bb4408582e868fc8149b9","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"sfmullen","email":"sfmullen@autonoma.app"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","repository":{"url":"git+https://github.com/Autonoma-AI/occultus.git","type":"git"},"_npmVersion":"10.8.2","description":"An NPM package that retrieves secrets from Google Cloud Secret Manager and writes them to an .env file.","directories":{},"_nodeVersion":"20.18.0","dependencies":{"@google-cloud/secret-manager":"^5.6.0"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/occultus_1.0.0_1741019321818_0.48484963651407886","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@autonoma-ai/occultus","version":"1.0.1","author":{"url":"https://github.com/sfmullen","name":"Simon Mullen","email":"sfmullen@autonoma.app"},"license":"MIT","_id":"@autonoma-ai/occultus@1.0.1","maintainers":[{"name":"sfmullen","email":"sfmullen@autonoma.app"}],"homepage":"https://github.com/Autonoma-AI/occultus#readme","bugs":{"url":"https://github.com/Autonoma-AI/occultus/issues"},"dist":{"shasum":"41847171a5fa957d94dc4fb2157c2dec70dd32ac","tarball":"https://registry.npmjs.org/@autonoma-ai/occultus/-/occultus-1.0.1.tgz","fileCount":5,"integrity":"sha512-47vDL/6qviEW/97POvevHOsp6g2d9Ye91RyPZpYm8GnT2s/6qm5StrNEkKZjekE8XP2RemfWIz8wUoVeEJM/1Q==","signatures":[{"sig":"MEUCID2upfehIGii4ppw1yHkVJzVKLQkb41vN+xtx/B3r8+uAiEAoXW3MPR5BRQyI/GfLi5PKI/un3FFsQEH4UU1GZdSlUo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7282},"main":"index.js","gitHead":"97687ea104721191ae1bb4408582e868fc8149b9","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"sfmullen","email":"sfmullen@autonoma.app"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","repository":{"url":"git+https://github.com/Autonoma-AI/occultus.git","type":"git"},"_npmVersion":"10.9.2","description":"An NPM package that retrieves secrets from Google Cloud Secret Manager and writes them to an .env file.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@google-cloud/secret-manager":"^5.6.0"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/occultus_1.0.1_1741019520791_0.3990906035765376","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-03-03T16:28:41.756Z","modified":"2026-05-22T15:00:40.387Z","1.0.0":"2025-03-03T16:28:42.028Z","1.0.1":"2025-03-03T16:32:01.007Z"},"bugs":{"url":"https://github.com/Autonoma-AI/occultus/issues"},"author":{"url":"https://github.com/sfmullen","name":"Simon Mullen","email":"sfmullen@autonoma.app"},"license":"MIT","homepage":"https://github.com/Autonoma-AI/occultus#readme","repository":{"url":"git+https://github.com/Autonoma-AI/occultus.git","type":"git"},"description":"An NPM package that retrieves secrets from Google Cloud Secret Manager and writes them to an .env file.","maintainers":[{"email":"npm@autonoma.app","name":"autonomaai-labs"},{"email":"tom@autonoma.app","name":"automoma"},{"email":"eugenio@autonoma.app","name":"scafati98"},{"email":"sfmullen@autonoma.app","name":"sfmullen"}],"readme":"# 🔮 Occultus\n\nOccultus is a Node.js package that fetches secrets from Google Cloud Secret Manager and stores them in an environment file. This helps in keeping secrets secure while ensuring they are available for your application during development. ⚡\n\n## ✨ Features\n\n- 🔐 Automatically downloads and updates secrets from Google Cloud Secret Manager\n- 📄 Stores secrets in an `.env` file for easy access\n- 🚀 Prevents unnecessary downloads by checking the secret version\n- ⚙️ Configuration stored in `package.json`\n- 🛠️ Designed for **development environments only**\n\n## 📥 Installation\n\nInstall Occultus as a **dev dependency**:\n\n```sh\nnpm install occultus --save-dev\n```\n\n## ⚙️ Configuration\n\nAdd the following configuration in your `package.json` file:\n\n```json\n\"occultus\": {\n  \"projectId\": \"your-gcp-project-id\",\n  \"secretName\": \"your-secret-name\",\n  \"envFile\": \".env\"\n}\n```\n\n- **projectId**: Your Google Cloud project ID\n- **secretName**: The name of the secret in Secret Manager\n- **envFile**: The target file where the secret will be stored\n\n## 🚀 Usage\n\nYou can use Occultus programmatically within your Node.js application:\n\n```javascript\nimport { saveSecretToEnv } from 'occultus';\n\nawait saveSecretToEnv();\n```\n\nAlternatively, add a script in `package.json` to run it easily:\n\n```json\n\"scripts\": {\n  \"fetch-secret\": \"node -e \\\"import('occultus').then(({ saveSecretToEnv }) => saveSecretToEnv())\\\"\"\n}\n```\n\nRun the script with:\n\n```sh\nnpm run fetch-secret\n```\n\n## 🔄 How It Works\n\n1. 📝 Occultus reads the configuration from `package.json`.\n2. 🔑 It fetches the latest version of the secret from Google Cloud Secret Manager.\n3. 🛑 If the secret version is the same as the one in the `.env` file, it skips the update.\n4. ✅ If the version is different, it updates the `.env` file with the new secret.\n\n## ⚠️ Important\n\n**Occultus is designed for development environments only!** 🚧 Do not use it in production to prevent security risks.\n\n## 🔧 Requirements\n\n- 📌 Node.js 14+\n- ☁️ Google Cloud SDK configured with appropriate permissions\n\n## 📜 License\n\nMIT\n\n","readmeFilename":"README.md"}