slack-cleaner 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Gasperoni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,8 +10,17 @@
 
 ## Install
 
+Install from npm (published package):
+
 ```bash
-npm install
+npm install -g slack-cleaner
+```
+
+Alternatively check out the repo:
+
+```bash
+gh repo clone mcdado/slack-cleaner-node
+cd slack-cleaner-node
 npm link
 ```
 
@@ -26,6 +35,13 @@ slack-cleaner --help
 Use a token that can read history and delete the target messages.
 
 This CLI auto-loads a `.env` file from your current working directory.
+If not present there, it also checks `.env` in the installed package directory
+(useful when running a globally linked install via `npm link`).
+
+Token setup by install mode:
+
+- `npm link` (repo checked out): put token in repo `.env` and it will be picked up as fallback.
+- `npm install -g slack-cleaner` (no repo checkout): use either a `.env` in the directory where you run `slack-cleaner`, shell env vars, or `--token`.
 
 Create it from the example:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slack-cleaner",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Flag-based Slack message cleaner CLI for Node.js",
   "license": "MIT",
   "type": "commonjs",
@@ -35,4 +35,4 @@
     "url": "https://github.com/mcdado/slack-cleaner-node/issues"
   },
   "homepage": "https://github.com/mcdado/slack-cleaner-node#readme"
-}
+}

package/src/cli/help.js

@@ -25,6 +25,8 @@ Execution:
 
 Environment:
   The CLI auto-loads .env in the current working directory.
+  If not set there, it also checks .env in the installed package directory.
+  For npm install -g usage, prefer cwd .env, shell env vars, or --token.
   SLACK_USER_TOKEN, SLACK_BOT_TOKEN, or SLACK_TOKEN can be used instead of --token.
 `);
 }

package/src/cli.js

@@ -20,7 +20,13 @@ const { createDeletionProgressReporter } = require('./output/progress');
  * @returns {Promise<void>}
  */
 async function run(argv) {
-  loadDotEnv(path.resolve(process.cwd(), '.env'));
+  const cwdEnvPath = path.resolve(process.cwd(), '.env');
+  const packageRootEnvPath = path.resolve(__dirname, '..', '.env');
+
+  loadDotEnv(cwdEnvPath);
+  if (packageRootEnvPath !== cwdEnvPath) {
+    loadDotEnv(packageRootEnvPath);
+  }
 
   const args = parseArgs(argv);
   const tokens = resolveTokens(args.token);

package/test/env.test.js

@@ -58,3 +58,19 @@ test('resolveTokens keeps ordered unique candidates', () => {
   ]);
   assert.deepEqual(resolveTokens('user-token'), ['user-token', 'bot-token', 'generic-token']);
 });
+
+test('loadDotEnv does not override keys already set by earlier .env files', () => {
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'slack-cleaner-'));
+  const firstEnvPath = path.join(tmpDir, '.env.first');
+  const secondEnvPath = path.join(tmpDir, '.env.second');
+
+  fs.writeFileSync(firstEnvPath, 'SLACK_TOKEN=first-token\n', 'utf8');
+  fs.writeFileSync(secondEnvPath, 'SLACK_TOKEN=second-token\n', 'utf8');
+
+  delete process.env.SLACK_TOKEN;
+
+  loadDotEnv(firstEnvPath);
+  loadDotEnv(secondEnvPath);
+
+  assert.equal(process.env.SLACK_TOKEN, 'first-token');
+});